From owner-freebsd-doc@FreeBSD.ORG Wed Aug 21 13:58:57 2013 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id A28F4810 for ; Wed, 21 Aug 2013 13:58:57 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4E4EB2D90 for ; Wed, 21 Aug 2013 13:58:57 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id r7LDwtZp006165; Wed, 21 Aug 2013 07:58:55 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r7LDwtbD006162; Wed, 21 Aug 2013 07:58:55 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Wed, 21 Aug 2013 07:58:55 -0600 (MDT) From: Warren Block To: Ganbold Tsagaankhuu Subject: Re: Updating translation workflow In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="3512871622-1094708081-1377093535=:5571" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Wed, 21 Aug 2013 07:58:55 -0600 (MDT) Cc: doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 21 Aug 2013 13:58:57 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. --3512871622-1094708081-1377093535=:5571 Content-Type: TEXT/PLAIN; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8BIT > I think we can use a combination of tools to work with our existing documents.  The workflow would be like this: > > 1. Use textproc/itstool to create a "strings to be translated" file >    (.pot) from an XML file. > > 2. Use pootle as a database to translate any of those strings that have >    not already been translated. > > 3. Use itstool to merge the translated strings back into the XML file. > > > I'm not quite sure here when we are putting back strings I guess we have to check again the meaning of the sentence. Examples may help: A German translation of a sentence: http://pootle.pcbsd.org/de/pcbsd/translate.html?unit=461257 Gnome uses the .pot/.po files to translate their documentation. Instructions that are specific to translating documentation as opposed to programs are hard to find. Possibly they don't make that distinction because the process is identical. An example: https://wiki.gnome.org/ReleaseNotes/Translating And a sample of the German .po file for a document: https://l10n.gnome.org/POT/gnome-user-docs.master/docs/gnome-help.master.de.po > What if we can have some rules for English documentation change? > For instance maybe limitation of changes in doc for one commit per day etc. I know English version needs to be updated very frequently and always needs modifications, improvements etc. > However if we can have some limitation of changes (I mean small changes like maybe couple of hundred lines that translators can follow immediately with ease) then it would be much > easier for translators and that would maybe help new translators join. Like asking them to work on small changes and review if necessary. > > And of course automated tools would be nice addition to it. Personally, I'd like to see fewer restrictions and much more automated help for everyone. With the .pot/.po system, whitespace changes seem to no longer be a problem. The web interface makes it much easier to get involved with translation, less intimidating for new translators and less work for experienced translators. Also, there are many people with experience using that translation system, so there's less of a learning curve. It could provide helpful experience if FreeBSD translators signed up for an account on the PC-BSD Pootle site and tried translating a few things there. And there may be other CAT software that we could use. Pootle is just a first possibility because PC-BSD is using it. It may even be possible to share the "translation memory" between PC-BSD and FreeBSD, reducing the effort to get documents translated. --3512871622-1094708081-1377093535=:5571--