[latex3-commits] [git/LaTeX3-latex3-babel] docs: Extended Arabic. Hebrew. Installation. (ac8f883)
Javier
email at dante.de
Sun Jun 13 11:25:49 CEST 2021
Repository : https://github.com/latex3/babel
On branch : docs
Link : https://github.com/latex3/babel/commit/ac8f88353499e56f0a18c24459ac53deb7bf4aaa
>---------------------------------------------------------------
commit ac8f88353499e56f0a18c24459ac53deb7bf4aaa
Author: Javier <email at localhost>
Date: Sun Jun 13 11:25:49 2021 +0200
Extended Arabic. Hebrew. Installation.
>---------------------------------------------------------------
ac8f88353499e56f0a18c24459ac53deb7bf4aaa
docs/_includes/menu.html | 3 ++-
docs/guides/locale-arabic.md | 41 ++++++++++++++++++++++++++++++++++++---
docs/guides/locale-bengali.md | 4 ++--
docs/guides/locale-hebrew.md | 21 ++++++++++++++++++++
docs/index.md | 15 +++++++++++++-
docs/media/arabic-sample-dad.png | Bin 0 -> 10087 bytes
6 files changed, 77 insertions(+), 7 deletions(-)
diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index e5e5d20..01199ee 100644
--- a/docs/_includes/menu.html
+++ b/docs/_includes/menu.html
@@ -49,10 +49,11 @@
<li><a href="https://latex3.github.io/babel/guides/using-babel-with-plain.html">Using babel with plain</a></li>
</ul>
</li>
- <li><a href="#">Locales</a>
+ <li><a href="#">Locales (selection)</a>
<ul>
<li><a href="https://latex3.github.io/babel/guides/locale-arabic.html">Arabic</a></li>
<li><a href="https://latex3.github.io/babel/guides/locale-bengali.html">Bengali</a></li>
+ <li><a href="https://latex3.github.io/babel/guides/locale-hebrew.html">Bengali</a></li>
<li><a href="https://latex3.github.io/babel/guides/locale-hindi.html">Hindi</a></li>
</ul>
</li>
diff --git a/docs/guides/locale-arabic.md b/docs/guides/locale-arabic.md
index 7c7fa58..529fd92 100644
--- a/docs/guides/locale-arabic.md
+++ b/docs/guides/locale-arabic.md
@@ -22,15 +22,50 @@ the source code):
\end{document}
```
-
-
There is a complete example (with tables, columns, a figure, a
description, etc.) in the repository
([tex](https://github.com/latex3/babel/blob/main/samples/lua-arabic.tex),
[pdf](https://github.com/latex3/babel/blob/main/samples/lua-arabic.pdf)).
It uses the tentative algorithm for justification with kashida.
-### Useful links
+## Counters
+
+Numerals are best entered directly in the desired
+form, but you may still need some conversion because LaTeX uses internally
+the Western Arabic ones. With `luatex` there are two ways to map the
+latter to the locale numerals, passed as option to `\babelprovide`:
+* `maparabic` does it at the TeX level, by redefining `\arabic`. Note
+ form written to the auxiliary files is the converted one. It works
+ with `xetex`, too.
+* `mapdigits` does it at the engine level. This is
+ usually the preferred method.
+
+## Transliteration
+
+The transform `transliteration.dad` applies the transliteration system
+devised by Yannis Haralambous for
+[`dad`](http://mirrors.ctan.org/language/arabic/dad/dad-user-guide.pdf).
+Not yet complete, but sufficient for many texts.
+
+This method to enter Arabic can be useful if you only need a few words
+in this language:
+```tex
+\documentclass{article}
+
+\usepackage[bidi=basic, ngerman]{babel}
+\babelprovide[transforms = transliteration.dad]{arabic}
+\babelfont{rm}{FreeSerif}
+
+\begin{document}
+
+Eine Präposition (\foreignlanguage{arabic}{Harof}) ist per
+Definition \foreignlanguage{arabic}{maboniY+}.
+
+\end{document}
+```
+
+
+## Useful links
* [Automatic enumerate list using eastern Arabic letters in beamer](https://tex.stackexchange.com/a/599846/5735)
* [Itemize environment in Arabic](https://tex.stackexchange.com/a/528562/5735)
diff --git a/docs/guides/locale-bengali.md b/docs/guides/locale-bengali.md
index c2680f6..91f0f34 100644
--- a/docs/guides/locale-bengali.md
+++ b/docs/guides/locale-bengali.md
@@ -19,7 +19,7 @@ is recommended. Here is a minimal example:
It works with `xetex`, too, with a similar output, but with this engine
there is no need the set the renderer (it’s always Harfbuzz).
-### Counters
+## Counters
Although Bengali numerals are best entered directly in its original
form, you may still need some conversion because LaTeX uses internally
@@ -44,7 +44,7 @@ There is an additional counter:
See the explanation in the babel manual about `\localecounter` and
`localenumeral`.
-### Useful links
+## Useful links
* [How to write Bengali in LaTeX?](https://tex.stackexchange.com/a/599846/5735)
* [Change numbering style to Bengali in nested ordered list](Change
diff --git a/docs/guides/locale-hebrew.md b/docs/guides/locale-hebrew.md
new file mode 100644
index 0000000..b6918a8
--- /dev/null
+++ b/docs/guides/locale-hebrew.md
@@ -0,0 +1,21 @@
+# Hebrew
+
+Hebrew is available for `pdftex`, `xetex`, and `luatex`, but the
+preferred engine is the latter, because of its unique features for
+bidirectional texts, not requiring explicit mark up.
+
+There is a complete example (with a table, a footnote, maths, etc.) in the repository
+([tex](https://github.com/latex3/babel/blob/main/samples/lua-hebrew.tex),
+[pdf](https://github.com/latex3/babel/blob/main/samples/lua-hebrew.pdf)).
+
+For `pdftex` you may need to install separately the [`culmus`
+package](https://www.guyrutenberg.com/culmus-latex/), which is usually
+not included in TeX distributions.
+
+## Useful links
+
+* [Tables with Hebrew text using
+ babel](https://tex.stackexchange.com/questions/558939/tables-with-hebrew-text-using-babel)
+* [Hebrew name
+ typesetting](https://tex.stackexchange.com/a/581010/5735)
+
diff --git a/docs/index.md b/docs/index.md
index 40a5e13..19f0954 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -16,6 +16,20 @@ applicable) and other technologies.
-----------------------
+## Installation
+
+Babel is one of the core components of LaTeX and therefore must be
+available on any LaTeX system. However, support for specific languages
+may require a separate installation in some cases.
+
+Please, refer to the manual of the distribution you have installed,
+which in Windows and MacOS usually involves configuring it with a
+graphical user interface, and in Un*x systems with some command (for
+example, `sudo apt-get install texlive-lang-arabic` for Arabic in
+Ubuntu).
+
+-----------------------
+
## Featured
* [Which method for which language](guides/which-method-for-which-language.html)
@@ -27,7 +41,6 @@ applicable) and other technologies.
* [Useful links to tex.strackexchange](guides/useful-links-to-tex.stackexchange.html)
Examples for many languages: Chinese, Arabic, Sanskrit, etc.
-
---------------------------
## What's new
diff --git a/docs/media/arabic-sample-dad.png b/docs/media/arabic-sample-dad.png
new file mode 100644
index 0000000..8d56da1
Binary files /dev/null and b/docs/media/arabic-sample-dad.png differ
More information about the latex3-commits
mailing list.