ブログをAstroに移行する

Quartz v5によるブログ環境でquartzによるブログを作成したのが1か月ちょっと前のことだが、さっそく作り直したくなってきた。

どうして移行するのか

Quartzである必要がなかった

Obsidianで書いた文章の公開ということで深く考えずにQuartzを選択していたが、実際にはMarkdownで書いた文章の公開ができればよく、Quartzの機能がむしろ邪魔になっていた。

カスタマイズ性への不安

Quartzではプラグインの設定を通じてカスタマイズを行うことができるが、設定幅は思ったより広くなかった。Quartz自体やプラグインをいじって対応していくことになりそうだが、そうするとアップデートに追従できるかなどの不安も出てくるし、いよいよQuartzを使っている意味がなくなってくる。

なぜAstroなのか

あまり深い理由はない。

• ブログにはAstroみたいなイメージ
• 簡素でロードの速い個人サイトへの憧れ

作業内容

やったことをメモしておく。

テーマ選定

Astroの公式サイトにテーマがたくさんある。テーマというよりはテンプレートという感じで、カスタマイズしてると移行はちょっと面倒そう。

Themes | Astro

Astro builds fast content sites, powerful web applications, dynamic server APIs, and everything in-between.

astro.build

とりあえずAstroPaperというテーマを使っている。

設定

astro.config.tsとastro-paper.config.tsでいろいろと設定ができる。 あとsrc/i18n/lang/ja.tsを作成してうまいことやる。

カードリンク

remark-link-card-plusというプラグインを導入した。

Markdown内のリンクをカード化するremarkプラグインremark-link-card-plusをリリースした | okaryo.log

正月駆動開発

blog.okaryo.studio

GitHubなど用に個別のカードを作るのもよさそうだが、今回は面倒なのでやらない。

draftをdevで表示する

dev環境ならdraft:trueの記事も表示されるようにした。 個人的に完成形を見ながら文章を書きたいのでこうしている。

Obsidianで書いたMarkdownの変換

Obsidian側で書いたMarkdownをブログ側に配置するスクリプトを書いて使っている。

いまはいろいろ試しつつやっているので詳しくは書かないが、固まってきたら別記事で書くかもしれない。

description list

description listを使うで書いたように、Obsidianでdescription listを利用しており、それをこっちでもレンダリングできるようにする。

この記事内でも冒頭で利用している。

ホットリロードが不安定

なんかやたら不安定だと思っていたら最新バージョンにあるバグだった。

Fix circular import in virtual:astro:routes causing "undefined is not a function" with server:defer + astro:i18n by astro-factory[bot] · Pull Request #17787 · withastro/astro

Summary Switches the import in the generated virtual:astro:routes module from 'astro/app' (the barrel export) to 'astro/app/manifest' (the direct path), breaking a circular dependen...

github.com

v7.1にダウングレードしたら直った。