summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/cstex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-03-13 20:57:13 +0000
committerKarl Berry <karl@freefriends.org>2019-03-13 20:57:13 +0000
commit2a0df47c9a261e34a4071da2134f1efd2b7a55ad (patch)
tree43e762f4d9a6fd9f7109eba1b6e21da86e768b3e /Master/texmf-dist/doc/cstex
parentf4bb07267c294f84d8f0656f916930f6883ca6f4 (diff)
cstex (13mar19)
git-svn-id: svn://tug.org/texlive/trunk@50372 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/cstex')
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-d.tex37
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-u-en.pdfbin240216 -> 242981 bytes
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-u-en.tex53
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-u.pdfbin276587 -> 280633 bytes
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-u.tex62
5 files changed, 147 insertions, 5 deletions
diff --git a/Master/texmf-dist/doc/cstex/opmac-d.tex b/Master/texmf-dist/doc/cstex/opmac-d.tex
index 0c19a207b5a..fcabe66ad6f 100644
--- a/Master/texmf-dist/doc/cstex/opmac-d.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-d.tex
@@ -8,7 +8,7 @@
% UTF-8 encTeX has a conflict with DocByTeX
\chyph
-\def\projectversion{Aug. 2018}
+\def\projectversion{Mar. 2019}
\def\headtitle{OPmac}
\widowpenalty=10000
@@ -344,6 +344,7 @@ uivatelsk dokumentaci.
\dgn \nb colsep
\dgn \nb mnoteindent
\dgn \nb mnotesize
+\dgn \nb titskip
\dgn \nb picdir
\dgn \nb bibtexhook
\dgn \nb chaphook
@@ -2797,6 +2798,40 @@ jednotky pomoc makra \db truedimen.
\inext{trueunit}{\empty}{+-}
+\subsec [styly] Peddefinovan styly
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+Makro \db boxlines pracuje obdobn jako makro plainTeX{}u "\obeylines", ale
+jednotliv dky jsou samostatn "\hbox"y rzn irok.
+Proto napklad "\vbox{\boxlines <dky textu>}" vytvo "\vbox", kter je stejn
+irok jako nejir dek v nm. Toto makro bude pouito v makru
+"\address", kter je definovno ve stylu "\letter".
+
+\inext{boxlines}{\empty}{+-}
+
+Toto makro pi pechodu do horizontlnho mdu pomoc "\everypar" tento md
+okamit uzave a oteve bn "\hbox\bgroup". V nm je konc dku aktivn a
+jakmile k nmu dojde, provede se \db boxlinesE, co ukon skupinu "\hbox"u
+pmoc "\egroup". Nejvce komplikac pin syntaktick alternativa, kdy
+uivatel me ukonit skupinu, kterou sm otevel, explicitnm "}", a to
+nejen ve vertiklnm mdu (to pak funguje sprvn), ale tak teba
+v rmci vnitnho horizontlnho mdu. Tm se tento md ukon, ale
+neukon se uivatelova skupina. Proto pomoc "\aftergroup" iniciaozavn ve
+vnitnm horizontlnm mdu je za kompletovanm "\hbox"em
+sputna dvojice maker \db boxlinesC a \db boxlinesD, kter zkontroluje,
+zda tsn nsleduje "\empty". To je pznak toho, e jsme ukonili intern
+horizonrln md pomoc "\boxlinesE". V takovm ppad nedlme nic. Jinak
+ukonme i uivatelovu skupinu pomoc "\egroup". Je tam pouit
+"\expandafter", protoe uivatel me mt taky sv "\aftergroup".
+
+Nsleduj definice maker \db report a \db letter nastavujc peddefinovan
+styl dokumentu v souladu s tm, co je o tom psno v uivatelsk dokumentaci.
+\dgn \nb address
+\dgn \nb subject
+\dgn \nb author
+
+\inext{report}{\empty}{+-}
+
\subsec [zaver] Zvr
%%%%%%%%%%%%%%%%%%%%%
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.pdf b/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
index 21724b8ebbc..b37232b0db3 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
+++ b/Master/texmf-dist/doc/cstex/opmac-u-en.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.tex b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
index 03809c3a482..d448150ab35 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u-en.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
@@ -20,7 +20,7 @@
\tit OPmac -- macros for plain\TeX\fnotemark1
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\centerline{\it Petr Ol\v s\'ak, 2012 -- 2016}
+\centerline{\it Petr Ol\v s\'ak, 2012 -- 2019}
\bigskip
\centerline{\url{http://petr.olsak.net/opmac-e.html}}
@@ -1414,11 +1414,58 @@ as dot and dot is ignored by sorting algorithm. You can redefine this macro,
but you must keep the format, keep "\setlccodes" in the front and "{}{}" in
the end.
+\sec Pre-defined styles
+
+OPmac defines two style-declaration macros "\report" and "\letter" since
+Mar.~2019. You can use them at the beginning of your document if you are
+preparing these types of document and you don't need to create your own
+macros.
+
+The "\report" declaration is intended to create reports. It
+sets default font size to 11\,pt and "\parindent" to 1.2\,em.
+The "\tit" macro uses smaller font because we assume that ``chapter'' level
+will be not used in reports. The first page has no page number, but next pages
+are numbered (from number 2). The footnotes are numbered from one in whole
+document. The macro "\author <authors><end-line>" can be used when
+"\report" is declared. It prints "<authors>" in italics at center of the
+line. You can separate authors by "\nl" to more lines.
+
+The "\letter" declaration is intended to create letters. It sets default
+font size to 11\,pt and "\parindent" to 0\,pt. It sets half-line space
+between paragraphs. The page numbers are not printed. The "\subject" macro
+can be used, it prints the word ``Subject:'' or ``V\v{e}c'' in bold
+depending on used language. Moreover, the "\address" macro
+can be used when "\letter" is declared. The usage of the "\address" macro
+looks like:
+
+\begtt
+\address
+ <first line of address>
+ <second line of address>
+ <etc.>
+ <empty line>
+\endtt
+
+It means that you need not to use any special mark at the end of lines: end
+of lines in the source file are the same as in printed output. The
+"\address" macro creates "\vtop" with address lines. The width of such
+"\vtop" is equal to the most wide line used in it. So, you can use
+"\hfill\address..." in order to put the address box to the right side of the
+document. Or you can use "<prefixed text>\address..." to put
+"<prefixed text>" before first line of the address.
+
+Analogical declaration macros "\book" or "\slides" are not prepared. Each
+book needs an individual typographical care so you need to cerate specific
+macros for design. And you can find an inspiration of slides in OPmac tricks
+\ulink[http://petr.olsak.net/opmac-tricks-e.html\#slidy]{0017 and 0022}.
+
+
+\vfil\break
\sec Summary
%%%%%%%%%%%%
-\def\tthook{\adef!{\string\endtt}\adef&{\kern.25em}}
+\def\tthook{\typosize[10/12]\adef!{\string\endtt}\adef&{\kern.25em}}
\begtt
\tit Title (terminated by end of line)
\chap Chapter Title (terminated by end of line)
@@ -1471,6 +1518,8 @@ the end.
\magscale[factor] % resize typesetting, line/page breaking unchanged
\margins/pg format (left, right, top, bottom)unit % margins setting
+
+\report \letter % style declaration macros
\endtt
\end
diff --git a/Master/texmf-dist/doc/cstex/opmac-u.pdf b/Master/texmf-dist/doc/cstex/opmac-u.pdf
index a65f94ff528..c0b62016227 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u.pdf
+++ b/Master/texmf-dist/doc/cstex/opmac-u.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/cstex/opmac-u.tex b/Master/texmf-dist/doc/cstex/opmac-u.tex
index a4450421637..60bdf7f1b1f 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-u.tex
@@ -20,7 +20,7 @@
\tit OPmac -- rozšiřující makra plain\TeX{}u
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\centerline{\it Petr Olšák, 2012 -- 2016}
+\centerline{\it Petr Olšák, 2012 -- 2019}
\bigskip
\centerline{\url{http://petr.olsak.net/opmac.html}}
@@ -1637,7 +1637,7 @@ makra: "\magscale[1414] \margins/1 a4 (,,,)mm" umístí sazbu, která je určena
pro tisk na a5, doprostřed stránky a4 a odpovídajícím způsobem ji zvětší,
aby se to korektorům lépe četlo.
-
+\label[lastpage]
\sec Poslední strana
%%%%%%%%%%%%%%%%%%%%
@@ -1770,6 +1770,62 @@ znakem.
\maybebreak 4cm
+\sec Předdefinované styly dokumentů
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+Implicitní styl dokumentu při použití OPmac zahrnuje výchozí parametry a
+vzhled sazby
+jako v plain\TeX u. Pochopitelně
+uživatel si styl dokumentu obvykle upraví pomocí svých maker a třeba s
+využitím maker OPmac.
+
+Od března 2019 nabízí OPmac kromě toho zkratky s výchozím nastavením jiných
+stylů, což je možné použít, pokud chce uživatel vytvořit
+běžný typ dokumentu a nechce se zdržovat nastavováním parametrů a
+definicí vlastních maker. Jsou připraveny deklarační makra "\report" a
+"\letter", která je možné použít v záhlaví dokumentu.
+
+Deklarace "\report" je určena pro psaní zpráv. Písmo je nastaveno
+na 11 bodů, odsazení odstavců je 1,2\,em. Makro "\tit" použije menší font
+než obvykle, protože se nepředpokládá, že bude použita úroveň \uv{kapitola}.
+První stránka je nečíslovaná, ostatní jsou číslovány (od strany~2).
+Poznámky pod čarou jsou číslovány vzestupně v celém dokumentu.
+Při použití tohoto makra v záhlaví dokumentu je připraveno též makro
+"\author<text><konec řádku>", které umístí <text> v kurzívě doprostřed
+řádku. Při použití "\nl" je text rozdělen do více řádků, každý je centrován.
+
+Deklarace "\letter" je určena pro psaní dopisů. Písmo je nastaveno na 11
+bodů, odsazení není žádné a mezi odstavci je půlřádková mezera. Stránky
+nejsou číslovány. Chcete-li je číslovat, můžete použít například kód uvedený
+v sekci \ref[lastpage].
+Při použití tohoto makra je dále připraveno makro
+"\address" pro psaní víceřádkových adres a makro "\subject" které vypíše
+tučně slovo \uv{Věc:} nebo \uv{Vec:} nebo \uv{Subject:} v závislosti na
+použitém jazyce. Užití makra "\address" vypadá takto:
+
+\begtt
+\address
+ <první řádek adresy>
+ <druhý řádek adresy>
+ <atd.>
+ <prázdný řádek>
+\endtt
+%
+tedy řádky se neukončují žádným speciálním znakem, ale konec řádku na
+vstupu je koncem řádku i v sazbě.
+Makro vytvoří "\vtop" se sazbou řádků tak, že jeho šířka
+odpovídá nejširšímu řádku. Chcete-li mít víceřádkovou adresu u pravého
+okraje stránky stačí tedy psát "\hfill\address..."
+A před adresu lze také do prvního
+řádku předsadit text jednoduše pomocí "<text>\address..."
+
+Analogický deklarátor "\book" není zahrnut, protože kniha vyžaduje individuální
+péči typografa a každá kniha může být jiná. Na takový projekt je účelné si
+připravit vlastní makra. Deklarátor "\slides" také není zahrnut, ale je
+možné použít OPmac triky
+\ulink[http://petr.olsak.net/opmac-tricks.html\#slidy]{0017 a 0022}.
+
+
\sec Shrnutí
%%%%%%%%%%%%
@@ -1827,6 +1883,8 @@ znakem.
\magscale[<faktor>] % zvětšení/zmenšení sazby beze změny zlomu
\margins/<pg> <formát> (<levý>,<pravý>,<horní>,<dolní>)<jednotka> % okraje
+
+\report \letter % inicializace předdefinovaného stylu dokumentu
\endtt
\bye