はじめに
はてなブログとの併用を決めた背景には、技術系のアウトプット先として Qiita を追加するという判断があります。
これまでのはてなブログ運用(はてな記法 + post_to_hatena.py)と併用する形で、より多様な技術情報を発信するための選択肢として、Qiita CLI を導入しました。
Qiita API v2 直接利用 vs @qiita/qiita-cli の比較表
| 特徴 | Qiita API v2 を直接利用 | @qiita/qiita-cli |
|---|---|---|
| ローカルプレビュー | ❌ | ✅ |
frontmatter での id 自動管理 |
❌ | ✅ |
| ローカル画像の自動アップロード | ❌ | ❌ |
| 非対話での認証対応 | ❌ | ✅ |
| 開発効率 | 低め | 高め |
| 記事の公開状態 |
private: true が必須 |
private: true が必須 |
併用ワークフロー全体図
セットアップ手順とディレクトリ構成
Qiita CLI を導入するには、以下の手順を踏みます。
-
npm install @qiita/qiita-cli --save-devにより、Qiita CLI を開発用依存ライブラリとしてインストールします。 -
npx qiita initで、ディレクトリ構成(public/,qiita.config.json,.github/等)を初期化します。
このとき、public/ ディレクトリ以下に記事を配置し、qiita.config.json に設定を記載します。
導入時にハマったポイント3つ
1. 非対話での credentials.json スキーマと chmod 600
非対話環境で認証を通す際には、~/.config/qiita-cli/credentials.json の形式を揃える必要があります。
default と credentials 配列の形式を確認し、パーミッションを 600 に設定する必要があります。
2. v0.5.0 以降の frontmatter 必須項目と private: true
v0.5.0 以降、frontmatter に id と private が必須項目として追加されています。
private: true が明記されていないと、記事は全体公開扱いになるため、注意が必要です。
3. ローカル画像非対応への対処
Qiita CLI はローカル画像の自動アップロードに対応していません。
プレビュー画面や外部URLを使う運用にしています。
まとめ
これで、ローカル執筆→プレビュー確認→限定共有投稿のサイクルが回り始めました。
はてなブログとの併用もスムーズにできるようになりました。
じゃあね。
