启用 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 进行测试。但是对于其他版本和其他操作系统将是可用的。
如何安装
同样,您可以像安装另一个软件包一样安装此软件包。
打开控制台并执行
pip install sortorder.在 MS-Windows 上,
<python_installed_path>\Scripts\pip.exe install sortorder.或者,当您获得诸如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.或者,这种方式是 Sphinx 特有的,你可以使用这个包来解压你想要的任何文件夹。conf.py使您能够使用主题和扩展。
如何使用(与狮身人面像)
要了解如何使用已有的排序顺序,请参阅yogosyu或gosyu。
如果您想使用此包具有的预设排序顺序之一,只需
language = 'xx'. 它会导致自动加载sortorder.xx。
目前,可用xx、ja和用于
预设。eoelru
要了解如何制作自己的排序顺序,请参阅sortorder/__init__.py。
简而言之:
确定新模块的文件名并创建它。如果你命名sort_order_xx.py
language = 'xx',它会在声明时自动加载。写
import sortorder。使类继承
sortorder.SortOrderBase。覆盖
get_string_to_sort和get_group_name。make
get_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_order和setup方法仅由 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_order。get_default_sort_order通过在模块中定义方法,您可以为代码添加一些自动功能,例如与 Sphinx 一起使用的功能。
历史
2.0.6(2015-07-04):
修复 PyPI 的文档(此文件)。
2.0.5(2015-07-04):
yogosyu扩展的一部分。
首先上传到 PyPI。
2013-12-07:
添加 Python 3 支持。
2013-12-06:
更新以满足 Sphinx 1.2。
2011-06-28:
添加了俄语和希腊语版本。
2011-05-24:
第一次发布。包含在yogosyu扩展中。包括日语和世界语版本。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。