Enable Sphinx to generate HTML5 valid files
Japanese version of this document is also available, on the site or the doc folder of this package.
Currently, June 1, 2015, Sphinx 1.3.1 cannot generate localized heading in index pages and glossary directives. This package make the gate to make the Sphinx internationalized. This means another package is required to do, I will make the one named ‘Gosyu’, please find that on pip.
This package does not depends on the Sphinx. You can use this for another text proccesing product.
2-clause BSD, same as the Sphinx project.
You can install or uninstall this package like another Python packages. Also, you can use this package without installing this package on your Python systems, the configuration file of Sphinx(conf.py) enable you to use.
Tested with 32bit version of Python 2.7.9 and 64bit version of 3.4.3, both on the Microsoft Windows 8.1 Pro 64bit edition. But with another versions and on another OSs would be usable.
How to install
Again, you can install this package as you will do with another one.
Open a console and do
pip install sortorder.
On the MS-Windows,
<python_installed_path>\Scripts\pip.exe install sortorder.
Or when you get zip archive like sortorder-2.0.6(.zip) where ‘2.0.6’ is version number, change current directiory to the folder that has the zip file, and do
On the MS-Windows,
<python_installed_path>\Scripts\pip.exe install sortorder-2.0.6.zip.
Or, this way is the Sphinx specific, you can use this package just extracted any folder you want. the conf.py enables you to use the themes and extensions.
How to use (with Sphinx)
If you want to use one of the preset sort orders this package has, just
language = 'xx'. it causes automatically load sortorder.xx.
xx is available
ru for the presets.
To know how to make your own sortorder, see sortorder/__init__.py.
- determine the filename of the new module and create it.
if you name sort_order_xx.py, it will automatically loaded
language = 'xx'is declared.
- make the class inherits
get_default_sort_orderreturns the instance of the class.
setup. see any of sortorder.xx included this package.
How to use (General)
If you have this module not installed by pip, you should first do
Second, if you want directly use
el.py (Greek) or
ru.py (Russian), Just do
xxx is language code like
Otherwise, you should make the your sort-order module as you want.
You should define the new class which inherits
sortorder.SortOrderBase. The filename of the module should
sort_order_, like sort_order_xx.py.
setup methods are only used by
the Sphinx document generator.
After you make sort_order_xx.py or you have it someone gives, add the path
of the .py file to
sys.path like above. Next import the module:
sys.path.insert(0, '<the_folder_you_copied_the_extension_file>') # (snip...) import sort_order_xx # may automatically import sortorder.__init__.py
But sortorder.__init__ has the method
You can add your code some automatic feature like used with the Sphinx,
get_default_sort_order method in your module.
Fix document(this file) for PyPI.
- Part from yogosyu extension.
- First uploded to PyPI.
Add Python 3 support.
Updated to meet Sphinx 1.2.
Russian and Greek versions added.
First release. Included in yogosyu extension. Japanese and Esperanto versions included.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|sortorder-2.0.6-py2.py3-none-any.whl (29.3 kB) Copy SHA256 hash SHA256||Wheel||2.7||Jul 4, 2015|
|sortorder-2.0.6.zip (32.3 kB) Copy SHA256 hash SHA256||Source||None||Jul 4, 2015|