asciidoctor / asciidoctor.org

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

Add list of extensions and extension descriptions to documentation #384

Closed graphitefriction closed 9 years ago

graphitefriction commented 9 years ago

This issue was spawned from PR: https://github.com/asciidoctor/asciidoctor.org/pull/372

Name: Asciidoctor Screenshot Description: Automate the inclusion of dynamically-generated screenshots into your documentation. Runtime: AsciidoctorJ URL: http://fix.github.io/asciidoctor-screenshot/

Name: Asciidoctor Gherkin Description: Include Gherkin feature files in AsciiDoc in the form of sections, paragraphs, lists and tables. Runtime: AsciidoctorJ URL: https://github.com/domgold/asciidoctor-gherkin-extension

Name: Markup Document Builder Description: This project is a document builder for markup documents, including AsciiDoc. Runtime: AsciidoctorJ URL: https://github.com/RobWin/markup-document-builder

The Markup Document Builder might end up being an infrastructure component rather than an extension.

Name: Asciidoctor Diagram Description: A set of extensions for Asciidoctor that allow you to embed diagrams written using the PlantUML, Graphviz, ditaa, or Shaape syntax inside your AsciiDoc documents. Runtime: Asciidoctor URL: https://github.com/asciidoctor/asciidoctor-diagram and/or http://asciidoctor.org/docs/asciidoctor-diagram/

Name: Asciidoctor LaTeX Description: Asciidoc-LaTeX makes it possible to render documents written in AsciiDoc to LaTeX or HTML. It also defines an extended mathematical syntax for the AsciiDoc markup language that closely parallels LaTeX. Runtime: Asciidoctor URL: https://github.com/asciidoctor/asciidoctor-latex

Asciidoctor LaTeX has it's foot both in the extension world and the converter world, so I think it will end up showing up in both places (assuming we have a converters page or section in the future).

The extension lab should be highlighted here as well. I would put it under "other" because it's more of a playground.

Name: Extension Lab Description: A playground for new and experimental extensions. Used to test the capabilities of the extension mechanism. Runtime: Asciidoctor URL: https://github.com/asciidoctor/asciidoctor-extensions-lab

Possible sorting structure:

mojavelinux commented 9 years ago

I think it might also be helpful to have a complete index of the components in the Asciidoctor ecosystem, whether they are extensions are not. I've created an initial list and posted it on Google+.

https://plus.google.com/114112334290393746697/posts/C1QLRBynXTB

jirutka commented 9 years ago

DocTest is missing on the list. :(

mojavelinux commented 9 years ago

Zonk! What was I thinking?!? (actually, I didn't think it wasn't pertinent for what was being asked in the contract :)) But I'll definitely add it to the G+ post.