様々な箇所でAstroのContent Collectionsを使う by haxibami · Pull Request #1777 · utelecon/utelecon.github.io

haxibami · 2025-12-22T11:30:06Z

概要

サイト内の様々なデータについて、Astro のコンテンツコレクションを使うようにしました
データをコンテンツコレクションで管理することで、事前にZodで定義したスキーマに基づき、データのバリデーション・加工を行うことができます
- これにより、誤った形式・型のデータを入力した際の問題発見が早くなるなどのメリットがあります
- 例：「お知らせのYAMLを更新した際に、英語・日本語両方のタイトルが入力されていなければ、ビルドがエラーになるようにする」といったことが可能になります
また、deprecated な Astro.glob() を使っている箇所の改修も兼ねています

変更対象

対象となるデータは、従来 Astro.glob() や import foo from "foo.yml"; などの方法で取得されていたものです（Markdown / MDX、YAML）
変更対象ごとにコミットが分かれているので、それぞれのコミットを見てもらうのがわかりやすいと思います

変更対象の一覧・留意点

説明会等
緊急のお知らせ
- コンテンツコレクションの仕様上、エントリが0件だと警告メッセージが出るため、ダミーのエントリ（src/emergencies/sample.md）を追加しています 805b228
お知らせ（とRSS）
- お知らせのタイトルは、日本語か英語のいずれかがあればエラーにならないようにしました。ただし、以下のガイドラインを踏まえ、片方の言語しかない場合は警告メッセージを出すようにしています
  - ja:の後に日本語の、en:の後に英語のタイトルを，それぞれ書いてください．仮にリンク先ページが片方の言語でしか書かれていなかったとしても，トップページでお知らせを発見できるよう，タイトルは両方の言語で書いてください．
- お知らせに id を付与する処理をZodの .transform() 内に移した結果、src/data/utils/notice.ts にはユーティリティ関数のみが残ったため、削除して src/lib/util.ts に移動しました e0cf9de
- 従来の処理では、英語タイトルのみを持ち、日本語タイトルを持たないお知らせ（例：2022-03-18）が英語版のお知らせページに表示されていませんでしたが、その点も修正されました
サイトマップ
ナビゲーション
グッドプラクティス
- src/pages/good-practice/_Loader.astro を消して src/pages/good-practice/index.tsx にまとめました
- バリデーションの結果、不足しているフィルタが見つかったため、追加しました 0f383e5

今後の見通し

説明会等のページ（/events）は、現在は手書きだが、お知らせページと同様にYAMLから生成できそう
過去のお知らせもすべて英訳して、日英双方のタイトルを必須にする（欠けている場合にエラーを出すようにする）ことも可能

github-actions · 2025-12-22T11:33:38Z

🚀 Deployed on https://deploy-preview-1777--utelecon.netlify.app

Copilot

Pull request overview

This PR migrates the codebase to use Astro's Content Collections feature with Zod schema validation, replacing the deprecated Astro.glob() API. This change provides type safety, runtime validation, and better data management for various content types including notices, events, navigation, good practices, and emergency notifications.

Key changes:

Introduction of a centralized src/content.config.ts with Zod schemas for all content collections
Migration from Astro.glob() and direct YAML imports to getCollection() and getEntry() APIs
Moved utility functions from src/data/utils/notices.ts to src/lib/util.ts for better organization
Enhanced validation with warnings for notices missing bilingual titles

Reviewed changes

Copilot reviewed 14 out of 16 changed files in this pull request and generated 16 comments.

Show a summary per file

File	Description
`src/content.config.ts`	New centralized configuration defining all content collections with Zod schemas for emergencies, events, notices, navigation, pages, and interviews
`src/pages/good-practice/index.mdx`	Updated to use Content Collections API instead of the deleted `_Loader.astro` component
`src/pages/good-practice/_Loader.astro`	Deleted file - functionality moved inline to index.mdx
`src/lib/util.ts`	Added date formatting utility functions moved from the deleted notices utility file
`src/layouts/Header/Navigation.astro`	Changed from direct YAML import to `getEntry()` API for navigation data
`src/layouts/Footer/Navigation.astro`	Changed from direct YAML import to `getEntry()` API for navigation data
`src/layouts/Emergency.astro`	Updated to use Content Collections with `getCollection()` and `render()` APIs
`src/emergencies/sample.md`	Added dummy emergency entry to avoid empty collection warnings
`src/data/utils/notices.ts`	Deleted - utilities moved to `src/lib/util.ts` and ID generation moved to content.config.ts
`src/data/schemas/notice.d.ts`	Deleted TypeScript type definitions, replaced by Zod schema inference
`src/data/schemas/nav.d.ts`	Deleted TypeScript type definitions, replaced by Zod schema inference
`src/components/pages/rss.ts`	Updated to use `getEntry()` API for retrieving notices
`src/components/pages/Sitemap.astro`	Updated to use `getCollection()` and `getEntry()` APIs for pages and navigation
`src/components/pages/Notice.astro`	Updated to use `getEntry()` API and import utilities from new location
`src/components/pages/GoodPractice.tsx`	Added missing filter options (TeX, Mathematica, UTAS, etc.) and exported constants for use in content.config.ts
`src/components/pages/Events.astro`	Updated to use `getCollection()` API instead of `Astro.glob()`

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-12-23T09:35:35Z

