[Koha-docs] [Koha-translate] Arabic manual 38

Fri Jul 13 16:36:52 CEST 2012

I think the idea of having po files for translating the manual is an interesting idea - because it means that when Nicole updates the manual, not the whole manual will have to be retranslated, but only the changed parts of it. If we keep the image names the same for each language, we could also have "translated" screenshots for each language. 

Git allows to see what has changed in the English manual between versions, but those changes are not reflected in the translated manuals.

If someone wants to do a 1:1 translation, using po files make a lot of sense and it would lower the barrier for translating the manuals.

Katrin

> -----Original Message-----
> From: koha-translate-bounces at lists.koha-community.org [mailto:koha-
> translate-bounces at lists.koha-community.org] On Behalf Of Nicole Engard
> Sent: Friday, July 13, 2012 4:21 PM
> To: Karam Qubsi
> Cc: Larry Baerveldt; Frédéric Demians; koha.ILS at groups.facebook.com;
> koha-docs at lists.koha-community.org; koha-translate at lists.koha-
> community.org
> Subject: Re: [Koha-translate] Arabic manual 38
> 
> I don't know anything about po - all I know is that the manual is in
> Docbook and when I push changes to it those are converted to HTML with a
> script on the server for display. If another set up is necessary, we'll
> need to discuss hat that requires.
> 
> For me the best place to start in the 3.8 manual and submit patches to
> the docbook file to me via this list.  Then once you have the 3.8 manual
> translated you can use that as the base for the 3.10 manual (at least
> that's what I do).
> 
> Nicole
> 
> On Fri, Jul 13, 2012 at 12:16 AM, Karam Qubsi <karamqubsi at gmail.com>
> wrote:
> > Hi all
> >
> > Thanks Nicole
> > I test it locally and it looks good , and i found the way to convert
> > it to html :) (and to po)
> >
> > but I'm puzzled a little
> >
> > where is the best to start ?
> > in translating the 3.8 manual ( because it is maybe stable more than
> > 3.10)
> >
> > or work in 3.10 to make the next koha version full in Arabic (manuals
> > and
> > system)
> >
> > so please advice .
> >
> > and one more point , I've found a tool that convert (docbook) format
> > to po and we can translate it from there
> >
> > it is more easy to translate
> >
> > If there is flaws in this solution please let me know.
> >
> >  the attached file is the po generated from the manaul.xml (for 3.10)
> > and it could be  re convert to xml after translation
> >
> > I used the gnome-doc-utils
> > https://live.gnome.org/GnomeDocUtils/
> >
> > "It includes xml2po tool which makes it easier to translate and keep
> > up to date translations of documentation"
> >
> > Hi Frédéric :)
> >
> > Can we use the Pootle Server to translate manuals ? as a new project
> > (not just for arabic )
> >
> > I think to make koha more translatable we need to provide easy way to
> > translate the system and the manuals I think the translator who used
> > to translate in Pootle will find this more easier to translate the
> > documentation
> >
> > I wish you all happy times
> >
> >
> >
> >
> >
> >
> >
> >
> > On Thu, Jul 12, 2012 at 10:48 PM, Nicole Engard <nengard at gmail.com>
> wrote:
> >>
> >> Here's how it converted in 3.2
> >> (http://manual.koha-community.org/3.2/ar/) does that look right? If
> >> so then your 3.8 manual should be A-OK. If you need to see the 3.2
> >> manual it's in git.
> >>
> >> Nicole
> >>
> >> On Wed, Jul 11, 2012 at 3:52 PM, Nicole Engard <nengard at gmail.com>
> wrote:
> >> > I need to check with someone about the script we use to convert XML
> >> > to HTML ... I don't know the way it works or if it will work for
> >> > your purposes. If anyone else on the list knows the answer I'd love
> >> > to hear it.
> >> >
> >> > Nicole
> >> >
> >> > On Wed, Jul 11, 2012 at 3:03 PM, Karam Qubsi <karamqubsi at gmail.com>
> >> > wrote:
> >> >> Hi
> >> >> first I'm so sorry if I bother you with my  questions.
> >> >>
> >> >> I have try to translate some parts in the manual of koha 3.8 , and
> >> >> I finish editing some section in the first chapter
> >> >>
> >> >> 1. Administration
> >> >> 1. Global System Preferences
> >> >> 1.1. Acquisitions 100%
> >> >> 1.2. Administration   20%
> >> >>
> >> >> with images from the English version  ( I will later update images
> >> >> from the Arabic version )
> >> >>
> >> >> so , I want to test my work in the web , and see if my work  will
> >> >> look good in the manual web site
> >> >>
> >> >> and I don't have experience about if I have to do some thing with
> >> >> my xml file to make the html result goes from right to left , or
> >> >> this will be done automatically ?
> >> >>
> >> >> and I want to ask , If I have to start work in the koha 3.10
> >> >> (better ) or working in koha 3.8 now (as what I'm doing) , and in
> >> >> the future we can update the changes and make it fit the koha 3.10
> >> >> .
> >> >>
> >> >> I wish you will batch my file as soon ad you can to see it
> >> >>
> >> >> i'm sorry if i have to do something else to do batches so please
> >> >> guide me to the correct way
> >> >>
> >> >> I know that not every one can send batches using git , so I attach
> >> >> the file here :)
> >> >>
> >> >> and thanks for your helps :)
> >> >> Thank you for your patience
> >> >>
> >> >>
> >> >>
> >> >> --
> >> >> Karam Qubsi
> >> >> Koha Arab Translating Team
> >> >> http://koha.wikibrary.org/
> >> >> Wikibrary for Arab Librarians
> >> >> http://wikibrary.org
> >> >>
> >
> >
> >
> >
> > --
> > Karam Qubsi
> > Koha Arab Translating Team
> > http://koha.wikibrary.org/
> > Wikibrary for Arab Librarians
> > http://wikibrary.org
> >
> _______________________________________________
> Koha-translate mailing list
> Koha-translate at lists.koha-community.org
> http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-translate
> website: www.koha-community.org
> git: git.koha-community.org
> bugs: bugs.koha-community.org