New Orgmode LaTex Document Class ?

New Orgmode LaTex Document Class ?

[David Masterson]

I want to install a resume document class for LaTex so that I can (more
easily) write good looking resumes from Org.  I think I see how to
identify the new document class to Org (org-latex-classes), but I'm not
sure if that tells Org *where* the new document class is.  Do I have to
install the .cls file somewhere (where?) in my LaTex installation
(TexLive) or can it be referenced elsewhere (like $HOME/tex) by proper
configuration of an Org variable?  I'm not a LaTex user -- this is my
first attempt to add something to LaTex that I can then leverage in Org,
-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

> I want to install a resume document class for LaTex so that I can (more
> easily) write good looking resumes from Org.  I think I see how to
> identify the new document class to Org (org-latex-classes), but I'm not
> sure if that tells Org *where* the new document class is.

You need to install the class file where LaTeX can find it.
Either using your system package manager or into ~/texmf

You may check
https://tex.stackexchange.com/questions/1137/where-do-i-place-my-own-sty-or-cls-files-to-make-them-available-to-all-my-te
 
-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[Stefan Nobis]

David Masterson <dsmasterson@gmail.com> writes:

> I want to install a resume document class for LaTex

There are the variables org-latex-classes and org-latex-default-class
on the Org side, but that's only about some structural metadata (how
to map Org headline levels to LaTeX structure macros).

To find the new class file you have to put it into a folder where
LaTeX will find it. Org just puts the name of the class into the TeX
file and everything else is up to LaTeX.

Usually, on Unix systems, there is the optional hierarchy $HOME/texmf
where you can store you private, local files. It is a good idea to
mimic the usual TeX directory structure, therefore class and style
files for LaTeX should go into $HOME/texmf/tex/latex (you may add
subdirectories there).

Nowadays it should suffice to just drop your class file there and
everything should work on the LaTeX side.

A quick check whether LaTeX will be able to find the file could be
done with the tool kpsewhich:

    kpsewhich myltxclass.cls

This tool uses the same configuration and search algorithms for the
files as the TeX engines. So if kpsewhich finds the file, the engines
should find it too.

One side note: On macOS the default path for the user texmf tree is
$HOME/Library/texmf. On all systems you may find the correct base
directory for the user texmf tree with the command

    kpsewhich -var-value TEXMFHOME

Hope this helps.

-- 
Until the next mail...,
Stefan.

Re: New Orgmode LaTex Document Class ?

[David Masterson]

Stefan Nobis <stefan-ml@snobis.de> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>> I want to install a resume document class for LaTex
>
> There are the variables org-latex-classes and org-latex-default-class
> on the Org side, but that's only about some structural metadata (how
> to map Org headline levels to LaTeX structure macros).
>
> To find the new class file you have to put it into a folder where
> LaTeX will find it. Org just puts the name of the class into the TeX
> file and everything else is up to LaTeX.
>
> Usually, on Unix systems, there is the optional hierarchy $HOME/texmf
> where you can store you private, local files. It is a good idea to
> mimic the usual TeX directory structure, therefore class and style
> files for LaTeX should go into $HOME/texmf/tex/latex (you may add
> subdirectories there).
>
> Nowadays it should suffice to just drop your class file there and
> everything should work on the LaTeX side.
>
> A quick check whether LaTeX will be able to find the file could be
> done with the tool kpsewhich:
>
>     kpsewhich myltxclass.cls
>
> This tool uses the same configuration and search algorithms for the
> files as the TeX engines. So if kpsewhich finds the file, the engines
> should find it too.
>
> One side note: On macOS the default path for the user texmf tree is
> $HOME/Library/texmf. On all systems you may find the correct base
> directory for the user texmf tree with the command
>
>     kpsewhich -var-value TEXMFHOME
>
> Hope this helps.

Thank you.  This is very helpful for a newbie like me.  Someone should
probably add something like this in the Org manual to help people begin
the bridge of setup into more advanced LaTex while using Org (maybe it's
there already?).

-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

