From owner-freebsd-doc@FreeBSD.ORG Tue Feb 18 05:19:09 2014 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 8DBFB3CF; Tue, 18 Feb 2014 05:19:09 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4B64E1C42; Tue, 18 Feb 2014 05:19:09 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.8/8.14.8) with ESMTP id s1I5J3Fr044147 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Mon, 17 Feb 2014 22:19:03 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.8/8.14.8/Submit) with ESMTP id s1I5J3RI044144; Mon, 17 Feb 2014 22:19:03 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Mon, 17 Feb 2014 22:19:03 -0700 (MST) From: Warren Block To: d@delphij.net Subject: Translations (was Re: svn commit: r43974 - head/en_US.ISO8859-1/books/handbook/advanced-networking) In-Reply-To: <5302E05F.1050200@delphij.net> Message-ID: References: <201402180226.s1I2QS0x076422@svn.freebsd.org> <5302C7B9.7090208@delphij.net> <5302E05F.1050200@delphij.net> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Mon, 17 Feb 2014 22:19:03 -0700 (MST) Cc: "freebsd-doc@freebsd.org" , Warren Block X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Feb 2014 05:19:09 -0000 On Mon, 17 Feb 2014, Xin Li wrote: > (redirecting to freebsd-doc@) Subject changed. > On 2/17/14, 7:10 PM, Warren Block wrote: >> >> I'm sorry, these multiple whitespace changes were my fault due to >> a mixup with Allan Jude's original patch. Normally, it would have >> been a single commit. >> >> I apologize for this difficulty. > > Well, please don't take it too personally :) Thanks. :) >> Would it help if these changes were reverted with a "reverse merge" >> of r43920, r43921, r43973, r43974, and r43975, then recommitted >> with the whitespace patches combined, or is it too late for that? > > I think using a batch of commits instead of one big commit is > generally a good idea because the diff is easier to read/merge. What > makes it hard to track is when the space changes are made in larger > timespan as they would be harder to ignore them or need more manual > intervention. I think I understand. Part of my difficulty is being monolingual, it's hard for me to see exactly what translators do. Benedict has explained it to me, but it sounds so difficult to track changes that it's hard to believe anyone can keep up with it. (Oh, and if those changes need to be reverted, let's do that as soon as possible.) >> If there is any way I or other committers can make this easier for >> translators, please post on the -doc mailing list or to me >> invididually. > > One thing I would recommend is to separate the contents that do not > need translation (e.g. tags, entities, etc.) and contents that needs > translation. This way, these contents would serve as a positioning > blocks when merging from upstream (English). That sounds interesting, and leads well into the next part: >> We are also trying to modernize the translation process, and >> automate some of the work that translators are currently forced to >> do. Anyone who would like to help with that is welcome. > > That would be great! How can we help, or is there some kind of TODO list? There are several things that would be helpful. We could use help from people who are experienced with using the .po/.pot/.mo tools (gettext) on other platforms. The basic process is to separate all the content from the markup automatically. Then an editor can be used to add translations, and the tool puts a translated file back together from it. This allows the translation program to remember existing translations, so translating one document helps translate others. textproc/itstool is one of the automatic separator programs. I've been somewhat stymied trying to figure out how to get the Python libxml2 implementation used by it to find FreeBSD documentation XML catalogs. Documentation on this is... let's just say sparse. The PC-BSD folks are using tools like Pootle, but not for DocBook (as far as I know). They have a web site for translation, useful as an example of what can be done: http://pootle.pcbsd.org/ Benedict (CCed) has made some progress with some of these tools. I think there are plans to add a page to the wiki, but don't know if it is present yet.