Re: How to compile the docs of Nmap (DocBook XML) on Ubuntu?

[食肉大灰兔V5 <hsluoyz () gmail com>]

Hi David,

Thanks for your help. I ran the command like this:

root@ubuntu:/# xsltproc -o ncatguidehtml.html
/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl ncatguidehtml.xml
Element continuation in namespace '' encountered in screen, but no template
matches.

It seems that the tag "continuation" is not recognized by my docbook.xsl
style file. So I removed the only one occurrence of it: <continuation/> in
Line: 471. Then recompile and everything is OK now.
It's weird. I wonder maybe it's because Ncat's docs is using DocBook XML
4.4, and what I have installed is DocBook XML 5.0?


Cheers,
Yang


On Wed, May 4, 2016 at 11:00 PM, David Fifield <david () bamsoftware com>
wrote:

> On Wed, May 04, 2016 at 05:20:02PM +0800, 食肉大灰兔V5 wrote:
> > Hi list,
> >
> > I'm currently using Ubuntu 14.04 to compile Nmap docs by following the
> guide
> > here: https://help.ubuntu.com/community/DocBook
> >
> > I successfully built the hello world in that guide. Then I pasted one
> doc file
> > (
> https://github.com/nmap/nmap/blob/ad5909f807ce2ba8c5408e7500e627d0d2486148/
> > ncat/docs/ncatguide.xml) into my XML file (test.xml) and compiled. It
> gave me
> > the following error:
> >
> > root@ubuntu:/# xsltproc -o test.html
> /usr/share/xml/docbook/stylesheet/nwalsh/
> > xhtml/docbook.xsl test.xml
> > test.xml:3: parser error : Extra content at the end of the document
> > <sect1 id="ncat-overview">
> > ^
> > unable to parse test.xml
> >
> >
> > I guess there's something wrong with my setting up. How to setup the
> build
> > environment for DocBook XML of Nmap and how to compile it? Thanks.
>
> You need to compile a wrapper XML file (that includes the <?xml> and
> DOCTYPE and everything), not just the file that contains the <sect1> and
> documentation.
>
> See here, ncatguidehtml.xml includes ncatguide.xml:
>
> https://github.com/nmap/nmap/blob/ad5909f807ce2ba8c5408e7500e627d0d2486148/ncat/docs/ncatguidehtml.xml
> _______________________________________________
> Sent through the dev mailing list
> https://nmap.org/mailman/listinfo/dev
> Archived at http://seclists.org/nmap-dev/
_______________________________________________
Sent through the dev mailing list
https://nmap.org/mailman/listinfo/dev
Archived at http://seclists.org/nmap-dev/