ブログを初期化する
このテンプレートを使ってブログを始めるまでの手順をまとめる。所要時間は15分ほど。
必要なもの
- Python 3.11以上 — Flask を動かすために必要
- uv — パッケージ管理。
brew install uvでインストール - Obsidian — 記事を書くエディタ。無料で使える
- Git — バージョン管理とデプロイに使う
1. テンプレートを取得する
GitHubのテンプレートリポジトリから自分のリポジトリを作成する。
- GitHubの「Use this template」ボタンをクリック
- リポジトリ名を入力(例:
myblog) git cloneでローカルに取得
git clone https://github.com/yourname/myblog.git
cd myblog
2. 依存パッケージをインストールする
uv venv
uv pip install -r requirements.txt
3. ObsidianでVaultを開く
Obsidianを起動し、「別のVaultを開く」→「フォルダをVaultとして開く」から content/ フォルダを選択する。
これだけで以下の設定が有効になる:
- 新規ノートの保存先 →
posts/ - 添付ファイルの保存先 →
assets/ - テンプレートフォルダ →
templates/
4. ローカルで起動する
uv run python app.py
http://localhost:5000 をブラウザで開くとブログが表示される。
5. 最初の記事を書く
Obsidianでコマンドパレット(Cmd+P)を開き、「テンプレートの挿入」→「新規投稿」を選択する。フロントマターが自動で入力されるので、タイトルとsummaryを書いて記事を書き始めればいい。
Obsidianの使い方の詳細はこちら。
6. サイト名を変更する
デフォルトのサイト名は「My Blog」。変更するには環境変数で渡す:
SITE_NAME="自分のブログ名" uv run python app.py
デプロイ時は Cloudflare Pages の環境変数 に設定する。