emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [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).