Difference between revisions of "Translations"
Jump to navigation
Jump to search
(→Language fallback chain for topic title and description, map labels, Wikidata entries) |
(→How to add a new user interface language to Wikidocumentaries?) |
||
(14 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | Wikidocumentaries is multilingual. The user interface language can be changed to any available language. | + | Wikidocumentaries is multilingual. The user interface language can be changed to any available language on Wikimedia projects. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
==Translations== | ==Translations== | ||
− | * | + | * The item information comes from Wikidata, and the translations are managed there. |
− | + | * The article comes from that language Wikipedia, and it is edited there. | |
+ | * The UI is translated to any of the languages in [https://translatewiki.net/wiki/Translating:Wikidocumentaries TranslateWiki]. | ||
− | == | + | ==UI languages== |
− | + | * The default user interface language is the browser language. | |
− | + | * The user may change the interface language of the site to another language, if it has been translated to that language. | |
− | + | * The language menu displays the available languages in alphabetical order. Later, custom language fallback order will be made possible. | |
− | * The default language is the browser language. | + | * Even if the UI is not translated to a language, it is still possible to navigate using the language code in the site URL. For example https://wikidocumentaries-demo.wmflabs.org/Q32815?language=dag. |
− | * The user may change the interface language of the site to | ||
− | * The language menu displays | ||
* The menu is created in [https://github.com/Wikidocumentaries/wikidocumentaries-ui/blob/master/src/components/menu/UILanguageMenu.vue UILanguageMenu.vue]. | * The menu is created in [https://github.com/Wikidocumentaries/wikidocumentaries-ui/blob/master/src/components/menu/UILanguageMenu.vue UILanguageMenu.vue]. | ||
* English is used as the ultimate fallback option. | * English is used as the ultimate fallback option. | ||
+ | |||
+ | ===How to add a new user interface language to Wikidocumentaries?=== | ||
+ | * Navigate to [https://translatewiki.net/wiki/Translating:Wikidocumentaries TranslateWiki]. | ||
+ | * Sign up. | ||
+ | * Select your language and start translating missing messages or checking existing ones. | ||
+ | |||
+ | ===Process=== | ||
+ | * The UI language must have at least 25% translated messages to be imported to the project. | ||
+ | * TranslateWiki sends translated files to Wikidocumentaries twice a week. The json translation files are put together in wikidocumentaries-ui/src/store/messages.js. A new language is not automatically added to Wikidocumentaries. Please alert about new language translations by emailing wikidocumentaries@gmail.com. | ||
==Language fallback== | ==Language fallback== | ||
− | Wikidata language fallback is [https://meta.wikimedia.org/wiki/Wikidata/Notes/Language_fallback described here]. | + | Wikidata language fallback is [https://meta.wikimedia.org/wiki/Wikidata/Notes/Language_fallback described here]. Can that be utilized? |
− | === | + | |
− | * The | + | ===Language fallback mechanisms=== |
− | + | Language fallback is handled differently in different cases. The MediaWiki API uses one mechanism and the SPARQL queries use another. Different components are based on different queries. | |
− | # UI language | + | |
+ | ====MediWiki API==== | ||
+ | * Topic title and description | ||
+ | * Map labels | ||
+ | * Wikidata component values | ||
+ | |||
+ | ====SPARQL query==== | ||
+ | These use SPARQL, and the fallback chain is declared in each query. | ||
+ | * The works, locations, related people and depicted in. | ||
+ | |||
+ | ===Fallback chain guideline=== | ||
+ | The desired display language is based on the following fallback chain. | ||
+ | # UI language (English default, user-defined.) | ||
# Topic's original language (how?) | # Topic's original language (how?) | ||
# Best option in the user-defined language fallback chain. The fallback chain is initially a hard-coded list of languages. Later on, the user may construct this list. | # Best option in the user-defined language fallback chain. The fallback chain is initially a hard-coded list of languages. Later on, the user may construct this list. | ||
Line 35: | Line 48: | ||
===Article=== | ===Article=== | ||
* The article is primarily displayed in the UI language | * The article is primarily displayed in the UI language | ||
− | * If the article does not exist in the UI language | + | * If the article does not exist in the UI language |
− | * The language menu displays a list of available article languages in the following order | + | *# a message to select another language is displayed. |
− | *# | + | *# Alternatively, the article can be displayed in the best available language option of the language fallback chain. |
+ | *# It is possible to create article generators that create stub articles from recorded facts. | ||
+ | * The article language menu displays a list of available article languages. The list is scrollable and displays all available languages in the following order. | ||
+ | *# Available languages in the order of the user-defined language fallback chain. The fallback chain is initially a hard-coded list of languages. Later on, the user may construct this list. | ||
*# English | *# English | ||
*# Any language ordered by... | *# Any language ordered by... | ||
Line 43: | Line 59: | ||
===Search conditions=== | ===Search conditions=== | ||
+ | See also other search conditions in the [[Images]] page. | ||
* The topic title is used to search for images | * The topic title is used to search for images | ||
* Additional labels in different languages, properties and aliases may be used also | * Additional labels in different languages, properties and aliases may be used also | ||
− | * The language for the search term is chosen based on | + | ** Labels and aliases in primary languages |
+ | ** Also use values of name properties if available. | ||
+ | * The primary language for the search term is chosen based on | ||
** API service's preferred language(s) | ** API service's preferred language(s) | ||
** Topic's original language (how is this reasoned?) | ** Topic's original language (how is this reasoned?) | ||
** English | ** English | ||
+ | |||
+ | ==Top language-related issues to fix== | ||
+ | * RTL support in the UI, T255530 | ||
{{design-nav}} | {{design-nav}} |
Latest revision as of 12:31, 7 November 2021
Wikidocumentaries is multilingual. The user interface language can be changed to any available language on Wikimedia projects.
Contents
Translations
- The item information comes from Wikidata, and the translations are managed there.
- The article comes from that language Wikipedia, and it is edited there.
- The UI is translated to any of the languages in TranslateWiki.
UI languages
- The default user interface language is the browser language.
- The user may change the interface language of the site to another language, if it has been translated to that language.
- The language menu displays the available languages in alphabetical order. Later, custom language fallback order will be made possible.
- Even if the UI is not translated to a language, it is still possible to navigate using the language code in the site URL. For example https://wikidocumentaries-demo.wmflabs.org/Q32815?language=dag.
- The menu is created in UILanguageMenu.vue.
- English is used as the ultimate fallback option.
How to add a new user interface language to Wikidocumentaries?
- Navigate to TranslateWiki.
- Sign up.
- Select your language and start translating missing messages or checking existing ones.
Process
- The UI language must have at least 25% translated messages to be imported to the project.
- TranslateWiki sends translated files to Wikidocumentaries twice a week. The json translation files are put together in wikidocumentaries-ui/src/store/messages.js. A new language is not automatically added to Wikidocumentaries. Please alert about new language translations by emailing wikidocumentaries@gmail.com.
Language fallback
Wikidata language fallback is described here. Can that be utilized?
Language fallback mechanisms
Language fallback is handled differently in different cases. The MediaWiki API uses one mechanism and the SPARQL queries use another. Different components are based on different queries.
MediWiki API
- Topic title and description
- Map labels
- Wikidata component values
SPARQL query
These use SPARQL, and the fallback chain is declared in each query.
- The works, locations, related people and depicted in.
Fallback chain guideline
The desired display language is based on the following fallback chain.
- UI language (English default, user-defined.)
- Topic's original language (how?)
- Best option in the user-defined language fallback chain. The fallback chain is initially a hard-coded list of languages. Later on, the user may construct this list.
- English
- Any language ordered by...
Article
- The article is primarily displayed in the UI language
- If the article does not exist in the UI language
- a message to select another language is displayed.
- Alternatively, the article can be displayed in the best available language option of the language fallback chain.
- It is possible to create article generators that create stub articles from recorded facts.
- The article language menu displays a list of available article languages. The list is scrollable and displays all available languages in the following order.
- Available languages in the order of the user-defined language fallback chain. The fallback chain is initially a hard-coded list of languages. Later on, the user may construct this list.
- English
- Any language ordered by...
- The menu is created in ArticleLanguageMenu.vue.
Search conditions
See also other search conditions in the Images page.
- The topic title is used to search for images
- Additional labels in different languages, properties and aliases may be used also
- Labels and aliases in primary languages
- Also use values of name properties if available.
- The primary language for the search term is chosen based on
- API service's preferred language(s)
- Topic's original language (how is this reasoned?)
- English
- RTL support in the UI, T255530
About | Technology | Design | Content modules | Tool pages | Projects |
Status
Wikidocumentaries Slack |
Setting up dev environment |
Components |
Active modules Module ideas |
Visual editor | Central Park Archives |