summaryrefslogtreecommitdiff
path: root/mod/doc/context/third/rst/hybridtest.tex
blob: bd509c04aaa2062aac412747d571be178c169e0d (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
\usemodule[rst][test=yes]
\setuphead[chapter][page=no,style=bold]

\def\RSTCTX{{\em rst}\kern.5pt\CONTEXT}
\def\reST{{\rm re}{\ss Structured}{\rm Text}}

\starttext

\chapter{\RSTCTX\ Hybrid Documents}

This example demonstrates the macro \type{\RST} which can be used
to process \reST\ markup directly in a normal \CONTEXT\ document.

\RST{
-------------
This Chapter,
-------------

… for instance, was given entirely in *reST* markup. Naturally,
there are some :bold:`drawbacks` to expect when mixing markups:
directives and hyperlink targets that have already been specified
somewhere above the current section will *stay* accessible in
later passages until you redefine them. Also, certain letters
need to be thoroughly escaped in order for them to make it
through to the *reST*-parser, e.g. *\\\{* (<left brace>), and
you’ll have to be inventive to make a backslash
(*\\letterbackslash*) pass through the parser.

}

\startRST

-------------
Alternatively
-------------
you may always use the matching environment ``\\[start|stop]RST``
if you prefer.

\stopRST


\stoptext