ブログのやり方で結構迷走してたからそれをまとめる

最初

初めは、HTMLを手打ちしていました。basestyle.cssはWebから持ってきたものの詰め合わせみたいな感じでしたが、それ以外はなんだかんだで全部手打ちでした。

ですが、複数行のコードを表示するときにつまづきました。

Vitepress

そういったことで、Vitepressというエンジンを使ってみました。しかし、肝心のGitHub Pagesへの公開をうまくできなかったので、変更することにしました。

今

とりあえずRustでmd2htmlというツールを気合いで作って、それを使うことにしました。 なので、使い方を見ればあるだろうと推測できますが、contentsフォルダーの直下にtemplate.htmlがいたり、それぞれの記事のフォルダーにentry.mdがいたりします。

2024/12/24追記

md2htmlだと説明文をHTMLにするたびに書かなくてはならず、面倒だったため、blog_manageというツールをつくりました。

箇条書きがうまくいっていなかったりするのですが、とりあえずどうにかなっています。

2025/07/23追記

blog_manageだとローカルでビルドを実行する必要があったり、ソースになるmarkdownと出力結果のHTMLが衝突する懸念があったりで、 markdownの方がGit管理できていなかったのですが、Github Actionsでサーバー側でビルドできるようになったので 出力先をdocsにしてpublic的な用途で使うことで、ゴリ押しでやっています。 ちなみにmarkdownからHTMLへの変換のコアはblog_manageと変わっていないので、箇条書きできない問題は今でも放置になっています。

さらにこれを書いたあとの追記

Gemini君に聞いてみたら箇条書きの前には空行が必要とのこと。実際にやってみたら箇条書きできない問題は解決しました。

つまり...私を半年以上苦しめてきた原因は私にありました。自業自得。

2025/11/10追記

Next.jsを使う超大々的な改造をしました。コメント欄や前後の記事へ行くボタンがなくなってしまいました。 tmp(下書きフォルダ)が消えて焦りましたがバックアップを取っておいたのが幸いして大丈夫でした。