設定リファレンス:サイト名、ドメイン、共通ナビゲーション、ソーシャル、フッター
サイト情報、環境変数の上書き、固定ナビゲーションと共通リンク。
目次
最初の情報変更はインストールとサイト情報、ドメインの公開は配備ガイドへ。他のモジュールは総合案内から探せます。
設定先は src/site.config.ts です。既定値はテーマパッケージ由来で、デモの名前・アカウント・ドメインではありません。既存 defineThemeConfig({…}) の import、export、他モジュールを残して統合します。
site:サイト情報の6項目
site はオブジェクトで、部分設定では全項目を省略できます。表の全項目は条件付きで有効です。ページが読む際に使い、環境変数やページ固有の詳細な値が優先する場合があります。
| 完全パス | 型 | テーマ既定値 | 役割・制約・例 |
|---|---|---|---|
site.title |
string | "My Blog" |
ヘッダーブランド、著作権名、RSS、構造化データ、一部ページ・自動共有画像のサイト名。ホームの大見出しとは別で、統一の空値補完はなし。例 "私のブログ"。 |
site.description |
string | "Cinematic web interfaces, AI-era engineering notes, and system architecture essays." |
全体・機械可読索引説明の一部。ホームは messages.siteDescription、About・一覧は固有説明を優先し、全ページを置換しない。例 "プロジェクト、読書、日々の記録。"。 |
site.url |
string | "https://example.com" |
Astro site、canonical、RSS、sitemap、公開出力の絶対 HTTP(S) URL。記事 URL ではない。購入・DNS・証明書・公開を行わない。例 "https://blog.example.com"。 |
site.author |
string | "Your Name" |
既定著者と構造化データ。記事 author は上書き可。著作権は title で、About・メールも自動変更しない。例 "林"。 |
site.tagline |
string | "" |
trim するフッター短句。空または旧 Built with Astro. は表記重複を避け非表示。例 "好奇心を持ち、作り続ける。"。 |
site.ogImage |
string、任意 | "" |
ページ・記事の優先画像がないときの共有画像。空白は内蔵画像。public パス・HTTPS で、アバターや全記事カバー置換ではない。例 "/images/share.webp"。 |
site.title は全サイト名、i18n.locales.<locale>.site.homeTitle は各言語のホーム表示見出しです。後者は言語チェーンで非空値を探し、最後にサイト名へ戻ります。ホーム見出しを参照してください。messages.siteTitle は現在どちらにも使わないためブランド名変更には使えません。
site.description はホームの可視紹介文とは異なり、可視文は i18n.locales.<locale>.site.hero、メタ説明は messages.siteDescription です。ホーム辞書に優先順位があります。サイト情報を変えても既存 About 紹介は自動変更しません。
共有画像の優先順位とパス
共通 head にページ画像がないとき site.ogImage を使います。記事の ogImage、自動生成画像、カバーが優先し得ます。記事辞書を参照してください。自動生成が有効なら site.ogImage で全記事を上書きできません。
/images/share.webp は public/images/share.webp で、先に実ファイルを用意します。不在、publicDir 外、不正パスは予備画像の解析時にエラーです。ローカルには公開 base と内容バージョンを付け、HTTPS はそのままで取得検証しません。空・空白は内蔵画像に戻り、共有メタ情報を消す設定ではありません。
site.ogImage は文字列で、Astro image import オブジェクトは指定しません。記事 frontmatter.ogImage の型とは異なります。PUBLIC_SITE_OG_IMAGE の上書きはなく、heroImage も変えません。
環境変数とドメインの優先順位
以下は site.config の新項目ではなく、現在読み込む string 環境変数です。未指定なら対応 site 値を使います。null 合体で読み、空文字を自動的に未指定とは見なしません。
| 環境変数 | 優先して上書きする項目 | 例 |
|---|---|---|
| PUBLIC_SITE_TITLE | site.title | PUBLIC_SITE_TITLE=私のブログ |
| PUBLIC_SITE_DESCRIPTION | site.description | PUBLIC_SITE_DESCRIPTION=プロジェクトと学習ノート |
| PUBLIC_SITE_AUTHOR | site.author | PUBLIC_SITE_AUTHOR=林 |
| PUBLIC_SITE_TAGLINE | site.tagline | PUBLIC_SITE_TAGLINE=保持好奇 |
| PUBLIC_SITE_URL | site.url | PUBLIC_SITE_URL=https://blog.example.com |
統合は dev/build と –mode に対応する Vite dotenv モードで PUBLIC_SITE_URL を読み、Astro site と公開 URL を一致させます。既存プロセス環境は同名 dotenv より優先します。site.url だけ変えてホストの旧変数を忘れないでください。空文字は文面を消したり URL を無効にしたりし、既定へ戻す方法ではありません。
ページ側 SITE_URL には import.meta.env.SITE の互換中間値があり、PUBLIC_SITE_URL → SITE → site.url です。標準統合は変数または設定で Astro site を決め、head は Astro.site を優先します。SITE は adapter 互換用で別のドメイン設定として推奨しません。
ドメインと公開サブパスは別です。Astro base、配備出力、DNS/HTTPS は配備ガイドに従い、site.url に任意の子パスを入れても全ルートは移動しません。変更後は dev 再起動、本番再ビルド・再配備が必要で、サーバー転送は設定しません。
共通ナビゲーション:固定入口と機能スイッチ
公開 nav 配列、順序、独自メニュー項目はありません。標準ヘッダーの構成は次のとおりです。
| 位置 | 現在の出典と制約 |
|---|---|
| ブランド | site.title/環境変数。現在言語のホームへ移動。 |
| ホーム・Blog | 常に存在する標準入口。messages.nav.home/blog は名前だけで移動先を変えません。 |
| About | theme.enableAboutPage、boolean、既定 true。例 theme: { enableAboutPage: false } はページと入口を停止。 |
| Frontier の Decoder | theme.enableDecoderPage、boolean、既定 true。ヘッダー表記は固定 Decoder Lab。 |
| Frontier の Fragments | theme.fragments.enabled、boolean、既定 false。名前は messages.fragments.title。 |
| Frontier の Contact | About 有効時。messages.about.contact、現在言語の /about/#contact へ。Decoder と独立。 |
| 検索 | theme.search.enabled、boolean、既定 true。検索辞書へ。 |
| 言語・状態 | 有効言語、meta.label、下表の静的状態文面。言語は任意リンク一覧ではありません。 |
Frontier 自体の名前は固定で、子項目が全部ない場合に非表示です。messages.decoderPage.fullTool は完全ツールとフッターを変えますが、ヘッダーの Decoder Lab は変えません。
言語・URLと各 About・Fragments・Decoder 辞書を参照してください。空ラベルで入口を止めようとすると、リンクや意味不明なボタンが残ります。
ヘッダーとフッターの7文面
接頭辞は i18n.locales.<locale>.messages、任意 string です。内蔵現在言語と補完を使い、表は簡体中国語/英語の実値です。対応する領域があるときに有効で、文字として描画し Markdown・任意 HTML は解析しません。
| 相対項目 | 簡体中国語 / 英語既定値 | 役割と制約 | 例 |
|---|---|---|---|
nav.home |
首页 / Home | ホーム名。ルートは変えない。 | "ホーム" |
nav.blog |
博客 / Blog | Blog 名。ルートは変えない。 | "記事" |
nav.about |
关于 / About | About 名。ウィンドウ再表示入口も使う。 | "私について" |
nav.status |
system: online / system: online | 静的状態でネット・API・健康を検出しない。 | "システム稼働中" |
nav.statusAria |
系统状态 / System status | 状態領域のアクセシブル名。検査スイッチではない。 | "サイトの状態" |
footer.theme |
主题: / Theme by | テーマ表記接頭辞。Anglefeint の文字・リンクは固定。 | "テーマ提供" |
footer.builtWith |
构建工具: / Built with | Astro 表記接頭辞。文字・リンクは固定。 | "使用" |
messages.langLabel は言語控件、選択名は meta.label です。言語文面へ。Contact・Fragments は各モジュールを使い、nav に独自項目を作りません。
social.links:ヘッダーとフッターの共通リンク
- 型 / 既定値: SocialLink[] / []。各項目は下表の5フィールドです。
- 状態と役割: 有効。配列順で共通表示し、全置換します。公開件数上限や言語別設定はありません。
- 制約: [] は全領域を消さず、クリック不可の Mastodon・Twitter・GitHub を表示します。dev には設定案内も出ます。既存項目の空 href はその仮表示にはならず、リンクを出力します。
- 例: [{ label: ‘GitHub’, href: ‘https://github.com/yourname’, icon: ‘github’ }]。
About のメール・GitHub は独立し、自動変更しません。theme.social.enabled・hidePlaceholders の公開スイッチはなく、showPlaceholdersWhenEmpty はレイアウト引数です。
SocialLink の5項目
接頭辞は social.links[]。必須項目の自動補完はありません。入力の部分型が部分オブジェクトを認めても、完全で有効な項目を指定してください。
| 項目 | 型 / 既定値 | 状態・役割・制約 | 例 |
|---|---|---|---|
| href | 必須 string / なし | 有効。実 URL。方式・到達性・非空の統一検証や BASE_URL 追加はありません。完全 HTTPS か正しい内部パスを使い、検証済みアカウントとは見なさないでください。 | ‘https://github.com/yourname’ |
| label | 必須 string / なし | 有効。アクセシブル名で、アイコンがなければ可視文字。プラットフォーム名や対象タイトルから補いません。明確な非空名を記入します。 | ‘GitHub’ |
| rel | 任意 string / 未指定、最終的に noopener noreferrer を含む | 有効。空白区切りを小文字・重複除去し opener を除去。空でも新窓保護は消えず、非文字列はエラー。 | ‘me nofollow’ |
| icon | 任意内蔵 SocialIcon / 未指定 | iconSrc がない場合の12候補。未知の非空名はエラー、URL から推定しません。どちらもなければ label。 | ‘github’ |
| iconSrc | 任意 string / 未指定 | publicDir のローカル SVG/PNG/WebP。有効非空パスは icon より優先。空白は未指定、非文字列・不正はエラー。 | ‘/icons/community.svg’ |
実リンクはすべて新タブで、rel は保護値と統合します。ラベルに HTML は使いません。内蔵名は正確・大小文字区別です。
mastodon
twitter
github
youtube
bluesky
linkedin
discord
telegram
instagram
facebook
whatsapp
line
独自アイコンのファイル制約
public/icons/community.svg は iconSrc: ‘/icons/community.svg’。実 publicDir 内のファイルで、パッケージや src/assets ではありません。単一 / 始まり、URL・プロトコル相対・クエリ・フラグメント・百分率符号化・. / .. セグメントは不可です。逆斜線・コロン・制御文字も使えません。
ビルドで存在・ファイル種別・実パスの publicDir 内滞在を検証し、シンボリックリンクでの逸脱も不可です。通常の空白・中国語名はコンポーネントが符号化するので事前にしません。出力には base を加えますが href はそのままです。JPG・GIF は未対応です。
有効 iconSrc があれば icon は選択に使いません。寸法・間隔はレイアウト引数で SocialLink ではありません。
theme.footer:リンクとクレジット
| 完全パス | 型 / 既定値 | 状態・役割・制約 | 例 |
|---|---|---|---|
| theme.footer.showCredits | boolean / true | 有効。テーマ・Astro のリンク表記。著作権、ソーシャル、短句、他リンクは残し、自動共有画像の表記にも反映するが独自画像は変えない。 | false |
| theme.footer.links | { label: string; href: string }[] / [] | 有効。配列順・全置換でヘッダーは変えない。レイアウトが Decoder を追加するため [] でも全リンク消去を保証しない。 | [{ label: ‘プロジェクト’, href: ‘https://example.com/project/’ }] |
| theme.footer.links[].label | 必須 string / なし | 条件付き。表示名を文字として出力し、対象から自動取得しない。 | ‘プロジェクト’ |
| theme.footer.links[].href | 必須 string / なし | 条件付き。そのままの URL。アイコン同等の検証や base 追加はなく、内部パスは正確に指定。既定は現タブ移動。 | ‘https://example.com/project/’ |
独自リンクを自動追加リンクの前に置き、重複除去しません。Decoder 有効なら fullTool 文面の完全ツールリンクを追加します。不要なら対応スイッチを変え、footer.links の消去では止まりません。
著作権はビルド年と有効 SITE_TITLE で、独立 copyright/year 設定はありません。tagline は署名と別で、trim 後 Built with Astro. の旧互換文は省略します。showCredits false は他短句や既存画像表記を自動削除しません。
統合用サイト・共通リンク例
既存の個人情報を残し、必要な項目だけを統合します。
site: {
title: '林のブログ',
description: 'プロジェクト、読書、日々の記録。',
url: 'https://blog.example.com',
author: '林',
tagline: '好奇心を持ち、作り続ける。',
},
social: {
links: [
{ label: 'GitHub', href: 'https://github.com/yourname', icon: 'github' },
{ label: 'プロジェクトのホーム', href: 'https://example.com/project/' },
],
},
theme: {
footer: {
showCredits: true,
links: [{ label: 'プロジェクト', href: 'https://example.com/project/' }],
},
},
名前、ドメイン、リンクは実値に変えてください。通信検証はしません。独自アイコンや共有画像は先に public ファイルを準備してから iconSrc・site.ogImage に指定します。
日本語ナビゲーションと表記接頭辞だけを変える例です。
i18n: {
locales: {
ja: {
messages: {
nav: { home: 'ホーム', blog: '記事', about: '私について' },
footer: { theme: 'テーマ提供', builtWith: '使用' },
},
},
},
},
現在未使用:messages.siteTitle
完全パスは i18n.locales.<locale>.messages.siteTitle。任意 string、簡体中国語・英語の実既定値は共に ‘Angle Feint’ です。現在の標準ホームと共通サイト情報は読まず、現在未使用です。siteTitle: ‘私のブログ’ でも変わりません。
ホームは i18n.locales.<locale>.site.homeTitle、共通名は最上位 site.title です。ホームとサイト情報を参照し、改名のためにこの保持項目を埋める必要はありません。
互換と無効項目の範囲
- site 6項目、ソーシャル、フッター、7文面には使用箇所がありますが、画像優先・環境変数・入口スイッチで実効果が決まります。
- tagline の Built with Astro. は明確な旧既定互換の特殊値で、任意短句がすべて無効という意味ではありません。
- messages.siteTitle は型で受理してもページは読みません。
- homeHref、localeHrefs、extraLinks、showPlaceholdersWhenEmpty、iconSize は引数で公開設定ではありません。nav 配列、仮アイコンのスイッチ、著作権テンプレート、独立健康検査もありません。
保存・素材準備後は再ビルド・再配備し、環境変数は対応モードを再読込します。ドメイン、到達性、アカウント、本番効果は自分の配備で確認し、ローカル型チェックだけで成功と判断しません。総合案内へ。