Commit Graph

1359 Commits

Author SHA1 Message Date
Takeshi KOMIYA
d45c5f8e82 #2725: latex builder: allow to use user-defined template file (experimental) 2016-08-17 22:52:42 +09:00
Takeshi KOMIYA
8a9459b308 Merge branch 'stable' 2016-08-09 23:19:11 +09:00
Yoshiki Shibukawa
90b3c79895 fix html entity to fix epub error 2016-08-09 16:58:56 +09:00
Yoshiki Shibukawa
8f162a132e fix epub warning in Sphinx's document 2016-08-09 16:58:56 +09:00
Yoshiki Shibukawa
59ebeb7f1f fix epub3 toc.xhtml, epub date format to satisfy spec 2016-08-09 16:58:56 +09:00
Jakob Lykke Andersen
1b251797bb Merge branch 'master' into cpp-concepts 2016-08-07 18:37:31 +02:00
Takeshi KOMIYA
a9da999d71 Merge branch 'stable' 2016-08-08 00:40:42 +09:00
Jakob Lykke Andersen
678630a59b C++, add support for removing index text prefixes
Closes sphinx-doc/sphinx#1958.
2016-08-06 00:53:50 +02:00
Jakob Lykke Andersen
c85e60a5ac C++, increase support for attributes.
User-defined attributes and simple C++11 style attributes.
Closes sphinx-doc/sphinx#2682.
2016-08-06 00:08:02 +02:00
Ashley Whetter
cfd4e51802 Python domain can now link container types automatically
Google types now greedily match the closing parenthesis.

Also removed name from returns section in Google docstrings.
Instead, everything before the colon is treated as the type.
2016-08-03 17:09:40 +01:00
Eric Knibbe
56ee02114a remove extra colons in C++ domain examples 2016-08-02 15:22:50 -04:00
Yoshiki Shibukawa
d842a4cbc8 Turn off viewcode extension by default 2016-07-28 15:38:38 +09:00
Takeshi KOMIYA
d651613583 Merge pull request #2772 from tk0miya/good_default_settings_for_latexpdfja
better default LaTeX settings for Japanese
2016-07-21 01:06:08 +09:00
Takeshi KOMIYA
f2a7eeca60 Merge pull request #2774 from tk0miya/latex_engine
Add `latex_engine` to switch the LaTeX engine by conf.py
2016-07-21 01:05:51 +09:00
Takeshi KOMIYA
80bfc55795 Merge branch 'stable' 2016-07-21 00:20:25 +09:00
Takeshi KOMIYA
c698fab338 Merge pull request #2786 from shibukawa/fix/epub
Reduce epub checker warnings/errors for epub3 builder.
2016-07-20 23:30:59 +09:00
Yoshiki Shibukawa
b7b1ac1c4d add preferred instruction to download role description 2016-07-19 23:35:49 +09:00
Yoshiki Shibukawa
702004acfc fix document download roles. download roles works only on html. 2016-07-19 23:15:35 +09:00
Takeshi KOMIYA
1a575f4666 Update CHANGES and docs 2016-07-19 11:03:38 +09:00
Yoshiki Shibukawa
06a861703d Reduce epub checker warnings/errors for epub3 builder.
Fix DOCTYPE to html5 and change extension from .html to .xhtml.

Sphinx's documents result:

  before: 95 warnings& 1238 errors
  after: 623 errors
