Skip to main content

启用 Sphinx 生成 HTML5 有效文件

项目描述

介绍

目前,2015 年 6 月 1 日,Sphinx 1.3.1 无法在索引页面和词汇表指令中生成本地化标题。这个包使狮身人面像国际化的大门。这意味着需要另一个包,我将制作一个名为“Gosyu”的包,请在 pip 上找到。

这个包不依赖于 Sphinx。您可以将其用于其他文本处理产品。

执照

2-clause BSD,与 Sphinx 项目相同。

安装

你可以像其他 Python 包一样安装或卸载这个包。此外,您可以在 Python 系统上不安装此包的情况下使用此包,Sphinx 的配置文件(conf.py)使您可以使用。

要求

在 Microsoft Windows 8.1 Pro 64 位版本上使用 32 位版本的 Python 2.7.9 和 64 位版本的 3.4.3 进行测试。但是对于其他版本和其他操作系统将是可用的。

如何安装

同样,您可以像安装另一个软件包一样安装此软件包。

  1. 打开控制台并执行pip install sortorder.

    在 MS-Windows 上, <python_installed_path>\Scripts\pip.exe install sortorder.

  2. 或者,当您获得诸如sortorder-2.0.6(.zip)之类的 zip 存档时 ,其中 '2.0.6' 是版本号,将当前目录更改为包含 zip 文件的文件夹,然后执行setup.py sortorder-2.0.6.zip.

    在 MS-Windows 上, <python_installed_path>\Scripts\pip.exe install sortorder-2.0.6.zip.

  3. 或者,这种方式是 Sphinx 特有的,你可以使用这个包来解压你想要的任何文件夹。conf.py使您能够使用主题和扩展。

如何使用(与狮身人面像)

要了解如何使用已有的排序顺序,请参阅yogosyugosyu

如果您想使用此包具有的预设排序顺序之一,只需 language = 'xx'. 它会导致自动加载sortorder.xx

目前,可用xxja和用于 预设。eoelru

要了解如何制作自己的排序顺序,请参阅sortorder/__init__.py

简而言之:

  • 确定新模块的文件名并创建它。如果你命名sort_order_xx.pylanguage = 'xx' ,它会在声明时自动加载。

  • import sortorder

  • 使类继承sortorder.SortOrderBase

  • 覆盖get_string_to_sortget_group_name

  • makeget_default_sort_order返回类的实例。

  • 使setup. 请参阅任何包含此包的sortorder.xx 。

使用方法(一般)

如果您没有通过 pip 安装此模块,则应首先执行 sys.path.insert(0, '<the_folder_you_copied_the_extension_file>').

其次,如果您想直接使用ja.py(日语)、eo.py(世界语)、 el.py(希腊语)或ru.py(俄语),只需执行语言代码的位置,如import sortorder.xxx ,等。xxxjaeo

否则,您应该根据需要制作排序顺序模块。您应该定义继承的新类 sortorder.SortOrderBase。模块的文件名应以 为前缀sort_order_,如sort_order_xx.py

get_default_sort_ordersetup方法仅由 Sphinx 文档生成器使用。

在你制作sort_order_xx.py或有人给它之后,将 .py 文件的路径添加到sys.path上面一样。接下来导入模块:

sys.path.insert(0, '<the_folder_you_copied_the_extension_file>')
# (snip...)
import sort_order_xx # may automatically import sortorder.__init__.py

但是sortorder.__init__有方法get_sort_orderget_default_sort_order通过在模块中定义方法,您可以为代码添加一些自动功能,例如与 Sphinx 一起使用的功能。

作者

铃见咲君高,2011-2015

历史

2.0.6(2015-07-04):

修复 PyPI 的文档(此文件)。

2.0.5(2015-07-04):

2013-12-07:

添加 Python 3 支持。

2013-12-06:

更新以满足 Sphinx 1.2。

2011-06-28:

添加了俄语和希腊语版本。

2011-05-24:

第一次发布。包含在yogosyu扩展中。包括日语和世界语版本。

下载文件

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

源分布

sortorder-2.0.6.zip (32.3 kB 查看哈希

已上传 source

内置分布

sortorder-2.0.6-py2.py3-none-any.whl (29.3 kB 查看哈希

已上传 2 7