From d10c0eee416fa9ba73ecde863b4945a28a01f140 Mon Sep 17 00:00:00 2001 From: Philipp Gesang Date: Wed, 27 Mar 2013 20:19:56 +0100 Subject: update readme --- README.rst | 96 +++++++++++++++++------------ mod/doc/context/third/rst/documentation.rst | 8 +-- 2 files changed, 59 insertions(+), 45 deletions(-) diff --git a/README.rst b/README.rst index 8c0e6fd..571b8ae 100644 --- a/README.rst +++ b/README.rst @@ -1,20 +1,32 @@ -============== -General Advice -============== +======================================================================= + General Advice +======================================================================= Read the section *Features Not Implemented* in the manual first. -*Note*: if you happen to read this on BitBucket_, the error messages some lines -below just mean that *their* implementation doesn’t understand |TeX| directives. -Don’t worry, |rstcontext| does. - -============ -Installation -============ - -In order to install |rstcontext|, copy everything under the ``mod/`` -subdirectory into your local |CONTEXT| tree and update the filename database, -i.e.: :: +*Note*: if you happen to read this on BitBucket_, the error messages +some lines below just mean that *their* implementation doesn’t +understand |TeX| directives. Don’t worry, |rstcontext| does. + +======================================================================= + Installation +======================================================================= +With ConTeXt Standalone +*********************** +An up to date version of the module is installed along with the ConTeXt +distribution (*Standalone*, formerly known as *The Minimals*). +The module should be working out of the box if you installed from the +official source_ and provided the parameter ``--modules=all``. + +.. _source: http://wiki.contextgarden.net/ConTeXt_Standalone#Installing_third_party_modules + +Manually +******** +Firstly, get the module source from BitBucket_ (see the *downloads* +section). +In order to install |rstcontext|, copy everything in the ``mod/`` +subdirectory into your local |CONTEXT| tree and update the filename +database, i.e. :: cp -r mod/* ~/context/tex/texmf-local/ context --generate @@ -22,48 +34,50 @@ i.e.: :: if the |CONTEXT| minimal distribution happens to be installed at ``~/context/``. -===== -Usage -===== +======================================================================= + Usage +======================================================================= -As rstConTeXt was developed on *texlua*, you may expect it to run best with this -interpreter. For now the script accepts two command line arguments: the input -file and the output file. The following will demonstrate the main usage in a -separate directory: :: +As rstConTeXt was developed on *texlua*, you may expect it to run best +with this interpreter. For now the script accepts two command line +arguments: the input file and the output file. The following will +demonstrate the main usage in a separate directory: :: mkdir tmp; cd tmp mtxrun --script rst --if=../mod/doc/context/third/rst/documentation.rst --of=doc.tex context ../mod/doc/context/third/rst/manual.tex -This should have gotten you the manual converted to a file ``doc.tex`` which was -subsequently run through |CONTEXT| to generate the final ``manual.pdf``. You -will find extended instructions on how to build the manual with some cosmetic -improvements in the section *Usage* of the manual itself. +This should have gotten you the manual converted to a file ``doc.tex`` +which was subsequently run through |CONTEXT| to generate the final +``manual.pdf``. You will find extended instructions on how to build the +manual with some cosmetic improvements in the section *Usage* of the +manual itself. -There is also a small module ``t-rst.mkiv`` which permits direct typesetting of -reST markup with |CONTEXT| MkIV. For usage examples see the files -``hybridtest.tex`` and ``moduletest.tex`` in the ``doc`` subdirectory. +There is also a small module ``t-rst.mkiv`` which permits direct +typesetting of reST markup with |CONTEXT| MkIV. For usage examples see +the files ``hybridtest.tex`` and ``moduletest.tex`` in the ``doc`` +subdirectory. -======= -License -======= +======================================================================= + License +======================================================================= -|rstcontext| is free software and may be redistributed under the terms of the -2-clause BSD license. You should have recieved a copy of this license in a file -named “COPYING” in the source tree. If there is no such file then please contact -the maintainer_ (Contact_). +|rstcontext| is free software and may be redistributed under the terms +of the 2-clause BSD license. You should have recieved a copy of this +license in a file named “COPYING” in the source tree. If there is no +such file then please contact the maintainer_ (Contact_). -======= -Contact -======= +======================================================================= + Contact +======================================================================= -|rstcontext| was written by Philipp Gesang, ``phg42.2a`` at ``gmail`` dot -``com`` (find me on BitBucket_). +|rstcontext| was written by Philipp Gesang, ``phg42.2a`` at ``gmail`` +dot ``com``. .. |rstcontext| ctx:: {{\em rst}\kern.5pt\CONTEXT} .. |TeX| ctx:: {\TEX} .. |CONTEXT| ctx:: {\CONTEXT} .. _Contact: phg42.2a@gmail.com -.. _BitBucket: http://bitbucket.org/phg +.. _BitBucket: http://bitbucket.org/phg/context-rst .. _maintainer: Contact_ diff --git a/mod/doc/context/third/rst/documentation.rst b/mod/doc/context/third/rst/documentation.rst index 83bf609..621528d 100644 --- a/mod/doc/context/third/rst/documentation.rst +++ b/mod/doc/context/third/rst/documentation.rst @@ -422,7 +422,7 @@ directive, namely containers_. Due to their being defined explicitly in terms of HTML, *containers* lack a corresponding construct in |CONTEXT| (or |TEX| for that matter). -Some parts of |CONTEXT| (e. g. ``\framed``) come quite close with +Some parts of |CONTEXT| (e. g. ``\\framed``) come quite close with respect to functionality as well as generality. However, none of the candidates alone covers the entire spectrum of functionality that containers_ are supposed to. @@ -435,7 +435,7 @@ Anonymous containers are interpreted as a |TEX| group. Any text block inside the element is treated as ordinary paragraph. In below example the content will be handled as if between -``\startxyzzy`` and ``\stopxyzzy``, where it is up to the user to +``\\startxyzzy`` and ``\\stopxyzzy``, where it is up to the user to define the *xyzzy* environment:: This is a paragraph. @@ -456,8 +456,8 @@ The middle part translates to |CONTEXT| as follows:: foo {\sc bar} baz \stop -Note that the ``\start[foo]``/``\stop``-environment is equivalent -to ``\startfoo``/``\stopfoo``, except that the environment +Note that the ``\\start[foo]``/``\\stop``-environment is equivalent +to ``\\startfoo``/``\\stopfoo``, except that the environment doesn’t actually need to be defined. .. caution:: -- cgit v1.2.3