| … | |
… | |
| 17 | converted to html or xml for viewing with a browser. |
17 | converted to html or xml for viewing with a browser. |
| 18 | |
18 | |
| 19 | Converting ReST to html or xml requires the "docutils" python package |
19 | Converting ReST to html or xml requires the "docutils" python package |
| 20 | [#docutils]_:: |
20 | [#docutils]_:: |
| 21 | |
21 | |
| 22 | # emerge docutils |
22 | # USE=glep emerge docutils |
| 23 | |
23 | |
|
|
24 | You will also need to have the ``docutils.conf`` file and the ``tools`` |
|
|
25 | subdirectory (with ``glep.css`` and ``glep-html-template``, all found in the |
|
|
26 | same place as this README.txt file) in the directory where you intend to |
|
|
27 | process GLEPs. |
|
|
28 | |
| 24 | The Gentoo Linux docutils package includes the *glep.py* program |
29 | The Gentoo Linux docutils package includes the *docutils-glep.py* program |
| 25 | which transforms a GLEP in text form to the equivalent html version:: |
30 | which transforms a GLEP in text form to the equivalent html version:: |
| 26 | |
31 | |
| 27 | # docutils-glep.py glep-0001.txt glep-0001.html |
32 | # docutils-glep.py glep-0001.txt glep-0001.html |
| 28 | |
33 | |
| 29 | (Incidentally, *glep.py* contains special code to verify that |
34 | (Incidentally, *docutils-glep.py* contains special code to verify that |
| 30 | the GLEP header is reasonable. This README lacks that header, |
35 | the GLEP header is reasonable. This README lacks that header, |
| 31 | so to convert this file to html using docutils you need to |
36 | so to convert this file to html using docutils you need to |
| 32 | use the more generic transformation program:: |
37 | use the more generic transformation program:: |
| 33 | |
38 | |
| 34 | # docutils-html.py --stylesheet-path=tools/glep.css README.txt README.html |
39 | # docutils-html.py --stylesheet-path=tools/glep.css README.txt README.html |