Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
show-titlefalse
titleUsage

The PDAC1 provides tools that access properties from projectdoc documents. Properties in document instances are not accessible by the internationalization key (e.g. projectdoc.doctype.common.doctype for the document type of the document), but only by the localized name of the property (e.g. 'Doctype' or 'Dokumenttyp').

The projectdoc Toolbox currently only supports the locales en (English, default) and de (German).

Users who need to translate the properties in a different language need to know:

  1. projectdoc assumes the site locale for all translations (that is users cannot use spaces for different languages in one instance)
  2. If a property name has been localized (e.g. 'Nombre' instead of 'Name') the tools relying on the property will assume it is not present if the localization information is not installed to the Confluence server
Note Box

It is not possible to have projectdoc support languages other than the one specified in the site locale.

Note that problems usually arise if the user or browser is set to a different locale. This is because some macros render depending on the user's or browser locale at request time.

If you happen to need to use a different locale than en or de, then the article Internationalising your plugin provides some additional information on how to accomplish this.

  1. If you would like to provide your own localization bundle to provide translations for property and section names, smartics-projectdoc-confluence-l10n on Bitbucket provides a way to get started.
  2. If you would like to provide translations for this project, please get in touch! We'll mention you as contributor for a given locale in the POM file.
  3. Note that this will only translate a subset of the keys. If you need access to the full localization file (for translating e.g. also wizard and instructional texts), please get in touch! Note that localization bundles for doctype add-ons are available on Bitbucket. If you need to translate these the simply add the keys of the properties file from a doctype add-on project to the properties file in your fork of smartics-projectdoc-confluence-l10n.

...

Section
titleResources

More information on internationalization (I18N) and Localization (L10N) for Confluence.

Tour
render-as-definition-listtrue
replace-title-with-nametrue
TitleShort Description
Internationalising your pluginThis document is a guide for developers wanting to provide internationalisation support for their plugins. This means that other people will be able to provide translated strings for the labels and messages in your plugin without you having to recompile your plugin, thereby simplifying the process of localisation.
smartics-projectdoc-confluence-l10nA project on Bitbucket to get started with deploying own localization bundles.
Document Properties
Document Sections