It’s not the easiest package to use, but could still have a lot. Going back I would probably suggest to look into other platforms, as the benefits of AsciiDoc are smaller than the amount of tooling frustrations. AsciidocFX is a cross-platform open-source markup editor for building PDF, HTML, ePUB and MOBI ebooks, documents, slides and more. To write documents we all used VS Code + the Firefox/Chrome ASciDoctor preview plugin, and that worked much better than AsciiDocFx. Moreover, the build times for the portal were extremely long (like 20-30 minutes for ~100 pages) We had multiple cases where the JS version would handle documents differently, or support a different feature set than the asciidoctor-cli. You can build PDF, Epub, Mobi and HTML books, documents and. I say developed rather than deployed as we ended up adding a ton of extra features to Antora (think authentication, authorizations, image previews, full-text search as you type, etc.).Īntora is quite nice and writing documentation in AsciiDoc was very enjoyable, but it was very clear how the JS implementation of AsciiDoctor was not on par with the Ruby one. AsciidocFX is an open-source live-preview Asciidoc editor. Use Homebrew to install it with one command: brew install -cask asciidocfx. Download executable/installer and run it. It is true I have not updated my Linux VSCode or any extensions for a few. After the download is completed, untar the package in your preferred directory. Asciidoctor is also distributed as a Docker image, as a package for numerous Linux distributions, and as a package for macOS (via Homebrew and MacPorts). At my former job we developed a documentation portal with Antora and AsciiDoc. AsciiDoc is a markup language that allows the creation of text documents for writing notes, documentation, articles, books, E-books, slideshows, web pages and blogs. How to resemble the PDF-output of AsciidocFX using a Gradle build-script.
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |