[Sugar-devel] Potential volunteer offering technical writing

Gonzalo Odiard gonzalo at laptop.org
Tue Oct 4 22:41:06 EDT 2011


I think the easier way is have a different floss manual by language.
The Help Activity is only a shell, we can create a e-pub or a content bundle
if we want,
but doing the i18n at this level will be a nightmare.

Gonzalo

On Tue, Oct 4, 2011 at 7:25 PM, Chris Leonard <cjlhomeaddress at gmail.com>wrote:

> All,
>
> In any refresh of the XO manual (Help Activity),  I would very much
> appreciate if some structural choices could be made to facilitate the
> internationalization of the text so that it can be converted into PO
> files and posted on Pootle for translation into a renewed Help
> Activity.  That is not to say a pretty web-version would not also be
> nice.
>
> An ideal format option would include producing a simple plain text
> version with paragraphs separated by a whitespace line (easily parsed
> by txt2po) and back converted with po2txt.
>
> I have had very little success with the html2po tool from the
> Translate Toolkit when  I explored parsing the current Help Activity's
> html pages for i18n and L10n.  Nor have I had any great success with
> parsing the FLOSSManuals version.  On the other hand, txt2po and
> po2txt has been working well for the Waveplace lesson plans.
>
> I have long considered it a great shame that the Help Activity was
> only in English, and although the XO manual on FLOSSManuals has seen
> translation into a few languages, I fear that the tools for long-form
> content L10n are just not as functional as Pootle or as well used by
> our L10n community.
>
> cjl
>
>
> On Tue, Oct 4, 2011 at 9:12 AM, Christoph Derndorfer
> <christoph.derndorfer at gmail.com> wrote:
> > On Tue, Oct 4, 2011 at 5:18 AM, Martin Langhoff <
> martin.langhoff at gmail.com>
> > wrote:
> >>
> >> Hi Tabs!
> >>
> >> that's great! Here's an idea: I was looking at recently at the FLOSS
> >> Manuals manuals for Sugar and activities... and they are a bit dated
> >> -- they cover Sugar 0.86 or so. Screens have changed quite a bit :-)
> >> and some procedures are much simpler (ad hoc networking for example).
> >>
> >> And the FLOSS Manuals feed into the Help Activity, so work there pays
> >> of many times over...
> >>
> >> My 2 deflationary cents...
> >
> > +2 equally deflationary Eurocents;-)
> > eKindling's Cherry (now in CC) suggested a similar Help Activity Refresh
> as
> > one of the activities for the OLPC-SF Community Summit and some good
> ideas
> > were thrown around as a result. So I think it makes sense to tie those
> two
> > thread of conversation together.
> > Cheers,
> > Christoph
> >
> >>
> >> m
> >>
> >> On Fri, Sep 30, 2011 at 5:51 AM, Tabitha Roder <tabitha at tabitha.net.nz>
> >> wrote:
> >> > Hi
> >> >
> >> > If we had a volunteer (English Native language) professional technical
> >> > writer, what writing would be of most use to OLPC or Sugar that we can
> >> > point
> >> > her in the direction of? She currently works with developers to write
> >> > end
> >> > user documentation.
> >> >
> >> > Thanks
> >> > Tabitha - NZ volunteers
> >> >
> >> > _______________________________________________
> >> > Devel mailing list
> >> > Devel at lists.laptop.org
> >> > http://lists.laptop.org/listinfo/devel
> >> >
> >> >
> >>
> >>
> >>
> >> --
> >>  martin.langhoff at gmail.com
> >>  martin at laptop.org -- Software Architect - OLPC
> >>  - ask interesting questions
> >>  - don't get distracted with shiny stuff  - working code first
> >>  - http://wiki.laptop.org/go/User:Martinlanghoff
> >> _______________________________________________
> >> Devel mailing list
> >> Devel at lists.laptop.org
> >> http://lists.laptop.org/listinfo/devel
> >
> >
> >
> > --
> > Christoph Derndorfer
> > editor, OLPC News [www.olpcnews.com]
> > volunteer, OLPC (Austria) [www.olpc.at]
> > e-mail: christoph at derndorfer.eu
> >
> >
> > _______________________________________________
> > Sugar-devel mailing list
> > Sugar-devel at lists.sugarlabs.org
> > http://lists.sugarlabs.org/listinfo/sugar-devel
> >
> >
> _______________________________________________
> Devel mailing list
> Devel at lists.laptop.org
> http://lists.laptop.org/listinfo/devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.laptop.org/pipermail/devel/attachments/20111004/7091425d/attachment.html>


More information about the Devel mailing list