/[gentoo]/xml/htdocs/proj/en/glep/README.txt
Gentoo

Diff of /xml/htdocs/proj/en/glep/README.txt

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.2 Revision 1.7
16quite readable in source form, yet it can be readily 16quite readable in source form, yet it can be readily
17converted to html or xml for viewing with a browser. 17converted to html or xml for viewing with a browser.
18 18
19Converting ReST to html or xml requires the "docutils" python package 19Converting 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
24The Gentoo Linux docutils package includes the *glep.py* program 24The Gentoo Linux docutils package includes the *glep.py* program
25which transforms a GLEP in text form to the equivalent html version:: 25which transforms a GLEP in text form to the equivalent html version::
26 26
27 # glep.py glep-0001.txt glep-0001.html 27 # docutils-glep.py glep-0001.txt glep-0001.html
28
29The above usage embeds the CSS stylesheet in the html file. For pages
30on glep.gentoo.org, it is better to use a link instead::
31
32 # docutils-glep.py --link-stylesheet --stylesheet-path=tools/glep.css \
33 > glep-0001.txt glep-0001.html
28 34
29(Incidentally, *glep.py* contains special code to verify that 35(Incidentally, *glep.py* contains special code to verify that
30the GLEP header is reasonable. This README lacks that header, 36the GLEP header is reasonable. This README lacks that header,
31so to convert this file to html using docutils you need to 37so to convert this file to html using docutils you need to
32use the more generic transformation program:: 38use the more generic transformation program::
33 39
34 # html.py --stylesheet-path=tools/glep.css README.txt README.html 40 # rst2html.py --stylesheet-path=tools/glep.css README.txt README.html
35 41
36to convert README.txt to README.html.) 42to convert README.txt to README.html.)
37 43
38Files 44Files
39===== 45=====
40 46
41======================== ====================================== 47======================== ======================================
42File Purpose 48File Purpose
43======================== ====================================== 49======================== ======================================
44README.txt This file (duh!) 50README.txt This file (duh!)
45docutils.conf Configuration file for GLEP conversion 51docutils.conf Configuration file for GLEP conversion
46 from txt to html 52 from txt to html
47glep-xxxx.txt GLEPs in text (ReST) form 53glep-xxxx.txt GLEPs in text (ReST) form
48tools/glep.css GLEP html stylesheet 54tools/glep.css GLEP html stylesheet
49tools/glep-html-template GLEP boilerplate template 55tools/glep-html-template GLEP boilerplate template
50======================== ====================================== 56======================== ======================================
51 57
52 58
53References 59References
54========== 60==========
55 61

Legend:
Removed from v.1.2  
changed lines
  Added in v.1.7

  ViewVC Help
Powered by ViewVC 1.1.20