[Docutils-checkins] SF.net SVN: docutils:[9405] trunk/docutils

[<mi...@us...>]

Revision: 9405
          http://sourceforge.net/p/docutils/code/9405
Author:   milde
Date:     2023-06-24 20:50:08 +0000 (Sat, 24 Jun 2023)
Log Message:
-----------
Add some cross-links and a TODO comment.

Modified Paths:
--------------
    trunk/docutils/docs/user/config.txt
    trunk/docutils/docutils/writers/odf_odt/__init__.py

Modified: trunk/docutils/docs/user/config.txt
===================================================================
--- trunk/docutils/docs/user/config.txt	2023-06-24 19:40:30 UTC (rev 9404)
+++ trunk/docutils/docs/user/config.txt	2023-06-24 20:50:08 UTC (rev 9405)
@@ -2035,6 +2035,8 @@
 ~~~~~~~~~~
 
 Specify a stylesheet URL, used verbatim.
+See section `Styles and Classes`_ in the `Odt Writer for Docutils`_
+document for details.
 
 Default: writers/odf_odt/styles.odt in the installation directory.
 
@@ -2046,7 +2048,8 @@
 contain a section named "Formats" that maps default style names to names
 to be used in the resulting output file allowing for adhering to external
 standards. For more info and the format of the configuration/mapping
-file, see the `Odt Writer for Docutils`_ document.
+file, see section `How to use custom style names`_ in the
+`Odt Writer for Docutils`_ document.
 
 cloak-email-addresses
 ~~~~~~~~~~~~~~~~~~~~~
@@ -2127,7 +2130,7 @@
 
 Specify the contents of a custom header line.  For details about
 custom headers and about special field character sequences, see
-section "Custom header/footers: inserting page numbers, date,
+section "`Custom header/footers`_: inserting page numbers, date,
 time, etc" in the `Odt Writer for Docutils`_ document for
 details.
 
@@ -2136,11 +2139,18 @@
 
 Specify the contents of a custom footer line.  For details about
 custom footers and about special field character sequences, see
-section "Custom header/footers: inserting page numbers, date,
+section "`Custom header/footers`_: inserting page numbers, date,
 time, etc" in the `Odt Writer for Docutils`_ document for
 details.
 
+.. _custom header/footers:
+    odt.html#custom-header-footers-inserting-page-numbers-date-time-etc
+.. _how to use custom style names:
+    odt.html#how-to-use-custom-style-names    
+.. _styles and classes:
+    odt.html#styles-and-classes    
 
+
 [pseudoxml writer]
 ------------------
 

Modified: trunk/docutils/docutils/writers/odf_odt/__init__.py
===================================================================
--- trunk/docutils/docutils/writers/odf_odt/__init__.py	2023-06-24 19:40:30 UTC (rev 9404)
+++ trunk/docutils/docutils/writers/odf_odt/__init__.py	2023-06-24 20:50:08 UTC (rev 9405)
@@ -1062,6 +1062,9 @@
         return self.dom_stylesheet
 
     def setup_paper(self, root_el):
+        # TODO: only call paperconf, if it is actually used
+        # (i.e. page size removed from "styles.odt" with rst2odt_prepstyles.py
+        # cf. conditional in walk() below)?
         try:
             dimensions = subprocess.check_output(('paperconf', '-s'),
                                                  stderr=subprocess.STDOUT)

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.