Improve translation plugin guide
authorChocobozzz <me@florianbigard.com>
Fri, 26 Jul 2019 13:29:28 +0000 (15:29 +0200)
committerChocobozzz <me@florianbigard.com>
Fri, 26 Jul 2019 13:29:28 +0000 (15:29 +0200)
support/doc/plugins/guide.md

index 1aae65a1c11961a9d76fa8c8d1c8c35e5d7f69ed..b4f3e66381727091ca7a03e3dd5415164202dd1b 100644 (file)
@@ -30,6 +30,7 @@
 - [Tips](#tips)
   - [Compatibility with PeerTube](#compatibility-with-peertube)
   - [Spam/moderation plugin](#spammoderation-plugin)
+  - [Other plugin examples](#other-plugin-examples)
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
@@ -323,6 +324,15 @@ If you want to translate strings of your plugin (like labels of your registered
 The key should be one of the locales defined in [i18n.ts](https://github.com/Chocobozzz/PeerTube/blob/develop/shared/models/i18n/i18n.ts).
 You **must** use the complete locales (`fr-FR` instead of `fr`).
 
+Translation files are just objects, with the english sentence as the key and the translation as the value.
+`fr.json` could contain for example:
+
+```json
+{
+  "Hello world": "Hello le monde"
+}
+```
+
 ### Test your plugin/theme
 
 You'll need to have a local PeerTube instance:
@@ -410,3 +420,6 @@ If you want to create an antispam/moderation plugin, you could use the following
  * `filter:api.video-thread-comments.list.result`: to change/hide the text of replies
  * `filter:video.auto-blacklist.result`: to automatically blacklist local or remote videos
  
+### Other plugin examples
+
+You can take a look to "official" PeerTube plugins if you want to take inspiration from them: https://framagit.org/framasoft/peertube/official-plugins