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] What is it mean by BUILDING DocBook ?

On Fri, Mar 2, 2012 at 1:52 AM, gihan karunarathne <gckarunarathne@gmail.com> wrote:
Dean Nelson,

I like to getting involved with DocBook project and contribute to develop it.
I will go though the links which are provided by you. It seems to be I can find more information from the Bob Stayton's book on DocBook.

Up to now, I followed the procedure which is mentioned in the file "docbook/trunk/xsl/README.BUILD". According to the readme file, I did following steps which are mentioned as relevant for contributors;
                "Part 1: Build and test the stylesheets
                 This section explains how to do a developer/contributor build of
                  the stylesheets."

> Part 0: Build Setup
   > 0. Third-party build dependencies.
   > 3. Shell Environment.
   > 4. ~/.xmlc
> Part 1: Build and test the stylesheets
   > 1. make all ( I got an error here while executing 

     . ~/docbk.sh && \
     $DOCBOOK_SVN/buildtools/build-clean && \
     make all 2>&1 \
       XSLTENGINE=xsltproc \
       | tee DOCBOOK-BUILD.LOG && \
     $DOCBOOK_SVN/buildtools/build-check DOCBOOK-BUILD.LOG") piece of lines.

I'm using Ubuntu 11.10 to build the stylesheets
When I execute the command without changing any thing, I got below message;

gihan-PC:~$ rm -f DOCBOOK-BUILD.LOG && \
>      . ~/docbk.sh && \
>      $DOCBOOK_SVN/buildtools/build-clean && \
>      make all 2>&1 \
>        XSLTENGINE=xsltproc \
>        | tee DOCBOOK-BUILD.LOG && \
>      $DOCBOOK_SVN/buildtools/build-check DOCBOOK-BUILD.LOG
svn: warning: '.' is not a working copy
svn: warning: '.' is not a working copy
make: *** No rule to make target `all'.  Stop.

Possible build problems found:

make: *** No rule to make target `all'.  Stop.

Stopping. "

What is the problem with my procedure?. How can I create a ". ~/docbk.sh" file ?.

I'd say, just create a file named docbk.sh at any location you want but remember the full path to it. The content for this are given in step 3 of README.BUILD. There, you need to make sure the 'export' paths are correct. For example, DOCBOOK_SVN should point to your DocBook svn checkout directory.

After that, open up ~/.bashrc (by command gedit ~/.bashrc). This file is located at /home/your-account-name/.bashrc. "~/" is an alias. Now, instead of adding ". ~/docbk.sh" to that file as said in the README.BUILD, add the following.
. /add/full/path/to/docbk.sh

Don't worry about this much. It's a simple procedure. I suspect that the error you are getting "svn: warning: '.' is not a working copy" is because DOCBOOK_SVN is not set correctly.  Can you run the command `echo $DOCBOOK_SVN` and see whether it outputs the correct directory?


Thank You in Advance !.

Gihan Chanuka

On Thu, Mar 1, 2012 at 10:44 PM, <DeanNelson@aol.com> wrote:
You are referring to the instructions in the source tree that enumerate the steps required for building a "release" package. This is for the developers who preprocess/build each release that shows up on SourceForge. This is not a normal process for users of DocBook.
The normal usage for user would be to download the ZIP file of the release and set up your XSLTPROC (or other tools) to run against that release.
The XSLT processors transform the DocBook XML into HTML, PDF, EPUB, etc, via the XSL  stylesheets in the release package.
I would also suggest that you read the Bob Stayton's book on DocBook
http://www.sagehill.net/docbookxsl/index.html  also available in paper copy.
Dean Nelson
In a message dated 2/29/2012 11:01:46 P.M. Pacific Standard Time, gckarunarathne@gmail.com writes:
Hi devs,

I'm Gihan Chanuka. An undergraduate of Bsc Engineering, University of Moratuwa, Sri Lanka. I'm new to open source and also to DocBook. But as I see, DocBook is one of the interesting and innovative idea.  So, I liked to get familiar with the DocBook project.

I went through some of the tutorials and documentation about it. And then, transformed a small DocBook document to html using xsltproc to understand how it works.

I got the DocBook source code by using SVN and went though "trunk>xsl>ReadMe.BUILD" and follow the steps in that file.

Can you tell me what is meant by "building" DocBook? It use XSL language to interpret and virtual processor called "XSLT" to transform the xml files. Since, we don't need to XSLs, what exactly we do when building?

Thanks in advance!

~ Gihan Chanuka
~ Undergraduate of Bsc Engineering,
~ Department of Computer Science and Engineering,
~ University of Moratuwa,
~ Sri Lanka.

Kasun Gajasinghe
Software Engineer; WSO2 Inc.; http://wso2.com,
linked-in: http://lk.linkedin.com/in/gajasinghe
blog: http://blog.kasunbg.org


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