* New Orgmode LaTex Document Class ? @ 2023-07-28 6:47 David Masterson 2023-07-28 7:23 ` Ihor Radchenko 2023-07-28 7:57 ` Stefan Nobis 0 siblings, 2 replies; 23+ messages in thread From: David Masterson @ 2023-07-28 6:47 UTC (permalink / raw) To: emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-28 6:47 New Orgmode LaTex Document Class ? David Masterson @ 2023-07-28 7:23 ` Ihor Radchenko 2023-07-28 7:57 ` Stefan Nobis 1 sibling, 0 replies; 23+ messages in thread From: Ihor Radchenko @ 2023-07-28 7:23 UTC (permalink / raw) To: David Masterson; +Cc: emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-28 6:47 New Orgmode LaTex Document Class ? David Masterson 2023-07-28 7:23 ` Ihor Radchenko @ 2023-07-28 7:57 ` Stefan Nobis 2023-07-29 22:58 ` David Masterson 1 sibling, 1 reply; 23+ messages in thread From: Stefan Nobis @ 2023-07-28 7:57 UTC (permalink / raw) To: emacs-orgmode 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. ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-28 7:57 ` Stefan Nobis @ 2023-07-29 22:58 ` David Masterson 2023-07-30 4:27 ` Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-07-29 22:58 UTC (permalink / raw) To: emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-29 22:58 ` David Masterson @ 2023-07-30 4:27 ` Ihor Radchenko 2023-07-30 5:02 ` David Masterson 0 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-07-30 4:27 UTC (permalink / raw) To: David Masterson; +Cc: emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-30 4:27 ` Ihor Radchenko @ 2023-07-30 5:02 ` David Masterson 2023-07-30 6:42 ` Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-07-30 5:02 UTC (permalink / raw) To: Ihor Radchenko; +Cc: emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-30 5:02 ` David Masterson @ 2023-07-30 6:42 ` Ihor Radchenko 2023-07-30 20:34 ` David Masterson 0 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-07-30 6:42 UTC (permalink / raw) To: David Masterson; +Cc: emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-30 6:42 ` Ihor Radchenko @ 2023-07-30 20:34 ` David Masterson 2023-07-31 7:05 ` Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-07-30 20:34 UTC (permalink / raw) To: Ihor Radchenko; +Cc: emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-30 20:34 ` David Masterson @ 2023-07-31 7:05 ` Ihor Radchenko 2023-07-31 7:40 ` Stefan Nobis 0 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-07-31 7:05 UTC (permalink / raw) To: David Masterson; +Cc: emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-31 7:05 ` Ihor Radchenko @ 2023-07-31 7:40 ` Stefan Nobis 2023-07-31 10:23 ` Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: Stefan Nobis @ 2023-07-31 7:40 UTC (permalink / raw) To: emacs-orgmode 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. ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-31 7:40 ` Stefan Nobis @ 2023-07-31 10:23 ` Ihor Radchenko 2023-07-31 22:41 ` David Masterson 0 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-07-31 10:23 UTC (permalink / raw) To: Stefan Nobis; +Cc: emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-31 10:23 ` Ihor Radchenko @ 2023-07-31 22:41 ` David Masterson 2023-08-01 8:11 ` Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-07-31 22:41 UTC (permalink / raw) To: Ihor Radchenko; +Cc: Stefan Nobis, emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-07-31 22:41 ` David Masterson @ 2023-08-01 8:11 ` Ihor Radchenko 2023-08-02 6:28 ` David Masterson 0 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-08-01 8:11 UTC (permalink / raw) To: David Masterson; +Cc: Stefan Nobis, emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-01 8:11 ` Ihor Radchenko @ 2023-08-02 6:28 ` David Masterson 2023-08-02 6:52 ` Ihor Radchenko ` (2 more replies) 0 siblings, 3 replies; 23+ messages in thread From: David Masterson @ 2023-08-02 6:28 UTC (permalink / raw) To: Ihor Radchenko; +Cc: Stefan Nobis, emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-02 6:28 ` David Masterson @ 2023-08-02 6:52 ` Ihor Radchenko 2023-08-02 6:59 ` Ihor Radchenko 2023-08-02 7:49 ` New Orgmode LaTex Document Class ? tomas 2 siblings, 0 replies; 23+ messages in thread From: Ihor Radchenko @ 2023-08-02 6:52 UTC (permalink / raw) To: David Masterson; +Cc: Stefan Nobis, emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-02 6:28 ` David Masterson 2023-08-02 6:52 ` Ihor Radchenko @ 2023-08-02 6:59 ` Ihor Radchenko 2023-08-02 17:14 ` David Masterson 2023-08-02 7:49 ` New Orgmode LaTex Document Class ? tomas 2 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-08-02 6:59 UTC (permalink / raw) To: David Masterson; +Cc: Stefan Nobis, emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-02 6:59 ` Ihor Radchenko @ 2023-08-02 17:14 ` David Masterson 2023-08-03 7:58 ` [PATCH] org-manual: Add references to LaTeX docs (was: New Orgmode LaTex Document Class ?) Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-08-02 17:14 UTC (permalink / raw) To: Ihor Radchenko; +Cc: Stefan Nobis, emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* [PATCH] org-manual: Add references to LaTeX docs (was: New Orgmode LaTex Document Class ?) 2023-08-02 17:14 ` David Masterson @ 2023-08-03 7:58 ` Ihor Radchenko 2023-08-06 3:35 ` [PATCH] org-manual: Add references to LaTeX docs David Masterson 0 siblings, 1 reply; 23+ messages in thread From: Ihor Radchenko @ 2023-08-03 7:58 UTC (permalink / raw) To: David Masterson; +Cc: Stefan Nobis, emacs-orgmode [-- 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> ^ permalink raw reply related [flat|nested] 23+ messages in thread
* Re: [PATCH] org-manual: Add references to LaTeX docs 2023-08-03 7:58 ` [PATCH] org-manual: Add references to LaTeX docs (was: New Orgmode LaTex Document Class ?) Ihor Radchenko @ 2023-08-06 3:35 ` David Masterson 2023-08-06 8:04 ` Ihor Radchenko 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-08-06 3:35 UTC (permalink / raw) To: Ihor Radchenko; +Cc: Stefan Nobis, emacs-orgmode 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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: [PATCH] org-manual: Add references to LaTeX docs 2023-08-06 3:35 ` [PATCH] org-manual: Add references to LaTeX docs David Masterson @ 2023-08-06 8:04 ` Ihor Radchenko 0 siblings, 0 replies; 23+ messages in thread From: Ihor Radchenko @ 2023-08-06 8:04 UTC (permalink / raw) To: David Masterson; +Cc: Stefan Nobis, emacs-orgmode 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> ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-02 6:28 ` David Masterson 2023-08-02 6:52 ` Ihor Radchenko 2023-08-02 6:59 ` Ihor Radchenko @ 2023-08-02 7:49 ` tomas 2023-08-02 16:53 ` David Masterson 2 siblings, 1 reply; 23+ messages in thread From: tomas @ 2023-08-02 7:49 UTC (permalink / raw) To: David Masterson; +Cc: Ihor Radchenko, Stefan Nobis, emacs-orgmode [-- 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 --] ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-02 7:49 ` New Orgmode LaTex Document Class ? tomas @ 2023-08-02 16:53 ` David Masterson 2023-08-02 17:29 ` tomas 0 siblings, 1 reply; 23+ messages in thread From: David Masterson @ 2023-08-02 16:53 UTC (permalink / raw) To: tomas; +Cc: Ihor Radchenko, Stefan Nobis, emacs-orgmode <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 ^ permalink raw reply [flat|nested] 23+ messages in thread
* Re: New Orgmode LaTex Document Class ? 2023-08-02 16:53 ` David Masterson @ 2023-08-02 17:29 ` tomas 0 siblings, 0 replies; 23+ messages in thread From: tomas @ 2023-08-02 17:29 UTC (permalink / raw) To: David Masterson; +Cc: Ihor Radchenko, Stefan Nobis, emacs-orgmode [-- 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 --] ^ permalink raw reply [flat|nested] 23+ messages in thread
end of thread, other threads:[~2023-08-06 8:04 UTC | newest] Thread overview: 23+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2023-07-28 6:47 New Orgmode LaTex Document Class ? David Masterson 2023-07-28 7:23 ` Ihor Radchenko 2023-07-28 7:57 ` Stefan Nobis 2023-07-29 22:58 ` David Masterson 2023-07-30 4:27 ` Ihor Radchenko 2023-07-30 5:02 ` David Masterson 2023-07-30 6:42 ` Ihor Radchenko 2023-07-30 20:34 ` David Masterson 2023-07-31 7:05 ` Ihor Radchenko 2023-07-31 7:40 ` Stefan Nobis 2023-07-31 10:23 ` Ihor Radchenko 2023-07-31 22:41 ` David Masterson 2023-08-01 8:11 ` Ihor Radchenko 2023-08-02 6:28 ` David Masterson 2023-08-02 6:52 ` Ihor Radchenko 2023-08-02 6:59 ` Ihor Radchenko 2023-08-02 17:14 ` David Masterson 2023-08-03 7:58 ` [PATCH] org-manual: Add references to LaTeX docs (was: New Orgmode LaTex Document Class ?) Ihor Radchenko 2023-08-06 3:35 ` [PATCH] org-manual: Add references to LaTeX docs David Masterson 2023-08-06 8:04 ` Ihor Radchenko 2023-08-02 7:49 ` New Orgmode LaTex Document Class ? tomas 2023-08-02 16:53 ` David Masterson 2023-08-02 17:29 ` tomas
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs/org-mode.git 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).