Omakase zenn articles

初期設定

1. 本リポジトリを フォーク して自分のgithub内にリポジトリを作成する
2. zennとgithubの連携を行う 手順
3. pnpmのインストール 手順
4. パッケージをインストール corepack enable pnpm && pnpm i --frozen-lockfile 参考

注意：個人リポジトリではarticles, imagesディレクトリ直下のみを編集可とし、フォーク元に対してPRは行わないこと（各自の投稿データが混合しないようにするため） 注意：パッケージやcicdまわり、READMEなどの大枠はフォーク元での変更のみとし、各自のリポジトリではSync forkのみを行うこと

記事作成/投稿手順

STEP1. 記事タイトル(仮決め)・アウトラインの作成

1. mainブランチから<slug名>/step-1というブランチを切る
2. 記事ファイルをコマンドで作成 pnpm create-article
3. ファイル名を変更する（ファイル名はslugとなるため一意でなければならない。ランダムではなく意味のある文字列かつ一意にすること） 参考
4. タイトル・アウトライン、各アウトラインの要約を書く 参考
5. 記事のPRを出し、 @43z708 にレビューを依頼する（PR文には投稿の意図や想定読者層などを記載する）
6. approveされたらmainブランチにマージすることで下書きとしてデプロイされる

STEP2. 記事本文を書く

1. mainブランチから<slug名>/step-2というブランチを切る
2. 記事本文を執筆する

• 画像はimages/<slug名>/~~.jpgのようなルールで配置する 画像ファイル配置方法
• pnpm previewでプレビューしながら記事を書ける

3. タイトルを本決めする
4. 記事のPRを出し、 @43z708 にレビューを依頼する
5. approveされたらmainブランチにマージすることで下書きとしてデプロイされる

STEP3. xの投稿文を作成する

1. mainブランチから<slug名>/step-3というブランチを切る
2. published: true、published_at: 2050-06-12 09:03という予約投稿をする
3. 記事のPRを出し、 PR文にて、xへの投稿文と添付予定の画像を提案し、@43z708 にレビューを依頼する
4. approveされたらmainブランチにマージすることで予約投稿としてデプロイされる
5. 時間になったら、omakaseアカウントから投稿する（記事リンクは外部リンクとなるため、スレッド1つめではなく2つめのスレッドにすることでインプへの影響を避けることができる）

タイトルを考える際のポイント

• 数字を使う

例：『トレンド入りする記事を書く技術！記事を200本投稿してわかった秘訣4選』

タイトルに数字を入れるのはよく使われるテクニックです。

数字を入れることで具体性が増し、説得力のあるタイトルになります。

• ターゲットを絞る

例：『せっかく書いた記事が読まれずに困っている人必見！トレンド入りする記事を書く技術』

特定のターゲットの感情を揺さぶることで、相手は記事を読んでみたくなります。

• 煽ってみる

例：『なぜあなたの書いた記事は読まれないのか？読まれる記事を書く方法を解説する』

私はあまり使いませんが、煽りを入れると興味を引くことができます。

煩りすぎるタイトルは反感を起こすこともあるため、適切なバランスを考えましょう。

ref

記事作成にあたって意識すること

1. 自分の言葉を大切にする。(AIに頼りすぎない。体験談は強い)
2. 各アウトラインの最初または最後にはつなぎの文章を入れると全体が滑らかになりやすい。
3. 図や画像を効果的に使う

レビューにあたって意識すること

• 誤字脱字、変な表現の修正
• 読んでいて客観的に分かりづらいと感じるところがないかチェック
• 遠回しにして煙に巻いているような文章になっている時は、大体理解が浅くなっているところです。自分に厳しく言語化を求めていきます
• 定めたゴールを満たせそうか考える
• 足りない要素があったら、内容とどこに挟むと自然かを考えて追記します
• 蛇足な部分がないかチェック
• 不必要な部分があったら思い切ってバッサリ削除します ref

text-lintを無視したい箇所について

コメントアウトすることで対象範囲を textlint 対象外とできます。

<!-- textlint-disable -->

this is ok

<!-- textlint-enable -->