If you are looking for an open documentation solution ny which you can implement single sourcing while integrating with a complex build process then this is a great solution.
In fact, also this claim is wrong, because there are three :D 1. https://asciidoctor.org/. - Source: Hacker News / about 2 months ago
Asciidoctor is a Ruby-based text processor for parsing AsciiDoc into a document model and converting it to HTML5, PDF, EPUB3, and other formats. Built-in converters for HTML5, DocBook5, and man pages are available in Asciidoctor. Asciidoctor has an out-of-the-box default stylesheet and built-in integrations for MathJax (display beautiful math in your browser), highlight.js, Rouge, and Pygments (syntax... - Source: dev.to / 2 months ago
If you're looking at AsciiDoc, you'll want to look at Asciidoctor: https://asciidoctor.org/. - Source: Reddit / 4 months ago
The third system that I found was AsciiDoc, which started as a Python project, abandoned for a while and eventually resurrected by Dan Allen with Asciidoctor. AsciiDoc has a lot of features and I consider it superior to Markdown, but Asciidoctor is a Ruby program, and this made it difficult for me to use it. In addition, the standard output of Asciidoctor is a nice single HTML page but again customising it is a... - Source: dev.to / 7 months ago
We use Antora and Asciidoc, published as in Gitlab pages, for technical documentation. - Source: Reddit / 10 months ago
In the previous post, we quickly saw the power of Asciidoctor, how it could enhance the documentation, writing and many other features. - Source: dev.to / 10 months ago
At this stage, a standard Jekyll blog should work. Yet, my blog also uses Asciidoctor, and more importantly, asciidoctor-diagram. I draw my diagrams using the PlantUML syntax. PlantUML requires a JVM and graphviz. - Source: dev.to / 10 months ago
The toolchain that brings power of Asciidoc is Asciidoctor. It parses Asciidoc files and helps in converting them to various formats - HTML5, PDF, DocBook, ePub, man pages etc. - Source: dev.to / 10 months ago
I looked at this for a similar problem. Pandoc is a beast. I eventually used it alongside https://asciidoctor.org which was a pretty tight tool chain for an extended markdown format to see https://docs.asciidoctor.org/asciidoctor/latest/migrate/ms-word/#pandoc. - Source: Reddit / 11 months ago
In this space, I'd love to see more asciidoctor (https://asciidoctor.org, they are in the process of writing up the spec at https://projects.eclipse.org/projects/asciidoc.asciidoc-lang). - Source: Reddit / about 1 year ago
I've the same experience. Soem years ago I tried DocBook to render HTML and PDF documents, but the whole setup was so unpleasant that I gave up. Writing the syntax is not overly hard, but also not pleasant. I ended up with AsciiDoc, what is nice to read and write and which has a rich set of features. It is also very easy to set up: just download AsciiDoctor and you're ready to go. https://asciidoctor.org/. - Source: Hacker News / about 1 year ago
I'm wondering that the article doesn't mention AsciiDoc with a single word. AsciiDoc is a perfect tool for complex text documents with tables, references, side notes etc. It is almost as easy as Markdown (if you compare only the features included in both), but offers way more possibilities. There are also good tools to convert it to different output formats like HTML and PDF. A good starting point is:... - Source: Hacker News / about 1 year ago
Did you checkout the asciidoc format? It’s close to what you are doing but with way more options (table of content, tables, indexes, glossaries, sidebars, internal links, etc). It got you covered for lots of stuff. - Source: Reddit / about 1 year ago
This is done with https://asciidoctor.org and their asciidoc-pdf tool. - Source: Reddit / over 1 year ago
Does it have to be pandoc? What about using asciidoc for the syntax? Then you could use asciidoctor for html output and asciidoctor-pdf for the pdf output. - Source: Reddit / over 1 year ago
I'm using Hugo with the theme PaperMod. You can take a look at the source code of the site here, it's pretty easy to get started if you look up a guide online. Also, I use Asciidoc instead of Markdown because it has more features built-in (customization, references, variables, etc). - Source: Reddit / over 1 year ago
So I was sold. I started learning how to use AsciiDoc to write my eBook and how to use AsciiDoctor to process my source file and produce many output formats like PDF, ePub or HTML from it very easily. - Source: dev.to / over 1 year ago
Asciidoc (https://asciidoctor.org/) or markdown, RST etc for documentation. - Source: Reddit / over 1 year ago
For more complex technical documentation AsciiDoc would be a better fit than markdown. A simple table with code blocks is not possible with markdown, for example. I think the target audience is pretty much the same as for AsciiDoctor. https://asciidoctor.org/. - Source: Hacker News / almost 2 years ago
Capable of semantic markup: like HTML/CSS, LaTeX or Asciidoc. That is, a language semantically Extensible enough so that true WYSIWYM can happen, allowing for a Better time at maintenance and refactorings in big projects. So no markdown And similarly semantically limited languages, which are a bit like text-based Attempts at WYSIWYG), if that is a Thing. - Source: Reddit / almost 2 years ago
They shouldn't look at Asciidoc, they should look at Asciidoctor, an extended language: https://asciidoctor.org/ It would seem to fit particularly well, because it was specifically designed to cover DocBook as much as possible. That both helps with conversion and with the sematic markup requirements. - Source: Hacker News / almost 2 years ago
Do you know an article comparing Asciidoctor to other products?
Suggest a link to a post with product alternatives.