* preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
@ 2014-03-06 12:47 Nicolas Richard
2014-03-13 14:26 ` Bastien
0 siblings, 1 reply; 11+ messages in thread
From: Nicolas Richard @ 2014-03-06 12:47 UTC (permalink / raw)
To: emacs-orgmode
Hello,
I was a little bit surprised that previewing latex fragments doesn't use
the same class as latex export. That's contrary to my expectation but I
don't know how to fix it. The reason I expected that is : I set a
default (personnal) latex class which defines many commands that I use
everyday when writing latex, and thus also when writing latex in org
documents.
Also, it took me a lot of time to find out that org-format-latex-header
was used for previewing latex fragments. I suggest that we mention it in
the manual in (info "(org) Previewing LaTeX fragments"). It's already
mentionned in (info "(org) LaTeX fragments") in a footnote, but I think
the variable must be found in the "Previewing" section too.
Here's a patch to do it, but maybe the whole footnote should be moved to
the "Previewing" section instead ?
From: Nicolas Richard <theonewiththeevillook@yahoo.fr>
Date: Thu, 6 Mar 2014 13:21:41 +0100
Subject: [PATCH] * doc/org.texi: mention org-format-latex-header near
org-format-latex-options
---
doc/org.texi | 9 +++++----
1 file changed, 5 insertions(+), 4 deletions(-)
diff --git a/doc/org.texi b/doc/org.texi
index 7e66034..b85f8c0 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -10228,10 +10228,11 @@ Remove the overlay preview images.
@end table
@vindex org-format-latex-options
-You can customize the variable @code{org-format-latex-options} to influence
-some aspects of the preview. In particular, the @code{:scale} (and for HTML
-export, @code{:html-scale}) property can be used to adjust the size of the
-preview images.
+@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.8.5.2
^ permalink raw reply related [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-06 12:47 preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)] Nicolas Richard
@ 2014-03-13 14:26 ` Bastien
2014-03-19 22:22 ` Nicolas Richard
0 siblings, 1 reply; 11+ messages in thread
From: Bastien @ 2014-03-13 14:26 UTC (permalink / raw)
To: Nicolas Richard; +Cc: emacs-orgmode
Hi Nicolas,
Nicolas Richard <theonewiththeevillook@yahoo.fr> writes:
> Also, it took me a lot of time to find out that org-format-latex-header
> was used for previewing latex fragments. I suggest that we mention it in
> the manual in (info "(org) Previewing LaTeX fragments"). It's already
> mentionned in (info "(org) LaTeX fragments") in a footnote, but I think
> the variable must be found in the "Previewing" section too.
Agreed.
> Here's a patch to do it, but maybe the whole footnote should be moved to
> the "Previewing" section instead ?
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!
--
Bastien
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-13 14:26 ` Bastien
@ 2014-03-19 22:22 ` Nicolas Richard
2014-03-20 10:55 ` Bastien
0 siblings, 1 reply; 11+ messages in thread
From: Nicolas Richard @ 2014-03-19 22:22 UTC (permalink / raw)
To: Bastien; +Cc: Nicolas Richard, emacs-orgmode
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 <theonewiththeevillook@yahoo.fr>
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
^ permalink raw reply related [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-19 22:22 ` Nicolas Richard
@ 2014-03-20 10:55 ` Bastien
2014-03-20 11:13 ` Nicolas Richard
2014-03-22 16:15 ` Nicolas Richard
0 siblings, 2 replies; 11+ messages in thread
From: Bastien @ 2014-03-20 10:55 UTC (permalink / raw)
To: Nicolas Richard; +Cc: emacs-orgmode
Hi Nicolas,
Nicolas Richard <theonewiththeevillook@yahoo.fr> writes:
> 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).
I can't apply the patch, either on maint or on master, but by reading
it carefully it looks good.
Just add a missing full-stop at the end of the Changelog sentence "in
its own section.", and perhaps use `C-x 4 a' from within the diff to
include the section's name in the Changelog too.
PS: I didn't check carefully because I don't use `C' from magit, but
I assume magit may be wrong in creating Changelogs. We should report
this to magit maintainers if this is true.
--
Bastien
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-20 10:55 ` Bastien
@ 2014-03-20 11:13 ` Nicolas Richard
2014-03-20 21:56 ` Bastien
2014-03-22 16:15 ` Nicolas Richard
1 sibling, 1 reply; 11+ messages in thread
From: Nicolas Richard @ 2014-03-20 11:13 UTC (permalink / raw)
To: Bastien; +Cc: emacs-orgmode
Le 20/03/2014 11:55, Bastien a écrit :
> Hi Nicolas,
>
> Nicolas Richard <theonewiththeevillook@yahoo.fr> writes:
>
>> 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).
>
> I can't apply the patch, either on maint or on master, but by reading
> it carefully it looks good.
> Just add a missing full-stop at the end of the Changelog sentence "in
> its own section.", and perhaps use `C-x 4 a' from within the diff to
> include the section's name in the Changelog too.
Ok, I'll fix that and make sure it can be applied to master (I'm not
sure how I managed to miss that part.)
> PS: I didn't check carefully because I don't use `C' from magit, but
> I assume magit may be wrong in creating Changelogs. We should report
> this to magit maintainers if this is true.
Indeed there usually is some difference between C (magit) and C-x 4 a. I
will have a look and report it when I get a chance.
--
Nico.
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-20 11:13 ` Nicolas Richard
@ 2014-03-20 21:56 ` Bastien
0 siblings, 0 replies; 11+ messages in thread
From: Bastien @ 2014-03-20 21:56 UTC (permalink / raw)
To: Nicolas Richard; +Cc: emacs-orgmode
Nicolas Richard <theonewiththeevillook@yahoo.fr> writes:
> Indeed there usually is some difference between C (magit) and C-x 4 a. I
> will have a look and report it when I get a chance.
That'd be great, thanks,
--
Bastien
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-20 10:55 ` Bastien
2014-03-20 11:13 ` Nicolas Richard
@ 2014-03-22 16:15 ` Nicolas Richard
2014-03-22 16:41 ` Bastien
1 sibling, 1 reply; 11+ messages in thread
From: Nicolas Richard @ 2014-03-22 16:15 UTC (permalink / raw)
To: Bastien; +Cc: Nicolas Richard, emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 768 bytes --]
Hello Bastien,
Bastien <bzg@gnu.org> writes:
> Just add a missing full-stop at the end of the Changelog sentence "in
> its own section.",
Done
> and perhaps use `C-x 4 a' from within the diff to
> include the section's name in the Changelog too.
I tried that in both parts of the diff, but then I get :
* org.texi (used, lines):
(The lines 'used:' and 'lines:' appear in that file.)
I guess that's not the intended result so I left that as is.
> PS: I didn't check carefully because I don't use `C' from magit, but
> I assume magit may be wrong in creating Changelogs. We should report
> this to magit maintainers if this is true.
In this case it seems that nothing was better than doing what C-x 4 a
did, so I didn't check further.
Here's the new patch :
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Keep-documentation-on-Previewing-LaTeX-in-its-own-se.patch --]
[-- Type: text/x-diff, Size: 3954 bytes --]
From cf5246c5f44fe637cb2000cf92b2f47499d7b8d2 Mon Sep 17 00:00:00 2001
From: Nicolas Richard <theonewiththeevillook@yahoo.fr>
Date: Thu, 6 Mar 2014 13:21:41 +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 | 38 ++++++++++++++++++--------------------
1 file changed, 18 insertions(+), 20 deletions(-)
diff --git a/doc/org.texi b/doc/org.texi
index e835022..2abfa66 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -10147,19 +10147,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:
@@ -10217,11 +10211,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
@@ -10237,12 +10241,6 @@ process the entire buffer.
Remove the overlay preview images.
@end table
-@vindex org-format-latex-options
-You can customize the variable @code{org-format-latex-options} to influence
-some aspects of the preview. In particular, the @code{:scale} (and for HTML
-export, @code{:html-scale}) property 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
^ permalink raw reply related [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-22 16:15 ` Nicolas Richard
@ 2014-03-22 16:41 ` Bastien
2014-03-22 17:09 ` Nicolas Richard
0 siblings, 1 reply; 11+ messages in thread
From: Bastien @ 2014-03-22 16:41 UTC (permalink / raw)
To: Nicolas Richard; +Cc: emacs-orgmode
Hi Nicolas,
Nicolas Richard <theonewiththeevillook@yahoo.fr> writes:
> Done
Thanks, applied on master, with a slight change in the Changelog
entry.
--
Bastien
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-22 16:41 ` Bastien
@ 2014-03-22 17:09 ` Nicolas Richard
2014-03-23 8:29 ` Bastien
0 siblings, 1 reply; 11+ messages in thread
From: Nicolas Richard @ 2014-03-22 17:09 UTC (permalink / raw)
To: Bastien; +Cc: emacs-orgmode
Bastien <bzg@gnu.org> writes:
> Thanks, applied on master, with a slight change in the Changelog
> entry.
Ok thanks. For my information, did C-x 4 a work for you in adding the
section name or did you add it manually ?
--
Nico.
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-22 17:09 ` Nicolas Richard
@ 2014-03-23 8:29 ` Bastien
2014-03-23 9:53 ` Nicolas Richard
0 siblings, 1 reply; 11+ messages in thread
From: Bastien @ 2014-03-23 8:29 UTC (permalink / raw)
To: Nicolas Richard; +Cc: emacs-orgmode
Hi Nicolas,
Nicolas Richard <theonewiththeevillook@yahoo.fr> writes:
> Ok thanks. For my information, did C-x 4 a work for you in adding the
> section name or did you add it manually ?
It worked from the diff.
I applied your patch with git apply, then went to the modified file,
then C-x v =, then hit `n' to go to the next change and `C-x 4 a' to
create the Changelog.
HTH,
--
Bastien
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)]
2014-03-23 8:29 ` Bastien
@ 2014-03-23 9:53 ` Nicolas Richard
0 siblings, 0 replies; 11+ messages in thread
From: Nicolas Richard @ 2014-03-23 9:53 UTC (permalink / raw)
To: Bastien; +Cc: Nicolas Richard, emacs-orgmode
Bastien <bzg@gnu.org> writes:
> It worked from the diff.
>
> I applied your patch with git apply, then went to the modified file,
> then C-x v =, then hit `n' to go to the next change and `C-x 4 a' to
> create the Changelog.
Thanks, I'll try again and hopefully find out what's wrong with what I
did.
Nico.
^ permalink raw reply [flat|nested] 11+ messages in thread
end of thread, other threads:[~2014-03-23 9:53 UTC | newest]
Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-03-06 12:47 preview and default class [8.2.5h (release_8.2.5h-677-g55b0a3 @ /home/youngfrog/sourcetrees/org-mode/lisp/)] Nicolas Richard
2014-03-13 14:26 ` Bastien
2014-03-19 22:22 ` Nicolas Richard
2014-03-20 10:55 ` Bastien
2014-03-20 11:13 ` Nicolas Richard
2014-03-20 21:56 ` Bastien
2014-03-22 16:15 ` Nicolas Richard
2014-03-22 16:41 ` Bastien
2014-03-22 17:09 ` Nicolas Richard
2014-03-23 8:29 ` Bastien
2014-03-23 9:53 ` Nicolas Richard
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).