巴黎午夜漫步：用 Eleventy 多语言博客构建可检索的城市旅行指南

• 示例工程

夜幕降临后的巴黎是光与影交织的城市，也是一座"幽灵之城"。深夜十点之后，拉丁区狭窄的鹅卵石街道上，你几乎可以想象昔日的哲学家与革命家们正在昏暗的咖啡馆角落里争论不休。这篇旅行指南以 巴黎午夜漫步 一文为原型，带你复盘塞纳河畔的深夜散步路线、街头美食与安全贴士，同时结合本仓库 trailblazers 站点的 Eleventy 源码，说明这类图文内容是如何以 Markdown + Front Matter 的形式被结构化、多语言化并最终渲染成静态博客页面的。

读完本文，你将掌握三件事：一是完整复现"塞纳河午夜散步—蒙马特收尾—街角美食"的巴黎夜游动线；二是看懂一篇带标题、标签、作者、日期和封面图字段的旅行博文在 Eleventy 中对应的数据模型与渲染流程；三是了解本站如何用 i18n 插件和本地化集合为同一篇文章产出英语、西班牙语、日语多版本页面。

从元数据看一篇旅行博文的"技术骨架"

原文档trailblazers/content/ja/blog/paris-midnight-stroll/index.md的正文第一行不是文字，而是一段 YAML Front Matter，这是 Eleventy 数据级联（Data Cascade）的入口。把文档的标题、摘要、日期、标签、作者全部结构化：

--- title: 'パリ：歴史を辿る真夜中の散歩' description: 'セーヌ川沿いの深夜の散歩は、究極のパリジャン・ロマンスです。' date: 2026-03-10 tags: ['都市', 'フランス', 'ロマンス'] author: maya ---

这些字段在渲染链路中被逐级消费：

• title / description：被 post.njk 布局 渲染为页面<h1>与分享数据（navigator.share时作为text）；同时作为归档列表卡片的核心文案。
• date：通过readableDate(locale)过滤器输出本地化日期，并在归档列表中以datetime属性标注机器可读时间。
• tags：参与 tags-schema.njk 生成的tags-schema.json校验枚举，并驱动零维护的标签页。
• author：在 eleventy.config.js 中定义的authorLocaleCombos集合把作者（maya / ashok / julia）与三种语言组合生成作者专属页面。

