Commit Graph

327 Commits

Author SHA1 Message Date
jfbu
5510653d6e Fix #2629. Add new config option `latex_keep_old_macro_names`
The cause of the issue was a clash about ``\titleref`` macro being already
defined in memoir class context. To avoid similar problems, this makes
the text styling macros

  ``\strong``, ``\code``, ``\bfcode``, ``\email``, ``\tablecontinued``,
  ``\titleref``, ``\menuselection``, ``\accelerator``, ``\crossref``,
  ``\termref``, ``\optional``,

also available with ``\sphinx`` prefix, with a conf.py boolean option to
let sphinx.sty only define ``\sphinx``-prefixed macros. As default value
is False, backwards compatibility is maintained.

On this occasion, some internal non-public macros have been renamed with
prefix ``\spx@``. The command

    find . -name '*.sty' -exec grep -l \\\\spx@ {} \;

has been executed in TeXLive 2015 and 2016 installations to check no
package defines macros starting with ``\spx@``.

Some internal macros having public names (because they are written by
latex.py into the body of the latex document) have been renamed to have
``\sphinx`` prefix. The macros in sphinx.sty starting with \py@, or \DU,
or \PYG have not been modified. Similarly ``\release``, ``\version``,
``\releasename``, etc... have not been renamed.
2016-06-15 08:53:24 +02:00
jfbu
7d3bddd4e3 Convert text into links at bottom of tutorial.rst and top of config.rst 2016-06-09 15:34:59 +02:00
Takeshi KOMIYA
7661a92fc1 Update docs; the inputenc hack will be released at 1.4.3 2016-05-31 10:07:03 +09:00
Avram Lubkin
197b33816f Only add '\\usepackage[utf8]{inputenc}' when using pdflatex 2016-05-31 10:02:58 +09:00
Takeshi KOMIYA
98c27003d0 Update description of numref option (ref: #2384) 2016-05-27 23:40:01 +09:00
Takeshi KOMIYA
59c40c24f3 Add warning for Application.add_source_parser() 2016-04-24 13:57:32 +09:00
Takeshi KOMIYA
52c7867d14 Fix #2466: Allow image.data_uri and image.nonlocal_uri as confval of suppress_warnings 2016-04-22 11:14:46 +09:00
Takeshi KOMIYA
21ee53df2d Define new warning types for suppress_warnings (ref #2451) 2016-04-16 12:43:03 +09:00
Takeshi KOMIYA
d35ccb9b4c The default format of today_fmt and html_last_updated_fmt is back to strftime format again
`html_last_updated_fmt` is commonly used for non date formatting. But
LDML is difficult to represent them from its characteristics.

Now we moved to strftime format again (ref: #2394).
2016-04-03 10:25:32 +09:00
Takeshi KOMIYA
da94ca5699 Merge branch '2327_toplevel_sectioning' 2016-03-03 20:41:17 +09:00
Takeshi KOMIYA
110c2b0dbc Fix #2327: Add latex_toplevel_sectioning to switch the top level sectioning of LaTeX document. 2016-03-02 11:18:08 +09:00
Takeshi KOMIYA
2441c647d2 Fix #2229: no warning is given for unknown options 2016-02-23 12:23:06 +09:00
Takeshi KOMIYA
ae9d786390 Add :confval:suppress_warnings to supress arbitrary warning message 2016-02-23 12:23:06 +09:00
Takeshi KOMIYA
84fb1b7617 Fix #2245: Add `latex_elements["passoptionstopackages"]` option to call PassOptionsToPackages in early stage of preambles 2016-02-23 00:14:03 +09:00
Takeshi KOMIYA
904163f5b6 Merge pull request #2276 from tk0miya/1921_figure_substitutions
Fix #1921: Support figure substitutions by locale
2016-02-22 23:55:53 +09:00
Takeshi KOMIYA
3f0843bca0 Add figure_language_filename to customize filename pattern for figure substitutions 2016-02-22 21:32:05 +09:00
Takeshi KOMIYA
1f5aa28db0 Fix #1921: Support figure substitutions by locale 2016-02-22 21:32:05 +09:00
shimizukawa
cea8c85bf0 remove a part of description that mentioned about epub3 internal formating. 2016-02-22 10:36:39 +09:00
shimizukawa
905cbd09ed Fix: ambiguous description for epub3_page_progression_direction conf value. 2016-02-22 10:20:28 +09:00
Takeshi KOMIYA
2b93e09c0a Highlighting fallbacks by default
In 423bf7b, I tried to add fallback mechanism to ``python3``. But it breaks
the python3 highlighting on python2 environment.

This adds ``'default'`` to highlighting languages; it works like
``'python3'``, but fallbacks if failed Highlighting. And this removes
try-parse step from ``'python3'`` language. Now, it highlights regardless of
runtime environments.  Thanks to Yoshiki SHIBUKAWA.
2016-02-20 00:44:28 +09:00
shimizukawa
a7ae5e39d9 fix wrong documentation 2016-02-15 09:45:04 +09:00
Takeshi KOMIYA
4452cc3d2e Fix #794: Date formatting in latex output is not localized 2016-02-14 21:48:24 +09:00
shimizukawa
0992ce542b Closes #1853: support custom text splitter on html search with language='ja'. 2016-02-14 19:23:51 +09:00
Takayuki SHIMIZUKAWA
e1394b5427 Merge pull request #2321 from sphinx-doc/py-3-highlighting
The default highlight language is now Python 3. Use it in viewcode as well.
2016-02-14 19:10:05 +09:00
Georg Brandl
c1b7b6f369 The default highlight language is now Python 3.
References: #2279.

This means that source code is highlighted as Python 3 (which is mostly
a superset of Python 2), and no parsing is attempted to distinguish
valid code.
2016-02-14 09:21:35 +01:00
shimizukawa
81a0f13199 Merge pull request #1854 from mocobeta/search_ja_janome
Allow to choose Janome for Japanese splitter.
2016-02-14 16:46:21 +09:00
Georg Brandl
5e8642983b Fixup links in the documentation. 2016-02-13 16:00:46 +01:00
Alex Gaynor
79206ef7b1 fixed indentation here as well 2016-02-13 09:23:00 -05:00
Alex Gaynor
374c6a6db3 fixed indentation 2016-02-13 09:18:41 -05:00
Alex Gaynor
4f00a9905c Fixed #1099 -- allow the linkcheck builder to retry on errors.
This is useful because if you run linkcheck often, you are likely to see lots of transient network errors, which usually disappear if you simply try again.
2016-02-13 08:52:38 -05:00
SHIMIZU Taku
bca16504d1 Add a documentation for epub3 builder. 2016-02-07 14:20:32 +09:00
Takeshi KOMIYA
ae478f678e Fix #2022: html_extra_path also copies dotfiles and refers exclude_patterns 2016-01-24 19:17:50 +09:00
Takeshi KOMIYA
04a8c26eab Fix #2235: `needs_sphinx` supports micro version comparison 2016-01-21 13:51:17 +09:00
Takeshi KOMIYA
cf5e138a53 Merge pull request #2207 from tk0miya/baseclass_for_parsers
Add sphinx.parsers.Parser class; a base class for new parsers
2016-01-17 19:17:58 +09:00
Takeshi KOMIYA
f89e3dfee3 Update docs about sphinx.parsers.Parser class 2016-01-17 19:18:02 +09:00
Takeshi KOMIYA
8c8f3dbc9b Merge pull request #2208 from tk0miya/2027_html_title_only_accepts_string
Fix #2027: ``make epub`` got errors if ``html_title`` is None
2016-01-17 18:59:44 +09:00
shimizukawa
f824539119 merge with stable 2016-01-13 00:13:35 +09:00
Takeshi KOMIYA
8ea92359ba Fix warnings in CHANGES and docs 2016-01-12 13:36:12 +09:00
Georg Brandl
3bd7d08b6f Merge pull request #2170 from daoiqi/zh-search
add Chinese Search into milestones
2016-01-06 10:34:36 +01:00
Takeshi KOMIYA
01a526793d Fix typos #2122 (cherry-picked by hand) 2016-01-02 11:17:59 +09:00
Jakub Wilk
f86217c9d1 Fix typos. 2016-01-01 20:54:30 +01:00
Takeshi KOMIYA
3c907f2337 Fix #2027: `make epub got errors if html_title` is None
Sphinx does not expect setting None value as ``html_title`` in
spite of documented.
This changed that to deny None value as ``html_title``.
2016-01-01 10:35:45 +09:00
Georg Brandl
8232707a12 merge stable to default 2015-12-18 21:42:55 +01:00
daoiqi
d76a700fa2 add chinese search options into html_search_options document 2015-12-13 17:07:11 +08:00
shimizukawa
32d4ab51bd Update CHANGES refs #1757 2015-12-09 17:00:40 +09:00
Takayuki SHIMIZUKAWA
8bfc9409ec Merge pull request #1757 from hemmecke/master
fix unclear documentation for html_last_updated_fmt
2015-12-09 16:54:45 +09:00
Takeshi KOMIYA
aa475604dc `figure_align` is added at 1.3 2015-12-03 23:31:54 +09:00
TAKASE Arihiro
5e1028db43 Fix the language code for Portuguese 2015-09-13 10:07:34 +09:00
TAKASE Arihiro
8e7166df1e Fix the language code for Portuguese 2015-09-11 19:46:27 +09:00
kyleknap
cfb3a75953 Update `'releasename'` latex element docs
To address https://github.com/sphinx-doc/sphinx/issues/1782
2015-07-25 03:00:47 -07:00