Create html documents

Shaun McCance <shaunm at gnome.org>
Fri Jul 16 10:51:51 EDT 2010

On Fri, 2010-07-16 at 03:02 +0200, Jendrik Seipp wrote: 
> Thanks for the info. I cloned yelp-tool and yelp-xsl from git and could 
> convert the files to html with
> 
> xsltproc /usr/local/share/yelp-xsl/xslt/mallard/html/mal2xhtml.xsl *.page
> 
> However, something is missing: I do not see links to the subpages on the 
> index.html page. Also, the information at the top where we are and the 
> "further reading part" is missing. Or is that something yelp provides?

gnome-doc-utils does have Mallard->HTML transformations,
and gnome-doc-tool should be able to handle the conversion,
but it can be a bit flaky, and it doesn't have some of the
newer features that are in yelp-xsl.

yelp-tools doesn't yet have a script to convert to HTML,
so you have to call xsltproc by hand. To get the dynamic
links, you first have to create a cache file. There is a
tool in yelp-tools for this: yelp-cache. Just call it in
the directory containing your page files, and it will
create an index.cache file.

Then call xsltproc like this:

xsltproc --stringparam mal.cache.file index.cache \
  /path/to/mal2xhtml.xsl *.page

Oh, and I *just* committed a fix to yelp-xsl to let you
pass "index.cache" without a full path, so you should
update yelp-xsl from git.

Hope this helps. Let me know if you still have troubles.

--
Shaun