启用 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
和用于
预设。eo
el
ru
要了解如何制作自己的排序顺序,请参阅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
,等。xxx
ja
eo
否则,您应该根据需要制作排序顺序模块。您应该定义继承的新类
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扩展中。包括日语和世界语版本。
项目详情
下载文件
下载适用于您平台的文件。如果您不确定要选择哪个,请了解有关安装包的更多信息。