phpDocumentor 2 VS Asciidoctor

phpDocumentor 2 Reviews

Asciidoctor Reviews

1. Elisa    

   Technical Writer at Self | about 2 years ago
   Professional output from open source

   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.

   👍 Pros:    Easy integration|Easy to use

phpDocumentor 2 mentions (2)

• I've noticed this syntax around - is there any "official" place where it comes from?

  I think you are talking about the comment which is a format called phpdoc. Source: over 1 year ago

• End-User Documentation

  I'm not sure if I want to include those guides in the DocBlocks for the functions, or as part of separate RST files that phpDoc.org supports. Source: over 2 years ago

Asciidoctor mentions (23)

• I don't always use LaTeX, but when I do, I compile to HTML (2013)

  You have also AsciiDoctor ( https://asciidoctor.org/ ) which is alive and well. I am using it for technical CS documentation internally, but only for single page documents. I did not try to deploy their whole multi-document setup called Antora ( https://antora.org/ ). - Source: Hacker News / 3 months ago

• Documentation generators and custom syntax highlighting

  I use Asciidoctor, highlightjs, a custom highlight.js language definition and that bash script:. Source: 12 months ago

• I wish Asciidoc was more popular

  In fact, also this claim is wrong, because there are three :D 1. https://asciidoctor.org/. - Source: Hacker News / about 1 year ago

• Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code

  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 / over 1 year ago

• Docs as code vs a tool that can work with .md and xml?

  If you're looking at AsciiDoc, you'll want to look at Asciidoctor: https://asciidoctor.org/. Source: over 1 year ago