Re: Need help to get started with Mallard

[Shaun McCance <shaunm gnome org>]

On Wed, 2009-10-28 at 19:14 -0200, Leonardo Ferreira Fontenelle wrote:
> Em Qua, 2009-10-28 às 12:01 -0500, Shaun McCance escreveu: 
> > On Tue, 2009-10-27 at 23:00 -0200, Leonardo Ferreira Fontenelle wrote:
> > > I wrote an index page, mostly the same as the one in the Ten Minutes
> > > Tour, and I can't have it converted to a (x)html page. What else
> > > should I do?
> > > 
> > > $ cat index.page
> > > <page xmlns="http://projectmallard.org/1.0/"; type="guide" id="index">
> > > <title>Referência Médica</title>
> > > </page>
> > > $ gnome-doc-tool xhtml index.page
> > > Unmatched element: page
> > > Unmatched element: title
> > > 
> > > For me it seems that the syntax is correct. Isn't gnome-doc-utils
> > > (0.18) recognizing it as a Mallard page? Do I need to set up autottool
> > > files and the GNOME help  directories hierarchy? I'd like to try
> > > Mallard outside software documentation...
> > 
> > Unfortunately, I didn't get Mallard support into gnome-doc-tool
> > in gnome-doc-utils 0.18.  The stylesheets were added, and the
> > build magic was added, but not the quick-fire command line tool.
> > 
> > I've attached a quick Makefile you can use to build XHTML for
> > a Mallard document.  It doesn't need to be integrated into a
> > full build system.  Just drop it in the same directory as your
> > page files and type 'make'.
> > 
> > The stylesheets rely on a cache file being generated first, and
> > this Makefile will take care of that for you.  The format of the
> > cache file is probably going to change slightly, so be aware that
> > this Makefile may not work as-is with gnome-doc-utils 0.20.  (But
> > then, gnome-doc-tool should do the right thing in 0.20.)
> > 
> 
> Thank you, it worked very well. But I've got two pages, index.page and
> asma-cronica.page (in English: cronic-asthma.page), and the generated
> index.xhtml doesn't have any reference to asma-cronica.page, even if
> index.cache does have it. What am I missing?
> 
> $ head -n 3 asma-cronica.page 
> <page xmlns="http://projectmallard.org/1.0/"; type="topic"
> id="asma-cronica">
>   <info><link type="guide" xref="index" /></info>
>   <title>Asma crônica</title>
> 
For the benefit of the list, Leonardo and I figured this out on IRC.
For some reason, reading the cache file fails when there are non-ASCII
characters in the file name.

--
Shaun