コンテンツの更新¶
固定ページ・お知らせ・画像・PDFを編集するための手順です。編集後は型チェックとビルドを実行し、対象ページを確認します。
編集するファイルの早見表¶
| 編集内容 | 編集するファイル |
|---|---|
| お知らせの追加・修正 | src/data/news.json |
| 新卒採用の募集要項 | src/content/pages/recruit/new_graduates.html |
| キャリア採用の募集要項 | src/content/pages/recruit/career.html |
| 会社概要・所在地・Googleマップ | src/content/pages/company/overview.html |
| 社名・テクタスについて | src/content/pages/company/about.html |
| トップページのご挨拶 | src/content/pages/home.html |
| 会社情報ページのご挨拶 | src/content/pages/company.html |
| ご挨拶の代表者名 | 上記2ファイルの <p class="ceo-signature">(画像ではなくテキスト) |
| その他の固定ページ本文 | src/content/pages/ 内の該当HTML |
| 固定ページのタイトル・URL・本文ファイルの対応 | src/data/pages.json |
| トップページのスライド・セクション構成 | src/pages/index.astro |
| 共通ヘッダー・フッター・連絡先 | src/layouts/Layout.astro |
| 会社ロゴ(ライト/ダーク) | src/components/CompanyLogo.astro |
| 表示テーマの初期設定・切替 | src/components/ThemeInit.astro / src/components/ThemeControl.astro |
| 会社情報・商品情報・採用情報のナビゲーション項目 | src/data/navigation.ts |
| フォント・色・文字サイズ・ダークモード配色 | src/styles/tokens.css |
| 共通ヘッダー/フッター・本文書式・サブページの背景画像 | src/styles/global.css |
| トップページ固有のレイアウト・スライドの見た目 | src/styles/home.css |
| 固定ページのレイアウト・サイドバー・募集要項のリンク | src/styles/interior.css |
| お知らせ一覧・記事詳細の見た目 | src/styles/news.css |
| 404ページの見た目 | src/styles/error.css |
| 元画像/配信用WebP | public/assets/original/ / public/assets/webp/ |
| 製品PDF | public/hp_pdf/ |
本文のHTMLは管理者が編集する信頼済みファイルとして扱います。本文を管理する公開画面・データベースはありません。お問い合わせフォームでは、送信処理用のAPIと、件数・受付状態を管理するSQLite(自前版)またはDynamoDB(AWS版)を別途用意します。問い合わせ本文はメールで送信し、DBへ保存しません。
固定ページの本文を編集する¶
- 上の表、または
src/data/pages.jsonから対象ページの本文ファイルを探します。 src/content/pages/内のHTMLを編集して保存します。npm run devを実行し、対象URLをブラウザーで確認します。起動中は保存した内容がローカル表示へ反映されます。
たとえば、新卒採用ページは src/content/pages/recruit/new_graduates.html を編集し、http://127.0.0.1:4321/recruit/new_graduates/ で確認します。本文は改行・インデント付きの通常のHTMLなので、JSON用のクォートのエスケープは不要です。
<p>本文をここに記載します。</p>
<p>詳細は<a href="/company/overview/">会社概要</a>をご確認ください。</p>
本文ファイルには本文部分だけを記述します。<html>・<head>・<body> や共通ヘッダー・フッターは追加しません。表を編集するときは、<table>・<tr>・<td> などの開始タグと終了タグの対応を保ってください。
トップページと会社情報ページのご挨拶は別ファイルです。共通の文章を更新する場合は、両方を確認してください。採用年度を更新するときは、見出し・応募資格の卒業年月・マイナビのリンク先とバナー表記も確認します。
ページのタイトルは src/data/pages.json の title で変更します。本文だけの修正では path(公開URL)と content(本文ファイルの相対パス)を変更する必要はありません。
お知らせを追加・修正する¶
src/data/news.jsonを開き、既存の記事を参考にオブジェクトを追加します。- 日付の新しい順に手動で並べます。自動ソートは行わず、トップページには配列の先頭3件を表示します。
- トップページ、
/news/、カテゴリー別一覧、記事詳細を確認します。
以下は新規記事1件の記述例です。実際のタイトル・日付・本文に置き換えて、配列 [...] 内へ追加してください。
{
"slug": "update-20261021",
"title": "会社情報を更新しました",
"category": "更新情報",
"date": "2026-10-21",
"html": "<p>会社情報を更新しました。</p>\n<p>詳細は<a href=\"/company/overview/\">会社概要</a>をご確認ください。</p>",
"source": "https://www.tectas.co.jp/update-20261021/"
}
| 項目 | 記入内容 |
|---|---|
slug |
URL用の重複しない半角英数字・ハイフン。既存記事の値はURL維持のため変更しません。 |
title |
一覧と記事詳細に表示するタイトル。 |
category |
更新情報 または 採用情報。カテゴリー別一覧はこの文字列で抽出します。 |
date |
表示日付。YYYY-MM-DD 形式。 |
html |
HTML形式の本文。属性の " は \"、文字列内の改行は \n と記述します。 |
source |
移行元URLの管理用情報。新規記事は同じ形式のURLを記入できます。この値へのアクセスや原稿取得は行いません。 |
JSONでは、記事同士をカンマで区切り、最後の記事の後ろにはカンマを付けません。コメントは記述できません。VS Codeのエラー表示も確認してください。
上記の例は /news/update-20261021/ に記事が生成されます。互換URL /update-20261021/ も生成されるため、slug が固定ページ名や既存ルートと重ならないようにします。更新情報 は /updates/、採用情報 は /careers/ にも掲載されます。
日付による予約公開機能はありません。未来の日付でもビルドすれば掲載されます。修正は該当オブジェクトを編集し、削除はそのオブジェクトを配列から除きます。記事を削除すると記事URLも生成されなくなります。
画像・PDFを追加・差し替える¶
画像は public/assets/original/、PDFは public/hp_pdf/ に配置します。HTMLから参照するときは public を除いた、/ から始まるパスを使います。
<img src="/assets/original/example.jpg" alt="画像の説明" width="800" height="450" loading="lazy" />
<a href="/hp_pdf/example.pdf">製品資料(PDF)</a>
width・height は画像の実際の寸法に合わせます。新しいファイル名は半角英数字・ハイフンなどを使用し、サーバー上でも大文字・小文字が一致するように記述してください。
画像名は用途が分かる半角英小文字・数字・ハイフンで統一しています。例:company-office.jpg(会社の写真)、csmanager-customer-details.jpg(顧客詳細画面)、todomanager-week-view.jpg(週表示)。原本とWebPは拡張子以外の名前をそろえます。元サイトの画像URLと現在の配信パスの対応は src/data/assets.json で確認できます。
画像名を変更すると公開URLも変わります。HTML・CSS・src/data/assets.json・WebP生成スクリプトなどの参照を更新し、本番には生成したHTML・CSS・画像をまとめて反映してください。キャッシュ済みHTMLやCSSが古い画像名を参照する場合があるため、公開済みの旧画像はキャッシュが切れるまでサーバー上に残す運用にします。
既存のWebP対象画像を更新する場合は、public/assets/original/ の対応する原本を更新して npm run images:optimize を実行します。開発サーバーの起動中に原本だけを更新してもWebPは再生成されません。public/assets/webp/ のファイルを直接編集すると、次の生成時に上書きされます。新しい画像をWebP対象に追加する方法はWebP画像の生成を参照してください。
固定ページを追加する場合¶
src/content/pages/に本文HTMLを作成します。src/data/pages.jsonに既存項目と同じ形式でpath・title・source・contentを追加します。pathは/company/example/のように前後へ/を付け、contentはcompany/example.htmlのように本文ディレクトリからの相対パスを指定します。- 必要に応じて
src/data/navigation.tsや既存ページの本文へリンクを追加します。会社情報などのナビゲーションはgroups、ホーム・お知らせ・リンクの共通項目はsrc/layouts/Layout.astroで管理しています。 - ローカルで新しいURL・リンク・表示を確認します。
sitemap.xmlにはビルド時に自動追加されます。
編集後の確認と配置ファイルの生成¶
プロジェクトのルートディレクトリで、以下を実行します。
npm run check
npm run build
npm run preview
npm run check で型・Astroの診断、npm run build でJSONの読み込みやページ生成を確認します。npm run preview が表示したローカルURLで、ビルド後の対象ページ・リンク先・画像・PC/スマートフォン表示を確認してください。終了は Ctrl+C です。
本番サーバーへ配置する対象は dist/ 内のファイル一式です。ソースの編集だけでは本番サイトは変わりません。これらのコマンドにアップロード・公開処理は含まれていません。GitLab CI/CDでの配置方法は CI/CD運用手順 を参照してください。ページや記事を削除した場合は、古い生成HTMLがサーバーに残らないことも確認してください。
dist/ 内のHTMLは直接編集せず、必ずソースを編集して再ビルドします。追加の表示チェックを行う場合は、別のターミナルで npm run dev を起動した状態で npm run qa を実行します。