From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id EOFpE0Mg8WKEOQAAbAwnHQ (envelope-from ) for ; Mon, 08 Aug 2022 16:40:03 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id wEWSEkMg8WKYiwAAG6o9tA (envelope-from ) for ; Mon, 08 Aug 2022 16:40:03 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id BC7F199C3 for ; Mon, 8 Aug 2022 16:40:02 +0200 (CEST) Received: from localhost ([::1]:57230 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oL3vF-0006Hz-20 for larch@yhetil.org; Mon, 08 Aug 2022 10:40:01 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46838) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oL3ud-0006DT-8B for emacs-orgmode@gnu.org; Mon, 08 Aug 2022 10:39:23 -0400 Received: from mout02.posteo.de ([185.67.36.66]:49057) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oL3uZ-0002Fa-Em for emacs-orgmode@gnu.org; Mon, 08 Aug 2022 10:39:22 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 59E0E240104 for ; Mon, 8 Aug 2022 16:39:15 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1659969555; bh=Na7XhwViEqvpOWeXvyQFx6/V2JVMXlICL7jV7IrGKFA=; h=From:To:Subject:Date:From; b=SSAafeFn+PVtqxoYJfvIR5XwdJ5CaFWbM/J/43SD7rQIhsMlcb5wdjkh7ZURK4St+ ILTF+eRf/U9mw2Kvp7S5J2PqPEJqbPIolAr0BlktsachhLK/YOElwEKzhSna6SHWZO nkJiEDFQz9IVCzZdemY7KMImkZE6zHQBqAcTrnilIuXbwPWyknuWMBqowRMcXlyu0j 7uxntmVu8XT5WUEHpm5kgjnxgmAx5hq1QF5wNbu9IFXmkgWccGlZaZZtE2rmJe62Ct C9mxKlJxzCGd5khhi9shfQaFZq3tjelUiJsAW3p06JlabCNYpm5eA5G9PlFM++m6Wh Qh/ZpcIBBLfOQ== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4M1f3Q5PRKz6tml for ; Mon, 8 Aug 2022 16:39:14 +0200 (CEST) From: =?utf-8?Q?Juan_Manuel_Mac=C3=ADas?= To: orgmode Subject: [PATCH] Documentation and NEWS for ` org-latex-language-alist' Date: Mon, 08 Aug 2022 14:39:12 +0000 Message-ID: <87iln2dckv.fsf@posteo.net> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Received-SPF: pass client-ip=185.67.36.66; envelope-from=maciaschain@posteo.net; helo=mout02.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1659969602; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=voYpdBZYRLc4H4/K9IUb2llfmOShnlupJeoft6drpHw=; b=SU4sC+KY321Fw3RIalYN67uB7R32xoqSKlDiuOaoYQbO15OmCFBT2xIK6/NNMhpHZJybZs 3q/B/XQN4Elc99g5GV3FMwjBRLA5lJ+BeVz6fpvCj+xea0HhWMgsoVOvGfHoxFAPTJtukf MxJAhgWjrhJdriQtmi8qWddw8JUW4TEewVQ2cJW8dxCLWjDbOz09MkhSuEBI6Q6p39JOSk peP8TNKd1fJi5yoCvlG5fIQ/b0cxQAL8gcNqKq0+cGA5NitRFSDl42c1V8u8EjmemccRDQ uY+Z9QVtBxCiBhAdvGaPPZwYmZh30QEZ1QB4NdpT5woAXPMiTlBkbuRPI+JkSw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1659969602; a=rsa-sha256; cv=none; b=HATPoNSsJnY1gcwDJidffPsSuR9jBAwpJ2KPRac6ges/U4Fs5hjZ0dmxrGlRmkaMNNb65t D5dFyARM3cTx0+NnJBjS2aLwBWvFGqgVRTrbKFaO7DKGFDNN9WL7w7tcCiniCtoxFWCEsf fnjEFjNEnIdqxu73nPk+TalweC4uMLFd8drC+9d9tPrFo0Nk0pIgulaz5PK8EPQNWanhkh o6Z2qW+8KWKQ6Ct06obxJFztzYvJj29FHtbgrP8femwZ6azZ+aX9eNlYkCHPOZwRTq732O bPAXlXZvTkjHHAA3JT7Slg/SIH5uMwhbvdrS/ZUGplFQ6/wwGYmhWEOVImF34Q== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=SSAafeFn; dmarc=pass (policy=none) header.from=posteo.net; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -7.59 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=SSAafeFn; dmarc=pass (policy=none) header.from=posteo.net; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: BC7F199C3 X-Spam-Score: -7.59 X-Migadu-Scanner: scn0.migadu.com X-TUID: QgDsWXNCcms3 --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi, I am attaching a patch with the documentation of the new variable in the Manual and the updated NEWS. Best regards, Juan Manuel --=20 -- ------------------------------------------------------ Juan Manuel Mac=C3=ADas=20 https://juanmanuelmacias.com https://lunotipia.juanmanuelmacias.com https://gnutas.juanmanuelmacias.com --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-org-manual.org-documentation-for-org-latex-langu.patch >From 2ec740e4b2f691f619878a7b86e4874fa05d3a82 Mon Sep 17 00:00:00 2001 From: Juan Manuel Macias Date: Mon, 8 Aug 2022 16:30:01 +0200 Subject: [PATCH] doc/org-manual.org: documentation for `org-latex-language-alist' * etc/ORG-NEWS: update the news with the new variable. --- doc/org-manual.org | 57 ++++++++++++++++++++++++++++++++++++++++++++-- etc/ORG-NEWS | 13 +++++++++++ 2 files changed, 68 insertions(+), 2 deletions(-) diff --git a/doc/org-manual.org b/doc/org-manual.org index 466718e6e..5d0283bf2 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -13370,19 +13370,72 @@ general options (see [[*Export Settings]]). - =LANGUAGE= :: #+cindex: @samp{LANGUAGE}, keyword #+vindex: org-latex-packages-alist + #+vindex: org-latex-language-alist + #+vindex: org-export-default-language + + The list of languages supported by Org is stored in the variable + ~org-latex-language-alist~. + In order to be effective, the =babel= or =polyglossia= packages---according to the LaTeX compiler used---must be loaded with the appropriate language as argument. This can be accomplished by modifying the ~org-latex-packages-alist~ variable, e.g., with the - following snippet: + following snippet (note that =polyglossia= does not work with + pdfLaTeX): #+begin_src emacs-lisp (add-to-list 'org-latex-packages-alist - '("AUTO" "babel" t ("pdflatex"))) + '("AUTO" "babel" t ("pdflatex" "xelatex" "lualatex"))) (add-to-list 'org-latex-packages-alist '("AUTO" "polyglossia" t ("xelatex" "lualatex"))) #+end_src + LaTeX packages =babel= or =polyglossia= can also be loaded in a + document. The "AUTO" string will be replaced in both cases by the + appropiate value for the =LANGUAGE= keyword, if present in the + document, or by the value of ~org-export-default-language~. Let's + see some examples in one or another case. + + =Babel= accepts the classic syntax and (in addition) the new syntax + with the =\babelprovide= command to load the languages using the new + =INI= files procedure. Keep in mind that there are a number of + languages that are only served in babel using =INI= files, so they + cannot be declared using the classic syntax, but only using the + =\babelprovide= command (see + http://mirrors.ctan.org/macros/latex/required/babel/base/babel.pdf). + Valid usage examples could be: + + #+begin_example + ,#+LATEX_HEADER: \usepackage[french,italian,AUTO]{babel} + #+end_example + + where "AUTO" is the main language. But it can also be loaded using + the =\babelprovide= command: + + #+begin_example + ,#+LATEX_HEADER: \usepackage[french,italian]{babel} + ,#+LATEX_HEADER: \babelprovide[import, main]{AUTO} + #+end_example + + =Polyglossia=, for this procedure to be effective, must be loaded + using the same =babel= classic syntax (but note that /this is not/ + the actual polyglossia syntax). For example, suppose a document + declares Polytonic Greek as the primary language, and French as the + secondary language. In this case, it would be expressed as: + + #+begin_example + ,#+LANGUAGE: el-polyton + ,#+LATEX_HEADER: \usepackage[french,AUTO]{polyglossia} + #+end_example + + This would produce in LaTeX (with the actual =polyglossia= syntax): + + #+begin_example + \usepackage{polyglossia} + \setmainlanguage[variant=polytonic]{greek} + \setotherlanguage{french} + #+end_example + - =LATEX_CLASS= :: #+cindex: @samp{LATEX_CLASS}, keyword diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index 00fe101dc..fc9ac688a 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -431,6 +431,19 @@ prompting for a link description. It can be a string (used as-is) or a function (called with the same arguments as ~org-make-link-description-function~ to return a string to use). +*** New list of languages for LaTeX export: ~org-latex-language-alist~ + +~org-latex-language-alist~ unifies into a single list the old language +lists for the =babel= and =polyglossia= LaTeX packages: +~org-latex-babel-language-alist~ and +~org-latex-polyglossia-language-alist~, respectively, which are +declared obsolete. + +This new list captures the current state of art regarding language +support in LaTeX. The new =babel= syntax for loading languages via +=ini= files and the new command =\babelprovide= (see: +http://mirrors.ctan.org/macros/latex/required/babel/base/babel.pdf) +are also supported. * Version 9.5 ** Important announcements and breaking changes -- 2.37.1 --=-=-=--