Skip to main content

MkDocs i18n 插件

项目描述

MkDocs i18n 插件

一个用于国际化 MkDocs 的插件。它为每个页面添加指向已翻译页面的链接。如果有当前页面语言的翻译,它还会隐藏导航菜单的其他语言页面链接。

mkdocs-i18n 用法示例:https ://mkdocs-i18n.gitlab.io/mkdocs-i18n

随时在https://gitlab.com/mkdocs-i18n/mkdocs-i18n/-/issues上写下您的评论或请求修改以适应您的要求。

如果启用, mkdocs-i18n 会更新MkDocs 材料的站点语言

mkdocs-i18n 更新MkDocs 材料的站点语言选择器,如果已配置,则链接每个已翻译页面。

实例探究

http://isardvdi.com ( https://isard.gitlab.io/isardvdi-docs ) 是一个多语言社区,大多数成员知道 2 种语言但不是同一种语言,有些人懂 3 种......每个人都有自己喜欢的语言并且对其他语言有不同程度的了解。此外,社区文档没有源语言,并非所有文档都需要翻译成所有语言。因此,此插件显示文档顶部显示的页面以及未翻译成导航菜单中选择的语言的页面的所有可用翻译。

设置

使用 pip 安装插件:

pip install mkdocs-i18n

通过mkdocs.yml配置插件

如果您的配置文件中没有plugins条目,则您search启用了插件。如果您创建plugins条目以启用插件,如果您想启用i18n插件,您还需要添加插件。searchsearch

捐款:

其他有趣的作品:

  • MkDocs 静态 i18n 插件:使用源语言构建翻译文档的并行结构。它不链接到当前文档的其他翻译,也不显示尚未翻译成当前语言或默认语言的页面。因此,仅翻译成非默认语言的文档仅在访问具有相同语言的页面时才链接到导航菜单。
  • MkDocs 主题 i18n:正在进行中。
  • Markdown i18n 插件:通过 po 文件提供文档翻译,但无法本地化图像。
  • MkDocs 多语言:仅针对 MkDocs < 1.0 发布

项目详情


下载文件

下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。

源分布

mkdocs-i18n-0.4.4.tar.gz (17.2 kB 查看哈希

已上传 source

内置分布

mkdocs_i18n-0.4.4-py3-none-any.whl (17.7 kB 查看哈希

已上传 py3