[latex3-commits] [git/LaTeX3-latex3-babel] docs: Norwegian. (fb5c8e5)

[Javier]

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

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

commit fb5c8e582af4390c2460585a92d0f54262ee4733
Author: Javier <email at localhost>
Date:   Sat Aug 28 10:46:26 2021 +0200

    Norwegian.


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

fb5c8e582af4390c2460585a92d0f54262ee4733
 docs/_includes/menu.html             |  2 ++
 docs/guides/locale-norwegian.md      | 64 ++++++++++++++++++++++++++++++++++++
 docs/index.md                        |  8 +++--
 docs/news/whats-new-in-babel-3.62.md |  2 ++
 4 files changed, 73 insertions(+), 3 deletions(-)

diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index 535dacc..0f3ae0c 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-3.63.html">3.63</a></li>
       <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.62.html">3.62</a></li>
       <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.61.html">3.61</a></li>
       <li><a href="https://latex3.github.io/babel/news/whats-new-in-babel-3.60.html">3.60</a></li>
@@ -59,6 +60,7 @@
         <li><a href="https://latex3.github.io/babel/guides/locale-czech.html">Czech</a></li>
         <li><a href="https://latex3.github.io/babel/guides/locale-hebrew.html">Hebrew</a></li>
         <li><a href="https://latex3.github.io/babel/guides/locale-hindi.html">Hindi</a></li>
+        <li><a href="https://latex3.github.io/babel/guides/locale-norwegian.html">Norwegian</a></li>
         <li><a href="https://latex3.github.io/babel/guides/locale-thai.html">Thai</a></li>
       </ul>
       </li>
diff --git a/docs/guides/locale-norwegian.md b/docs/guides/locale-norwegian.md
new file mode 100644
index 0000000..fe0fa4a
--- /dev/null
+++ b/docs/guides/locale-norwegian.md
@@ -0,0 +1,64 @@
+# Norwegian
+
+Norwegian(is available for `pdftex`, `xetex`, and `luatex`. An example
+for `pdftex` with the UTF-8 encoding is:
+```tex
+\documentclass{book}
+
+\usepackage[norsk]{babel}
+\usepackage[T1]{fontenc}
+
+\begin{document}
+
+Alle menneske er fødde til fridom og med same menneskeverd og
+menneskerettar. Dei har fått fornuft og samvit og skal leve med
+kvarandre som brør.
+
+\end{document}
+```
+
+With `luatex` and `xetex` remove the line:
+```tex
+\usepackage[T1]{fontenc}
+```
+
+Nynorsk is also available. Just write instead:
+```tex
+\usepackage[nynorsk]{babel}
+```
+
+## Hyphenation
+
+A number of words (a few hundred) require adding a letter when
+hyphenated. In `pdftex` and `xetex` they must be marked explicitly with
+a shorthand, like `volleyba"llandslag` (‘volleyball-landslag’).
+
+With `luatex` no explicit markup is required, because they can be
+added to the exception list with:
+```tex
+\babelhyphenation[norsk]{vol-ley-ba{ll-}{l}{ll}ands-lag}
+```
+Here, the group `{ll-}{l}{ll}` is equivalente to a `\discretionary`.
+Remember you must add every word (like, say, ‘volleyballandslaget’).
+
+Alternatively, you may define a transform, which is more flexible, but
+less efficient. For example:
+```
+\babelposthyphenation{norsk}{ vol|ley|ba()l()lands|la }{
+  { no = l, pre = ll- }
+}
+```
+This rule matches the sequence of characters and hyphenation points in
+the second argument, which explains why the ending ‘g’ has not been
+included —without it, ‘volleyballandslaget’ is also matched.
+
+Furthermore, with transforms hyphenation points can by weighted with
+different penalties, too, as explained in [Non-standard hyphenation
+with
+luatex](https://latex3.github.io/babel/guides/non-standard-hyphenation-with-luatex.html).
+
+Feel free to contribute list a words requiring this feature.
+
+## Useful Links
+
+* [babel-norsk in CTAN](https://ctan.org/pkg/babel-norsk)
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 02d4ccd..77bd910 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -24,9 +24,10 @@ 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).
+graphical user interface, and in Un*x systems with some command, as for
+example `sudo apt-get install texlive-lang-arabic` for Arabic in
+Ubuntu. (Note some Linux distros install outdated versions. In such a
+case, it's advisable to install TeXLive.)
 
 -----------------------
 
@@ -47,6 +48,7 @@ Ubuntu).
 
 | Version | Most relevant changes
 | --- | --- |
+| [3.63](news/whats-new-in-babel-3.63.html) | Fixes a severe bug with CJK and XeTeX.
 | [3.62](news/whats-new-in-babel-3.62.html) | Preliminary support for `\AddToHook`.
 | [3.61](news/whats-new-in-babel-3.61.html) | Transform `danda.nobreak`. Improved Arabic justification.
 | [3.60](news/whats-new-in-babel-3.60.html) | Mainly a maintenance release.
diff --git a/docs/news/whats-new-in-babel-3.62.md b/docs/news/whats-new-in-babel-3.62.md
index a9d7a2d..a4d6632 100644
--- a/docs/news/whats-new-in-babel-3.62.md
+++ b/docs/news/whats-new-in-babel-3.62.md
@@ -4,6 +4,8 @@
 
 Most changes in this version are minor improvements in the code. 
 
+⚠ This version introduced a severe bug in XeTeX with CJK, fixed in 3.63.
+
 ## Unknown languages in auxiliary files
 
 A warning is shown instead of raising an error if a language is not