src/content.config.ts

+    .transform(
+      (v) => new RegExp(v)
+    )
+  })


Missing space after closing brace in the object literal. This is inconsistent with the formatting used elsewhere in the file.

src/components/pages/rss.ts

src/layouts/Footer/Navigation.astro

Copilot · 2025-12-23T09:35:36Z

src/content.config.ts

+      (v) => new RegExp(v)
+    )
+  })
+})


Missing space after closing brace in the object literal. This is inconsistent with the formatting used elsewhere in the file.

Suggested change

})

} )

Copilot · 2025-12-23T09:35:36Z

src/content.config.ts

+      )
+    })
+  )
+})


Missing space after closing brace in the object literal. This is inconsistent with the formatting used elsewhere in the file.

Copilot · 2025-12-23T09:35:38Z

src/content.config.ts

+      return { ...notice, id };
+    }).toReversed();
+  })
+})


Missing space after closing brace in the object literal. This is inconsistent with the formatting used elsewhere in the file.

Copilot · 2025-12-23T09:35:38Z

src/content.config.ts

+      tools: z.string()
+    })
+  })
+})


Missing space after closing brace in the object literal. This is inconsistent with the formatting used elsewhere in the file.

Suggested change

})

} )

src/components/pages/GoodPractice.tsx

src/content.config.ts

arx-ein

レビューしました。全体として基本的に問題なく想定通りに動作しており、diffを確認しても非自明な変更はありませんでした。

軽微な変更をいくつかコミットしておきました。以下に変更点を各コミット順に示します。

コーディングスタイルの修正。文末のセミコロン追加やカッコ周りのスペースなど、Copilotに文句を出された箇所のうち適切だろうと思われるところを適用しました。
Sitemap.astroから不必要となったnullチェック (if (!url) continue;) と非nullアサーション !. を除去しました。
緊急のお知らせのダミーエントリに、その旨が分かるようにコメントを追加しておきました。
1つ目のコミットで入れ忘れていたセミコロンを回収しました。

haxibami added 9 commits December 22, 2025 18:53

use content collection for events

917d9cb

use content collection for emergencies

fb7b221

add dummy emergency to suppress build warnings

805b228

use content collection for notices + rss

2a23206

mv utility functions to src/lib/util

e0cf9de

use content collection for sitemap

a93f6e2

use content collection for navigation

14bdd34

use content collection for good-practice

0a19fab

add missing filters

0f383e5

haxibami added the web_development label Dec 22, 2025

haxibami requested a review from Copilot December 23, 2025 09:25

Copilot started reviewing on behalf of haxibami December 23, 2025 09:27 View session

Copilot AI reviewed Dec 23, 2025

View reviewed changes

arx-ein requested review from arx-ein February 19, 2026 07:23

arx-ein added 4 commits March 4, 2026 19:49

Code styling changes

5b4b214

Remove obsolete null check & assertion

0723612

Add comment for emergency sample file

863a087

Code styling changes (append)

be28170

arx-ein approved these changes Mar 4, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

様々な箇所でAstroのContent Collectionsを使う#1777

様々な箇所でAstroのContent Collectionsを使う#1777
haxibami wants to merge 13 commits intomasterfrom
202512-use-content-collection

haxibami commented Dec 22, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Dec 22, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Dec 23, 2025

Uh oh!

Uh oh!

Uh oh!

Copilot AI Dec 23, 2025

Uh oh!

Copilot AI Dec 23, 2025

Uh oh!

Copilot AI Dec 23, 2025

Uh oh!

Copilot AI Dec 23, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

arx-ein left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

haxibami commented Dec 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

概要

変更対象

変更対象の一覧・留意点

今後の見通し

Uh oh!

github-actions bot commented Dec 22, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Dec 23, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Copilot AI Dec 23, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 23, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 23, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 23, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

arx-ein left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

haxibami commented Dec 22, 2025 •

edited

Loading

github-actions bot commented Dec 22, 2025 •

edited

Loading