indymedia
/
epicyon
mirror of https://gitlab.com/bashrc2/epicyon
7
4
Fork 1
Code Issues 14 Releases Wiki Activity

Update manual to document federated blocklists

merge-requests/30/head
Bob Mottram 2024-02-10 13:15:02 +00:00
parent 0e82d56cd0
commit 0c218cb2d4
3 changed files with 96 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
manual/manual.epub
View File

Binary file not shown.

60
manual/manual.html
View File

@ -870,14 +870,58 @@ why you blocked someone. Such as:</p>
sealion@endlessreplies.net Another bad faith &quot;debater&quot;</code></pre> sealion@endlessreplies.net Another bad faith &quot;debater&quot;</code></pre>
<p>Be sure to select <strong>Publish</strong> to finalize your <p>Be sure to select <strong>Publish</strong> to finalize your
settings.</p> settings.</p>
<h3 id="replacing-words">Replacing words</h3> <h3 id="federated-blocklists">Federated blocklists</h3>
<p>Sometimes you may want to replace words within received posts. This <p>If you have the admin or moderator role then there is a section
can be for added clarity, to dissipate annoyance or just for fun.</p> within <strong>Filtering and blocking</strong> called <strong>Blocking
<p>From the main timeline select the top banner to go to your profile, API endpoints</strong>. This can be used to subscribe to remote
then select the <strong>edit</strong> icon. Open the <strong>Filtering blocklist URLs, and may be useful in situations where for example you
and blocking</strong> section and then you can specify replacements as have multiple instances set up for an organisation and want them to all
follows:</p> use the same blocklist.</p>
<pre class="text"><code>OldWord -&gt; NewWord <p>Federated blocklists should be a json endpoint accessible via HTTP
GET, and can either be a simple list of strings, where the strings are
blocked account handles or domains:</p>
<pre class="text"><code>[
&quot;@asshat@angrychuds.com&quot;,
&quot;@replyguy@endlessly.replying.net&quot;,
&quot;tedious.domain&quot;
]</code></pre>
<p>Or they can be a list of dictionaries:</p>
<pre class="text"><code>[
{
&#39;id&#39;: 123,
&#39;username&#39;: &#39;@asshat@angrychuds.com&#39;,
&#39;email&#39;: &#39;null&#39;,
&#39;status&#39;: &#39;block&#39;,
&#39;created_at&#39;: None,
&#39;updated_at&#39;: None
},
{
&#39;id&#39;: 124,
&#39;username&#39;: &#39;@replyguy@endlessly.replying.net&#39;,
&#39;email&#39;: &#39;null&#39;,
&#39;status&#39;: &#39;block&#39;,
&#39;created_at&#39;: None,
&#39;updated_at&#39;: None
},
{
&#39;id&#39;: 125,
&#39;username&#39;: &#39;@tedious.domain&#39;,
&#39;email&#39;: &#39;null&#39;,
&#39;status&#39;: &#39;block&#39;,
&#39;created_at&#39;: None,
&#39;updated_at&#39;: None
}
]
``
**Caution:** When subscribing to a federated blocklist you need to have a high degree of trust in the people maintaining it. If they turn out to be untrustworthy or malevolent then they can potentially render your instance useless by blocking all your followed domains.
### Replacing words
Sometimes you may want to replace words within received posts. This can be for added clarity, to dissipate annoyance or just for fun.
From the main timeline select the top banner to go to your profile, then select the **edit** icon. Open the **Filtering and blocking** section and then you can specify replacements as follows:
```text
OldWord -&gt; NewWord
original phrase -&gt; new phrase</code></pre> original phrase -&gt; new phrase</code></pre>
<p>These replacements are subjective, such that if you <p>These replacements are subjective, such that if you
boost/repeat/announce a post then the original wording will be retained boost/repeat/announce a post then the original wording will be retained

44
manual/manual.md
View File

@ -637,6 +637,50 @@ sealion@endlessreplies.net Another bad faith "debater"
Be sure to select **Publish** to finalize your settings. Be sure to select **Publish** to finalize your settings.
### Federated blocklists
If you have the admin or moderator role then there is a section within **Filtering and blocking** called **Blocking API endpoints**. This can be used to subscribe to remote blocklist URLs, and may be useful in situations where for example you have multiple instances set up for an organisation and want them to all use the same blocklist.
Federated blocklists should be a json endpoint accessible via HTTP GET, and can either be a simple list of strings, where the strings are blocked account handles or domains:
``` text
[
"@asshat@angrychuds.com",
"@replyguy@endlessly.replying.net",
"tedious.domain"
]
```
Or they can be a list of dictionaries:
``` text
[
{
'id': 123,
'username': '@asshat@angrychuds.com',
'email': 'null',
'status': 'block',
'created_at': None,
'updated_at': None
},
{
'id': 124,
'username': '@replyguy@endlessly.replying.net',
'email': 'null',
'status': 'block',
'created_at': None,
'updated_at': None
},
{
'id': 125,
'username': '@tedious.domain',
'email': 'null',
'status': 'block',
'created_at': None,
'updated_at': None
}
]
``
**Caution:** When subscribing to a federated blocklist you need to have a high degree of trust in the people maintaining it. If they turn out to be untrustworthy or malevolent then they can potentially render your instance useless by blocking all your followed domains.
### Replacing words ### Replacing words
Sometimes you may want to replace words within received posts. This can be for added clarity, to dissipate annoyance or just for fun. Sometimes you may want to replace words within received posts. This can be for added clarity, to dissipate annoyance or just for fun.