Wyam | Jamstack
A simple to use, highly modular, and extremely configurable static content generator.
https://www.staticgen.com/wyam
インストール
初期化する
- config.wyam(siteの設定)
- input(記事置き場)
- about.md
- posts
- first-post.md
設定ファイル
config.wyam がそれで、C# を Roslyn で処理するらしい。 おもしろい。
#recipe Blog
がパイプライン設定で、 input フォルダの構成と処理を設定している。
設定ファイルに展開したものを記述することもできるみたい。
gitignore
wyam.io
https://wyam.io/docs/advanced/what_to_exclude_from_source_control
生成する
- output
- index.html
$ wyam --watch --preview
で更新を監視して livereload できる。
動作
- input/posts/ 配下の markdown が /posts/ 下にhtml化される
- input/posts/**/hoge.md が /posts/hoge.html のように階層は無くなる
テーマを変えてみる
コマンドラインに、 --theme THEME_NAME
とするか config.wyam に
とすれば OK。
appveyor で GitHub-Pages に展開
wyam.io
https://wyam.io/docs/deployment/appveyor
CIよくわかってないので難航したが動くようになった。
GitHub-pages のユーザー頁を使ったので、 ソースのリポジトリと、html置き場のリポジトリを分けた。
ソースのリポジトリに AppVeyor を仕掛けて、 push したときにビルドして、html置き場に push する。
vscode で編集する
watch タスクを作成してバックグランドで input
の変更を監視。
launch.json を作成して F5 でブラウザを開く。
自動でリロードがかかるので快適。
参考
日本語で wyam に言及しているサイトはこれしかなかった。 マイナーでござる。