Release 3.1.1 Michalˇcihar
Total Page:16
File Type:pdf, Size:1020Kb
Weblate Documentation Release 3.1.1 Michal Cihaˇ rˇ Jul 27, 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........................................... 68 4.4 Upgrading Weblate............................................ 79 4.5 Authentication.............................................. 81 4.6 Access control.............................................. 87 4.7 Translation projects........................................... 94 4.8 Language definitions........................................... 105 4.9 Continuous translation.......................................... 106 4.10 Licensing translations.......................................... 112 4.11 Translation process............................................ 113 4.12 Checks and fixups............................................ 120 4.13 Machine translation........................................... 124 4.14 Addons.................................................. 129 4.15 Translation Memory........................................... 137 4.16 Configuration............................................... 137 i 4.17 Sample configuration........................................... 152 4.18 Management commands......................................... 166 4.19 Whiteboard messages.......................................... 176 4.20 Component Lists............................................. 178 4.21 Optional Weblate modules........................................ 179 5 Translation workflows 185 5.1 Translation access............................................ 185 5.2 Translation states............................................. 185 5.3 Direct translation............................................. 186 5.4 Peer review................................................ 186 5.5 Dedicated reviewers........................................... 186 5.6 Enabling reviews............................................. 187 6 Frequently Asked Questions 189 6.1 Configuration............................................... 189 6.2 Usage................................................... 193 6.3 Troubleshooting............................................. 194 6.4 Features.................................................. 196 7 Supported formats 197 7.1 Bilingual and monolignual formats................................... 197 7.2 Automatic detection........................................... 197 7.3 GNU Gettext............................................... 198 7.4 XLIFF.................................................. 199 7.5 Java properties.............................................. 200 7.6 Joomla translations............................................ 200 7.7 Qt Linguist .ts.............................................. 200 7.8 Android string resources......................................... 201 7.9 Apple OS X strings............................................ 202 7.10 PHP strings................................................ 202 7.11 JSON files................................................ 202 7.12 WebExtension JSON........................................... 203 7.13 .Net Resource files............................................ 204 7.14 CSV files................................................. 204 7.15 YAML files................................................ 205 7.16 DTD files................................................. 206 7.17 Windows RC files............................................ 206 7.18 Others.................................................. 206 7.19 Adding new translations......................................... 207 8 Version control integration 209 8.1 Accessing repositories.......................................... 209 8.2 Git.................................................... 212 8.3 GitHub.................................................. 212 8.4 Mercurial................................................. 213 8.5 Subversion................................................ 213 9 Weblate’s Web API 215 9.1 REST API................................................ 215 9.2 Notification hooks............................................ 235 9.3 Exports.................................................. 236 9.4 RSS feeds................................................. 237 10 Weblate Client 239 ii 10.1 Installation................................................ 239 10.2 Synopsis................................................. 239 10.3 Description................................................ 239 10.4 Files................................................... 241 10.5 Examples................................................. 242 11 Weblate’s Python API 243 11.1 Instalation................................................ 243 11.2 wlc .................................................... 243 11.3 wlc.config .............................................. 244 11.4 wlc.main ................................................ 244 12 Changes 245 12.1 weblate 3.1.1............................................... 245 12.2 weblate 3.1................................................ 245 12.3 weblate 3.0.1............................................... 246 12.4 weblate 3.0................................................ 246 12.5 weblate 2.20............................................... 246 12.6 weblate 2.19.1.............................................. 247 12.7 weblate 2.19............................................... 247 12.8 weblate 2.18............................................... 248 12.9 weblate 2.17.1.............................................. 248 12.10 weblate 2.17............................................... 248 12.11 weblate 2.16............................................... 249 12.12 weblate 2.15............................................... 249 12.13 weblate 2.14.1.............................................. 249 12.14 weblate 2.14............................................... 250 12.15 weblate 2.13.1.............................................. 250 12.16 weblate 2.13............................................... 250 12.17 weblate 2.12............................................... 251 12.18 weblate 2.11............................................... 251 12.19 weblate 2.10.1.............................................. 252 12.20 weblate 2.10............................................... 252 12.21 weblate 2.9................................................ 252 12.22 weblate 2.8................................................ 253 12.23 weblate 2.7................................................ 253 12.24 weblate 2.6................................................ 254 12.25 weblate 2.5................................................ 254 12.26 weblate 2.4................................................ 255 12.27 weblate 2.3................................................ 256 12.28 weblate 2.2................................................ 257 12.29 weblate 2.1................................................ 257 12.30 weblate 2.0................................................ 258 12.31 weblate 1.9................................................ 258 12.32 weblate 1.8................................................ 259 12.33 weblate 1.7................................................ 259 12.34 weblate 1.6................................................ 259 12.35 weblate 1.5................................................ 260 12.36 weblate 1.4................................................ 261 12.37 weblate 1.3................................................ 261 12.38 weblate 1.2................................................ 262 12.39 weblate 1.1................................................ 263 12.40 weblate 1.0................................................ 263 12.41 weblate 0.9................................................ 263 iii 12.42 weblate 0.8................................................ 264 12.43 weblate 0.7................................................ 264 12.44 weblate 0.6................................................ 264 12.45 weblate 0.5................................................ 265 12.46 weblate 0.4................................................ 265 12.47 weblate 0.3................................................ 265 12.48 weblate 0.2................................................ 265 12.49 weblate 0.1................................................ 266 13 Contributing 267 13.1 Code and development.........................................