rspec_api_documentation VS Asciidoctor

rspec_api_documentation

We haven't tracked posts mentioning rspec_api_documentation yet.
Tracking mentions began in Dec 2020.

Asciidoctor

• I don't always use LaTeX, but when I do, I compile to HTML (2013)
  13 projects | news.ycombinator.com | 25 Jan 2024

  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/ ).

• [DEV][App Release] Markor 2.11 adds AsciiDoc and CSV Support
  2 projects | /r/androidapps | 6 Jun 2023

  AsciiDoc File support. ( #1876, #808, #2022)

• Good software/SaaS for Technical Documentation CMS
  1 project | /r/technicalwriting | 17 May 2023

  If Maths is important to you, take a look at Asciidoc - https://asciidoctor.org/

• Documentation generators and custom syntax highlighting
  5 projects | /r/ProgrammingLanguages | 5 May 2023

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

• I wish Asciidoc was more popular
  11 projects | news.ycombinator.com | 6 Feb 2023

  AsciiDoc is so close to being good. It slam dunks Markdown, but they just have a few nagging issues that they refuse to fix, for 9 years now:

  https://github.com/asciidoctor/asciidoctor/issues/1087

• Markdown, Asciidoc, or reStructuredText - a tale of docs-as-code
  23 projects | dev.to | 10 Jan 2023

  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 highlighting), as well as Font Awesome (for icons). Although Asciidoctor is written in Ruby, that does not mean you need to know Ruby to use it. Asciidoctor can be executed on a JVM using AsciidoctorJ or in any JavaScript environment (including the browser) using Asciidoctor.js. You can choose any one of three Asciidoctor processors (Ruby, JavaScript, Java/JVM) and get the same experience. You can also use the Asciidoctor Maven Plugin to convert your Asciidoc documentation using Asciidoctor from an Apache Maven build.

• Designing Go Libraries: The Talk: The Article
  6 projects | /r/golang | 7 Dec 2022

  asciidoctor for writing

• Docs as code vs a tool that can work with .md and xml?
  2 projects | /r/technicalwriting | 3 Dec 2022

  If you're looking at AsciiDoc, you'll want to look at Asciidoctor: https://asciidoctor.org/

• Diving deeper into custom PDF and ePub generation
  2 projects | news.ycombinator.com | 20 Sep 2022
• Mau: a lightweight markup language based on Jinja
  3 projects | dev.to | 17 Aug 2022

  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 pain. I eventually created the site of the book using it, but adding my Google Analytics code and a sitemap.xml to the HTML wasn't trivial, not to mention customising the look of elements such as admonitions.