From: Ihor Radchenko <[email protected]> To: "Pedro A. Aranda" <[email protected]> Cc: Org Mode List <[email protected]> Subject: Re: Status of the all-tex-fonts feature branch Date: Sun, 12 Oct 2025 08:56:43 +0000 [thread overview] Message-ID: <87wm50wlcb.fsf@localhost> (raw) In-Reply-To: <[email protected]> "Pedro A. Aranda" <[email protected]> writes: > I have split the commit in two (apart from minor stylistic quirks). The > first big commit is a rewrite based on comments of the head of the > section and the second is a modified version on the LaTeX markups which > were missing. Thanks! Let me then detail the critical points I tried to address in my suggested patch and that are still missing (IMHO). > LaTeX was initially developed to handle documents written primally > in English. As long as you don't need localisation, you can use it > as-is with any language that uses the Latin character set. As a > general rule, most LaTeX classes include standard font settings that > work well in this situation. I am not sure if referring to "localization" is entirely clear to people unfamiliar with LaTeX. If someone does not get the implications of localization (names, punctuation rules), they may read this paragraph as if any Latin language will work auto-magically. > Languages using non-Latin character > sets will need font configuration, which will vary depending on the > LaTeX compiler and multi-language support package you use. This sounds like you focus on fonts only. But I think that it is also important to talk about localization. > Non-English and multi-language documents use the LaTeX packages > =babel= or =polyglossia= to localise document features like the > table of contents, dates, hyphenation, etc. Maybe "need to use"? Also, after previous sentence focuses on fonts, this reads weird. > By default, LaTeX only loads the fonts appropriate for Latin > characters. Non-Latin characters in the document are often not > rendered correctly without loading a custom font This is repeating the first paragraph. > =pdflatex= relies > on LaTeX packages you need to include using the =#+LATEX_HEADER:= > keyword Here, and elsewhere in the manual, I think that it is better to talk about export settings rather than directly asking to use keywords. That's because export settings may e configured through variables, not just via keywords. > =LATEX_MULTI_LANG= is ~nil~ by default to handle localisation > manually as described at the end of this section. This is ok, but I feel that users may be confused reading this. That's why my variant included a short explanation on why the default is nil. Also, in similar fashion, maybe also move "fontspec" description towards the end? I think that users should use babel/polyglossia if they can and only fall back to fontspec/nil when they have to. > In general, when exporting to LaTeX or PDF, we recommend > using a Unicode font set that covers the scripts you use in your > document. This will simplify the font configuration. This is repeating what we say in one of the previous paragraphs. > When =#+LATEX_MULTI_LANG= is either ~babel~ or ~polyglossia~, Org > mode will use the indicated LaTeX package to handle multi-language > support. Either should be used for non-English documents. Both > provide setting up your font configuration globally for your > document and on a per-language basis > ... > See [[#lualatex-polyglossia]] and [[#babel-fontconfig]] for more > details about how to configure fonts using ~babel~ and > ~polyglossia~. Note that ~polyglossia~ does not work with > =pdflatex= compiler. We recommend using =lualatex= or =xelatex= for > reliable non-Latin language support. Reading the first paragraph, I can see people concluding that font configuration is automatic with babel and polyglossia, while in reality fonts must be configured in addition to setting LATEX_MULTI_LANG. Finally, any reason you dropped by examples with including secondary language? I think that it needs to be explained for completeness. Because there is no way users know what to do without knowing latex. -- 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>
next prev parent reply other threads:[~2025-10-12 8:56 UTC|newest]
Thread overview: 208+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-06-23 5:46 Status of the all-tex-fonts feature branch Pedro Andres Aranda Gutierrez
2025-06-29 8:21 ` Ihor Radchenko
2025-06-29 8:51 ` Pedro Andres Aranda Gutierrez
2025-06-29 16:59 ` Pedro Andres Aranda Gutierrez
2025-06-29 18:02 ` Ihor Radchenko
2025-06-30 6:41 ` Pedro Andres Aranda Gutierrez
2025-06-30 10:35 ` Pedro Andres Aranda Gutierrez
2025-06-30 17:32 ` Ihor Radchenko
2025-07-01 5:28 ` Pedro Andres Aranda Gutierrez
2025-07-02 16:03 ` Pedro Andres Aranda Gutierrez
2025-07-04 7:44 ` Pedro Andres Aranda Gutierrez
2025-07-06 17:35 ` Ihor Radchenko
2025-07-07 7:55 ` Pedro Andres Aranda Gutierrez
2025-07-07 16:26 ` Ihor Radchenko
2025-07-06 17:11 ` Ihor Radchenko
2025-06-30 17:50 ` Ihor Radchenko
2025-07-01 5:20 ` Pedro Andres Aranda Gutierrez
2025-07-06 17:15 ` Ihor Radchenko
2025-07-15 17:22 ` Ihor Radchenko
2025-07-16 6:08 ` Pedro Andres Aranda Gutierrez
2025-07-16 7:41 ` Pedro Andres Aranda Gutierrez
2025-07-17 10:57 ` Max Nikulin
2025-07-17 15:18 ` Pedro Andres Aranda Gutierrez
2025-07-19 14:11 ` Ihor Radchenko
2025-07-17 15:23 ` Pedro Andres Aranda Gutierrez
2025-07-17 15:39 ` Pedro Andres Aranda Gutierrez
2025-07-17 15:59 ` Pedro Andres Aranda Gutierrez
2025-07-19 14:27 ` Ihor Radchenko
2025-07-19 15:37 ` Pedro Andres Aranda Gutierrez
2025-07-19 15:44 ` Ihor Radchenko
2025-07-19 15:45 ` Ihor Radchenko
2025-07-22 8:11 ` Pedro Andres Aranda Gutierrez
2025-07-27 13:02 ` Ihor Radchenko
2025-07-28 5:50 ` Pedro Andres Aranda Gutierrez
2025-07-28 7:00 ` Pedro Andres Aranda Gutierrez
2025-07-28 17:48 ` Ihor Radchenko
2025-07-29 5:17 ` Pedro Andres Aranda Gutierrez
2025-07-30 7:05 ` Pedro Andres Aranda Gutierrez
2025-07-30 7:07 ` Ihor Radchenko
2025-09-27 11:28 ` Ihor Radchenko
2025-09-27 18:49 ` Pedro Andres Aranda Gutierrez
2025-09-28 5:15 ` Pedro Andres Aranda Gutierrez
2025-09-28 12:59 ` Ihor Radchenko
2025-09-29 5:32 ` Pedro Andres Aranda Gutierrez
2025-09-29 6:36 ` Pedro Andres Aranda Gutierrez
2025-09-29 8:54 ` Pedro Andres Aranda Gutierrez
2025-09-29 9:49 ` Ihor Radchenko
2025-09-30 6:19 ` Pedro Andres Aranda Gutierrez
2025-10-03 18:12 ` Ihor Radchenko
2025-10-04 5:39 ` Pedro Andres Aranda Gutierrez
2025-10-04 6:43 ` Ihor Radchenko
2025-10-04 8:19 ` Pedro Andres Aranda Gutierrez
2025-10-04 8:53 ` Ihor Radchenko
2025-10-04 10:13 ` Pedro Andres Aranda Gutierrez
2025-10-04 10:45 ` Pedro Andres Aranda Gutierrez
2025-10-04 12:20 ` Ihor Radchenko
2025-10-04 14:36 ` Pedro Andres Aranda Gutierrez
2025-10-04 18:01 ` Ihor Radchenko
2025-10-05 5:17 ` Pedro Andres Aranda Gutierrez
2025-10-05 9:39 ` Ihor Radchenko
2025-10-05 15:15 ` Pedro Andres Aranda Gutierrez
2025-10-05 18:48 ` Ihor Radchenko
2025-10-06 6:12 ` Pedro Andres Aranda Gutierrez
2025-10-06 15:25 ` Ihor Radchenko
2025-10-06 16:09 ` Pedro Andres Aranda Gutierrez
2025-10-06 17:06 ` Ihor Radchenko
2025-10-07 5:32 ` Pedro Andres Aranda Gutierrez
2025-10-07 16:58 ` Ihor Radchenko
2025-10-08 6:13 ` Pedro Andres Aranda Gutierrez
2025-10-11 11:50 ` Ihor Radchenko
2025-10-11 17:12 ` Pedro Andres Aranda Gutierrez
2025-10-12 7:10 ` Pedro A. Aranda
2025-10-12 8:56 ` Ihor Radchenko [this message]
2025-10-12 8:57 ` Ihor Radchenko
2025-10-12 9:14 ` Ihor Radchenko
[not found] ` <CAO48Bk9hxtk_n+AwgyuF+YxO3nMf94EjBa=JVfY8G6s3pgk1zQ@mail.gmail.com>
2025-10-12 11:01 ` Ihor Radchenko
2025-10-12 15:40 ` Pedro Andres Aranda Gutierrez
2025-10-12 17:08 ` Pedro Andres Aranda Gutierrez
2025-10-12 18:55 ` Ihor Radchenko
2025-10-13 5:36 ` Pedro Andres Aranda Gutierrez
2025-10-16 17:23 ` Ihor Radchenko
2025-10-17 6:25 ` Pedro Andres Aranda Gutierrez
2025-10-17 16:53 ` Ihor Radchenko
2025-10-18 8:30 ` Pedro Andres Aranda Gutierrez
2025-10-18 9:29 ` Ihor Radchenko
2025-10-18 16:50 ` Pedro Andres Aranda Gutierrez
2025-10-18 17:25 ` Ihor Radchenko
2025-10-18 19:03 ` Pedro Andres Aranda Gutierrez
2025-10-19 8:28 ` Ihor Radchenko
2025-10-19 8:43 ` Pedro Andres Aranda Gutierrez
2025-10-19 6:27 ` Pedro Andres Aranda Gutierrez
2025-10-19 8:25 ` Ihor Radchenko
2025-10-21 17:57 ` Ihor Radchenko
2025-10-22 5:48 ` Pedro A. Aranda
2025-10-22 16:55 ` Ihor Radchenko
[not found] ` <[email protected]>
2025-10-23 15:22 ` Fwd: " Pedro Andres Aranda Gutierrez
2025-10-23 17:16 ` Ihor Radchenko
2025-10-24 6:07 ` Pedro Andres Aranda Gutierrez
2025-10-24 18:27 ` Ihor Radchenko
2025-10-25 6:09 ` Pedro Andres Aranda Gutierrez
2025-10-25 10:13 ` Ihor Radchenko
2025-10-25 10:55 ` Pedro Andres Aranda Gutierrez
2025-10-25 12:14 ` Ihor Radchenko
2025-10-25 14:27 ` Pedro Andres Aranda Gutierrez
2025-10-25 15:10 ` Ihor Radchenko
2025-10-30 6:31 ` Pedro Andres Aranda Gutierrez
2025-11-01 13:23 ` Ihor Radchenko
2025-11-02 7:44 ` Pedro A. Aranda
2025-11-02 11:27 ` Ihor Radchenko
[not found] ` <[email protected]>
[not found] ` <87346unccd.fsf@localhost>
2025-11-07 17:27 ` Pedro Andres Aranda Gutierrez
2025-11-07 18:51 ` Ihor Radchenko
2025-11-08 7:12 ` Pedro Andres Aranda Gutierrez
2025-11-08 10:10 ` Ihor Radchenko
2025-11-08 16:32 ` Pedro Andres Aranda Gutierrez
2025-11-08 20:37 ` Ihor Radchenko
2025-11-09 7:15 ` Pedro Andres Aranda Gutierrez
[not found] ` <CAO48Bk-YH_9cjjeDogH57SFf4WmOC4CaiRv4zVpTYZ=Y+mUgAQ@mail.gmail.com>
2025-11-09 10:58 ` Fwd: " Huang Jing
2025-11-09 12:21 ` Ihor Radchenko
2025-11-09 13:34 ` Huang Jing
2025-11-10 18:14 ` Ihor Radchenko
2025-11-11 13:35 ` RadioNoiseE
2025-11-11 14:05 ` Pedro Andres Aranda Gutierrez
2025-11-11 15:01 ` RadioNoiseE
2025-11-11 15:35 ` Pedro Andres Aranda Gutierrez
2025-11-14 10:07 ` Fwd: " Pedro A. Aranda
2025-11-15 10:35 ` Ihor Radchenko
2025-11-15 11:46 ` Pedro Andres Aranda Gutierrez
2025-11-17 2:03 ` RadioNoiseE
[not found] ` <CAO48Bk_ua3JQYM0bjHrmE1b7gyymAwPTT4d7HX0YYCOv0KB6pw@mail.gmail.com>
2025-11-17 7:22 ` Fwd: " Pedro Andres Aranda Gutierrez
2025-11-18 17:52 ` Pedro Andres Aranda Gutierrez
2025-11-19 20:14 ` Ihor Radchenko
2025-11-20 5:50 ` Pedro Andres Aranda Gutierrez
2025-11-20 6:25 ` Ihor Radchenko
2025-11-20 6:34 ` Pedro Andres Aranda Gutierrez
2025-11-20 20:22 ` Ihor Radchenko
2025-11-21 6:12 ` Pedro Andres Aranda Gutierrez
2025-11-21 8:05 ` Ihor Radchenko
2025-11-21 8:43 ` Pedro Andres Aranda Gutierrez
2025-11-21 13:45 ` Ihor Radchenko
2025-11-21 15:59 ` Pedro Andres Aranda Gutierrez
2025-11-21 16:56 ` Pedro Andres Aranda Gutierrez
2025-11-21 17:08 ` Pedro Andres Aranda Gutierrez
2025-11-21 18:31 ` Ihor Radchenko
2025-11-22 6:46 ` Pedro Andres Aranda Gutierrez
2025-11-22 9:16 ` Ihor Radchenko
2025-11-22 12:06 ` Pedro Andres Aranda Gutierrez
2025-11-22 13:12 ` Ihor Radchenko
2025-11-22 15:58 ` Pedro Andres Aranda Gutierrez
2025-11-22 16:20 ` Ihor Radchenko
2025-11-22 16:26 ` Pedro Andres Aranda Gutierrez
2025-11-23 3:23 ` Max Nikulin
2025-11-23 5:52 ` Pedro Andres Aranda Gutierrez
2025-11-23 7:52 ` Max Nikulin
2025-11-23 8:44 ` Pedro Andres Aranda Gutierrez
2025-11-23 9:30 ` Ihor Radchenko
2025-11-23 9:58 ` Pedro Andres Aranda Gutierrez
2025-11-23 10:07 ` Ihor Radchenko
2025-11-22 16:20 ` Pedro Andres Aranda Gutierrez
2025-11-23 7:36 ` Pedro Andres Aranda Gutierrez
2025-11-23 9:20 ` Ihor Radchenko
2025-11-23 9:46 ` Pedro Andres Aranda Gutierrez
2025-11-23 11:10 ` Ihor Radchenko
2025-11-24 9:34 ` Pedro Andres Aranda Gutierrez
2025-11-24 17:57 ` Ihor Radchenko
2025-11-24 19:31 ` Pedro Andres Aranda Gutierrez
2025-11-24 19:36 ` Ihor Radchenko
2025-11-24 19:37 ` Pedro Andres Aranda Gutierrez
2025-11-24 19:40 ` Ihor Radchenko
2025-11-24 19:44 ` Ihor Radchenko
2025-11-25 6:02 ` Pedro Andres Aranda Gutierrez
2025-11-25 6:56 ` Pedro Andres Aranda Gutierrez
2025-11-25 20:01 ` Ihor Radchenko
2025-11-26 7:02 ` Pedro Andres Aranda Gutierrez
2025-11-26 7:46 ` Pedro Andres Aranda Gutierrez
2025-11-29 14:18 ` Ihor Radchenko
2025-11-29 18:52 ` Pedro Andres Aranda Gutierrez
2025-11-30 10:57 ` Ihor Radchenko
2025-11-30 11:47 ` Pedro Andres Aranda Gutierrez
2025-11-30 12:55 ` Ihor Radchenko
2025-11-30 16:43 ` Pedro Andres Aranda Gutierrez
2025-11-30 18:06 ` Ihor Radchenko
2025-11-30 19:42 ` Pedro Andres Aranda Gutierrez
2025-12-01 18:04 ` Pedro Andres Aranda Gutierrez
2025-12-01 20:26 ` Ihor Radchenko
2025-11-29 14:11 ` Ihor Radchenko
2025-11-23 7:29 ` Pedro Andres Aranda Gutierrez
2025-11-23 7:36 ` Ihor Radchenko
2025-11-23 7:40 ` Pedro Andres Aranda Gutierrez
2025-11-23 9:22 ` Ihor Radchenko
2025-11-15 6:48 ` Fwd: " Pedro Andres Aranda Gutierrez
2025-11-15 18:33 ` Ihor Radchenko
2025-11-16 6:13 ` Pedro Andres Aranda Gutierrez
2025-11-17 2:16 ` RadioNoiseE
[not found] ` <CAO48Bk_0K+EGtbk08xHUJ0C7oksuH5JoFnyS4GBQxFUPBfvzPg@mail.gmail.com>
2025-11-17 7:21 ` Pedro Andres Aranda Gutierrez
2025-11-17 7:22 ` Fwd: " Pedro Andres Aranda Gutierrez
2025-11-17 2:07 ` RadioNoiseE
2025-11-09 11:15 ` Ihor Radchenko
2025-11-09 16:38 ` Pedro Andres Aranda Gutierrez
2025-11-10 18:30 ` Ihor Radchenko
2025-11-11 6:19 ` Pedro Andres Aranda Gutierrez
2025-11-11 12:43 ` Ihor Radchenko
2025-11-11 13:40 ` Pedro Andres Aranda Gutierrez
2025-11-15 10:32 ` Ihor Radchenko
2025-11-15 11:41 ` Pedro Andres Aranda Gutierrez
2025-11-12 7:00 ` Pedro Andres Aranda Gutierrez
2025-11-15 6:13 ` Max Nikulin
2025-11-15 6:53 ` Pedro Andres Aranda Gutierrez
2025-09-27 11:30 ` Ihor Radchenko
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87wm50wlcb.fsf@localhost \
[email protected] \
[email protected] \
[email protected] \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).