Problem converting Mallard document to HTML

Shaun McCance <shaunm at gnome.org>
Sun Jan 16 12:38:55 EST 2011

On Sat, 2011-01-15 at 18:56 -0500, Luis Felipe López Acevedo wrote:
> Hi,
> 
> I'm trying to convert a Mallard document to HTML following the steps I
> found in the list archives[1], but I get some errors:
> 
> $ gnome-doc-tool html -c index.css index.page
> /usr/bin/gnome-doc-tool: 1: Bad substitution
> file://:1: parser error : Document is empty
> 
> ^
> file://:1: parser error : Start tag expected, '<' not found
> 
> ^
> 
> The document I'm trying to convert is the "First page" from the Ten
> Minute Tour[2].

What version of gnome-doc-tool are you using?

$ gnome-doc-tool --version

Also, what's the full path of the directory you're running
it in? gnome-doc-tool is known to have issues when paths
contain spaces, non-ASCII characters, and some other stuff.


Also, if you want to be bleeding edge, you could try using
yelp-build from yelp-tools instead. You'll have to build it
from git. Here's how:

First, if you don't have git installed, install it:

$ sudo apt-get install git

Next, to build most package from Gnome git, you'll need the
gnome-common package installed. You can get this from apt:

$ sudo apt-get install gnome-common

Next, you'll need a very recent copy of yelp-xsl installed.

$ git clone git://git.gnome.org/yelp-xsl
$ cd yelp-xsl
$ ./autogen.sh --prefix=/usr
$ make
$ sudo make install

Finally, install yelp-tools.

$ git clone git://git.gnome.org/yelp-tools
$ cd yelp-tools
$ ./autogen.sh --prefix=/usr
$ make
$ sudo make install

You should now be able to build HTML with this command:

$ yelp-build html *.page

--
Shaun