The asciidoctor gradle plugin is the official means of using asciidoctor to convert all your asciidoc documentation using gradle. Using debian sid or fedora rawhide, oracle jdk8 u25, gradle 2. A gradle plugin that uses asciidoctor via jruby to process asciidoc source files. Any slide deck generated by supported asciidoctor slide task types can be converted to pdf if you need a productionready version of the asciidoctorj plugin.
As i am very new to asciidoc and asciidoctor, i may miss something obvious. Documentation we are migrating our documentation to the new asciidoctor antorabased site when it is ready. Asciidoctorj pdf bundles the asciidoctor pdf rubygem asciidoctor pdf so it can be loaded into the jvm using jruby. This started as a port of the asciidoctor maven plugin project founded by jason porter and relies on asciidoctorj which was founded by alex soto. If you want to generate static api documentation and combine it with. Any slide deck generated by supported asciidoctor slide task types can be converted to pdf if you need a productionready version of the asciidoctorj plugin for gradle use a 2. Instead of every subproject creating its own offline repo, create a subproject that will keep one on behalf of all subprojects. I would like to use the new xrefstyle feature in asciidoctor and be able to build the document using this gradle plugin.
Commits master asciidoctor asciidoctorgradleplugin. Asciidoctor a fast, open source text processor and. That way, it wont matter where the generated image is written. If decide to use asciidoctor, youll still need to install the python version for some conversionssuch as generating a pdf that asciidoctor doesnt handle at the time of this writing. Sign in sign up instantly share code, notes, and snippets. The asciidoctor gradle plugin is the official means of using asciidoctor to.
Asciidoctor is a fast text processor and publishing toolchain for converting asciidoc content to html5, epub3, pdf, docbook 5 or 4. A gradle build that generates a versioned pdf for multiple. There are now a really nice set of example projects for using the gradle plugin thanks to danny hyun and rob winch. Pdf generation is provided by identical gradle scripts. Theres a modern implementation of asciidoc, written in ruby, named asciidoctor. Asciidoctor is written in ruby, packaged as a rubygem and published to. The last step would be to merge it with asciidocdiagramtohtmlexample into a single example named asciidoctor diagramexample. Hi everyone, i am a bit confused as i am trying to create a running header and footer. The core processors asciidoctor, asciidoctorj, and asciidoctor. Remarked linkedchapters tests for epub as pendingfeature. Asciidoctor discussion using asciidoctorjpdf from gradle. Asciidoc writers guide asciidoctor stylesheet factory.
There is this github repo with a set of examples using the following gradle build file style excerpt. In the next asciidoctor file we combine all these settings for a table. Make asciidoc task much faster by reusing jruby runtime. Index page listing asciidoc and asciidoctor documents and resources including the asciidoctor user manual, asciidoc quick reference guide, the benefits of asciidoc, the benefits of asciidoctor, asciidoctor installation guide, how to convert an asciidoc document, and asciidoctor. A gradle build that generates a versioned pdf for multiple asciidoc documents. Use either sourcedir path, setsourcedir path or sourcedirpath type. Asciidoc to github pages with travis and docker asciidoctor. A gradle plugin that uses asciidoctor via jruby to process asciidoc source files within the project. Asciidoctor jvm pdf gradle plugin last release on jan 31, 2020 indexed repositories 1267 central. Closed rwinch opened this issue apr 30, 2015 48 comments. I am a bit confused about the options to use gradle to convert my asciidoc files to pdf. Separate tasks are used for illustrative purposes and to allow each conversion to be individually configured. Problems including asciidoctor diagrams for pdf and epub. I am using asciidoctor with gradle and now i want to add pdf generation to the build process.
To combine a variety of gpars information into a single place guides,references. Asciidoctor discussion problem running asciidoctor. In this section, we will show how you to generate pdf file during maven build. The gem is also packaged in several linux distributions, including fedora, debian and ubuntu. Example manual this is a user manual for an example project. Html and pdf files on asciidoctoghpages project ghpages branch. I am not too familiar with ruby, but it looks like something needs to be upgraded to support asciidoctorj pdf 1. The effort to integrate the solution into a gradle plugin shouldt be that high. We plan for all three projects to make this major version shift at roughly the same time to minimize confusion. In november 2010 i presented a gradle talk at the jfall conference of the dutch java. Simplifies convesion of asciidoc documetns to pdf if you need a productionready version of the asciidoctorj plugin for gradle use a 1.
This repository contains examples on how to use gradle and asciidoctor to create html5, pdf, epub, deck. Span cell over rows and columns when we define a table in asciidoctor we might want to span a cell over multiple columns or rows, instead of just a single column or row. If i understand things properly, there is no way to use asciidoctor 2. The asciidoctorj block will merge with this extension.
1450 1526 448 164 667 958 285 1386 239 1033 144 1468 237 782 1541 498 238 859 723 49 412 754 565 359 668 787 819 1396 1358 1241 1130