asciidoctor-multipage
asciidoctor-html5s
asciidoctor-multipage | asciidoctor-html5s | |
---|---|---|
1 | 1 | |
56 | 85 | |
- | - | |
6.4 | 10.0 | |
about 1 month ago | over 1 year ago | |
HTML | HTML | |
MIT License | MIT License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
asciidoctor-multipage
-
I wish Asciidoc was more popular
When searching how to do this, I somehow find a tutorial that instructs me to write Java (?!) to generate a search index, and some extension that generates multipage HTML but seems to not be what the Asciidoctor docs use.
asciidoctor-html5s
-
AsciiDoc, Liquid and Jekyll
https://github.com/jirutka/asciidoctor-html5s
The HTML alternate back-end fixes a lot of these issues and chooses semantic elements for a more modern age (while Asciidoctor is actively overhauling its output I believe).
The issue visually can be solved with CSS as-is, but Microsoft GitHub treats its AsciiDoc rendering as a second-class citizen despite it objectively having more/better features for documentation than Markdown. The negligence becomes apparent when you look at the way GitHub syntax fork (βflavorβ) handles admonitions; not only does it overload, overcomplicate, and ruin the semantics of the blockquote, but the CSS styling that makes them look nice was never ported to admonitions for reStructuredText and AsciiDoc despite these formats having the feature natively to the syntax (no fork required).
What are some alternatives?
Hacktoberfest_Practice_Contribution - Hacktoberfest is a month long event where people are awarded for contributing to open source projects π, and we're joining the party .Hosted by DigitalOcean for the 8th year in a row, Hacktoberfest encourages participation in giving back to the open source community by completing pull requests, participating in events, and donating to open source projects.
readable - π A service for reading long-form content on any device
asciidoctor.org - :globe_with_meridians: Asciidoctor project site. Composed in AsciiDoc. Baked with Awestruct.
criminal-law - You can't commit a crime. You can try if you want.
pasdoc - Documentation tool for ObjectPascal (Free Pascal, Lazarus, Delphi) source code
aria-at - Assistive Technology ARIA Experience Assessment
awestruct - A static site baking and deployment tool written in Ruby.
nimib - nimib π³ - nim π driven β΅ publishing β
Simply-Docs - A simple, fast, free & easy to use static based plain HTML template. That allows you to make a beautiful personal / blog or technical documentation website really quickly.
mattrighetti - Personal profile page
commonmark-spec - CommonMark spec, with reference implementations in C and JavaScript
nimibex - π nimibex - extensions, experiments and extras for nimib ecosystem