> ...  Someone should
> probably add something like this in the Org manual to help people begin
> the bridge of setup into more advanced LaTex while using Org (maybe it's
> there already?).

It will not be productive to explain LaTeX in the Org manual. There are
whole books dedicated to various aspects of LaTeX out there.

The best we can do it pointing users to some resources about TeX or to
the existence of such resources.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[David Masterson]

Ihor Radchenko <yantar92@posteo.net> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>> ...  Someone should
>> probably add something like this in the Org manual to help people begin
>> the bridge of setup into more advanced LaTex while using Org (maybe it's
>> there already?).
>
> It will not be productive to explain LaTeX in the Org manual. There are
> whole books dedicated to various aspects of LaTeX out there.
>
> The best we can do it pointing users to some resources about TeX or to
> the existence of such resources.

Agreed.  I was only suggesting a tidbit on how Org connects to LaTeX,
but, looking further at the docs, I think it is already covered.
Mentioning the (previously mentioned) 'kpsewhich' for finding what are
the LaTex classes (etc.) to which Org can refer might be useful.  From
there, the newbie (like me) can go research what the classes can do in
the LaTeX manuals.

-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

> Mentioning the (previously mentioned) 'kpsewhich' for finding what are
> the LaTex classes (etc.) to which Org can refer might be useful.  From
> there, the newbie (like me) can go research what the classes can do in
> the LaTeX manuals.

Do you have specific section of the manual in mind?

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[David Masterson]

Ihor Radchenko <yantar92@posteo.net> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>> Mentioning the (previously mentioned) 'kpsewhich' for finding what are
>> the LaTex classes (etc.) to which Org can refer might be useful.  From
>> there, the newbie (like me) can go research what the classes can do in
>> the LaTeX manuals.
>
> Do you have specific section of the manual in mind?

I thought about it and, I think, a simple statement at the end of 13.10
(Latex Export) provides a start to help a newbie.  Something like:

----

If you have the LaTeX system installed, the 'kpsewhich' Linux command
can be used to help you find where things are installed to learn if the
LaTeX classes you want are already installed.  In particular:

  kpsewhich -show-path tex

This will show you the path of directories that are searched for classes
and such.  From there, you can use LaTeX documentation to learn more.
----

Hmm. Perhaps only the first sentence to give people a start on where to
look. 

What do you think?

-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

>> Do you have specific section of the manual in mind?
>
> I thought about it and, I think, a simple statement at the end of 13.10
> (Latex Export) provides a start to help a newbie.  Something like:
>
> ----
>
> If you have the LaTeX system installed, the 'kpsewhich' Linux command
> can be used to help you find where things are installed to learn if the
> LaTeX classes you want are already installed.  In particular:
> ...
> What do you think?

It looks a bit too specific. Most users will not even need to know this
- I went away without knowing about kpsewhich by using default sty files
or putting these files alongside the .tex file for over 10 years since I
learned LaTeX.

I'd prefer to put some more generic reference. Some info manual or good
stable URL link that has explanations about kpsewhich and other LaTeX
basics.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[Stefan Nobis]

Ihor Radchenko <yantar92@posteo.net> writes:

> I'd prefer to put some more generic reference. Some info manual or
> good stable URL link that has explanations about kpsewhich and other
> LaTeX basics.

What about

   http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf

No direct references to kpsewhich, but I agree, that this is already a
rather specialized tool. But there are pointers to all the entry level
tutorials and resources and also some of the rather often asked for
packages.

-- 
Until the next mail...,
Stefan.

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

Stefan Nobis <stefan-ml@snobis.de> writes:

> Ihor Radchenko <yantar92@posteo.net> writes:
>
>> I'd prefer to put some more generic reference. Some info manual or
>> good stable URL link that has explanations about kpsewhich and other
>> LaTeX basics.
>
> What about
>
>    http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf

Looks reasonable.
We may also link to "texdoc latex" command (the same file, but locally).

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[David Masterson]

Ihor Radchenko <yantar92@posteo.net> writes:

