Weblate Documentation Release 3.5.1

Total Page:16

File Type:pdf, Size:1020Kb

Weblate Documentation Release 3.5.1 Weblate Documentation Release 3.5.1 Michal Cihaˇ rˇ Mar 10, 2019 Contents 1 About Weblate 3 1.1 Project goals...............................................3 1.2 Project name...............................................3 1.3 Project website..............................................3 1.4 Authors..................................................3 2 Translators guide 5 2.1 Weblate basics..............................................5 2.2 Registration and user profile.......................................5 2.3 Translating using Weblate........................................ 10 2.4 Downloading and uploading translations................................ 19 2.5 Checks and fixups............................................ 20 3 Application developer guide 31 3.1 Starting with internationalization.................................... 31 3.2 Translation component alerts....................................... 36 3.3 Managing translations.......................................... 37 3.4 Reviewing source strings......................................... 37 3.5 Promoting the translation........................................ 41 3.6 Translation progress reporting...................................... 43 4 Administrators guide 45 4.1 Quick setup guide............................................ 45 4.2 Installation instructions......................................... 48 4.3 Weblate deployments........................................... 74 4.4 Upgrading Weblate............................................ 87 4.5 Backing up and moving Weblate..................................... 90 4.6 Authentication.............................................. 92 4.7 Access control.............................................. 99 4.8 Translation projects........................................... 106 4.9 Language definitions........................................... 116 4.10 Continuous localization......................................... 116 4.11 Licensing translations.......................................... 124 4.12 Translation process............................................ 126 4.13 Checks and fixups............................................ 132 4.14 Machine translation........................................... 137 4.15 Addons.................................................. 142 i 4.16 Translation Memory........................................... 150 4.17 Configuration............................................... 152 4.18 Sample configuration........................................... 167 4.19 Management commands......................................... 183 4.20 Whiteboard messages.......................................... 194 4.21 Component Lists............................................. 195 4.22 Optional Weblate modules........................................ 197 4.23 Customizing Weblate........................................... 201 4.24 Django admin interface......................................... 202 5 Translation workflows 211 5.1 Translation access............................................ 211 5.2 Translation states............................................. 211 5.3 Direct translation............................................. 212 5.4 Peer review................................................ 212 5.5 Dedicated reviewers........................................... 212 5.6 Enabling reviews............................................. 213 6 Frequently Asked Questions 215 6.1 Configuration............................................... 215 6.2 Usage................................................... 219 6.3 Troubleshooting............................................. 220 6.4 Features.................................................. 222 7 Supported formats 223 7.1 Bilingual and monolingual formats................................... 223 7.2 Automatic detection........................................... 223 7.3 Translation types capabilities...................................... 224 7.4 GNU Gettext............................................... 224 7.5 XLIFF.................................................. 226 7.6 Java properties.............................................. 227 7.7 Joomla translations............................................ 227 7.8 Qt Linguist .ts.............................................. 228 7.9 Android string resources......................................... 228 7.10 Apple OS X strings............................................ 229 7.11 PHP strings................................................ 229 7.12 JSON files................................................ 230 7.13 JSON i18next files............................................ 231 7.14 WebExtension JSON........................................... 231 7.15 .Net Resource files............................................ 232 7.16 CSV files................................................. 232 7.17 YAML files................................................ 233 7.18 DTD files................................................. 233 7.19 Windows RC files............................................ 234 7.20 App store metadata files......................................... 234 7.21 Excel Open XML............................................ 235 7.22 Others.................................................. 235 7.23 Adding new translations......................................... 235 8 Version control integration 237 8.1 Accessing repositories.......................................... 237 8.2 Git.................................................... 240 8.3 GitHub.................................................. 240 8.4 Gerrit................................................... 241 8.5 Mercurial................................................. 241 ii 8.6 Subversion................................................ 242 9 Weblate’s Web API 243 9.1 REST API................................................ 243 9.2 Notification hooks............................................ 263 9.3 Exports.................................................. 264 9.4 RSS feeds................................................. 265 10 Weblate Client 267 10.1 Installation................................................ 267 10.2 Synopsis................................................. 267 10.3 Description................................................ 267 10.4 Files................................................... 269 10.5 Examples................................................. 270 11 Weblate’s Python API 273 11.1 Installation................................................ 273 11.2 wlc .................................................... 273 11.3 wlc.config .............................................. 274 11.4 wlc.main ................................................ 274 12 Changes 275 12.1 weblate 3.5.1............................................... 275 12.2 weblate 3.5................................................ 275 12.3 weblate 3.4................................................ 276 12.4 weblate 3.3................................................ 276 12.5 weblate 3.2.2............................................... 277 12.6 weblate 3.2.1............................................... 277 12.7 weblate 3.2................................................ 277 12.8 weblate 3.1.1............................................... 278 12.9 weblate 3.1................................................ 278 12.10 weblate 3.0.1............................................... 279 12.11 weblate 3.0................................................ 279 12.12 weblate 2.20............................................... 279 12.13 weblate 2.19.1.............................................. 280 12.14 weblate 2.19............................................... 280 12.15 weblate 2.18............................................... 281 12.16 weblate 2.17.1.............................................. 281 12.17 weblate 2.17............................................... 281 12.18 weblate 2.16............................................... 282 12.19 weblate 2.15............................................... 282 12.20 weblate 2.14.1.............................................. 282 12.21 weblate 2.14............................................... 283 12.22 weblate 2.13.1.............................................. 283 12.23 weblate 2.13............................................... 283 12.24 weblate 2.12............................................... 284 12.25 weblate 2.11............................................... 284 12.26 weblate 2.10.1.............................................. 285 12.27 weblate 2.10............................................... 285 12.28 weblate 2.9................................................ 285 12.29 weblate 2.8................................................ 286 12.30 weblate 2.7................................................ 286 12.31 weblate 2.6................................................ 287 12.32 weblate 2.5................................................ 287 12.33 weblate 2.4................................................ 288 iii 12.34 weblate 2.3................................................ 289 12.35 weblate 2.2................................................ 290 12.36 weblate 2.1................................................ 290 12.37 weblate 2.0................................................ 291 12.38 weblate 1.9................................................ 291 12.39 weblate 1.8................................................ 292 12.40 weblate 1.7................................................ 292 12.41 weblate 1.6...............................................
Recommended publications
  • Release 2.19 Michalˇcihar
    Weblate Documentation Release 2.19 Michal Cihaˇ rˇ Feb 15, 2018 Contents 1 About Weblate 3 1.1 Project goals...............................................3 1.2 Project name...............................................3 1.3 Project website..............................................3 1.4 Authors..................................................3 2 Translators guide 5 2.1 Weblate basics..............................................5 2.2 Registration and user profile.......................................5 2.3 Translating using Weblate........................................ 11 2.4 Downloading and uploading translations................................ 18 2.5 Checks and fixups............................................ 20 3 Application developer guide 27 3.1 Starting with internationalization.................................... 27 3.2 Managing translations.......................................... 31 3.3 Reviewing source strings......................................... 31 3.4 Promoting the translation........................................ 35 3.5 Translation progress reporting...................................... 36 4 Administrators guide 39 4.1 Quick setup guide............................................ 39 4.2 Installation instructions......................................... 40 4.3 Weblate deployments........................................... 62 4.4 Upgrading Weblate............................................ 73 4.5 Authentication.............................................. 83 4.6 Access control.............................................
    [Show full text]
  • Weblate-4.5.3
    The Weblate Manual 4.5.3 Michal Čihař 20210401 Weblate Weblate 1 : GNU gettext Android string resources1 Component configuration : ../devel/integration : 1. 2. 3. 2.5 . : 1 : > Weblate Weblate : : settings.py : SINGLE_PROJECT Weblate 2 VCS : : UI 3 : 4 : 5 Component configuration Web : VCS editor://open/?file={{filename}}&line={{line}} : URL Nette documentation : 2 DE- FAULT_AUTO_WATCH : 6 7 Weblate : Weblate : Weblate GitLab GitHubGoogleFacebookBitbucket OAuth 2.0 8 9 ENABLE_AVATARS https://gravatar.com/ API API IP : Weblate Weblate 2 : : : 10 11 : Weblate 3 : Markdown @mention : report-source : variants : : labels : (X) () () weblate 1 "car" 1 "cars" 2 Weblate Weblate Unicode Language Plural Rules : 12 13 2.18 : 2.18 : Alt+Home Alt+End Alt+PageUp or 1 Ctrl ↑ or Alt ↑ or Cmd ↑ Alt+PageDown or Ctrl+↓ or Alt+↓ or Cmd+↓ Alt+Enter or Ctrl+Enter or Cmd+Enter Ctrl+Shift+Enter or Cmd+Shift+Enter Ctrl+E or Cmd+E Ctrl+U or Cmd+U Ctrl+M or : Cmd+M Ctrl+1 to Ctrl+9 or Cmd+1 to Cmd+9 Ctrl+M+1 to 9 or Cmd+M+1 to 9 Ctrl+I+1 to 9 or 1 Cmd+I+1 to 9 Ctrl+J or Cmd+J Ctrl+S or Cmd+S Ctrl+O or Cmd+O Ctrl+Y or Cmd+Y 3 : Weblate RTL SPECIAL_CHARS 14 IDmsgctxt Weblate : Visual context for strings : : Weblate 15 Weblate 10 LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH Weblate Bilingual and monolingual formats : : Weblate 1 : : 16 2 : Weblate : : WEB : Keeping translations same across components 17 : : 2 1 : : : : labels : : Bulk edit addon : Available options might be limited by access control settings. The first option is to download the file in the original format as it is stored in the repository.
    [Show full text]
  • Weblate-3.10
    The Weblate Manual Release 3.10 Michal Čihař Dec 20, 2019 User docs 1 User docs 1 1.1 Weblate basics .......................................... 1 1.2 Registration and user profile .................................. 1 1.3 Translating using Weblate ................................... 8 1.4 Downloading and uploading translations ........................... 16 1.5 Checks and fixups ........................................ 17 1.6 Searching ............................................. 28 1.7 Application developer guide ................................... 29 1.8 Translation workflows ...................................... 43 1.9 Frequently Asked Questions .................................. 46 1.10 Supported file formats ...................................... 53 1.11 Version control integration ................................... 68 1.12 Weblate’s Web API ....................................... 74 1.13 Weblate Client .......................................... 97 1.14 Weblate’s Python API ...................................... 101 2 Administrator docs 103 2.1 Installation instructions ..................................... 103 2.2 Configuration instructions ................................... 125 2.3 Weblate deployments ...................................... 145 2.4 Upgrading Weblate ....................................... 145 2.5 Backing up and moving Weblate ................................ 151 2.6 Authentication .......................................... 156 2.7 Access control .......................................... 163 2.8 Translation projects
    [Show full text]
  • Release 3.2.2 Michalˇcihar
    Weblate Documentation Release 3.2.2 Michal Cihaˇ rˇ Oct 21, 2018 Contents 1 About Weblate 3 1.1 Project goals...............................................3 1.2 Project name...............................................3 1.3 Project website..............................................3 1.4 Authors..................................................3 2 Translators guide 5 2.1 Weblate basics..............................................5 2.2 Registration and user profile.......................................5 2.3 Translating using Weblate........................................ 10 2.4 Downloading and uploading translations................................ 18 2.5 Checks and fixups............................................ 20 3 Application developer guide 29 3.1 Starting with internationalization.................................... 29 3.2 Managing translations.......................................... 34 3.3 Reviewing source strings......................................... 34 3.4 Promoting the translation........................................ 38 3.5 Translation progress reporting...................................... 40 4 Administrators guide 43 4.1 Quick setup guide............................................ 43 4.2 Installation instructions......................................... 46 4.3 Weblate deployments........................................... 70 4.4 Upgrading Weblate............................................ 81 4.5 Backing up and moving Weblate..................................... 84 4.6 Authentication.............................................
    [Show full text]
  • Weblate-4.0.3
    The Weblate Manual Versión 4.0.3 Michal Čihař 20 de julio de 2020 User docs 1 User docs 1 1.1 Weblate basics .......................................... 1 1.2 Registration and user profile .................................. 1 1.3 Translating using Weblate ................................... 9 1.4 Downloading and uploading translations ........................... 18 1.5 Checks and fixups ........................................ 20 1.6 Searching ............................................. 32 1.7 Application developer guide ................................... 34 1.8 Translation workflows ...................................... 52 1.9 Frequently Asked Questions .................................. 55 1.10 Supported file formats ...................................... 62 1.11 Version control integration ................................... 76 1.12 Weblate’s Web API ....................................... 82 1.13 Weblate Client .......................................... 110 1.14 Weblate’s Python API ...................................... 114 2 Administrator docs 116 2.1 Configuration instructions ................................... 116 2.2 Weblate deployments ...................................... 162 2.3 Upgrading Weblate ....................................... 163 2.4 Backing up and moving Weblate ................................ 169 2.5 Authentication .......................................... 174 2.6 Access control .......................................... 182 2.7 Translation projects ....................................... 188 2.8 Language
    [Show full text]
  • Release 3.10.1 Michal Čihař
    The Weblate Manual Release 3.10.1 Michal Čihař Jan 09, 2020 User docs 1 User docs 1 1.1 Weblate basics .......................................... 1 1.2 Registration and user profile .................................. 1 1.3 Translating using Weblate ................................... 8 1.4 Downloading and uploading translations ........................... 16 1.5 Checks and fixups ........................................ 17 1.6 Searching ............................................. 28 1.7 Application developer guide ................................... 29 1.8 Translation workflows ...................................... 43 1.9 Frequently Asked Questions .................................. 46 1.10 Supported file formats ...................................... 53 1.11 Version control integration ................................... 68 1.12 Weblate’s Web API ....................................... 74 1.13 Weblate Client .......................................... 98 1.14 Weblate’s Python API ...................................... 101 2 Administrator docs 103 2.1 Installation instructions ..................................... 103 2.2 Configuration instructions ................................... 125 2.3 Weblate deployments ...................................... 145 2.4 Upgrading Weblate ....................................... 146 2.5 Backing up and moving Weblate ................................ 152 2.6 Authentication .......................................... 157 2.7 Access control .......................................... 164 2.8 Translation
    [Show full text]
  • The Weblate Manual Versión 4.3 Michal Čihař
    The Weblate Manual Versión 4.3 Michal Čihař 15 de octubre de 2020 Documentación para usuarios 1 Documentación para usuarios 1 1.1 Fundamentos de Weblate ....................................... 1 1.2 Registro y perfil de usuario ...................................... 1 1.3 Traducir con Weblate ......................................... 10 1.4 Descargar y cargar traducciones ................................... 20 1.5 Comprobaciones y correcciones ................................... 22 1.6 Búsquedas .............................................. 38 1.7 Guía para el programador de aplicaciones .............................. 42 1.8 Flujos de trabajo de traducción .................................... 62 1.9 Preguntas frecuentes ......................................... 66 1.10 Formatos de archivo admitidos .................................... 73 1.11 Integración de control de versiones .................................. 91 1.12 API REST de Weblate ........................................ 97 1.13 Cliente de Weblate .......................................... 141 1.14 API de Python de Weblate ...................................... 146 2 Documentación para administradores 148 2.1 Instrucciones de configuración .................................... 148 2.2 Implantaciones de Weblate ...................................... 200 2.3 Actualizar Weblate .......................................... 201 2.4 Backing up and moving Weblate ................................... 206 2.5 Autenticación ............................................. 212 2.6 Control de acceso
    [Show full text]
  • Weblate-2.4 --No-Git 2
    Weblate Documentation Versión 2.4 Michal Cihaˇ rˇ 20 de julio de 2020 Índice general 1. About Weblate 3 1.1. Project goals...............................................3 1.2. Project name...............................................3 1.3. Project website..............................................3 1.4. Authors..................................................3 2. Translators guide 5 2.1. Weblate basics..............................................5 2.2. Registration and user profile.......................................5 2.3. Translating using Weblate........................................9 2.4. Checks and fixups............................................ 16 3. Application developer guide 21 3.1. Activity reports.............................................. 21 3.2. Promoting the translation........................................ 22 3.3. Reviewing source strings......................................... 23 3.4. Adding new translations......................................... 24 4. Administrators guide 25 4.1. Quick setup guide............................................ 25 4.2. Installation instructions......................................... 26 4.3. Weblate deployments........................................... 40 4.4. Upgrading Weblate............................................ 44 4.5. Authentication.............................................. 49 4.6. Access control.............................................. 51 4.7. Translation projects........................................... 55 4.8. Continuous translation.........................................
    [Show full text]
  • Release 3.4 Michalˇcihar
    Weblate Documentation Release 3.4 Michal Cihaˇ rˇ Jan 22, 2019 Contents 1 About Weblate 3 1.1 Project goals...............................................3 1.2 Project name...............................................3 1.3 Project website..............................................3 1.4 Authors..................................................3 2 Translators guide 5 2.1 Weblate basics..............................................5 2.2 Registration and user profile.......................................5 2.3 Translating using Weblate........................................ 10 2.4 Downloading and uploading translations................................ 18 2.5 Checks and fixups............................................ 20 3 Application developer guide 29 3.1 Starting with internationalization.................................... 29 3.2 Translation component alerts....................................... 34 3.3 Managing translations.......................................... 35 3.4 Reviewing source strings......................................... 35 3.5 Promoting the translation........................................ 39 3.6 Translation progress reporting...................................... 41 4 Administrators guide 43 4.1 Quick setup guide............................................ 43 4.2 Installation instructions......................................... 46 4.3 Weblate deployments........................................... 72 4.4 Upgrading Weblate............................................ 84 4.5 Backing up and moving Weblate....................................
    [Show full text]
  • A Preliminary Analysis of Localization in Free Software: How Translations Are Performed Laura Arjona Reina, Gregorio Robles, Jesús González-Barahona
    A Preliminary Analysis of Localization in Free Software: How Translations Are Performed Laura Arjona Reina, Gregorio Robles, Jesús González-Barahona To cite this version: Laura Arjona Reina, Gregorio Robles, Jesús González-Barahona. A Preliminary Analysis of Localiza- tion in Free Software: How Translations Are Performed. 9th Open Source Software (OSS), Jun 2013, Koper-Capodistria, Slovenia. pp.153-167, 10.1007/978-3-642-38928-3_11. hal-01467568 HAL Id: hal-01467568 https://hal.inria.fr/hal-01467568 Submitted on 14 Feb 2017 HAL is a multi-disciplinary open access L’archive ouverte pluridisciplinaire HAL, est archive for the deposit and dissemination of sci- destinée au dépôt et à la diffusion de documents entific research documents, whether they are pub- scientifiques de niveau recherche, publiés ou non, lished or not. The documents may come from émanant des établissements d’enseignement et de teaching and research institutions in France or recherche français ou étrangers, des laboratoires abroad, or from public or private research centers. publics ou privés. Distributed under a Creative Commons Attribution| 4.0 International License A preliminary analysis of localization in free software: how translations are performed Laura Arjona Reina1, Gregorio Robles2, and Jes´usM. Gonz´alez-Barahona2 1 Technical University of Madrid (UPM), Madrid (Spain) [email protected] 2 GSyC/Libresoft, Universidad Rey Juan Carlos, Madrid (Spain) {grex,jgb}@gsyc.urjc.es Abstract. Software is more than just source code. There is a myriad of elements that compose a software project, among others documentation, translations, multimedia, artwork, marketing. In this paper, we focus on the translation efforts that free, libre, open source software (FLOSS) projects undergo to provide their software in multiple languages.
    [Show full text]
  • Ubports Documentation
    UBports Documentation Marius Gripsgard Sep 23, 2021 ABOUT 1 Introduction 3 2 Processes 5 3 Install Ubuntu Touch 11 4 Daily use 15 5 Advanced use 27 6 Contributing to UBports 35 7 App development 47 8 Human interface guidelines 87 9 System software development 123 10 Introduction 143 11 Building and booting 149 12 Configuring, testing and fixing 165 13 Finalizing the port 177 i ii UBports Documentation Welcome to the official documentation of the UBports project! UBports develops the mobile phone operating system Ubuntu Touch. Ubuntu Touch is a mobile operating system focused on ease of use, privacy, and convergence. On this website you find guides to install Ubuntu Touch on your mobile phone, use Ubuntu Touch, develop Ubuntu Touch apps, port Ubuntu Touch to an Android handset and learn more about system components. If this is your first time here, please consider reading our introduction. If you want to help improving this documentation, the Documentation contribute page will get you started. You may view this documentation in the following languages: • English • Català • Français • Deutsch • Italiano • Română • • Türkçe • Español • Simplified Chinese ABOUT 1 UBports Documentation 2 ABOUT CHAPTER ONE INTRODUCTION Our goal is to create a copylefted libre mobile operating system. One you can use, study, change and share; with all. 1.1 About UBports The project was founded by Marius Gripsgard in 2015 and in its infancy a place where developers could share ideas and educate each other in hopes of bringing the Ubuntu Touch platform to more mobile devices. After Canonical suddenly announced plans to terminate support for Ubuntu Touch in April of 2017, UBports and its sister projects began work on the source code; maintaining and expanding its possibilities for the future.
    [Show full text]
  • Release 4.8.1 Michal Čihař
    The Weblate Manual Release 4.9 Michal Čihař Sep 23, 2021 USER DOCS 1 User docs 1 1.1 Weblate basics ............................................ 1 1.2 Registration and user profile ..................................... 1 1.3 Translating using Weblate ...................................... 10 1.4 Downloading and uploading translations ............................... 19 1.5 Glossary ............................................... 23 1.6 Checks and fixups .......................................... 25 1.7 Searching ............................................... 47 1.8 Translation workflows ......................................... 52 1.9 Frequently Asked Questions ..................................... 55 1.10 Supported file formats ........................................ 62 1.11 Version control integration ...................................... 82 1.12 Weblate’s REST API ......................................... 89 1.13 Weblate Client ............................................ 133 1.14 Weblate’s Python API ........................................ 137 2 Administrator docs 140 2.1 Configuration instructions ....................................... 140 2.2 Weblate deployments ......................................... 199 2.3 Upgrading Weblate .......................................... 200 2.4 Backing up and moving Weblate ................................... 207 2.5 Authentication ............................................ 213 2.6 Access control ............................................ 223 2.7 Translation projects .........................................
    [Show full text]