Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

259 line
9.4 KiB

  1. # SOME DESCRIPTIVE TITLE.
  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
  3. # members
  4. # This file is distributed under the same license as the
  5. # matrix-docker-ansible-deploy package.
  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
  7. #
  8. #, fuzzy
  9. msgid ""
  10. msgstr ""
  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"
  12. "Report-Msgid-Bugs-To: \n"
  13. "POT-Creation-Date: 2024-12-16 12:05+0900\n"
  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  16. "Language: jp\n"
  17. "Language-Team: jp <LL@li.org>\n"
  18. "MIME-Version: 1.0\n"
  19. "Content-Type: text/plain; charset=utf-8\n"
  20. "Content-Transfer-Encoding: 8bit\n"
  21. "Generated-By: Babel 2.16.0\n"
  22. #: ../../../docs/configuring-playbook-dimension.md:1
  23. msgid "Setting up Dimension integration manager (optional, unmaintained)"
  24. msgstr ""
  25. #: ../../../docs/configuring-playbook-dimension.md:3
  26. msgid ""
  27. "**[Dimension](https://dimension.t2bot.io) can only be installed after "
  28. "Matrix services are installed and running.** If you're just installing "
  29. "Matrix services for the first time, please continue with the "
  30. "[Configuration](configuring-playbook.md) / [Installation](installing.md) "
  31. "flow and come back here later."
  32. msgstr ""
  33. #: ../../../docs/configuring-playbook-dimension.md:5
  34. msgid ""
  35. "**Note**: Dimension is **[officially "
  36. "unmaintained](https://github.com/spantaleev/matrix-docker-ansible-"
  37. "deploy/issues/2806#issuecomment-1673559299)**. We recommend not bothering"
  38. " with installing it."
  39. msgstr ""
  40. #: ../../../docs/configuring-playbook-dimension.md:7
  41. msgid ""
  42. "**Note**: This playbook now supports running "
  43. "[Dimension](https://dimension.t2bot.io) in both a federated and "
  44. "[unfederated](https://github.com/turt2live/matrix-"
  45. "dimension/blob/master/docs/unfederated.md) environments. This is handled "
  46. "automatically based on the value of "
  47. "`matrix_homeserver_federation_enabled`. Enabling Dimension, means that "
  48. "the `openid` API endpoints will be exposed on the Matrix Federation port "
  49. "(usually `8448`), even if [federation](configuring-playbook-"
  50. "federation.md) is disabled. It's something to be aware of, especially in "
  51. "terms of firewall whitelisting (make sure port `8448` is accessible)."
  52. msgstr ""
  53. #: ../../../docs/configuring-playbook-dimension.md:9
  54. msgid "Adjusting the playbook configuration"
  55. msgstr ""
  56. #: ../../../docs/configuring-playbook-dimension.md:11
  57. msgid ""
  58. "To enable Dimension, add this to your configuration file "
  59. "(`inventory/host_vars/matrix.example.com/vars.yml`):"
  60. msgstr ""
  61. #: ../../../docs/configuring-playbook-dimension.md:17
  62. msgid "Define admin users"
  63. msgstr ""
  64. #: ../../../docs/configuring-playbook-dimension.md:19
  65. msgid ""
  66. "These users can modify the integrations this Dimension supports. Add this"
  67. " to your configuration file "
  68. "(`inventory/host_vars/matrix.example.com/vars.yml`):"
  69. msgstr ""
  70. #: ../../../docs/configuring-playbook-dimension.md:27
  71. msgid ""
  72. "The admin interface is accessible within Element Web by accessing it in "
  73. "any room and clicking the cog wheel/settings icon in the top right. "
  74. "Currently, Dimension can be opened in Element Web by the \"Add widgets, "
  75. "bridges, & bots\" link in the room information."
  76. msgstr ""
  77. #: ../../../docs/configuring-playbook-dimension.md:29
  78. msgid "Access token"
  79. msgstr ""
  80. #: ../../../docs/configuring-playbook-dimension.md:31
  81. msgid ""
  82. "We recommend that you create a dedicated Matrix user for Dimension "
  83. "(`dimension` is a good username). Follow our [Registering users"
  84. "](registering-users.md) guide to learn how to register **a regular (non-"
  85. "admin) user**."
  86. msgstr ""
  87. #: ../../../docs/configuring-playbook-dimension.md:33
  88. msgid ""
  89. "You are required to specify an access token (belonging to this new user) "
  90. "for Dimension to work. To get an access token for the Dimension user, you"
  91. " can follow the documentation on [how to do obtain an access token"
  92. "](obtaining-access-tokens.md)."
  93. msgstr ""
  94. #: ../../../docs/configuring-playbook-dimension.md:35
  95. msgid ""
  96. "**Access tokens are sensitive information. Do not include them in any bug"
  97. " reports, messages, or logs. Do not share the access token with anyone.**"
  98. msgstr ""
  99. #: ../../../docs/configuring-playbook-dimension.md:37
  100. msgid ""
  101. "Add access token to your configuration file "
  102. "(`inventory/host_vars/matrix.example.com/vars.yml`):"
  103. msgstr ""
  104. #: ../../../docs/configuring-playbook-dimension.md:43
  105. msgid ""
  106. "For more information on how to acquire an access token, visit "
  107. "[https://t2bot.io/docs/access_tokens](https://t2bot.io/docs/access_tokens)."
  108. msgstr ""
  109. #: ../../../docs/configuring-playbook-dimension.md:45
  110. msgid "Adjusting the Dimension URL"
  111. msgstr ""
  112. #: ../../../docs/configuring-playbook-dimension.md:47
  113. msgid ""
  114. "By default, this playbook installs Dimension on the `dimension.` "
  115. "subdomain (`dimension.example.com`) and requires you to [adjust your DNS "
  116. "records](#adjusting-dns-records)."
  117. msgstr ""
  118. #: ../../../docs/configuring-playbook-dimension.md:49
  119. msgid ""
  120. "By tweaking the `matrix_dimension_hostname` and "
  121. "`matrix_dimension_path_prefix` variables, you can easily make the service"
  122. " available at a **different hostname and/or path** than the default one."
  123. msgstr ""
  124. #: ../../../docs/configuring-playbook-dimension.md:51
  125. msgid ""
  126. "Example additional configuration for your "
  127. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  128. msgstr ""
  129. #: ../../../docs/configuring-playbook-dimension.md:62
  130. msgid ""
  131. "**Note**: While there is a `matrix_dimension_path_prefix` variable for "
  132. "changing the path where Dimension is served, overriding it is not "
  133. "possible due to [this Dimension issue](https://github.com/turt2live"
  134. "/matrix-dimension/issues/510). You must serve Dimension at a dedicated "
  135. "subdomain."
  136. msgstr ""
  137. #: ../../../docs/configuring-playbook-dimension.md:64
  138. msgid "Adjusting DNS records"
  139. msgstr ""
  140. #: ../../../docs/configuring-playbook-dimension.md:66
  141. msgid ""
  142. "Once you've decided on the domain and path, **you may need to adjust your"
  143. " DNS** records to point the Dimension domain to the Matrix server."
  144. msgstr ""
  145. #: ../../../docs/configuring-playbook-dimension.md:68
  146. msgid ""
  147. "By default, you will need to create a CNAME record for `dimension`. See "
  148. "[Configuring DNS](configuring-dns.md) for details about DNS changes."
  149. msgstr ""
  150. #: ../../../docs/configuring-playbook-dimension.md:70
  151. msgid "Installing"
  152. msgstr ""
  153. #: ../../../docs/configuring-playbook-dimension.md:72
  154. msgid ""
  155. "After configuring the playbook and potentially [adjusting your DNS "
  156. "records](#adjusting-dns-records), run the playbook with [playbook tags"
  157. "](playbook-tags.md) as below:"
  158. msgstr ""
  159. #: ../../../docs/configuring-playbook-dimension.md:79
  160. msgid "**Notes**:"
  161. msgstr ""
  162. #: ../../../docs/configuring-playbook-dimension.md:81
  163. msgid ""
  164. "The shortcut commands with the [`just` program](just.md) are also "
  165. "available: `just install-all` or `just setup-all`"
  166. msgstr ""
  167. #: ../../../docs/configuring-playbook-dimension.md:83
  168. msgid ""
  169. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  170. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  171. "runtime) than `just setup-all`) when its components remain unchanged. If "
  172. "you adjust your `vars.yml` to remove other components, you'd need to run "
  173. "`just setup-all`, or these components will still remain installed. Note "
  174. "these shortcuts run the `ensure-matrix-users-created` tag too."
  175. msgstr ""
  176. #: ../../../docs/configuring-playbook-dimension.md:85
  177. msgid ""
  178. "After Dimension has been installed you may need to log out and log back "
  179. "in for it to pick up the new integration manager. Then you can access "
  180. "integrations in Element Web by opening a room, clicking the Room info "
  181. "button (`i`) button in the top right corner of the screen, and then "
  182. "clicking Add widgets, bridges & bots."
  183. msgstr ""
  184. #: ../../../docs/configuring-playbook-dimension.md:87
  185. msgid "Jitsi domain"
  186. msgstr ""
  187. #: ../../../docs/configuring-playbook-dimension.md:89
  188. msgid ""
  189. "By default Dimension will use [jitsi.riot.im](https://jitsi.riot.im/) as "
  190. "the `conferenceDomain` of [Jitsi](https://jitsi.org/) audio/video "
  191. "conference widgets. For users running [a self-hosted Jitsi instance"
  192. "](./configuring-playbook-jitsi.md), you will likely want the widget to "
  193. "use your own Jitsi instance. Currently there is no way to configure this "
  194. "via the playbook, see [this issue](https://github.com/turt2live/matrix-"
  195. "dimension/issues/345) for details."
  196. msgstr ""
  197. #: ../../../docs/configuring-playbook-dimension.md:91
  198. msgid ""
  199. "In the interim until the above limitation is resolved, an admin user "
  200. "needs to configure the domain via the admin ui once dimension is running."
  201. " In Element Web, go to *Manage Integrations* &rightarrow; *Settings* "
  202. "&rightarrow; *Widgets* &rightarrow; *Jitsi Conference Settings* and set "
  203. "*Jitsi Domain* and *Jitsi Script URL* appropriately."
  204. msgstr ""
  205. #: ../../../docs/configuring-playbook-dimension.md:93
  206. msgid "Additional features"
  207. msgstr ""
  208. #: ../../../docs/configuring-playbook-dimension.md:95
  209. msgid ""
  210. "To use a more custom configuration, you can define a "
  211. "`matrix_dimension_configuration_extension_yaml` string variable and put "
  212. "your configuration in it. To learn more about how to do this, refer to "
  213. "the information about `matrix_dimension_configuration_extension_yaml` in "
  214. "the [default variables file](../roles/custom/matrix-"
  215. "dimension/defaults/main.yml) of the Dimension component."
  216. msgstr ""
  217. #: ../../../docs/configuring-playbook-dimension.md:97
  218. msgid ""
  219. "You can find all configuration options on [GitHub page of Dimension "
  220. "project](https://github.com/turt2live/matrix-"
  221. "dimension/blob/master/config/default.yaml)."
  222. msgstr ""