Re: [Docutils-users] broken rst cheatsheet?

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

On 2013-02-18, David Goodger wrote:
> Regardless of the bug in LaTeX formatting, the cheatsheet
> (http://docutils.sourceforge.net/docs/user/rst/cheatsheet.txt) is
> really meant to be used in text (.txt) form. When it is processed,
> much of the useful information disappears. It's meant as a reminder of
> reST syntax.

> So I recommend referring to the .txt original, rather than processing
> it to .html or .pdf.

Maybe we can extempt the cheatsheet from the files translated by the
html-builder then?

Currently, we have in docutils/docutils.conf:

# Prevent tools/buildhtml.py from processing certain text files.
[buildhtml application]
ignore: GPL2.txt
prune: .svn:.hg:docs/.svn:docutils:test:tools:licenses:build:dist


An alternative woudld be a wrapper file that includes the parts of
cheatsheet.txt both, literal and "normal" to offer a syntax vs. result HTML
page.

Günter