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

2017-06-05 perl v5.26.0 User Contributed Perl Documentation