OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Using the DocBook XSLT 2.0 stylesheets with Gradle

On 3/5/18 10:14 AM, Dave Pawson wrote:
I got as far as ant for builds. I can understand most of that.

Bash script... similar? Maybe

gradle? Wozzat.

Why make it deeper than needs be?


The idea is to make it super easy for someone (e.g. an author) who just wants to build the doc. They don't want to install a ton of stuff _at the right version_ and keep track of it.

From an end-user's perspective, setting up the whole tool chain and building the doc at most three steps:

# You only have to do this once (or use apt-get/yum or whatever windows
# users do to install software):
brew install gradle

# Get DocBook xml source from whatever source control system
# it lives in...
git clone <url-to-repo-for-somedoc> && cd somedoc

# This installs the DocBook toolchain and builds the doc:
gradle somedoc

Even as new versions of the underlying tools come out, "somedoc" continues to build because your gradle file indicates what versions it depends on. However, you easily can switch to newer versions if you need to.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]