Docs更新依頼(このファイルを見てHTML更新)¶
このファイルは、docs/ 配下のMarkdown更新を「左ナビに必ず反映」した上で、静的HTML(site/)を再生成してもらうための依頼フォームです。
運用ルール(固定)¶
- 新規追加/更新したMarkdownは、必ずMkDocsの左ナビ(
mkdocs.ymlのnav)に載せる - HTML更新は
./scripts/docs-build.sh(=mkdocs build)でsite/を再生成する - 本番反映は下記「デプロイ手順」でFTPアップロード
デプロイ手順(本番反映)¶
接続情報¶
| 項目 | 値 |
|---|---|
| サーバー | sv16678.xserver.jp |
| ユーザー | ksb1969 |
| パスワード | 8wp912x5 |
| アップロード先 | /kitazo-group.com/public_html/docs.kitazo-group.com/ky/ |
| 本番URL | https://docs.kitazo-group.com/ky/ |
アップロード手順(PowerShell)¶
リポジトリルートで実行:
cd "g:\マイドライブ\AzureRAG\KnowledgeYardV2"
$siteRoot = (Resolve-Path "site").Path
Get-ChildItem -Path $siteRoot -Recurse -File | ForEach-Object {
$rel = $_.FullName.Substring($siteRoot.Length + 1).Replace('\','/')
$url = "ftp://sv16678.xserver.jp/kitazo-group.com/public_html/docs.kitazo-group.com/ky/$rel"
Write-Host "Uploading: $rel"
curl.exe -T $_.FullName --ftp-create-dirs -u ksb1969:8wp912x5 $url
}
依頼の書き方¶
1) 下の「依頼内容」を更新する(追記でOK) 2) チャットで次の一文を送る:
- 「docs/docs-update-request.md を見て、ナビ更新+HTML再生成(
site/更新)してください」
依頼内容(ここを更新)¶
依頼日: 2026-01-07
変更一覧¶
変更が複数ある場合は、上から優先順に。
- 種別: 更新
- ファイル: docs/xxxxx.md
- 変更概要: (例)費用見込みを更新、図を差し替え
- ナビ表示名: (例)現状報告書(2026-01)
-
ナビ配置先(必須): (例)レポート / 開発・運用 / データ / 評価・テスト / 連携 / 全体像
-
種別: 追加
- ファイル: docs/yyyyy.md
- 目的: (例)SSOの運用手順を追記
- ナビ表示名: (例)SSO運用
- ナビ配置先(必須): (例)開発・運用
備考(任意)¶
- (例)既存ページの名称も変えたい、並び順をこうしたい、など