summaryrefslogtreecommitdiff
path: root/sphinx/templates
Commit message (Collapse)AuthorAgeFilesLines
* Revert "Support and prefer ``.jinja`` to ``_t`` for static templates ↵James Addison2023-04-2320-0/+0
| | | | | (#11165)" (#11329) This reverts commit 5d13215b58f93c6be8255ef2e3e20836508c7d47.
* Use leaner TeX syntax (follow-up to #11319)Jean-François B2023-04-111-6/+6
| | | | Because it is cool. And avoids overhead. Matter of principle.
* LaTeX: get aligned longtable obey current list indentJean-François B2023-04-111-9/+13
| | | | | | Fix #11268. Thanks to @picnixz.
* Support and prefer ``.jinja`` to ``_t`` for static templates (#11165)James Addison2023-04-0720-0/+0
| | | Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Happy New Year!Adam Turner2023-01-011-1/+1
|
* LaTeX: support for booktabs-style and zebra-striped tables (#10759)Jean-François B2022-10-124-22/+121
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is a combination of 2 + 28 + 7 + and some more commits... * Cherry-pick: Add support for booktabs-style tables to LaTeX builder * Cherry-pick: Add support for zebra-striped tables to LaTeX builder Co-authored-by: Stefan Wiehler <stefan.wiehler@missinglinkelectronics.com> Above work originally initiated by @sephalon (thanks!) Development refactored and continued by @jfbu * latex_table_style configuration, support booktabs, colorrows, borderless Some details: - Simplify a bit a conditional in the longtable template This also puts the target for a longtable with a label but no caption above the toprule for better hyperlinking (testing shows hyperlink target can not end up alone at bottom of previous page). - Extend allowed syntax for colour assignments via 'sphinxsetup' - latex_table_style new configuration value and coloured rows For the user interface I tried to look for inspiration in https://docutils.sourceforge.io/docs/user/config.html#table-style which mentions booktabs and borderless. They also mention captionbelow which we can implement later, now that architecture is here. They don't mention coloured rows. - Test on our own document... looks fine! - Work-around an incompatibility of \cline with row colours - Reverse priority of classes to allow overruling booktabs by standard after parsing source but before letting LaTeX writer act - Closes #8220 Commit https://github.com/sphinx-doc/sphinx/commit/bb859c669679baebd8cc8d10c99382478c0d1647 already improved a bit, this finishes it (as :rst:dir:`rst-class` was actually not linking to anywhere). - Let booktabs style defaults to *not* using \cmidrule. They actually don't make much sense there, as all \hline's are removed. - Add \sphinxnorowcolor which allows construct such as this one in a tabularcolumns directive: >{\columncolor{blue}\sphinxnorowcolor} else LaTeX always overrides column colour by row colour - Add TableMergeColorHeader, TableMergeColorOdd, TableMergeColorEven so single-row merged cells can be styled especially - Extend row colours to all header rows not only the first one (all header rows will share same colour settings) - Auto-adjust to a no '|'-colspec for optimal handling of merged cell - Add \sphinxcolorblend - Workaround LaTeX's \cline features and other grid tables matters - Add \sphinxbuildwarning for important warnings - Fix some white gaps in merged cells of tables with vlines and colorrows - Work around LaTeX's \cline serious deficiencies for complex grid tables This commit corrects \cline badly impacting vertical spacing and making tables look even more cramped as they usually are in LaTeX (although one sees it clearly only with \arrarrulewidth a bit more than the LaTeX default of 0.4pt). Most importantly this commit solves the problem that \cline's got masked by colour panels from the row below. - Update CHANGES for PR #10759 - Improve documentation of new latex_table_style regarding colours
* Reduce content in the `sphinx-quickstart` `conf.py` file (#10571)Pradyun Gedam2022-06-251-66/+18
|
* Fix #10122: make.bat should check the installation before helpTakeshi KOMIYA2022-01-301-2/+2
|
* A happy new year!Takeshi KOMIYA2022-01-011-1/+1
|
* Remove intersphinx_disabled_domains from quickstartJakob Lykke Andersen2021-10-311-3/+0
|
* Add intersphinx_disabled_domainsJakob Lykke Andersen2021-10-311-0/+4
| | | | | Fixes sphinx-doc/sphinx#2068 Replaces sphinx-doc/sphinx#8981
* Merge pull request #9616 from jdufresne/fix-urlTakeshi KOMIYA2021-09-112-2/+2
|\ | | | | Update Sphinx url: s|https?://sphinx-doc\.org/|https://www.sphinx-doc.org/|g
| * Update Sphinx url: s|https?://sphinx-doc\.org/|https://www.sphinx-doc.org/|gJon Dufresne2021-09-062-2/+2
| | | | | | | | | | | | https://sphinx-doc.org is unreachable, but is linked from the PyPI page: https://pypi.org/project/Sphinx/. Switch to https://www.sphinx-doc.org/ instead.
* | Fix typos discovered by codespellChristian Clauss2021-09-081-1/+1
|/
* Fix #9608: apidoc: module is not described if implicit namespace packageTakeshi KOMIYA2021-09-041-0/+4
| | | | | To make implicit namespace packages referencable, this outputs empty module definitions for them.
* Fix #9009: LaTeX: "release" value with underscore leads to invalid LaTeXTakeshi KOMIYA2021-03-171-1/+1
| | | | The "release" variable is not escaped on the LaTeX output.
* Merge pull request #8986 from ↵Takeshi KOMIYA2021-03-131-1/+3
|\ | | | | | | | | webknjaz/bugfixes/8985-new-style-intersphinx-mapping Make `conf.py` template use new-style interpshinx
| * Make `conf.py` template use new-style interpshinxSviatoslav Sydorenko2021-03-121-1/+3
| | | | | | | | Fixes #8985
* | Merge branch 'master' into pdf_bookmarksdepthJean-François B2021-03-124-6/+6
|\ \
| * | Close #8326: Rename master_doc to root_docTakeshi KOMIYA2021-02-284-6/+6
| | | | | | | | | | | | | | | | | | To describe the purpose more accurately, the `master_doc` is now renamed to `root_doc`. The old name is still available. But it is recommeneded to use new one from now on.
* | | LaTeX: let bookmarks use high default depthjfbu2021-02-181-0/+2
|/ / | | | | | | Add bookmarksdepth key to latex_elements['sphinxsetup']
* | Merge branch '3.x'Takeshi KOMIYA2021-01-281-0/+3
|\ \ | |/
| * Fix #8442: missing index entries in pdf output with memoir + xindyjfbu2021-01-261-0/+3
| |
* | LaTeX: sync pdftex engine default imageresolution with pxunitjfbu2021-01-251-0/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Closes: #8253 The 'pxunit' key from latex_elements instructs how to handle image dimensions specified in px units. But pdftex has \pdfimageresolution which is used when an image file does not provide readable or legit values for the x and/or y resolution. This commit syncs them: from 'pxunit' the default image resolution in pixels per inch (an integer) is computed. This way an image will behave the same if: - it is loaded with no explicit size set, _and_ no readable image resolution data is readable from the file (or that data matches the 'pxunit' setting) - or a size is set in figure directive using px units and equal to the natural pixel size of the image, This also with 'lualatex' but is ignored by with 'xelatex' and 'uplatex'.
* | LaTeX: update default font configurationjfbu2021-01-201-0/+1
| | | | | | | | | | | | | | | | | | | | | | This replaces times package with tgtermes and tgheros (clones of Times and Helvetica with better LaTeX support) and the monospace font from txfonts package (txtt). This font is better matched with Times-like fonts than Courier clones. The changes applies to pdflatex/platex/uplatex. Fixes: #8711
* | Merge branch '3.x'Takeshi KOMIYA2021-01-011-1/+1
|\ \ | |/
| * A happy new year!Takeshi KOMIYA2021-01-011-1/+1
| | | | | | | | | | | | | | .. note:: $ find sphinx tests LICENSE doc/conf.py -type f -exec sed -i '' -e 's/2007\-20../2007-2021/' {} \; $ git co sphinx/locale/**/*.js sphinx/templates/epub3/mimetype
* | Merge branch '3.x'Takeshi KOMIYA2020-11-221-1/+1
|\ \ | |/
| * Fix #8437: Do `make clean` in more safe wayTakeshi KOMIYA2020-11-201-1/+1
| | | | | | | | | | | | | | When users gives empty BUILDDIR to the `make clean` command on non-make mode, our Makefile will remove all of files of systems via `rm -rf /*`. To prevent the catastrophic operation, this makes the `make clean` command safety.
* | Update Makefile_tAaron Carlisle2020-10-051-0/+1
| |
* | Update make.bat_tAaron Carlisle2020-10-051-0/+1
| |
* | Makefiles: Include clean in help messageAaron Carlisle2020-10-012-2/+2
|/ | | | The make clean help command was missing from all make files.
* Cleaner fix for double trailing whitespace apidocAleksaC2020-07-111-4/+3
|
* Fix double trailing whitespace for apidoc with module firstAleksaC2020-07-091-2/+3
|
* latex: Allow to add LaTeX package after hyperref loaded via APITakeshi KOMIYA2020-05-241-0/+8
|
* Fix typo in make.bat_t, https:// linkAllan Nordhøy2020-05-211-3/+3
|
* * Propagated "maxdepth" recursively through package documents.Sergio Garcia Prado2020-03-141-0/+1
|
* Merge branch '2.0'Takeshi KOMIYA2020-01-301-1/+1
|\
| * Fix #7019: gettext: Absolute path used in message catalogsTakeshi KOMIYA2020-01-131-1/+1
| |
* | Merge branch '2.0'Takeshi KOMIYA2020-01-011-1/+1
|\ \ | |/
| * A happy new year!Takeshi KOMIYA2020-01-011-1/+1
| |
* | Merge branch '2.0'Takeshi KOMIYA2019-12-161-2/+2
|\ \ | |/
| * Close #6781: gettext Add confvals to customize headers of POT fileTakeshi KOMIYA2019-12-151-2/+2
| | | | | | | | | | * gettext_last_translator * gettext_language_team
* | Merge branch '2.0'Takeshi KOMIYA2019-12-091-1/+1
|\ \ | |/
| * Update longtable latex templatejfbu2019-12-071-1/+1
| |
* | Merge branch '2.0'Takeshi KOMIYA2019-11-172-0/+34
|\ \ | |/
| * gettext: Use template file to generate message catalogTakeshi KOMIYA2019-11-081-0/+33
| |
| * Close #6762: latex: Allow to load additonal LaTeX packagesTakeshi KOMIYA2019-11-051-0/+1
| |
* | Merge branch '2.0'Takeshi KOMIYA2019-08-191-3/+2
|\ \ | |/
| * Update links in quickstart template to save redirectsSteve Piercy2019-08-021-3/+2
| |
View Lorry Controller Status