chore: ワークスペース運用規則の更新(1ページ1コンテンツ、マクロ詳細化、分割推進、Seesaa Wikiニュートラルグレー準拠)

This commit is contained in:
armonica committed 2026-10-28 11:11:37 +09:00
1 parent b28506ab75
commit a5a796b13c
2 files changed
+72 -46

No files matched your search

+36 -23
View File
@@ -8,26 +8,39 @@
本リポジトリは、ファイナルファンタジーXIV(FF14)の攻略情報・ジョブ立ち回り・クロスホットバー(XHB)設計・ギャザクラ育成ロードマップを集約した**「ローカルHTML型Wikiナレッジベース」**です。
### 1.1 ポータルページ(`index.html`)の常時最新化
- **新規ページ追加時の必須タスク**:
- 新しい攻略HTMLファイルを作成した際は、必ずポータルページ `index.html` に該当ガイドの**カード(カードバナー、カテゴリタグ、レベル帯、タイトル、概要、主要トピック3点、検索タグ、リンクボタン)**を追加してください。
- カテゴリーフィルターおよびリアルタイム検索が正常に動作するよう、`data-category` および `data-keywords` を適切に設定してください。
- ヘッダーの収録統計(ガイド本数など)を更新してください。
- **既存ページ更新時の同期**:
- ガイドの内容変更・レベル上限解放・パッチ対応などを行った際は、`index.html` の該当カードの記載内容も最新情報に同期させてください。
### 1.1 【最重要】1ページ1コンテンツの原則&積極的なフォルダ・ページ分割
- **1ページ1コンテンツの徹底**:
- 極力1つのHTMLファイルには単一の明確なトピック(例: 「召喚士のXHB配置」「吟遊詩人の戦歌ローテーション」「ギャザクラ全NPC座標一覧」など)のみを記述してください。
- 1つの長大なページに複数のジョブや無関係なテーマを詰め込むことは禁止とし、トピックごとに明確に分割してください。
- **積極的なフォルダ分類(階層化)**:
- 大カテゴリごとにフォルダを作成し(例: `jobs/summoner/`, `jobs/bard/`, `crafter_gatherer/`, `xhb/`, `multiplayer/` 等)、各フォルダ内に目的別のHTMLページを整理して配置してください。
- 各フォルダには必要に応じて案内用トップページ(`index.html`)を設置してください。
### 1.2 全ページ共通ナビゲーションバーの設置
- 新しく作成するすべての攻略HTMLファイルには、ページ最上部(`<body>` 開始直後)に共通ナビゲーションバー(`class="wiki-global-nav"`)を設置してください。
- 共通ナビゲーションバーには以下を含めてください:
- ポータル(`index.html`)へのリンク(「🏛️ FF14 攻略ポータル (Wiki TOP)」)
- 各主要攻略ページへのクイックリンク
- 現在開いているページのリンクには `class="wiki-nav-item current"` を付与してハイライト
- 既存のCSSデザイン(ダークテーマ、アクセントゴールド `#d4af37`)と整合する共通CSSを `<head>` 内に含めてください。
### 1.2 【最重要】マクロ設定・機能解説の完全詳細記述
- **マクロの全行・全設定の完全記述**:
- マクロ設定やゲーム内機能を解説する際は、概要のみで済ませず、**マクロの全コード行(`/micon`、代名詞 `<t>`/`<me>`/`<mo>`、ウェイト `<wait.1>` 等)を省略なく完全に記述**してください。
- なぜその記述順序なのか、行ごとの役割、連打時の挙動、ターゲットがいない場合のフェイルセーフ仕様、設定時の注意点まで余すところなく詳細に解説してください。
### 1.3 HTMLデザイン・クオリティ基準
- すべての攻略ガイドはスタンドアロンで美しく閲覧できる単一HTMLファイル(CSS/JS内包)として構成してください。
- デザインテーマ: FF14のUIや世界観と調和する高品質なダークファンタジー調(背景 `#0a0e17`〜`#141b27`、金 `#d4af37`、クリスタル青 `#38bdf8` 等)。
- ゲームパッド(XHB/WXHB)の配置図や、60秒/120秒バースト周期のフローチャートなど、プレイヤーが視覚的・直感的に理解できるリッチなUIコンポーネントを積極的に採用してください。
### 1.3 【最重要】デザインテンプレート「Seesaa Wiki ニュートラルグレー」の厳格適用
- 全ページのUIデザインは、日本の定番ゲームWikiスタイルである**「Seesaa Wiki ニュートラルグレー」**を踏襲してください。
- **共通CSSの適用**:
- すべてのHTMLページは `common/css/seesaa_neutral_gray.css` をリンクして読み込んでください。
- **デザイン規範**:
- **背景色**: 落ち着いたニュートラルグレー系(`#f0f0f2` 〜 `#e6e6e9`)
- **メインコンテンツ**: 白色(`#ffffff`)、視認性の高いダークグレー本文(`#2b2b2b`)
- **2カラムレイアウト**:
- **左サイドバー**: メニュー(カテゴリー一覧、主要ページリンク、サイト内検索、最近の更新)
- **右メインコンテンツ**: パンくずリスト、ページタイトル、最終更新日、本文、ページネーション
- **見出しスタイル**:
- H2(大見出し): ニュートラルグレーの帯見出し(`#646c7a` または `#e8e9ec` に左太線アクセント)
- H3(中見出し): 下線ボーダー+左縦線アクセント
- **テーブル・マクロ表示**:
- テーブルヘッダー: 薄いグレー(`#ececf0`)
- マクロ枠(コードブロック): 背景 `#f7f7f9`、罫線 `#d8d8de`、等幅フォント、コピー機能や詳細注釈を併記
### 1.4 ポータルページ(`index.html`)の常時同期
- 新規ページを追加、または構成を変更した際は、必ずトップポータル [`index.html`](file:///z:/FF14攻略/index.html) のサイトマップ、カテゴリーリンク、収録統計を同期更新してください。
- サイドバー共通メニューにも適宜最新のページ構造を反映させてください。
---
@@ -36,17 +49,17 @@
ユーザーからの明示的な指示がなくとも、**変更作業を行った際は必ず自律的にGitコミットを実施してください**。
### 2.1 コミットのタイミング
- ガイドの新規作成、既存ガイドの加筆・修正、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。
- ガイドの新規作成、既存ガイドの加筆・分割、ポータルの更新、設定変更などの作業が完了した際、**変更内容(論理的単位)ごとに即時コミット**を行ってください。
- 複数の無関係な修正を1つのコミットに混ぜず、適切な単位で分割してコミットしてください。
### 2.2 コミットメッセージの記法
- コミットメッセージは**分かりやすい日本語**で記述してください。
- プレフィックスを付与して変更種別を明示してください:
- `feat: `: 新しい攻略ガイドの追加、ポータル機能の追加
- `fix: `: スキル回し、数値、NPC座標、リンク等の誤り訂正
- `feat: `: 新しい攻略ガイドの追加、新機能・新ページの追加
- `fix: `: スキル回し、マクロ構文、数値、座標、リンク等の誤り訂正
- `docs: `: 既存ガイドの解説追記、ポータルの説明文修正
- `style: `: レイアウト調整、CSSデザインの改善
- `refactor: `: HTML/CSS/JSコードのリファクタリング
- `style: `: Seesaa Wikiニュートラルグレーのデザイン調整、レイアウト改善
- `refactor: `: ページ分割、ディレクトリ整理、コードのリファクタリング
- `chore: `: 設定ファイルや運用規則の変更
### 2.3 コミットの実行手順