commit 332e28b9b8dc95f8136e44b7891c5cba5722b0a3
parent 5374426a4c37ecca08bf419cc7be27f27bc601ea
Author: default <nobody@localhost>
Date: Fri, 28 Feb 2025 09:49:41 +0100
Updated documentation.
Diffstat:
1 file changed, 26 insertions(+), 0 deletions(-)
diff --git a/doc/snac.8 b/doc/snac.8
@@ -620,6 +620,32 @@ hashtags.
Please take note that subscribing to relays can increase the traffic towards your instance
significantly. In any case, lowering the "Maximum days to keep posts" value for the relay
special user is recommended (e.g. setting to just 1 day).
+.Ss Web interface language
+Since version 2.73, the web UI can be localized via simple .po files (they are directly
+parsed, no support for gettext is needed).
+.Pp
+No language file is installed by default; the administrator must copy any desired .po files
+to the
+.Pa lang/
+subdirectory in the base directory. Once the server is restarted, users can select the
+new language from the user settings. The
+.Nm
+source distribution may include .po files in the
+.Pa po/
+subdirectory. You don't need to copy the English language one, as it's the default.
+.Pp
+To create new language files, create a copy of
+.Pa en.po ,
+rename it to a reasonable value like
+.Pa pl.po
+or
+.Pa pt_BR.po ,
+change the translator to yourself and fill the msgstr strings with your translation. If
+you have any doubt on how to modify .po files, there are many tutorials out there.
+If you want your language file to be included in the standard
+.Nm
+distribution, please send it to me via the Fediverse as an attachment to @grunfink@comam.es
+or make a PR via the Git repository.
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev DEBUG
