On Fri, Mar 2, 2012 at 1:52 AM, gihan karunarathne <> 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
"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") 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 ?.
Hi,
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?
Regards,
--Kasun
Thank You in Advance !.
regards,
Gihan Chanuka
On Thu, Mar 1, 2012 at 10:44 PM, <> wrote:
Gihan,
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.
http://sourceforge.net/projects/docbook/files/docbook-xsl/
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.
Regards,
Dean Nelson
In a message dated 2/29/2012 11:01:46 P.M. Pacific Standard Time,
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
twitter: http://twitter.com/kasunbg
