環境構築ガイド

研究室PCおよびWikiのローカル環境のセットアップ手順です。

環境構築ガイド

1. 必要なツール

ツールバージョン用途
Git2.40 以上バージョン管理
Python3.11 以上CLI ツール
Zola0.19.xWiki ビルド(任意:ローカルプレビュー用)

2. リポジトリのクローン

git clone https://github.com/scr-lab/wiki.git scr-lab-wiki
cd scr-lab-wiki

3. Zola のインストール(ローカルプレビュー用)

macOS

brew install zola

Linux (Ubuntu/Debian)

ZOLA_VERSION="0.19.2"
curl -sL \
  "https://github.com/getzola/zola/releases/download/v${ZOLA_VERSION}/zola-v${ZOLA_VERSION}-x86_64-unknown-linux-gnu.tar.gz" \
  | tar -xz -C /usr/local/bin

Windows

Zola リリースページ から zola-v*-x86_64-pc-windows-msvc.zip をダウンロードし、PATH の通った場所に配置してください。

4. ローカルプレビュー

bash tools/build.sh --serve --drafts

ブラウザで http://127.0.0.1:1111 を開くと、ファイル変更を検知してリロードされます。

5. 最初のページを作成する

python tools/new_page.py "私のはじめてのページ" --category knowledge --author "Yamada Taro"
エディタの設定
`$EDITOR` 環境変数を設定しておくと、ページ作成後に自動でエディタが起動します。 ```bash # .bashrc / .zshrc に追加 export EDITOR="code" # VS Code の場合 export EDITOR="vim" # Vim の場合 ```