commit fd424dc

default  ·  2024-03-26 17:56:33 +0000 UTC
parent a453c01
Updated documentation.
1 files changed,  +21, -0
+21, -0
 1@@ -230,6 +230,27 @@ for details. Further, every user can have a private CSS file in their
 2 that will be served instead of the server-wide one.
 3 It's not modifiable from the web interface to avoid users
 4 shooting themselves in the foot by destroying everything.
 5+.Ss Custom Emojis
 6+From version 2.51, support for customized Emojis in posts is available
 7+(previously, they were hardcoded). Emojis are read from the
 8+.Pa emojis.json
 9+file in the instance base directory, as a JSON object of key / value
10+pairs (if this file does not exist, it will be created with
11+the predefined set). Each key in the object contains the text to be found (e.g.,
12+the :-) for a smiling face), and its associated value, the text string that
13+will replace it (in this example case, the HTML entity for the Unicode codepoint
14+for the smiley or the Emoji itself as text).
15+.Pp
16+Emoji values can also be URLs to image files; in this case, they will not be
17+substituted in the post content, but added to the 'tag' array as an ActivityPub
18+standard 'Emoji' object (it's recommendable that the Emoji key be enclosed in
19+colons for maximum compatilibity with other ActivityPub implementations, like
20+e.g. :happydoggo:). These images can be served from an external source or from the
21+.Pa static
22+directory of the instance admin.
23+.Pp
24+If you want to disable any Emoji substitution, leave it as a 0 byte file
25+or with an empty JSON object ({}).
26 .Ss SPAM Mitigation
27 There have been some SPAM attacks on the Fediverse and, as too many
28 instances and server implementations out there still allow automatic