diff --git a/docs/_includes/menu.html b/docs/_includes/menu.html
index a07e1a6d..3e144da6 100644
--- a/docs/_includes/menu.html
+++ b/docs/_includes/menu.html
@@ -34,7 +34,8 @@
3.36
3.35
-->
-
+
+
Guides
-
diff --git a/docs/assets/css/style.css b/docs/assets/css/style.css
index b771d92c..8e9f9a2e 100644
--- a/docs/assets/css/style.css
+++ b/docs/assets/css/style.css
@@ -275,7 +275,7 @@
}
.highlight {
- background-color: #f8f8f8
+ /* background-color: #f8f8f8 */
}
html,
@@ -415,7 +415,8 @@ h6 {
h1 {
font-size: 36px;
- font-weight: 700
+ font-weight: 700;
+ padding-top: 10px
}
h2 {
@@ -511,7 +512,7 @@ code {
color: #222;
background-color: #fff;
font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
- font-size: 14px;
+ font-size: 90%;
border-radius: 2px;
-moz-border-radius: 2px;
-webkit-border-radius: 2px
@@ -523,9 +524,19 @@ pre {
overflow: auto
}
+h1 code {
+ font-size: 80%
+}
+h2 code {
+ font-size: 80%
+}
+h3 code {
+ font-size: 80%
+}
+
code {
- padding: 3px;
- margin: 0 3px;
+ padding: 3px;
+ /* margin: 0 3px; */
box-shadow: 0 0 10px rgba(0, 0, 0, 0.1)
}
@@ -594,7 +605,7 @@ th {
}
td {
- padding: 10px;
+ padding: 5px;
border: 1px solid #373737
}
@@ -609,7 +620,7 @@ form {
.inner {
position: relative;
- max-width: 640px;
+ max-width: 660px;
padding: 20px 10px;
margin: 0 auto
}
@@ -702,7 +713,7 @@ form {
}
#main_content_wrap {
- background: #f2f2f2;
+ background: #f9f9f9;
border-top: 1px solid #111;
border-bottom: 1px solid #111
}
@@ -736,7 +747,8 @@ form {
font-size: 32px
}
h1 {
- font-size: 28px
+ font-size: 28px;
+ padding-top: 10px
}
h2 {
font-size: 24px
@@ -774,7 +786,8 @@ form {
font-size: 28px
}
h1 {
- font-size: 24px
+ font-size: 24px;
+ padding-top: 10px
}
h2 {
font-size: 21px
@@ -800,7 +813,7 @@ form {
}
nav.top {
- margin: 130px 0;
+ margin: 140px 0;
background-color: #007070;
position: absolute;
top: 6mm;
diff --git a/docs/guides/locales-arabic.md b/docs/guides/locales-arabic.md
new file mode 100644
index 00000000..22098867
--- /dev/null
+++ b/docs/guides/locales-arabic.md
@@ -0,0 +1,18 @@
+### Arabic
+
+Recommended basic settings for a monolingual Arabic document in `luatex` (please, note your browser might not be rendering correctly the source code):
+```tex
+\documentclass{article}
+
+\usepackage[arabic, provide=*, bidi=basic, layout=counters.tabular]{babel}
+\babelfont{rm}[Renderer=Harfbuzz]{FreeSerif}
+
+\begin{document}
+
+الموسيقى أو الموسيقا هي فن مؤلف من الأصوات والسكوت عبر فترة زمنية،
+ويعتقد العلماء بأن كلمة الموسيقى يونانية الأصل، وقد كانت تعني سابقا
+الفنون عموما غير أنها أصبحت فيما بعد تطلق على لغة الألحان فقط.
+
+\end{document}
+```
+
diff --git a/docs/guides/which-method-for-which-language.md b/docs/guides/which-method-for-which-language.md
index bf12507e..055bb857 100644
--- a/docs/guides/which-method-for-which-language.md
+++ b/docs/guides/which-method-for-which-language.md
@@ -1,8 +1,19 @@
# Which method for which language
-_Document under development. Only XeTeX and LuaTeX._ (I like to thank Loren Davis for his help in preparing this page, including the list of additional fonts.)
+Since currently there are two methods to load a language, here is a short
+explanation on how to do it, with info about basic fonts, so that you
+can setup quickly a document. There are also pages on specific locales
+in the menu above
-**Index** [Loading the language](#loading-the-language) • [Fonts](#fonts) • [Examples](#examples)
+See also the [examples
+here](https://github.com/latex3/babel/tree/main/samples) for languages
+like Arabic, Thai, Hebrew, Polytonic Greek, Japanese, and Malayalam,
+among others.
+
+_I'd like to thank Loren Davis for his help in preparing this page,
+including the list of additional fonts._
+
+**Index** [Loading the language](#loading-the-language) • [Fonts](#fonts)
--------------------------
@@ -74,37 +85,9 @@ There are also some fine fonts out there, but you must install them because they
You may also want to have a look at some articles on tex.textackexchange on [Arabic](https://tex.stackexchange.com/questions/314202/overview-of-arabic-fonts-available-for-latex-xetex)
-----------------------
-
-## Examples
-
-Some examples follow (well, not yet). Remember there are [examples here](https://github.com/latex3/babel/tree/master/samples).
-
-### Arabic
-
-Recommended basic settings for a monolingual Arabic document in `luatex` (please, note your browser might not be rendering correctly the source code):
-```tex
-\documentclass{article}
-
-\usepackage[arabic, provide=*, bidi=basic, layout=counters.tabular]{babel}
-\babelfont{rm}[Renderer=Harfbuzz]{FreeSerif}
-
-\begin{document}
-
-الموسيقى أو الموسيقا هي فن مؤلف من الأصوات والسكوت عبر فترة زمنية،
-ويعتقد العلماء بأن كلمة الموسيقى يونانية الأصل، وقد كانت تعني سابقا
-الفنون عموما غير أنها أصبحت فيما بعد تطلق على لغة الألحان فقط.
-
-\end{document}
-```
-
-### (...)
-
-------------------------
-*Under development*
-
-Monolingual documents
+## Recommended options for monolingual documents
| Language | Method | Font | Additional package options (lua) | xe | Notes |
| --- | --- | --- | --- | --- | --- |