Profile cover photo
Profile photo
Asciidoctor
159 followers -
An open source Ruby processor for converting AsciiDoc markup into HTML 5, DocBook 4.5 and other formats
An open source Ruby processor for converting AsciiDoc markup into HTML 5, DocBook 4.5 and other formats

159 followers
About
Posts

Post has shared content
Thanks to Jérémie, Asciidoctor is making waves at Eclipse. Find out why in this short talk.
Mon #Talk sur +Asciidoctor est déjà en ligne (#EclipseCon Europe 2015). Mon anglais est ce qu'il est, mais cela donne un bon aperçu des possibilités (les exemples proviennent de différents projets de la +Eclipse Foundation )
Add a comment...

Post has attachment
Gems (by popularity) that depend on Asciidoctor:

0) tilt: 51354321
1) sinatra-contrib: 1572118
2) awestruct: 116790
3) opskeleton: 37726
4) asciidoctor-diagram: 24939
5) markdpwn: 10357
6) asciidoctor-pdf: 6691
7) spiffy: 6471
8) hyla: 6447
9) corefines: 3266
10) adocsite: 3098
11) jekyll-asciidoc: 3049
12) asciidoctor-doctest: 2944
13) asciidoctor-epub3: 2692
14) potion: 2296
15) html-pipeline-asciidoc_filter: 1935
16) asciidoctor-html5ruby: 1805
17) persie: 1303
18) ascii_binder: 1218
19) nanoc-asciidoctor: 1166
20) asciidoctor-latex: 1161
21) linkedin2cv: 1125
22) doc_site_builder: 1012
23) guard-asciidoctor: 713
24) asciidoctor-confluence: 560
25) asciinurse: 484
26) asciidoctor-mathematical: 146

Thanks to http://www.schneems.com/blogs/2015-09-30-reverse-rubygems
Add a comment...

Post has shared content
Asciidoctor Needs Our Help
I've had a wild ride in my journey in open source thanks to +Asciidoctor and the wider community like +Anthonny Querouil and +John Ericksen 

Now is the time for us as a Tech Comms community to put our money where our mouths are and rustle up some serious funding for this organization. Even if you can't donate personally, I'm sure that you could use your skills of persuasion to convince your organization to commit to supporting such a vital Tech Comms standard.

I'm going to do whatever I can to get things moving in the right direction. Up towards the funding goal.

What will you do?
Add a comment...

Post has shared content
“Pair document” with professional technical writers from Red Hat to learn a good bit about AsciiDoc and Asciidoctor.
https://github.com/jaredmorgs/Asciidoctor_Presentation is the home I've decided upon for the Asciidoctor presentation I delivered with my colleague +Russell Dickenson last night.

Open and forkable, just like it should be. Don't know whether I should pick a license for it or not. If you think I should, suggest a good one in the comments.

It was a great night giving some background on AsciiDoc, and demonstrating some great examples of Asciidoctor projects. Technology like AsciiDoc and Asciidoctor promotes action. Some folks have gone off and created their own fork of +Anthonny Querouil 's http://hubpress.io project to get blogging and practicing AsciiDoc.
Add a comment...

Post has shared content
I was asked to create a list of prior innovations in Asciidoctor for a contract I'm doing. I'm blown away by the size of the list...and I'm still missing stuff! We've built quite an open source documentation kingdom!

