search

asciidoctor / asciidoctor.org

:globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
https://asciidoctor.org
Other
322 stars 805 forks source link

Create page of AsciiDoc importers (tools to convert to AsciiDoc) #386

Open wadael opened 9 years ago

wadael commented 9 years ago

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

mojavelinux commented 9 years ago

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?

wadael commented 9 years ago

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

image

the corresponding plantuml is

@startuml Asciidoc -> doc: tool name doc --> Asciidoc: converter tool name

Asciidoc -> ODT: Another converter Asciidoc <-- ODT: another converter @enduml

mojavelinux commented 9 years ago

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!

jaredmorgs commented 8 years ago

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.

mojavelinux commented 8 years ago

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.

mojavelinux commented 5 years ago

Kramdown AsciiDoc is now released, with a 1.0.0 version happening soon.