An HTML Export Observation

An HTML Export Observation

[Scott Randby]

When I look at the "Org Export HTML Group" for customization, I get the
following:

Org Export Html Validation Link: Show Value
   State: UNINITIALIZED, you should not see this.
   Link to HTML validation service.

Org Export Html With Timestamp: Hide Value Toggle  off (nil)
   State: UNINITIALIZED, you should not see this.
   If non-nil, write timestamp into the exported HTML text. More

The other variables in this group are also uninitialized. The other org
export groups (such as "Org Export LaTeX") do not contain uninitialized
variables. Why is it that the variables I need the most do not work?

Scott Randby

Re: An HTML Export Observation

[Nick Dokos]

Scott Randby <srandby@gmail.com> wrote:

> When I look at the "Org Export HTML Group" for customization, I get the
> following:
> 
> Org Export Html Validation Link: Show Value
>    State: UNINITIALIZED, you should not see this.
>    Link to HTML validation service.
> 
> Org Export Html With Timestamp: Hide Value Toggle  off (nil)
>    State: UNINITIALIZED, you should not see this.
>    If non-nil, write timestamp into the exported HTML text. More
> 
> The other variables in this group are also uninitialized. The other org
> export groups (such as "Org Export LaTeX") do not contain uninitialized
> variables. Why is it that the variables I need the most do not work?
> 

I can't answer that question, but if you care to try, the following should
work as a temporary solution, until all this is cleared up: add

(setq org-export-html-postamble "<p class=\"author\">Author: %a (%e)</p>\n<p class=\"date\">Date: %d</p>\n<p class=\"creator\">Generated by %c</p>\n")

