From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Richard Subject: Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)] Date: Wed, 19 Mar 2014 23:22:54 +0100 Message-ID: <87wqfpx1z5.fsf@yahoo.fr> References: <87pplzbijh.fsf@yahoo.fr> <87y50euqc8.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:53011) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WQOt6-0004uN-Vy for emacs-orgmode@gnu.org; Wed, 19 Mar 2014 18:23:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WQOt0-00065F-HR for emacs-orgmode@gnu.org; Wed, 19 Mar 2014 18:23:04 -0400 In-Reply-To: <87y50euqc8.fsf@bzg.ath.cx> (Bastien's message of "Thu, 13 Mar 2014 15:26:47 +0100") 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: Bastien Cc: Nicolas Richard , emacs-orgmode@gnu.org Hi Bastien, > Mhh, yes, I'm for moving it to the previewing section. > > Do you want to get commit access so that you can fix this directly? > Otherwise, just send a patch and I'll apply it. > > Thanks! Here's a patch. I can commit it if you like, but I don't want to do so without some review (it's not as trivial a change as moving the corresponding footnote to the other section). >From 4b431a0fc2a4df7cecd8b6649227415ed86e7f7c Mon Sep 17 00:00:00 2001 From: Nicolas Richard Date: Wed, 19 Mar 2014 23:13:39 +0100 Subject: [PATCH] Keep documentation on "Previewing LaTeX" in its own section * doc/org.texi: Keep documentation on "Previewing LaTeX" in its own section --- doc/org.texi | 39 ++++++++++++++++++--------------------- 1 file changed, 18 insertions(+), 21 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index c442f83..447cde9 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -10140,19 +10140,13 @@ format sub- and superscripts in a WYSIWYM way. Going beyond symbols and sub- and superscripts, a full formula language is needed. Org mode can contain @LaTeX{} math fragments, and it supports ways to process these for several export back-ends. When exporting to @LaTeX{}, -the code is obviously left as it is. When exporting to HTML, Org invokes the -@uref{http://www.mathjax.org, MathJax library} (@pxref{Math formatting in +the code is obviously left as it is. When exporting to HTML, Org can invoke +the @uref{http://www.mathjax.org, MathJax library} (@pxref{Math formatting in HTML export}) to process and display the math@footnote{If you plan to use this regularly or on pages with significant page views, you should install @file{MathJax} on your own server in order to limit the load of our server.}. -Finally, it can also process the mathematical expressions into -images@footnote{For this to work you need to be on a system with a working -@LaTeX{} installation. You also need the @file{dvipng} program or the -@file{convert}, respectively available at -@url{http://sourceforge.net/projects/dvipng/} and from the @file{imagemagick} -suite. The @LaTeX{} header that will be used when processing a fragment can -be configured with the variable @code{org-format-latex-header}.} that can be -displayed in a browser. +It can also process the mathematical expressions into images that can be +displayed in a browser (see @pxref{Previewing @LaTeX{} fragments}). @LaTeX{} fragments don't need any special marking at all. The following snippets will be identified as @LaTeX{} source code: @@ -10210,11 +10204,21 @@ lines: @cindex @LaTeX{} fragments, preview @vindex org-latex-create-formula-image-program -If you have @file{dvipng} or @file{imagemagick} installed@footnote{Choose the -converter by setting the variable +If you have a working @LaTeX{} installation and either @file{dvipng} or +@file{convert} installed@footnote{These are respectively available at +@url{http://sourceforge.net/projects/dvipng/} and from the @file{imagemagick} +suite. Choose the converter by setting the variable @code{org-latex-create-formula-image-program} accordingly.}, @LaTeX{} -fragments can be processed to produce preview images of the typeset -expressions: +fragments can be processed to produce images of the typeset expressions to be +used for inclusion while exporting to HTML (see @pxref{@LaTeX{} fragments}), +or for inline previewing within Org mode. + +@vindex org-format-latex-options +@vindex org-format-latex-header +You can customize the variables @code{org-format-latex-options} and +@code{org-format-latex-header} to influence some aspects of the preview. In +particular, the @code{:scale} (and for HTML export, @code{:html-scale}) +property of the former can be used to adjust the size of the preview images. @table @kbd @kindex C-c C-x C-l @@ -10230,13 +10234,6 @@ process the entire buffer. Remove the overlay preview images. @end table -@vindex org-format-latex-options -@vindex org-format-latex-header -You can customize the variables @code{org-format-latex-options} and -@code{org-format-latex-header} to influence some aspects of the preview. In -particular, the @code{:scale} (and for HTML export, @code{:html-scale}) -property of the former can be used to adjust the size of the preview images. - @vindex org-startup-with-latex-preview You can turn on the previewing of all @LaTeX{} fragments in a file with -- 1.9.1