Eleventy Plugin I18n 使用教程
1. 项目的目录结构及介绍
eleventy-plugin-i18n/
├── src/
│ ├── en-GB/
│ │ ├── about.njk
│ │ └── index.njk
│ └── es-ES/
│ ├── about.njk
│ └── index.njk
├── .eleventy.js
├── .gitignore
├── .prettierignore
├── .prettierrc
├── LICENSE
├── README.md
├── i18n.js
├── package.json
src/
: 包含不同语言的站点目录。en-GB/
: 英语(英国)站点目录。about.njk
: 关于页面模板。index.njk
: 首页模板。
es-ES/
: 西班牙语(西班牙)站点目录。about.njk
: 关于页面模板。index.njk
: 首页模板。
.eleventy.js
: Eleventy 配置文件。.gitignore
: Git 忽略文件。.prettierignore
: Prettier 忽略文件。.prettierrc
: Prettier 配置文件。LICENSE
: 项目许可证。README.md
: 项目说明文档。i18n.js
: i18n 插件配置文件。package.json
: 项目依赖和脚本配置文件。
2. 项目的启动文件介绍
项目的启动文件主要是 package.json
中的脚本配置。通常,Eleventy 项目的启动命令如下:
{
"scripts": {
"start": "eleventy --serve"
}
}
运行 npm start
或 yarn start
即可启动项目。
3. 项目的配置文件介绍
.eleventy.js
这是 Eleventy 的主要配置文件,用于配置插件和自定义功能。以下是一个示例配置:
const i18n = require('eleventy-plugin-i18n');
module.exports = function (eleventyConfig) {
eleventyConfig.addPlugin(i18n, {
translations: {
hello: {
'en-GB': 'Hello',
'es-ES': 'Hola'
}
},
fallbackLocales: {
'*': 'en-GB'
}
});
};
i18n.js
这是 i18n 插件的配置文件,用于定义翻译字典和 fallback 语言。以下是一个示例配置:
module.exports = {
translations: {
hello: {
'en-GB': 'Hello',
'es-ES': 'Hola'
}
},
fallbackLocales: {
'*': 'en-GB'
}
};
通过这些配置文件,可以实现多语言站点的构建和翻译功能。