サンプルページ
この記事は、ニュース記事の書き方のサンプルです。
新しいお知らせや活動報告を投稿する際は、このページを参考にしてください。
ニュースページの書き方(テンプレート)
ニュース記事を書く際は、ファイルを posts/
フォルダに .md
形式で追加し、以下のような YAMLフロントマター をページ冒頭に記述してください:
title: ニュースタイトル(例:「○○イベントに参加しました」)
layout: base.njk
date: 2025-06-26
permalink: "/posts/news2025-06-26/"
tags: [ニュース, 活動報告]
title
: ページタイトル(一覧にも表示されます)layout
: 基本的にbase.njk
で統一date
: 投稿日。ニュース一覧はこの順で並びますpermalink
: 公開されるURL(/posts/○○/
形式)tags
: タグ
タグ付けルール
tags: [タグ1, タグ2, ...]
の形式で1〜3個のタグをつけてください。タグの上限はありません。- 以下の推奨タグリストを参考にしつつ、内容に応じて柔軟に判断してください。
推奨タグ一覧
- 活動の分類:ニュース, お知らせ, 活動報告
- テーマ:自動運転, ISUCON, CTF, メイカー, プログラミングコンテスト, VR
- 種別:LT会, 読書会, ハッカソン, 勉強会, プロジェクト, コンテスト
本文の書き方
Markdown形式で自由に記述可能です:
---
title: 〇〇イベントに参加しました
layout: base.njk
date: 2025-06-20
permalink: "/posts/event2025-06-20/"
thumbnail: /images/posts/2025-06-26-sample.png
---
技術チャレンジ部は、2025年6月に開催された「〇〇イベント」に出展しました。
多数の来場者と交流し、メンバーの作品も高く評価されました。
投稿ファイルの保存場所
全て posts/ フォルダに保存してください。 ファイル名の例:
posts/
├── news-2025-06-20.md
├── event-2025-07-01.md
├── sample.md ← このガイドページ
サムネイル画像の指定方法
ニュース記事の一覧ページなどで表示される サムネイル画像は、ページ冒頭の frontmatter に以下のように記述することで明示的に指定できます。
thumbnail: /images/posts/2025-06-26-sample.png
サムネイル画像は以下の優先順位で表示されます:
- thumbnail: に明示的に指定された画像(推奨)
- 記事本文内の最初の画像
- デフォルト画像 /images/default-thumbnail.png
備考: thumbnail: を記載しない場合でも、記事内に画像があれば自動で使用されます。ただし、意図しない画像が選ばれることもあるため、明示指定を推奨します。
注意点
-
index.md(投稿一覧ページ)も同じ posts/ にありますが、eleventyExcludeFromCollections: true を指定して投稿一覧には含まれていません。
-
ファイル名や日付の順序は自由ですが、date フィールドが並び順に使われます。
ご不明点があれば、他の運用者と共有するか、リポジトリのREADMEやWikiに追記してください。