Create html documents

Jendrik Seipp <jendrikseipp at web.de>
Sun Jul 18 16:23:38 EDT 2010

Thank for your help guys, Shaun's instructions worked.

Cheers,
Jendrik

Am 16.07.2010 16:51, schrieb Shaun McCance:
> 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
>
>
>