SF.net SVN: docutils:[9586 ] trunk/sandbox/manpage-wri ter

Revision: 9586
          http://sourceforge.net/p/docutils/code/9586
Author:   grubert
Date:     2024-03-24 17:58:23 +0000 (Sun, 24 Mar 2024)
Log Message:
-----------
add tests for references to terminal (latin1, utf8)
BUG man misses to print the urls

Added Paths:
-----------
    trunk/sandbox/manpage-writer/expected/references.latin1
    trunk/sandbox/manpage-writer/expected-mandoc/references.utf8

Added: trunk/sandbox/manpage-writer/expected/references.latin1
===================================================================
--- trunk/sandbox/manpage-writer/expected/references.latin1	                        (rev 0)
+++ trunk/sandbox/manpage-writer/expected/references.latin1	2024-03-24 17:58:23 UTC (rev 9586)
@@ -0,0 +1,86 @@
+REFERENCE TESTS()                                            REFERENCE TESTS()
+
+NAME
+       reference tests -
+
+HOW TO MARKUP
+       link adr in .UR .UE or simply in parantheses
+
+       \xB7 man and mandoc convert UR/UE to < and >.
+
+       \xB7 pandoc transforms
+
+            See the `Python home page <https://www.python.org>`_ for info.
+
+         to
+
+            see See the Python home page (https://www.python.org) for info.
+
+TEST FOR REFERENCES IN MAN PAGES
+       embedded in a paragraph
+
+       \xB7 at line start
+
+       \xB7 in line
+
+       \xB7 at eol
+
+       at start of paragraph
+
+       \xB7 followed by text
+
+       \xB7 at eol
+
+       at end of paragraph
+
+TESTS
+       See     ]8;;https://docutils.sourceforge.io/docs/user/rst/quickref.html#explicit-markup\https://docutils.sourceforge.io/docs/user/rst/quickref.html#ex-
+       plicit-markup]8;;\
+
+       for more
+
+       See the ]8;;https://www.python.org\Python home page]8;;\
+        for info.
+
+       External hyperlinks, like ]8;;https://www.python.org\Python]8;;\ .
+
+       Want to learn about ]8;;https://www.python.org\my favorite programming language]8;;\ ?
+
+       Clicking on this internal hyperlink will take us to the ]8;;target\target]8;;\
+
+       below.
+
+       The hyperlink target above points to this paragraph.
+
+       \xB7 bullet list
+
+       \xB7 second item, with hyperlink target.
+
+       See the ]8;;https://www.python.org\Python]8;;\
+        home page for info.
+
+
+       ]8;;mailto:[email protected]\Write to me]8;;\
+        with your questions.
+
+       The ]8;;https://docutils.sourceforge.io/rst.html\one-liner]8;;\
+        and ]8;;https://docutils.sourceforge.net/rst.html\starts-on-this-line]8;;\
+        or ]8;;https://docutils.sourceforge.net/rst.html\entirely-below]8;;\
+        point to ]8;;https://docutils.sourceforge.io/rst.html\https://docutils.sourceforge.io/rst.html]8;;\
+        and in man are ... ?
+
+       Escaped whitespace is preserved as intentional spaces, e.g.:
+
+       some ]8;;../local\reference]8;;\
+        to a local path.
+
+       Anonymous hyperlink references are specified with two  underscores  in-
+       stead of one:
+
+       See ]8;;https://www.python.org\the web site of my favorite programming language]8;;\ .
+
+       Anonymous targets begin with ".. __:"; no reference name is required or
+       allowed:
+
+
+                                                             REFERENCE TESTS()

Added: trunk/sandbox/manpage-writer/expected-mandoc/references.utf8
===================================================================
--- trunk/sandbox/manpage-writer/expected-mandoc/references.utf8	                        (rev 0)
+++ trunk/sandbox/manpage-writer/expected-mandoc/references.utf8	2024-03-24 17:58:23 UTC (rev 9586)
@@ -0,0 +1,87 @@
+REFERENCE TESTS()                                            REFERENCE TESTS()
+
+NNAAMMEE
+       reference tests -
+
+HHOOWW TTOO MMAARRKKUUPP
+       link adr in .UR .UE or simply in parantheses
+
+       • man and mandoc convert UR/UE to << and >>.
+
+       • pandoc transforms
+
+            See the `Python home page <https://www.python.org>`_ for info.
+
+         to
+
+            see See the Python home page (https://www.python.org) for info.
+
+TTEESSTT FFOORR RREEFFEERREENNCCEESS IINN MMAANN PPAAGGEESS
+       embedded in a paragraph
+
+       • at line start
+
+       • in line
+
+       • at eol
+
+       at start of paragraph
+
+       • followed by text
+
+       • at eol
+
+       at end of paragraph
+
+TTEESSTTSS
+       See
+       <https://docutils.sourceforge.io/docs/user/rst/quickref.html#explicit-markup>
+
+       for more
+
+       See the Python home page <https://www.python.org>
+        for info.
+
+       External hyperlinks, like Python <https://www.python.org> .
+
+       Want to learn about my favorite programming language
+       <https://www.python.org> ?
+
+       Clicking on this internal hyperlink will take us to the <target>
+
+       below.
+
+       The hyperlink target above points to this paragraph.
+
+       • bullet list
+
+       • second item, with hyperlink target.
+
+       See the Python <https://www.python.org>
+        home page for info.
+
+
+       Write to me <mailto:[email protected]>
+        with your questions.
+
+       The one-liner <https://docutils.sourceforge.io/rst.html>
+        and starts-on-this-line <https://docutils.sourceforge.net/rst.html>
+        or entirely-below <https://docutils.sourceforge.net/rst.html>
+        point to <https://docutils.sourceforge.io/rst.html>
+        and in man are ... ?
+
+       Escaped whitespace is preserved as intentional spaces, e.g.:
+
+       some reference <../local>
+        to a local path.
+
+       Anonymous hyperlink references are specified with two underscores
+       instead of one:
+
+       See the web site of my favorite programming language
+       <https://www.python.org> .
+
+       Anonymous targets begin with ".. __:"; no reference name is required or
+       allowed:
+
+                                                             REFERENCE TESTS()

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



_______________________________________________
Docutils-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-checkins