ブログのやり方で結構迷走してたからそれをまとめる
最初
初めは、HTMLを手打ちしていました。basestyle.cssはWebから持ってきたものの詰め合わせみたいな感じでしたが、それ以外はなんだかんだで全部手打ちでした。ですが、複数行のコードを表示するときにつまづきました。
Vitepress
そういったことで、Vitepressというエンジンを使ってみました。しかし、肝心のGitHub Pagesへの公開をうまくできなかったので、変更することにしました。今
とりあえずRustで[md2html](https://github.com/shizukani-cp/md2html.git)というツールを気合いで作って、それを使うことにしました。 なので、使い方を見ればあるだろうと推測できますが、contentsフォルダーの直下にtemplate.htmlがいたり、それぞれの記事のフォルダーにentry.mdがいたりします。2024/12/24追記
md2htmlだと説明文をHTMLにするたびに書かなくてはならず、面倒だったため、[blog_manage](https://github.com/shizukani-cp/blog_manage.git)というツールをつくりました。箇条書きがうまくいっていなかったりするのですが、とりあえずどうにかなっています。
2025/07/23追記
blog_manageだとローカルでビルドを実行する必要があったり、ソースになるmarkdownと出力結果のHTMLが衝突する懸念があったりで、 markdownの方がGit管理できていなかったのですが、Github Actionsでサーバー側でビルドできるようになったので 出力先をdocsにしてpublic的な用途で使うことで、ゴリ押しでやっています。 ちなみにmarkdownからHTMLへの変換のコアはblog_manageと変わっていないので、箇条書きできない問題は今でも放置になっています。さらにこれを書いたあとの追記
Gemini君に聞いてみたら箇条書きの前には空行が必要とのこと。実際にやってみたら箇条書きできない問題は解決しました。つまり...私を半年以上苦しめてきた原因は私にありました。自業自得。