> Stefan Nobis <stefan-ml@snobis.de> writes:
>
>> Ihor Radchenko <yantar92@posteo.net> writes:
>>
>>> I'd prefer to put some more generic reference. Some info manual or
>>> good stable URL link that has explanations about kpsewhich and other
>>> LaTeX basics.
>>
>> What about
>>
>>    http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf

Seems good, but maybe https://ctan.org is the true starting place.  They
can search for "latex" or look in the "Cover" dropdown for some ideas.
I just found https://tug.org/begin.html there for getting started with
TeX/LaTeX (which might also be good to mention).

> Looks reasonable.
> We may also link to "texdoc latex" command (the same file, but
> locally).

Didn't know about 'texdpc', but that brought up details about the
Luaotfload package for me.  Was that what you intended?

-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

>>> What about
>>>
>>>    http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf
>
> Seems good, but maybe https://ctan.org is the true starting place.  They
> can search for "latex" or look in the "Cover" dropdown for some ideas.
> I just found https://tug.org/begin.html there for getting started with
> TeX/LaTeX (which might also be good to mention).

I am not sure. I cannot easily see beginner resources on CTAN and that
linked latex-doc-ptr.pdf does mention CTAN, alongside other useful
resources like stackexchange, learnlatex.org, and various beginner
tutorials.

>> Looks reasonable.
>> We may also link to "texdoc latex" command (the same file, but
>> locally).
>
> Didn't know about 'texdpc', but that brought up details about the
> Luaotfload package for me.  Was that what you intended?

Running texdoc latex in shell will open the same pdf file as in 
http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[David Masterson]

Ihor Radchenko <yantar92@posteo.net> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>>>> What about
>>>>
>>>>    http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf
>>
>> Seems good, but maybe https://ctan.org is the true starting place.  They
>> can search for "latex" or look in the "Cover" dropdown for some ideas.
>> I just found https://tug.org/begin.html there for getting started with
>> TeX/LaTeX (which might also be good to mention).
>
> I am not sure. I cannot easily see beginner resources on CTAN and that
> linked latex-doc-ptr.pdf does mention CTAN, alongside other useful
> resources like stackexchange, learnlatex.org, and various beginner
> tutorials.

Okay, I agree.

>>> Looks reasonable.
>>> We may also link to "texdoc latex" command (the same file, but
>>> locally).
>>
>> Didn't know about 'texdpc', but that brought up details about the
>> Luaotfload package for me.  Was that what you intended?
>
> Running texdoc latex in shell will open the same pdf file as in 
> http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf

Hmm.  For me 'texdoc -l latex' in a shell showed me this:

 1 /usr/share/texlive/texmf-dist/doc/luatex/luaotfload/luaotfload-latex.pdf
 2 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/llmk.pdf
 3 /usr/share/texlive/texmf-dist/doc/support/latex-papersize/README
   = Readme
 4 /usr/share/texlive/texmf-dist/doc/support/latex-git-log/README.md
 5 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/README.md.gz
 6 /usr/share/texlive/texmf-dist/doc/support/hook-pre-commit-pkg/pre-commit-latex.gz

Searching around my system, I don't find the file, but all latex
packages seem to be installed.  Maybe it's not in Debian Bullseye?

If this is a general problem, then new users would have to figure out
what wasn't installed (Chromebook starts with a pretty barebones
Debian).  Perhaps a URL is better to avoid installation issues?

-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

>> Running texdoc latex in shell will open the same pdf file as in 
>> http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf
>
> Hmm.  For me 'texdoc -l latex' in a shell showed me this:
>
>  1 /usr/share/texlive/texmf-dist/doc/luatex/luaotfload/luaotfload-latex.pdf
>  2 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/llmk.pdf
>  3 /usr/share/texlive/texmf-dist/doc/support/latex-papersize/README
>    = Readme
>  4 /usr/share/texlive/texmf-dist/doc/support/latex-git-log/README.md
>  5 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/README.md.gz
>  6 /usr/share/texlive/texmf-dist/doc/support/hook-pre-commit-pkg/pre-commit-latex.gz
>
> Searching around my system, I don't find the file, but all latex
> packages seem to be installed.  Maybe it's not in Debian Bullseye?

