[docbook-apps] Re: Tools to make DocBook easier

[Norman Walsh]

Lars Vogel  writes:
> May I ask where does the code for the 'org.docbook.task' Gradle
> plug-in lives?

It's in the 2.0 repo:

  https://github.com/docbook/xslt20-stylesheets

It's also on Maven. I have a "getting started" project that uses it.
I should uncloak that, I guess.

Be seeing you,
  norm

-- 
Norman Walsh  | In science, "fact" can only mean
http://nwalsh.com/| "confirmed to such a degree that it
  | would be perverse to withhold
  | provisional assent." I suppose that
  | apples might start to rise tomorrow,
  | but the possibility does not merit
  | equal time in physics
  | classrooms.--Stephen J. Gould


signature.asc
Description: PGP signature

Re: [docbook-apps] Re: Tools to make DocBook easier

[Aristedes Maniatis]

If it is of use to anyone, here is my gradle build file for the documentation I 
create.

https://gist.github.com/ari/4156d967d54289f4abf6

This supports:

* custom css/js folders
* multiple projects within this top level gradle project (each create separate 
docs)
* tokens in the docbook to insert project name, version, published date and year
* a location for stylesheet overrides


If I get some time, I'll try and tidy it up to be more generic and perhaps a 
plugin. But hopefully it helps someone.

Ari


On 7/12/2015 9:40pm, Lars Vogel wrote:
> Hi Norman,
> 
> Nice to see a Gradle toolchain for creating DocBook output. Thanks for that.
> 
> May I ask where does the code for the  'org.docbook.task' Gradle plug-in 
> lives?
> 
> Best regards, Lars
> 
> 2015-09-15 16:05 GMT+02:00 Norman Walsh  >:
> 
> Warren Block > writes:
> > What tools are there to make working with DocBook easier?
> 
> I'm just in the process of finishing up a first release of a tool
> to make DocBook publishing easier with gradle. Given doc.xml, written
> in DocBook, this build.gradle file will download all of the necessary
> dependencies and run the transformations.
> 
> buildscript {
>   repositories {
> mavenCentral()
> maven { url "http://maven.restlet.org; }
>   }
> 
>   dependencies {
> classpath group: 'org.docbook', name: 'docbook-xslt2', version: 
> '2.0.14'
> classpath group: 'com.xmlcalabash', name: 'xmlcalabash1-print', 
> version: '1.1.4'
>   }
> }
> 
> repositories {
>   mavenLocal()
>   mavenCentral()
> }
> 
> apply plugin: 'org.docbook.task'
> 
> import org.docbook.DocBookTask
> 
> task publishhtml5(type: DocBookTask) {
>   format "html"
>   input "doc.xml"
>   output "index.html"
> }
> 
> task publishxhtml(type: DocBookTask) {
>   format "xhtml"
>   input "doc.xml"
>   output "index.html"
> }
> 
> task publishpdf(type: DocBookTask) {
>   format "foprint"
>   input "doc.xml"
>   pdf "doc.pdf"
> }
> 
> Needs documentation and such, but it does at least run now. :-)
> 
> Be seeing you,
>   norm
> 
> --
> Norman Walsh >  | There 
> might very well be nothing;
> http://www.oasis-open.org/docbook/ | nor anyone. No one to notice that
> Chair, DocBook Technical Committee | there is nothing, and to consider
>| that natural. But that there is
>| something, and, whatever it may
>| be, the strange thing! I shall
>| never cease being amazed at
>| this.--André Gide
> 
> 

-- 
-->
Aristedes Maniatis
ish
http://www.ish.com.au
Level 1, 30 Wilson Street Newtown 2042 Australia
phone +61 2 9550 5001   fax +61 2 9550 4001
GPG fingerprint CBFB 84B4 738D 4E87 5E5C  5EFA EF6A 7D2E 3E49 102A



signature.asc
Description: OpenPGP digital signature

Re: [docbook-apps] Re: Tools to make DocBook easier

[Lars Vogel]

Hi Norman,

Nice to see a Gradle toolchain for creating DocBook output. Thanks for
that.

May I ask where does the code for the  'org.docbook.task' Gradle plug-in
lives?

Best regards, Lars

2015-09-15 16:05 GMT+02:00 Norman Walsh :

> Warren Block  writes:
> > What tools are there to make working with DocBook easier?
>
> I'm just in the process of finishing up a first release of a tool
> to make DocBook publishing easier with gradle. Given doc.xml, written
> in DocBook, this build.gradle file will download all of the necessary
> dependencies and run the transformations.
>
> buildscript {
>   repositories {
> mavenCentral()
> maven { url "http://maven.restlet.org; }
>   }
>
>   dependencies {
> classpath group: 'org.docbook', name: 'docbook-xslt2', version:
> '2.0.14'
> classpath group: 'com.xmlcalabash', name: 'xmlcalabash1-print',
> version: '1.1.4'
>   }
> }
>
> repositories {
>   mavenLocal()
>   mavenCentral()
> }
>
> apply plugin: 'org.docbook.task'
>
> import org.docbook.DocBookTask
>
> task publishhtml5(type: DocBookTask) {
>   format "html"
>   input "doc.xml"
>   output "index.html"
> }
>
> task publishxhtml(type: DocBookTask) {
>   format "xhtml"
>   input "doc.xml"
>   output "index.html"
> }
>
> task publishpdf(type: DocBookTask) {
>   format "foprint"
>   input "doc.xml"
>   pdf "doc.pdf"
> }
>
> Needs documentation and such, but it does at least run now. :-)
>
> Be seeing you,
>   norm
>
> --
> Norman Walsh   | There might very well be nothing;
> http://www.oasis-open.org/docbook/ | nor anyone. No one to notice that
> Chair, DocBook Technical Committee | there is nothing, and to consider
>| that natural. But that there is
>| something, and, whatever it may
>| be, the strange thing! I shall
>| never cease being amazed at
>| this.--André Gide
>