Re: Need help to get started with Mallard
- From: Leonardo Ferreira Fontenelle <leonardof gnome org>
- To: Shaun McCance <shaunm gnome org>
- Cc: GNOME Documentation <gnome-doc-list gnome org>
- Subject: Re: Need help to get started with Mallard
- Date: Wed, 28 Oct 2009 19:14:54 -0200
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>
--
Shaun
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]