Zenn Github連携メモ

自分向けメモ

参考資料

• GitHub リポジトリで Zenn のコンテンツを管理する
  • https://zenn.dev/zenn/articles/connect-to-github
• Zenn CLI をインストールする
  • https://zenn.dev/zenn/articles/install-zenn-cli
• GitHub リポジトリ連携で画像をアップロードする方法
  • https://zenn.dev/zenn/articles/deploy-github-images

ざっくりとした流れ

1. Github でドキュメント管理用のリポジトリを作成
   • zenn-cliを使う場合Add .gitignoreの設定をNodeにしておくと良い
2. ZENN 側で Gihub のアカウントとリポジトリを連携
3. 作成したリポジトリをクローンしzenn-cliをインストール

   npm i -D zenn-cli
   

4. zenn 用のセットアップを行う

   npx zenn init
   

5. 記事、本を作成し執筆開始

つまずいたところ

• slug のエラー

  articles/xxxxxxxxx.mdはslug（helloWorld）が不正です。slugは半角英数字（a-z0-9）、ハイフン（-）、アンダースコア（_）の12〜50字の組み合わせにする必要があります
  

  • 解決方法 -> 素直にzenn-cliで記事を作成する
    • 結果:自動的に良きに計らってくれる
    • 必須となるテンプレートも記述されている