Curious.
On my Gentoo:

$ equery b /usr/share/texmf-dist/doc/latex/latex-doc-ptr/latex-doc-ptr.pdf
 * Searching for /usr/share/texmf-dist/doc/latex/latex-doc-ptr/latex-doc-ptr.pdf ... 
dev-texlive/texlive-langenglish-2021 (/usr/share/texmf-dist/doc/latex/latex-doc-ptr/latex-doc-ptr.pdf)

This package is a part of default TeXLive installation (on Gentoo) for
English language environment.

> If this is a general problem, then new users would have to figure out
> what wasn't installed (Chromebook starts with a pretty barebones
> Debian).  Perhaps a URL is better to avoid installation issues?

We should definitely provide the URL link. At least as one option.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

>> http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf

Other possibilities are:
https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-70001.5 or
https://tug.org/begin.html

Some people may be slightly uncomfortable reading pdf-only. So,
providing an html page link might be slightly better.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: New Orgmode LaTex Document Class ?

[tomas]

[-- Attachment #1: Type: text/plain, Size: 1064 bytes --]

On Tue, Aug 01, 2023 at 11:28:32PM -0700, David Masterson wrote:

[...]

> Hmm.  For me 'texdoc -l latex' in a shell showed me this:
> 
>  1 /usr/share/texlive/texmf-dist/doc/luatex/luaotfload/luaotfload-latex.pdf
>  2 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/llmk.pdf
>  3 /usr/share/texlive/texmf-dist/doc/support/latex-papersize/README
>    = Readme
>  4 /usr/share/texlive/texmf-dist/doc/support/latex-git-log/README.md
>  5 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/README.md.gz
>  6 /usr/share/texlive/texmf-dist/doc/support/hook-pre-commit-pkg/pre-commit-latex.gz
> 
> Searching around my system, I don't find the file, but all latex
> packages seem to be installed.  Maybe it's not in Debian Bullseye?

It seems to be a problem in texdoc. The file itself is there:

  tomas@trotzki:~$ apt-file search latex-doc-ptr.pdf
  texlive-lang-english: /usr/share/doc/texlive-doc/latex/latex-doc-ptr/latex-doc-ptr.pdf

This is Bullseye, but I don't expect those things to change in Buster.

Cheers
-- 
t

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 195 bytes --]

Re: New Orgmode LaTex Document Class ?

[David Masterson]

<tomas@tuxteam.de> writes:

> On Tue, Aug 01, 2023 at 11:28:32PM -0700, David Masterson wrote:
>
> [...]
>
>> Hmm.  For me 'texdoc -l latex' in a shell showed me this:
>> 
>>  1 /usr/share/texlive/texmf-dist/doc/luatex/luaotfload/luaotfload-latex.pdf
>>  2 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/llmk.pdf
>>  3 /usr/share/texlive/texmf-dist/doc/support/latex-papersize/README
>>    = Readme
>>  4 /usr/share/texlive/texmf-dist/doc/support/latex-git-log/README.md
>>  5 /usr/share/texlive/texmf-dist/doc/support/light-latex-make/README.md.gz
>>  6 /usr/share/texlive/texmf-dist/doc/support/hook-pre-commit-pkg/pre-commit-latex.gz
>> 
>> Searching around my system, I don't find the file, but all latex
>> packages seem to be installed.  Maybe it's not in Debian Bullseye?
>
> It seems to be a problem in texdoc. The file itself is there:
>
>   tomas@trotzki:~$ apt-file search latex-doc-ptr.pdf
>   texlive-lang-english: /usr/share/doc/texlive-doc/latex/latex-doc-ptr/latex-doc-ptr.pdf
>
> This is Bullseye, but I don't expect those things to change in Buster.

Ah!  That's the problem -- I didn't have texlive-lang-english installed!
I also didn't know about 'apt-file search' -- useful command!

'texdoc latex' now works for me.

Thanks
-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[David Masterson]

