[latex3-commits] [git/LaTeX3-latex3-babel] docs: Bengali counters. Links. (3189f56)

[Javier]

Repository : https://github.com/latex3/babel
On branch  : docs
Link       : https://github.com/latex3/babel/commit/3189f5611bf0e8f6aca60ca9137cb14fb8639d64

>---------------------------------------------------------------

commit 3189f5611bf0e8f6aca60ca9137cb14fb8639d64
Author: Javier <email at localhost>
Date:   Sat Jun 12 10:30:21 2021 +0200

    Bengali counters. Links.


>---------------------------------------------------------------

3189f5611bf0e8f6aca60ca9137cb14fb8639d64
 docs/assets/css/style.css     | 10 +++++-----
 docs/guides/locale-arabic.md  | 23 +++++++++++++++++++++--
 docs/guides/locale-bengali.md | 29 ++++++++++++++++++++++++++++-
 docs/index.md                 | 11 +++++++++--
 4 files changed, 63 insertions(+), 10 deletions(-)

diff --git a/docs/assets/css/style.css b/docs/assets/css/style.css
index e113128..ea08a78 100644
--- a/docs/assets/css/style.css
+++ b/docs/assets/css/style.css
@@ -421,24 +421,24 @@ h1 {
 
 h2 {
 	padding-bottom: 10px;
-	font-size: 32px;
+	font-size: 26px;
 	background: url("../images/bg_hr.png") repeat-x bottom
 }
 
 h3 {
-	font-size: 24px
+	font-size: 21px
 }
 
 h4 {
-	font-size: 21px
+	font-size: 18px
 }
 
 h5 {
-	font-size: 18px
+	font-size: 16px
 }
 
 h6 {
-	font-size: 16px
+	font-size: 14px
 }
 
 p {
diff --git a/docs/guides/locale-arabic.md b/docs/guides/locale-arabic.md
index 2209886..5d5939e 100644
--- a/docs/guides/locale-arabic.md
+++ b/docs/guides/locale-arabic.md
@@ -1,6 +1,12 @@
-### Arabic
+## Arabic
 
-Recommended basic settings for a monolingual Arabic document in `luatex` (please, note your browser might not be rendering correctly the source code):
+Arabic 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.
+
+The recommended basic settings for a monolingual Arabic document in
+`luatex` is (please, note your browser might not be rendering correctly
+the source code):
 ```tex
 \documentclass{article}
 
@@ -15,4 +21,17 @@ Recommended basic settings for a monolingual Arabic document in `luatex` (please
 
 \end{document}
 ```
+
 ![](https://user-images.githubusercontent.com/1314536/97981471-a6943300-1dd2-11eb-8f13-3fb5c20dc355.png)
+
+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
+
+* [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 c7db318..c757f29 100644
--- a/docs/guides/locale-bengali.md
+++ b/docs/guides/locale-bengali.md
@@ -16,7 +16,34 @@ is recommended. Here is a minimal example:
 ```
 ![](../media/bengali-sample-luatex.png)
 
-It works with `xetex`, too, with the same output, but with this engine
+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
 
+Although Bengali numerals are best entered directly in its original
+form, you may still need some conversion because LaTeX uses internally
+the Arabic ones. With `luatex` there are two ways to map Arabic to
+Bengali 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.
+  
+To perform this conversión, use the following preamble:
+```
+\usepackage[bengali, provide=*]{babel}
+\babelprovide[mapdigits]{bengali}  % or alternatively maparabic
+\babelfont{rm}[Renderer=Harfbuzz]{FreeSerif}
+```
+
+There is an additional counter:
+* `alphabetic` ▸ ক খ গ ঘ ঙ চ ছ জ ঝ ঞ ট ঠ ড ঢ ণ ত থ দ ধ ন প ফ ব ভ
+
+See the explanation in the babel manual about `\localecounter` and
+`localenumeral`.
+
+### Useful links
+
+* [How to write Bengali in LaTeX?](https://tex.stackexchange.com/a/599846/5735)
diff --git a/docs/index.md b/docs/index.md
index f4ac857..40a5e13 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -4,8 +4,15 @@
 <strong>Localization and internationalization ◾ pdfTeX, LuaTeX and XeTeX</strong>
 </p>
 
-This is the home page for Babel, the multilingual environment for latex
-(and sometimes plain) with the three basic engines (pdfTeX, LuaTeX and XeTeX). Its aim is to provide a localization framework for different languages, scripts, and cultures based on the latest advances in Unicode and other technologies. 
+This is the home page for Babel, the multilingual environment for
+[LaTeX](https://www.latex-project.org/)
+(and sometimes Plain) with the three basic engines (pdfTeX, LuaTeX and
+XeTeX). Its aim is to provide a localization framework for different
+languages, scripts, and cultures based on the latest advances in
+[Unicode](https://home.unicode.org/) (including the
+[CLDR](http://cldr.unicode.org/)), the
+[W3C](https://www.w3.org/groups/wg/i18n-core/publications) (where
+applicable) and other technologies.
 
 -----------------------