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

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

Revision: 7994
          http://sourceforge.net/p/docutils/code/7994
Author:   milde
Date:     2016-12-10 17:41:45 +0000 (Sat, 10 Dec 2016)
Log Message:
-----------
Add rst2html4 front end. Update docs.

Modified Paths:
--------------
    trunk/docutils/HISTORY.txt
    trunk/docutils/RELEASE-NOTES.txt
    trunk/docutils/docs/user/html.txt
    trunk/docutils/setup.py

Added Paths:
-----------
    trunk/docutils/tools/rst2html4.py

Modified: trunk/docutils/HISTORY.txt
===================================================================
--- trunk/docutils/HISTORY.txt	2016-12-10 17:19:12 UTC (rev 7993)
+++ trunk/docutils/HISTORY.txt	2016-12-10 17:41:45 UTC (rev 7994)
@@ -16,6 +16,7 @@
 Changes Since 0.13.1
 ====================
 
+  - New front-end ``rst2html4.py``.
 
 Release 0.13.1 (2016-12-09)
 ===========================

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2016-12-10 17:19:12 UTC (rev 7993)
+++ trunk/docutils/RELEASE-NOTES.txt	2016-12-10 17:41:45 UTC (rev 7994)
@@ -34,10 +34,23 @@
 
 * Drop support for python 2.4 after release 0.13.
 
+* The default HTML writer may eventually become "html" with frontend
+  ``rst2html.py``.
+
+  Use `get_writer_by_name('html')` or the rst2html.py_ front end, if you
+  want the output to be up-to-date automatically.
+
+  Use a specific writer name or front end, if you depend on stability of the
+  generated HTML code, e.g. because you use a custom style sheet or
+  post-processing that may break otherwise.
+
+
 Changes Since 0.13.1
 ====================
 
+  - New front-end ``rst2html4.py``.
 
+
 Release 0.13.1 (2016-12-09)
 ===========================
 
@@ -52,13 +65,14 @@
 
 .. _HTML 5: http://www.w3.org/TR/html5/
 
-* languages: persian/farsi and latvian/la mappings.
+* languages: persian/farsi (fa) and latvian (la) mappings.
 
-* change default base url for :rfc: to http://tools.ietf.org/html/  
+* change default base url for :rfc: to http://tools.ietf.org/html/
 
-* tables accept widths, a list and align 
+* tables accept widths, a list and align
 
-* latex2e: Fix admonition width, remove deprecated options, better tablewidth auto, ... 
+* latex2e: Fix admonition width, remove deprecated options,
+           better tablewidth auto, ...
 
 * rst.el : The problem with ``electric-indent-mode`` has been fixed.
 

Modified: trunk/docutils/docs/user/html.txt
===================================================================
--- trunk/docutils/docs/user/html.txt	2016-12-10 17:19:12 UTC (rev 7993)
+++ trunk/docutils/docs/user/html.txt	2016-12-10 17:41:45 UTC (rev 7994)
@@ -95,7 +95,7 @@
 :config: `[html5 writer]`_
 
 The ``html5_polyglot`` writer generates `polyglot HTML`_ output, valid XML that
-is compatible with `HTML5`_.
+is compatible with `HTML5`_ (cf. `Benefits of polyglot XHTML5`_).
 New features and elements will only be used if they are widely supported to
 make documents `viewable with any browser`_.
 
@@ -113,8 +113,8 @@
 .. _plain.css: ../../docutils/writers/html5_polyglot/plain.css
 .. _custom style sheets: ../howto/html-stylesheets.html
 .. _viewable with any browser: http://www.anybrowser.org/campaign
+.. _Benefits of polyglot XHTML5: http://xmlplease.com/xhtml/xhtml5polyglot/
 
-
 HTML writers in the sandbox
 ---------------------------
 

Modified: trunk/docutils/setup.py
===================================================================
--- trunk/docutils/setup.py	2016-12-10 17:19:12 UTC (rev 7993)
+++ trunk/docutils/setup.py	2016-12-10 17:41:45 UTC (rev 7994)
@@ -168,6 +168,7 @@
                    ]
                    + s5_theme_files),
     'scripts' : ['tools/rst2html.py',
+                 'tools/rst2html4.py',
                  'tools/rst2html5.py',
                  'tools/rst2s5.py',
                  'tools/rst2latex.py',

Added: trunk/docutils/tools/rst2html4.py
===================================================================
--- trunk/docutils/tools/rst2html4.py	                        (rev 0)
+++ trunk/docutils/tools/rst2html4.py	2016-12-10 17:41:45 UTC (rev 7994)
@@ -0,0 +1,26 @@
+#!/usr/bin/env python
+
+# $Id$
+# Author: David Goodger <go...@py...>
+# Copyright: This module has been placed in the public domain.
+
+"""
+A minimal front end to the Docutils Publisher, producing (X)HTML.
+
+The output conforms to XHTML 1.0 transitional
+and almost to HTML 4.01 transitional (except for closing empty tags).
+"""
+
+try:
+    import locale
+    locale.setlocale(locale.LC_ALL, '')
+except:
+    pass
+
+from docutils.core import publish_cmdline, default_description
+
+
+description = ('Generates (X)HTML documents from standalone reStructuredText '
+               'sources.  ' + default_description)
+
+publish_cmdline(writer_name='html4', description=description)


Property changes on: trunk/docutils/tools/rst2html4.py
___________________________________________________________________
Added: svn:executable
## -0,0 +1 ##
+*
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Author Date Id Revision
\ No newline at end of property
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.