Anoy Backstage v0.3
internal 6 日前に更新

運用ガイド

ページを追加する

  1. content/<project>/internal/ または content/<project>/public/ に MD を置く
  2. (初回プロジェクトなら)content/<project>/_project.yaml を書く
  3. npm run build
  4. Git にコミット → push でデプロイ(CI 設定後)

新しいプロジェクトを起こす

mkdir -p content/<slug>/{internal,public}
cat > content/<slug>/_project.yaml <<EOF
title: プロジェクト名
summary: 一行サマリ
order: 10
EOF

これだけ。MD を 1 本置けばメニューに自動で出る。

ローカルで確認する

npm run dev   # build + http.server :8888

ブラウザで http://localhost:8888/ を開く。

公開範囲の切り替え

  • internal/ 配下 → Cloudflare Access(Google 認証)必須
  • public/ 配下 → Access の Bypass policy で匿名アクセス可(要設定)

ビルダーは public ページの nav から internal リンクを除去する。タイトル経由の漏洩は防いでいる。

デザイン正本

anoy-share/_design-guide.md を正本として参照する。 ここの assets/styles.css はその時点でのスナップショット。 正本が更新されたら手動同期する(自動化は v0.2 以降)。