summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-margintexts.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-margintexts.tex')
-rw-r--r--Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-margintexts.tex100
1 files changed, 100 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-margintexts.tex b/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-margintexts.tex
new file mode 100644
index 00000000000..54ed6db6a7b
--- /dev/null
+++ b/Master/texmf-dist/doc/context/sources/general/manuals/start/en/ma-cb-en-margintexts.tex
@@ -0,0 +1,100 @@
+\startcomponent ma-cb-en-margintexts
+
+\enablemode[**en-us]
+
+\project ma-cb
+
+\startchapter[title=Margin texts]
+
+\index{margin text}
+
+\Command{\tex{margintext}}
+\Command{\tex{inmargin}}
+\Command{\tex{inleft}}
+\Command{\tex{inright}}
+\Command{\tex{margintitle}}
+
+It is very easy to put text in the margin. You just use \type{\inmargin}.
+
+\shortsetup{inmargin}
+
+You may remember one of the earlier examples:
+
+\startbuffer[marginpicture]
+\inmargin
+ {\externalfigure
+ [ma-cb-23]
+ [width=.6\marginwidth]}
+\stopbuffer
+
+\typebuffer[marginpicture]
+
+This would result in a figure in the \pagereference [marginpicture]
+margin. You can imagine that it looks quite nice in some
+documents. But be careful. The margin is rather small so the figure could become
+very marginal.
+
+A few other examples are shown in the text below.\getbuffer
+[marginpicture]
+
+\startbuffer
+The Ridderstraat (Street of knights) \inmargin{Street of\\Knights}
+is an obvious name. In the 14th and 15th centuries, nobility and
+prominent citizens lived in this street. Some of their big houses
+were later turned into poorhouses \inright{poorhouse}and old
+peoples homes.
+
+Up until \inleft[low]{\tfc 1940}1940 there was a synagog in the
+Ridderstraat. Some 40 Jews gathered there to celebrate their
+sabbath. During the war all Jews were deported to Westerbork and
+then to the extermination camps in Germany and Poland. None of
+the Jewish families returned. The synagog was knocked down in
+1958.
+\stopbuffer
+
+\typebuffer
+
+The commands \type{\inmargin}, \type{\inleft} and \type{\inright} all have the
+same function. In a two sided document \type{\inmargin} puts the margin text in
+the correct margin. The \type{\\} is used for line breaking. The example above
+would look like this:
+
+\getbuffer
+
+You can set up the margin text with:
+
+\shortsetup{setupinmargin}
+
+Other commands that you can use for forcing text into the margin
+are listed in \in{table}[tab:margincommands].
+
+\placetable
+ [here]
+ [tab:margincommands]
+ {Overview of margin commands.}
+ {\starttable[|l|l|]
+ \HL
+ \NC \bf Command \NC \bf Meaning \NC\SR
+ \HL
+ \NC \type{\ininner} \NC text in inner margin \NC\FR
+ \NC \type{\inouter} \NC text in outer margin \NC\MR
+ \NC \type{\inright} \NC text in right margin \NC\MR
+ \NC \type{\inleft} \NC text in left margin \NC\MR
+ \NC \type{\inmargin} \NC text in the margin \NC\MR
+ \NC \type{\inothermargin} \NC text in other margin \NC\MR
+ \NC \type{\margintext} \NC text in the margin \NC\LR
+ \HL
+ \stoptable}
+
+If you want to place more extensive text blocks in the margin there is the
+command:
+
+\shortsetup{marginblock}
+
+and the accompanying command:
+
+\shortsetup{setupmarginblocks}
+
+\stopchapter
+
+\stopcomponent