diff options
Diffstat (limited to 'Master/texmf-dist/doc/luatex/optex/optex-userdoc.tex')
-rw-r--r-- | Master/texmf-dist/doc/luatex/optex/optex-userdoc.tex | 45 |
1 files changed, 27 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/luatex/optex/optex-userdoc.tex b/Master/texmf-dist/doc/luatex/optex/optex-userdoc.tex index 8f2fe4d3d3e..899b1d55aae 100644 --- a/Master/texmf-dist/doc/luatex/optex/optex-userdoc.tex +++ b/Master/texmf-dist/doc/luatex/optex/optex-userdoc.tex @@ -650,7 +650,7 @@ The \^`\url` macro prints its parameter in \~`\tt` font and creates a potential breakpoints in it (after slash or dot, for example). If the \^`\hyperlinks` declaration is used then the parameter of \^`\url` is treated as an external URL link. An example: `\url{http://www.olsak.net}` creates \url{http://www.olsak.net}. -The characters \code{\%}, `\`, `#`, `{` and `}` have to be protected by +The characters \code{\%}, `\`, `#`, `{`, and `}` have to be protected by backslash in the \^`\url` argument, the other special characters `~`, `^`, `&` can be written as single character\fnote {More exactly, there are the same rules as for `\code` command, see @@ -663,6 +663,8 @@ If the linked text have to be different than the URL, you can use `\ulink[http://petr.olsak.net/optex]{\OpTeX/ page}` outputs to the text \ulink[http://petr.olsak.net/optex]{\OpTeX/ page}. +The characters \code{\%}, `\`, `#`, `{`, and `}` must by escaped in +the <url> parameter. The PDF format provides {\em outlines} which are notes placed in the special frame of the PDF viewer. These notes can be managed as a structured and hyperlinked @@ -683,6 +685,11 @@ the main level~0. These entries can be placed before the table of contents (crea by \^`\outlines`) or after it. Their hyperlink destination is in the place where the \^`\insertoutline` macro is used. +The command \^`\thisoutline{<text>}` uses <text> in the outline instead of default +title text for the first following `\chap`, `\sec`, or `\secc`. +Special case: \^`\thisoutline{\relax}` doesn't create any outline for the following +`\chap`, `\sec`, or `\secc`. + \secc Lists %%%%%%%%%% @@ -768,9 +775,9 @@ These letters can be combined by the `|` character (vertical line). Example July & yacht & k\$ 170 \crl} \endtt % -generates the following result: +generates the result: -\medskip +\vskip-\medskipamount \noindent\hfil\table{||lc|r||}{ \crl Month & commodity & price \crli \tskip2pt January & notebook & \$ 700 \cr @@ -902,29 +909,28 @@ You can use this for creating tables like in the following example: & Exclusive & \mspan3[c|]{} &\mspan3[c|] X \crl \vspan2{II} & Informal & \mspan3[c|] X &\mspan3[c|] X \crlp{2-8} & Formal & \mspan6[c|] X \crl - \vspan2{III} & Informal & \vspan2 O & X & X &\mspan2[c|] X & \vspan2 O \crlp{2,4-7} + \vspan2{III} & Informal & \vspan2{O} & X & X &\mspan2[c|] X & \vspan2{O} \crlp{2,4-7} & Formal & &\mspan4[c|] X & \crl }}\pdfrestore} \hangindent=-7.5cm \hangafter=0 -The <number> parameter of \^`\vspan` must be one-digit number. -If you want to set more digits then use braces. -You can use non-integer values too if you feel that the -result is better, for example \^`\vspan{2.1}{text}`. +You can use \^`\vspan` with non-integer parameter too if you feel that the +result looks better, for example \^`\vspan2.1{text}`. \hangindent=-7.5cm \hangafter=0 The rule width of tables and implicit width of all `\vrule`s and `\hrule`s can be set by the command \^`\rulewidth=<dimen>`. The default value given by \TeX/ is 0.4\,pt. +\hangindent=-7.5cm \hangafter=-2 The `c`, `l`, `r` and `p` are default \"declaration letters" but you can define more such letters by `\def\_tabdeclare<letter>{<left>##<right>}`. More about it is in technical documentation in section~\ref[table.impl]. -See the definition of the \^`\tabdeclarec` macro, for example. +See the definition of the \^`\_tabdeclarec` macro, for example. The `:` columns boundary declarator is described in section~\ref[table.bound]. The tables with given width can be declared by `to<size>` or `pxto<size>`. -More about it is in section~\ref[table.w] +More about it is in section~\ref[table.w]. Many tips about tables can be seen on the site \url{http://petr.olsak.net/optex/optex-tricks.html}. @@ -935,7 +941,7 @@ The display verbatim text have to be surrounded by the \^`\begtt` and \^`\endtt` couple. The in-line verbatim have to be tagged (before and after) by a character which is declared by -\^`\activettchar``<char>`. For example \code{\\activettchar`} +\^`\verbchar``<char>`. For example \code{\\verbchar`} declares the character \code{`} for in-line verbatim markup. And you can use \code{`\\relax`} for @@ -974,7 +980,7 @@ the parameter of \^`\everytt` is read. So you don't have to worry about active categories in this parameter. There is an alternative to \^`\everytt` named \^`\everyintt` which is used for -in-line verbatim surrounded by an \^`\activettchar` or processed by the \~`\code` +in-line verbatim surrounded by an \^`\verbchar` or processed by the \~`\code` command. The \^`\everytt` is applied to all \^`\begtt...`\^`\endtt` environments (if it is not @@ -997,7 +1003,7 @@ Each occurrence of ? will be changed to ! and vice versa. @ \endtt -The in-line verbatim surrounded by an `\activettchar` doesn't work in +The in-line verbatim surrounded by a \^`\verbchar` doesn't work in parameter of macros and macro definitions. (It works in titles declared by \~`\chap`, \~`\sec` etc. and in \~`\fnote`s, because these macros are specially defined in \OpTeX/). @@ -1556,10 +1562,11 @@ coordinates `<x>`, `<y>`. More exactly the left edge of its baseline is at that position. \new -The \^`\putpic` `<x> <y> <width> <height> {<image>}` puts the `<image>` of given +The \^`\putpic` `<x> <y> <width> <height> {<image-file>}` puts an image +given by `<image-file>` (including extension) of given `<width>` and `<height>` at given position (its left-bottom corner). -You can write \^`\nospec` instead `<width>` or `<height>` if this parameter is -not given. +You can write \^`\nospec` instead `<width>` or `<height>` if this parameter +is not specified. \sec Others %%%%%%%%%%% @@ -1795,7 +1802,7 @@ put it as the first command in your document: ~endblock' % end of block of text ~begtt' % start a verbatim text ~endtt' % end verbatim text -~activettchar' X % initialization character X for in-text verbatim +~verbchar' X % initialization character X for in-text verbatim ~code' % another alternative for in-text verbatim ~verbinput' % verbatim extract from the external file ~begmulti' num % start multicolumn text (num columns) @@ -1873,7 +1880,8 @@ documentation. \^`\foreach` `<list>\do <parameters>{<what>}` is exapandable loop over <list>.\nl \^`\foreachdef` `\macro <parameters>{<what>}` declares expandable `\macro` as loop over <list>.\nl \^`\fornum` `<from>..<to>\do {<what>}` is expanadable loop with numeric variable.\nl -\^`\ignoreit` `<one>`, \^`\ignoresecond` `<one><two>`, \^`\usesecond` `<one><two>` ignores parameters.\nl +\^`\incr` `<counter>` increases and \^`\decr` `<counter>` decreases `<counter>` by one globally.\nl +\^`\ignoreit` `<one>`, \^`\ignoresecond` `<one><two>` ignores given parameter.\nl `\expandafter` \^`\ignorept` `\the<dimen>` expands to decimal number <dimen> without `pt`.\nl \~`\isempty`, \~`\istoksempty`, \~`\isequal`, \~`\ismacro`, \~`\isdefined`, \~`\isinlist` \~`\isfile`, \~`\isfont` do various tests. Example: \~`\isinlist\list{<text>}\iftrue` does @@ -1899,6 +1907,7 @@ documentation. \^`\slet` `{<stringA>}{<stringB>}` behaves like `\let\<stringA>=\<stringB>`\nl \^`\sxdef` `{<string>}<parameters>{<body>}` behaves like `\xdef\<string><parameters>{<body>}`.\nl \^`\trycs`` {<string>}{<text>}` expands `\<string>` if it is defined else expands <text>.\nl +\^`\useit` `<one>`, \^`\usesecond` `<one><two>` uses given parameter.\nl \^`\wlog`` {<text>}` writes <text> to .log file.\nl \^`\wterm`` {<text>}` writes <text> to the terminal and .log file.\nl \^`\xargs`` <what> <token> <token> ... ;` repeats <what><token> for each <token>.\nl |