From mboxrd@z Thu Jan 1 00:00:00 1970 From: Randomcoder Subject: [proposal] better documentation around syntax highlighting Org-Mode code blocks when exporting to LaTeX Date: Tue, 17 Mar 2015 16:50:08 +0200 Message-ID: <20150317145008.GB14053@xw> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:39865) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXsp3-0003Ea-PW for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 10:50:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YXsoy-0005eC-Ar for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 10:50:21 -0400 Received: from mail-wi0-x22f.google.com ([2a00:1450:400c:c05::22f]:36235) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXsoy-0005Zf-40 for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 10:50:16 -0400 Received: by wibg7 with SMTP id g7so65321495wib.1 for ; Tue, 17 Mar 2015 07:50:15 -0700 (PDT) Received: from localhost ([188.25.252.62]) by mx.google.com with ESMTPSA id w3sm2993924wiz.5.2015.03.17.07.50.14 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 17 Mar 2015 07:50:14 -0700 (PDT) Content-Disposition: inline List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org 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/