overmind
/
matrix-docker-ansible-deploy
miroir de https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Bifurcation 0
Code Tickets 0 Versions 0 Wiki Activité
Matrix Docker Ansible eploy
Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
8904 Révisions
12 Branches
241 MiB
 
 
Aborescence: af0dfd99cd
Branches Tags
${ item.name }
Créer la branche ${ searchTerm }
de 'af0dfd99cd'
${ noResults }
matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-etherp...

170 lignes
8.0 KiB
Brut Annotations Historique 

  1. # SOME DESCRIPTIVE TITLE.

  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community members

  3. # This file is distributed under the same license as the matrix-docker-ansible-deploy package.

  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

  5. #

  6. #, fuzzy

  7. msgid ""

  8. msgstr ""

  9. "Project-Id-Version: matrix-docker-ansible-deploy \n"

  10. "Report-Msgid-Bugs-To: \n"

  11. "POT-Creation-Date: 2024-12-20 07:23+0200\n"

  12. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"

  13. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"

  14. "Language-Team: LANGUAGE <LL@li.org>\n"

  15. "MIME-Version: 1.0\n"

  16. "Content-Type: text/plain; charset=UTF-8\n"

  17. "Content-Transfer-Encoding: 8bit\n"

  18. 

  19. #: ../../../docs/configuring-playbook-etherpad.md:1

  20. msgid "Setting up Etherpad (optional)"

  21. msgstr ""

  22. 

  23. #: ../../../docs/configuring-playbook-etherpad.md:3

  24. msgid "[Etherpad](https://etherpad.org) is an open source collaborative text editor that can be embedded in a Matrix chat room using the [Dimension integration manager](https://dimension.t2bot.io) or used as standalone web app."

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-etherpad.md:5

  28. msgid "When enabled together with the Jitsi audio/video conferencing system (see [our docs on Jitsi](configuring-playbook-jitsi.md)), it will be made available as an option during the conferences."

  29. msgstr ""

  30. 

  31. #: ../../../docs/configuring-playbook-etherpad.md:7

  32. msgid "Adjusting the playbook configuration"

  33. msgstr ""

  34. 

  35. #: ../../../docs/configuring-playbook-etherpad.md:9

  36. msgid "To enable Etherpad, add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-etherpad.md:19

  40. msgid "Adjusting the Etherpad URL"

  41. msgstr ""

  42. 

  43. #: ../../../docs/configuring-playbook-etherpad.md:21

  44. msgid "By default, this playbook installs Etherpad on the `etherpad.` subdomain (`etherpad.example.com`) and requires you to [adjust your DNS records](#adjusting-dns-records)."

  45. msgstr ""

  46. 

  47. #: ../../../docs/configuring-playbook-etherpad.md:23

  48. msgid "By tweaking the `etherpad_hostname` and `etherpad_path_prefix` variables, you can easily make the service available at a **different hostname and/or path** than the default one."

  49. msgstr ""

  50. 

  51. #: ../../../docs/configuring-playbook-etherpad.md:25

  52. msgid "Example additional configuration for your `inventory/host_vars/matrix.example.com/vars.yml` file:"

  53. msgstr ""

  54. 

  55. #: ../../../docs/configuring-playbook-etherpad.md:36

  56. msgid "Adjusting DNS records"

  57. msgstr ""

  58. 

  59. #: ../../../docs/configuring-playbook-etherpad.md:38

  60. msgid "Once you've decided on the domain and path, **you may need to adjust your DNS** records to point the Etherpad domain to the Matrix server."

  61. msgstr ""

  62. 

  63. #: ../../../docs/configuring-playbook-etherpad.md:40

  64. msgid "By default, you will need to create a CNAME record for `etherpad`. See [Configuring DNS](configuring-dns.md) for details about DNS changes."

  65. msgstr ""

  66. 

  67. #: ../../../docs/configuring-playbook-etherpad.md:42

  68. msgid "If you've decided to reuse the `matrix.` domain, you won't need to do any extra DNS configuration."

  69. msgstr ""

  70. 

  71. #: ../../../docs/configuring-playbook-etherpad.md:44

  72. msgid "Installing"

  73. msgstr ""

  74. 

  75. #: ../../../docs/configuring-playbook-etherpad.md:46

  76. msgid "After configuring the playbook and potentially [adjusting your DNS records](#adjusting-dns-records), run the playbook with [playbook tags](playbook-tags.md) as below:"

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-etherpad.md:53

  80. msgid "**Notes**:"

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-etherpad.md:55

  84. msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create the Etherpad admin user (`etherpad_admin_username`)."

  85. msgstr ""

  86. 

  87. #: ../../../docs/configuring-playbook-etherpad.md:57

  88. msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"

  89. msgstr ""

  90. 

  91. #: ../../../docs/configuring-playbook-etherpad.md:59

  92. msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed."

  93. msgstr ""

  94. 

  95. #: ../../../docs/configuring-playbook-etherpad.md:61

  96. msgid "If you change the Etherpad admin user's password (`etherpad_admin_password` in your `vars.yml` file) subsequently, the admin user's credentials on the homeserver won't be updated automatically. If you'd like to change the admin user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `etherpad_admin_password` to let the admin user know its new password."

  97. msgstr ""

  98. 

  99. #: ../../../docs/configuring-playbook-etherpad.md:63

  100. msgid "Usage"

  101. msgstr ""

  102. 

  103. #: ../../../docs/configuring-playbook-etherpad.md:65

  104. msgid "The Etherpad UI should be available at `https://etherpad.example.com`, while the admin UI (if enabled) should then be available at `https://etherpad.example.com/admin`."

  105. msgstr ""

  106. 

  107. #: ../../../docs/configuring-playbook-etherpad.md:67

  108. msgid "If you've [decided on another hostname or path-prefix](#adjusting-the-etherpad-url) (e.g. `https://matrix.example.com/etherpad`), adjust these URLs accordingly before usage."

  109. msgstr ""

  110. 

  111. #: ../../../docs/configuring-playbook-etherpad.md:69

  112. msgid "Managing / Deleting old pads"

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-etherpad.md:71

  116. msgid "If you want to manage and remove old unused pads from Etherpad, you will first need to able Admin access as described above."

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-etherpad.md:73

  120. msgid "Then from the plugin manager page (`https://etherpad.example.com/admin/plugins`, install the `adminpads2` plugin. Once installed, you should have a \"Manage pads\" section in the Admin web-UI."

  121. msgstr ""

  122. 

  123. #: ../../../docs/configuring-playbook-etherpad.md:75

  124. msgid "How to use Etherpad widgets without an integration manager (like Dimension)"

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-etherpad.md:77

  128. msgid "This is how it works in Element Web, it might work quite similar with other clients:"

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-etherpad.md:79

  132. msgid "To integrate a standalone Etherpad in a room, create your pad by visiting `https://etherpad.example.com`. When the pad opens, copy the URL and send a command like this to the room: `/addwidget URL`. You will then find your integrated Etherpad within the right sidebar in the `Widgets` section."

  133. msgstr ""

  134. 

  135. #: ../../../docs/configuring-playbook-etherpad.md:81

  136. msgid "Set Dimension default to the self-hosted Etherpad (optional)"

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-etherpad.md:83

  140. msgid "If you decided to install [Dimension integration manager](configuring-playbook-dimension.md) alongside Etherpad, the Dimension administrator users can configure the default URL template."

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-etherpad.md:85

  144. msgid "The Dimension configuration menu can be accessed with the sprocket icon as you begin to add a widget to a room in Element Web. There you will find the Etherpad Widget Configuration action beneath the _Widgets_ tab."

  145. msgstr ""

  146. 

  147. #: ../../../docs/configuring-playbook-etherpad.md:87

  148. msgid "Removing the integrated Etherpad chat"

  149. msgstr ""

  150. 

  151. #: ../../../docs/configuring-playbook-etherpad.md:89

  152. msgid "If you wish to disable the Etherpad chat button, you can do it by appending `?showChat=false` to the end of the pad URL, or the template."

  153. msgstr ""

  154. 

  155. #: ../../../docs/configuring-playbook-etherpad.md:91

  156. msgid "Example: `https://etherpad.example.com/p/$roomId_$padName?showChat=false`"

  157. msgstr ""

  158. 

  159. #: ../../../docs/configuring-playbook-etherpad.md:93

  160. msgid "Known issues"

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-etherpad.md:95

  164. msgid "If your Etherpad widget fails to load, this might be due to Dimension generating a Pad name so long, the Etherpad app rejects it."

  165. msgstr ""

  166. 

  167. #: ../../../docs/configuring-playbook-etherpad.md:97

  168. msgid "`$roomId_$padName` can end up being longer than 50 characters. You can avoid having this problem by altering the template so it only contains the three word random identifier `$padName`."

  169. msgstr ""