to your .emacs and either restart emacs or evaluate the form (place the
cursor after the closing paren and press `C-x C-e'); then export
normally. In principle, I think this should work with a file option, but
a few minutes of experimentation have not brought any happiness.

See the documentation for the variable org-export-html-postamble-format
for the %X escapes:

,----
| %a stands for the author.
| %e stands for the email(s).
| %d stands for the date.
| %c will be replaced by information about Org/Emacs.
| %v will be replaced by `org-export-html-validation-link'.
| 
| If you need to use a "%" character, you need to escape it
| like that: "%%".
`----

As for your previous email re. @<b>, the very latest git seems to have
fixed that problem.

But there is obviously some churn in the HTML export area. Your
idea about going back to 7.4 might be the way to go for a little
while until all this is cleared up.

Nick

[PATCH] Move org-export-html group definition to fix uninitialized customs.

[Manuel Giraud]

---
 lisp/org-exp.el  |    5 +++++
 lisp/org-html.el |    5 -----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/lisp/org-exp.el b/lisp/org-exp.el
index 34f101d..2cd4289 100644
--- a/lisp/org-exp.el
+++ b/lisp/org-exp.el
@@ -134,6 +134,11 @@ This is without condition, so even subtrees inside that carry one of the
   :group 'org-export-general
   :type '(repeat (string :tag "Tag")))
 
+(defgroup org-export-html nil
+  "Options specific for HTML export of Org-mode files."
+  :tag "Org Export HTML"
+  :group 'org-export)
+
 ;; FIXME: rename, this is a general variable
 (defcustom org-export-html-expand t
   "Non-nil means for HTML export, treat @<...> as HTML tag.
diff --git a/lisp/org-html.el b/lisp/org-html.el
index d9f34ef..a17b044 100644
--- a/lisp/org-html.el
+++ b/lisp/org-html.el
@@ -36,11 +36,6 @@
 (declare-function org-id-find-id-file "org-id" (id))
 (declare-function htmlize-region "ext:htmlize" (beg end))
 
-(defgroup org-export-html nil
-  "Options specific for HTML export of Org-mode files."
-  :tag "Org Export HTML"
-  :group 'org-export)
-
 (defcustom org-export-html-footnotes-section "<div id=\"footnotes\">
 <h2 class=\"footnotes\">%s: </h2>
 <div id=\"text-footnotes\">
-- 
1.7.1

Re: [PATCH] Move org-export-html group definition to fix uninitialized customs.

[Bastien]

Hi Manuel,

did that patch fix the problem for you?

There was a problem with the custom type definition of the variable
`org-export-html-protect-char-alist', and AFAIU that caused Scott's
problem.  I fixed this.

I think org-html.el is the right place for declaring the Org Export Html
customization group -- I'm curious to understand why your patch would
have fixed Scott's issue.

Thanks!

-- 
 Bastien

Re: [PATCH] Move org-export-html group definition to fix uninitialized customs.

[Manuel Giraud]

Bastien <bzg@altern.org> writes:

> Hi Manuel,
>
> did that patch fix the problem for you?

Hi Bastien,

Just re-check and yes it fixes the problem for me. I tried with "emacs
-Q", add org path to load-path, (require 'org) and M-x customize-group.
My patch was applied on top of:
--8<---------------cut here---------------start------------->8---
commit f8c627a44b65b081b1ca0668081dc7fefd70c002
Author: Nicolas Goaziou <n.goaziou@gmail.com>
Date:   Mon Mar 14 23:36:19 2011 +0100

    org-list: fix parsing of counters
    
    * lisp/org-list.el (org-list-parse-list): fixed regexp.
--8<---------------cut here---------------end--------------->8---

> I think org-html.el is the right place for declaring the Org Export Html
> customization group -- I'm curious to understand why your patch would
> have fixed Scott's issue.

I have to say that I don't understand too. I've just mimic what is done
for org-export-xml group and others. Anyway, if yours is ok discard
mine.

-- 
Manuel Giraud

Re: [PATCH] Move org-export-html group definition to fix uninitialized customs.

[Bastien]

Hi Manuel,

Manuel Giraud <manuel.giraud@univ-nantes.fr> writes:

> I have to say that I don't understand too. I've just mimic what is done
> for org-export-xml group and others. Anyway, if yours is ok discard
> mine.

Actually, the org-export-xml is unused, I just removed it.

Other group (like org-export-icalendar) are defined in org-icalendar.el.

Thanks,

-- 
 Bastien

Re: An HTML Export Observation

[Bastien]

Hi Scott,

Scott Randby <srandby@gmail.com> writes:

> When I look at the "Org Export HTML Group" for customization, I get the
> following:
>
> Org Export Html Validation Link: Show Value
>    State: UNINITIALIZED, you should not see this.
>    Link to HTML validation service.
>
> Org Export Html With Timestamp: Hide Value Toggle  off (nil)
>    State: UNINITIALIZED, you should not see this.
>    If non-nil, write timestamp into the exported HTML text. More
>
> The other variables in this group are also uninitialized. The other org
> export groups (such as "Org Export LaTeX") do not contain uninitialized
> variables. Why is it that the variables I need the most do not work?

There was a typo in the definition of the custom type of
`org-export-html-protect-char-alist'.  I just fixed this.  Please
confirm you don't have this error again.

Thanks!

-- 
 Bastien

Re: An HTML Export Observation

[Scott Randby]

On 03/15/2011 09:14 AM, Bastien wrote:
> Hi Scott,
>
> Scott Randby <srandby@gmail.com> writes:
>
>> When I look at the "Org Export HTML Group" for customization, I get the
>> following:
>>
>> Org Export Html Validation Link: Show Value
>>    State: UNINITIALIZED, you should not see this.
>>    Link to HTML validation service.
>>
>> Org Export Html With Timestamp: Hide Value Toggle  off (nil)
>>    State: UNINITIALIZED, you should not see this.
>>    If non-nil, write timestamp into the exported HTML text. More
>>
>> The other variables in this group are also uninitialized. The other org
>> export groups (such as "Org Export LaTeX") do not contain uninitialized
>> variables. Why is it that the variables I need the most do not work?
>
> There was a typo in the definition of the custom type of
> `org-export-html-protect-char-alist'.  I just fixed this.  Please
> confirm you don't have this error again.


Almost everything is fixed now. The variables in the "Org Export HTML
Group" work as they should, and the @<tag> issue is fixed. Thanks to
everyone for their help. But there is one remaining issue -- I can't get
timestamps in the postamble.

First, I am using org-mode release_7.5.41.g187b.

In my document, I have the following:
#+OPTIONS: H:3 num:nil skip:nil toc:t author:t timestamp:t email:t creator:t

I looked through the export variables for anything that mentioned
timestamps and the following now appears in my .emacs:
 '(org-export-html-with-timestamp t)
 '(org-export-time-stamp-file t)
 '(org-export-with-timestamps t)

But when I do C-c C-e h on the document, the author, email, and creator
appear in the postamble, but no timestamp.

I can get the timestamp if I put the following in my .emacs (following
the instructions given by Nick Dokos):
(setq org-export-html-postamble "<p class=\"author\">Author: %a
(%e)</p>\n<p class=\"date\">Date: %d</p>\n<p class=\"creator\">Generated
by %c</p>\n")

However, I would rather have the above in my document instead of my
.emacs, but Nick says he can't get that to work. I saw in the manual
that one may set up a project and publish it. Then one could set the
:html-postamble option for the project, but I don't have time right now
to learn how to set up a project.

Scott Randby

Re: An HTML Export Observation

[Bastien]

Hi Scott,

Scott Randby <srandby@gmail.com> writes:

> First, I am using org-mode release_7.5.41.g187b.

Please make sure to pull after this commit:

http://orgmode.org/w/?p=org-mode.git;a=commit;h=1b02fe8c6e3693a321bfc4d2da52fa64a7d22590

>  '(org-export-html-with-timestamp t)

This control the insertion of html-helper timestamp section.

>  '(org-export-time-stamp-file t)

This is the one you want. (:time-stamp-file in a publishing project).

>  '(org-export-with-timestamps t)
>
> But when I do C-c C-e h on the document, the author, email, and creator
> appear in the postamble, but no timestamp.

It works here with latest git.

-- 
 Bastien

Re: An HTML Export Observation

[Scott Randby]

On 03/15/2011 11:53 AM, Bastien wrote:
> Hi Scott,
> 
> Scott Randby <srandby@gmail.com> writes:
> 
>> First, I am using org-mode release_7.5.41.g187b.
> 
> Please make sure to pull after this commit:
> 
> http://orgmode.org/w/?p=org-mode.git;a=commit;h=1b02fe8c6e3693a321bfc4d2da52fa64a7d22590
> 
>>  '(org-export-html-with-timestamp t)
> 
> This control the insertion of html-helper timestamp section.

This answers the question I asked in the email I just sent. Thanks.

> 
>>  '(org-export-time-stamp-file t)
> 
> This is the one you want. (:time-stamp-file in a publishing project).
> 
>>  '(org-export-with-timestamps t)
>>
>> But when I do C-c C-e h on the document, the author, email, and creator
>> appear in the postamble, but no timestamp.
> 
> It works here with latest git.
>