Profile

Cover photo
Asciidoctor
152 followers|34,900 views
AboutPostsPhotosVideos

Stream

Asciidoctor

Shared publicly  - 
 
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 )
 ·  Translate
View original post
2
Jean Michel Bruel's profile photo
 
Those slides are not done with #asciidoctor !? #wtf 
Add a comment...

Asciidoctor

Shared publicly  - 
 
“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.
Asciidoctor_Presentation - Files relating to the AsciiDoc presentation showcasing HubPress and Asciidoctor technologies
5 comments on original post
1
Add a comment...

Asciidoctor

Shared publicly  - 
 
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!
 
+Asciidoctor is featured in the Git v2.2.0 release notes ;)

Some people use AsciiDoctor, instead of AsciiDoc, to format our documentation set; the documentation has been adjusted to be usable by both, as AsciiDoctor is pickier than AsciiDoc about its input mark-up.

http://lkml.iu.edu/hypermail/linux/kernel/1411.3/02881.html
[ANNOUNCE] Git v2.2.0. From: Junio C Hamano Date: Wed Nov 26 2014 - 18:09:34 EST. Next message: tip-bot for Jiang Liu: "[tip:x86/apic] iommu/amd: Enhance AMD IR driver to suppport hierarchy irqdomain"; Previous message: tip-bot for Jiang Liu: "[tip:x86/apic] iommu/vt-d: Enhance Intel IR driver ...
View original post
4
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
This blog post describes how you can transform Asciidoc documents into HTML and render the created HTML with Spring MVC.
View original post
1
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
"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!
The amazing adventures and final toolchain of Pro Git, 2nd Edition
10 comments on original post
1
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
The first alpha release of Asciidoctor PDF is now available! There are three things that make this release significant.

1. It's available as a pre-release on RubyGems.org, so you can install it using `gem install asciidoctor-pdf --pre`
2. It's a proper Asciidoctor converter extension, so you can load it using `-b pdf -r asciidoctor-pdf` or just use the provided cross-platform `asciidoctor-pdf` script.
3. You can create PDFs from AsciiDoc without going through the DocBook toolchain (and avoid the pain & suffering of DocBook XSL)

The version of this release is 1.5.0.alpha.1. I decided to start at 1.5.0 because this is an official converter & we want to keep it aligned with core.

Please note that Asciidoctor still supports DocBook output. That will not change. I do believe DocBook is a good transfer format for documentation. I just don't believe it should be a prerequisite for publishing.

I'm interested to hear how it works for you & look forward to discussing how we can make it better!

Enjoy!
asciidoctor-pdf - Asciidoctor PDF: A native PDF renderer for AsciiDoc based on Asciidoctor and Prawn, written entirely in Ruby.
1 comment on original post
2
Add a comment...

Asciidoctor

Shared publicly  - 
 
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
Who Does your Gem Work For? 30 Sep 2015. Have you ever wondered who out there is using a gem? Now there's an easy way. Rubygems.org has a reverse dependencies API endpoint that's documented here. I wrote a simple Ruby script that finds all the reverse dependencies of a gem, and then weighs them ...
1
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
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?
Shaping the future of writing and publishing, primarily in the field of technical documentation.
4 comments on original post
1
2
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
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.
5 comments on original post
6
1
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
"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!
The amazing adventures and final toolchain of Pro Git, 2nd Edition
10 comments on original post
4
3
John Graber's profile photo
 
Truth! +Asciidoctor & +GitHub, two great tastes that taste great together.

But seriously, folks, this is Nirvana when it comes to technical writing. I use this tool chain for all kinds of reports now. And the recipients are never anything but impressed at the appearance, even when the content falls short ;)
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
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!
The amazing adventures and final toolchain of Pro Git, 2nd Edition
4 comments on original post
1
Add a comment...

Asciidoctor

Shared publicly  - 
 
 
All in one - The Asciidoctor ecosystem in a Docker container
I have to admit, I'm following the trends. Doing some documentation with  Asciidoctor  and playing with  Docker  and if you don't know those 2, you should have a look at them. Anyway let's dive in. As written in the Asciidoctor documentation, you should fir...
View original post
1
Add a comment...
Story
Tagline
An open source Ruby processor for converting AsciiDoc markup into HTML 5, DocBook 4.5 and other formats
Introduction
The Asciidoctor project is an effort to bring a comprehensive and accessible documentation toolchain, centered around the AsciiDoc syntax, to the Ruby and JVM ecosystems.

In addition to an AsciiDoc processor, the Asciidoctor project provides plugins for Maven, Gradle and Guard, packages for operating systems such as Fedora and helps promote AsciiDoc through education and advocacy.