AsciiDoc (http://asciidoc.org)::
A presentation-agnostic, text-based document format for producing published content that incorporates many plain text markup conventions and maps closely to the DocBook XML schema.

Asciidoctor (aka Asciidoctor core) (https://github.com/asciidoctor/asciidoctor, License: MIT)::
An open source text processor and publishing toolchain for converting AsciiDoc content to HTML5, DocBook 5 (or 4.5), man pages and other formats.
Provides an extension mechanism for extending the AsciiDoc language.

Asciidoctor Diagram (https://github.com/asciidoctor/asciidoctor-diagram, License: MIT)::
A set of extensions for Asciidoctor that allow you to embed diagrams written using, but not limited to, the PlantUML, Graphviz, ditaa or Shaape syntax inside your AsciiDoc documents.
The extension runs the composite diagram processor to generate an SVG, PNG, or TXT file from the input text.
The generated file is then inserted into your converted document.

Asciidoctor.js (https://github.com/asciidoctor/asciidoctor.js, License: MIT)::
A version of Asciidoctor core which has been transpiled to JavaScript using Opal.
Allows Asciidoctor to be used in any JavaScript environment, including, but not limited to, a browser (Firefox, Chrome, Internet Explorer, Opera), a text editor based on web technologies (Atom, Brackets), Node.js (via the npm module), and a JVM (via Rhino or Nashorn).
Asciidoctor.js also provides a command line interface that mimics the one in Asciidoctor core.

AsciidoctorJ (https://github.com/asciidoctor/asciidoctorj, License: Apache)::
AsciidoctorJ is a library for running Asciidoctor on the JVM.
AsciidoctorJ allows you can convert AsciiDoc content or analyze the structure of a parsed AsciiDoc document from Java and other JVM languages.
AsciidoctorJ provides bindings to the Asciidoctor API from Java.
AsciidoctorJ also bundles and distributes additional components, including, but not limited to, Asciidoctor PDF, Asciidoctor EPUB3 and a command line interface that mimics the one in Asciidoctor core.

AsciidoctorJ Groovy DSL (https://github.com/asciidoctor/asciidoctorj-groovy-dsl, License: Apache)::
A DSL for Groovy that implements the extension DSL from Asciidoctor core.

Asciidoclet (https://github.com/asciidoctor/asciidoclet, License: Apache)::
A Javadoc Doclet based on Asciidoctor that lets you write Javadoc (Java API docs) in the AsciiDoc syntax.

Asciidoctor Maven plugin (https://github.com/asciidoctor/asciidoctor-maven-plugin, License: Apache)::
A plugin for Maven that configures and runs the Asciidoctor processor as part of your Maven build using the AsciidoctorJ integration library.

Asciidoctor Gradle plugin (https://github.com/asciidoctor/asciidoctor-gradle-plugin, License: Apache)::
A plugin for Gradle that configures and runs the Asciidoctor processor as part of your Gradle build using the AsciidoctorJ integration library.
Exposes the AsciidoctorJ Groovy DSL as a top-level construct to allow Asciidoctor extensions to be written in the Gradle build.

Asciidoctor PDF (https://github.com/asciidoctor/asciidoctor-pdf, License: MIT)::
A native PDF renderer for AsciiDoc that is built using Asciidoctor and Prawn.
Converts AsciiDoc content directly to a PDF structure and writes the result to a file or stream.
Provides a collection of themes and associated theme assets (images, fonts, etc).

Asciidoctor EPUB3 (https://github.com/asciidoctor/asciidoctor-epub3, License: MIT)::
An EPUB3 converter for AsciiDoc that is built using Asciidoctor and gepub.
Converts AsciiDoc content directly to an EPUB3 layout and writes the result to a file or stream.
Provides a collection of themes and associated theme assets (images, fonts, etc).

Asciidoctor Chrome Extension (https://github.com/asciidoctor/asciidoctor-chrome-extension, License: MIT)::
An extension for Google Chrome (& Chromium) that converts AsciiDoc files to HTML directly in the browser using Asciidoctor.js.
Allows the Asciidoctor processor to be configured using an option page or by passing attributes through the query string of the URL.

Asciidoctor Firefox Add-on (https://github.com/asciidoctor/asciidoctor-firefox-addon, License: MIT)::
An add-on for Mozilla Firefox that converts AsciiDoc files to HTML directly in the browser using Asciidoctor.js.
Allows the Asciidoctor processor to be configured using an option page or by passing attributes through the query string of the URL.

Asciidoctor reveal.js, deck.js & dzslides (https://github.com/asciidoctor/asciidoctor-backends, Licence: MIT)::
A collection of templates for use with the Asciidoctor template converter that convert AsciiDoc to a reveal.js, deck.js or dzslides presentation.

Asciidoctor LaTeX (https://github.com/asciidoctor/asciidoctor-latex, License: MIT)::
Asciidoctor LaTeX defines an extended mathematical syntax for the AsciiDoc markup language that closely parallels LaTeX.
The Asciidoctor LaTeX converter renders documents written in this extended markup language into both HTML and LaTeX.

Atom AsciiDoc Preview (https://github.com/asciidoctor/atom-asciidoc-preview, License: MIT)::
Live preview of AsciiDoc using Asciidoctor.js for the Atom editor.

Atom AsciiDoc Language (https://github.com/asciidoctor/atom-language-asciidoc, License: MIT)::
AsciiDoc syntax definition for the Atom text editor.

Brackets AsciiDoc Preview (https://github.com/asciidoctor/brackets-asciidoc-preview, License: MIT)::
Live preview of AsciiDoc using Asciidoctor.js for the Adobe Brackets editor.

Editions (https://github.com/opendevise/editions, Licence MIT)::
A toolchain for publishing periodicals in EPUB3, KF8 & PDF from content stored in GitHub repositories and composed in AsciiDoc.

Docbook Rx (https://github.com/opendevise/docbookrx, License: MIT)::
A DocBook to AsciiDoc converter written in Ruby.

Asciidoctor extensions lab (https://github.com/asciidoctor/asciidoctor-extensions-lab, License: MIT)::
Experimental Asciidoctor extensions for extending the AsciiDoc syntax and the capabilities of the Asciidoctor processor.

Asciidoctor stylesheet factory (https://github.com/asciidoctor/asciidoctor-stylesheet-factory, License: MIT)::
A factory for producing stylesheets to theme AsciiDoc HTML5 output.
Assembled using Compass, Sass and Foundation.

DocGist (https://github.com/asciidoctor/docgist, License: Apache)::
Renders AsciiDoc documents from Gists, GitHub, DropBox and other remote sources in the browser.

Jekyll AsciiDoc (https://github.com/asciidoctor/asciidoc-jekyll, License: MIT)::
A Jekyll plugin to convert AsciiDoc files (both pages and posts) in your site source to HTML pages using Asciidoctor.
Add a comment...

Post has shared content
"If you’ve written a technical book and didn’t do it in AsciiDoc on GitHub, you have done ten times more work than you needed to."

"Now that Asciidoctor is around, I can do truly amazing things with my AsciiDoc source book that were not nearly as simple before."

"I believe this process is at least the short to medium term future of technical publishing."

\o/

This is why we do what we do in Asciidoctor, and why we will continue to do it. All authors should love their toolchain this much...and even more!
Add a comment...

Post has shared content
Git loves AsciiDoc, and now Asciidoctor!

Special thanks to community member Brian Carlson who has been raising awareness about Asciidoctor on the git mailing list & championing support for it. Additional thanks to all Asciidoctor community members and authors. Write on!
Add a comment...

Post has shared content
This blog post describes how you can transform Asciidoc documents into HTML and render the created HTML with Spring MVC.
Add a comment...

Post has shared content
I can't even tell you how excited I am to see the work of the Asciidoctor community showcased by such a prominent author, from GitHub no less!

Congratulations +Anthonny Querouil, +Guillaume Grossetie and the whole Asciidoctor community! You all are rocking it!
Add a comment...

Post has shared content
"If you’ve written a technical book and didn’t do it in AsciiDoc on GitHub, you have done ten times more work than you needed to."

"Now that Asciidoctor is around, I can do truly amazing things with my AsciiDoc source book that were not nearly as simple before."

"I believe this process is at least the short to medium term future of technical publishing."

\o/

This is why we do what we do in Asciidoctor, and why we will continue to do it. All authors should love their toolchain this much...and even more!
Add a comment...
Wait while more posts are being loaded