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
451 MiB
 
 
 
Tree: c51e771d1a
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'c51e771d1a'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-cactus...

239 lines
7.9 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: bg\n"

  17. "Language-Team: bg <LL@li.org>\n"

  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"

  19. "MIME-Version: 1.0\n"

  20. "Content-Type: text/plain; charset=utf-8\n"

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

  22. "Generated-By: Babel 2.16.0\n"

  23. 

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

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

  26. msgstr ""

  27. 

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

  29. msgid ""

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

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

  32. msgstr ""

  33. 

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

  35. msgid ""

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

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

  38. msgstr ""

  39. 

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

  41. msgid ""

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

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

  44. "to you."

  45. msgstr ""

  46. 

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

  48. msgid ""

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

  50. "Cactus Comments system:"

  51. msgstr ""

  52. 

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

  54. msgid ""

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

  56. "Matrix homeserver"

  57. msgstr ""

  58. 

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

  60. msgid ""

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

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

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

  64. msgstr ""

  65. 

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

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

  68. msgstr ""

  69. 

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

  71. msgid "Configuration"

  72. msgstr ""

  73. 

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

  75. msgid ""

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

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

  78. msgstr ""

  79. 

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

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

  82. msgstr ""

  83. 

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

  85. msgid ""

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

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

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

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

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

  91. msgstr ""

  92. 

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

  94. msgid ""

  95. "By tweaking the `matrix_cactus_comments_client_hostname` and "

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

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

  98. "the default one."

  99. msgstr ""

  100. 

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

  102. msgid ""

  103. "Example additional configuration for your "

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

  105. msgstr ""

  106. 

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

  108. msgid "Adjusting DNS records"

  109. msgstr ""

  110. 

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

  112. msgid ""

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

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

  115. "server."

  116. msgstr ""

  117. 

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

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

  120. msgstr ""

  121. 

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

  123. msgid ""

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

  125. "extra DNS configuration."

  126. msgstr ""

  127. 

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

  129. msgid "Installing"

  130. msgstr ""

  131. 

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

  133. msgid ""

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

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

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

  137. msgstr ""

  138. 

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

  140. msgid "**Notes**:"

  141. msgstr ""

  142. 

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

  144. msgid ""

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

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

  147. msgstr ""

  148. 

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

  150. msgid ""

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

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

  153. msgstr ""

  154. 

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

  156. msgid ""

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

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

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

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

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

  162. msgstr ""

  163. 

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

  165. msgid "Usage"

  166. msgstr ""

  167. 

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

  169. msgid ""

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

  171. "automatically."

  172. msgstr ""

  173. 

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

  175. msgid ""

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

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

  178. msgstr ""

  179. 

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

  181. msgid ""

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

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

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

  185. msgstr ""

  186. 

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

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

  189. msgstr ""

  190. 

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

  192. msgid "Embed Cactus Comments"

  193. msgstr ""

  194. 

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

  196. msgid ""

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

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

  199. "website."

  200. msgstr ""

  201. 

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

  203. msgid ""

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

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

  206. msgstr ""

  207. 

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

  209. msgid ""

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

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

  212. "that has been registered above:"

  213. msgstr ""

  214. 

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

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

  217. msgstr ""

  218. 

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

  220. msgid ""

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

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

  223. msgstr ""

  224. 

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

  226. msgid ""

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

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

  229. "documentation:"

  230. msgstr ""

  231. 

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

  233. msgid ""

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

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

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

  237. msgstr ""