On Fri, Mar 2, 2012 at 1:52 AM, gihan karunarathne <[email protected] > 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, <[email protected]> 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, >> [email protected] 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* <http://blog.kasunbg.org/> * twitter: **http://twitter.com/kasunbg* <http://twitter.com/kasunbg>
