summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/nicetext/README
blob: 171fd1d339f76392fda1873e3e1e8fdde96191aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
                     The NICETEXT bundle

     (c) 2009 Uwe Lueck http://contact-ednotes.sty.de.vu

                     == General Idea ==

The NICETEXT bundle offers ``minimal'' markup syntax for rather 
simple kinds of text. The code you type should show little more 
characters than are printed, though you get LaTeX quality. We try 
to do away with backslashes, technical terms, and curly braces 
(which also are so clumsy to type on PC keyboards). 

                       == Packages ==

'wiki.sty' addresses general kinds of texts. 'niceverb.sty' is 
made for documenting LaTeX packages. 'niceverb.sty' especially 
offers [almost-]WYSIWIG for meta-variables (macro arguments) and 
for referring to commands (and their syntax) in footnotes, 
section titles etc. E.g., to get the syntax description

                 \foo[<opt-arg>]{<mand-arg>}
you just type 
                 \foo[<opt-arg>]{<mand-arg>}
!-)

                      == Comparison ==

One source of inspiration is the markup syntax that is used in 
editing Wikipedia pages. The package 'wiki.sty' of the bundle 
offers a very similar syntax as a LaTeX front-end. It suffices for 
italics, boldface, sectioning, and certain list-like environments. 
This is also similar to 'easylatex', 

               http.//www.ctan.org/pkg/easylatex

which is more powerful and uses Perl. 'wiki.sty', by contrast, is 
just a LaTeX package, working on any TeX installation. 

                     == Documentation ==

'wikicheat.pdf' is a one-page manual of 'wiki.sty'. The file 
'wiki.sty' contains additional documentation as ASCII text. 
'niceverb.pdf' describes 'niceverb.sty'. Note that certain
features must be activated by commands in the document environment.

                    == What is missing ==

1. 'niceverb' should extend 'wiki', yet their font switchings are 
incompatible at present. 2. 'niceverb' should typeset the ASCII 
documentation of 'wiki.sty' ... This upload is for reference and 
for proving that I am not just dreaming. I think repairing needs 
only few hours, yet I must do something different right now. See 
more on what's missing in 'niceverb.pdf'.

3. I have a package 'nicedots' for controlling horizontal spacing 
with ellipses which may go here. 

               ________________________________
               [This file 2009/02/23 Uwe Lueck]