Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,549 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ブログ自動ビルド処理

このプロジェクトでは、あるTXT形式の原稿を source_txt/ ディレクトリ内にプッシュすると それらの記事を docs/ フォルダ内に静的なHTMLサイトとして変換する自動ビルド機能が実装されてます。

txtからHTMLへの変換について

ビルドスクリプト scripts/build.pysource/*.txt を読み取り、 docs/ 以下に月別・カテゴリ別の HTML を生成します。 生成に使用する処理は以下のみです(以下はローカルでの実行コマンド)。

python scripts/build.py

このビルドスクリプトを実行することで、サイトをローカルでプレビューすることが可能になります。
なお、docs/ 内の既存ファイルは、ビルドのたびに上書きされますのでご注意ください。

GitHub Actionsによる自動化ワークフロー

GitHub Actionsを用いたワークフローにより、mainブランチへの「source_txt/」へのpushごとに自動的にビルド処理を行います。 このアクションは変換スクリプトを実行し、生成されたHTMLをコミットすることで、ブログが常に最新の状態に保たれるようになります。

ブログ投稿者はsource_txt/source_img/source_js/、内のみ操作するようにしてください。

デザイン変更時はdesign/内を編集します(ただしその後にsource_txt内を更新して再ビルドを行うまで反映されません)

source_img/内に画像がpushされた場合、docs/image/内にコピーされます(新しい画像のみ)。

source_js/内に画像がpushされた場合、docs/js/内にコピーされます。

scripts/build.pyについて

build.pyは「source_txt/内に何かがプッシュされる」か「毎週土曜の明け方」のタイミングで実行されます。 実行されると、source_txt/内の全txtを使用してdocs/内に全期間・全カテゴリーのブログHTMLを生成します。

About

SmokingWOLFの開発日誌を原稿からHTMLに変換してPagesで公開するページ、docsディレクトリ内に記事HTMLが生成

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages