asciidoctor.org
asciidoctor.org copied to clipboard
asciidoctor
Create page of AsciiDoc importers (tools to convert to AsciiDoc)
Hi,
I did not find a paragraph addressing the "I have existing documents how do I convert them?" need There is asciidoc converters but no importers.
To make it even more readable, I advise a drawing
Thanks
What about http://asciidoctor.org/docs/user-manual/#processing-your-content?
There is asciidoc converters but no importers.
I'm not sure what you mean by this. What's an importer?
To make it even more readable, I advise a drawing
Could you be more clear about which page you are talking about?
Hello Dan, Sorry, I filed this in a rush and was not clear.
My first point is that the user manual lacks a paragraph that list the available options to convert existing content FROM other formats TO asciidoc
And the image could be something like that
the corresponding plantuml is
@startuml Asciidoc -> doc: tool name doc --> Asciidoc: converter tool name
Asciidoc -> ODT: Another converter Asciidoc <-- ODT: another converter @enduml
No problem. Thanks for clarifying!
I think part of the reason I was confused is because Asciidoctor doesn't have any official tools yet for converting to AsciiDoc. There are some experimental efforts, including docbookrx https://github.com/opendevise/docbookrx and markdown2asciidoc https://github.com/bodiam/markdown-to-asciidoc. I suppose we'll want to emphasize those when we're comfortable recommending them. We'll probably create a page similar to http://asciidoctor.org/docs/extensions/.
I like the idea of the diagram!
Are we yet comfortable recommending these tools. I think adoption may be hindered by it: no reliable migration strategy. Particularly from Markdown to AsciiDoc which I would think would be the easiest path to migration.
Stuff like converting Markdown HTML table code into AsciiDoc markup would be a huge demonstration of the power of this mark-up.
An initial release of DocbookRx is coming soon, markdown2asciidoc is already available in the IntelliJ IDEA plugin and Kramdown AsciiDoc is coming along pretty quickly, so I'd say it's time to start preparing to cover them. Information about how to use them is covered in the respective repositories, so we can start pulling in that info.