サイトの更新
本文を編集する
docs/ のMarkdownファイルを編集します。通常の更新では、元プラグインのHTML生成スクリプトやソースコードを実行する必要はありません。
新しいページを追加する
カテゴリのフォルダーに、例えば tips.md を追加します。
- Blockbenchプラグイン：
docs/plugins/<プラグイン名>/ - アドオン・カスタムコマンド：
docs/addons/ - 汎用アトラクションシステム：
docs/attractions/
---
title: 作業のヒント
order: 50
---
# 作業のヒント
## よく使う操作
ここに本文を書きます。サイドバーはMarkdownファイルから自動生成されます。title は表示名、order は並び順です。どちらも省略できます。ファイルを追加した後は開発サーバーを再起動してください。ビルド時には新しいページと検索の索引が自動で取り込まれます。
画像とリンク
共有画像は docs/public/images/ に置き、 のように指定します。ページへのリンクは [使い方](./guide) または /plugins/プラグイン名/guide の形式です。
UIを調整する
- サイト名・ナビゲーション・検索・目次：
docs/.vitepress/config.mjs - サイドバーの生成：
docs/.vitepress/navigation.mjs - 色・余白・文字・スマートフォン表示：
docs/.vitepress/theme/custom.css - カテゴリのカード・手順・折りたたみ：
docs/.vitepress/theme/manual-catalog.css - カードの表示部品：
docs/.vitepress/theme/ManualCards.vue - Vueコンポーネントの追加：
docs/.vitepress/theme/index.mjs - GitHubのURL・編集リンク：
site.config.mjs
Codexには対象ページや設定ファイルを指定して、文章・UI・機能の変更を依頼できます。公開前に npm run build を実行すると、ビルドとページ内リンク・画像の参照を確認できます。
公開する
Cloudflare PagesとGitHubの接続後、main にpushするとサイトが更新されます。初回設定、ローカル開発、認証の手順は、このサイトのリポジトリにある README.md を参照してください。
公開先と更新の確認
公開中のマニュアルは blockbench-manuals.pages.dev です。
個人リポジトリのmainをCloudflare Pagesに接続しています。Markdownを編集し、ビルドを確認してmainへpushすると、新しいコミットからサイトを自動生成します。
Cloudflare PagesのDeploymentsで、ProductionのコミットがGitHubの最新コミットと一致していることを確認します。その後、このページを再読み込みして、変更した文章や画像が表示されることを確認してください。
図解UIを保って編集する
Motion Rig StudioとTexture Paint Studioは、元のカード・図・手順番号・折りたたみ・比較操作を通常ページに引き継いでいます。本文は各ページのMarkdownで更新します。カードや操作デモのHTMLも同じファイルに含まれます。
文章を修正するときは、図解部品のclass、id、data属性を残してください。新しいページのテンプレートとUIの編集箇所はリポジトリのREADMEを参照できます。