- Created by Robert Reiner, last modified on 21. Nov 2017
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 5 Next »
projectdoc Toolbox
Using projectdoc with a non-supported locale (language) works, but lacks some of its features. This short topic provides some details on this matter.
The projectdoc Toolbox 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').
Users who need to translate the properties in a different language need to know:
- projectdoc assumes the site locale for all translations
- 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
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.
Localization File
This is the list of resource keys projectdoc understands and uses to access properties from a document instance.
# Doctypes #################################################################### # Common properties for all project documentation types projectdoc.doctype.common.pageId=Page ID projectdoc.doctype.common.doctype=Doctype projectdoc.doctype.common.docsubtype=Docsubtype projectdoc.doctype.common.is-a=is-a projectdoc.doctype.common.shortName=Short Name projectdoc.doctype.common.name=Name projectdoc.doctype.common.delegateDocument.name=Delegate Document Name projectdoc.doctype.common.delegateDocumentDoctype.name=Delegate Document Doctype projectdoc.doctype.common.delegateDocumentIsA.name=Delegate Document Is-A Relationship projectdoc.doctype.common.delegateDocument.pageRef=Delegate Document Page Reference projectdoc.doctype.common.delegateDocument.pageLink=Delegate Document Page Link projectdoc.doctype.common.shortDescription=Short Description projectdoc.doctype.common.iteration=Iteration projectdoc.doctype.common.audience=Audience projectdoc.doctype.common.sponsors=Sponsors projectdoc.doctype.common.reference=Reference projectdoc.doctype.common.sortKey=Sort Key projectdoc.doctype.common.cssStyleInformation=CSS Style Information projectdoc.doctype.common.tags=Tags projectdoc.doctype.common.categories=Categories projectdoc.doctype.common.subject=Subject projectdoc.doctype.common.type=Type projectdoc.doctype.common.title=Title projectdoc.doctype.common.spaceLink=Space projectdoc.doctype.common.spaceKey=Space Key projectdoc.doctype.common.space=Space Title projectdoc.doctype.common.spaceTags=Space Tags projectdoc.doctype.common.relativeUrl=Relative URL projectdoc.doctype.common.uri=URI projectdoc.doctype.common.absoluteUrl=URL projectdoc.doctype.common.tinyUrl=Tiny URL projectdoc.doctype.common.date=Date projectdoc.doctype.common.duration=Duration projectdoc.doctype.common.creationDate=Creation Date projectdoc.doctype.common.creationDateMs=Creation Timestamp projectdoc.doctype.common.creationDateNormalized=Creation Date\u00a7 projectdoc.doctype.common.creationTime=Creation Time projectdoc.doctype.common.creationTimeNormalized=Creation Time\u00a7 projectdoc.doctype.common.creator=Creator projectdoc.doctype.common.lastModificationDate=Last Modification Date projectdoc.doctype.common.lastModificationDateMs=Last Modification Timestamp projectdoc.doctype.common.lastModificationDateNormalized=Last Modification Date\u00a7 projectdoc.doctype.common.version.number=Version Number projectdoc.doctype.common.version.comment=Version Comment projectdoc.doctype.common.version.number.withComment=Last Version Number with Comment projectdoc.doctype.common.version.comment.withComment=Last Version Comment projectdoc.doctype.common.lastModifier=Last Modifier projectdoc.doctype.common.wikiType=Wiki Type projectdoc.doctype.common.targetVersions=Target Versions projectdoc.doctype.common.targetProducts=Target Products projectdoc.doctype.common.parent=Parent projectdoc.doctype.common.level=Level projectdoc.doctype.common.attachments=Attachments projectdoc.doctype.common.since=Since projectdoc.doctype.common.deprecated=Deprecated projectdoc.doctype.common.removed=Removed projectdoc.doctype.common.date.suffix.ms= Timestamp projectdoc.doctype.common.date.suffix.plain=$ projectdoc.doctype.common.date.suffix.normalized=\u00a7 ## Association projectdoc.doctype.association.document=Document ## Resource projectdoc.doctype.resource.authors=Authors projectdoc.doctype.resource.publicationDate=Publication Date ## Image projectdoc.imageUrl=Image URL projectdoc.doctype.common.image=Image projectdoc.doctype.common.icon.m=Icon projectdoc.doctype.common.icon.s=S Icon projectdoc.doctype.common.icon.xs=XS Icon projectdoc.doctype.common.icon.xxs=XXS Icon # Sections projectdoc.doctype.common.description=Description projectdoc.doctype.common.details=Details projectdoc.doctype.common.summary=Summary projectdoc.doctype.common.notes=Notes projectdoc.doctype.common.references=References projectdoc.doctype.common.resources=Resources
Three notes here:
- 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.
- 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.
- 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.
Supported Locales
The projectdoc Toolbox currently only supports the locales en (English, default) and de (German).
If you happen to need to use a different locale then the article Internationalising your plugin provides some additional information.
Resources
More information on internationalization (I18N) and Localization (L10N) for Confluence.
- Internationalising your plugin
- This 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-l10n
- A project on Bitbucket to get started with deploying own localization bundles.
- No labels
