[Sugar-devel] FM-->DocBook (was Fwd: [FM Discuss] Fwd: Documentation ...)

[Edward Cherlin]

Here is your invitation to have at FLOSS Manuals to Docbook XML conversion.

---------- Forwarded message ----------
From: adam hyde <adam at flossmanuals.net>
Date: Sun, May 31, 2009 at 8:17 PM
Subject: Re: [FM Discuss] Fwd: [Sugar-devel] Documentation [WAS:
Re:	[Localization] Help activity]
To: discuss at lists.flossmanuals.net


not too tricky...you could try it yourself :
1. view a manual with the chapter _all
2. add the following ?skin=basic

that gives you an entire manual without a skin...then u can see the raw
html and try out some transformations on that...

im offline as i write this but i believe there is some good stuff online
about html->docbook transformations

if you can write a shell script to do it then we can hack it in somehow

adam

On Thu, 2009-05-28 at 16:12 -0700, Edward Cherlin wrote:
> How hard would it be to get the FM software to generate Docbook XML?
> That would give us several more output formats.
>
>
> ---------- Forwarded message ----------
> From: Tomeu Vizoso <tomeu at sugarlabs.org>
> Date: Thu, May 28, 2009 at 2:45 AM
> Subject: Re: [Sugar-devel] Documentation [WAS: Re: [Localization] Help activity]
> To: Sayamindu Dasgupta <sayamindu at gmail.com>
> Cc: iaep <iaep at lists.sugarlabs.org>, Localization at lists.laptop.org,
> sugar-devel <sugar-devel at lists.sugarlabs.org>, "Diogo Serra @
> IPLEIRIA" <diogo.serra at ipleiria.pt>
>
>
> 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/ :-)
>
> +1
>
> What I have been wishing for.
>
> > 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]
> >
> _______________________________________________
> Sugar-devel mailing list
> Sugar-devel at lists.sugarlabs.org
> http://lists.sugarlabs.org/listinfo/sugar-devel
>
>
>
--
Adam Hyde
Founder FLOSS Manuals
German mobile : + 49 15 2230 54563
Email : adam at flossmanuals.net
irc: irc.freenode.net #flossmanuals

"Free manuals for free software"
http://www.flossmanuals.net/about


_______________________________________________
Discuss mailing list
Discuss at lists.flossmanuals.net
http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net



-- 
Silent Thunder (默雷/धर्ममेघशब्दगर्ज/دھرممیگھشبدگر ج) is my name
And Children are my nation.
The Cosmos is my dwelling place, The Truth my destination.
http://earthtreasury.org/worknet (Edward Mokurai Cherlin)