diff options
| author | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2010-11-18 21:50:54 +0000 |
|---|---|---|
| committer | milde <milde@929543f6-e4f2-0310-98a6-ba3bd3dd1d04> | 2010-11-18 21:50:54 +0000 |
| commit | cf0b3368b8774fc2cd0c580969cdfd16182f5b0e (patch) | |
| tree | b387cfa7580d003ff0f4a47a46f949f8cc9e585b | |
| parent | ad8d25a46e36c43e0382fc12b95552858e60500c (diff) | |
| download | docutils-cf0b3368b8774fc2cd0c580969cdfd16182f5b0e.tar.gz | |
Update documentation about Cyrillic, XeTeX, and hyperref [ 3100778 ]
git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@6484 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
| -rw-r--r-- | docutils/docs/user/latex.txt | 25 | ||||
| -rw-r--r-- | docutils/test/functional/tests/xetex_cyrillic.py | 4 |
2 files changed, 23 insertions, 6 deletions
diff --git a/docutils/docs/user/latex.txt b/docutils/docs/user/latex.txt index c94536f54..d34a7bac7 100644 --- a/docutils/docs/user/latex.txt +++ b/docutils/docs/user/latex.txt @@ -1802,8 +1802,8 @@ See also the `Link text doesn’t break at end line`_ FAQ entry. Glyph not defined in PD1 encoding ````````````````````````````````` -If a section title or other link contains e.g. cyrillic characters, -the LaTeX log contains lots of warnings like:: +If a section title or other link contains non-Latin (e.g. Cyrillic) +characters, the LaTeX log contains lots of warnings like:: Package hyperref Warning: Glyph not defined in PD1 encoding, (hyperref) removing `\CYRZ' on input line 6. @@ -1814,11 +1814,26 @@ This can be solved with the "unicode" hyperref_option_ setting:: --hyperref-option=unicode (works also with non-unicode input/output encoding (e.g. "koi8r" or -"latin1"). However, this setting does not work with xelatex_ and is -therefore not made a default. +"latin1"). Newer versions of hyperref default to "unicode=true" if the +document language is "russian". -.. _hyperref_option: config.html#stylesheet-latex2e-writer +However, this setting leads to "strange" characters in the bookmarks +if used with xelatex_ in hyperref versions before v6.79g (2009/11/20). +(cf `bugreport 3100778`__). + +If updating the hyperref package is not an option, the workaround is +to set :: + + --hyperref-option="unicode=false" + +or (in the config file):: + [xetex writer] + + hyperref-option: unicode=false + +__ http://sourceforge.net/tracker/?func=detail&aid=3100778&group_id=38414&atid=422030 +.. _hyperref_option: config.html#stylesheet-latex2e-writer image inclusion ``````````````` diff --git a/docutils/test/functional/tests/xetex_cyrillic.py b/docutils/test/functional/tests/xetex_cyrillic.py index cefb9458c..f301ad564 100644 --- a/docutils/test/functional/tests/xetex_cyrillic.py +++ b/docutils/test/functional/tests/xetex_cyrillic.py @@ -7,5 +7,7 @@ writer_name = "xetex" # Settings settings_overrides['language_code'] = 'ru' -# override the automatic addition of "unicode" option for "russian" language +# Override the automatic addition of "unicode" option for "russian" +# language to work around a problem with cyrillic in PDF-bookmarks in +# hyperref versions < v6.79g 2009/11/20 settings_overrides['hyperref_options'] = 'unicode=false' |