From 2a0df47c9a261e34a4071da2134f1efd2b7a55ad Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 13 Mar 2019 20:57:13 +0000 Subject: cstex (13mar19) git-svn-id: svn://tug.org/texlive/trunk@50372 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/cstex/opmac-d.tex | 37 ++++++++++++++++- Master/texmf-dist/doc/cstex/opmac-u-en.pdf | Bin 240216 -> 242981 bytes Master/texmf-dist/doc/cstex/opmac-u-en.tex | 53 +++++++++++++++++++++++- Master/texmf-dist/doc/cstex/opmac-u.pdf | Bin 276587 -> 280633 bytes Master/texmf-dist/doc/cstex/opmac-u.tex | 62 ++++++++++++++++++++++++++++- 5 files changed, 147 insertions(+), 5 deletions(-) (limited to 'Master/texmf-dist/doc/cstex') 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 @@ u \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 \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 }" 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 Binary files a/Master/texmf-dist/doc/cstex/opmac-u-en.pdf and b/Master/texmf-dist/doc/cstex/opmac-u-en.pdf 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 " can be used when +"\report" is declared. It prints "" 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 + + + + +\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 "\address..." to put +"" 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 Binary files a/Master/texmf-dist/doc/cstex/opmac-u.pdf and b/Master/texmf-dist/doc/cstex/opmac-u.pdf 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", které umístí 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 + + + + +\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í "\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[] % zvětšení/zmenšení sazby beze změny zlomu \margins/ (,,,) % okraje + +\report \letter % inicializace předdefinovaného stylu dokumentu \endtt \bye -- cgit v1.2.3