diff options
author | Karl Berry <karl@freefriends.org> | 2011-08-26 22:17:31 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-08-26 22:17:31 +0000 |
commit | 80219992c1ed63efeca5390194411fcdcedb17bb (patch) | |
tree | 71fa8ca43e70073fc77a5ff97454bf43549dee9a /Master/texmf-dist/doc/latex/nicetext/README | |
parent | 87f1685a45c8f23851013817d1ead13ff8c20677 (diff) |
nicetex 0.43 (24aug11)
git-svn-id: svn://tug.org/texlive/trunk@23703 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/nicetext/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/nicetext/README | 136 |
1 files changed, 74 insertions, 62 deletions
diff --git a/Master/texmf-dist/doc/latex/nicetext/README b/Master/texmf-dist/doc/latex/nicetext/README index 5ce1fb0b0c4..9666441116a 100644 --- a/Master/texmf-dist/doc/latex/nicetext/README +++ b/Master/texmf-dist/doc/latex/nicetext/README @@ -1,29 +1,29 @@ The NICETEXT bundle - (c) 2009-2011 Uwe Lueck http://contact-ednotes.sty.de.vu + (c) 2009-2011 Uwe Lueck http://contact-ednotes.sty.de.vu == General Idea == The NICETEXT bundle supports "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). +characters than are printed, though you get LaTeX quality. We +try to do away with backslashes, technical terms, and curly +braces (clumsy to type ... - "syntactic sugar"). -Main focus is easy documentation of LaTeX packages. Preprocessing -by Perl or so is replaced by TeX macros (reviving/generalizing the -'docstrip' idea), including expandable, safe, correct string -substitution and typographical enhancements of plain text for -LaTeX input. +Main focus is easy documentation of LaTeX packages. +Preprocessing by Perl or so is replaced by TeX macros +(reviving/generalizing the `docstrip' idea), including +expandable, safe, correct string substitution and typographical +enhancements of plain text for LaTeX input. == 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, +`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>} @@ -31,85 +31,82 @@ you just type \foo[<opt-arg>]{<mand-arg>} !-) -'fifinddo.sty' provides basic setup for text filtering, especially -string substitution. 'makedoc.sty' extends it to provide a simple -script language for transforming plain text package files into LaTeX -input files [manual!?]. One LaTeX run can perform preprocessing and -typesetting. +`fifinddo.sty' provides basic setup for text filtering, +especially string substitution. `makedoc.sty' extends it to +provide a simple script language for transforming plain text +package files into LaTeX input files [manual!?]. One LaTeX run +can perform preprocessing and typesetting. == Comparisons == -One source of inspiration is the markup syntax of editing Wikipedia -pages. 'wiki.sty' of the bundle offers something similar as a LaTeX -front-end for italics, boldface, sectioning, and certain list-like -environments. This is also similar to 'easylatex', +One source of inspiration is the markup syntax of editing +Wikipedia pages. `wiki.sty' of the bundle offers something +similar as a LaTeX front-end 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. NICETEXT, by contrast, consists -just of LaTeX packages, working on any TeX installation [!? note -restrictions in 'fifinddo.pdf']. Cf. also preprocessor packages -'txt2tex' and 'txt2latex'. +which is more powerful and uses Perl. NICETEXT, by contrast, +consists just of LaTeX packages, working on any TeX +installation [!? note restrictions in `fifinddo.pdf']. +Cf. also preprocessor packages `txt2tex' and `txt2latex'. -Regarding "self-documentation," there is a difference to current -`\DocInput', similar ideas are in 'gmdoc' and 'lineno.sty', -see 'niceverb.pdf' and 'makedoc.pdf'. Standard 'doc.sty' and -'contrib' extensions of it are rather avoided. +Regarding "self-documentation," there is a difference to +current `\DocInput', similar ideas are in `gmdoc' and +`lineno.sty', see `niceverb.pdf' and `makedoc.pdf'. Standard +`doc.sty' and `contrib' extensions of it are rather avoided. There are several *LaTeX macro* packages for processing text or databases or for editing TeX's input stream while typesetting --- see 'fifinddo.pdf'. What seems to be new here is +-- see `fifinddo.pdf'. What seems to be new here is *expandable string substitution* and safe, correct detection of -substrings -- discussed in 'fifinddo.pdf'. +substrings -- discussed in `fifinddo.pdf'. == Documentation == -'fifinddo.pdf' describes 'fifinddo.sty', typeset from 'fifinddo.tex'. -'makedoc.pdf' describes 'makedoc.sty', typeset from 'makedoc.tex'. -'mdoccheat.pdf' is a list of script commands, typeset from 'mdocchea.tex'. -'niceverb.pdf' describes 'niceverb.sty', typeset from 'niceverb.tex'. -Typesetting them anew (for customizing printout) requires -'makedoc.cfg', 'mdoccorr.cfg', and the *.sty files. +`fifinddo.pdf' describes `fifinddo.sty', typeset from +`fifinddo.tex'. `makedoc.pdf' describes `makedoc.sty', typeset +from `makedoc.tex'. `mdoccheat.pdf' is a list of script +commands, typeset from `mdocchea.tex'. `niceverb.pdf' describes +`niceverb.sty', typeset from `niceverb.tex'. Typesetting them +anew (for customizing printout) requires `makedoc.cfg', +`mdoccorr.cfg', and the *.sty files. -'wikicheat.pdf' is a one-page manual of 'wiki.sty'. The file -'wiki.sty' contains additional documentation as plain text. +`wikicheat.pdf' is a one-page manual of `wiki.sty'. The file +`wiki.sty' contains additional documentation as plain text. Note that certain features must be activated by commands in the document environment. == Templates/Dialogue == -txt to TeX functionality through \MakeDocCorrectHook can be tried -and applied with templates `fdtxttex.tpl' and `makedoc.tpl' and in -a dialogue started by running `fdtxttex.tex'. +txt to TeX functionality through \MakeDocCorrectHook can be +tried and applied with templates `fdtxttex.tpl' and +`makedoc.tpl' and in a dialogue started by running +`fdtxttex.tex'. Running `copyfile.tex', you get a dialogue +for "compressing" blank lines or text encoding conversion. `substr.tex' should typeset the version of Harald Harders' `substr.sty' next at your TeX installation. `arseneau.tex' -should typeset documentation of a few packages by Donald Arseneau. -My results are `substr.pdf' and `arseneau.pdf'. - - - == Required == - -`makedoc.sty' requires the `moreverb' package from - - CTAN:/macros/latex/contrib/moreverb +should typeset documentation of a few packages by Donald +Arseneau. MY results are `substr.pdf' and `arseneau.pdf'. == License == -Copying, distributing, modifying, using the files of the `nicetext' -bundle are allowed under the terms of the LaTeX Project Public -License, either version 1.3a or any later version, the latest version -is at +Copying, distributing, modifying, using the files of the +`nicetext' bundle are allowed under the terms of the +LaTeX Project Public License, either version 1.3a or any later +version, the latest version is at http://www.latex-project.org/lppl.txt -There is NO WARRANTY, and you must CARE indeed with `fifinddo' and -`makedoc', they will OVERWRITE existing files without warning because -their main purpose is updating. +There is NO WARRANTY, and you must CARE indeed with `fifinddo' +and `makedoc', they will OVERWRITE existing files without +warning (because their main purpose is updating). The bundle is AUTHOR-MAINTAINED in the sense of the LPPL. @@ -117,9 +114,24 @@ Copyright (C) 2009-2011 Uwe Lueck, http://www.contact-ednotes.sty.de.vu -Please report bugs, problems, and suggestions via the previous web -form. +Please report bugs, problems, and suggestions via the previous +web form. + + + == Installing/Required == + +`makedoc.sty' requires the `moreverb' package from + + CTAN:/macros/latex/contrib/moreverb + +You find the latest public version of the NICETEXT bundle at + + http://mirror.ctan.org/macros/latex/contrib/nicetext/ + +A TDS version `nictext.tds.zip' is available at + + http://mirror.ctan.org/install/macros/latex/contrib/ ________________________________ - [This file 2011/01/26 Uwe Lueck] + [This file 2011/08/23 Uwe Lueck] |