Re: [libreoffice-l10n] Best way to create new help entries

Hi,

2011/11/17 Alexander Thurgood <alex.thurgood@gmail.com>:
> Hi all,
>
> I have an itch to scratch in the Base help (which I find totally
> lacking, but hey, just my opinion) and so I've been thinking about the
> best way to improve it :
>
> (1) hack the XHP files directly and then git diff them ;
> - how would I deal with new entries ? my understanding is that I need to
> create a new unique id somewhere ?

That would work. It's not that hard to create new unique IDs. When you
edit XHP files, you'll see where and how to use IDs. You can't do it
wrong, because if you do, the build will break. So you'll notice. :)

> (2) add pages to, or expand on, the wiki online help in the hope that
> these then get converted back to XHP files
> - I see in the code repo that there are some python scripts for doing
> this, but are they actually used ?

Scripts do XHP -> Wiki conversion, not the other direction. At the
moment the only way to extend the help is to modify XHP files.

> On a more general note, could we not move the Base help out of /shared
> into its own module, like the other main modules ?

That would be a big work at the source level and for end users the
result will be the same. Why should we bother?

Thanks,
Andras

-- 
Unsubscribe instructions: E-mail to l10n+help@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/l10n/
All messages sent to this list will be publicly archived and cannot be deleted