Org mode manual export

Org mode manual export

[Thomas S. Dye]

Aloha all,

The Org mode FAQ on Worg correctly reports that the Org mode 
manual is written in Org mode, but it implies that it is exported 
to texinfo using pandoc--"You can export .org files to texinfo 
using Pandoc".

I thought the manual was exported to texinfo with ox-texinfo, but 
I don't know for certain.

Can someone confirm how the Org mode manual is exported to 
texinfo, please?

I'll update the FAQ if necessary.

All the best,
Tom

--
Thomas S. Dye
https://tsdye.online/tsdye

Re: Org mode manual export

[Greg Minshall]

Thomas, indeed, aloha.

while waiting for authoritative information, i'll notice that the
Makefile calls an elisp function
----
(defun org-make-manuals ()
  "Generate the Texinfo files out of Org manuals."
  (require 'ox-texinfo)
  (dolist (manual '("../doc/org-manual.org" "../doc/org-guide.org"))
    (find-file manual)
    (org-texinfo-export-to-texinfo)))
----

and, (org-texinfo-export-to-texinfo) (in ox-texinfo.el) seems a
fully-functioning export module, and i don't see any reference to pandoc
in it.  (but, i've never looked at that code before.)

cheers, Greg

Re: Org mode manual export

[Kyle Meyer]

Thomas S. Dye writes:

> Aloha all,
>
> The Org mode FAQ on Worg correctly reports that the Org mode 
> manual is written in Org mode, but it implies that it is exported 
> to texinfo using pandoc--"You can export .org files to texinfo 
> using Pandoc".
>
> I thought the manual was exported to texinfo with ox-texinfo, but 
> I don't know for certain.
>
> Can someone confirm how the Org mode manual is exported to 
> texinfo, please?

Yes, you're right that ox-texinfo is used.

In doc/Makefile there's

  org.texi orgguide.texi:	org-manual.org org-guide.org
  	$(BATCH) 				      \
  	  --eval '(add-to-list `load-path "../lisp")' \
  	  --eval '(load "../mk/org-fixup.el")' 	      \
  	  --eval '(org-make-manuals)'

where org-make-manuals is defined in mk/org-fixup.el as

  (defun org-make-manuals ()
    "Generate the Texinfo files out of Org manuals."
    (require 'ox-texinfo)
    (dolist (manual '("../doc/org-manual.org" "../doc/org-guide.org"))
      (find-file manual)
      (org-texinfo-export-to-texinfo)))

Re: Org mode manual export

[Thomas S. Dye]

Done.  Thanks!

All the best,
Tom

Kyle Meyer <kyle@kyleam.com> writes:

> Thomas S. Dye writes:
>
>> Aloha all,
>>
>> The Org mode FAQ on Worg correctly reports that the Org mode
>> manual is written in Org mode, but it implies that it is 
>> exported
>> to texinfo using pandoc--"You can export .org files to texinfo
>> using Pandoc".
>>
>> I thought the manual was exported to texinfo with ox-texinfo, 
>> but
>> I don't know for certain.
>>
>> Can someone confirm how the Org mode manual is exported to
>> texinfo, please?
>
> Yes, you're right that ox-texinfo is used.
>
> In doc/Makefile there's
>
>   org.texi orgguide.texi:	org-manual.org org-guide.org
>   	$(BATCH) 				      \
>   	  --eval '(add-to-list `load-path "../lisp")' \
>   	  --eval '(load "../mk/org-fixup.el")' 	      \
>   	  --eval '(org-make-manuals)'
>
> where org-make-manuals is defined in mk/org-fixup.el as
>
>   (defun org-make-manuals ()
>     "Generate the Texinfo files out of Org manuals."
>     (require 'ox-texinfo)
>     (dolist (manual '("../doc/org-manual.org" 
>     "../doc/org-guide.org"))
>       (find-file manual)
>       (org-texinfo-export-to-texinfo)))


--
Thomas S. Dye
https://tsdye.online/tsdye