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.............................................. 86 4.7 Access control.............................................. 92 4.8 Translation projects........................................... 99 4.9 Language definitions........................................... 108 4.10 Continuous translation.......................................... 108 4.11 Licensing translations.......................................... 114 4.12 Translation process............................................ 115 4.13 Checks and fixups............................................ 122 4.14 Machine translation........................................... 127 4.15 Addons.................................................. 132 4.16 Translation Memory........................................... 140 i 4.17 Configuration............................................... 142 4.18 Sample configuration........................................... 158 4.19 Management commands......................................... 172 4.20 Whiteboard messages.......................................... 183 4.21 Component Lists............................................. 185 4.22 Optional Weblate modules........................................ 186 4.23 Django admin interface......................................... 191 5 Translation workflows 199 5.1 Translation access............................................ 199 5.2 Translation states............................................. 199 5.3 Direct translation............................................. 200 5.4 Peer review................................................ 200 5.5 Dedicated reviewers........................................... 200 5.6 Enabling reviews............................................. 201 6 Frequently Asked Questions 203 6.1 Configuration............................................... 203 6.2 Usage................................................... 207 6.3 Troubleshooting............................................. 208 6.4 Features.................................................. 210 7 Supported formats 211 7.1 Bilingual and monolignual formats................................... 211 7.2 Automatic detection........................................... 211 7.3 Translation types capabilities...................................... 212 7.4 GNU Gettext............................................... 212 7.5 XLIFF.................................................. 213 7.6 Java properties.............................................. 214 7.7 Joomla translations............................................ 215 7.8 Qt Linguist .ts.............................................. 215 7.9 Android string resources......................................... 215 7.10 Apple OS X strings............................................ 216 7.11 PHP strings................................................ 217 7.12 JSON files................................................ 217 7.13 WebExtension JSON........................................... 218 7.14 .Net Resource files............................................ 219 7.15 CSV files................................................. 219 7.16 YAML files................................................ 220 7.17 DTD files................................................. 220 7.18 Windows RC files............................................ 221 7.19 Excel Open XML............................................ 221 7.20 Others.................................................. 221 7.21 Adding new translations......................................... 222 8 Version control integration 223 8.1 Accessing repositories.......................................... 223 8.2 Git.................................................... 226 8.3 GitHub.................................................. 226 8.4 Mercurial................................................. 227 8.5 Subversion................................................ 227 9 Weblate’s Web API 229 9.1 REST API................................................ 229 9.2 Notification hooks............................................ 249 ii 9.3 Exports.................................................. 250 9.4 RSS feeds................................................. 251 10 Weblate Client 253 10.1 Installation................................................ 253 10.2 Synopsis................................................. 253 10.3 Description................................................ 253 10.4 Files................................................... 255 10.5 Examples................................................. 256 11 Weblate’s Python API 257 11.1 Instalation................................................ 257 11.2 wlc .................................................... 257 11.3 wlc.config .............................................. 258 11.4 wlc.main ................................................ 258 12 Changes 259 12.1 weblate 3.2.2............................................... 259 12.2 weblate 3.2.1............................................... 259 12.3 weblate 3.2................................................ 260 12.4 weblate 3.1.1............................................... 260 12.5 weblate 3.1................................................ 261 12.6 weblate 3.0.1............................................... 261 12.7 weblate 3.0................................................ 261 12.8 weblate 2.20............................................... 262 12.9 weblate 2.19.1.............................................. 262 12.10 weblate 2.19............................................... 262 12.11 weblate 2.18............................................... 263 12.12 weblate 2.17.1.............................................. 263 12.13 weblate 2.17............................................... 264 12.14 weblate 2.16............................................... 264 12.15 weblate 2.15............................................... 264 12.16 weblate 2.14.1.............................................. 265 12.17 weblate 2.14............................................... 265 12.18 weblate 2.13.1.............................................. 266 12.19 weblate 2.13............................................... 266 12.20 weblate 2.12............................................... 266 12.21 weblate 2.11............................................... 267 12.22 weblate 2.10.1.............................................. 267 12.23 weblate 2.10............................................... 267 12.24 weblate 2.9................................................ 268 12.25 weblate 2.8................................................ 268 12.26 weblate 2.7................................................ 269 12.27 weblate 2.6................................................ 269 12.28 weblate 2.5................................................ 269 12.29 weblate 2.4................................................ 271 12.30 weblate 2.3................................................ 272 12.31 weblate 2.2................................................ 272 12.32 weblate 2.1................................................ 273 12.33 weblate 2.0................................................ 273 12.34 weblate 1.9................................................ 274 12.35 weblate 1.8................................................ 274 12.36 weblate 1.7................................................ 274 12.37 weblate 1.6................................................ 275 iii 12.38 weblate 1.5................................................ 275 12.39 weblate 1.4................................................ 276 12.40 weblate 1.3................................................ 277 12.41 weblate 1.2................................................ 277 12.42 weblate 1.1................................................ 278 12.43 weblate 1.0................................................ 278 12.44 weblate 0.9................................................ 278 12.45 weblate 0.8................................................ 279 12.46 weblate 0.7...............................................