overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
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.
8820 Commits
5 Branches
516 MiB
 
 
 
Tree: c51e771d1a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/jp/LC_MESSAGES/docs/configuring-playbook-cactus...

238 lines
7.8 KiB
Raw Blame History 

  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. 

  23. #: ../../../docs/configuring-playbook-cactus-comments.md:1

  24. msgid "Setting up Cactus Comments (optional)"

  25. msgstr ""

  26. 

  27. #: ../../../docs/configuring-playbook-cactus-comments.md:3

  28. msgid ""

  29. "The playbook can install and configure the [Cactus "

  30. "Comments](https://cactus.chat) system for you."

  31. msgstr ""

  32. 

  33. #: ../../../docs/configuring-playbook-cactus-comments.md:5

  34. msgid ""

  35. "Cactus Comments is a **federated comment system** built on Matrix. It "

  36. "respects your privacy, and puts you in control."

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-cactus-comments.md:7

  40. msgid ""

  41. "See the project's [documentation](https://cactus.chat/docs/getting-"

  42. "started/introduction/) to learn what it does and why it might be useful "

  43. "to you."

  44. msgstr ""

  45. 

  46. #: ../../../docs/configuring-playbook-cactus-comments.md:9

  47. msgid ""

  48. "The playbook contains 2 roles for configuring different pieces of the "

  49. "Cactus Comments system:"

  50. msgstr ""

  51. 

  52. #: ../../../docs/configuring-playbook-cactus-comments.md:11

  53. msgid ""

  54. "`matrix-cactus-comments` - the backend appservice integrating with the "

  55. "Matrix homeserver"

  56. msgstr ""

  57. 

  58. #: ../../../docs/configuring-playbook-cactus-comments.md:13

  59. msgid ""

  60. "`matrix-cactus-comments-client` - a static website server serving the "

  61. "[cactus-client](https://cactus.chat/docs/client/introduction/) static "

  62. "assets (`cactus.js` and `styles.css`)"

  63. msgstr ""

  64. 

  65. #: ../../../docs/configuring-playbook-cactus-comments.md:15

  66. msgid "You can enable whichever component you need (typically both)."

  67. msgstr ""

  68. 

  69. #: ../../../docs/configuring-playbook-cactus-comments.md:17

  70. msgid "Configuration"

  71. msgstr ""

  72. 

  73. #: ../../../docs/configuring-playbook-cactus-comments.md:19

  74. msgid ""

  75. "To enable Cactus Comments, add the following configuration to your "

  76. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  77. msgstr ""

  78. 

  79. #: ../../../docs/configuring-playbook-cactus-comments.md:41

  80. msgid "Adjusting the Cactus Comments' client URL"

  81. msgstr ""

  82. 

  83. #: ../../../docs/configuring-playbook-cactus-comments.md:43

  84. msgid ""

  85. "By default, this playbook installs Cactus Comments' client on the "

  86. "`matrix.` subdomain, at the `/cactus-comments` path "

  87. "(https://matrix.example.com/cactus-comments). This makes it easy to "

  88. "install it, because it **doesn't require additional DNS records to be set"

  89. " up**. If that's okay, you can skip this section."

  90. msgstr ""

  91. 

  92. #: ../../../docs/configuring-playbook-cactus-comments.md:45

  93. msgid ""

  94. "By tweaking the `matrix_cactus_comments_client_hostname` and "

  95. "`matrix_cactus_comments_client_path_prefix` variables, you can easily "

  96. "make the service available at a **different hostname and/or path** than "

  97. "the default one."

  98. msgstr ""

  99. 

  100. #: ../../../docs/configuring-playbook-cactus-comments.md:47

  101. msgid ""

  102. "Example additional configuration for your "

  103. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  104. msgstr ""

  105. 

  106. #: ../../../docs/configuring-playbook-cactus-comments.md:56

  107. msgid "Adjusting DNS records"

  108. msgstr ""

  109. 

  110. #: ../../../docs/configuring-playbook-cactus-comments.md:58

  111. msgid ""

  112. "If you've changed the default hostname, **you may need to adjust your "

  113. "DNS** records to point the Cactus Comments' client domain to the Matrix "

  114. "server."

  115. msgstr ""

  116. 

  117. #: ../../../docs/configuring-playbook-cactus-comments.md:60

  118. msgid "See [Configuring DNS](configuring-dns.md) for details about DNS changes."

  119. msgstr ""

  120. 

  121. #: ../../../docs/configuring-playbook-cactus-comments.md:62

  122. msgid ""

  123. "If you've decided to use the default hostname, you won't need to do any "

  124. "extra DNS configuration."

  125. msgstr ""

  126. 

  127. #: ../../../docs/configuring-playbook-cactus-comments.md:64

  128. msgid "Installing"

  129. msgstr ""

  130. 

  131. #: ../../../docs/configuring-playbook-cactus-comments.md:66

  132. msgid ""

  133. "After configuring the playbook and potentially [adjusting your DNS "

  134. "records](#adjusting-dns-records), run the playbook with [playbook tags"

  135. "](playbook-tags.md) as below:"

  136. msgstr ""

  137. 

  138. #: ../../../docs/configuring-playbook-cactus-comments.md:73

  139. msgid "**Notes**:"

  140. msgstr ""

  141. 

  142. #: ../../../docs/configuring-playbook-cactus-comments.md:75

  143. msgid ""

  144. "The `ensure-matrix-users-created` playbook tag makes the playbook "

  145. "automatically create the bot's user account."

  146. msgstr ""

  147. 

  148. #: ../../../docs/configuring-playbook-cactus-comments.md:77

  149. msgid ""

  150. "The shortcut commands with the [`just` program](just.md) are also "

  151. "available: `just install-all` or `just setup-all`"

  152. msgstr ""

  153. 

  154. #: ../../../docs/configuring-playbook-cactus-comments.md:79

  155. msgid ""

  156. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "

  157. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"

  158. "runtime) than `just setup-all`) when its components remain unchanged. If "

  159. "you adjust your `vars.yml` to remove other components, you'd need to run "

  160. "`just setup-all`, or these components will still remain installed."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-cactus-comments.md:81

  164. msgid "Usage"

  165. msgstr ""

  166. 

  167. #: ../../../docs/configuring-playbook-cactus-comments.md:83

  168. msgid ""

  169. "Upon starting Cactus Comments, a `bot.cactusbot` user account is created "

  170. "automatically."

  171. msgstr ""

  172. 

  173. #: ../../../docs/configuring-playbook-cactus-comments.md:85

  174. msgid ""

  175. "To get started, send a `help` message to the `@bot.cactusbot:example.com`"

  176. " bot to confirm it's working."

  177. msgstr ""

  178. 

  179. #: ../../../docs/configuring-playbook-cactus-comments.md:87

  180. msgid ""

  181. "Then, register a site by sending `register <YourSiteName>` (where "

  182. "`<YourSiteName>` is a unique identifier you choose. It does not have to "

  183. "match your domain). You will then be invited into a moderation room."

  184. msgstr ""

  185. 

  186. #: ../../../docs/configuring-playbook-cactus-comments.md:89

  187. msgid "Now you are good to go and can embed the comment section on your website!"

  188. msgstr ""

  189. 

  190. #: ../../../docs/configuring-playbook-cactus-comments.md:91

  191. msgid "Embed Cactus Comments"

  192. msgstr ""

  193. 

  194. #: ../../../docs/configuring-playbook-cactus-comments.md:93

  195. msgid ""

  196. "The official [documentation](https://cactus.chat/docs/getting-started"

  197. "/quick-start/) provides a useful guide to embed Cactus Comments on your "

  198. "website."

  199. msgstr ""

  200. 

  201. #: ../../../docs/configuring-playbook-cactus-comments.md:95

  202. msgid ""

  203. "After including the JavaScript and CSS asset files, insert a `<div>` "

  204. "where you'd like to display the comment section:"

  205. msgstr ""

  206. 

  207. #: ../../../docs/configuring-playbook-cactus-comments.md:101

  208. msgid ""

  209. "Then, you need to initialize the comment section. Make sure to replace "

  210. "`example.com` with your base domain and `<YourSiteName>` with the one "

  211. "that has been registered above:"

  212. msgstr ""

  213. 

  214. #: ../../../docs/configuring-playbook-cactus-comments.md:115

  215. msgid "Adjust the domain name for self-hosting"

  216. msgstr ""

  217. 

  218. #: ../../../docs/configuring-playbook-cactus-comments.md:117

  219. msgid ""

  220. "To have the assets served from your homeserver (not from `cactus.chat`), "

  221. "you need to adjust the domain name on the official documentation."

  222. msgstr ""

  223. 

  224. #: ../../../docs/configuring-playbook-cactus-comments.md:119

  225. msgid ""

  226. "Make sure to replace `example.com` with your base domain before you "

  227. "include the following lines, instead of the one provided by the official "

  228. "documentation:"

  229. msgstr ""

  230. 

  231. #: ../../../docs/configuring-playbook-cactus-comments.md:126

  232. msgid ""

  233. "**Note**: if the `matrix_cactus_comments_client_hostname` and "

  234. "`matrix_cactus_comments_client_path_prefix` variables are tweaked, you "

  235. "would need to adjust the URLs of the assets accordingly."

  236. msgstr ""