lunes, noviembre 19, 2018

Continuous Documentation with Antora and Travis

Antora is a documentation pipeline that enables docs, product, and engineering teams to create, manage, remix, and publish documentation sites composed in AsciiDoc and sourced from multiple versioned content repositories.

You can see several examples out there from Couchbase documentation to Fedora documentation. And of course, Antora documentation is used to generate Antora documentation. You can see it here.

So basically we have our project with documents in adoc format. Then what we want is regenerating the documentation every time a PR is merged to master.

In our project, we are using Travis-CI as CI server, so I am going to show you how we have done.

First of all, you need to create a .travis.yml file on the root of your project.


First, we define what we want to use. In this case docker and git.

Then in before_install section, we are detecting if we need to regenerate documentation or not.

Basically, we are going to generate documentation in two conditions:

  1. If commit message contains the word doc, then docs should be regenerated.
  2. If you have modified an adoc file from the documentation folder (or README.adoc) and the branch is master, then the docs should be regenerated.
If any of these conditions are met, then we configure git client with user, email and token to be used for pushing the generated documentation. Notice that this information comes from environment variable defined in Travis console. Also, it is important to note that the documentation should be generated in gh-pages branch (since we are releasing to GitHub pages). For this reason, we are using git worktree which checkouts the gh-pages branch in gh-pages directory.

Then in script section, we are just using Antora docker image to render documentation.

Finally, we just need to enter into gh-pages directory, create a .nojekyll file to avoid Git Hub Pages thinks that this is a Jekyll site, and finally push the changes.

And then for PR merged, the documentation is automatically regenerated and published.

Important: This script is based on one done previously by Bartosz Majsak (@majson) for Asciidoctor. My task has been only adapting it to use Antora.

We keep learning,
Alex.

Y no me importa nada nada (nada), Que rías o que sueñes, que digas o que hagas, Y no me importa nada, Por mucho que me empeñe, estoy jugando y no me importa nada (No me importa nada - Luz  Casal)








19 comentarios:

sandy dijo...


https://khalejmovers.com/نقل-اثاث-من-الرياض-الى-الدمام/

https://khalejmovers.com/شركة-نقل-اثاث-من-الرياض-الى-البحرين/
https://khalejmovers.com/

https://khalejmovers.com/نقل-اثاث-الرياض-الكويت/

https://khalejmovers.com/نقل-اثاث-الرياض-الاردن/
_______________


yanmaneee dijo...

kobe 11
louboutin shoes
air max
kd shoes
balenciaga shoes
coach outlet store
michael kors handbags
nike air max
kyrie 4
off white shoes

steve dijo...


شكرا معلومات مفيدة يمكنك زيارة ايضا لمعلومات قيمة اخرى قم بزيارة :

شركة غسيل خزانات بالمدينة المنورة
افضل شركة تنظيف

yanmaneee dijo...

kd 11 shoes
yeezy boost 350
lebron 15
nike sneakers
supreme
hermes belt
curry 6
nike react
nike sneakers for men
kd 11

Andrew303john dijo...

Economics Assignment Help

We Fullassignment.com is among the best companies on the Economics assignment writing market. We offer top-notch essays, Business Economics Assignment help research papers, thesis and other types of works that can be assigned to you at a high school or college. We also provide Analog Electrtonics Assignment Help from our experts.

https://fullassignment.com/

hrroman dijo...

If you are looking for the Marketing Assignments help then in this case you can opt for our Market Analysis Assignment.we provide the best Assignment Help Experts.We also provide 5c Marketing Assignment for students across the globe. for more information contact us +16692714848.

hrroman dijo...



We Fullassignment.com is among the best companies on the Programming Database and IT Assignments Help writing market. We offer top-notch essays, Online Programming Assignment Help research papers, thesis and other types of works that can be assigned to you at a high school or college. We also provide Java Programming Assignment Help from our experts. for more information contact us +16692714848.

rana07vishal dijo...

A complete list of all the different types of Action games. The Best action new games for playstation and Find latest games , trailer , information , walkthrough and more here at player4life.

alia dijo...

Agra Escorts
Akola Escorts
Aligarh Escorts
Allahabad Escorts
Amravati Escorts
Amritsar Escorts

Bareilly Escorts
Belgaum Escorts
Bhavnagar Escorts
Bhilai Escorts

alia dijo...

Bhiwandi Escorts
Bhopal Escorts

Bhubaneswar Escorts
Bikaner Escorts
Bokaro Escorts
Chandigarh Escorts
Cuttack Escorts
Daman Escorts

Dehradun Escorts
Durgapur Escorts

alia dijo...

Erode Escorts
Faridabad Escorts
Gangtok Escorts
Gorakhpur Escorts

Gulbarga Escorts
Guntur Escorts
Guwahati Escorts
Gwalior Escorts
Howrah Escorts
Hubli Escorts

alia dijo...


Hyderabad Escorts
Indore Escorts
Itanagar Escorts
Jabalpur Escorts
Jaipur Escorts
Jalandhar Escorts

Jhansi Escorts
Jodhpur Escorts
Kakinada Escorts
Kalyan-Dombivali Escorts

alia dijo...

Kochi Escorts
Kolhapur Escorts

Kozhikode Escorts
Kurnool Escorts
Loni Escorts
Lucknow Escorts
Ludhiana Escorts
Madurai Escorts

Maheshtala Escorts
Malegaon Escorts

alia dijo...

Mangalore Escorts
Meerut Escorts
Mysore Escorts
Nagpur Escorts

Nanded Escorts
Nashik Escorts
Nellore Escorts
Kolkata Escorts
Panaji Escorts
Patiala Escorts

alia dijo...

Pimpri-Chinchwad Escorts
Port Blair Escorts
Raipur Escorts
Rajahmundry Escorts
Rajkot Escorts
Ranchi Escorts

Rourkela Escorts
Saharanpur Escorts
Salem Escorts
Sangli Escorts

alia dijo...

Shillong Escorts
Shimla Escorts

Siliguri Escorts
Silvassa Escorts
Solapur Escorts
South Dumdum Escorts
Sri Ganganagar Escorts
Srinagar Escorts

Surat Escorts
Trivandrum Escorts

alia dijo...

Udaipur Escorts
Ulhasnagar Escorts
Vadodara Escorts
Varanasi Escorts

Vijayawada Escorts
Visakhapatnam Escorts
Warangal Escorts
Vapi Escorts
Ujjain Escorts
Agartala Escorts

alia dijo...

Kanpur Escorts
Mumbai Escorts
Navi Mumbai Escorts
Noida Escorts
Pune Escorts
Ramagundam Escorts

Thane Escorts
Vasai-Virar Escorts
Ahmedabad Escorts
Bangalore Escorts

alia dijo...

Bellary Escorts
Chennai Escorts

Coimbatore Escorts
Delhi Escorts
Dhanbad Escorts
Dharwad Escorts
Gaya Escorts
Gurgaon Escorts

Jammu Escorts
Pathankot Escorts