開発環境セットアップ

前提条件

要件

バージョン

備考

uv

0.5+

Python のパッケージ管理と仮想環境

Python

3.12+

uv によって自動的にインストールされます

Node.js

24+

Pagefind の検索インデックス生成に使用します

uv のインストール

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Homebrew
brew install uv

リポジトリのクローン

git clone https://github.com/Nagatatz/jpyc-tipjar-widget.git
cd jpyc-tipjar-widget

依存関係のインストール

cd sphinx-docs
make install    # install dependencies with uv sync

セットアップの確認

make html       # build the English HTML
make serve      # preview at localhost:8000