您可以将“目录”重命名吗?在狮身人面像侧边栏中?

发布于 2024-11-26 10:47:31 字数 93 浏览 3 评论 0原文

更一般地说,如何重命名 Sphinx 默认元素(例如,将 Quick Search 重命名为 Search)?你可以吗?

More generally how do you rename Sphinx default elements (e.g. Quick Search to Search)? Can you?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(2

马蹄踏│碎落叶 2024-12-03 10:47:31

以下是如何通过覆盖模板将“快速搜索”更改为其他内容:

  1. 在 Sphinx 项目目录中创建一个名为 templates 的文件夹。

  2. /themes/basic/searchbox.html 复制到 模板

  3. 在conf.py中添加

    templates_path = [“模板”]
    
  4. Rename 'Quick search' 添加到 searchbox.html 副本中您想要的任何内容。

但我不会这样做。

更灵活的方法是创建 gettext MO 文件并按照 locale_dirs 文档中所述设置配置。像这样:

  1. 模板文件/locale/sphinx.pot包含所有可以翻译的字符串。将该文件复制到本地 sphinx.po 文件。

  2. 将您的更改添加到 sphinx.po

  3. 使用msgfmt.pysphinx.po编译为sphinx.mo

  4. sphinx.mo 放入正确的目录(对于英语,/en/LC_MESSAGES)。

另请参阅 http://docs.python.org/library/gettext.html#国际化您的程序和模块

Here is how you could change "Quick search" to something else by overriding a template:

  1. Create a folder called templates in the Sphinx project directory.

  2. Copy <Sphinx install dir>/themes/basic/searchbox.html to templates.

  3. In conf.py, add

    templates_path = ["templates"]
    
  4. Rename 'Quick search' to whatever you want in the copy of searchbox.html.

But I would not do it this way.

A more flexible approach is to create a gettext MO file and set up the configuration as described in the documentation for locale_dirs. Like this:

  1. The template file <Sphinx install dir>/locale/sphinx.pot contains all the strings that can be translated. Copy that file to a local sphinx.po file.

  2. Add your changes to sphinx.po.

  3. Use msgfmt.py to compile sphinx.po into sphinx.mo.

  4. Put sphinx.mo in the proper directory (<your_locale_dir>/en/LC_MESSAGES for English).

See also http://docs.python.org/library/gettext.html#internationalizing-your-programs-and-modules.

蓝礼 2024-12-03 10:47:31

根据Sphinx配置文档,您应该能够修改html模板或者将Sphinx指向新的模板来通过处理模板的 html 来实现您想要做的事情。

当前模板在上下文中提供了搜索标题,但我不确定填充 _('search') 的上下文值的内容是什么。我想知道您是否可以尝试通过修改 /sphinx/sphinx/locale/sphinx.pot 中的区域设置文件来自定义它:

#: sphinx/themes/agogo/layout.html:49 sphinx/themes/basic/layout.html:137
#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:20
msgid "Search"
msgstr ""

并说 msgstr“我的替代搜索” 而不是 msgstr“”.

According to Sphinx config documentation, you should be able to amend the html templates or perhaps point Sphinx to new templates to achieve what you trying to do by working on the templates' html.

Current templates have search title provided in the context, I am not sure though what populates context value for _('search'). I wander if you could try customizing it by amending the locale file in /sphinx/sphinx/locale/sphinx.pot:

#: sphinx/themes/agogo/layout.html:49 sphinx/themes/basic/layout.html:137
#: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:20
msgid "Search"
msgstr ""

and say msgstr "My alternative search" instead of msgstr "".

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文