diff options
author | Karl Berry <karl@freefriends.org> | 2014-08-16 21:43:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-08-16 21:43:28 +0000 |
commit | 9caacf53d7d2a1620a603aa644617293a60183e2 (patch) | |
tree | 231eaf764696a85098e37d8ec19045fbb72c0a77 /Master/texmf-dist/doc/cstex/opmac-u-en.tex | |
parent | 48523b6ca61cfc84ac2bbe578b12fed09cbd70eb (diff) |
cstex (16aug14)
git-svn-id: svn://tug.org/texlive/trunk@34952 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/cstex/opmac-u-en.tex')
-rw-r--r-- | Master/texmf-dist/doc/cstex/opmac-u-en.tex | 69 |
1 files changed, 45 insertions, 24 deletions
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.tex b/Master/texmf-dist/doc/cstex/opmac-u-en.tex index 95408df9a3e..82c65e45165 100644 --- a/Master/texmf-dist/doc/cstex/opmac-u-en.tex +++ b/Master/texmf-dist/doc/cstex/opmac-u-en.tex @@ -32,24 +32,25 @@ \nonum \sec Introduction %%%%%%%%%%%% -The OPmac package is simple additional macros to plain\TeX{}. It enables -users to take advantage of basic \LaTeX{} functionality: the font size -selection, automatic creation of table of contents and index, working with -bibliography databases, tables, references including hyperlinks option, -margins settings, etc. - -I have decided to publish my macros together with the new version of -\csplain{}. I am using these macros long time for various purposes only in -my own computer. Now, I have made them more clean and added the user and -technical documentation and released them. - -The main reason is to give a set of macros which solves the common tasks to -the plain\TeX{} users. The side effect is that the macros demonstrate -that it is possible to do \TeX{} code simple and effective. Most of -\LaTeX{} macro packages don't have this feature. All macros are in the single -documented file "opmac.tex" with only 1700 lines. On the other hand the -\LaTeX{} code which solves comparable tasks is placed in kernel and tens -of \LaTeX{} packages with many tens of thousands lines in total. +The OPmac package is a set of simple additional macros to plain\TeX{}. It +enables users to take advantage of basic \LaTeX{} functionality: font size +selection, the automatic creation of a table of contents and an index, working +with bibliography databases, tables, references with optional hyperlinks, margin +settings, etc. + +I had been using these macros personally for a long time, but now, after +cleaning up the code a bit and providing both user and technical documentation, +I'm releasing them to the general public along with the new version of +\csplain{}. + +My main motivation in publishing OPmac is to provide a set of macros with +solutions to common tasks for plain\TeX{} users. Additionally, I wanted to +demonstrate that it is possible to write \TeX{} code in a simple and effective +style, something that most \LaTeX{} macro packages lack. All of OPmac's macros +are contained within the single file "opmac.tex" in only 1,700 +lines. By comparison, the \LaTeX{} code which solves comparable tasks is placed +inside its ``kernel'' along with many \LaTeX{} packages all of which contain +tens of thousands of lines. The main principles which I followed when creating this macro package, are: @@ -95,7 +96,7 @@ Here is a text. \bye \endtt -You can use \TeX, pdf\TeX, Xe\TeX{} or lua\TeX{} with eplain or \csplain{} +You can use \TeX, pdf\TeX, Xe\TeX{} or lua\TeX{} with "etex.src" or \csplain{} preloaded. The \csplain{} is recommended but it is not explicitly requested if you don't need to use Czech/Slovak specific features\fnote {Warnings: ``falling back to ASCII sorting'' @@ -134,10 +135,26 @@ i.e. the value stays unchanged. Examples: \typoscale[\magstep2/] % fonts bigger 1,44times \endtt -The sizes declared by these macros (for example in titles) are relative to -the basic size selected for the font (this may be arbitrary size, not only +The sizes declared by these macros (for example in titles) are relative to the +basic size selected for the current font (this may be arbitrary size, not only 10pt). +There are times however, when one would like to make a font change relative to +the documents ``base'' font size instead of the current font (e.g. when +typesetting footnotes). The macro "\typobase" provides an easy way to perform +such changes. The ``base'' font size is set with the first use of either +"\typosize" or "\typoscale" and this size is restored by "\typobase". Example: + +\begtt +\typosize[12/14] % if first use of \typosize, then this sets the "base" +... +{\typoscale[16/18] % bigger size (for example title font) + ... + \typobase\typoscale[750/750] % reduced to 75% of [12/14] (i.e. [9/10.5]) + ... % this is caculated from "base", no from actual title font +} +\endtt + The size of the current font can be changed by the command "\thefontsize[<font-size>]" or can be rescaled by "\thefontscale[<factor>]". These macros don't change math fonts sizes nor @@ -290,6 +307,10 @@ If there are forward referenced objects then user have to run \TeX{} twice. During each pass, the working "*.ref" file (with refereces data) is created and this file is used (if it exists) at the begin of the document. +You can create a reference to whatever else by commands +"\label[<label>]\wlabel{<text>}". The connection between "<label>" and +"<text>" is established. The "\ref[<label>]" will print "<text>". + \sec Lists %%%%%%%%%% @@ -501,7 +522,7 @@ instead "\localcolor". Example: \begtt \Red The text is red -\hbox{\loacalcolor \Blue here is blue {\localcolor \Green and green} +\hbox{\localcolor \Blue here is blue {\localcolor \Green and green} restored blue \Brown and brown} now the text is red. \endtt @@ -1023,7 +1044,7 @@ spaces and without extension) and the "<style>" is the part of the filename "opmac-bib-<style>.tex" where the formatting of the references list is defined. Possible styles are "simple" or "iso690". The behavior of "opmac-bib.tex" and "opmac-bib-iso690.tex" is full documented in these files -(after "\endpinput" command). +(after "\endinput" command). \medskip\noindent {\bf Formatting of the references list} is controlled by the "\printb" macro. @@ -1104,7 +1125,7 @@ You can change this behavior by following commands: \begtt \itvariables % variables typeset by text italics. -\mitvariables % mariables typeset by math italics. +\mitvariables % variables typeset by math italics. \endtt |