同一篇文章的英语版本trailblazers/content/en/blog/paris-midnight-stroll/index.md与西班牙语版本trailblazers/content/es/blog/paris-midnight-stroll/index.md采用完全相同的 Front Matter 结构，只是title、description、tags换成了对应语言，这正是多语言站点"内容分离、结构统一"的典型做法。正文中的 Markdown 图片语法[![フランス、パリ](https://raw.gitcode.com/gh_mirrors/samp/samples/raw/92e10978e30fb18693920e372297b17be3274431/trailblazers/content/es/blog/reykjavik-northern-lights/cover.jpg?utm_source=gitcode_repo_files)](https://link.gitcode.com/i/455696a1f9aa43ed74dd2400961ad0dd)引用与文档同目录的封面图，而目录下的 cover.jpg 会被 eleventyImageTransformPlugin 自动转换为 AVIF / WebP 并补上width、height、loading="lazy"、decoding="async"等属性，规避布局偏移。

塞纳河畔的午夜散步路线复盘

原文档的核心叙事是一条反常规的夜游动线：避开白天的拥挤观光团，选择深夜 10 点后出行，从塞纳河畔一路走到蒙马特。具体分解如下：

1. 起点：拉丁区（カルチエ・ラタン）——深夜十点后，在狭窄的鹅卵石街道上穿行，氛围感的来源是想象历史人物在昏暗咖啡馆中争论的场景。
2. 塞纳河段：从新桥（ポン・ヌフ）出发，沿河夜行，途经夜晚如同"珠宝盒"般发光的**卢浮宫（ルーヴル）**外观。
3. 收尾：蒙马特（モンマルトル）——在**特特尔广场（テルトル広場）观看路灯下仍在创作的本地画家，最后在圣心大教堂（サクレ・クール寺院）**的台阶上于凌晨 2 点俯瞰全城。

这条路线在仓库中的"多语言对照"版本（英语版、西班牙语版）里保持了完全一致的四个叙事小节——塞纳河夜曲、街头灵魂美食、贴士、亮点——只是语言不同。这意味着旅行内容的叙事骨架一旦确定，就可以通过语言文件批量衍生多语言页面。

从渲染实现看，这类正文会被 content.11tydata.js 与 blog.11tydata.js 的数据级联补上默认布局与posts标签，最终套用 post.njk 布局输出为静态 HTML，并在文章底部由posts_${locale}集合自动生成上一篇/下一篇导航。

街角美食：两顿有记忆点的夜宵

原文档对巴黎美食的描述刻意避开米其林星级，聚焦街头与市井：

• 招牌推荐：圣日耳曼德佩（サン・ジェルマン・デ・プレ）附近街边摊的榛果巧克力酱香蕉可丽饼（ヌテラとバナナのクレープ），趁热倚着路灯吃，是"格别"的一餐。
• 深夜正餐：一家供应经典牛排薯条（ステーキ・フリート／Steak Frites）的传统小酒馆（ビストロ），配浓郁胡椒酱汁，作者形容为"食物形态的拥抱"。

这段内容在站点中的呈现方式值得注意：每篇文章正文末尾，post.njk 布局 会依次插入飞行航班组件（flight-widget.njk）、旅行助手组件（travel-agent-widget.njk）、T 恤组件（tshirt-widget.njk）和国家地图组件（country-map.njk），这些 组件文件 属于站点级的增强交互模块，与正文的纯 Markdown 内容分离，体现了 Eleventy"布局与内容解耦"的设计——作者只管写文字，交互组件由模板层统一注入。

实用贴士与安全提示（原文档完整保留）

原文档的"ヒントとアドバイス"一节包含三条可直接落地的建议，在此完整保留并补充说明：

• 自拍的陷阱：如果讨厌人潮，日落时分的特罗卡德罗广场（トロカデロ広場）要避开。想更美且更安静地看埃菲尔铁塔，可以转向战神公园（シャン・ド・マルス公園），或寻找**比尔阿克姆桥（ビル・アケム橋）**这类隐蔽桥梁。
• 步行是硬性要求：巴黎最适合用双脚丈量，准备一双好看又耐穿的步行鞋——作者的原话是"你的脚踝会感谢你"。
• 夜间安全：巴黎整体安全，但要提防热门景点周边的"卖花人"和"编手链的人"，一句礼貌而坚定、轻声细语的"Non, merci（不用了，谢谢）"通常就足够应对。

亮点清单与一句话收尾

原文档以四条"ハイライト（Highlights）"总结这次夜游的不可错过瞬间：

• 夜间的卢浮宫：金字塔亮灯时，没有白天那 3 万名游客。
• 塞纳河畔步道：欣赏城市建筑"骨骼"的最佳视角。
• 凌晨 2 点的圣心大教堂：巴黎最安静、最具魔法感的观景点。
• 完美的可丽饼：定义巴黎体验的简单快乐。

结尾一句"夜间的巴黎不只是一个地方，而是一种情绪"点明全文主旨：这是一座邀请你放慢脚步、抬头仰望、允许自己稍稍迷路的城市。这句话同时也是本仓库中该旅行主题系列内容（如 trailblazers/content/ja/blog 目录下的阿马尔菲海岸、阿姆斯特丹运河等目的地文章）统一的情感基调。

站点视角：这篇博文在 Eleventy 中的完整生命周期

把上面所有零散证据串起来，这篇日语博文从 Markdown 到线上页面的完整链路是：

1. 输入：content/ja/blog/paris-midnight-stroll/index.md（含 Front Matter 与正文）＋同目录cover.jpg。
2. 数据级联：content.11tydata.js 提供默认布局，blog.11tydata.js 打上posts标签，目录结构本身（content/ja/）通过 ja.json 声明locale: "ja"与dir: "ltr"。
3. 集合与分页：eleventy.config.js 按en/es/ja三种主语言构建posts_${lang}集合，blog.njk 用filterByLocale(locale)过滤出当前语言的文章列表，postslist.njk 渲染归档卡片（封面图直接取自post.url + cover.jpg）。
4. 多语言与本地化：eleventy-plugin-i18n配合fallbackLocales（如en-US → en、es-ES → es）处理语言回退；每篇文章以/{locale}/blog/...的 permalink 输出，并为每种语言生成 Atom feed（/{lang}/feed/feed.xml）。
5. 输出：dir.output指向dist目录，pathPrefix: '/samples/trailblazers/dist/'（见 eleventy.config.js）支持子路径部署。

所以当你看到这篇巴黎夜游散文时，看到的不仅是文字，更是一个完整的、面向搜索引擎与多语言读者的静态站点内容单元——Front Matter 管结构化、i18n 管语言、Image 插件管图片性能、集合管归档与导航。如果你想在本地复现这套站点，可以在仓库 trailblazers 目录下执行npm install后运行npx @11ty/eleventy --serve启动开发服务器，或在构建模式下运行npx @11ty/eleventy生成生产级静态文件。

封面图说明：文中配图来自本仓库trailblazers/content/ja/blog/paris-midnight-stroll/cover.jpg，呈现亚历山大三世桥黄昏夜景，与"巴黎夜游"主题直接对应。

• 示例工程