* [proposal] better documentation around syntax highlighting Org-Mode code blocks when exporting to LaTeX
@ 2015-03-17 14:50 Randomcoder
2015-03-17 15:02 ` Nicolas Goaziou
0 siblings, 1 reply; 2+ messages in thread
From: Randomcoder @ 2015-03-17 14:50 UTC (permalink / raw)
To: emacs-orgmode
Hi,
While writing technical documents, as a programmer and an Org-Mode user,
for me it's important to have ways to syntax highlight code blocks when
exporting them to LaTeX.
While I am aware of the customizations that need to be done
to Org-Mode's configuration in order to get that to work, in
particular customizing these variables(see [1] for details):
* org-latex-listings
* org-latex-custom-lang-environments
* org-latex-minted-options
and having tried them, I got this working for one document, but it
really felt like a lot of trial-and-error and a lot of room for error
on my side as a user.
Although this is Org-Mode and it is supposed to be very customizable
(like Emacs is), I still believe the documentation and the implementation
can be improved on this.
I think there's even reason to believe that this should be working out
of the box. The only reason I see for this not being the default setting
is to not add pygments [2] as a dependency. Still, I think it should be
much easier for me as a user to spend less time getting it to work.
I welcome any feedback on this.
Thank you for taking the time to read my proposal.
[1] http://orgmode.org/worg/org-tutorials/org-latex-export.html#sec-12-2
[2] http://pygments.org/
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: [proposal] better documentation around syntax highlighting Org-Mode code blocks when exporting to LaTeX
2015-03-17 14:50 [proposal] better documentation around syntax highlighting Org-Mode code blocks when exporting to LaTeX Randomcoder
@ 2015-03-17 15:02 ` Nicolas Goaziou
0 siblings, 0 replies; 2+ messages in thread
From: Nicolas Goaziou @ 2015-03-17 15:02 UTC (permalink / raw)
To: Randomcoder; +Cc: emacs-orgmode
Hello,
Randomcoder <randomcoder1@gmail.com> writes:
> While writing technical documents, as a programmer and an Org-Mode user,
> for me it's important to have ways to syntax highlight code blocks when
> exporting them to LaTeX.
>
> While I am aware of the customizations that need to be done
> to Org-Mode's configuration in order to get that to work, in
> particular customizing these variables(see [1] for details):
>
> * org-latex-listings
> * org-latex-custom-lang-environments
> * org-latex-minted-options
Did you read `org-latex-listings' docstring? If so, what do you think is
missing or not clear enough?
> and having tried them, I got this working for one document, but it
> really felt like a lot of trial-and-error and a lot of room for error
> on my side as a user.
>
> Although this is Org-Mode and it is supposed to be very customizable
> (like Emacs is), I still believe the documentation and the implementation
> can be improved on this.
What do you suggest, concretely?
> I think there's even reason to believe that this should be working out
> of the box.
I think the default value is right. Any other value requires the user
additional steps (requiring "listings" package or even adding pygments
as a dependency)
Regards,
--
Nicolas Goaziou
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2015-03-17 15:23 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-03-17 14:50 [proposal] better documentation around syntax highlighting Org-Mode code blocks when exporting to LaTeX Randomcoder
2015-03-17 15:02 ` Nicolas Goaziou
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).