Mercurial > repos > IBBoard
annotate Lang/Translation.cs @ 82:5182df00c558
Fixes #36: Remove specialist "divider" handling from Translations
* Remove special handling (shouldn't be needed anyway as we have IBBMenuItems that identify what a translatable item is)
Also:
* Remove unnecessary log4net library
| author | IBBoard <dev@ibboard.co.uk> |
|---|---|
| date | Sun, 18 Apr 2010 19:01:36 +0000 |
| parents | 09f71d10c249 |
| children | 13f0ffb012cb |
| rev | line source |
|---|---|
| 16 | 1 // This file (Translation.cs) is a part of the IBBoard library and is copyright 2009 IBBoard. |
| 2 // | |
| 3 // The file and the library/program it is in are licensed under the GNU LGPL license, either version 3 of the License or (at your option) any later version. Please see COPYING.LGPL for more information and the full license. | |
| 4 | |
| 37 | 5 using System; |
| 6 using System.IO; | |
|
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
7 using System.Xml; |
| 37 | 8 using System.Xml.Schema; |
| 9 using System.Collections.Generic; | |
| 10 using System.Reflection; | |
|
0
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
11 using System.ComponentModel; |
|
961030992bd2
Initial commit of IBBoard libraries
IBBoard <dev@ibboard.co.uk>
parents:
diff
changeset
|
12 using IBBoard.IO; |
| 37 | 13 using IBBoard.Logging; |
| 14 using IBBoard.Xml; | |
| 15 | |
| 16 namespace IBBoard.Lang | |
| 17 { | |
| 18 /// <summary> | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
19 /// A basic string translator that a specified language and returns translated strings that correspond to translation IDs. |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
20 /// If the string doesn't exist in the specified language then the translator falls back defined 'super' languages. |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
21 /// If the translation doesn't exist in the hierarchy of languages then either a supplied value, null or a "no validation available" |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
22 /// message is returned, depending on the parameters supplied to the method. |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
23 /// |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
24 /// Loaded languages are referenced by two-character language code (e.g. "en" or "it") |
| 37 | 25 /// </summary> |
| 26 public class Translation | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
27 { |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
28 private static AbstractTranslationSet currentTranslations; |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
29 private static Dictionary<string, AbstractTranslationSet> langToTranslationMap; |
|
74
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
30 public static event MethodInvoker TranslationChanged; |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
31 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
32 static Translation() |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
33 { |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
34 langToTranslationMap = new Dictionary<string, AbstractTranslationSet>(); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
35 } |
| 6 | 36 |
| 37 /// <summary> | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
38 /// Initialises the translations and loads the specified language so that the Translation class can be used. |
|
21
c8d74202182a
Closes #14 - Throw specific exceptions from translations
IBBoard <dev@ibboard.co.uk>
parents:
16
diff
changeset
|
39 /// Throws a TranslationLoadException if a problem occurred while loading translations. If this occurs then the translation methods can |
|
c8d74202182a
Closes #14 - Throw specific exceptions from translations
IBBoard <dev@ibboard.co.uk>
parents:
16
diff
changeset
|
40 /// still be called but no translation will be performed. |
| 6 | 41 /// </summary> |
| 42 /// <param name="appPath"> | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
43 /// The full path that the contains the "translations" folder - normally the application directory path. |
| 6 | 44 /// </param> |
| 45 /// <param name="language"> | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
46 /// The language to use as the loaded language |
| 37 | 47 /// </param> |
| 48 public static void InitialiseTranslations(string appPath, string language) | |
| 6 | 49 { |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
50 InitialiseTranslations(appPath); |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
51 LoadTranslationForLanguage(language); |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
52 } |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
53 |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
54 /// <summary> |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
55 /// Initialises the translation class for an application or source. |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
56 /// </summary> |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
57 /// <param name="appPath"> |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
58 /// The full path that the contains the "translations" folder - normally the application directory path. |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
59 /// </param> |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
60 public static void InitialiseTranslations(string appPath) |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
61 { |
| 6 | 62 InitialiseDefaults(appPath); |
| 63 } | |
| 64 | |
| 65 private static void InitialiseDefaults(string appPath) | |
| 66 { | |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
67 Reset(); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
68 LoadTranslations(appPath); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
69 } |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
70 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
71 private static void LoadTranslations(string appPath) |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
72 { |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
73 DirectoryInfo dir = new DirectoryInfo(Path.Combine(appPath, "translations")); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
74 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
75 if (!dir.Exists) |
| 6 | 76 { |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
77 throw new TranslationLoadException("Translation path not found (" + dir.FullName + ")"); |
| 37 | 78 } |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
79 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
80 TranslationXmlLoader loader = new TranslationXmlLoader(Path.Combine(appPath, "schemas/translation.xsd")); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
81 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
82 foreach (FileInfo file in dir.GetFiles("*.translation")) |
| 37 | 83 { |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
84 AbstractTranslationSet translations = loader.LoadTranslations(file.FullName); |
|
78
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
85 AddTranslationSet(translations); |
| 6 | 86 } |
| 87 } | |
| 88 | |
|
22
ea058f9ea9d4
Closes #15 - Migrate to schema for translations
IBBoard <dev@ibboard.co.uk>
parents:
21
diff
changeset
|
89 /// <summary> |
|
78
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
90 /// Adds the supplied translation set to the list of available translations |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
91 /// </summary> |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
92 /// <param name="translations"> |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
93 /// The translation set to add |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
94 /// </param> |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
95 public static void AddTranslationSet(AbstractTranslationSet translations) |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
96 { |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
97 langToTranslationMap[translations.LanguageCode] = translations; |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
98 } |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
99 |
|
da339d10c5fe
Re #32: Add staged loading of translations
IBBoard <dev@ibboard.co.uk>
parents:
75
diff
changeset
|
100 /// <summary> |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
101 /// Resets the loaded translations and reverts to no translations. |
|
69
b5d7e8b93205
Re #30: Improve Translations API
IBBoard <dev@ibboard.co.uk>
parents:
67
diff
changeset
|
102 /// </summary> |
|
b5d7e8b93205
Re #30: Improve Translations API
IBBoard <dev@ibboard.co.uk>
parents:
67
diff
changeset
|
103 public static void Reset() |
|
b5d7e8b93205
Re #30: Improve Translations API
IBBoard <dev@ibboard.co.uk>
parents:
67
diff
changeset
|
104 { |
|
74
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
105 SetCurrentTranslations(null); |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
106 langToTranslationMap.Clear(); |
|
69
b5d7e8b93205
Re #30: Improve Translations API
IBBoard <dev@ibboard.co.uk>
parents:
67
diff
changeset
|
107 } |
|
74
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
108 |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
109 private static void SetCurrentTranslations(AbstractTranslationSet newTranslations) |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
110 { |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
111 if (currentTranslations != newTranslations || (currentTranslations != null && !currentTranslations.Equals(newTranslations))) |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
112 { |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
113 currentTranslations = newTranslations; |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
114 |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
115 if (TranslationChanged != null) |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
116 { |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
117 TranslationChanged(); |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
118 } |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
119 } |
|
726731c78414
Re #37: Add event to indicate change of translation
IBBoard <dev@ibboard.co.uk>
parents:
73
diff
changeset
|
120 } |
| 6 | 121 |
| 122 /// <summary> | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
123 /// Loads translations for a given language and sets them as the current language. |
|
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
124 /// Throws a TranslationLoadException if a problem occurred while loading translations. If this occurs then the translation methods can |
|
21
c8d74202182a
Closes #14 - Throw specific exceptions from translations
IBBoard <dev@ibboard.co.uk>
parents:
16
diff
changeset
|
125 /// still be called but all translations will fall back to the default translation. |
| 6 | 126 /// </summary> |
| 127 /// <param name="translationLang"> | |
| 128 /// The new local language to load | |
| 37 | 129 /// </param> |
| 130 public static void LoadTranslation(string translationLanguage) | |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
131 { |
|
7
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
132 if (translationLanguage == "" || translationLanguage == null) |
| 6 | 133 { |
|
10
3b7a321e7c4c
Fixes #4 - unexpected exception in translations
IBBoard <dev@ibboard.co.uk>
parents:
9
diff
changeset
|
134 throw new ArgumentException("Translation language cannot be null or empty"); |
| 37 | 135 } |
| 136 | |
| 137 LoadTranslationForLanguage(translationLanguage); | |
|
7
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
138 } |
|
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
139 |
|
f4da31cb09d9
* Add translation DTD to utils project
IBBoard <dev@ibboard.co.uk>
parents:
6
diff
changeset
|
140 private static void LoadTranslationForLanguage(string translationLanguage) |
|
67
5fb2e5a2e7a8
* Remove errors on uninitialised translations - means that the translations just fall back to the provided string if they haven't been initialised
IBBoard <dev@ibboard.co.uk>
parents:
65
diff
changeset
|
141 { |
|
75
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
142 SetCurrentTranslations(GetTranslationSet(translationLanguage)); |
| 37 | 143 } |
| 6 | 144 |
| 145 /// <summary> | |
| 146 /// Gets a translation for a given ID, falling back to a "missing translation" message if none can be found. Also optionally replaces any placeholders with the supplied values. | |
| 147 /// </summary> | |
| 148 /// <param name="translationID"> | |
| 149 /// The ID to look up the translation for | |
| 150 /// </param> | |
| 151 /// <param name="replacements"> | |
| 152 /// A collection of <see cref="System.Object"/>s to replace placeholders with | |
| 153 /// </param> | |
| 154 /// <returns> | |
| 155 /// The translation with the placeholders replaced or a "missing translation" message | |
| 37 | 156 /// </returns> |
| 157 public static string GetTranslation(string translationID, params object[] replacements) | |
| 158 { | |
| 159 return GetTranslation(translationID, false, replacements); | |
| 160 } | |
| 6 | 161 |
| 162 /// <summary> | |
| 163 /// Gets a translation for a given ID, falling back to null or a warning message if a translation cannot be found. Also optionally replaces any placeholders with the supplied values. | |
| 164 /// </summary> | |
| 165 /// <param name="translationID"> | |
| 166 /// The ID to look up the translation for | |
| 167 /// </param> | |
| 168 /// <param name="returnNullOnFail"> | |
| 169 /// TRUE if null should be returned when no translation can be found, or FALSE if a "missing translation" message should be returned | |
| 170 /// </param> | |
| 171 /// <param name="replacements"> | |
| 172 /// A collection of <see cref="System.Object"/>s to replace placeholders with | |
| 173 /// </param> | |
| 174 /// <returns> | |
| 175 /// The translation with the placeholders replaced, or a "missing translation" message or null depending on <param name="returnNullOnFail"> | |
| 37 | 176 /// </returns> |
| 177 public static string GetTranslation(string translationID, bool returnNullOnFail, params object[] replacements) | |
| 178 { | |
| 179 return GetTranslation(translationID, returnNullOnFail ? null : "", replacements); | |
| 180 } | |
| 6 | 181 |
| 182 /// <summary> | |
| 183 /// Gets a translation for a given ID, falling back to a supplied default if a translation cannot be found. Also optionally replaces any placeholders with the supplied values. | |
| 184 /// </summary> | |
| 185 /// <param name="translationID"> | |
| 186 /// The ID to look up the translation for | |
| 187 /// </param> | |
| 188 /// <param name="defaultTranslation"> | |
| 189 /// The string to return if no translation can be found. Can be null or any string. | |
| 190 /// </param> | |
| 191 /// <param name="replacements"> | |
| 192 /// A collection of <see cref="System.Object"/>s to replace placeholders with | |
| 193 /// </param> | |
| 194 /// <returns> | |
| 195 /// The translation, if one exists, or the supplied default with the placeholders replaced | |
| 37 | 196 /// </returns> |
| 197 public static string GetTranslation(string translationID, string defaultTranslation, params object[] replacements) | |
| 198 { | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
199 string trans = GetTranslationFromTranslationSet(translationID); |
| 37 | 200 |
| 201 if (trans == null) | |
| 202 { | |
| 203 trans = GetDefaultTranslation(translationID, defaultTranslation); | |
| 204 } | |
| 205 | |
| 206 trans = AddVariablesToTranslation(trans, replacements); | |
| 207 | |
| 208 return trans; | |
| 6 | 209 } |
| 210 | |
|
71
40c09e57d213
Fixes #31: Break out Translations for language to own class
IBBoard <dev@ibboard.co.uk>
parents:
69
diff
changeset
|
211 private static string GetTranslationFromTranslationSet(string translationID) |
| 6 | 212 { |
| 213 string translation = null; | |
| 214 | |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
215 if (currentTranslations!=null) |
| 37 | 216 { |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
217 translation = currentTranslations[translationID]; |
| 6 | 218 } |
| 219 | |
| 220 return translation; | |
| 221 } | |
| 222 | |
| 223 private static string GetDefaultTranslation(string translationID, string defaultTranslation) | |
| 224 { | |
|
69
b5d7e8b93205
Re #30: Improve Translations API
IBBoard <dev@ibboard.co.uk>
parents:
67
diff
changeset
|
225 return (defaultTranslation != "" || defaultTranslation == null) ? defaultTranslation : GetMissingTranslationMessage(translationID); |
| 37 | 226 } |
| 6 | 227 |
| 228 private static string GetMissingTranslationMessage(string translationID) | |
| 229 { | |
| 230 return "++ Missing Translation "+translationID+" ++"; | |
| 231 } | |
| 232 | |
| 233 private static string AddVariablesToTranslation(string translation, object[] replacements) | |
| 234 { | |
| 37 | 235 if (translation != null && replacements != null && replacements.Length > 0) |
| 236 { | |
| 237 translation = String.Format(translation, replacements); | |
| 6 | 238 } |
| 239 | |
| 240 return translation; | |
| 241 } | |
| 242 | |
| 243 /// <summary> | |
|
36
c949727ec0e0
Re #22 - Make failing control translation cleaner for normal use
IBBoard <dev@ibboard.co.uk>
parents:
35
diff
changeset
|
244 /// Translate an <see cref="ITranslatable"/> item, with optional string replacement. If the translation |
|
c949727ec0e0
Re #22 - Make failing control translation cleaner for normal use
IBBoard <dev@ibboard.co.uk>
parents:
35
diff
changeset
|
245 /// does not exist then a warning message will be used as the translated text. |
| 6 | 246 /// </summary> |
| 247 /// <param name="item"> | |
| 248 /// A <see cref="ITranslatable"/> to set the text for | |
| 249 /// </param> | |
| 250 /// <param name="replacements"> | |
| 251 /// A collection of <see cref="System.Object"/>s that will be used to fill place-holders | |
| 37 | 252 /// </param> |
| 253 public static void Translate(ITranslatable item, params object[] replacements) | |
| 254 { | |
|
69
b5d7e8b93205
Re #30: Improve Translations API
IBBoard <dev@ibboard.co.uk>
parents:
67
diff
changeset
|
255 Translate(item, GetMissingTranslationMessage(item.Name), replacements); |
| 37 | 256 } |
| 257 | |
| 258 /// <summary> | |
| 259 /// Translate an <see cref="ITranslatable"/> item, with optional string replacement. The <code>defaultText</code> | |
| 260 /// can be used to specify an alternate translation. Passing <code>null</code> will result in a warning message | |
| 261 /// about a missing translation ID. | |
| 262 /// </summary> | |
| 263 /// <param name="item"> | |
| 264 /// A <see cref="ITranslatable"/> to set the text for | |
| 265 /// </param> | |
| 266 /// <param name="defaultText"> | |
| 267 /// The default string to display if no translation could be found. | |
| 268 /// </param> | |
| 269 /// <param name="replacements"> | |
| 270 /// A collection of <see cref="System.Object"/>s that will be used to fill place-holders | |
| 271 /// </param> | |
| 272 public static void Translate(ITranslatable item, string defaultText, params object[] replacements) | |
| 273 { | |
|
82
5182df00c558
Fixes #36: Remove specialist "divider" handling from Translations
IBBoard <dev@ibboard.co.uk>
parents:
81
diff
changeset
|
274 if (item.Text == "") |
| 37 | 275 { |
| 276 //it doesn't need translating - either there is no text from the developer or it's a hyphen for a divider | |
| 277 return; | |
| 278 } | |
| 279 | |
| 280 item.Text = GetTranslation(item.Name, defaultText, replacements); | |
| 6 | 281 } |
| 282 | |
| 283 /// <summary> | |
|
81
09f71d10c249
* Fix documentation - we're now using ISO codes (or should be, although we do handle invalid ones)
IBBoard <dev@ibboard.co.uk>
parents:
78
diff
changeset
|
284 /// Get the current local translation language. This is the "language code" used by the translation and should match the ISO code for the language. |
| 6 | 285 /// </summary> |
| 286 /// <returns> | |
|
81
09f71d10c249
* Fix documentation - we're now using ISO codes (or should be, although we do handle invalid ones)
IBBoard <dev@ibboard.co.uk>
parents:
78
diff
changeset
|
287 /// The string used as the language code of the current local translation |
| 6 | 288 /// </returns> |
| 289 public static string GetTranslationLanguage() | |
| 290 { | |
|
73
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
291 return (currentTranslations != null ? currentTranslations.LanguageCode : ""); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
292 } |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
293 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
294 public static ICollection<TranslationLanguage> GetLanguages() |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
295 { |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
296 ICollection<TranslationLanguage> langs = new List<TranslationLanguage>(); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
297 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
298 foreach (AbstractTranslationSet translations in langToTranslationMap.Values) |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
299 { |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
300 langs.Add(translations.Language); |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
301 } |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
302 |
|
091bfa54d6c7
Re #33: Add method to get list of available translations
IBBoard <dev@ibboard.co.uk>
parents:
71
diff
changeset
|
303 return langs; |
| 37 | 304 } |
|
75
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
305 |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
306 public static AbstractTranslationSet GetTranslationSet(string translationLanguage) |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
307 { |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
308 AbstractTranslationSet translations = null; |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
309 |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
310 if (translationLanguage != null) |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
311 { |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
312 translations = DictionaryUtils.GetValue(langToTranslationMap, translationLanguage); |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
313 |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
314 if (translations == null) |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
315 { |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
316 translations = new ModifiableTranslationSet(translationLanguage); |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
317 } |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
318 } |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
319 |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
320 return translations; |
|
b1ae6fce2e3f
Re #35: Add multi-level cascading of translations
IBBoard <dev@ibboard.co.uk>
parents:
74
diff
changeset
|
321 } |
| 37 | 322 } |
| 323 } |