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.

Anónimo dijo...

Bhiwandi Escorts
Bhopal Escorts

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

Dehradun Escorts
Durgapur Escorts

Anónimo dijo...


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

Jhansi Escorts
Jodhpur Escorts
Kakinada Escorts
Kalyan-Dombivali Escorts

Anónimo dijo...

Kochi Escorts
Kolhapur Escorts

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

Maheshtala Escorts
Malegaon Escorts

Anónimo dijo...

Mangalore Escorts
Meerut Escorts
Mysore Escorts
Nagpur Escorts

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

Anónimo dijo...

Shillong Escorts
Shimla Escorts

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

Surat Escorts
Trivandrum Escorts

Anónimo dijo...

Udaipur Escorts
Ulhasnagar Escorts
Vadodara Escorts
Varanasi Escorts

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

Anónimo dijo...

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

Thane Escorts
Vasai-Virar Escorts
Ahmedabad Escorts
Bangalore Escorts

Ace Starlit dijo...

Its a very impressive content. Thank you for sharing it. Visit:- Ace Starlit

Garika Jello dijo...

I’m impressed, I must say. Really rarely do I encounter a blog that’s both educative and entertaining, and let me tell you, you have hit the nail on the head. Your idea is outstanding; the issue is something that not enough people are speaking intelligently about. I am very happy that I stumbled across this in my search for something relating to this.

Click Here
Visit Web

SITES 2021 dijo...

Thank you. I authentically greeting your way for writing an article. I safe as a majority loved it to my bookmark website sheet list and will checking rear quite than later.
토토사이트

website designing in noida dijo...

I things and data online that you might not have heard before on the web.

Hi, I found your site by means of Google

indeed, even as searching for a comparative matter, your site arrived up, it is by all accounts incredible.

bhai aapke liye hai. lagao or jeeto.I have bookmarked it in my google bookmarks.

game is drawing and guisses based generally match-up,

anyway currentlyit's arranged in best, and satta lord desawar is presently horribly eminent

furthermore, to a great extent participating in game across the globe people ar insane with respect to this game.

Yet, as of now the principal essential factor is that this game is satta king neglected to keep the law and

decide guideline that to keep the conventions and rule. Presently right now people need to depend on it,

on the off chance that the game doesn't follow the conventions they need not play the games anyway people are still

partaking in the game,they play the games on the QT people have answer on it to quit participating

in this kind of games, consistently help work and worked with individuals that might want facilitated,do something for

your country do perpetually reasonable thing and be everlastingly happy.satta king

Much obliged to you for visiting Our Website sattaking,Most most likely similar to our visitor from Google search.Maybe you are

visting here to become more acquainted with about gali satta number today.to know gali disawar ka satta number please visting

your landing page of site and look down . You will see boxed sorts data which is show satta number

of particular game. There you will likewise see number of today yesterday satta number of, for example, gali disawar, new

mumbai, disawar gold and loads of game you have wagered on the game.If you play your own gali disawar satta game and

need us to put your own board on your website.Please satta king

get in touch with us on showed number which you will discover in footer part of website.Apna game dalwane k liye hamse

contact kre on google pay,phonepe, paytm jaise aap chahe pehle installment karen. aapka board moment site pr update

kr diya jayega jaisi hey aapka installment done hota haiWe greet you wholeheartedly and exceptionally pleased to have you our

website.satta kingPlease bookmark our site and stay tuned and refreshed to know.

you might have perceived the cycle to play disawar satta gali game and caught wind of fix spill jodi disawar gali from

your companions, family members. Actaully individuals favors disawar gali games as It is exceptionally well known in Indian subcontinent.

also, is considered illegal.by having appended with our site .satta kingYou

will discover magnificient content in regards to all the games.satta king We have staggering

data of satta results and gali disawar diagrams as the are open for public and refreshed.

Diksha Rai dijo...

I read this post your post so nice and very informative post thanks for sharing this post
http://www.pinkiahuja.in/