zanata_zanata_xml_make man page

zanata_zanata_xml_make — Make a zanata.xml for using Zanata

Synopsis

zanata_zanata_xml_make -h | --help

zanata_zanata_xml_make [options] <ZanataURL> [<project> [ <project-version> ] ]

Description

This program makes zanata.xml according to project information, server supported locales and local supplied locales.

Project Information

Project information such as project, project-version and project-type are choose from following order:

1. Command line options

2. zanata.xml from project page if ZanataURL, project and project-version are all given

2. Existing local zanata.xml file

Server supported locales

Server supported locales, are obtain from sources in following order:

1. zanata.xml from project page if ZanataURL, project and project-version are all given

2. Existing local zanata.xml file

3. Language list page from Zanata server if ZanataURL is given

If none are available, the <locales> will not be written to zanata.xml

Local provided locales

Local provided locales are determined by following:

1. 'locale -a' if --mapFromLocale (-m) is given

2. Local translated file by default

If none are availale, the map-from attribute of <locale> will not be written.

The original file will be backed up with '.bak' by default.

Arguments

ZanataUrl
The URL of zanata server, such as 'http://translate.zanata.org/'
project
Set project ID.
project-version
Set version of the project.

Options

-h, --help:
Print brief help message and exits.
-m, --mapFromLocale
Use 'locale -a' for locale mapping instead of finding existing translated files.

This is useful for projects that use the same locale format as 'locale -a', or new projects that do not have much translation coverge yet.
-p, --projectType=STRING
Set the project-type. Valid values are: 'podir', 'gettext', 'properties', 'utf8properties', 'xliff'.
-b, --baseDir=DIR
Set the base directory as working directory. zanata.xml by default is made in this directory, srcDir and transDir should also related to this directory.

Default is '.'.
-s, --srcDir=DIR
Set the source directory. Source directory is need for some project type (like podir and project-type) to identify the genuine locale translation files. Usually this is a directory that contains .pot files.

Either an absolute path or related to the $baseDir

Default is '$baseDir'.
-t, --transDir=DIR
Set the translation directory. Local translation files are searched under this directory and its subdirectories. Usually this is a directory that contains .po files.

Either an absolute path or related to the $baseDir

Default is '$baseDir'.
-o, --backupSuffix=STRING
Set the suffix for backup file.

Default is '.bak'
-z, --zanataXml=FILE
Set the output zanata.xml. Default: ($baseDir/zanata.xml)

Files

zanata.cfg
Configure file for this program. Directories will be visited in following order: '~/.config', '/etc', 'etc' and '.'

See 'man zanata_zanata_xml_make' for more infomation.

Pod Errors

Hey! The above document had some coding errors, which are explained below:

Around line 137:
'=item' outside of any '=over'

=over without closing =back

Info

2016-05-16 perl v5.24.0 User Contributed Perl Documentation