[latex3-commits] [latex3/babel] docs: 24.11 (99459c3)
github at latex-project.org
github at latex-project.org
Sat Oct 5 10:30:05 CEST 2024
Repository : https://github.com/latex3/babel
On branch : docs
Link : https://github.com/latex3/babel/commit/99459c370f15c7ee2a28895cc3ea9307d95cc544
>---------------------------------------------------------------
commit 99459c370f15c7ee2a28895cc3ea9307d95cc544
Author: Javier <email at localhost>
Date: Sat Oct 5 10:30:05 2024 +0200
24.11
>---------------------------------------------------------------
99459c370f15c7ee2a28895cc3ea9307d95cc544
docs/_includes/menu.html | 6 +----
docs/index.md | 47 ++++++++++++++++++-----------------
docs/news/whats-new-in-babel-24.11.md | 41 +++++++++++++++++++-----------
3 files changed, 51 insertions(+), 43 deletions(-)
diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index 3de6d47..8ad5b8b 100644
--- a/docs/_includes/menu.html
+++ b/docs/_includes/menu.html
@@ -6,6 +6,7 @@
<!-- -->
<li><a href="#">News</a>
<ul>
+ <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.11.html">24.11</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.10.html">24.10</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.9.html">24.9</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-24.8.html">24.8</a></li>
@@ -23,11 +24,6 @@
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.95.html">3.95</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.94.html">3.94</a></li>
<li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.93.html">3.93</a></li>
- <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.92.html">3.92</a></li>
- <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.91.html">3.91</a></li>
- <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.90.html">3.90</a></li>
- <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.89.html">3.89</a></li>
- <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.88.html">3.88</a></li>
</ul>
</li>
<!-- -->
diff --git a/docs/index.md b/docs/index.md
index 9f6d208..9b07214 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -13,23 +13,34 @@ based on the **latest advances in
[CLDR](http://cldr.unicode.org/)), the
[W3C](https://www.w3.org/groups/wg/i18n-core/publications) (where
applicable) and other technologies, as well as on **international
-standards** for better compatibility and consistency.
+standards** for better compatibility and consistency. Find the [PDF manual
+here](http://mirrors.ctan.org/macros/latex/required/babel/base/babel.pdf).
Babel currently supports approximately **300 languages** (with various
levels of coverage) across about **45 scripts, including complex and
-RTL** ones like Arabic, Chinese, Tibetan and Devanagari. Its high-level
-interface with `fontspec` allows for seamless integration with
-**OpenType** technologies in `xetex` and `luatex`, enabling effortless
-use of advanced typographic features, and fine-grained control and
-customization. Additionally, lazy locale and font loading facilitate
-integration into **automated document generation workflows**, and makes
-it adept at handling complex documents with **multiple languages**.
+RTL** ones like
+[Arabic](https://latex3.github.io/babel/guides/locale-arabic.html),
+[Chinese](https://latex3.github.io/babel/guides/locale-chinese.html),
+[Tibetan](https://latex3.github.io/babel/news/whats-new-in-babel-3.81.html)
+and
+[Devanagari](https://latex3.github.io/babel/guides/locale-hindi.html).
+Its high-level interface with
+[`fontspec`](https://ctan.org/pkg/fontspec?lang=en) allows for seamless
+integration with **OpenType** technologies in `xetex` and `luatex`,
+enabling effortless use of advanced typographic features, and
+fine-grained control and customization. Additionally, lazy locale and
+font loading facilitate integration into **automated document
+generation workflows**, and makes it adept at handling complex
+documents with **multiple languages**.
Many locales in Babel are built on a **modern core** that utilizes
-descriptive `ini` files. This design **simplifies the customization** of
-hyphenation and line breaking, captions, date formats (across various
-calendars), spacing and other language-specific typographical rules,
-and so on.
+descriptive `ini` files. This design [simplifies the tailoring and
+customization](guides/using-babelprovide-to-modify-or-extend-locales.html)
+of languages, thanks to tools that provide highly precise control over
+[hyphenation and line
+breaking](guides/non-standard-hyphenation-with-luatex.html), captions,
+date formats (across various calendars), spacing, and other
+locale-specific typographical rules.
-----------------------
@@ -52,10 +63,6 @@ case, it's advisable to install TeXLive.)
* [Which method for which language](guides/which-method-for-which-language.html)
When to use the old good language files and when `\babelprovide` or `provide=*`.
-* [Non-standard hyphenation with luatex](guides/non-standard-hyphenation-with-luatex.html)
- Explains how to define special hyphenation rules like `ff` → `ff-f`
-* [Using \babelprovide to modify or extend locales](guides/using-babelprovide-to-modify-or-extend-locales.html)
- Hints on how to tailor your language to your needs in some frequent cases.
* [Useful links to tex.strackexchange](guides/useful-links-to-tex.stackexchange.html)
Examples for many languages: Chinese, Arabic, Sanskrit, etc.
@@ -65,6 +72,7 @@ case, it's advisable to install TeXLive.)
| Version | Most relevant changes
| --- | --- |
+| [24.11](news/whats-new-in-babel-24.11.html) | Manual revised. Transform variables. |
| [24.10](news/whats-new-in-babel-24.10.html) | `\localename`, `\mainlocalename`, `\babelhyphenmins` |
| [24.9](news/whats-new-in-babel-24.9.html) | Transforms: `digits.native`, CJK spacing (tentative). |
| [24.8](news/whats-new-in-babel-24.8.html) | `\BabelWrapText` and hook `foreign`. |
@@ -141,13 +149,6 @@ case, it's advisable to install TeXLive.)
| [3.36](news/whats-new-in-babel-3.36.html) | Polytonic Greek. Improvements in Chinese. |
| [3.35](news/whats-new-in-babel-3.35.html) | Shorthands work in bibs and refs even with `safe=none`. |
-## More
-
-* [Keys in ini files](guides/keys-in-ini-files.html)
-* [List of locale templates](guides/list-of-locale-templates.html)
-* [Old and deprecated functions](guides/old-and-deprecated-functions.html)
-* [Using babel with plain](guides/using-babel-with-plain.html)
-
## External links
* [Getting Started with Internationalization
diff --git a/docs/news/whats-new-in-babel-24.11.md b/docs/news/whats-new-in-babel-24.11.md
index b0fdea3..916c674 100644
--- a/docs/news/whats-new-in-babel-24.11.md
+++ b/docs/news/whats-new-in-babel-24.11.md
@@ -1,29 +1,40 @@
# What's new in babel 24.11
-**Draft**
+2024-10-05
## Manual thoroughly revised
-It’s a work in progress, but a good deal of obsolete comments have been
-updated, sections have been reorganized, and some explanations have been
-extended. There are also more examples.
+The manual is still being refined, but many outdated comments have been
+revised or directly deleted, sections restructured, and certain
+explanations expanded. Additionally, a greater number of examples have
+been included.
-The layout is also somewhat different — macro and environment names are not
-set in the margin anymore.
+The design has also changed slightly — names of macros and environments
+are no longer placed in the margins.
## Transform variables
-Values in some transforms are hardcoded in the `ini` files and cannot
-be modified. Now a new feature in introduced to readjust them. No `ini`
-has been modified yet, but CJK languages (for proper margin alignment),
-French (spaces with punctuation) and Tibetan (for traditional
-justification) will be extended soon.
+Previously, values for some transforms were fixed in the `ini` files
+and unchangeable. A new feature has now been introduced to allow
+adjustments (specifically numeric parameters in prehyphenation). While
+no `ini` file has been altered yet, updates for Chinese languages (to
+align margins correctly), Japanese (also small kana), French (spacing
+with punctuation), and Tibetan (for traditional text justification) are
+planned for the near future.
-Only numeric parameters in prehyphenation.
+This applies solely to numeric parameters in prehyphenation.
+
+In the transforms section of `ìni` files, a value of
+`{<variable-name>|<default>}` employs the variable as set by
+`\SetTransformValue{<locale-name>}{<variable-name>}{<value>}`. If the
+variable is undefined (or its value is `nil`), the `default` is used
+instead.
+
+## Other changes
+
+Updated the internal list of RTL scripts to add Garay, Todhri, Elymaic,
+Yazidi, and a few more.
-`{variable|default}`: uses the variable as defined by
-\SetTransformValue{<locale-name>}{<variable-name>}{<value>}. If the
-variable is not defined (or its value is `nil`), use the default value.
More information about the latex3-commits
mailing list.