Integrate Oxygen XML Author with Jenkins

<oXygen/> general issues.
Sreeram891
Posts: 7
Joined: Tue May 08, 2018 1:40 pm

Integrate Oxygen XML Author with Jenkins

Post by Sreeram891 » Wed Jul 04, 2018 9:54 am

Hello team,

Currently, we are in a idea to automate the documentation process through Jenkins.

As i am new to Jenkins and automation process, i would top like to seek your suggestions or ideas about automating the documentation.

We use Oxygen XML Author 15.2 for authoring the XML content and trying to find ways to integrate the Oxygen Author with Jenkins.

Can you suggest how this process works and how can we take it to the next level.


Thanks,
Sreeram

Radu
Posts: 6435
Joined: Fri Jul 09, 2004 5:18 pm

Re: Integrate Oxygen XML Author with Jenkins

Post by Radu » Thu Jul 05, 2018 12:44 pm

Hi Sreeram,

I will assume you want to publish DITA content using a Jenkins server. If you want something else, please provide us with more details.
Oxygen uses for publishing DITA content an engine called the DITA Open Toolkit which can also be downloaded and invoked separately (on the server side):

https://www.dita-ot.org/download
https://www.dita-ot.org/3.0/topics/building-output.html

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Sreeram891
Posts: 7
Joined: Tue May 08, 2018 1:40 pm

Re: Integrate Oxygen XML Author with Jenkins

Post by Sreeram891 » Thu Jul 05, 2018 1:43 pm

Hi Radu,

Thanks for the response.

But, what i am looking is to automate the documentation process by using Jenkins.

I was browsing through forum and found this topic post44987.html?hilit=jenkins#p44987 for automating builds.

I am looking for some plugins, using which we can automate existing manual process for documentation.

Radu
Posts: 6435
Joined: Fri Jul 09, 2004 5:18 pm

Re: Integrate Oxygen XML Author with Jenkins

Post by Radu » Thu Jul 05, 2018 3:38 pm

Hi,

I understand and I stick to my previous answer.
Using Jenkins you can start any process on the server side. So on the server side you can have a Jenkins job which first downloads the current DITA content for the documentation from your CMS or version control system, then downloads a DITA Open Toolkit (from the DITA OT website I mentioned), unzips it, then runs the DITA OT process specifying various parameters to it (path to the DITA Map, output format). Then the Jenkins job can take the output content and move it to a web server to publish it.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

Post Reply