Pedro Andres Aranda Gutierrez <[email protected]> writes:
>> sometimes *need* more than one font, or you won't get the document
>> rendered in full; (2) explain what those fonts are and what they are
>> used for.
>>
>> The existing version only says that user /may/ define 4 fonts, but it is
>> not very clear when and why you would need that.
>>
>
> Let's see if the last commit is more inline with your wishes...
That's better. Thanks!
I also have a couple of suggestions on top. See the attached.
I also played around with your example document (+ =тук= тук)
and noticed that while the warning about missing characters is issued,
nothing is printing in the *Messages* buffer, despite the manual
claiming
In this case, the LaTeX compiler will fail and Emacs will warn you. To
help you, the LaTeX export process always prints a list of scripts in
the *~*Messages*~* buffer.
Maybe we should expand the script scanner to all characters, not just to
a subset we do now?
>From 8f23faf3c034002805165ecd7ad622524c4a69a1 Mon Sep 17 00:00:00 2001
Message-ID: <8f23faf3c034002805165ecd7ad622524c4a69a1.1766772526.git.yanta...@posteo.net>
From: Ihor Radchenko <[email protected]>
Date: Fri, 26 Dec 2025 19:08:16 +0100
Subject: [PATCH] doc/org-manual.org: Another round of suggestions
---
doc/org-manual.org | 27 ++++++++++++++++-----------
1 file changed, 16 insertions(+), 11 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index 4ed971b66..cef86ef52 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -15055,11 +15055,15 @@ *** Different languages and character sets in LaTeX export
These are normally mapped to system fonts in the document class you
use. However, you may need to change them, for example if the
default fonts don't support the character set or sets used in your
- document. Additionally, you can also provide fall-backs in specific
- cases. See [[#lualatex-fontspec]] for more details. Note that
- ~fontspec~ does not work with the =pdflatex= compiler. For =pdflatex=,
- you only can control fonts using font packages provided with your
- LaTeX distribution (cf. [[#pdflatex-fonts]]).
+ document. Org mode will show a warning if your document contains
+ characters that cannot be rendered with the selected or default fonts
+ upon export.
+
+ You can also provide fall-backs in specific cases. See
+ [[#lualatex-fontspec]] for more details. Note that ~fontspec~ does
+ not work with the =pdflatex= compiler. For =pdflatex=, you can only
+ control fonts using font packages provided with your LaTeX
+ distribution (cf. [[#pdflatex-fonts]]).
We recommend using =lualatex= or =xelatex= for reliable non-Latin
language support and using Unicode fonts that include
@@ -15134,7 +15138,7 @@ *** Font configuration for LuaLaTeX and XeLaTeX
. ((org-latex-unicode-math-options . "math-style=upright"))))
#+END_SRC
-You can also set ~org-latex-multi-lang~ or the ~LATEX_MULTI_LANG~
+You can also set ~org-latex-multi-lang~ or the =LATEX_MULTI_LANG=
option to either ~polyglossia~ or ~babel~. These LaTeX packages load
~fontspec~ internally. When using ~polyglossia~, you can combine
~fontspec~ and ~polyglossia~-specific configuration. Font
@@ -15152,12 +15156,13 @@ **** Configuration of the ~fontspec~ package
#+vindex: org-latex-fontspec-default-features
Org mode uses the variable ~org-latex-fontspec-config~ to map your
-document's fonts to the fonts used in the generated PDF document. To
-familiarize yourself with fonts and options, read the
+document's fonts to the fonts used in the generated PDF document.This
+variable can be set in your Emacs initialization code, in the file
+local variables or in the directory local variable file
+~.dir-locals.el~[fn:54]. To familiarize yourself with fonts and
+options, read the
[[http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf][~fontspec~
-package manual]] Part II. This variable can be set in your Emacs
-initialization code, in the file local variables or in the directory
-local variable file ~.dir-locals.el~[fn:54].
+package manual]] Part II.
~org-latex-fontspec-config~ maps the font family name used by LaTeX to
the font used in the PDF output and optional font features. LaTeX
--
2.52.0
--
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
