mirror of
https://github.com/libguestfs/libguestfs.git
synced 2026-03-21 22:53:37 +00:00
Allow manual pages and POD files to be translated.
This uses the optional po4a package to split these files into PO files for translation, and reassemble afterwards. Note this creates an extra pot file (po-docs/libguestfs-docs.pot). We don't (yet) combine this with the main po/libguestfs.pot file. The 'libguestfs-docs.pot' file included in this commit is not the real thing, just a short cut down snippet for testing. The real thing is created if you update one of the dependent files and rebuild. Note also the dummy ja.po, for testing the principles.
This commit is contained in:
Richard Jones
5
.gitignore
vendored
5
.gitignore
vendored
@@ -197,6 +197,11 @@ po/en@quot.header
|
||||
po/insert-header.sin
|
||||
po/quot.sed
|
||||
po/remove-potcdate.sin
|
||||
po-docs/po4a.conf
|
||||
po-docs/*/*.pl
|
||||
po-docs/*/*.pod
|
||||
po-docs/*/*.1
|
||||
po-docs/*/*.3
|
||||
python/bindtests.py
|
||||
python/guestfs.py
|
||||
python/guestfs-py.c
|
||||
|
||||
8
HACKING
8
HACKING
@@ -116,7 +116,13 @@ ocaml/
|
||||
OCaml bindings.
|
||||
|
||||
po/
|
||||
Translations.
|
||||
Translations of simple gettext strings. For translations of
|
||||
longer documents, see po-docs/.
|
||||
|
||||
po-docs/
|
||||
The build infrastructure and PO files for translations of
|
||||
manpages and POD files. Eventually this will be combined
|
||||
with the po/ directory, but that is rather complicated.
|
||||
|
||||
perl/
|
||||
Perl bindings.
|
||||
|
||||
@@ -20,7 +20,7 @@ include $(top_srcdir)/subdir-rules.mk
|
||||
ACLOCAL_AMFLAGS = -I m4
|
||||
|
||||
# Basic source for the library.
|
||||
SUBDIRS = gnulib/lib images src examples po
|
||||
SUBDIRS = gnulib/lib images src examples po po-docs
|
||||
|
||||
if ENABLE_DAEMON
|
||||
SUBDIRS += daemon
|
||||
@@ -181,6 +181,7 @@ all-local:
|
||||
grep -v '/guestfs_protocol.c' | \
|
||||
grep -v '/rc_protocol.c' | \
|
||||
grep -v 'appliance/debian/root' | \
|
||||
grep -v '^po-docs/' | \
|
||||
LC_ALL=C sort | \
|
||||
sed 's,^\./,,' > po/POTFILES.in
|
||||
|
||||
|
||||
2
README
2
README
@@ -94,6 +94,8 @@ in virt-inspector).
|
||||
|
||||
- (Optional, but highly recommended) perl-libintl for translating perl code.
|
||||
|
||||
- (Optional) po4a for translating manpages and POD files.
|
||||
|
||||
Running ./configure will check you have all the requirements installed
|
||||
on your machine.
|
||||
|
||||
|
||||
@@ -768,6 +768,10 @@ AM_CONDITIONAL([HAVE_INSPECTOR],
|
||||
AM_CONDITIONAL([HAVE_TOOLS],
|
||||
[test "x$PERL" != "xno" -a "x$missing_perl_modules" != "xyes"])
|
||||
|
||||
dnl po4a for translating man pages and POD files (optional).
|
||||
AC_CHECK_PROG([PO4A],[po4a],[po4a],[no])
|
||||
AM_CONDITIONAL([HAVE_PO4A], [test "x$PO4A" != "xno"])
|
||||
|
||||
dnl Library versioning.
|
||||
MAX_PROC_NR=`cat $srcdir/src/MAX_PROC_NR`
|
||||
AC_SUBST(MAX_PROC_NR)
|
||||
@@ -802,6 +806,8 @@ AC_CONFIG_FILES([Makefile
|
||||
gnulib/lib/Makefile
|
||||
gnulib/tests/Makefile
|
||||
fuse/Makefile
|
||||
po-docs/Makefile
|
||||
po-docs/ja/Makefile
|
||||
ocaml/META perl/Makefile.PL])
|
||||
AC_OUTPUT
|
||||
|
||||
|
||||
88
po-docs/Makefile.am
Normal file
88
po-docs/Makefile.am
Normal file
@@ -0,0 +1,88 @@
|
||||
# libguestfs translations of man pages and POD files
|
||||
# Copyright (C) 2010 Red Hat Inc.
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; either version 2 of the License, or
|
||||
# (at your option) any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program; if not, write to the Free Software
|
||||
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
|
||||
# XXX The use of po4a is naive here. Also we should integrate this
|
||||
# into the po/ directory and the translations into the usual
|
||||
# libguestfs.pot file.
|
||||
|
||||
# Languages.
|
||||
LINGUAS = ja
|
||||
|
||||
EXTRA_DIST = \
|
||||
libguestfs-docs.pot \
|
||||
$(LINGUAS:%=%.po)
|
||||
|
||||
CLEANFILES = po4a.conf
|
||||
|
||||
# Build the final man pages from the translated POD files. Each
|
||||
# language directory contains a Makefile.am that we need to keep up to
|
||||
# date (note each $lang/Makefile.am should be identical).
|
||||
# XXX Is there a better way?
|
||||
SUBDIRS = $(LINGUAS)
|
||||
|
||||
# List of english POD sources which can be translated.
|
||||
# Perl files count as POD as far as po4a is concerned.
|
||||
PODFILES = \
|
||||
../src/guestfs.pod \
|
||||
../src/guestfs-actions.pod \
|
||||
../src/guestfs-availability.pod \
|
||||
../src/guestfs-structs.pod \
|
||||
../fish/guestfish.pod \
|
||||
../fish/guestfish-actions.pod \
|
||||
../test-tool/libguestfs-test-tool.pod \
|
||||
../fuse/guestmount.pod \
|
||||
../inspector/virt-inspector.pl \
|
||||
$(wildcard ../tools/virt-*.pl)
|
||||
|
||||
if HAVE_PO4A
|
||||
update-po: libguestfs-docs.pot
|
||||
else
|
||||
update-po:
|
||||
endif
|
||||
|
||||
if HAVE_PO4A
|
||||
|
||||
# Note: po4a leaves empty '=encoding' lines in POD files. Also it
|
||||
# includes a large warning message which ends up in the output. We
|
||||
# post-process the output to remove both.
|
||||
libguestfs-docs.pot: po4a.conf
|
||||
$(PO4A) \
|
||||
-M utf-8 -L utf-8 -A utf-8 \
|
||||
-v \
|
||||
-k 0 \
|
||||
--package-name $(PACKAGE_NAME) \
|
||||
--package-version $(PACKAGE_VERSION) \
|
||||
--msgid-bugs-address libguestfs@redhat.com \
|
||||
--copyright-holder "Red Hat Inc." \
|
||||
po4a.conf
|
||||
for f in `find $(LINGUAS) -name '*.pod' -o -name '*.pl'`; do \
|
||||
awk 'FNR >= 14 { print }' < $$f > $$f.new; \
|
||||
mv $$f.new $$f; \
|
||||
done
|
||||
|
||||
po4a.conf: $(PODFILES)
|
||||
rm -f $@-t
|
||||
echo "[po_directory] ." >> $@-t
|
||||
echo >> $@-t
|
||||
for f in $(PODFILES); do \
|
||||
b=`basename -- $$f`; \
|
||||
echo "[type: pod] $$f \$$lang:\$$lang/$$b" >> $@-t; \
|
||||
echo >> $@-t; \
|
||||
done;
|
||||
mv $@-t $@
|
||||
|
||||
endif
|
||||
28
po-docs/ja.po
Normal file
28
po-docs/ja.po
Normal file
@@ -0,0 +1,28 @@
|
||||
# SOME DESCRIPTIVE TITLE.
|
||||
# Copyright (C) YEAR Free Software Foundation, Inc.
|
||||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||||
#
|
||||
#, fuzzy
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: PACKAGE VERSION\n"
|
||||
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
|
||||
"POT-Creation-Date: 2010-09-02 14:43+0200\n"
|
||||
"PO-Revision-Date: 2010-09-02 14:46+0100\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=UTF-8\n"
|
||||
"Content-Transfer-Encoding: 8bit\n"
|
||||
|
||||
# type: =head1
|
||||
#: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
|
||||
#: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
|
||||
#: ../inspector/virt-inspector.pl:38 ../tools/virt-cat.pl:32
|
||||
#: ../tools/virt-df.pl:34 ../tools/virt-edit.pl:33
|
||||
#: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30
|
||||
#: ../tools/virt-ls.pl:33 ../tools/virt-make-fs.pl:35
|
||||
#: ../tools/virt-rescue.pl:31 ../tools/virt-resize.pl:40
|
||||
#: ../tools/virt-tar.pl:32 ../tools/virt-win-reg.pl:36
|
||||
msgid "NAME"
|
||||
msgstr "名前"
|
||||
94
po-docs/ja/Makefile.am
Normal file
94
po-docs/ja/Makefile.am
Normal file
@@ -0,0 +1,94 @@
|
||||
# libguestfs translations of man pages and POD files
|
||||
# Copyright (C) 2010 Red Hat Inc.
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; either version 2 of the License, or
|
||||
# (at your option) any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program; if not, write to the Free Software
|
||||
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
|
||||
# Note that each Makefile.am in po-docs/$lang/Makefile.am should be
|
||||
# identical. If you create a new $lang.po, create the $lang/
|
||||
# subdirectory and copy the Makefile.am from an existing language.
|
||||
|
||||
LINGUA = $(shell basename -- `pwd`)
|
||||
|
||||
CLEANFILES = *.1 *.3
|
||||
|
||||
# Ship the final translated manpages in the tarball.
|
||||
MANPAGES = \
|
||||
guestfs.3 \
|
||||
guestfish.1 \
|
||||
libguestfs-test-tool.1 \
|
||||
guestmount.1 \
|
||||
$(patsubst %.pl,%.1,$(wildcard virt-*.pl))
|
||||
|
||||
EXTRA_DIST = $(MANPAGES)
|
||||
|
||||
all-local: $(MANPAGES)
|
||||
|
||||
guestfs.3: guestfs.pod guestfs-actions.pod guestfs-availability.pod guestfs-structs.pod
|
||||
sed \
|
||||
-e '/@ACTIONS@/rguestfs-actions.pod' \
|
||||
-e 's/@ACTIONS@//' \
|
||||
-e '/@AVAILABILITY@/rguestfs-availability.pod' \
|
||||
-e 's/@AVAILABILITY@//' \
|
||||
-e '/@STRUCTS@/rguestfs-structs.pod' \
|
||||
-e 's/@STRUCTS@//' \
|
||||
< $< | \
|
||||
$(POD2MAN) -u \
|
||||
--section 3 \
|
||||
-c "Virtualization Support" \
|
||||
--name "guestfs" \
|
||||
--release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \
|
||||
> $@-t; mv $@-t $@
|
||||
|
||||
guestfish.1: guestfish.pod guestfish-actions.pod
|
||||
sed \
|
||||
-e '/@ACTIONS@/rguestfish-actions.pod' -e 's/@ACTIONS@//' \
|
||||
< $< | \
|
||||
$(POD2MAN) -u \
|
||||
--section 1 \
|
||||
-c "Virtualization Support" \
|
||||
--name "guestfish" \
|
||||
--release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \
|
||||
> $@-t; mv $@-t $@
|
||||
|
||||
guestmount.1: guestmount.pod
|
||||
$(POD2MAN) -u \
|
||||
--section 1 \
|
||||
-c "Virtualization Support" \
|
||||
--name "guestmount" \
|
||||
--release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \
|
||||
$< > $@-t; mv $@-t $@
|
||||
|
||||
libguestfs-test-tool.1: libguestfs-test-tool.pod
|
||||
$(POD2MAN) -u \
|
||||
--section 1 \
|
||||
-c "Virtualization Support" \
|
||||
--release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \
|
||||
$< > $@-t; mv $@-t $@
|
||||
|
||||
virt-%.1: virt-%.pl
|
||||
$(POD2MAN) -u \
|
||||
--section 1 \
|
||||
-c "Virtualization Support" \
|
||||
--release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \
|
||||
$< > $@-t && mv $@-t $@
|
||||
|
||||
# XXX Can automake do this properly?
|
||||
install-data-hook:
|
||||
$(MKDIR_P) $(DESTDIR)$(mandir)/$(LINGUA)/man1
|
||||
$(INSTALL) -m 0644 guestfish.1 $(DESTDIR)$(mandir)/$(LINGUA)/man1
|
||||
$(INSTALL) -m 0644 guestmount.1 $(DESTDIR)$(mandir)/$(LINGUA)/man1
|
||||
$(INSTALL) -m 0644 virt-*.1 $(DESTDIR)$(mandir)/$(LINGUA)/man1
|
||||
$(MKDIR_P) $(DESTDIR)$(mandir)/$(LINGUA)/man3
|
||||
$(INSTALL) -m 0644 guestfs.3 $(DESTDIR)$(mandir)/$(LINGUA)/man3
|
||||
21
po-docs/libguestfs-docs.pot
Normal file
21
po-docs/libguestfs-docs.pot
Normal file
@@ -0,0 +1,21 @@
|
||||
# SOME DESCRIPTIVE TITLE
|
||||
# Copyright (C) YEAR Red Hat Inc.
|
||||
# This file is distributed under the same license as the libguestfs package.
|
||||
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
||||
#
|
||||
#, fuzzy
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: libguestfs 1.5.7\n"
|
||||
"Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
|
||||
"POT-Creation-Date: 2010-09-02 14:43+0200\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
"Content-Type: text/plain; charset=CHARSET\n"
|
||||
"Content-Transfer-Encoding: ENCODING"
|
||||
|
||||
# type: =head1
|
||||
msgid "NAME"
|
||||
msgstr ""
|
||||
Reference in New Issue
Block a user