Differences

This shows you the differences between two versions of the page.

--- development:architecture:localization [2016/03/29 18:04] – [Formatting Language Files] demiankatz
+++ development:architecture:localization [2019/03/07 13:44] – [Formatting Language Files] demiankatz
@@ Line 1: / Line 1: @@
 ====== Language Support ======
-// This page refers to VuFind 2.x and later; for earlier documentation, see [[legacy:vufind_1.x_developer_manual:language_localization_support|VuFind 1.x Language/Localization Support]]. //
+// This page refers to VuFind 2.x and later; use of earlier versions is no longer recommended. //
 Keywords: localization, l10n, internationalization, i18n
@@ Line 27: / Line 27: @@
 For an example of a full language file, see [[https://github.com/vufind-org/vufind/blob/master/languages/en.ini|en.ini]].
-Note: If modifications to a language file do not take effect, sometimes it is necessary to clear out the local directory language cache by removing the local/cache/languages directory. The directory should be recreated automatically.
+:!: Note: If modifications to a language file do not take effect, sometimes it is necessary to clear out the local directory language cache by removing the local/cache/languages directory. The directory should be recreated automatically.
 === Sorting Language Files ===
@@ Line 39: / Line 39: @@
   - Create a new language file as described [[#formatting language files|above]] and put it in the languages directory (either in the root of VuFind if you are planning to commit the new language to the master branch, or inside your [[configuration:local_settings_directory|local settings directory]] if this is a local customization).
+  - If you also wish to translate strings inside text domains (see below) you will need to create appropriate subdirectories inside languages, and put additional language files inside these directories.
   - If desired, translate help screens as described [[#help screen translation|above]].
   - Edit [[configuration:files:config.ini]] and add your new language to the [Languages] section.
@@ Line 117: / Line 118: @@
 on a valid $translator object would return "The translation".
+Text domains currently used by VuFind:
+  * CreatorRoles - used for translating author relator terms (such as [[https://www.loc.gov/marc/relators/relaterm.html|these]])
+  * HoldingStatus - used for displaying complex item availability messages (not supported by all ILS drivers)
 ===== Help Screen Translation =====