Ihor Radchenko <yantar92@posteo.net> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>>> http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf
>
> Other possibilities are:
> https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-70001.5 or
> https://tug.org/begin.html
>
> Some people may be slightly uncomfortable reading pdf-only. So,
> providing an html page link might be slightly better.

I think begin.html is a good starting point.  Mentioning 'texdoc latex'
is also simple (and more LaTeX specific) and most likely to work.  You
could include a parenthetical note that, if it doesn't work, try the
URL.  After that, new users can dig through the documentation.

-- 
David Masterson

Re: New Orgmode LaTex Document Class ?

[tomas]

[-- Attachment #1: Type: text/plain, Size: 456 bytes --]

On Wed, Aug 02, 2023 at 09:53:27AM -0700, David Masterson wrote:
> <tomas@tuxteam.de> writes:

[...]

> >   tomas@trotzki:~$ apt-file search latex-doc-ptr.pdf

[...]

> Ah!  That's the problem -- I didn't have texlive-lang-english installed!
> I also didn't know about 'apt-file search' -- useful command!

  sudo apt-get install apt-file

I couldn't live without :-)

> 'texdoc latex' now works for me.

good to hear.

Cheers
-- 
t

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 195 bytes --]

[PATCH] org-manual: Add references to LaTeX docs (was: New Orgmode LaTex Document Class ?)

[Ihor Radchenko]

[-- Attachment #1: Type: text/plain, Size: 368 bytes --]

David Masterson <dsmasterson@gmail.com> writes:

> I think begin.html is a good starting point.  Mentioning 'texdoc latex'
> is also simple (and more LaTeX specific) and most likely to work.  You
> could include a parenthetical note that, if it doesn't work, try the
> URL.  After that, new users can dig through the documentation.

See the attached tentative patch.


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-org-manual.org-Refer-to-LaTeX-docs-for-general-t.patch --]
[-- Type: text/x-patch, Size: 2196 bytes --]

From 659d79484fcd280b0ec8d57282588386aa626b21 Mon Sep 17 00:00:00 2001
Message-ID: <659d79484fcd280b0ec8d57282588386aa626b21.1691049428.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Thu, 3 Aug 2023 10:56:07 +0300
Subject: [PATCH] doc/org-manual.org: Refer to LaTeX docs for general
 terminology

* doc/org-manual.org (LaTeX Export): Add links to online and offline
LaTeX docs.
(Quoting LaTeX code): Clarify that direct LaTeX can be used for
fine-tuning.

Link: https://orgmode.org/list/SJ0PR03MB5455B2712FA85BA945DFF441A20BA@SJ0PR03MB5455.namprd03.prod.outlook.com
---
 doc/org-manual.org | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index 16fbb268f..c3a4e47bc 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -13703,6 +13703,13 @@ ** LaTeX Export
 blank lines in the Org document.  That's because LaTeX itself depends
 on blank lines to tell apart syntactical elements, such as paragraphs.
 
+The following sections expect users to be familiar with common LaTeX
+terminology.  You may refer to https://tug.org/begin.html to get
+familiar with LaTeX basics.  Users with LaTeX installed may also run
+=texinfo latex= from terminal to open LaTeX introduction [fn:: The
+command will open PDF file, which is also available for download from
+http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf]
+
 *** LaTeX/PDF export commands
 :PROPERTIES:
 :DESCRIPTION: For producing @LaTeX{} and PDF documents.
@@ -13979,9 +13986,10 @@ *** Quoting LaTeX code
 :DESCRIPTION: Incorporating literal @LaTeX{} code.
 :END:
 
-The LaTeX export backend can insert any arbitrary LaTeX code, see
-[[*Embedded LaTeX]].  There are three ways to embed such code in the Org
-file and they all use different quoting syntax.
+When the available LaTeX export customizations are not sufficient to
+fine-tune the desired output, it is possible to insert any arbitrary
+LaTeX code (see [[*Embedded LaTeX]]).  There are three ways to embed such
+code in the Org file and they all use different quoting syntax.
 
 #+cindex: inline, in @LaTeX{} export
 Inserting in-line quoted with @ symbols:
