はじめに
QiitaでGitHub Actionsを使って記事を管理する方法が掲載されていたので、試してみました。
$ npx qiita new 20250215_newarticle
$ emacs public/20250215_newarticle.md
$ git add public/20250215_newarticle.md
$ git push
この記事を含む私のQiita記事はGitHub上で公開しています。
下書きに登録されている記事の取り扱い
npx qiita pullを実行すると公開されている記事が全てダウンロードされます。
裏を返すと下書きに登録されている記事はqiita.com上に置かれたまま同期の対象とはなりません。
１度記事を投稿して公開すればnpx qiita pullで新規記事としてダウンロードできるはずなので、一応確認しておきます。
下書きに登録されている記事を公開してから同期を取る
記事を完成させて反映させてから同期させます。
$ npx qiita pull
gitコマンドで差分を確認します。
$ git status
On branch main
Your branch is up to date with 'origin/main'.
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: .gitignore
modified: Makefile
Untracked files:
(use "git add <file>..." to include in what will be committed)
public/20250215_newarticle.md
public/36dbe88619c258eb5b74.md
no changes added to commit (use "git add" and/or "git commit -a")
qiita.com上で投稿した記事はIDがそのままファイル名になってpublic/以下にコピーされています。
登録済みの記事をpushして変化がないか確認する
public/36dbe88619c258eb5b74.mdをcommitしてgit pushしてみます。
この時の記事の更新時刻はupdated_at: '2025-02-15T21:18:13+09:00'でした。
$ git add public/36dbe88619c258eb5b74.md
$ git commit -m 'Added new published article public/36dbe88619c258eb5b74.md.'
$ git push
この後、npx qiita pullを実行しても特に変化はなく、既存の記事がGitHub Actionsで処理されることはありませんでした。
新規記事を投稿する
書きかけの public/20250215_newarticle.md を登録します。
$ git add public/20250215_newarticle.md
$ git commit -m 'Added new article public/20250215_newarticle.md.'
$ git push
GitHubのプロジェクトページに移動して、Actionsタブから経過を見守ります。
30secで処理が完了したと記録されていますが、git pushしてからは2分ぐらいは経過していた印象です。
気がついたこと
preview機能が秀逸
ファイルの更新に応じてpreviewも更新されるためQiita公式サイトで編集するのと大きな違いを感じませんでした。
画像ファイルのアップロードはpreviewページのリンクを辿って公式サイトで手動で管理しなければいけない点は少し面倒ですが、クリップボードからのコピーができてMarkdown形式でURLのコピーが出来るので、これは大きな障害ではないと思っています。
内容の重複するファイルが作成されてしまう
npx qiita newで作成したファイルをgit add/commit/pushすると、ActionsによってQiitaに記事が登録されます。
しばらくこの現象を追っていましたが、GitHub Actionsではnpx qiita publish --all相当の処理が行われているだけなので、原理的にこれはおかしな現象でした。
いまのところ、この現象は再発していないので、このセクションの内容は無視してもらえればと思います。
この後にnpx qiita pullを実行するとGitHub ActionsからQiita側に登録された記事がpublic/87881ee04e6052acafee.mdのようなファイル名で新しく作成されます。
こちらで適当に作成したファイル名とQiita側で統一的にIDで管理されているファイルの2つが出来るのは当然ですが、どちらを編集するべきか、考えなければいけないという点では少し悩ましいです。
GitHub側から全てのファイルをpushして、npx qiita pullを止めれば良いというのは、revalidationが出来なくなる点で問題があります。
これは結構悩ましく、投稿したことでIDが確定するのでファイル名は予測不可能です。
後からgit mvでIDのファイル名に変更するのが最善手のように考えています。
git pushをすると常にコンフリクトが発生してしまう
しばらく使ってみるとGitHub Actionsがgithub.com側のmainブランチを更新するので、git pullを実行すると常にmergeが動いてしまうことに気がつきました。
差分を確認するとupdated_at:行が変化しただけですね。
diff --git a/public/87881ee04e6052acafee.md b/public/87881ee04e6052acafee.md
index 8e6c8b1..53bd9eb 100644
--- a/public/87881ee04e6052acafee.md
+++ b/public/87881ee04e6052acafee.md
@@ -4,7 +4,7 @@ tags:
- GitHub
- qiita-cli
private: false
-updated_at: '2025-02-15T23:38:56+09:00'
+updated_at: '2025-02-15T23:47:08+09:00'
id: 87881ee04e6052acafee
organization_url_name: null
slide: false
このためgit pushした後は、Actionsの処理が終わってから``git pull`を実行するようにしています。
ファイルを登録する際にはnpx qiita publishで投稿してから変更分をGitHub Actionsに処理させる方法が良さそうです。
更新したいファイルを探すのが少し面倒
Webページから検索するのも、grepコマンドを使うのもあまり大差ないのですが、せっかくgitでファイル単位で管理できるようになってもファイル名は手掛りにならないのは少し物足りなく感じます。
更新履歴のコメントが反映されない
Gitのコミットログがそのまま反映されても困るなぁと思いつつ、公式サイトの更新履歴には何も記載されていませんでした。
編集履歴を確認する人もそんなにいないかもしれませんし、自分が分かれば良いという点ではgitコマンドで差分が確認できるから良いよね、とは思いつつ、一言ぐらいは何か残しておきたい気もします。
さいごに
丸1日、qiita-cliを使ってみましたが、総じて問題はないのかなと思います。
無理にGitHubと連携させなくても、npx qiita new/publish とgitコマンドを連携させても十分な気もしますし、この点は好みで使い方を決められるという点では良いのかもしれません。
また、GitHub Actionsに触れるための最初の一歩としても良い機会かもしれません。
.github/workflows/publish.ymlとincrements/qiita-cli/actions/publish@v1を読めば、GitHub Actionsが何をやっているのか、何となく分かると思います。