2016-07-17 09:53:04 +09:00
Takeshi KOMIYA
253eef9e6a #2680: sphinx.ext.todo now emits warnings if todo_emit_warnings enabled 2016-07-16 00:59:02 +09:00
Takeshi KOMIYA
2aace8d54b Use jreport to the docclass for Japanese howto documents 2016-07-15 23:34:51 +09:00
Takeshi KOMIYA
fc9c9e04ee better default LaTeX settings for Japanese 2016-07-15 22:36:49 +09:00
Ville Skyttä
302c695048 Run *.png through zopflipng -m
Before: 2334583 bytes
After:  2136324 bytes
2016-07-07 18:34:18 +03:00
Ville Skyttä
f1316a0bb3 Run *.jpg through jpegoptim -s
Before: 28408 bytes
After:  25206 bytes
2016-07-07 18:34:18 +03:00
Ville Skyttä
7cfbc2a702 Fix style checks 2016-07-07 16:48:12 +03:00
Takeshi KOMIYA
31c6beb578 Merge pull request #2454 from mgeier/html-sourcelink-txt
Add option html_sourcelink_suffix
2016-07-06 01:43:18 +09:00
Rob Ruana
8eecdbd715 [Napoleon] Removes Python 2/3 compatible type annotation doc example, because they aren't current supported by Sphinx 2016-07-02 11:43:55 -04:00
Takeshi KOMIYA
e3c3e4f0cb Merge branch 'stable' 2016-07-02 16:39:13 +09:00
jfbu
067d3cabf0 latex, make use of `\small` for code listings customizable 2016-06-30 11:20:30 +02:00
jfbu
f30a8d5a36 fix a mark-up typo in doc/install.rst 2016-06-30 11:10:58 +02:00
jfbu
a20533540b Add a sentence in doc/config.rst on `'pxunit'` key 2016-06-29 20:55:07 +02:00
jfbu
d76e9d48a5 Update doc/rest.rst 2016-06-26 23:13:32 +09:00
jfbu
fc2202fd2a latex, replace `'pixelsize' by more precise 'pxunit'` name 2016-06-25 10:32:48 +02:00
jfbu
f6b0ae903d latex, allow image dimensions using px unit (96px=1in)
New key ``'pixelsize'`` in ``latex_elements`` dictionary.
2016-06-24 20:36:35 +02:00
Rob Ruana
2b60fc2027 Fixes #2688: [Napoleon] Updates to Napoleon documentation to fix intersphinx links and demonstrate PEP 484 type annotations 2016-06-23 15:25:46 -04:00
jfbu
5bd76815ff Added an item about sphinxVerbatim to doc/latex.rst 2016-06-22 22:30:58 +02:00
jfbu
12ade10d55 New latex.rst for extended documentation of LaTeX's customizing. 2016-06-20 09:23:41 +02:00
jfbu
2cec5a25b2 Merge branch 'stable'
Conflicts:
	sphinx/domains/cpp.py
	sphinx/texinputs/sphinx.sty
	tests/test_build_latex.py
2016-06-15 18:29:58 +02:00
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
Rob Ruana
ff34d02beb Fix #2537: [Napoleon] Corrects minor formatting issue on example NumPy Attributes section 2016-06-12 14:55:39 -06:00
Rob Ruana
32a852c1f1 Update #2374: [Napoleon] clarifies documentation of napoleon_include_init_with_doc conf value 2016-06-11 18:28:48 -06:00
Takeshi KOMIYA
a35399a0aa Merge branch 'stable' 2016-06-10 20:55:05 +09: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
jfbu
c51282530c Merge branch 'stable' 2016-06-08 11:38:33 +02:00
Matthias Geier
5559150578 Change html_sourcelink_txt -> html_sourcelink_suffix 2016-06-07 15:17:12 +02:00
Matthias Geier
86615e1f09 Add option html_sourcelink_txt 2016-06-07 15:15:39 +02:00
jfbu
f38665b58c Display correctly the Builtin themes in the PDF build of Sphinx doc
Add longtable as class, which will allow pagebreaks in pdf output.
2016-06-06 14:42:58 +02:00
Takeshi KOMIYA
f6ebd372d4 Merge branch 'stable' 2016-06-05 17:24:41 +09:00
Takeshi KOMIYA
7661a92fc1 Update docs; the inputenc hack will be released at 1.4.3 2016-05-31 10:07:03 +09:00