Weblate Documentation Release 3.5.1
Total Page:16
File Type:pdf, Size:1020Kb
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...............................................