Module document¶
Generally, you don’t have to know read here. Please read unicode_ids extension.
通常はこの頁を読む必要はありません。使い方などについてはunicode_ids拡張(日本語版説明書)をご覧ください。
Module sphinxcontrib.unicode_ids¶
The Sphinx extension to allow HTML builder to use Non-ASCII identifiers
| copyright: | © 2011-2015 Suzumizaki-Kimitaka(鈴見咲 君高, for additional works only) |
|---|---|
| license: | 2-clause BSD. |
This module hacks sphinx.environment.BuildEnvironment.resolve_toctree().
And because of this, when used with Python 2(means not Python 3), just
cover characters included in the set of sys.getdefaultencoding(),
not all of Unicode characters.
For Windows, you might create usercustomize.py or
sitecustomize.py to call sys.setdefaultencoding('mbcs').
See PEP 370 http://www.python.org/dev/peps/pep-0370/ to know where
to place the script.
-
unicode_ids.my_make_id(s) Return identifier without losing Unicode characters.
Parameters: s (str_or_unicode) – base string to make new identifier Return type: unicode(Python 2), str(Python 3) Returns: the new identifier string for patched Sphinx Defined to replace the function
docutils.nodes.make_id().Currently, this function can’t determine the return value will be used in HTML or CSS. Unusable characters will be replaced with
_xhhform wherehhis 2-digit hexadecimal lowercase.
-
unicode_ids.my_toctree_run(self) Show non existing entries of toctree
Parameters: self (sphinx.directives.other.TocTree) – The instance object Return type: list Returns: list of the nodes made in this method Defined to replace the method
sphinx.directives.other.TocTree.run()Only
%rfollowing are replaced with%sto avoid unreadable string.
-
unicode_ids.setup(app) Extend the Sphinx as we want, called from the Sphinx
Parameters: app (sphinx.application.Sphinx) – the object to add builder or something.
-
unicode_ids.to_unicode(s) Get unicode object by decoding given string with filesystem encoding
Parameters: s (str) – the string, if unicode object is given, return this unmodified. Return type: unicode Returns: the string converted unicode type When the system encoding is not found, just return the parameter
s. This function is called Python 2 only.