* Org-mode for Docbook and DITA
@ 2024-05-31 6:59 Mark Lewin
2024-05-31 8:30 ` Thomas Redelberger
0 siblings, 1 reply; 2+ messages in thread
From: Mark Lewin @ 2024-05-31 6:59 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 499 bytes --]
Hi all,
I'll shortly be starting a new role as a tech writer, where much of the docs are written in Docbook and DITA.
I'm hoping to do the bulk of my work in org-mode and export to the required format.
I've seen an exporter for Docbook, but I wonder if anyone has successfully used Emacs/org-mode to work with DITA content? Any recommendations? How are custom tags handled? And how can I best work with Docbook/DITA files that were created in another editor, like OxygenXML?
Thanks in advance.
[-- Attachment #2: Type: text/html, Size: 699 bytes --]
^ permalink raw reply [flat|nested] 2+ messages in thread
* Re: Org-mode for Docbook and DITA
2024-05-31 6:59 Org-mode for Docbook and DITA Mark Lewin
@ 2024-05-31 8:30 ` Thomas Redelberger
0 siblings, 0 replies; 2+ messages in thread
From: Thomas Redelberger @ 2024-05-31 8:30 UTC (permalink / raw)
To: emacs-orgmode
Hi Mark,
You might want to look at org-mode's built I exporters and/or using "pandoc". pandoc supports Docbook both on input and output and org-mode on input and output.
I use a Makefile when combining Emacs/org and pandoc. Alternatively you might want to use the Emacs package org-pandoc (ox-pandoc?), which helps with integration.
To go from org to Docbook and DITA - which are both XML formats - I would probably use org's XHTML export and then do an XSLT transformation to the target format.
You might want to look at my web site
https://web222.webclient5.de/doc/swdev/emacs/orgmode/html
It shows
1) How to customize the org HTML exporter
2) How to post-process the XHTML using an XSLT transformation (simple ELISP code included)
I do step 2) to further change the XHTML to my requirements. You would instead generate Docbook or DITA XML.
The main effort would be to develop the XSLT style sheets needed. Maybe somebody has already done that development work for HTML->Docbook and HTML->DITA
Regards "custom tags" (custom elements?):
- You can embed "raw HTML code" in org.
I have not checked, but this might cover any custom XML element
- If the semantics of the custom tags are covered by built-in org
constructs (like e.g. "properties", "tags") then you might be
able to transform from org to XML like mentioned above
I guess "round trip" functionality would be quite a challenge compared to one way conversion.
Best regards
Thomas
--
Thomas Redelberger
redetho@gmx.de
Am 31.05.2024 um 08:59 schrieb Mark Lewin:
> Hi all,
>
> I'll shortly be starting a new role as a tech writer, where much of the docs are written in Docbook and DITA.
>
> I'm hoping to do the bulk of my work in org-mode and export to the required format.
>
> I've seen an exporter for Docbook, but I wonder if anyone has successfully used Emacs/org-mode to work with DITA content? Any recommendations? How are custom tags handled? And how can I best work with Docbook/DITA files that were created in another editor, like OxygenXML?
>
> Thanks in advance.
>
>
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2024-05-31 8:31 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-05-31 6:59 Org-mode for Docbook and DITA Mark Lewin
2024-05-31 8:30 ` Thomas Redelberger
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).