Re: Need help to get started with Mallard

[Shaun McCance <shaunm gnome org>]

On Thu, 2009-10-29 at 19:25 -0200, Leonardo Ferreira Fontenelle wrote:
> Em Qua, 2009-10-28 às 21:02 -0500, Shaun McCance escreveu: 
> > 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>
> > > 
> > Does index.page have type="guide"?
> > 
> Yes (see in the first quoted email).

Ah, right.  Sorry.

So I just tried this with your index.page and asma-cronica.page here,
closing the asma-cronica page after the title.  It worked as expected.
Can you send me those two files and the generated cache file?

--
Shaun