Re: HELP_ID doesn't point to a real file, probably a macro

[Petr Kovar <pmkovar gnome org>]

Hi,

The issue seems to be fixed now after committing a dummy index.page file
needed by DL to recognize Mallard documentation. Thanks to Claude for
pointing me in the right direction!


On Fri, 08 Mar 2013 18:05:43 +0100
Mario Blättermann <mario blaettermann gmail com> wrote:

> Am 08.03.2013 17:58, schrieb Petr Kovar:
> > Hey list,
> >
> > DL currently seems to error out with "HELP_ID doesn't point to a real
> > file, probably a macro" when updating a POT for:
> >
> > https://l10n.gnome.org/module/gnome-getting-started-docs/
> >
> > Looks like it might be related to the directory structure being different
> > from the HELP_ID. We share the HELP_ID with gnome-help from gnome-user-docs
> > so that we can install the getting-started files in the same installation
> > directory (normally /usr/share/help/C/gnome-help/).
> >
> > Would it help to move the files in the getting-started git repo from the
> > getting-started subdirectory to the gnome-help subdirectory?
> Could be... Well, it's a good idea to provide the getting-starting-docs 
> as part of the user manual, but this way it is difficult to handle. It 
> causes problems with creating the pot files as seen here. Moreover, when 
> I check out the module and try to run "yelp ." as usual from the folder 
> containing the *.page files, Yelp doesn't show anything because the file 
> index.page is missing.

I fixed this by committing the index.page file that will not be
distributed in the tarball (similarly to the legal.xml file, also present
in the same subdirectory).

You could also try running "yelp getting-started.page" to directly open
the landing page for Getting Started.

> Actually, gnome-getting-started-docs should be integrated into the 
> gnome-user-docs Git module. This should avoid the trouble.

I actually like the modularity design of Mallard documents, which
gives us and downstream distributors more freedom in how we can design
and deliver the content. But, more importantly, we plan to further split
the getting-started package into language packs /subpackages to distribute
the translated video files (bug #692208). 

Cheers,
Petr Kovar