設定ガイド

Xingluo の設定可能なオプションはすべて、ルートレベルの xingluo.config.ts にあります。このファイルは defineXingluoConfig による完全な型制約を提供し、変更はソースコードに触れることなく即座に反映されます。

site

ts
site: {
  url: "https://xingluo.example.com/",  // サイトURL（絶対リンク、RSS、サイトマップに使用）
  title: "Xingluo",                      // サイトタイトル
  description: "A modern blog CMS built with Astro and shadcn",
  author: "Xingluo",                     // デフォルトの著者名
  profile: "https://xingluo.example.com", // 著者のホームページ（JSON-LD に使用）
  ogImage: "default-og.jpg",              // デフォルトOG画像（public ディレクトリ内）
  lang: "zh-cn",                          // デフォルト言語
  timezone: "Asia/Shanghai",              // タイムゾーン（投稿日時の表示）
  dir: "ltr",                             // テキスト方向: ltr | rtl
  googleVerification: "",                 // Google Search Console 確認値（または環境変数経由）
}

posts

ts
posts: {
  perPage: 8,              // リストページごとの投稿数
  perIndex: 5,             // ホームページに表示する投稿数
  scheduledPostMargin: 900000, // 予約公開の許容範囲（ミリ秒）、15分
}

• perPage: /posts/[...page] および /tags/[tag]/[...page] のページサイズ
• perIndex: ホームページの「最新」セクションに表示する投稿数
• scheduledPostMargin: この時間枠内の未来の投稿は公開済みとして扱われます（本番で有効。開発ではすべて表示）

features

ts
features: {
  lightAndDarkMode: true,
  dynamicOgImage: true,
  showArchives: true,
  showBackButton: true,
  editPost: { enabled: true, url: "https://github.com/.../edit/main/" },
  search: "flexsearch",
  mdx: true,
  comments: { provider: false /* giscus | twikoo | waline */ },
  players: { aplayer: false, dplayer: false },
}

editPost

editPost.url はリポジトリの編集 URL プレフィックスです。Xingluo は投稿の相対ソースパス（src/content/posts/...）を末尾に追加します。例：

ts
editPost: { enabled: true, url: "https://github.com/owner/repo/edit/main/" }

投稿 src/content/posts/welcome.md はリンク https://github.com/owner/repo/edit/main/src/content/posts/welcome.md を生成します。

socials

ts
socials: [
  { name: "github", url: "https://github.com/xingluo/blog" },
  { name: "x", url: "https://x.com/xingluo" },
  { name: "mail", url: "mailto:[email protected]" },
];

• name: アイコン名。src/assets/icons/socials/{name}.astro に対応します。組み込み: github、x、mail、facebook、telegram、weibo
• url: リンク URL。メールには mailto: を使用
• linkTitle: オプションのアクセシブルなタイトル。省略時は名前から自動生成

ソーシャルプラットフォームの追加: src/assets/icons/socials/ に同名の .astro アイコンコンポーネントを作成します。src/lib/socialIcons.ts が import.meta.glob で自動的に収集します。

shareLinks

ts
shareLinks: [
  { name: "x", url: "https://x.com/intent/post?url=" },
  { name: "facebook", url: "https://www.facebook.com/sharer.php?u=" },
  { name: "telegram", url: "https://t.me/share/url?url=" },
  { name: "weibo", url: "https://service.weibo.com/share/share.php?url=" },
  { name: "mail", url: "mailto:?subject=...&body=" },
];

これらの共有エントリは投稿ページの下部に表示されます。url は共有 URL プレフィックスで、Xingluo は現在の投稿の絶対 URL を末尾に追加します。name は同様に src/assets/icons/socials/ 内のアイコンにマッピングされます。

環境変数

astro.config.ts の env.schema で宣言されます：

例（PowerShell）:

powershell
$env:PUBLIC_GOOGLE_SITE_VERIFICATION = "your-verification-code"
pnpm build

この値は config.site.googleVerification に注入され、<meta name="google-site-verification"> としてレンダリングされます。

完全な例

xingluo.config.ts を参照してください。features.comments および features.players セクションには、giscus / twikoo / waline のコメントアウトされた例が含まれています。コメントを解除して実際の値を入力することで有効化できます。