diff options
author | Hans Hagen <pragma@wxs.nl> | 2018-02-19 19:19:07 +0100 |
---|---|---|
committer | Context Git Mirror Bot <phg42.2a@gmail.com> | 2018-02-19 19:19:07 +0100 |
commit | 9bb459e9fedcad94579973ccd07ad9e78d0734c8 (patch) | |
tree | e01ac3174e8891a6e6004c88cb46f220312a2bfc /doc | |
parent | 5321d35d68ce0acb71b46bddac1d8cab8eca3fcc (diff) | |
download | context-9bb459e9fedcad94579973ccd07ad9e78d0734c8.tar.gz |
2018-02-19 19:05:00
Diffstat (limited to 'doc')
19 files changed, 70 insertions, 29 deletions
diff --git a/doc/context/documents/general/manuals/bidi.pdf b/doc/context/documents/general/manuals/bidi.pdf Binary files differindex 8550e5fd4..0d88c7de7 100644 --- a/doc/context/documents/general/manuals/bidi.pdf +++ b/doc/context/documents/general/manuals/bidi.pdf diff --git a/doc/context/documents/general/manuals/luatex.pdf b/doc/context/documents/general/manuals/luatex.pdf Binary files differindex 77db079d5..26af7ac71 100644 --- a/doc/context/documents/general/manuals/luatex.pdf +++ b/doc/context/documents/general/manuals/luatex.pdf diff --git a/doc/context/documents/general/qrcs/setup-cs.pdf b/doc/context/documents/general/qrcs/setup-cs.pdf Binary files differindex 871517201..432c0f4c3 100644 --- a/doc/context/documents/general/qrcs/setup-cs.pdf +++ b/doc/context/documents/general/qrcs/setup-cs.pdf diff --git a/doc/context/documents/general/qrcs/setup-de.pdf b/doc/context/documents/general/qrcs/setup-de.pdf Binary files differindex 706ad5cea..773140962 100644 --- a/doc/context/documents/general/qrcs/setup-de.pdf +++ b/doc/context/documents/general/qrcs/setup-de.pdf diff --git a/doc/context/documents/general/qrcs/setup-en.pdf b/doc/context/documents/general/qrcs/setup-en.pdf Binary files differindex 7c655f08a..e20173696 100644 --- a/doc/context/documents/general/qrcs/setup-en.pdf +++ b/doc/context/documents/general/qrcs/setup-en.pdf diff --git a/doc/context/documents/general/qrcs/setup-fr.pdf b/doc/context/documents/general/qrcs/setup-fr.pdf Binary files differindex 39356d60b..e54348de5 100644 --- a/doc/context/documents/general/qrcs/setup-fr.pdf +++ b/doc/context/documents/general/qrcs/setup-fr.pdf diff --git a/doc/context/documents/general/qrcs/setup-it.pdf b/doc/context/documents/general/qrcs/setup-it.pdf Binary files differindex 06020527c..3a4344aad 100644 --- a/doc/context/documents/general/qrcs/setup-it.pdf +++ b/doc/context/documents/general/qrcs/setup-it.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf Binary files differindex 13e06cbfe..79339c817 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-de.pdf b/doc/context/documents/general/qrcs/setup-mapping-de.pdf Binary files differindex 72afbb69e..cf6e35653 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-de.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-de.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-en.pdf b/doc/context/documents/general/qrcs/setup-mapping-en.pdf Binary files differindex 2e141dcbd..d0c223e7d 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-en.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-en.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf Binary files differindex baa3fec16..813e89679 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-it.pdf b/doc/context/documents/general/qrcs/setup-mapping-it.pdf Binary files differindex a4007450c..b3298becc 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-it.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-it.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf Binary files differindex 75dba641e..748bafafe 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf diff --git a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf Binary files differindex 339fe2e10..0ee1e3a5f 100644 --- a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf +++ b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf diff --git a/doc/context/documents/general/qrcs/setup-nl.pdf b/doc/context/documents/general/qrcs/setup-nl.pdf Binary files differindex 39ebff455..b164996e8 100644 --- a/doc/context/documents/general/qrcs/setup-nl.pdf +++ b/doc/context/documents/general/qrcs/setup-nl.pdf diff --git a/doc/context/documents/general/qrcs/setup-ro.pdf b/doc/context/documents/general/qrcs/setup-ro.pdf Binary files differindex 6b8570642..7651786e2 100644 --- a/doc/context/documents/general/qrcs/setup-ro.pdf +++ b/doc/context/documents/general/qrcs/setup-ro.pdf diff --git a/doc/context/sources/general/manuals/bidi/bidi.tex b/doc/context/sources/general/manuals/bidi/bidi.tex index 38de2f838..abd3f64fa 100644 --- a/doc/context/sources/general/manuals/bidi/bidi.tex +++ b/doc/context/sources/general/manuals/bidi/bidi.tex @@ -8,39 +8,37 @@ \startbuffer[preamble-fonts] \definefontfallback - [Serif] [scheherazaderegular*arabic sa 1.5] - [arabic] [force=yes] + [Serif] [scheherazaderegular*arabic] + [arabic] [force=yes,rscale=1.5] \definefontfallback - [SerifBold] [scheherazadebold*arabic sa 1.5] - [arabic] [force=yes] + [SerifBold] [scheherazadebold*arabic] + [arabic] [force=yes,rscale=1.5] \definefontfallback - [SerifItalic] [scheherazaderegular*arabic sa 1.5] - [arabic] [force=yes] + [SerifItalic] [scheherazaderegular*arabic] + [arabic] [force=yes,rscale=1.5] \definefontfallback - [SerifBoldItalic] [scheherazadebold*arabic sa 1.5] - [arabic] [force=yes] + [SerifBoldItalic] [scheherazadebold*arabic] + [arabic] [force=yes,rscale=1.5] \definefontfallback - [Serif] [sileot*hebrew sa 1.0] + [Serif] [sileot*hebrew] [hebrew] [force=yes] \definefontfallback - [SerifBold] [sileot*hebrew sa 1.0] + [SerifBold] [sileot*hebrew] [hebrew] [force=yes] \definefontfallback - [SerifItalic] [sileot*hebrew sa 1.0] + [SerifItalic] [sileot*hebrew] [hebrew] [force=yes] \definefontfallback - [SerifBoldItalic] [sileot*hebrew sa 1.0] + [SerifBoldItalic] [sileot*hebrew] [hebrew] [force=yes] -\definefontfeature[fakemono][mode=node,fakemono=yes] - -% \definefontfallback -% [Mono] [scheherazaderegular*fakemono sa 1.5] -% [arabic] [force=yes,factor=1] % factor forces a monospace +\definefontfallback + [Mono] [almfixed*none] + [arabic] [force=yes] \definefontfallback - [Mono] [sileot*fakemono sa 1.0] + [Mono] [sileot*none] [hebrew] [force=yes,factor=1] % factor forces a monospace \setupbodyfont @@ -78,6 +76,18 @@ \setuphead [color=darkyellow] +\setuphead + [chapter] + [style=\bfc] + +\setuphead + [section] + [style=\bfb] + +\setuphead + [subsection] + [style=\bfa] + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \startluacode @@ -115,7 +125,7 @@ p := textext("l2r") xsized .9PaperWidth ; q := textext("r2l") xsized .9PaperWidth ; r := textext("a few tips") xsized .9PaperWidth ; - s := textext("hans\quad\quad hagen") xsized .5bbheight(p); + s := textext("\bf\ss hans\quad\space\quad hagen") xsized .5bbheight(p); p := p shifted - llcorner p ; q := q shifted - llcorner q ; @@ -132,7 +142,7 @@ draw p withcolor "lightgray" ; draw q withcolor "lightgray" ; draw r withcolor "middleblue" ; - draw s withcolor "middleblue" ; + draw s withcolor "lightgray" ; \stopMPpage @@ -152,6 +162,15 @@ driven left or right of the road. \getbuffer +Even someone not familiar with right to left typesetting can see what happens +here, or not? In fact Luigi Scarso pointed out that the \type {fixed} reversed +into {\righttoleft \type {fixed}} but not in the example where {\bf fixed} +becomes {\righttoleft \bf fixed}. This signals an important property of the way +the text gets processed: you input something, at some points font features get +applied (like ligatures) and in the end the resulting glyph stream is reversed. +By that time the combination of {\bf f}+{\bf i} has become {\bf fi}! So, be +prepared for surprises. + This manual is written by a left to right user so don't expect a manual on semitic typesetting. Also don't expect a (yet) complete manual. I'll add whatever comes to mind. This is not a manual about Hebrew or Arabic, if only because I @@ -175,14 +194,18 @@ The sentence \quotation {I have no clue what this means.} is translated (by Google Translate) into \quotation {\ar \righttoleft ليس لدي أي فكرة عما يعنيه هذا.} which is then translated back to \quotation {I have no idea what this means.} so maybe arabic has no clue what a clue is. The suggested Arabic pronunciation is -\quotation {\ar lays laday 'ayu fikrat eamaa yaenih hadha}. Hebrew also likes ideas -more: \quotation {\hr \righttoleft אין לי מושג מה זה אומר}. +\quotation {lays laday 'ayu fikrat eamaa yaenih hadha}. Hebrew also likes ideas +more: \quotation {\he \righttoleft אין לי מושג מה זה אומר}. \stopbuffer \typebuffer \getbuffer +According to Idris Hamid the Arabic should actually be this: \quotation {\ar +لَيْسَ لَدَيَّ أَيُّ فِكْرَةٍ عَمَّا يَعْنِيهِ هٰذَا} and the transliteration \quotation {Laysa +ladayya ayyu fikratin ʿammā yaʿnihi hādhā}. + The \CONTEXT\ (or any \TEX) ecosystem deals with languages and fonts. Languages (that relate to scripts) have specific characteristics, like running from right to left, and fonts provide a repertoire of glyphs and features. There is no real @@ -214,13 +237,13 @@ In addition we set up the languages: The following example demonstrates what the effects of these commands are: \startbuffer -{ليس لدي أي فكرة عما يعنيه هذا.} +{لَيْسَ لَدَيَّ أَيُّ فِكْرَةٍ عَمَّا يَعْنِيهِ هٰذَا.} {אין לי מושג מה זה אומר.} -{\righttoleft ليس لدي أي فكرة عما يعنيه هذا.} +{\righttoleft لَيْسَ لَدَيَّ أَيُّ فِكْرَةٍ عَمَّا يَعْنِيهِ هٰذَا.} {\righttoleft אין לי מושג מה זה אומר.} -{\ar \righttoleft ليس لدي أي فكرة عما يعنيه هذا.} +{\ar \righttoleft لَيْسَ لَدَيَّ أَيُّ فِكْرَةٍ عَمَّا يَعْنِيهِ هٰذَا.} {\he \righttoleft אין לי מושג מה זה אומר.} -{\ar ليس لدي أي فكرة عما يعنيه هذا.} +{\ar لَيْسَ لَدَيَّ أَيُّ فِكْرَةٍ عَمَّا يَعْنِيهِ هٰذَا.} {\he אין לי מושג מה זה אומר.} \stopbuffer @@ -244,7 +267,7 @@ language related settings. It really helps if you properly tag your document content, as in: \starttyping -{\ar ليس لدي أي فكرة عما يعنيه هذا.} +{\ar لَيْسَ لَدَيَّ أَيُّ فِكْرَةٍ عَمَّا يَعْنِيهِ هٰذَا.} {\he אין לי מושג מה זה אומר.} \stoptyping @@ -442,10 +465,10 @@ class nodes. In the \LUA\ interface we still support the: \startitemize[packed] \startitem - \type {LTR} and \type {RTL} keywords for local par nodes + \type {TLT} and \type {TRT} keywords for local par nodes \stopitem \startitem - \type {+LTR}, \type {-LTR}, \type {+RTL} and \type {-RTL} keywords for + \type {+TLT}, \type {-TLT}, \type {+TRT} and \type {-TRT} keywords for direction nodes \stopitem \stopitemize diff --git a/doc/context/sources/general/manuals/luatex/luatex-fonts.tex b/doc/context/sources/general/manuals/luatex/luatex-fonts.tex index ea176d197..ddb64d946 100644 --- a/doc/context/sources/general/manuals/luatex/luatex-fonts.tex +++ b/doc/context/sources/general/manuals/luatex/luatex-fonts.tex @@ -608,6 +608,18 @@ Finally, here is a plain \TEX\ input file with a virtual font demonstration: \typebuffer +\section{The \type {vf} library} + +The \type {vf} library can be used when \LUA\ code, as defined in the \type +{commands} of the font, is executed. The functions provided are similar as the +commands: \type {char}, \type {down}, \type {fontid}, \type {image}, \type +{node}, \type {nop}, \type {pop}, \type {push}, \type {right}, \type {rule}, +\type {special} and \type {pdf}. This library has been present for a while but +not been advertised and tested much, if only because it's easy to define an +invalid font (or mess up the \PDF\ stream). Keep in mind that the \LUA\ snippets +are executed each time when a character is output. + + \section{The \type {font} library} The font library provides the interface into the internals of the font system, diff --git a/doc/context/sources/general/manuals/luatex/luatex-nodes.tex b/doc/context/sources/general/manuals/luatex/luatex-nodes.tex index ee60f6451..f4fd87119 100644 --- a/doc/context/sources/general/manuals/luatex/luatex-nodes.tex +++ b/doc/context/sources/general/manuals/luatex/luatex-nodes.tex @@ -35,6 +35,12 @@ You can ask for a list of fields with the \type {node.fields} (which takes an id and for valid subtypes with \type {node.subtypes} (which takes a string because eventually we might support more used enumerations). +The \type {node.values} function reports some used values. Valid arguments are +\type {dir}, \type {direction}, \type {glue}, \type {pdf_literal}, \type +{pdf_action}, \type {pdf_window} and \type {color_stack}. Keep in mind that the +setters normally expect a number, but this helper gives you a list of what +numbers matter. + \subsection{Attributes} The newly introduced attribute registers are non|-|trivial, because the value |