Jean-François B.
bf431ed0d7
LaTeX: do not use `\small with FreeMono, but Scale=0.9` ( #12822 )
2024-08-25 17:07:49 +02:00
Jean-François B.
3d49941484
LaTeX: two lines lost in previous commit (docs) ( #12819 )
2024-08-23 18:15:40 +02:00
Jean-François B.
9943274033
LaTeX: clarify some docs, add syntax highlighting (refactoring) ( #12818 )
2024-08-23 18:04:38 +02:00
Jean-François B.
1c131dfffe
LaTeX: make contents, topic, and sidebar separately customizable ( #12704 )
...
Co-authored-by: Bénédikt Tran <10796600+picnixz@users.noreply.github.com>
2024-08-19 20:43:47 +02:00
Thomas Fanning
e0f2009346
LaTeX: Add math_numsep support to latex builder ( #12652 )
...
Co-authored-by: Jean-François B <2589111+jfbu@users.noreply.github.com>
2024-08-18 21:34:20 +02:00
Jean-François B.
4c7fe10a4b
LaTeX: fix mark-up when \DUrole is used with multiple classes ( #12745 )
2024-08-17 20:33:15 +02:00
Jean-François B.
afaddd3c45
Update LaTeX docs with new admonition colours ( #12588 )
2024-07-15 18:28:40 +01:00
Adam Turner
7b570c06a1
Standardise on a common directive for describing code snippets
2024-07-15 02:15:52 +01:00
Jean-François B
aa6dac81ec
LaTeX: Revamp the styling of all admonitions ( #12508 )
...
In LaTeX output, all admonitions now also have a title row with icon.
The ``xcolor`` LaTeX package is now required and the ``fontawesome5`` LaTeX package is needed for the icons.
2024-07-13 17:33:22 +01:00
Jean-François B
e49e2933bb
LaTeX: Use the babel LaTeX package by default for 'lualatex' with French ( #12557 )
...
Previously ``polyglossia`` was used by default.
2024-07-13 09:02:43 +01:00
Adam Turner
82edc3d385
Rewrite `usage/configuration.rst` ( #12537 )
...
- Remove now-removed configuration values
- Use obvious 'unset' defaults for ``project`` and ``author``
- Prefer 'e.g.' to 'ex.'
- Allow non-list sequence types in various configuration values
- Add types and defaults to every confval directive
2024-07-10 21:43:14 +01:00
Jean-François B
b90482fc81
LaTeX: fix docs for `'babel' key of latex_elements` ( #12411 )
...
This fixes the documentation which was faulty since v1.7.6, but #12410 is left open until a decision is taken.
2024-06-05 12:52:35 +02:00
James Addison
0806a00f05
Support `.jinja` for theme static templates ( #11916 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2024-04-23 10:40:24 +01:00
Bénédikt Tran
b2069fb64f
[lint] update Makefile and lint doc ( #12117 )
2024-03-17 14:45:56 +01:00
Dimitri Papadopoulos Orfanos
460a63010f
Fix various spelling errors ( #11735 )
2024-01-04 02:37:44 +00:00
picnixz
480630c649
Support PEP 695 and PEP 696 syntax in the Python domain ( #11444 )
...
* Generic classes can be documented with ``.. py:class::`` using PEP 695 syntax:
.. code:: rst
.. py:class:: Sequence[T]
* Generic functions can be documented with ``.. py:function::`` using PEP 695 syntax:
.. code:: rst
.. py:function:: foo[T](x: T)
* Default values for type bounds are supported.
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
2023-07-23 23:22:40 +01:00
TLouf
86b07d4a97
Allow multi-line object description signatures ( #11011 )
...
Co-authored-by: Adam Turner <9087854+aa-turner@users.noreply.github.com>
Co-authored-by: Jean-François B <2589111+jfbu@users.noreply.github.com>
Co-authored-by: TLouf <loufthomas@gmail.com>
2023-05-11 14:28:57 +01:00
James Addison
59de8d5202
Revert "Support and prefer `.jinja to _t` for static templates ( #11165 )" ( #11329 )
...
This reverts commit 5d13215b58
2023-04-23 19:06:44 +01:00
Jean-François B
188b869fa2
Use longtable for our document in PDF format
...
Previous commit applied longtable class to the next one, but this still
left the previous table prevent an earlier page break.
2023-04-11 22:59:28 +02:00
Jean-François B
256ac63bf9
Use a :class:longtable in our document for LaTeX PDF output
...
Now that #11268 has been fixed via #11319 .
2023-04-11 20:48:24 +02:00
James Addison
5d13215b58
Support and prefer `.jinja to _t` for static templates ( #11165 )
...
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
2023-04-07 18:07:15 +01:00
Adam Turner
7ecf037280
Enable 'nit-picky mode' for Sphinx's documentation
...
Fix several reference errors throughout the documentation and set
``nitpick_ignore`` in ``doc/conf.py``.
2023-04-06 23:11:39 +01:00
Jean-François B
8f9bac9c4f
LaTeX: rename `\sphinxnotetitle into \sphinxstylenotetitle` (etc)
...
Follow-up to #11266 . Using \sphinxstyle prefix looked a posteriori
better, for coherency, although it is a bit long.
2023-03-27 15:21:06 +02:00
Jean-François B
7cdd9b2679
LaTeX: let \sphinxremovefinalcolon work also if no colon in input
2023-03-27 12:21:26 +02:00
Dimitri Papadopoulos
669bcc0a19
Fix typos found by codespell
2023-03-27 07:22:07 +02:00
Jean-François B
7144f4924a
LaTeX: add \sphinxnotetitle et al.
...
In passing I reverted some deprecation I had added at 6bf40599e
2023-03-26 23:57:04 +02:00
Jean-François B
a7949d4290
LaTeX: let mark-up for seealso directive use explicit colon ( fix #11264 )
2023-03-26 23:57:04 +02:00
Jean-François B
ec25892dd9
LaTeX: doc updates
...
modified: doc/latex.rst
2023-03-20 10:34:15 +01:00
Jean-François B
8ed2c6708d
LaTeX: update doc, trim unneeded extra examples
2023-03-20 00:10:31 +01:00
Jean-François B
de60cd8618
LaTeX: support elliptical corners in rounded boxes
2023-03-19 21:47:03 +01:00
Jean-François B
f78d86554c
LaTeX: remove more-or-less obsolete doc
2023-03-19 21:23:06 +01:00
Jean-François B
cf6273a6b1
LaTeX: fix nits with some mark-up in doc and code comment
2023-03-19 19:09:08 +01:00
Jean-François B
b433d4cb9d
LaTeX: warn about \sphinxbox addstrut default possibly changed at 7.0.0
2023-03-19 18:33:13 +01:00
Jean-François B
6bf40599e2
LaTeX: add <prefix>_{TeXcolor,TeXextras} options
...
And add <type>TextColor and <type>TeXextras for <type>=hint, important,
note, tip for variants which do not trigger for sphinxheavybox but
still uses sphinxlightbox (suitably enhanced).
Similar named TeXcolor and TeXextras options for \sphinxbox.
2023-03-19 18:29:09 +01:00
Jean-François B
4d7347cf1b
LaTeX: reset options in nested \sphinxbox'es
2023-03-19 18:28:37 +01:00
Jean-François B
e80c1e6b31
LaTeX: let rounded boxes support up to 4 distinct border-widths
...
Internally replace "strokepath" operation for drawing the border
(which mandated constant border-width) by only "fillpath" operations.
This also allowed to significantly simplify some other aspects of the
code related to box-decoration-break=slice.
2023-03-15 17:59:43 +01:00
Jean-François B
78e14fb6ba
LaTeX: add boolean option addstrut to \sphinxbox/\sphinxboxsetup
2023-03-14 23:52:32 +01:00
Jean-François B
ee3c720cfa
LaTeX: also admonition directives support box-decoration-break=slice
2023-03-13 19:50:31 +01:00
Jean-François B
99863fb080
LaTeX: encapsulate dimension options in \dimexpr
2023-03-13 12:25:47 +01:00
Jean-François B
85fbfe1fa9
LaTeX: polish code comments
2023-03-13 10:47:01 +01:00
Jean-François B
819c7d508d
LaTeX: mumble with trailing whitespaces in latex.rst
2023-03-12 18:37:21 +01:00
Jean-François B
e1c521f38b
LaTeX: documentation and a mark-up fix in latex.rst
2023-03-12 18:28:54 +01:00
Jean-François B
aeeadb6f1e
Fix #11235 : LaTeX: `\color` may cause color leaks in topic or notices
2023-03-12 15:55:57 +01:00
Jean-François B
212ed5b940
LaTeX: add support for styling `note (hint, ...) similarly as warning ( danger`, ...) ( #11234 )
2023-03-12 11:28:36 +01:00
Jean-François B
d50ae3c1c9
LaTeX: fix some documentation from #11224
2023-03-07 19:10:43 +01:00
Jean-François B
e39949fed0
Update some LaTeX comments and documentation after #11224
2023-03-07 13:58:02 +01:00
Jean-François B
b635150bc7
LaTeX: `\sphinxbox` for boxing inline text elements
2023-03-07 13:19:19 +01:00
Jean-François B
b88713e68e
Update LaTeX docs
2023-01-24 14:45:46 +01:00
Jean-François B
55170d01d7
LaTeX: `\emph replaced by \sphinxparam and \sphinxsamedocref`
2023-01-24 14:11:24 +01:00
Jean-François B
6259c2b723
Markup typo in docs
2023-01-07 00:03:52 +01:00
