summaryrefslogtreecommitdiff
path: root/doc/context/third
diff options
context:
space:
mode:
Diffstat (limited to 'doc/context/third')
-rw-r--r--doc/context/third/cyrillicnumbers/cyrillicnumbers.tex354
1 files changed, 306 insertions, 48 deletions
diff --git a/doc/context/third/cyrillicnumbers/cyrillicnumbers.tex b/doc/context/third/cyrillicnumbers/cyrillicnumbers.tex
index 7e56d9b..fcb2872 100644
--- a/doc/context/third/cyrillicnumbers/cyrillicnumbers.tex
+++ b/doc/context/third/cyrillicnumbers/cyrillicnumbers.tex
@@ -1,3 +1,5 @@
+\enablemode[print]
+
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Module loading %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -14,6 +16,18 @@
]
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Colors %
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\definecolor [primarycolor] [darkmagenta]
+\definecolor[secondarycolor] [magenta]
+
+\startmode[print]
+ \definecolor [primarycolor] [gray12]
+ \definecolor[secondarycolor] [gray22]
+\stopmode%%% print
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Letterspacing / emphases %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -28,7 +42,7 @@
\def\pompoustitle#1{%
\setuplocalinterlinespace[line=33pt]%
- \color[darkmagenta]{%
+ \color[primarycolor]{%
\tfd\bold\WORD\largecaps{#1}%
}%
}
@@ -44,7 +58,7 @@
\def\mediumtitle#1{%
\setuplocalinterlinespace[line=33pt]%
- \color[darkmagenta]{%
+ \color[primarycolor]{%
\tfa\sc\mediumcaps{#1}%
}%
}
@@ -71,15 +85,6 @@
]
\let\te\textemph
-\unexpanded\def\name#1{\smallcaps{\sc#1}}
-
-\defineletterspace [ugly]
-\setupletterspace [ugly] [
- factor=.4,
- spaceskip=1em,
- suppresskern=no,
-]
-
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Font Setups %
@@ -112,10 +117,9 @@
\usetypescriptfile [type-imp-computer-modern-unicode.mkiv]
\usetypescript [computer-modern-unicode]
-\def\russian#1{\begingroup\language[ru]\setupbodyfont[computer-modern-unicode]#1\endgroup}
-
+\def \russian#1{\begingroup\language[ru]\setupbodyfont[computer-modern-unicode]#1\endgroup}
\def\oldrussian#1{\begingroup\language[ru]\setupbodyfont[vintagecyrillic]#1\endgroup}
-\def\greek #1{\begingroup\language[agr]\setupbodyfont[computer-modern-unicode]#1\endgroup}
+\def \greek#1{\begingroup\language[agr]\setupbodyfont[computer-modern-unicode]#1\endgroup}
\usetypescript [modern]
\starttypescript [mymodern]
@@ -125,10 +129,6 @@
\usetypescript [mymodern]
\setupbodyfont [mymodern]
-% \setupbodyfont [modern]
-% \usetypescript [antykwa-poltawskiego]
-% \setupbodyfont [antykwa-poltawskiego,10pt]
-
\usetypescript [serif] [hz] [highquality]
\setupalign [hanging,hz]
@@ -138,7 +138,28 @@
\def\uprightslash{\bgroup\tf/\egroup}
\def\uprightomiss{\bgroup\tf[\dots]\egroup}
-% \setuptyping[style=\tfx\sans]
+%%% The Wiki is great. Long live the Gardener!
+\definetextbackground[verbatim] [
+ background=color,
+ backgroundcolor=gray92,
+ backgroundoffset=0cm,
+ frame=off,
+ location=paragraph,
+ offset=0.5cm,
+]
+
+\setuptyping[
+ after={\stoptextbackground\blank[line]},
+ before={\blank[line]\noindentation\starttextbackground[verbatim]},
+ bodyfont=9pt,
+ margin=1em,
+ % style=\tfx\sans,
+]
+
+%%% TODO: find out if this is documented already
+%%% http://archive.contextgarden.net/message/20060523.151528.b6da35e1.en.html
+%%% http://archive.contextgarden.net/message/20111221.083957.5c85d357.en.html
+\setconstant\kindofpagetextareas\plusone
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Presenting the Interface %
@@ -154,8 +175,8 @@
\unexpanded\def\setupintfont {\rm\sc\Word}%
\unexpanded\def\setupvarfont {\rm\it}%
\unexpanded\def\setupoptfont {\rm\it}%
- \unexpanded\def\setupalwcolor {darkmagenta}%
- \unexpanded\def\setupoptcolor {darkmagenta}%
+ \unexpanded\def\setupalwcolor {primarycolor}%
+ \unexpanded\def\setupoptcolor {primarycolor}%
\defineframedtext [setuptext] [
frame=off,
background=color,
@@ -221,8 +242,8 @@
\setupinteraction[%
state=start,
- color=darkmagenta,
- contrastcolor=darkmagenta,
+ color=primarycolor,
+ contrastcolor=primarycolor,
%color=,
%contrastcolor=,
style=,
@@ -273,7 +294,6 @@
\definestructureconversionset[regularstructure] [numbers,cyrnumone,cyrnumtwo] [cyrnumone]
\definestructureconversionset[regularstructure] [numbers,cyrnumone,cyrnumtwo] [cyrnumone]
-% \definestructureconversionset[regularstructure] [numbers,romannumerals,romannumerals] [cyrnumone]
\setuphead [chapter] [
align=middle,
@@ -495,14 +515,36 @@
\setupindenting [yes,next,medium]
-\useURL [petr] [http://www.paratype.ru/e-zine/issue04/peter1/peter1a.htm] [] [\hyphenatedurl{http://www.paratype.ru/e-zine/issue04/peter1/peter1a.htm}]
-\useURL [reform1917] [http://ru.wikipedia.org/wiki/Реформа_русской_орфографии_1918_года] [] [\hyphenatedurl{http://ru.wikipedia.org/wiki/Реформа_русской_орфографии_1918_года}]
+% \sethyphenatedurlnormal{:=?&}
+\sethyphenatedurlbefore{?&abcdefghijklmnopqrstuvwxyz}
+% \sethyphenatedurlafter {:=}
+\startasciimode
+\useURL [petr] [http://www.paratype.ru/e-zine/issue04/peter1/peter1a.htm]
+ [] [\hyphenatedurl{http://www.paratype.ru/e-zine/issue04/peter1/peter1a.htm}]
+
+\useURL [reform1917] [http://ru.wikipedia.org/wiki/Реформа_русской_орфографии_1918_года]
+ [] [\hyphenatedurl{http://ru.wikipedia.org/wiki/Реформа_русской_орфографии_1918_года}]
+
+\useURL [wp_titlo] [http://commons.wikimedia.org/wiki/Category:Titlo?uselang=uk]
+ [] [\hyphenatedurl{http://commons.wikimedia.org/wiki/Category:Titlo?uselang=uk}]
+\useURL [rubl’] [http://ru.wikipedia.org/wiki/Рубль#.D0.92_.D0.98.D0.BC.D0.BF.D0.B5.D1.80.D0.B0.D1.82.D0.BE.D1.80.D1.81.D0.BA.D0.BE.D0.B9_.D0.A0.D0.BE.D1.81.D1.81.D0.B8.D0.B8]
+ [] [\hyphenatedurl{http://ru.wikipedia.org/wiki/Рубль#.D0.92_.D0.98.D0.BC.D0.BF.D0.B5.D1.80.D0.B0.D1.82.D0.BE.D1.80.D1.81.D0.BA.D0.BE.D0.B9_.D0.A0.D0.BE.D1.81.D1.81.D0.B8.D0.B8}]
\useURL [pttypescript] [http://archive.contextgarden.net/message/20110105.204326.d0228ca7.en.html]
-\useURL [phg-mail] [mailto:gesang@stud.uni-heidelberg.de] [] [\hyphenatedurl{gesang@stud.uni-heidelberg.de}]
+\useURL [phg-mail] [mailto:megas.kapaneus@gmail.com] [] [\hyphenatedurl{megas.kapaneus@gmail.com}]
\useURL [phg-bibu] [https://bitbucket.org/phg/] [] []
+\useURL [cmu-home] [http://cm-unicode.sourceforge.net/] [] [\hyphenatedurl{http://cm-unicode.sourceforge.net/}]
+\useURL [cmu-debian] [http://packages.debian.org/wheezy/fonts-cmu] [] [\hyphenatedurl{http://packages.debian.org/wheezy/fonts-cmu}]
+\useURL [cmu-arch] [http://aur.archlinux.org/packages.php?ID=44029] [] [\hyphenatedurl{http://aur.archlinux.org/packages.php?ID=44029}]
+\useURL [cmu-tl] [http://tug.org/svn/texlive/trunk/Master/texmf-dist/fonts/opentype/public/cm-unicode/]
+ [] [\hyphenatedurl{http://tug.org/svn/texlive/trunk/Master/texmf-dist/fonts/opentype/public/cm-unicode/}]
+\useURL [bukyvede] [http://kodeks.uni-bamberg.de/aksl/Schrift/BukyVede.htm]
+ [] [\hyphenatedurl{http://kodeks.uni-bamberg.de/aksl/Schrift/BukyVede.htm}]
+\useURL [romancyr] [http://kodeks.uni-bamberg.de/aksl/Schrift/RomanCyrillicStd.htm]
+ [] [\hyphenatedurl{http://kodeks.uni-bamberg.de/aksl/Schrift/RomanCyrillicStd.htm}]
+\stopasciimode
\pdfcompresslevel9
@@ -554,7 +596,7 @@
toffset=6pt,
]{%
\tfc%
- \dorecurse{9}{\normaltextcyrnum[titlo=mp,titlocolor=darkmagenta,titlomode=\recurselevel]{42}%
+ \dorecurse{9}{\normaltextcyrnum[titlo=mp,titlocolor=primarycolor,titlomode=\recurselevel]{42}%
\ifnum\recurselevel=9\else\hfill\fi}%
}%
}%
@@ -567,7 +609,7 @@
\dorecurse{6}{%
\recurselevel
\hfill
- \normaltextcyrnum[titlo=mp,titlomode=1,titlocolor=darkmagenta,titlospan=\recurselevel]{424242}%
+ \normaltextcyrnum[titlo=mp,titlomode=1,titlocolor=primarycolor,titlospan=\recurselevel]{424242}%
\ifnum\recurselevel<6\par\fi%
}
}%
@@ -577,7 +619,7 @@
\startbuffer[penwidthshowcase]%
\start\setuptolerance[horizontal,tolerant,stretch]%
% \placetable[left][penwidthdemo]{Comparison of different values for the parameter \type{penwidth}.}{%
-\placetable[bottom,left][penwidthdemo]{Comparison of different values for the parameter \type{penwidth}.}{%
+\placetable[middle][penwidthdemo]{Comparison of different values for the parameter \type{penwidth}.}{%
\starttabulate[|r|r|l|r|r|l|]%% tabulate sucks hard, just try to use it with a macro that contains a numberconversion and you’ll know why
\let\lp\letterpercent
\startluacode
@@ -593,6 +635,7 @@
\stopluacode
\stoptabulate%
}%
+\stop
\stopbuffer
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -632,7 +675,7 @@
titlo=mp,
titlomode=\the\thistitlomode,
command=\showoldrussian,
- titlocolor=magenta,
+ titlocolor=secondarycolor,
]
\newdimen\skipincrement \skipincrement=0.047619047619048\hsize
\newdimen\showskip \showskip=\zeropoint
@@ -644,7 +687,7 @@
\dontleavehmode\hbox to\showskip{}%
\ifconditional\checker
\setfalse\checker
- \colored[darkmagenta]{\showcasecyrnum{\recurselevel}}%
+ \colored[primarycolor]{\showcasecyrnum{\recurselevel}}%
\else
\settrue\checker
\showcasecyrnum{\recurselevel}%
@@ -704,7 +747,8 @@ with the description on the module’s usage in the section on
\about[functionality].
\ctxluabuffer[showcase1]
-\indentation The Cyrillic system, like the alphabet
+\start\setuptolerance[horizontal,verytolerant]%% stupid float
+\indentation The Cyrillic numeral system, like the alphabet
it is based on, originated from the Greek numerals and thus
continues many features of the latter.\footnote{%
Thorough examinations of how Cyrillic numbers were used in
@@ -719,7 +763,10 @@ continues many features of the latter.\footnote{%
As with the Roman number system, there are no genuine glyphs
reserved for numerals, instead numbers are represented by strings
of letters from the ordinary alphabet, organized in a peculiar
-way.
+way; both systems also have the base (10) in common.
+However, unlike the Roman system Cyrillic numbers are
+\te{positional}, meaning that the numerical value of a digit
+depends on its location relative to the other digits.
The first nine digits, in ascending order, are:
\dorecurse{9}{\ifnum\recurselevel=9 and \fi%
“\normaltextcyrnum{\recurselevel}”%
@@ -747,7 +794,8 @@ For example, in the Cyrillic system the number 42 is written as
\normaltextcyrnum{42}; the lack of a distinct zero sign causes
402 to have \te{two} digits as well, but the character
representing the digit 4 gets chosen from the hundreds set:
-\normaltextcyrnum{402}.
+\normaltextcyrnum{402}.\par
+\stop
% above 10^3
The rules so far don’t allow for numbers above 999.
@@ -918,6 +966,14 @@ character above which it is placed.
Thus, multi-digit Cyrillic numbers (i.~e. essentially any number
with two or more non-zero digits) won’t be represented in an
optimal way: \normaltextcyrnum[titlo=font]{42}.
+There is a further option, \type{titlolocation}, which controls
+the placement of a font specific titlo.\marginhint{titlolocation}
+The three possible values specify a position
+{\italic first}: \normaltextcyrnum[titlo=font, titlolocation=first]{4242},
+{\italic middle}: \normaltextcyrnum[titlo=font,titlolocation=middle]{4242}, and
+{\italic final}: \normaltextcyrnum[titlo=font, titlolocation=final]{4242}.
+(For even character counts, the {\italic middle} argument will
+pick one place to the right of the exact middle.)
\getbuffer[titloshowcase]
\getbuffer[titlospanshowcase]\indentation An alternative to the
@@ -927,13 +983,18 @@ digits.
Not only does this titlo cover the entire numeral, it also comes
in a variety of drawing routines.
At the moment there are nine more or less different titlos you
-may choose from as demonstrated in \in{figure}[mptitlodemo].\marginhint{titlomode,titlospan}
+may choose from as demonstrated in \in{figure}[mptitlodemo].
These can be enabled on via the \type{titlomode} key.
+(Observant users will have recognized mode 8 as the old Rubl’
+sign:
+\normaltextcyrnum[titlo=mp,titlomode=8,penwidth=.21]{42}.\footnote{%
+ Cf. \from[rubl’].
+})
The range of digits to be covered by the titlo can be customized
by passing the parameter \type{titlospan} an integer.
The default value of 3 results in the titlo spanning at maximum the
least significant three digits, because these won’t be prefixed
-by a thousands sign.
+by a thousands sign.\marginhint{titlomode,titlospan}
If the user wants the numeral to be covered as a whole, E can
simply pass the value {\italic all}.
Beware that the dimensions of the titlo are proportional to the
@@ -949,31 +1010,152 @@ five digits plus two thousand signs of
When using the {\italic mp} titlo the color of this element can
be chosen separately by passing a valid color identifier to the
\type{titlocolor} key.\marginhint{titlocolor}
+The following example code demonstrates the colorization and
+drawing facilities.
+
+\starttyping
-\indentation The \METAPOST\ drawing options have separate keys.\marginhint{penwidth}
-Of these, \type{penwidth} rather obviously determines the width
-of the pen that is used when drawing a titlo.
-Finding the optimal width can involve a lot of testing;
-as a rule, the bigger the font, the wider the pen should be.
-See the table \about[penwidthdemo] for a demonstration of
+\usemodule [cyrillicnumbers]
+\setupbodyfont [computer-modern-unicode]
+\setupcyrnum [
+ titlo=mp,
+ titlocolor=blue,
+ titlospan=all,
+ titlomode=7,
+]
+
+\starttext
+\startlines
+\cyrnum {42}
+\cyrnum [titlocolor=red,titlomode=9] {141213}
+\cyrnum [titlocolor=green,titlomode=2] {271828}
+\cyrnum [titlocolor=cyan,titlomode=4] {314159}
+\stoplines
+\stoptext
+
+\stoptyping
+
+\indentation The \METAPOST\ option also comes with a key
+\marginhint{penwidth}, which rather obviously determines the
+width of the pen that is used when drawing a titlo.
+Finding the optimal width can involve a lot of testing on the
+user’s side; as a rule, the greater the font size, the wider the
+pen should be.
+Refer to \in{table}[penwidthdemo] for a demonstration of
different values for this parameter.
\getbuffer[penwidthshowcase]
-\stop
-
\stopsection
\startsection[title=Predefined Commands]
+Once the module is loaded, the commands \type{\cyrnum} and
+\type{\cyrnumdrawtitlo} will have been predefined.
+
\showsetup{cyrnum}
+
+\type{\cyrnum} is the default Cyrillic number macro which is
+fully functional, meaning that besides converting a nonnegative
+integer into a Cyrillic numeral, it takes a key-value set of
+options as an optional first argument.
+
+\starttyping
+\usemodule[cyrillicnumbers]
+\starttext
+
+\cyrnum{1}
+
+\cyrnum[titlo=mp,titlomode=4]{42}
+
+\cyrnum{15}
+
+\stoptext
+\stoptyping
+
+Any of the abovementioned settings can be specified in the first
+argument.
+As customary with \CONTEXT\ macros, these additional settings are
+local to one instance.
+Further calls to the macro won’t be affected, unless they are
+explicitly applied via \type{\setupcyrnum},
+
+The use of \te{titlos} is not restricted to indicating numerals.
+In addition it is often employed as a kind of emphasis in
+handwritten text where it is not easy to achieve visual
+distinction by font switching.
+Also, the titlo serves as a default marker for abbreviations as
+in \oldrussian{благодѣть} \rightarrow\space
+\oldrussian{\cyrnumdrawtitlo{блг}одѣть}.
+
\showsetup{cyrnumdrawtitlo}
-% \cyrnumdrawtitlo{foobar}
+This is where the macro \type{\cyrnumdrawtitlo} comes into play.
+For instance, designations of things considered “sacred” are
+highlighted by default in some texts.
+Because they appear very frequently, they were shortened as
+well, like \oldrussian{господь}
+\rightarrow\space\oldrussian{\cyrnumdrawtitlo{гь}}.\footnote{%
+ Examples taken from \from[wp_titlo].
+}
+
+\starttyping
+господь ->\cyrnumdrawtitlo{гь}
+
+благодѣть -> \cyrnumdrawtitlo{блг}одѣть
+\stoptyping
+
\stopsection
\startsection[title=Command Derivation]
+
+There is no need to reconfigure the \type{\cyrnum} macro whenever
+you intend to deviate from the presets.
+Instead, special purpose commands can be defined via
+\type{\definecyrnum}.
+
\showsetup{definecyrnum}
+All the options that can be passed to \type{\definecyrnum} are
+also valid for derived macros; they inherit the setups of
+the macros they are derived from.
+A full example to play with is given in below listing:
+
+\starttyping
+\usemodule[cyrillicnumbers]
+\setupbodyfont[computer-modern-unicode]
+
+\definecyrnum[mynumone][titlo=no,dots=no]
+
+\definecyrnum[mynumtwo][mynumone]
+\setupcyrnum [mynumtwo][titlo=mp,titlomode=2,titlocolor=red]
+
+\definecyrnum[mynumthree][mynumtwo]
+\setupcyrnum [mynumthree][titlomode=4,dots=yes]
+
+\starttext
+
+\mynumone{42}
+\mynumtwo{42}
+\mynumthree{42}
+
+\stoptext \endinput
+\stoptyping
+
+\start
+ \definecyrnum[mynumone][titlo=no,dots=no]
+
+ \definecyrnum[mynumtwo][mynumone]
+ \setupcyrnum [mynumtwo][titlo=mp,titlomode=2,titlocolor=red]
+
+ \definecyrnum[mynumthree][mynumtwo]
+ \setupcyrnum [mynumthree][titlomode=4,dots=yes]
+
+ \noindentation Which results in:
+ \mynumone{42}
+ \mynumtwo{42}
+ \mynumthree{42}.
+\stop
+
\stopsection
\stopchapter
@@ -983,12 +1165,88 @@ different values for this parameter.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\startsection[title=Counters]
-\stopsection
+The macros created by \type{\definecyrnum} are generic conversion
+commands.
+As such, they can be hooked into any functionality that outputs
+integers of some sort: document structure elements, page numbers
+{\italic\letterampersand}c.
+In order to have \CONTEXT\ recognize your personal Cyrillic
+number macro as a converter you need the macro
+\type{\defineconversion}.
+
+\starttyping
+\usemodule [cyrillicnumbers]
+\setupbodyfont [computer-modern-unicode]
+
+%%% 1. Define a number converter.
+\definecyrnum [neatsections] [
+ dots=yes,
+ titlo=mp,
+ titlomode=7,
+]
+
+%%% 2. Register the converter.
+\defineconversion [my_section_conversion] [\neatsections]
+
+%%% 3. Insert it into a structure set.
+\definestructureconversionset [my_section_set]
+ [numbers,my_section_conversion] [my_section_conversion]
+
+%%% 4. Use the set in your chapter command.
+\definehead [mychapter] [chapter]
+\setuphead [mychapter] [
+ sectionconversionset=my_section_set,
+ page=no,
+]
+
+\starttext
+
+\dorecurse{10}{%
+ \startmychapter[title=foo]
+ \input knuth
+ \stopmychapter
+}
+
+\stoptext \endinput
+\stoptyping
-\startsection[title=The Titlo]
\stopsection
+% \startsection[title=The Titlo]
+% \stopsection
+
\startsection[title=Font Issues]
+
+Although not the entire Cyrillic alphabet is needed to represent
+the numerals, they involve certain characters which are uncommon
+in contemporary languages.
+Therefore they are usually omitted in Cyrillic fonts, which leads
+to the problem of finding an adequate font.
+A matching superset of Knuth’s typeface is {\italic Computer Modern
+Unicode} which is part of \TEX Live and packaged for many
+distributions.\footnote{%
+ Home: \from[cmu-home];
+ \TEX Live: \from[cmu-tl];
+ Arch: \from[cmu-arch];
+ Debian: \from[cmu-debian].
+}
+CMU is SIL-OpenFont licensed; it has been used in some of the
+above examples.
+
+There are alternatives offering glyph shapes that resemble the
+hand written script of Old Slavonic codices.
+One of them is the beautiful {\italic BukyVede} which has been
+used as the main Cyrillic font throughout the text.
+It was created by the Codex project of the Bamberg
+University\footnote{%
+ Home: \from[bukyvede].
+}
+but unfortunately the licensing terms are imprecise (non-free).
+Its authors offer another font matching the popular Times
+typeface under a yet more restrictive license.\footnote{%
+ Home: \from[romancyr].
+}
+
\stopsection
\stopchapter