summaryrefslogtreecommitdiff
path: root/docs/user
Commit message (Collapse)AuthorAgeFilesLines
* Fix spellingmilde2021-10-224-22/+22
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8860 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Fix spelling errors.milde2021-10-211-15/+15
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8859 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* docutils-cli.py: Read settings from standard configuration files.milde2021-10-191-0/+29
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8858 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Config setting image_loading: use value "link" instead of "eager".milde2021-10-151-6/+6
| | | | | | | The name "eager" is too HTML5-centric. The distinction link/embed may be supported in future also by the ODF/ODT writer. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8854 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* New option "image_loading" for HTML5.milde2021-10-131-12/+27
| | | | | | | | With values "embed", "eager", "lazy", cf, feature-request #78. Obsoletes "embed_image". git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8853 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* HTML5: New default for table column widths (fixes bug #426).milde2021-10-011-2/+0
| | | | | | | | | Only specify table column widths, if the "widths" option is set and is not "auto". The `table_style`_ setting "colwidths-grid" restores the current default. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8836 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* LaTeX writer: New algorithm for table colum widths. Fixes bug #422.milde2021-09-302-89/+122
| | | | | | | | | | | | New configuration setting "legacy_column_widths" for backwards compatibility. Only write "continued on next page..." if it fits without making the table columns wider. Table `width` option overrides conflicting "auto" column `widths`. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8835 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Documentation updatemilde2021-09-241-44/+29
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8833 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* TODOsgrubert2021-08-231-2/+4
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8814 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* LaTeX writer: Refactor computation of table column widths.milde2021-08-102-9/+12
| | | | | | | | | Prepare for fixes (cf. bug #422). Update documentation. No change to the output. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8806 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Update SVG image samples and tests.milde2021-07-194-239/+28
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8804 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* HTML5: add self-link after section headings (feature request #28).milde2021-07-051-58/+64
| | | | | | | | | | | | The "section_self_link" setting triggers this behaviour. As it is currently only implemented for HTML5, the setting is defined for this writer only. The self-link "invisible" by default. The provided stylesheet "responsive.css" gives an example how it can be made visible when hovering over the section heading. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8788 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Reorganise functional tests.milde2021-06-301-40/+8
| | | | | | | | | | | Move additional tests for special features or problems specific to the output format from the "standalone_..." generic test case to additional tests. Use unit test instead of functional test for the fix in r6155 (hyperlink references in substitutions). git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8784 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* HTML5: small fixes, preparation for footnote handling refactoring.milde2021-06-251-1/+0
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8772 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Change default value for the "auto_id_prefix" setting to "%".milde2021-06-181-1/+1
| | | | | | | Auto-generated IDs use the tag name as prefix. Set auto_id_prefix_ to "id" if you want unchanged auto-IDs. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8771 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Make "meta" a standard node.milde2021-06-171-5/+10
| | | | | | Fixes also bug #241. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8766 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Minor documentation update.milde2021-05-271-1/+1
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8759 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Document recent changes to MathML support.milde2021-05-203-763/+13
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8757 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML: remove unrequired <mrow>s, support more commands.milde2021-05-201-101/+96
| | | | | | | | | | | | | Support additional commands from the AMS math-guide. Remove <mrow>, if it is single child and the parent inferres an mrow or if it has only one child element. tex_number(): do not return trailing delimiter. Use class "mathscr" instead of hard-codes font name for \mathscr. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8756 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML: support \circledR, \circledS, functions that take limits.milde2021-05-201-19/+15
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8755 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML fix multi-digit number literals. Support optional arg for \sqrt.milde2021-05-201-28/+21
| | | | | | | | Place consecutive digits and comma/dot in a common <mn> element. Support the optinal argument to specify a degree of a radical. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8754 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML: fix script/limt order when given as ^{super}_{sub}.milde2021-05-201-7/+12
| | | | | | | | Separate function to handle scripts or limits, Rename handle_keyword() and math.reverse. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8753 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML: new text_optarg(), refactor parse_latex_math(), support more TeX cmds.milde2021-05-201-36/+58
| | | | | | | | | | | tex_optarg(): New function to extract an optional argument parse_latex_math() now expects a start-node to expand and returns new current node (makes it usable for nested parsing), Support for \overset, \underset, \xrightarrow, \xleftarrow. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8752 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML: Refactor XML output routines.milde2021-05-201-11/+10
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8751 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* MathML: simplify node class interface, fix accent handling.milde2021-05-201-9/+12
| | | | | | | | | | | Instantiating functions for "math" class and descendents handle all positional arguments as children/data and named arguments as attributes. Set "accent" argument for <mover> according to LaTeX macro. Influences dropping of i-dot and size of top character, defaults to "automatic" (MathML 3) or "false" (MathML Core Draft). git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8750 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Comprehensive Sample Document/Guide for LaTeX math input.milde2021-05-201-0/+691
| | | | | | Move documentation to the user documentation dir. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8749 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Update documentation (links).milde2021-05-201-118/+57
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8732 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Remove IE 6 compatibility workaround for S5.milde2021-05-181-6/+0
| | | | | | | | Remove files ``iepngfix.htc`` and blank.gif, adapt code and docs. Fixes bug #169. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8729 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Default of "legacy_class_functions" setting changed to "False".milde2021-05-181-1/+1
| | | | | | | | - The setting `legacy_class_functions`_ now defaults to "False". - latex2e/docutils.sty: Fix excessive padding above sidebar titles. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8728 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Documentation update.milde2021-05-081-39/+27
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8719 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Documentation fixes.milde2021-04-191-94/+110
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8713 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Documentation update.milde2021-04-131-1/+1
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8691 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Update documentationmilde2021-04-071-54/+58
| | | | | | rST parser is no longer the only one. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8672 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Fix typo.milde2021-03-271-2/+2
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8645 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Documentation update.milde2021-03-263-168/+141
| | | | | | | | Fix or remove broken links. Adapt to changes in recent versions. Adapt to state of the art in HTML and web browsers. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8644 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Documentation update. Warn about file overwriting.milde2021-03-202-20/+20
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8640 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* HTML5 writer: support <video>.milde2021-03-201-0/+0
| | | | | | Use <video> for images with video MIME types supported by HTML5. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8639 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* HTML5 writer: Add a `viewport` meta tag to fix rendering in mobile browsers.milde2021-03-091-5/+0
| | | | | | | | The default behaviour of many mobile browsers is to render for a virtual viewport size and scale. This breaks CSS styling with the default stylesheets. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8632 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Small documentation updates and fixes.milde2021-03-058-75/+77
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8631 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Small documentation update.milde2021-02-182-10/+10
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8625 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Small documentation update/fix.milde2021-01-261-8/+24
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8610 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Support "captionbelow" class value for tables in HTML5.milde2021-01-261-14/+17
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8609 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Fix/improve "odf" writer metadata handling.milde2021-01-081-21/+22
| | | | | | | | | | Fix "keyword" splitting, patch by Casper Meijn, https://github.com/caspermeijn/docutils/commit/af5c7718f68abfb15f5225524b42c9bd1179fce1 Allow generic fields (stored as "Custom Properties"), based on patch #122 by pifi. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8604 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* New option "detailled" for the `pseudoxml` writer.milde2020-12-151-8/+13
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8592 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Implement feature request #40 Option to embed images as data URI.milde2020-11-271-5/+21
| | | | | | | | | | | | | | | If the new "embed_image" configuration setting is true, the image can be read from the local file system, and its MIME type can be determined, it is base64 encoded and included as a data URI. TODO: * Add an "embed" option to the "image" directive to allow embedding of individual images? * Use direct inlinging for SVG in HTML5? git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8581 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Update the link to PIL (now unmaintained) and hint to the drop-in ↵milde2020-11-251-1/+1
| | | | | | replacement Pillow. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8576 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Limit length of input lines and substitution expansion.milde2020-09-141-0/+15
| | | | | | | | | | | | | | | | | | Mitigate the danger of DoS attacs using specially crafted rST input (cf. bug #381). The default value of 10 000 characters should suffice for legitimate use cases (e.g. long paragraphs in auto-wrapping editors or extensive creative use of substitutions). Applications processing untrusted rST might wish to lower this limitation (together with other safety measures described in docs/howto/security.txt). Unsupervised processing of untrusted rST input should always be safeguarded with limits on processing time and memory use. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8565 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* LaTeX writer updatemilde2020-09-042-19/+24
| | | | | | | | | | | | | Fix workaround for section title of unsupported levels with the new-style class handling (class wrapper instead of class-argument for \DUtitle). Require minimal version of "docutils.sty" to get a warning in the LaTeX-log for obsolete files with the same name. Update documentation. git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8557 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Change the `initial_header_level`_ setting's default to "2"milde2020-09-041-2/+15
| | | | | | | | Browsers use the `same style for <h1> and <h2> when it's nested in a section`. cf. https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8556 929543f6-e4f2-0310-98a6-ba3bd3dd1d04
* Fix link to 2-Clause BSD license.milde2020-09-041-1/+1
| | | | git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk/docutils@8554 929543f6-e4f2-0310-98a6-ba3bd3dd1d04