-- 
2.41.0


[-- Attachment #3: Type: text/plain, Size: 224 bytes --]


-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: [PATCH] org-manual: Add references to LaTeX docs

[David Masterson]

Minor change below.

Ihor Radchenko <yantar92@posteo.net> writes:

> David Masterson <dsmasterson@gmail.com> writes:
>
>> I think begin.html is a good starting point.  Mentioning 'texdoc latex'
>> is also simple (and more LaTeX specific) and most likely to work.  You
>> could include a parenthetical note that, if it doesn't work, try the
>> URL.  After that, new users can dig through the documentation.
>
> See the attached tentative patch.
>
> From 659d79484fcd280b0ec8d57282588386aa626b21 Mon Sep 17 00:00:00 2001
> Message-ID: <659d79484fcd280b0ec8d57282588386aa626b21.1691049428.git.yantar92@posteo.net>
> From: Ihor Radchenko <yantar92@posteo.net>
> Date: Thu, 3 Aug 2023 10:56:07 +0300
> Subject: [PATCH] doc/org-manual.org: Refer to LaTeX docs for general
>  terminology
>
> * doc/org-manual.org (LaTeX Export): Add links to online and offline
> LaTeX docs.
> (Quoting LaTeX code): Clarify that direct LaTeX can be used for
> fine-tuning.
>
> Link: https://orgmode.org/list/SJ0PR03MB5455B2712FA85BA945DFF441A20BA@SJ0PR03MB5455.namprd03.prod.outlook.com
> ---
>  doc/org-manual.org | 14 +++++++++++---
>  1 file changed, 11 insertions(+), 3 deletions(-)
>
> diff --git a/doc/org-manual.org b/doc/org-manual.org
> index 16fbb268f..c3a4e47bc 100644
> --- a/doc/org-manual.org
> +++ b/doc/org-manual.org
> @@ -13703,6 +13703,13 @@ ** LaTeX Export
>  blank lines in the Org document.  That's because LaTeX itself depends
>  on blank lines to tell apart syntactical elements, such as paragraphs.
>  
> +The following sections expect users to be familiar with common LaTeX
> +terminology.  You may refer to https://tug.org/begin.html to get
> +familiar with LaTeX basics.  Users with LaTeX installed may also run
> +=texinfo latex= from terminal to open LaTeX introduction [fn:: The

I think you meant '=texdoc latex=' here.

> +command will open PDF file, which is also available for download from

Oh, also 'open a PDF file'.

> +http://mirrors.ctan.org/info/latex-doc-ptr/latex-doc-ptr.pdf]
> +
>  *** LaTeX/PDF export commands
>  :PROPERTIES:
>  :DESCRIPTION: For producing @LaTeX{} and PDF documents.
> @@ -13979,9 +13986,10 @@ *** Quoting LaTeX code
>  :DESCRIPTION: Incorporating literal @LaTeX{} code.
>  :END:
>  
> -The LaTeX export backend can insert any arbitrary LaTeX code, see
> -[[*Embedded LaTeX]].  There are three ways to embed such code in the Org
> -file and they all use different quoting syntax.
> +When the available LaTeX export customizations are not sufficient to
> +fine-tune the desired output, it is possible to insert any arbitrary
> +LaTeX code (see [[*Embedded LaTeX]]).  There are three ways to embed such
> +code in the Org file and they all use different quoting syntax.
>  
>  #+cindex: inline, in @LaTeX{} export
>  Inserting in-line quoted with @ symbols:
> -- 
> 2.41.0

Everything else looks good.

-- 
David Masterson

Re: [PATCH] org-manual: Add references to LaTeX docs

[Ihor Radchenko]

David Masterson <dsmasterson@gmail.com> writes:

> I think you meant '=texdoc latex=' here.
> ...
> Oh, also 'open a PDF file'.
>
> Everything else looks good.

Thanks for the review!
Applied, with the suggested amendments, onto main.
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=f4fecc244

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>