[IAEP] Documentation [WAS: Re: [Sugar-devel] [Localization] Help activity]

[Tomeu Vizoso]

On Tue, May 26, 2009 at 21:47, Sayamindu Dasgupta <sayamindu at gmail.com> wrote:
> [Jumping into the discussion midway]:
>
> From an l10n point of view, I would highly recommend adopting (and
> perhaps extending) the GNOME documentation framework. It is docbook
> based, which is a format pretty easy to pick up (and I believe
> OpenOffice.org can also export to docbook - though I have never tried
> it out).

Well, I think it was a decision by the people who wrote the manual to
use floss manuals, I guess it would be up to them which tool they use.
And in the same way, translators would choose the tools that best suit
them. I think that floss manuals has already tools for translation and
also think that people have worked on a translation to spanish, Maybe
we should ask to those people which was their experience with the
floss manuals tool set?

Regards,

Tomeu

> Many programmers and documentation people should This would
> easily let us
>
> a) generate PO files out of the documentation files
> b) merge back translations easily
> c) generate multiple format files (PDF, epub, rtf, etc)
>
> It would be even more incredible if our documentation system can be
> integrated with the work being done at http://tutorius.org/ :-)
>
> A random google search brought up the story of a project which had
> used twiki initially, and then had moved on to docbook:
> http://www.ipcop.org/1.2.0/en/authors_guide/html/what-is-docbook.html
>
> Also, converting existing material might not be _that_ difficult: see
> http://deplate.sourceforge.net/
>
>
> Thanks,
> Sayamindu
>
>
> On Wed, May 20, 2009 at 2:29 PM, Tomeu Vizoso <tomeu at sugarlabs.org> wrote:
>> [forwarding to sugar-devel at lists.sugarlabs.org]
>>
>> 2009/5/14 Diogo Serra @ IPLEIRIA <diogo.serra at ipleiria.pt>:
>>> Hy there,
>>>
>>> Where i can find the *.po  of Help activity ?
>>>
>>> Thanks
>>> --
>>> Diogo Serra
>>> Programação e Desenvolvimento
>>>
>>> Campus 5 - Rua das Olhalvas
>>> 2414 - 016 Leiria - PORTUGAL
>>> Tel.: (+351) 244 845 052 | Fax: (+351) 244 845 059
>>>  | diogo.serra at ipleiria.pt | http://ued.ipleiria.pt
>>>
>>>
>>>
>>> _______________________________________________
>>> Localization mailing list
>>> Localization at lists.laptop.org
>>> http://lists.laptop.org/listinfo/localization
>>>
>>>
>> _______________________________________________
>> Sugar-devel mailing list
>> Sugar-devel at lists.sugarlabs.org
>> http://lists.sugarlabs.org/listinfo/sugar-devel
>>
>
>
>
> --
> Sayamindu Dasgupta
> [http://sayamindu.randomink.org/ramblings]
>