summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorHans Hagen <pragma@wxs.nl>2018-02-19 19:19:07 +0100
committerContext Git Mirror Bot <phg42.2a@gmail.com>2018-02-19 19:19:07 +0100
commit9bb459e9fedcad94579973ccd07ad9e78d0734c8 (patch)
treee01ac3174e8891a6e6004c88cb46f220312a2bfc /doc
parent5321d35d68ce0acb71b46bddac1d8cab8eca3fcc (diff)
downloadcontext-9bb459e9fedcad94579973ccd07ad9e78d0734c8.tar.gz
2018-02-19 19:05:00
Diffstat (limited to 'doc')
-rw-r--r--doc/context/documents/general/manuals/bidi.pdfbin115048 -> 136420 bytes
-rw-r--r--doc/context/documents/general/manuals/luatex.pdfbin1170248 -> 1172111 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-cs.pdfbin844123 -> 844203 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-de.pdfbin843997 -> 844058 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-en.pdfbin848553 -> 848575 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-fr.pdfbin839957 -> 840030 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-it.pdfbin845771 -> 845804 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-cs.pdfbin359124 -> 359140 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-de.pdfbin438419 -> 438432 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-en.pdfbin356632 -> 356642 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-fr.pdfbin359378 -> 359388 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-it.pdfbin358170 -> 358190 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-nl.pdfbin357817 -> 357830 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-mapping-ro.pdfbin624610 -> 624626 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-nl.pdfbin837109 -> 837135 bytes
-rw-r--r--doc/context/documents/general/qrcs/setup-ro.pdfbin840058 -> 840092 bytes
-rw-r--r--doc/context/sources/general/manuals/bidi/bidi.tex81
-rw-r--r--doc/context/sources/general/manuals/luatex/luatex-fonts.tex12
-rw-r--r--doc/context/sources/general/manuals/luatex/luatex-nodes.tex6
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
index 8550e5fd4..0d88c7de7 100644
--- a/doc/context/documents/general/manuals/bidi.pdf
+++ b/doc/context/documents/general/manuals/bidi.pdf
Binary files differ
diff --git a/doc/context/documents/general/manuals/luatex.pdf b/doc/context/documents/general/manuals/luatex.pdf
index 77db079d5..26af7ac71 100644
--- a/doc/context/documents/general/manuals/luatex.pdf
+++ b/doc/context/documents/general/manuals/luatex.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-cs.pdf b/doc/context/documents/general/qrcs/setup-cs.pdf
index 871517201..432c0f4c3 100644
--- a/doc/context/documents/general/qrcs/setup-cs.pdf
+++ b/doc/context/documents/general/qrcs/setup-cs.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-de.pdf b/doc/context/documents/general/qrcs/setup-de.pdf
index 706ad5cea..773140962 100644
--- a/doc/context/documents/general/qrcs/setup-de.pdf
+++ b/doc/context/documents/general/qrcs/setup-de.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-en.pdf b/doc/context/documents/general/qrcs/setup-en.pdf
index 7c655f08a..e20173696 100644
--- a/doc/context/documents/general/qrcs/setup-en.pdf
+++ b/doc/context/documents/general/qrcs/setup-en.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-fr.pdf b/doc/context/documents/general/qrcs/setup-fr.pdf
index 39356d60b..e54348de5 100644
--- a/doc/context/documents/general/qrcs/setup-fr.pdf
+++ b/doc/context/documents/general/qrcs/setup-fr.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-it.pdf b/doc/context/documents/general/qrcs/setup-it.pdf
index 06020527c..3a4344aad 100644
--- a/doc/context/documents/general/qrcs/setup-it.pdf
+++ b/doc/context/documents/general/qrcs/setup-it.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf
index 13e06cbfe..79339c817 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-de.pdf b/doc/context/documents/general/qrcs/setup-mapping-de.pdf
index 72afbb69e..cf6e35653 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-de.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-de.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-en.pdf b/doc/context/documents/general/qrcs/setup-mapping-en.pdf
index 2e141dcbd..d0c223e7d 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-en.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-en.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf
index baa3fec16..813e89679 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-it.pdf b/doc/context/documents/general/qrcs/setup-mapping-it.pdf
index a4007450c..b3298becc 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-it.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-it.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf
index 75dba641e..748bafafe 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf
index 339fe2e10..0ee1e3a5f 100644
--- a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf
+++ b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-nl.pdf b/doc/context/documents/general/qrcs/setup-nl.pdf
index 39ebff455..b164996e8 100644
--- a/doc/context/documents/general/qrcs/setup-nl.pdf
+++ b/doc/context/documents/general/qrcs/setup-nl.pdf
Binary files differ
diff --git a/doc/context/documents/general/qrcs/setup-ro.pdf b/doc/context/documents/general/qrcs/setup-ro.pdf
index 6b8570642..7651786e2 100644
--- a/doc/context/documents/general/qrcs/setup-ro.pdf
+++ b/doc/context/documents/general/qrcs/setup-ro.pdf
Binary files differ
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