Release 2.19 Michalˇcihar
Total Page:16
File Type:pdf, Size:1020Kb
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.............................................. 88 4.7 Translation projects........................................... 93 4.8 Language definitions........................................... 105 4.9 Continuous translation.......................................... 106 4.10 Translation process............................................ 113 4.11 Checks and fixups............................................ 119 4.12 Machine translation........................................... 123 4.13 Addons.................................................. 128 4.14 Configuration............................................... 130 4.15 Sample configuration........................................... 144 4.16 Management commands......................................... 157 i 4.17 Whiteboard messages.......................................... 166 4.18 Component Lists............................................. 168 4.19 Optional Weblate modules........................................ 169 5 Translation workflows 173 5.1 Translation access............................................ 173 5.2 Translation states............................................. 173 5.3 Direct translation............................................. 174 5.4 Peer review................................................ 174 5.5 Dedicated reviewers........................................... 174 5.6 Enabling reviews............................................. 175 6 Frequently Asked Questions 177 6.1 Configuration............................................... 177 6.2 Usage................................................... 180 6.3 Troubleshooting............................................. 182 6.4 Features.................................................. 183 7 Supported formats 185 7.1 Automatic detection........................................... 185 7.2 GNU Gettext............................................... 185 7.3 XLIFF.................................................. 187 7.4 Java properties.............................................. 188 7.5 Joomla translations............................................ 188 7.6 Qt Linguist .ts.............................................. 188 7.7 Android string resources......................................... 189 7.8 Apple OS X strings............................................ 189 7.9 PHP strings................................................ 190 7.10 JSON files................................................ 190 7.11 WebExtension JSON........................................... 191 7.12 .Net Resource files............................................ 192 7.13 CSV files................................................. 192 7.14 YAML files................................................ 193 7.15 DTD files................................................. 194 7.16 Others.................................................. 194 7.17 Adding new translations......................................... 194 8 Version control integration 195 8.1 Accessing repositories.......................................... 195 8.2 Git.................................................... 197 8.3 GitHub.................................................. 198 8.4 Mercurial................................................. 199 8.5 Subversion................................................ 199 9 Weblate’s Web API 201 9.1 REST API................................................ 201 9.2 Notification hooks............................................ 221 9.3 Exports.................................................. 222 9.4 RSS feeds................................................. 223 10 Weblate Client 225 10.1 Installation................................................ 225 10.2 Synopsis................................................. 225 10.3 Description................................................ 225 10.4 Files................................................... 227 ii 10.5 Examples................................................. 228 11 Weblate’s Python API 229 11.1 Instalation................................................ 229 11.2 wlc .................................................... 229 11.3 wlc.config .............................................. 230 11.4 wlc.main ................................................ 230 12 Changes 231 12.1 weblate 2.19............................................... 231 12.2 weblate 2.18............................................... 232 12.3 weblate 2.17.1.............................................. 232 12.4 weblate 2.17............................................... 232 12.5 weblate 2.16............................................... 233 12.6 weblate 2.15............................................... 233 12.7 weblate 2.14.1.............................................. 233 12.8 weblate 2.14............................................... 234 12.9 weblate 2.13.1.............................................. 234 12.10 weblate 2.13............................................... 234 12.11 weblate 2.12............................................... 235 12.12 weblate 2.11............................................... 235 12.13 weblate 2.10.1.............................................. 236 12.14 weblate 2.10............................................... 236 12.15 weblate 2.9................................................ 236 12.16 weblate 2.8................................................ 237 12.17 weblate 2.7................................................ 237 12.18 weblate 2.6................................................ 238 12.19 weblate 2.5................................................ 238 12.20 weblate 2.4................................................ 239 12.21 weblate 2.3................................................ 240 12.22 weblate 2.2................................................ 241 12.23 weblate 2.1................................................ 241 12.24 weblate 2.0................................................ 242 12.25 weblate 1.9................................................ 242 12.26 weblate 1.8................................................ 243 12.27 weblate 1.7................................................ 243 12.28 weblate 1.6................................................ 243 12.29 weblate 1.5................................................ 244 12.30 weblate 1.4................................................ 245 12.31 weblate 1.3................................................ 245 12.32 weblate 1.2................................................ 246 12.33 weblate 1.1................................................ 247 12.34 weblate 1.0................................................ 247 12.35 weblate 0.9................................................ 247 12.36 weblate 0.8................................................ 248 12.37 weblate 0.7................................................ 248 12.38 weblate 0.6................................................ 248 12.39 weblate 0.5................................................ 249 12.40 weblate 0.4................................................ 249 12.41 weblate 0.3................................................ 249 12.42 weblate 0.2................................................ 249 12.43 weblate 0.1................................................ 250 13 Contributing 251 iii 13.1 Code and development.......................................... 251 13.2 Coding standard............................................. 251 13.3 Developer’s Certificate of Origin.................................... 251 13.4 Testsuite................................................. 252 13.5 Reporting issues............................................. 252 13.6 Security issues.............................................. 252 13.7 Starting with our codebase........................................ 253 13.8 Earning money by coding........................................ 253 13.9 Translating................................................ 253 13.10 Funding Weblate development...................................... 253 14 Internals 255 14.1 Modules................................................