Author: milde Date: 2009-10-15 14:31:36 +0200 (Thu, 15 Oct 2009) New Revision: 6179 Added: trunk/sandbox/latex-variants/tests/citation-tests.txt trunk/sandbox/latex-variants/tests/figure-reference.txt trunk/sandbox/latex-variants/tests/mikro-mu.txt trunk/sandbox/latex-variants/tests/pro-and-con-lists.txt trunk/sandbox/latex-variants/tests/strong-emphasis.txt Removed: trunk/sandbox/latex-variants/data/ trunk/sandbox/latex-variants/tests/input/ Modified: trunk/sandbox/latex-variants/README.txt trunk/sandbox/latex-variants/tests/README.txt Log: Clean up my sandbox Modified: trunk/sandbox/latex-variants/README.txt =================================================================== --- trunk/sandbox/latex-variants/README.txt 2009-10-13 15:45:55 UTC (rev 6178) +++ trunk/sandbox/latex-variants/README.txt 2009-10-15 12:31:36 UTC (rev 6179) @@ -16,6 +16,45 @@ ``latex2e`` writer extensions ***************************** +.. Steps for uploading Changes: + + * pepare patch to ../../docutils/docutils/writers/latex2e/__init__.py + + * (add and) run functional and unit- tests:: + + ../../docutils/test/test_functional.py + ../../docutils/test/test_writers/test_latex2e.py + + or all at once:: + + cd ../../docutils/test/ + ./alltests.py + + + if output changed: test-compile and approve new output in + ../../docutils/test/functional/output/ + + More (informal) tests are in:: + + ../../docutils/test/functional/input/data/latex.txt + ../grubert/test + ~/Texte/Test/Docutils + + * Documentation + + * remove from TODO list in ../../docutils/docs/dev/todo.txt + or the BUGS in ../../docutils/BUGS.txt + + * describe new end-user features in ../../docutils/docs/user/latex.txt + * describe new settings in ../../docutils/docs/user/config.txt + + * add backwards-incompatible changes to ../../docutils/RELEASE-NOTES.txt + * add summary of changes to ../../docutils/HISTORY.txt + * describe change in ../../docutils/docs/user/docutils-05-compat.sty.txt + (convert to style sheet and test with + ../../docutils/docutils/writers/latex2e/05-compatibility-test.txt + + * Commit and announce. + Questionnaire ============= @@ -258,35 +297,7 @@ Also see the `Docutils Release Notes`_, the `Docutils History`_. -.. Steps for uploading Changes: - * provide patch to latex2e/__init__.py - * get approvement from the latex writer maintainer (Engelbert Gruber) - - * (add and) run functional and unit- tests:: - - ../../docutils/test/test_functional.py - ../../docutils/test/test_writers/test_latex2e.py - - or all at once:: - - cd ../../docutils/test/ - ./alltests.py - - + if output changed: test-compile and approve new output in - ../../docutils/test/functional/output/ - - * Documentation - - * remove from TODO list in ../../docutils/docs/dev/todo.txt - - * describe new end-user features in ../../docutils/docs/user/latex.txt - - * add backwards-incompatible changes to ../../docutils/RELEASE-NOTES.txt - * add summary of changes to ../../docutils/HISTORY.txt - * describe change in ../../docutils/docs/user/docutils-05-compat.sty.txt - - Alternative latex writers ************************* Modified: trunk/sandbox/latex-variants/tests/README.txt =================================================================== --- trunk/sandbox/latex-variants/tests/README.txt 2009-10-13 15:45:55 UTC (rev 6178) +++ trunk/sandbox/latex-variants/tests/README.txt 2009-10-15 12:31:36 UTC (rev 6179) @@ -3,13 +3,14 @@ Informal tests ================ -The `<input>`_ directory contains test documents highlighting +This directory contains test documents highlighting problems with the LaTeX export and for testing alternatives. + Unit test scripts ================= -The test scripts are developed with (and for) the nose_ test framework but +Unit test scripts are developed with (and for) the nose_ test framework but should run with `py.test`_ as well. Copied: trunk/sandbox/latex-variants/tests/citation-tests.txt (from rev 6177, trunk/sandbox/latex-variants/tests/input/citation-tests.txt) Copied: trunk/sandbox/latex-variants/tests/figure-reference.txt (from rev 6177, trunk/sandbox/latex-variants/tests/input/figure-reference.txt) Copied: trunk/sandbox/latex-variants/tests/mikro-mu.txt (from rev 6177, trunk/sandbox/latex-variants/tests/input/mikro-mu.txt) =================================================================== --- trunk/sandbox/latex-variants/tests/input/mikro-mu.txt 2009-10-12 07:38:51 UTC (rev 6177) +++ trunk/sandbox/latex-variants/tests/mikro-mu.txt 2009-10-15 12:31:36 UTC (rev 6179) @@ -0,0 +1,15 @@ + +With LaTeX -> PDF, the:: + + character 'µ' (181, 0xB5) 00B5 MICRO SIGN, + +used for the SI-Prefix Mikro (= 10e-6) vanishes or is written in +kursive: + +A layer of 2 µm is just 2/1000000 m thick. + +Workaround: + use utf8x encoding (ucs package) (this inserts an *italic* mu while the + micro sign must be upright) +TODO: + replacements using textcomp (see writers/latex2e/__init__.py) Copied: trunk/sandbox/latex-variants/tests/pro-and-con-lists.txt (from rev 6177, trunk/sandbox/latex-variants/tests/input/pro-and-con-lists.txt) =================================================================== --- trunk/sandbox/latex-variants/tests/input/pro-and-con-lists.txt 2009-10-12 07:38:51 UTC (rev 6177) +++ trunk/sandbox/latex-variants/tests/pro-and-con-lists.txt 2009-10-15 12:31:36 UTC (rev 6179) @@ -0,0 +1,49 @@ +Listing pros and cons +********************* + +What is the most elegant way to compile a list of (dis-) advantages with +rst? + +itemize: + + concise + + clear source + + - shows only dots in output + +classy itemize: + .. class:: advantages + + + clear source + + output can by styled with css + + .. class: disadvantages + + - no longer concise + - does not (currently) work with LaTeX export + + +option list: + +1 concise + +1 clear source + -2 does not work reliably (needs number) + -1 less straightforward + -2 "abusing" special list type + +line block: + | + works reliably, correct output + | - list items not aligned (+ wider than -) + | - rating "hidden" in source + | - no semantic markup (generic block for special list type) + +line block with U+2212 "minus sign": + | + works reliably, correct output + | + list items aligned + | − rating "hidden" in source + | − minus sign not easily input with most text editors + | − minus sign not distinguishable from '-' (HYPHEN-MINUS) in fixed + with fonts + +field list: + :+: aligned markers and items + :-: "ugly" source + :-: colon in output Copied: trunk/sandbox/latex-variants/tests/strong-emphasis.txt (from rev 6177, trunk/sandbox/latex-variants/tests/input/strong-emphasis.txt) |