Re: [RFC] Org version of the Org manual

[Jonathan Leech-Pepin <jonathan.leechpepin@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 3753 bytes --]

Hello Achim,

On 10 March 2013 08:24, Achim Gratz <Stromeko@nexgo.de> wrote:

> Thomas S. Dye writes:
> > That works nicely.  I found the error and orgmanual.pdf is now produced
> > without errors.
>
> Progress! :-)
>
> With the current version from git I cannot export to texinfo
> successfully, though, I get this error near the end of the export:
>
> Debugger entered--Lisp error: (wrong-type-argument stringp nil)
>   string-match("\\`[ \n.]+" nil) (if (string-match "\\`[ \n.]+" s)
>   (setq s (replace-match "" t t s))) org-trim(nil) (concat "\n@item "
>   (if tag desc) "\n" (org-trim contents) "\n") (let* ((tag
>   (org-element-property :tag item)) (desc (org-export-data tag info)))
>   (concat "\n@item " (if tag desc) "\n" (org-trim contents) "\n"))
>   org-texinfo-item((item (:bullet "- " :begin 41929 :end 42016
>   :contents-begin 42016 :contents-end 42016 :checkbox nil :counter nil
>   :hiddenp outline :structure ((40825 2 "- " nil nil "@@info:@kbd{@@C-c
>   /@@info:}@@, ~org-sparse-tree~" 41031) (41031 2 "- " nil nil
>   "@@info:@kbd{@@C-c / r@@info:}@@, ~org-occur~" 41929) (41929 2 "- "
>   nil nil "@@info:@kbd{@@M-g n@@info:}@@ or @@info:@kbd{@@M-g
>   M-n@@info:}@@, ~next-error~" 42016))…
>
> This may actually a bug in the texinfo exporter.
>
>
The error is actually on line 6069 of the manual.  The {{{vindex[...]}}}
line and
subsequent paragraph.  As far as the list is concerned there is no
associated
content for that list entry.  Indenting them appropriately to be recognized
as part
of the list allows for successful export.

This may also be partly a bug, should the exporter allow for a list item
without any contents?

Regards,

Jon

> > Is the html version of the Org manual generated from the .texi source?
> > If so, could you show me how to augment Makefile so the html
> > document is generated by `make orgmanual'?  I want to check if the html
> > document looks reasonable.
>
> I've extended the Makefile to approximate the one in doc/, HTML is
> produced both via makeinfo and as an export via ox-html.  To proceed in
> an orderly manner and prepare for an eventual integration into Org, can
> you please do the following in your Org clone:
>
> git checkout master
> git checkout -b orgmanual master
> git submodule add https://github.com/tsdye/orgmanual.git
> git commit -am 'make orgmanual/ a submodule'
>
> cd orgmanual
> git checkout -b orgmanual master
> git am orgmanual.patch
>
>
>
> cd ..
> git commit -am 'update submodule orgmanual'
> git am org.patch
>
>
>
> If you are unsure about any of this, please ask.  You can now edit/add
> these lines
>
> --8<---------------cut here---------------start------------->8---
> .PHONY: orgmanual
> EXTRADIRS=orgmanual
> orgmanual:
>         $(MAKE) -C $@
> --8<---------------cut here---------------end--------------->8---
>
> to the top of your local.mk and should now be able to do a "make
> orgmanual".  Which types of documentation are produced can be controlled
> with ORG_MAKE_DOC (default is "info pdf html"), just like for the
> official manuals.  Also, "make cleanall" will now clean up in orgmanual
> also.  BTEST_POST should be configured to have a load-path pointing to a
> sufficiently advanced htmlize version for the HTML export.
>
> > My next step will be to bring orgmanual up-to-date with the changes
> > that have been made to org.texi since I started the translation several
> > months ago.
>
> I'm not envious…
>
>
> Regards,
> Achim.
> --
> +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+
>
> SD adaptations for Waldorf Q V3.00R3 and Q+ V3.54R2:
> http://Synth.Stromeko.net/Downloads.html#WaldorfSDada
>
>

[-- Attachment #2: Type: text/html, Size: 4878 bytes --]