mirror
/
funkwhale
kopia lustrzana https://dev.funkwhale.audio/funkwhale/funkwhale
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność

Multi lang docs

1373-login-form-move-reset-your-password-link
Georg Krause 2022-04-26 12:04:02 +00:00
rodzic 380858dfb2
commit 9045cbbd3f
155 zmienionych plików z 24615 dodań i 8 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

1
changes/changelog.d/multi-language.doc 100644
Wyświetl plik

@ -0,0 +1 @@
Add ability to translate documentation into multiple languages

2
docs/.gitignore vendored 100644
Wyświetl plik

@ -0,0 +1,2 @@
.doctrees/
_panels_static/

16
docs/_static/css/translation-hint.css vendored 100644
Wyświetl plik

@ -0,0 +1,16 @@
#translation-closer {
float: right;
}
.translation-hint {
position: fixed;
z-index: 999;
bottom: 20px;
right: 20px;
background-color: #c9c9c9;
padding: 20px;
}
.translation-hint h1 {
font-size: 20px;
}

7
docs/_static/js/translation-hint.js vendored 100644
Wyświetl plik

@ -0,0 +1,7 @@
hideTranslationHint = function() {
document.getElementsByClassName("translation-hint")[0].style.display = "none"
}
window.onload = function() {
document.getElementById("translation-closer").addEventListener("click", hideTranslationHint);
}

10
docs/_templates/layout.html vendored
Wyświetl plik

@ -2,6 +2,16 @@
{% block document %}
{% if language is not none %}
<div class="translation-hint">
<i class="fa fa-times" id="translation-closer" aria-hidden="true"></i>
<h1>Something wrong with the translation?</h1>
<p>Help us to improve it on our <a href="
https://translate.funkwhale.audio/projects/documentation/{{ pagename |
replace("/", "-") }}" target="_blank">translation platform</a></p>
</div>
{% endif %}
{% if current_version and current_version.name == "develop" %}
<div class="admonition warning">
<p class="admonition-title">Warning</p>

20
docs/build_docs.sh
Wyświetl plik

@ -1,6 +1,24 @@
#!/bin/bash -eux
# Building sphinx and swagger docs
# We clean up translations, only fully translated components are kept
IFS=$'\n'
for i in $(poetry run sphinx-intl stat); do
echo "$i"
if [[ "$i" != *" 0 untranslated." ]]; then
file=$(echo $i | cut -d: -f1)
echo "delete $file"
rm $file
fi
done
# Build sphinx
poetry run sphinx-multiversion . $BUILD_PATH
for d in $(ls locales); do
if [[ $d != "gettext" ]]; then
poetry run sphinx-multiversion -D language="$d" . $BUILD_PATH/$d
fi
done
# Build swagger
TARGET_PATH="$BUILD_PATH/swagger" ./build_swagger.sh
python ./get-releases-json.py > $BUILD_PATH/releases.json
python ./get-releases-json.py --latest > $BUILD_PATH/latest.txt

13
docs/conf.py
Wyświetl plik

@ -20,7 +20,6 @@
import os
import sys
import datetime
import subprocess
sys.path.insert(0, os.path.abspath("../api"))
sys.path.insert(0, os.path.abspath("../api/config"))
@ -131,7 +130,13 @@ html_favicon = "../front/public/favicon.png"
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
# html_static_path = ["_static"]
html_static_path = ["_static"]
html_css_files = [
"css/translation-hint.css",
]
html_js_files = [
"js/translation-hint.js",
]
# -- Options for HTMLHelp output ------------------------------------------
@ -284,3 +289,7 @@ def setup(app):
smv_tag_whitelist = None
smv_branch_whitelist = r"(stable|develop)$"
# Internationalization settings
locale_dirs = ["locales/"]
gettext_compact = False

84
docs/locales/en_GB/LC_MESSAGES/admin/backup.po 100644
Wyświetl plik

@ -0,0 +1,84 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
"Language: en_GB\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/backup.rst:2
msgid "Backup your Funkwhale instance"
msgstr ""
#: ../../admin/backup.rst:6
msgid "Before upgrading your instance, we strongly advise you to make at least a database backup. Ideally, you should make a full backup, including the database and the media files."
msgstr ""
#: ../../admin/backup.rst:10
msgid "Docker setup"
msgstr ""
#: ../../admin/backup.rst:12
msgid "If you've followed the setup instructions in :doc:`../installation/docker`, here is the backup path:"
msgstr ""
#: ../../admin/backup.rst:15
msgid "Multi-container installation"
msgstr ""
#: ../../admin/backup.rst:18
#: ../../admin/backup.rst:51
msgid "Backup the database"
msgstr ""
#: ../../admin/backup.rst:20
msgid "On docker setups, you have to ``pg_dumpall`` in container ``funkwhale_postgres_1``:"
msgstr ""
#: ../../admin/backup.rst:27
#: ../../admin/backup.rst:60
msgid "Backup the media files"
msgstr ""
#: ../../admin/backup.rst:29
msgid "To backup docker data volumes, as the volumes are bound mounted to the host, the ``rsync`` way would go like this:"
msgstr ""
#: ../../admin/backup.rst:38
#: ../../admin/backup.rst:70
msgid "Backup the configuration files"
msgstr ""
#: ../../admin/backup.rst:40
msgid "On docker setups, the configuration file is located at the root level:"
msgstr ""
#: ../../admin/backup.rst:48
msgid "Non-docker setup"
msgstr ""
#: ../../admin/backup.rst:53
msgid "On non-docker setups, you have to ``pg_dump`` as user ``postgres``:"
msgstr ""
#: ../../admin/backup.rst:62
msgid "A simple way to backup your media files is to use ``rsync``:"
msgstr ""
#: ../../admin/backup.rst:77
msgid "You may also want to backup your proxy configuration file."
msgstr ""
#: ../../admin/backup.rst:79
msgid "For frequent backups, you may want to use deduplication and compression to keep the backup size low. In this case, a tool like ``borg`` will be more appropriate."
msgstr ""

84
docs/locales/en_US/LC_MESSAGES/admin/backup.po 100644
Wyświetl plik

@ -0,0 +1,84 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
"Language: en_US\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/backup.rst:2
msgid "Backup your Funkwhale instance"
msgstr ""
#: ../../admin/backup.rst:6
msgid "Before upgrading your instance, we strongly advise you to make at least a database backup. Ideally, you should make a full backup, including the database and the media files."
msgstr ""
#: ../../admin/backup.rst:10
msgid "Docker setup"
msgstr ""
#: ../../admin/backup.rst:12
msgid "If you've followed the setup instructions in :doc:`../installation/docker`, here is the backup path:"
msgstr ""
#: ../../admin/backup.rst:15
msgid "Multi-container installation"
msgstr ""
#: ../../admin/backup.rst:18
#: ../../admin/backup.rst:51
msgid "Backup the database"
msgstr ""
#: ../../admin/backup.rst:20
msgid "On docker setups, you have to ``pg_dumpall`` in container ``funkwhale_postgres_1``:"
msgstr ""
#: ../../admin/backup.rst:27
#: ../../admin/backup.rst:60
msgid "Backup the media files"
msgstr ""
#: ../../admin/backup.rst:29
msgid "To backup docker data volumes, as the volumes are bound mounted to the host, the ``rsync`` way would go like this:"
msgstr ""
#: ../../admin/backup.rst:38
#: ../../admin/backup.rst:70
msgid "Backup the configuration files"
msgstr ""
#: ../../admin/backup.rst:40
msgid "On docker setups, the configuration file is located at the root level:"
msgstr ""
#: ../../admin/backup.rst:48
msgid "Non-docker setup"
msgstr ""
#: ../../admin/backup.rst:53
msgid "On non-docker setups, you have to ``pg_dump`` as user ``postgres``:"
msgstr ""
#: ../../admin/backup.rst:62
msgid "A simple way to backup your media files is to use ``rsync``:"
msgstr ""
#: ../../admin/backup.rst:77
msgid "You may also want to backup your proxy configuration file."
msgstr ""
#: ../../admin/backup.rst:79
msgid "For frequent backups, you may want to use deduplication and compression to keep the backup size low. In this case, a tool like ``borg`` will be more appropriate."
msgstr ""

390
docs/locales/gettext/admin/0.17.pot 100644
Wyświetl plik

@ -0,0 +1,390 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/0.17.rst:2
msgid "About Funkwhale 0.17"
msgstr ""
#: ../../admin/0.17.rst:4
msgid "Funkwhale 0.17 is a special version, which contains a lot of breaking changes."
msgstr ""
#: ../../admin/0.17.rst:6
msgid "Before doing the upgrade, please read this document carefully."
msgstr ""
#: ../../admin/0.17.rst:10
msgid "Overview of the changes"
msgstr ""
#: ../../admin/0.17.rst:15
msgid "The what and why are described more thoroughly in this page: https://dev.funkwhale.audio/funkwhale/funkwhale/merge_requests/368"
msgstr ""
#: ../../admin/0.17.rst:17
msgid "To sum it up, this release big completely changes the way audio content is managed in Funkwhale. As you may guess, this has a huge impact on the whole project, because audio is at the core of Funkwhale."
msgstr ""
#: ../../admin/0.17.rst:21
msgid "Here is a side by side comparison of earlier versions and this release to help you understand the scale of the changes:"
msgstr ""
#: ../../admin/0.17.rst:25
msgid "Before"
msgstr ""
#: ../../admin/0.17.rst:25
msgid "After"
msgstr ""
#: ../../admin/0.17.rst:25
msgid "Reason"
msgstr ""
#: ../../admin/0.17.rst:27
msgid "There is one big audio library, managed at the instance level"
msgstr ""
#: ../../admin/0.17.rst:27
msgid "Each user can have their own libraries (either public, private or shared at the instance level)"
msgstr ""
#: ../../admin/0.17.rst:27
msgid "Managing the library at instance was cumbersome and dangerous: sharing an instance library over federation would quickly pose copyright issues, as well as opening public instances. It also made it impossible to only share a subset of the music."
msgstr ""
#: ../../admin/0.17.rst:29
msgid "Users needed a specific permissions from instance owners to upload audio content"
msgstr ""
#: ../../admin/0.17.rst:29
msgid "Users can upload music to their own libraries without any specific permissions"
msgstr ""
#: ../../admin/0.17.rst:29
msgid "This change makes it easier for new users to start using Funkwhale, and for creators to share their content on the network."
msgstr ""
#: ../../admin/0.17.rst:31
msgid "Users with permissions can upload as much content as they want in the instance library"
msgstr ""
#: ../../admin/0.17.rst:31
msgid "Users have a storage quota and cannot exceed that storage"
msgstr ""
#: ../../admin/0.17.rst:31
msgid "This change gives visibiliy to instance owners about their resource usage. If you host 100 users with a 1Gb quota, you know that your Funkwhale instance will not store more than 100Gb of music files."
msgstr ""
#: ../../admin/0.17.rst:33
msgid "N/A"
msgstr ""
#: ../../admin/0.17.rst:33
msgid "Users can upload private content or share content with only specific users"
msgstr ""
#: ../../admin/0.17.rst:33
msgid "This is a new feature, and we think it will enable users to upload their own music libraries to their instance, without breaking the law or putting their admins in trouble, since their media will remain private."
msgstr ""
#: ../../admin/0.17.rst:35
msgid "Youtube Import"
msgstr ""
#: ../../admin/0.17.rst:35
#: ../../admin/0.17.rst:37
msgid "This feature is removed"
msgstr ""
#: ../../admin/0.17.rst:35
msgid "This feature posed copyright issues and impacted the credibility of the project, so we removed it."
msgstr ""
#: ../../admin/0.17.rst:37
msgid "Music requests"
msgstr ""
#: ../../admin/0.17.rst:37
msgid "Since all users can now upload content without specific permissions, we think this feature is less-likely to be useful in its current state."
msgstr ""
#: ../../admin/0.17.rst:41
msgid "From a shared, instance-wide library to users libraries"
msgstr ""
#: ../../admin/0.17.rst:43
msgid "As you can see, there is a big switch: in earlier versions, each instance had one big library, that was available to all its users. This model don't scale well (especially if you put federation on top of that), because it's an all-or-nothing choice if you want to share it."
msgstr ""
#: ../../admin/0.17.rst:47
msgid "Starting from version 0.17, each user will be able to create personal libraries and upload content in those, up to a configurable quota."
msgstr ""
#: ../../admin/0.17.rst:50
msgid "Those libraries can have one of the following visibility level:"
msgstr ""
#: ../../admin/0.17.rst:52
msgid "**Private**: only the owner of the library can access its content"
msgstr ""
#: ../../admin/0.17.rst:53
msgid "**Instance**: users from the same instance can access the library content"
msgstr ""
#: ../../admin/0.17.rst:54
msgid "**Public**: everyone (including other instances) can access the library content"
msgstr ""
#: ../../admin/0.17.rst:56
msgid "Regardless of this visibility level, library owners can also share them manually with other users, both from the same instance or from the federation."
msgstr ""
#: ../../admin/0.17.rst:59
msgid "We think this change will have a really positive impact:"
msgstr ""
#: ../../admin/0.17.rst:61
msgid "Admins should be more inclined to open their instance to strangers, because copyrighted media can be upload and shared privately"
msgstr ""
#: ../../admin/0.17.rst:63
msgid "Creators should have a better experience when joining the network, because they can now upload their own content and share it over the federation without any admin intervention"
msgstr ""
#: ../../admin/0.17.rst:65
msgid "The federation should grow faster, because user libraries can contain copyrighted content and be shared, without putting the admins at risk"
msgstr ""
#: ../../admin/0.17.rst:69
msgid "Accessing music"
msgstr ""
#: ../../admin/0.17.rst:71
msgid "From an end-user perspective, you will be able to browse any artist or album or track that is known by your instance, but you'll only be able to listen to content that match one of those criteria:"
msgstr ""
#: ../../admin/0.17.rst:75
msgid "The content is available is one of your libraries"
msgstr ""
#: ../../admin/0.17.rst:76
msgid "The content is available in a public library"
msgstr ""
#: ../../admin/0.17.rst:77
msgid "The content is available in one library from your instance that has a visibility level set to \"instance\""
msgstr ""
#: ../../admin/0.17.rst:78
msgid "The content is available in one of the libraries you follow"
msgstr ""
#: ../../admin/0.17.rst:80
msgid "Following someone else's library is a four step process:"
msgstr ""
#: ../../admin/0.17.rst:82
msgid "Get the library link from its owner"
msgstr ""
#: ../../admin/0.17.rst:83
msgid "Use this link on your instance to follow the library"
msgstr ""
#: ../../admin/0.17.rst:84
msgid "Wait until your follow request is approved by the library owner"
msgstr ""
#: ../../admin/0.17.rst:85
msgid "If this library is unknown on your instance, it will be scanned to import its content, which may take a few minutes"
msgstr ""
#: ../../admin/0.17.rst:87
msgid "Libraries owner can revoke follows at any time, which will effectively prevent the ancient follower from accessing the library content."
msgstr ""
#: ../../admin/0.17.rst:91
msgid "A brand new federation"
msgstr ""
#: ../../admin/0.17.rst:93
msgid "This is more \"under the hood\" work, but the whole federation/ActivityPub logic was rewritten for this release. This new implementation is more spec compliant and should scale better."
msgstr ""
#: ../../admin/0.17.rst:97
msgid "The following activities are propagated over federation:"
msgstr ""
#: ../../admin/0.17.rst:99
msgid "Library follow creation, accept and reject"
msgstr ""
#: ../../admin/0.17.rst:100
msgid "Audio creation and deletion"
msgstr ""
#: ../../admin/0.17.rst:101
msgid "Library deletion"
msgstr ""
#: ../../admin/0.17.rst:104
msgid "A better import UI"
msgstr ""
#: ../../admin/0.17.rst:106
msgid "This version includes a completely new import UI which should make file uploading less annoying. In particular, the UI updates in real-time and has a better error reporting."
msgstr ""
#: ../../admin/0.17.rst:111
msgid "A better import engine"
msgstr ""
#: ../../admin/0.17.rst:113
msgid "Funkwhale is known for its quircks during music import. Missing covers, split albums, bad management of tracks with multiple artists, missing data for files imported over federation, bad performance, discrepancies between the user-provided tags and what is actually stored in the database..."
msgstr ""
#: ../../admin/0.17.rst:118
msgid "This should be greatly improved now, as the whole import logic was rewritten from scratch."
msgstr ""
#: ../../admin/0.17.rst:121
msgid "Import is done completely offline and no longer calls the MusicBrainz API, except to retrieve covers if those are not embedded in the imported files. MusicBrainz references are still stored in the database, but we rely solely on the tags from the audio file now."
msgstr ""
#: ../../admin/0.17.rst:126
msgid "This has two positive consequences:"
msgstr ""
#: ../../admin/0.17.rst:128
msgid "Improved performance for both small and big imports (possibly by a factor of 10)"
msgstr ""
#: ../../admin/0.17.rst:129
msgid "More reliable import result: if your file is tagged in a specific way, we will only use tags for the import."
msgstr ""
#: ../../admin/0.17.rst:132
msgid "Imports from federation, command-line and UI/API all use the same code, which should greatly reduce the bugs/discrepencies."
msgstr ""
#: ../../admin/0.17.rst:135
msgid "Finally, the import engine now understands the difference between a track artist and an album artist, which should put an end to the album splitting issues for tracks that had a different artist than the album artist."
msgstr ""
#: ../../admin/0.17.rst:140
msgid "What will break"
msgstr ""
#: ../../admin/0.17.rst:142
msgid "If you've read until here, you can probably understand that all of these changes comes at a cost: version 0.17 contains breaking changes, removed features and other changes."
msgstr ""
#: ../../admin/0.17.rst:146
msgid "The following features were removed:"
msgstr ""
#: ../../admin/0.17.rst:148
msgid "YouTube imports: for copyright reasons, keeping this in the core was not possible"
msgstr ""
#: ../../admin/0.17.rst:149
msgid "Music requests: those are now less useful since anyone can upload content"
msgstr ""
#: ../../admin/0.17.rst:151
msgid "Also, the current federation will break, as it's absolutely not compatible with what we've built in version 0.17, and maintaining compatibility was simply not possible."
msgstr ""
#: ../../admin/0.17.rst:154
msgid "Apart from that, other features should work the same way as they did before."
msgstr ""
#: ../../admin/0.17.rst:157
msgid "Migration path"
msgstr ""
#: ../../admin/0.17.rst:161
msgid "This migration is huge. Do a backup. Please. The database, and the music files. Please."
msgstr ""
#: ../../admin/0.17.rst:164
msgid "I'm not kidding."
msgstr ""
#: ../../admin/0.17.rst:167
msgid "Migration will be similar to previous ones, with an additional script to run that will take care of updating existing rows in the database. Especially, this script will be responsible to create a library for each registered user, and to bind content imported by each one to this library."
msgstr ""
#: ../../admin/0.17.rst:172
msgid "Libraries created this way will have a different visibility level depending of your instance configuration:"
msgstr ""
#: ../../admin/0.17.rst:174
msgid "If your instance requires authentication to access the API / listen to music, libraries will be marked with \"instance\" visibility. As a result, all users from the instance will still be able to listen to all the music of the instance after the migration"
msgstr ""
#: ../../admin/0.17.rst:177
msgid "If your instance does not require authentication to access the API / listen to music, libraries will be completely public, allowing anyone to access the content (including federation)"
msgstr ""
#: ../../admin/0.17.rst:180
msgid "This script will also contain other database-related operations, but the impact will remain invisible."
msgstr ""
#: ../../admin/0.17.rst:185
msgid "Upgrade instructions"
msgstr ""
#: ../../admin/0.17.rst:187
msgid "Follow instructions from https://docs.funkwhale.audio/upgrading/index.html, then run the migrations script."
msgstr ""
#: ../../admin/0.17.rst:190
msgid "On docker-setups::"
msgstr ""
#: ../../admin/0.17.rst:196
msgid "On non docker-setups::"
msgstr ""
#: ../../admin/0.17.rst:202
msgid "If the scripts complete without errors, your instance should be updated and ready to use :)"
msgstr ""
#: ../../admin/0.17.rst:206
msgid "If you use nginx, ensure your funkwhale_proxy.conf file does not contain this:"
msgstr ""
#: ../../admin/0.17.rst:208
msgid "proxy_set_header X-Forwarded-Host $host:$server_port;"
msgstr ""
#: ../../admin/0.17.rst:210
msgid "If you have this line present, replace it with:"
msgstr ""
#: ../../admin/0.17.rst:212
msgid "proxy_set_header X-Forwarded-Host $host;"
msgstr ""
#: ../../admin/0.17.rst:214
msgid "And reload your nginx server."
msgstr ""

84
docs/locales/gettext/admin/backup.pot 100644
Wyświetl plik

@ -0,0 +1,84 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/backup.rst:2
msgid "Backup your Funkwhale instance"
msgstr ""
#: ../../admin/backup.rst:6
msgid "Before upgrading your instance, we strongly advise you to make at least a database backup. Ideally, you should make a full backup, including the database and the media files."
msgstr ""
#: ../../admin/backup.rst:10
msgid "Docker setup"
msgstr ""
#: ../../admin/backup.rst:12
msgid "If you've followed the setup instructions in :doc:`../installation/docker`, here is the backup path:"
msgstr ""
#: ../../admin/backup.rst:15
msgid "Multi-container installation"
msgstr ""
#: ../../admin/backup.rst:18
#: ../../admin/backup.rst:51
msgid "Backup the database"
msgstr ""
#: ../../admin/backup.rst:20
msgid "On docker setups, you have to ``pg_dumpall`` in container ``funkwhale_postgres_1``:"
msgstr ""
#: ../../admin/backup.rst:27
#: ../../admin/backup.rst:60
msgid "Backup the media files"
msgstr ""
#: ../../admin/backup.rst:29
msgid "To backup docker data volumes, as the volumes are bound mounted to the host, the ``rsync`` way would go like this:"
msgstr ""
#: ../../admin/backup.rst:38
#: ../../admin/backup.rst:70
msgid "Backup the configuration files"
msgstr ""
#: ../../admin/backup.rst:40
msgid "On docker setups, the configuration file is located at the root level:"
msgstr ""
#: ../../admin/backup.rst:48
msgid "Non-docker setup"
msgstr ""
#: ../../admin/backup.rst:53
msgid "On non-docker setups, you have to ``pg_dump`` as user ``postgres``:"
msgstr ""
#: ../../admin/backup.rst:62
msgid "A simple way to backup your media files is to use ``rsync``:"
msgstr ""
#: ../../admin/backup.rst:77
msgid "You may also want to backup your proxy configuration file."
msgstr ""
#: ../../admin/backup.rst:79
msgid "For frequent backups, you may want to use deduplication and compression to keep the backup size low. In this case, a tool like ``borg`` will be more appropriate."
msgstr ""

150
docs/locales/gettext/admin/commands.pot 100644
Wyświetl plik

@ -0,0 +1,150 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/commands.rst:2
msgid "Management commands"
msgstr ""
#: ../../admin/commands.rst:5
msgid "User management"
msgstr ""
#: ../../admin/commands.rst:7
msgid "It's possible to create, remove and update users directly from the command line."
msgstr ""
#: ../../admin/commands.rst:9
msgid "This feature is useful if you want to experiment, automate or perform batch actions that would be too repetitive through the web UI."
msgstr ""
#: ../../admin/commands.rst:12
msgid "All users-related commands are available under the ``python manage.py fw users`` namespace:"
msgstr ""
#: ../../admin/commands.rst:21
msgid "Creation"
msgstr ""
#: ../../admin/commands.rst:38
msgid "Additional options are available to further configure the user during creation, such as setting permissions or user quota. Please refer to the command help."
msgstr ""
#: ../../admin/commands.rst:43
msgid "Update"
msgstr ""
#: ../../admin/commands.rst:73
msgid "Deletion"
msgstr ""
#: ../../admin/commands.rst:93
msgid "Pruning library"
msgstr ""
#: ../../admin/commands.rst:95
msgid "Because Funkwhale is a multi-user and federated audio server, we don't delete any artist, album and track objects in the database when you delete the corresponding files."
msgstr ""
#: ../../admin/commands.rst:98
msgid "This is on purpose, because those objects may be referenced in user playlists, favorites, listening history or on other instances, or other users could have upload files matching linked to those entities in their own private libraries."
msgstr ""
#: ../../admin/commands.rst:102
msgid "Therefore, Funkwhale has a really conservative approach and doesn't delete metadata when audio files are deleted."
msgstr ""
#: ../../admin/commands.rst:105
msgid "This behaviour can be problematic in some situations though, e.g. if you imported a lot of wrongly tagged files, then deleted the files to reimport them later."
msgstr ""
#: ../../admin/commands.rst:108
msgid "To help with that, we provide a management you can run on the server and that will effectively prune you library from track, album and artist metadata that is not tied to any file:"
msgstr ""
#: ../../admin/commands.rst:128
msgid "The ``prune_library`` command will not delete anything by default, and only gives you an estimate of how many database objects would be affected by the pruning."
msgstr ""
#: ../../admin/commands.rst:131
msgid "Once you have reviewed the output and are comfortable with the changes, you should rerun the command with the ``--no-dry-run`` flag to disable dry run mode and actually apply the changes on the database."
msgstr ""
#: ../../admin/commands.rst:137
#: ../../admin/commands.rst:169
msgid "Running this command with ``--no-dry-run`` is irreversible. Unless you have a backup, there will be no way to retrieve the deleted data."
msgstr ""
#: ../../admin/commands.rst:142
msgid "The command will exclude tracks that are favorited, included in playlists or listening history by default. If you want to include those in the pruning process as well, add the corresponding ``--ignore-favorites``, ``--ignore-playlists`` and ``--ignore-listenings`` flags."
msgstr ""
#: ../../admin/commands.rst:148
msgid "Remove obsolete files from database"
msgstr ""
#: ../../admin/commands.rst:150
msgid "When importing using the :ref:`in-place method <in-place-import>`, if you move or remove in-place imported files on disk, Funkwhale will still have a reference to those files and won't be able to serve them properly."
msgstr ""
#: ../../admin/commands.rst:154
msgid "To help with that, whenever you remove or move files that were previously imported with the ``--in-place`` flag, you can run the following command::"
msgstr ""
#: ../../admin/commands.rst:159
msgid "This command will loop through all the database objects that reference an in-place imported file, check that the file is accessible on disk, or delete the database object if it's not."
msgstr ""
#: ../../admin/commands.rst:163
msgid "Once you have reviewed the output and are comfortable with the changes, you should rerun the command with the ``--no-dry-run`` flag to disable dry run mode and actually delete the database objects."
msgstr ""
#: ../../admin/commands.rst:173
msgid "Adding tags from tracks"
msgstr ""
#: ../../admin/commands.rst:175
msgid "By default, genre tags found imported files are associated with the corresponding track."
msgstr ""
#: ../../admin/commands.rst:177
msgid "While you can always associate genre information with an artist or album through the web UI, it may be tedious to do so by hand for a large number of objects."
msgstr ""
#: ../../admin/commands.rst:180
msgid "We offer a command you can run after an import to do this for you. It will:"
msgstr ""
#: ../../admin/commands.rst:182
msgid "Find all local artists or albums with no tags"
msgstr ""
#: ../../admin/commands.rst:183
msgid "Get all the tags associated with the corresponding tracks"
msgstr ""
#: ../../admin/commands.rst:184
msgid "Associate tags that are found on all tracks to the corresponding artist or album"
msgstr ""
#: ../../admin/commands.rst:186
msgid "..note::"
msgstr ""
#: ../../admin/commands.rst:190
msgid "Usage:"
msgstr ""

706
docs/locales/gettext/admin/configuration.pot 100644
Wyświetl plik

@ -0,0 +1,706 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/configuration.rst:2
msgid "Instance configuration"
msgstr ""
#: ../../admin/configuration.rst:4
msgid "General configuration is achieved using two type of settings:"
msgstr ""
#: ../../admin/configuration.rst:6
msgid ":ref:`environment variables <environment-variables>` and"
msgstr ""
#: ../../admin/configuration.rst:7
msgid ":ref:`instance settings <instance-settings>`."
msgstr ""
#: ../../admin/configuration.rst:12
msgid "Environment variables"
msgstr ""
#: ../../admin/configuration.rst:14
msgid "Those are located in your ``.env`` file, which you should have created during installation. A full list of available variables is given :ref:`below <environment-variables>`."
msgstr ""
#: ../../admin/configuration.rst:17
msgid "Options from this file are heavily commented, and usually target lower level and technical aspects of your instance, such as database credentials."
msgstr ""
#: ../../admin/configuration.rst:22
msgid "You should restart all Funkwhale processes when you change the values on environment variables::"
msgstr ""
#: ../../admin/configuration.rst:30
msgid "Some characters are unsafe to use in configuration variables that are URLs, such as the user and password in the database and SMTP sections. If those variables contain such characters, they must be urlencoded, for instance using the following command::"
msgstr ""
#: ../../admin/configuration.rst:37
msgid "See as well https://github.com/joke2k/django-environ#using-unsafe-characters-in-urls"
msgstr ""
#: ../../admin/configuration.rst:42
msgid "Instance settings"
msgstr ""
#: ../../admin/configuration.rst:44
msgid "These settings are stored in the database and do not require a restart of your instance after modification. They typically relate to higher level configuration, such your instance description, signup policy and so on."
msgstr ""
#: ../../admin/configuration.rst:48
msgid "You can edit those settings directly from the web application, assuming you have the required permissions. The URL is ``/manage/settings``, and you will also find a link to this page in the sidebar."
msgstr ""
#: ../../admin/configuration.rst:52
msgid "If you plan to use acoustid and external imports (e.g. with the YouTube backends), you should edit the corresponding settings in this interface."
msgstr ""
#: ../../admin/configuration.rst:58
msgid "If you have any issue with the web application, a management interface is also available for those settings from :doc:`Django's administration interface <django>`. It's less user friendly, though, and we recommend you use the web app interface whenever possible."
msgstr ""
#: ../../admin/configuration.rst:63
msgid "The URL should be ``/api/admin/dynamic_preferences/globalpreferencemodel/`` (prepend your domain in front of it, of course)."
msgstr ""
#: ../../admin/configuration.rst:67
msgid "Configuration reference"
msgstr ""
#: ../../admin/configuration.rst:70
msgid "Pod"
msgstr ""
#: ../../docstring of config.settings.common.FUNKWHALE_HOSTNAME:1
msgid "Hostname of your Funkwhale pod, e.g. ``mypod.audio``"
msgstr ""
#: ../../docstring of config.settings.common.FUNKWHALE_PROTOCOL:1
msgid "Protocol end users will use to access your pod, either ``http`` or ``https``."
msgstr ""
#: ../../admin/configuration.rst:77
msgid "Database and redis"
msgstr ""
#: ../../docstring of config.settings.common.DATABASE_URL:1
msgid "URL to connect to the PostgreSQL database. Examples:"
msgstr ""
#: ../../docstring of config.settings.common.DATABASE_URL:3
msgid "``postgresql://funkwhale@:5432/funkwhale``"
msgstr ""
#: ../../docstring of config.settings.common.DATABASE_URL:4
msgid "``postgresql://<user>:<password>@<host>:<port>/<database>``"
msgstr ""
#: ../../docstring of config.settings.common.DATABASE_URL:5
msgid "``postgresql://funkwhale:passw0rd@localhost:5432/funkwhale_database``"
msgstr ""
#: ../../docstring of config.settings.common.DB_CONN_MAX_AGE:1
msgid "Max time, in seconds, before database connections are closed."
msgstr ""
#: ../../docstring of config.settings.common.CACHE_URL:1
msgid "URL to your redis server. Examples:"
msgstr ""
#: ../../docstring of config.settings.common.CACHE_URL:3
msgid "``redis://<host>:<port>/<database>``"
msgstr ""
#: ../../docstring of config.settings.common.CACHE_URL:4
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:7
msgid "``redis://127.0.0.1:6379/0``"
msgstr ""
#: ../../docstring of config.settings.common.CACHE_URL:5
msgid "``redis://:password@localhost:6379/0``"
msgstr ""
#: ../../docstring of config.settings.common.CACHE_URL:6
msgid "for password auth (the extra semicolon is important) - ``redis:///run/redis/redis.sock?db=0`` over unix sockets"
msgstr ""
#: ../../docstring of config.settings.common.CACHE_URL:11
msgid "If you want to use Redis over unix sockets, you'll also need to update :attr:`CELERY_BROKER_URL`"
msgstr ""
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:1
msgid "URL to celery's task broker. Defaults to :attr:`CACHE_URL`, so you shouldn't have to tweak this, unless you want to use a different one, or use Redis sockets to connect."
msgstr ""
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:5
msgid "Exemple:"
msgstr ""
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:8
msgid "``redis+socket:///run/redis/redis.sock?virtual_host=0``"
msgstr ""
#: ../../admin/configuration.rst:88
msgid "Accounts and registration"
msgstr ""
#: ../../docstring of config.settings.common.ACCOUNT_EMAIL_VERIFICATION_ENFORCE:1
msgid "Determine wether users need to verify their e-mail address before using the service. Enabling this can be useful to reduce spam or bots accounts, however, you'll need to configure a mail server so that your users can receive the verification e-mails, using :attr:`EMAIL_CONFIG`."
msgstr ""
#: ../../docstring of config.settings.common.ACCOUNT_EMAIL_VERIFICATION_ENFORCE:5
#: ../../docstring of config.settings.common.ACCOUNT_EMAIL_VERIFICATION_ENFORCE:7
msgid "Note that regardless of the setting value, superusers created through the command line will never require verification."
msgstr ""
#: ../../docstring of config.settings.common.USERS_INVITATION_EXPIRATION_DAYS:1
msgid "Expiration delay, in days, for user invitations."
msgstr ""
#: ../../docstring of config.settings.common.DISABLE_PASSWORD_VALIDATORS:1
msgid "Wether to disable password validators (length, common words, similarity with username…) used during regitration."
msgstr ""
#: ../../docstring of config.settings.common.ACCOUNT_USERNAME_BLACKLIST:1
msgid "List of usernames that will be unavailable during registration, given as a list of strings."
msgstr ""
#: ../../docstring of config.settings.common.AUTH_LDAP_ENABLED:1
msgid "Wether to enable LDAP authentication."
msgstr ""
#: ../../docstring of config.settings.common.AUTH_LDAP_ENABLED:3
msgid "See :doc:`/installation/ldap` for more information."
msgstr ""
#: ../../admin/configuration.rst:102
msgid "Media storage and serving"
msgstr ""
#: ../../docstring of config.settings.common.MEDIA_URL:1
msgid "URL where media files are served. The default value should work fine on most configurations, but could can tweak this if you are hosting media files on a separate domain, or if you host Funkwhale on a non-standard port."
msgstr ""
#: ../../docstring of config.settings.common.MEDIA_ROOT:1
msgid "Path where media files (such as album covers or audio tracks) are stored on your system. Ensure this directory actually exists."
msgstr ""
#: ../../docstring of config.settings.common.PROXY_MEDIA:1
msgid "Wether to proxy audio files through your reverse proxy. It's recommended to keep this on, as a way to enforce access control, however, if you're using S3 storage with :attr:`AWS_QUERYSTRING_AUTH`, it's safe to disable it."
msgstr ""
#: ../../docstring of config.settings.common.EXTERNAL_MEDIA_PROXY_ENABLED:1
msgid "Wether to proxy attachment files hosted on third party pods and and servers. Keeping this to true is recommended, to reduce leaking browsing information of your users, and reduce the bandwidth used on remote pods."
msgstr ""
#: ../../docstring of config.settings.common.ATTACHMENTS_UNATTACHED_PRUNE_DELAY:1
msgid "Delay in seconds before uploaded but unattached attachements are pruned from the system."
msgstr ""
#: ../../docstring of config.settings.common.REVERSE_PROXY_TYPE:1
msgid "Depending on the reverse proxy used in front of your funkwhale instance, the API will use different kind of headers to serve audio files"
msgstr ""
#: ../../docstring of config.settings.common.REVERSE_PROXY_TYPE:4
msgid "Allowed values: ``nginx``, ``apache2``"
msgstr ""
#: ../../docstring of config.settings.common.PROTECT_FILES_PATH:1
msgid "Which path will be used to process the internal redirection to the reverse proxy **DO NOT** put a slash at the end."
msgstr ""
#: ../../docstring of config.settings.common.PROTECT_FILES_PATH:4
msgid "You shouldn't have to tweak this."
msgstr ""
#: ../../admin/configuration.rst:117
msgid "Audio acquisition"
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:1
msgid "The path on your server where Funkwhale can import files using :ref:`in-place import <in-place-import>`. It must be readable by the webserver and Funkwhale api and worker processes."
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:5
msgid "On docker installations, we recommend you use the default of ``/music`` for this value. For non-docker installation, you can use any absolute path. ``/srv/funkwhale/data/music`` is a safe choice if you don't know what to use."
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:9
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:16
msgid "This path should not include any trailing slash."
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_PATH:13
msgid "You need to adapt your :ref:`reverse proxy configuration <reverse-proxy-setup>` to serve the directory pointed by ``MUSIC_DIRECTORY_PATH`` on ``/_protected/music`` URL."
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:1
msgid "Default: :attr:`MUSIC_DIRECTORY_PATH`"
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:3
msgid "When using Docker, the value of :attr:`MUSIC_DIRECTORY_PATH` in your containers may differ from the real path on your host. Assuming you have the following directive in your :file:`docker-compose.yml` file::"
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:11
msgid "Then, the value of :attr:`MUSIC_DIRECTORY_SERVE_PATH` should be ``/srv/funkwhale/data/music``. This must be readable by the webserver."
msgstr ""
#: ../../docstring of config.settings.common.MUSIC_DIRECTORY_SERVE_PATH:14
msgid "On non-docker setup, you don't need to configure this setting."
msgstr ""
#: ../../admin/configuration.rst:123
msgid "S3 Storage"
msgstr ""
#: ../../docstring of config.settings.common.AWS_QUERYSTRING_AUTH:1
msgid "Whether to include signatures in S3 urls, as a way to enforce access-control."
msgstr ""
#: ../../docstring of config.settings.common.AWS_QUERYSTRING_AUTH:3
msgid "Defaults to the inverse of :attr:`PROXY_MEDIA`."
msgstr ""
#: ../../docstring of config.settings.common.AWS_QUERYSTRING_EXPIRE:1
msgid "Expiration delay, in seconds, of signatures generated when :attr:`AWS_QUERYSTRING_AUTH` is enabled."
msgstr ""
#: ../../docstring of config.settings.common.AWS_ACCESS_KEY_ID:1
msgid "Access-key ID for your S3 storage."
msgstr ""
#: ../../docstring of config.settings.common.AWS_SECRET_ACCESS_KEY:1
msgid "Secret access key for your S3 storage."
msgstr ""
#: ../../docstring of config.settings.common.AWS_STORAGE_BUCKET_NAME:1
msgid "Bucket name of your S3 storage."
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_CUSTOM_DOMAIN:1
msgid "Custom domain to use for your S3 storage."
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:1
msgid "If you use a S3-compatible storage such as minio, set the following variable to the full URL to the storage server. Example:"
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:4
msgid "``https://minio.mydomain.com``"
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:5
msgid "``https://s3.wasabisys.com``"
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:1
msgid "If you are using Amazon S3 to serve media directly, you will need to specify your region name in order to access files."
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:4
#: ../../docstring of config.settings.common.THROTTLING_RATES:5
#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:4
msgid "Example:"
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:6
msgid "``eu-west-2``"
msgstr ""
#: ../../docstring of config.settings.common.AWS_LOCATION:1
msgid "An optional bucket subdirectory were you want to store the files. This is especially useful if you plan to use share the bucket with other services."
msgstr ""
#: ../../admin/configuration.rst:136
msgid "API configuration"
msgstr ""
#: ../../docstring of config.settings.common.THROTTLING_ENABLED:1
msgid "Wether to enable throttling (also known as rate-limiting). Leaving this enabled is recommended especially on public pods, to improve the quality of service."
msgstr ""
#: ../../docstring of config.settings.common.THROTTLING_RATES:1
msgid "Throttling rates for specific endpoints and features of the app. You can tweak this if you are encountering to severe rate limiting issues or, on the contrary, if you want to reduce the consumption on some endpoints."
msgstr ""
#: ../../docstring of config.settings.common.THROTTLING_RATES:7
msgid "``signup=5/d,password-reset=2/d,anonymous-reports=5/d``"
msgstr ""
#: ../../docstring of config.settings.common.ADMIN_URL:1
msgid "Path to the Django admin area."
msgstr ""
#: ../../docstring of config.settings.common.ADMIN_URL:3
msgid "Examples:"
msgstr ""
#: ../../docstring of config.settings.common.ADMIN_URL:5
msgid "``^api/admin/``"
msgstr ""
#: ../../docstring of config.settings.common.ADMIN_URL:6
msgid "``^api/mycustompath/``"
msgstr ""
#: ../../docstring of config.settings.common.EXTERNAL_REQUESTS_VERIFY_SSL:1
msgid "Wether to enforce HTTPS certificates verification when doing outgoing HTTP requests (typically with federation). Disabling this is not recommended."
msgstr ""
#: ../../docstring of config.settings.common.EXTERNAL_REQUESTS_TIMEOUT:1
msgid "Default timeout for external requests."
msgstr ""
#: ../../admin/configuration.rst:145
msgid "Federation"
msgstr ""
#: ../../docstring of config.settings.common.FEDERATION_OBJECT_FETCH_DELAY:1
msgid "Delay, in minutes, before a remote object will be automatically refetched when accessed in the UI."
msgstr ""
#: ../../docstring of config.settings.common.FEDERATION_DUPLICATE_FETCH_DELAY:1
msgid "Delay, in seconds, between two manual fetch of the same remote object."
msgstr ""
#: ../../admin/configuration.rst:151
msgid "Metadata"
msgstr ""
#: ../../docstring of config.settings.common.TAGS_MAX_BY_OBJ:1
msgid "Maximum number of tags that can be associated with an object. Extra tags will be ignored."
msgstr ""
#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:1
msgid "Use this setting to change the MusicBrainz hostname, for instance to use a mirror. The hostname can also contain a port number."
msgstr ""
#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:6
msgid "``mymusicbrainz.mirror``"
msgstr ""
#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:7
msgid "``localhost:5000``"
msgstr ""
#: ../../docstring of config.settings.common.MUSICBRAINZ_CACHE_DURATION:1
msgid "How long to cache MusicBrainz results, in seconds."
msgstr ""
#: ../../admin/configuration.rst:158
msgid "Channels and podcasts"
msgstr ""
#: ../../docstring of config.settings.common.PODCASTS_RSS_FEED_REFRESH_DELAY:1
msgid "Delay, in seconds, between two fetch of RSS feeds."
msgstr ""
#: ../../docstring of config.settings.common.PODCASTS_RSS_FEED_REFRESH_DELAY:3
msgid "Reducing this mean you'll receive new episodes faster, but will require more resources."
msgstr ""
#: ../../docstring of config.settings.common.PODCASTS_RSS_FEED_MAX_ITEMS:1
msgid "Maximum number of RSS items to load in each podcast feed."
msgstr ""
#: ../../docstring of config.settings.common.PODCASTS_THIRD_PARTY_VISIBILITY:1
msgid "By default, only people who subscribe to a podcast RSS will have access to their episodes."
msgstr ""
#: ../../docstring of config.settings.common.PODCASTS_THIRD_PARTY_VISIBILITY:4
msgid "Switch to \"instance\" or \"everyone\" to change that."
msgstr ""
#: ../../docstring of config.settings.common.PODCASTS_THIRD_PARTY_VISIBILITY:6
msgid "Changing it only affect new podcasts."
msgstr ""
#: ../../admin/configuration.rst:165
msgid "Subsonic"
msgstr ""
#: ../../docstring of config.settings.common.SUBSONIC_DEFAULT_TRANSCODING_FORMAT:1
msgid "Default format for transcoding when using Subsonic API."
msgstr ""
#: ../../admin/configuration.rst:170
msgid "Email configuration"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:1
msgid "SMTP configuration for sending e-mails. Possible values:"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:3
msgid "``EMAIL_CONFIG=consolemail://``: output e-mails to console (the default)"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:4
msgid "``EMAIL_CONFIG=dummymail://``: disable e-mail sending completely"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:6
msgid "On a production instance, you'll usually want to use an external SMTP server:"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:8
msgid "``EMAIL_CONFIG=smtp://user@:password@youremail.host:25``"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:9
msgid "``EMAIL_CONFIG=smtp+ssl://user@:password@youremail.host:465``"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:10
msgid "``EMAIL_CONFIG=smtp+tls://user@:password@youremail.host:587``"
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_CONFIG:14
msgid "If ``user`` or ``password`` contain special characters (eg. ``noreply@youremail.host`` as ``user``), be sure to urlencode them, using for example the command: ``python3 -c 'import urllib.parse; print(urllib.parse.quote_plus (\"noreply@youremail.host\"))'`` (returns ``noreply%40youremail.host``)"
msgstr ""
#: ../../docstring of config.settings.common.DEFAULT_FROM_EMAIL:1
msgid "Name and e-mail address used to send system e-mails."
msgstr ""
#: ../../docstring of config.settings.common.DEFAULT_FROM_EMAIL:3
msgid "Default: ``Funkwhale <noreply@yourdomain>``"
msgstr ""
#: ../../docstring of config.settings.common.DEFAULT_FROM_EMAIL:7
msgid "Both the forms ``Funkwhale <noreply@yourdomain>`` and ``noreply@yourdomain`` work."
msgstr ""
#: ../../docstring of config.settings.common.EMAIL_SUBJECT_PREFIX:1
msgid "Subject prefix for system e-mails."
msgstr ""
#: ../../admin/configuration.rst:179
msgid "Other settings"
msgstr ""
#: ../../docstring of config.settings.common.INSTANCE_SUPPORT_MESSAGE_DELAY:1
msgid "Delay after signup, in days, before the \"support your pod\" message is shown."
msgstr ""
#: ../../docstring of config.settings.common.FUNKWHALE_SUPPORT_MESSAGE_DELAY:1
msgid "Delay after signup, in days, before the \"support Funkwhale\" message is shown."
msgstr ""
#: ../../docstring of config.settings.common.MIN_DELAY_BETWEEN_DOWNLOADS_COUNT:1
msgid "Minimum required period, in seconds, for two downloads of the same track by the same IP or user to be recorded in statistics."
msgstr ""
#: ../../docstring of config.settings.common.MARKDOWN_EXTENSIONS:1
msgid "List of markdown extensions to enable."
msgstr ""
#: ../../docstring of config.settings.common.MARKDOWN_EXTENSIONS:3
msgid "See `<https://python-markdown.github.io/extensions/>`_."
msgstr ""
#: ../../docstring of config.settings.common.LINKIFIER_SUPPORTED_TLDS:1
msgid "Additional TLDs to support with our markdown linkifier."
msgstr ""
#: ../../admin/configuration.rst:188
msgid "User permissions"
msgstr ""
#: ../../admin/configuration.rst:190
msgid "Funkwhale's permission model works as follows:"
msgstr ""
#: ../../admin/configuration.rst:192
msgid "Anonymous users cannot do anything unless configured specifically;"
msgstr ""
#: ../../admin/configuration.rst:193
msgid "Logged-in users can use the application, but cannot do things that affect the whole instance;"
msgstr ""
#: ../../admin/configuration.rst:194
msgid "Superusers can do anything."
msgstr ""
#: ../../admin/configuration.rst:196
msgid "To make things more granular and allow some delegation of responsibility, superusers can grant specific permissions to specific users. Available permissions are:"
msgstr ""
#: ../../admin/configuration.rst:200
msgid "**Manage instance-level settings**: users with this permission can edit instance settings as described in :ref:`instance-settings`;"
msgstr ""
#: ../../admin/configuration.rst:202
msgid "**Manage library**: users with this permission can import new music in the instance;"
msgstr ""
#: ../../admin/configuration.rst:204
msgid "**Manage library federation**: users with this permission can ask to federate with other instances, and accept/deny federation requests from other instances."
msgstr ""
#: ../../admin/configuration.rst:207
msgid "There is no dedicated interface to manage users permissions, but superusers can login on the :doc:`Django's admin <django>` at ``/api/admin/`` and grant permissions to users at ``/api/admin/users/user/``."
msgstr ""
#: ../../admin/configuration.rst:212
msgid "Front-end settings"
msgstr ""
#: ../../admin/configuration.rst:214
msgid "We offer a basic mechanism to customize the behavior and look and feel of Funkwhale's Web UI. To use any of the options below, you will need to create a custom JSON configuration file and serve it on ``https://yourinstanceurl/settings.json``."
msgstr ""
#: ../../admin/configuration.rst:218
msgid "On typical deployments, this url returns a 404 error, which is simply ignored."
msgstr ""
#: ../../admin/configuration.rst:221
msgid "Set-up"
msgstr ""
#: ../../admin/configuration.rst:223
msgid "First, create the settings file:"
msgstr ""
#: ../../admin/configuration.rst:241
msgid "Once the ``settings.json`` file is created, you will need to serve it from your reverse proxy."
msgstr ""
#: ../../admin/configuration.rst:243
msgid "If you are using nginx, add the following snippet to your vhost configuration::"
msgstr ""
#: ../../admin/configuration.rst:249
msgid "On Apache, add the following to your vhost configuration::"
msgstr ""
#: ../../admin/configuration.rst:253
msgid "Then, reload your reverse proxy."
msgstr ""
#: ../../admin/configuration.rst:255
msgid "At this point, visiting ``https://yourinstanceurl/settings.json`` should serve the content of the settings.json file."
msgstr ""
#: ../../admin/configuration.rst:260
msgid "The settings.json file must be a valid JSON file. If you have any issue, try linting the file with a tool such as `<https://github.com/zaach/jsonlint>`_ to detect potential syntax issues."
msgstr ""
#: ../../admin/configuration.rst:265
msgid "Available configuration options"
msgstr ""
#: ../../admin/configuration.rst:267
msgid "Your :file:`settings.json` can contain the following options:"
msgstr ""
#: ../../admin/configuration.rst:270
msgid "Name"
msgstr ""
#: ../../admin/configuration.rst:270
msgid "Type"
msgstr ""
#: ../../admin/configuration.rst:270
msgid "Example value"
msgstr ""
#: ../../admin/configuration.rst:270
msgid "Description"
msgstr ""
#: ../../admin/configuration.rst:272
msgid "``additionalStylesheets``"
msgstr ""
#: ../../admin/configuration.rst:272
msgid "Array of URLs"
msgstr ""
#: ../../admin/configuration.rst:272
msgid "``[\"https://test/theme.css\"]`` (default: ``[]``)"
msgstr ""
#: ../../admin/configuration.rst:272
msgid "A list of stylesheets URL (absolute or relative) that the web UI should load. see the \"Theming\" section below for a detailed explanation"
msgstr ""
#: ../../admin/configuration.rst:277
msgid "``defaultServerUrl``"
msgstr ""
#: ../../admin/configuration.rst:277
msgid "URL"
msgstr ""
#: ../../admin/configuration.rst:277
msgid "``\"https://api.yourdomain.com\"`` (default: ``null``)"
msgstr ""
#: ../../admin/configuration.rst:277
msgid "The URL of the API server this front-end should connect with. If null, the UI will use the value of VUE_APP_INSTANCE_URL (specified during build) or fallback to the current domain"
msgstr ""
#: ../../admin/configuration.rst:283
msgid "Missing options or options with a ``null`` value in the ``settings.json`` file are ignored."
msgstr ""
#: ../../admin/configuration.rst:286
msgid "Theming"
msgstr ""
#: ../../admin/configuration.rst:288
msgid "To theme your Funkwhale instance, you need:"
msgstr ""
#: ../../admin/configuration.rst:290
msgid "A CSS file for your theme, that can be loaded by the front-end;"
msgstr ""
#: ../../admin/configuration.rst:291
msgid "To update the value of ``additionalStylesheets`` in your settings.json file to point to your CSS file URL."
msgstr ""
#: ../../admin/configuration.rst:308
msgid "The last step to make this work is to ensure your CSS file is served by the reverse proxy."
msgstr ""
#: ../../admin/configuration.rst:310
msgid "On nginx, add the following snippet to your vhost config::"
msgstr ""
#: ../../admin/configuration.rst:316
msgid "On Apache, use the following::"
msgstr ""
#: ../../admin/configuration.rst:326
msgid "Once done, reload your reverse proxy, refresh Funkwhale in your web browser, and you should see a red background."
msgstr ""
#: ../../admin/configuration.rst:331
msgid "You can reference external urls as well in ``additionalStylesheets``, simply use the full urls. Be especially careful with external urls as they may affect your users privacy."
msgstr ""
#: ../../admin/configuration.rst:337
msgid "Loading additional stylesheets and CSS rules can affect the performance and usability of your instance. If you encounter issues with the interfaces and use custom stylesheets, try to disable those to ensure the issue is not caused by your customizations."
msgstr ""

81
docs/locales/gettext/admin/debugging.pot 100644
Wyświetl plik

@ -0,0 +1,81 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/debugging.rst:2
msgid "Debugging Funkwhale"
msgstr ""
#: ../../admin/debugging.rst:4
msgid "In order to track down errors its useful to provide as many information as possible. Usually pasting the logs should be sufficient, but there are some tools for some deeper debugging."
msgstr ""
#: ../../admin/debugging.rst:8
msgid "Frontend Logs"
msgstr ""
#: ../../admin/debugging.rst:10
msgid "Logs and errors written by the Frontend can be accessed with Firefox. When opening the website of your Funkwhale instance, simply hit ``Ctlr + Shift + J``. Alternatively open the Firefox Menu and open the Browser Console in the developers menu."
msgstr ""
#: ../../admin/debugging.rst:14
msgid "In the opening window you can see all the output. You can copy what you want to share or repeat the failing operation to see what error occurs."
msgstr ""
#: ../../admin/debugging.rst:18
msgid "Backend Logs"
msgstr ""
#: ../../admin/debugging.rst:20
msgid "Depending on your setup you can see the logs from our API server in different ways."
msgstr ""
#: ../../admin/debugging.rst:23
msgid "Docker"
msgstr ""
#: ../../admin/debugging.rst:25
msgid "Simply run ``docker-compose logs --tail=100 api`` If you want continuous logs, add the ``f`` flag."
msgstr ""
#: ../../admin/debugging.rst:28
msgid "Quick install"
msgstr ""
#: ../../admin/debugging.rst:30
msgid "To get the logs, run ``journalctl -xn -u funkwhale-server``"
msgstr ""
#: ../../admin/debugging.rst:33
msgid "Profiling"
msgstr ""
#: ../../admin/debugging.rst:35
msgid "In order to find performance issues, its possible to run API requests with activated profiling. In order to do this, add ``funkwhale_api.common.middleware.ProfilerMiddleware`` to the environment variable ``ADDITIONAL_MIDDLEWARES_BEFORE``"
msgstr ""
#: ../../admin/debugging.rst:39
msgid "If enabled, simply add ``?prof`` to the request URL you want to profile. You should get an HTML-Report of the running request."
msgstr ""
#: ../../admin/debugging.rst:43
msgid "Memory Tracing"
msgstr ""
#: ../../admin/debugging.rst:45
msgid "Its possible to print memory traces for each API request to the API logs. In order to do this, add ``funkwhale_api.common.middleware.PymallocMiddleware`` to the environment variable ``ADDITIONAL_MODDLEWARES_BEFORE`` This adds a middleware which should not do anything by default. Tracing can be activated by setting ``PYTHONTRACEMALLOC=1`` This might has some inpact on the performance, please report how it goes. The Middleware now prints the top 25 memory allocations to the API logs."
msgstr ""

165
docs/locales/gettext/admin/django.pot 100644
Wyświetl plik

@ -0,0 +1,165 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/django.rst:2
msgid "Using the Django Administration Backend"
msgstr ""
#: ../../admin/django.rst:4
msgid "Funkwhale is being actively developed, and new features are being added to the frontend all the time. However, there are some administrative tasks that can only be undertaken in the Django Administration backend."
msgstr ""
#: ../../admin/django.rst:7
msgid "Deleting items on the backend is **not** recommended. Deletions performed on the backend are permanent. If you remove something in the backend, you will need to re-add it from scratch."
msgstr ""
#: ../../admin/django.rst:10
msgid "Accessing the Django Backend"
msgstr ""
#: ../../admin/django.rst:12
msgid "To access your instance's backend, navigate to ``https://yourdomain/api/admin``. You will be prompted to log in. By default, the login details will be those of the priviliged user created during the setup process."
msgstr ""
#: ../../admin/django.rst:15
msgid "Deleting Items"
msgstr ""
#: ../../admin/django.rst:17
msgid "By default, deleting items in the front end removes the file from the server but **does not** delete associated entities such as artists, albums, and track data, meaning that they will still be viewable but no longer playable. Items deleted in this way will also still count on the instance statistics. To remove them completely, it is necessary to remove them from the database entirely using the Django Administration backend."
msgstr ""
#: ../../admin/django.rst:20
msgid "Deleting tracks, albums, or artists will also remove them completely from any associated playlists, radios, or favorites lists. Before continuing, make sure other users on the instance are aware of the deletion(s)."
msgstr ""
#: ../../admin/django.rst:23
msgid "Deleting a Track"
msgstr ""
#: ../../admin/django.rst:25
msgid "Navigate to ``https://yourdomain/api/admin/music/track``"
msgstr ""
#: ../../admin/django.rst:26
msgid "Select the track(s) you wish to delete"
msgstr ""
#: ../../admin/django.rst:27
#: ../../admin/django.rst:35
#: ../../admin/django.rst:47
#: ../../admin/django.rst:61
msgid "In the ``Action`` dropdown menu, select \"Delete Selected Items\""
msgstr ""
#: ../../admin/django.rst:28
msgid "Click on \"Go\". You will be prompted to confirm the track's deletion"
msgstr ""
#: ../../admin/django.rst:31
msgid "Deleting an Album"
msgstr ""
#: ../../admin/django.rst:33
#: ../../admin/django.rst:69
msgid "Navigate to ``https://yourdomain/api/admin/music/album``"
msgstr ""
#: ../../admin/django.rst:34
msgid "Select the album(s) you wish to delete"
msgstr ""
#: ../../admin/django.rst:36
msgid "Click on \"Go\". You will be prompted to confirm the album's deletion"
msgstr ""
#: ../../admin/django.rst:40
msgid "Deleting an album will remove all tracks associated with the album"
msgstr ""
#: ../../admin/django.rst:43
msgid "Deleting an Artist"
msgstr ""
#: ../../admin/django.rst:45
msgid "Navigate to ``https://yourdomain/api/admin/music/artist``"
msgstr ""
#: ../../admin/django.rst:46
msgid "Select the artist(s) you wish to delete"
msgstr ""
#: ../../admin/django.rst:48
msgid "Click on \"Go\". You will be prompted to confirm the artist's deletion"
msgstr ""
#: ../../admin/django.rst:52
msgid "Deleting an artist will remove all tracks and albums associated with the artist"
msgstr ""
#: ../../admin/django.rst:55
msgid "Removing a Followed Library"
msgstr ""
#: ../../admin/django.rst:57
msgid "In Funkwhale, unfollowing a library will leave the items in place but inaccessible. To completely remove them:"
msgstr ""
#: ../../admin/django.rst:59
msgid "Navigate to ``https://yourdomain/api/admin/music/library/``"
msgstr ""
#: ../../admin/django.rst:60
msgid "Tick the box next to the library you wish to remove"
msgstr ""
#: ../../admin/django.rst:62
msgid "Click on \"Go\". You will be prompted to confirm the library's deletion"
msgstr ""
#: ../../admin/django.rst:65
msgid "Adding Missing Album Art"
msgstr ""
#: ../../admin/django.rst:67
msgid "Sometimes album art can fail to appear despite music being properly tagged. When this happens, it is possible to replace the missing art."
msgstr ""
#: ../../admin/django.rst:70
msgid "Search for and select the album in question"
msgstr ""
#: ../../admin/django.rst:71
msgid "Find the item marked \"Cover\""
msgstr ""
#: ../../admin/django.rst:72
msgid "Click \"Browse\" and select the file from your computer"
msgstr ""
#: ../../admin/django.rst:73
msgid "Click \"Save\" to confirm the changes"
msgstr ""
#: ../../admin/django.rst:75
msgid "The album art will now be present on the frontend."
msgstr ""
#: ../../admin/django.rst:79
msgid "You can also clear currently loaded album art by checking the checkbox next to the current item and selecting \"Clear\""
msgstr ""

161
docs/locales/gettext/admin/external-storages.pot 100644
Wyświetl plik

@ -0,0 +1,161 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/external-storages.rst:2
msgid "Using external storages to store Funkwhale content"
msgstr ""
#: ../../admin/external-storages.rst:4
msgid "By default, Funkwhale will store user-uploaded and related media such as audio files, transcoded files, avatars and album covers on a server directory."
msgstr ""
#: ../../admin/external-storages.rst:7
msgid "However, for bigger instances or more complex deployment scenarios, you may want to use distributed or external storages."
msgstr ""
#: ../../admin/external-storages.rst:11
msgid "S3 and S3-compatible servers"
msgstr ""
#: ../../admin/external-storages.rst:15
msgid "This feature was released in Funkwhale 0.19 and is still considered experimental. Please let us know if you see anything unusual while using it."
msgstr ""
#: ../../admin/external-storages.rst:18
msgid "Funkwhale supports storing media files Amazon S3 and compatible implementations such as Minio or Wasabi."
msgstr ""
#: ../../admin/external-storages.rst:20
msgid "In this scenario, the content itself is stored in the S3 bucket. Non-sensitive media such as album covers or user avatars are served directly from the bucket. However, audio files are still served by the reverse proxy, to enforce proper authentication."
msgstr ""
#: ../../admin/external-storages.rst:24
msgid "To enable S3 on Funkwhale, add the following environment variables::"
msgstr ""
#: ../../admin/external-storages.rst:38
msgid "Then, edit your nginx configuration. On docker setups, the file is located at ``/srv/funkwhale/nginx/funkwhale.template``, and at ``/etc/nginx/sites-available/funkwhale.template`` on non-docker setups."
msgstr ""
#: ../../admin/external-storages.rst:41
msgid "Replace the ``location /_protected/media`` block with the following::"
msgstr ""
#: ../../admin/external-storages.rst:50
msgid "Add your S3 store URL to the ``img-src`` and ``media-src`` headers"
msgstr ""
#: ../../admin/external-storages.rst:56
msgid "Then restart Funkwhale and nginx."
msgstr ""
#: ../../admin/external-storages.rst:58
msgid "From now on, media files will be stored on the S3 bucket you configured. If you already had media files before configuring the S3 bucket, you also have to move those on the bucket by hand (which is outside the scope of this guide)."
msgstr ""
#: ../../admin/external-storages.rst:64
msgid "At the moment, we do not support S3 when using Apache as a reverse proxy."
msgstr ""
#: ../../admin/external-storages.rst:68
msgid "If you are attempting to integrate your docker deployment with an existing nginx webserver, such as the one provided by `linuxserver/swag <https://docs.linuxserver.io/images/docker-swag>`_ (formerly `linuxserver/letsencrypt <https://docs.linuxserver.io/images/docker-swag#migrating-from-the-old-linuxserver-letsencrypt-image>`_), you may run into an issue where an additional ``Content-Security-Policy`` header appears in responses from the server, without the newly included S3 URL values."
msgstr ""
#: ../../admin/external-storages.rst:74
msgid "In this case, you can suppress the extraneous ``Content-Security-Policy`` header by specifying it in a ``proxy_hide_header`` `directive <http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_hide_header>`_ in the ``location /`` block."
msgstr ""
#: ../../admin/external-storages.rst:89
msgid "Serving audio files directly from the bucket"
msgstr ""
#: ../../admin/external-storages.rst:91
msgid "Depending on your setup, you may want to serve audio files directly from the S3 bucket instead of proxying them through Funkwhale, e.g to reduce the bandwidth consumption on your server, or get better performance."
msgstr ""
#: ../../admin/external-storages.rst:95
msgid "You can achieve that by adding ``PROXY_MEDIA=false`` to your ``.env`` file."
msgstr ""
#: ../../admin/external-storages.rst:97
msgid "When receiving a request on the stream endpoint, Funkwhale will check for authentication and permissions, then issue a 302 redirect to the file URL in the bucket."
msgstr ""
#: ../../admin/external-storages.rst:100
msgid "This URL is actually be visible by the client, but contains a signature valid only for one hour, to ensure no one can reuse this URL or share it publicly to distribute unauthorized content."
msgstr ""
#: ../../admin/external-storages.rst:105
msgid "If you are using Amazon S3, you will need to set your ``AWS_S3_REGION_NAME`` in the ``.env`` file to use this feature."
msgstr ""
#: ../../admin/external-storages.rst:110
msgid "Since some Subsonic clients don't support 302 redirections, Funkwhale will ignore the ``PROXY_MEDIA`` setting and always proxy file when accessed through the Subsonic API."
msgstr ""
#: ../../admin/external-storages.rst:115
msgid "Securing your S3 bucket"
msgstr ""
#: ../../admin/external-storages.rst:117
msgid "It's important to ensure your the root of your bucket doesn't list its content, which is the default on many S3 servers. Otherwise, anyone could find out the true URLs of your audio files and bypass authentication."
msgstr ""
#: ../../admin/external-storages.rst:121
msgid "To avoid that, you can set the following policy on your bucket::"
msgstr ""
#: ../../admin/external-storages.rst:144
msgid "If you are using ``awscli``, you can store this policy in a ``/tmp/policy`` file, and apply it using the following command::"
msgstr ""
#: ../../admin/external-storages.rst:150
msgid "Troubleshooting"
msgstr ""
#: ../../admin/external-storages.rst:153
msgid "No Resolver Found"
msgstr ""
#: ../../admin/external-storages.rst:155
msgid "Depending on your setup, you may experience the following issue when trying to stream music directly from your S3-compatible store."
msgstr ""
#: ../../admin/external-storages.rst:162
msgid "This happpens when the nginx config is unable to use your server's DNS resolver. This issue is still under investigation, but in the meantime can be worked around by specifying a resolver in your ``funkwhale.template`` under the ``location ~/_protected/media/(.+)`` section."
msgstr ""
#: ../../admin/external-storages.rst:176
msgid "No Images or Media Loading"
msgstr ""
#: ../../admin/external-storages.rst:178
msgid "If you are serving media from an S3-compatible store, you may experience an issue where nothing loads in the front end. The error logs in your browser may show something like the following:"
msgstr ""
#: ../../admin/external-storages.rst:187
msgid "This happens when your S3 store isn't defined in the ``Content-Security-Policy`` headers in your Nginx files. To resolve the issue, add the base URL of your S3 store to the ``img-src`` and ``media-src`` headers and reload nginx."
msgstr ""
#: ../../admin/external-storages.rst:196
msgid "Broken Images in Audio Player On Page Reload"
msgstr ""
#: ../../admin/external-storages.rst:198
msgid "If you are serving media directly from an S3-compatible store, you may find that images in the queue and the player won't load after the page is refreshed. This happens if the generated URL has expired and the authorization is no longer valid. You can extend the expiry time using the following setting in your ``.env`` file:"
msgstr ""

273
docs/locales/gettext/admin/importing-music.pot 100644
Wyświetl plik

@ -0,0 +1,273 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/importing-music.rst:2
msgid "Importing music from the server"
msgstr ""
#: ../../admin/importing-music.rst:4
msgid "Funkwhale can import music files saved on the server assuming they are readable by the Funkwhale application. Your music files should contain at least ``artist``, ``album`` and ``title`` tags, but we recommend you tag extensively using a proper tool, such as Beets or Musicbrainz Picard."
msgstr ""
#: ../../admin/importing-music.rst:11
msgid "Funkwhale supports two different import modes:"
msgstr ""
#: ../../admin/importing-music.rst:13
msgid "copy(default): files are copied into Funkwhale's internal storage. This means importing a 1GB library will result in the same amount of space being used by Funkwhale."
msgstr ""
#: ../../admin/importing-music.rst:14
msgid ":ref:`in-place <in-place-import>` (with ``--in-place`` flag): files are referenced in Funkwhale's DB but not copied or touched in anyway. This is useful if you have a huge library, or one that is updated by an external tool such as Beets."
msgstr ""
#: ../../admin/importing-music.rst:16
msgid "Regardless of the mode you choose, follow the below steps to import music, assuming your files are located in ``/srv/funkwhale/data/music``:"
msgstr ""
#: ../../admin/importing-music.rst:27
msgid "You have to create a library in the Web UI to get your library ID. Simply visit https://yourdomain/content/libraries/ to create one."
msgstr ""
#: ../../admin/importing-music.rst:30
msgid "Library IDs are part of the library url or sharing link. For example, the library ID of https://funkwhale.instance/content/libraries/769a2ae3-eb3d-4aff-9f94-2c4d80d5c2d1, is 769a2bc3-eb1d-4aff-9f84-2c4d80d5c2d1"
msgstr ""
#: ../../admin/importing-music.rst:35
msgid "You can use only the first characters of the ID when calling the command, like that: ``export LIBRARY_ID=\"769a2bc3\"``"
msgstr ""
#: ../../admin/importing-music.rst:38
msgid "When you use docker, ``/srv/funkwhale/data/music`` is mounted from the host to the ``/music`` directory on the container:"
msgstr ""
#: ../../admin/importing-music.rst:46
msgid "When you installed Funkwhale via ansible, you need to call a script instead of Python, and the folder path must be adapted accordingly:"
msgstr ""
#: ../../admin/importing-music.rst:54
msgid "The import command supports several options, check the help for details::"
msgstr ""
#: ../../admin/importing-music.rst:61
msgid "We recommend tagging your music collection using `Picard <http://picard.musicbrainz.org/>`_ to have the best quality metadata."
msgstr ""
#: ../../admin/importing-music.rst:65
msgid "This command is idempotent, meaning you can run it multiple times on the same files and already imported files are simply skipped."
msgstr ""
#: ../../admin/importing-music.rst:71
msgid "At the moment, only Flac, OGG/Vorbis and MP3 or AIFF files with ID3 tags are supported."
msgstr ""
#: ../../admin/importing-music.rst:77
msgid "In-place import"
msgstr ""
#: ../../admin/importing-music.rst:79
msgid "By default, the CLI-importer will copy imported files to Funkwhale's internal storage. This means importing a 1GB library will result in the same amount of space being used by Funkwhale."
msgstr ""
#: ../../admin/importing-music.rst:83
msgid "While this behaviour has some benefits (easier backups and configuration), it is not always the best choice, especially if you have a huge library to import and don't want to double your disk usage."
msgstr ""
#: ../../admin/importing-music.rst:88
msgid "The CLI importer supports an additional ``--in-place`` option through which Funkwhale will store file paths rather than file content."
msgstr ""
#: ../../admin/importing-music.rst:92
msgid "Structure"
msgstr ""
#: ../../admin/importing-music.rst:94
msgid "Because imported files are not managed by Funkwhale, we offer additional configuration options to ensure the webserver can serve them properly:"
msgstr ""
#: ../../admin/importing-music.rst:98
msgid ":data:`MUSIC_DIRECTORY_PATH <config.settings.common.MUSIC_DIRECTORY_PATH>`"
msgstr ""
#: ../../admin/importing-music.rst:99
msgid ":data:`MUSIC_DIRECTORY_SERVING_PATH <config.settings.common.MUSIC_DIRECTORY_SERVE_PATH>`"
msgstr ""
#: ../../admin/importing-music.rst:101
msgid "We recommend you symlink all your music directories into ``/srv/funkwhale/data/music`` and run the `import_files` command from that directory. This will make it possible to use multiple music directories without any additional configuration on the webserver side."
msgstr ""
#: ../../admin/importing-music.rst:106
msgid "For instance, if you have an NFS share with your music mounted at ``/media/mynfsshare``, you can create a symlink like this::"
msgstr ""
#: ../../admin/importing-music.rst:112
msgid "And import music from the share::"
msgstr ""
#: ../../admin/importing-music.rst:118
msgid "Docker"
msgstr ""
#: ../../admin/importing-music.rst:120
msgid "Docker setups require a bit more work, because while the ``/srv/funkwhale/data/music`` is mounted in containers, symlinked directories are not."
msgstr ""
#: ../../admin/importing-music.rst:124
msgid "To fix that, you can use bind mounts instead of symbolic links, as they replicate the source directory tree. With the previous NFS share, use this command::"
msgstr ""
#: ../../admin/importing-music.rst:130
msgid "If you want to go with symlinks, ensure each symlinked directory is mounted as a volume as well as in your ``docker-compose.yml`` file::"
msgstr ""
#: ../../admin/importing-music.rst:149
msgid "Metadata updates"
msgstr ""
#: ../../admin/importing-music.rst:151
msgid "When doing an import with in ``in-place`` mode, the importer will also check and update existing entries found in the database. For instance, if the ID3 Title tag of an existing song was updated since the last scan, Funkwhale picks up the new title. The following fields can be updated this way:"
msgstr ""
#: ../../admin/importing-music.rst:156
msgid "Track mbid"
msgstr ""
#: ../../admin/importing-music.rst:157
msgid "Track title"
msgstr ""
#: ../../admin/importing-music.rst:158
msgid "Track position and disc number"
msgstr ""
#: ../../admin/importing-music.rst:159
msgid "Track license and copyright"
msgstr ""
#: ../../admin/importing-music.rst:160
msgid "Track genre (`from version 1.2 <https://dev.funkwhale.audio/funkwhale/funkwhale/-/merge_requests/1225>`_)"
msgstr ""
#: ../../admin/importing-music.rst:161
msgid "Album cover"
msgstr ""
#: ../../admin/importing-music.rst:162
msgid "Album title"
msgstr ""
#: ../../admin/importing-music.rst:163
msgid "Album mbid"
msgstr ""
#: ../../admin/importing-music.rst:164
msgid "Album release date"
msgstr ""
#: ../../admin/importing-music.rst:165
msgid "Artist name"
msgstr ""
#: ../../admin/importing-music.rst:166
msgid "Artist mbid"
msgstr ""
#: ../../admin/importing-music.rst:167
msgid "Album artist name"
msgstr ""
#: ../../admin/importing-music.rst:168
msgid "Album artist mbid"
msgstr ""
#: ../../admin/importing-music.rst:170
msgid "Changes in artist name can lead to multiple artists with the same name in the database, `this is a known issue <https://dev.funkwhale.audio/funkwhale/funkwhale/-/issues/1318>`_ and can be remedied by adding mbids."
msgstr ""
#: ../../admin/importing-music.rst:175
msgid "React to filesystem events with ``--watch``"
msgstr ""
#: ../../admin/importing-music.rst:177
msgid "If you have a really big library or update it regularly, running the ``import_files`` command by hand may not be practical. For this use case, the ``import_files`` command supports a ``--watch`` flag through which it observes filesystem events instead of performing a full import."
msgstr ""
#: ../../admin/importing-music.rst:183
msgid "File creation, move, update and removal are handled when ``--watch`` is provided:"
msgstr ""
#: ../../admin/importing-music.rst:186
msgid "Files created in the watched directory are imported immediately"
msgstr ""
#: ../../admin/importing-music.rst:187
msgid "If using ``in-place`` mode, files updates trigger a metadata update on the corresponding entries"
msgstr ""
#: ../../admin/importing-music.rst:188
msgid "If using ``in-place`` mode, files that are moved and known by Funkwhale will see their path updated in Funkwhale's DB"
msgstr ""
#: ../../admin/importing-music.rst:189
msgid "If using ``in-place`` mode, files that are removed and known by Funkwhale will be removed from Funkwhale's DB"
msgstr ""
#: ../../admin/importing-music.rst:192
msgid "Pruning dangling metadata with ``--prune``"
msgstr ""
#: ../../admin/importing-music.rst:194
msgid "Funkwhale is, by design, conservative with music metadata in its database. If you remove a file from Funkwhale's DB, the corresponding artist, album and track object won't be deleted by default."
msgstr ""
#: ../../admin/importing-music.rst:198
msgid "If you want to prune dangling metadata from the database once the ``import_files`` command is over, simply add the ``--prune`` flag. This also works in with ``--watch``."
msgstr ""
#: ../../admin/importing-music.rst:202
msgid "Album covers"
msgstr ""
#: ../../admin/importing-music.rst:204
msgid "Whenever possible, Funkwhale obtains album covers for tracks, with the following precedence:"
msgstr ""
#: ../../admin/importing-music.rst:207
msgid "The cover embedded in the audio files themeselves, if any (Flac/MP3 only)"
msgstr ""
#: ../../admin/importing-music.rst:208
msgid "Use a cover.jpg or a cover.png file from the imported track directory, if any"
msgstr ""
#: ../../admin/importing-music.rst:209
msgid "Fetch cover art from musicbrainz, assuming the file is tagged correctly"
msgstr ""
#: ../../admin/importing-music.rst:212
msgid "Getting demo tracks"
msgstr ""
#: ../../admin/importing-music.rst:214
msgid "If you do not have any music on your server but want to test the import process, you can call the following methods to download a few albums licenced under creative commons (courtesy of Jamendo):"
msgstr ""
#: ../../admin/importing-music.rst:226
msgid "This will download a bunch of zip archives (one per album) under the ``data/music`` directory and unzip their content."
msgstr ""

37
docs/locales/gettext/admin/index.pot 100644
Wyświetl plik

@ -0,0 +1,37 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/index.rst:2
msgid "Administrator Documentation"
msgstr ""
#: ../../admin/index.rst:4
msgid "This documentation is targeted at administrators of instances. This typically refers to the person(s) responsible for running the server and managing the software on a technical level."
msgstr ""
#: ../../admin/index.rst:9
msgid "Setup Guides"
msgstr ""
#: ../../admin/index.rst:25
msgid "Administration"
msgstr ""
#: ../../admin/index.rst:37
msgid "Troubleshooting"
msgstr ""

113
docs/locales/gettext/admin/ldap.pot 100644
Wyświetl plik

@ -0,0 +1,113 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/ldap.rst:2
msgid "LDAP configuration"
msgstr ""
#: ../../admin/ldap.rst:4
msgid "LDAP is a protocol for providing directory services, in practice allowing a central authority for user login information."
msgstr ""
#: ../../admin/ldap.rst:6
msgid "Funkwhale supports LDAP through the Django LDAP authentication module and by setting several configuration options."
msgstr ""
#: ../../admin/ldap.rst:10
msgid "Note that LDAP-based users cannot change their password inside the app."
msgstr ""
#: ../../admin/ldap.rst:13
msgid "Dependencies"
msgstr ""
#: ../../admin/ldap.rst:15
msgid "LDAP support requires some additional dependencies to enable. On the OS level both ``libldap2-dev`` and ``libsasl2-dev`` are required, and the Python modules ``python-ldap`` and ``python-django-auth-ldap`` must be installed. These dependencies are all included in the ``requirements.*`` files so deploying with those will install these dependencies by default. However, they are not required unless LDAP support is explicitly enabled."
msgstr ""
#: ../../admin/ldap.rst:18
msgid "Environment variables"
msgstr ""
#: ../../admin/ldap.rst:20
msgid "LDAP authentication is configured entirely through the environment variables. The following options enable the LDAP features:"
msgstr ""
#: ../../admin/ldap.rst:23
msgid "Basic features"
msgstr ""
#: ../../admin/ldap.rst:25
msgid "``LDAP_ENABLED``: Set to ``True`` to enable LDAP support. Default: ``False``."
msgstr ""
#: ../../admin/ldap.rst:26
msgid "``LDAP_SERVER_URI``: LDAP URI to the authentication server, e.g. ``ldap://my.host:389``."
msgstr ""
#: ../../admin/ldap.rst:27
msgid "``LDAP_BIND_DN``: LDAP user DN to bind as to perform searches."
msgstr ""
#: ../../admin/ldap.rst:28
msgid "``LDAP_BIND_PASSWORD``: LDAP user password for bind DN."
msgstr ""
#: ../../admin/ldap.rst:29
msgid "``LDAP_SEARCH_FILTER``: The LDAP user filter, using ``{0}`` as the username placeholder, e.g. ``(|(cn={0})(mail={0}))``; uses standard LDAP search syntax. Default: ``(uid={0})``."
msgstr ""
#: ../../admin/ldap.rst:30
msgid "``LDAP_START_TLS``: Set to ``True`` to enable LDAP StartTLS support. Default: ``False``."
msgstr ""
#: ../../admin/ldap.rst:31
msgid "``LDAP_ROOT_DN``: The LDAP search root DN, e.g. ``dc=my,dc=domain,dc=com``; supports multiple entries in a space-delimited list, e.g. ``dc=users,dc=domain,dc=com dc=admins,dc=domain,dc=com``."
msgstr ""
#: ../../admin/ldap.rst:32
msgid "``LDAP_USER_ATTR_MAP``: A mapping of Django user attributes to LDAP values, e.g. ``first_name:givenName, last_name:sn, username:cn, email:mail``. Default: ``first_name:givenName, last_name:sn, username:cn, email:mail``."
msgstr ""
#: ../../admin/ldap.rst:33
msgid "``AUTH_LDAP_BIND_AS_AUTHENTICATING_USER``: Controls whether direct binding is used. Default: ``False``."
msgstr ""
#: ../../admin/ldap.rst:36
msgid "Group features"
msgstr ""
#: ../../admin/ldap.rst:38
msgid "For details on these options, see the `Django documentation <https://django-auth-ldap.readthedocs.io/en/latest/groups.html>`_. Group configuration is disabled unless an ``LDAP_GROUP_DN`` is set. This is an advanced LDAP feature and most users should not need to configure these settings."
msgstr ""
#: ../../admin/ldap.rst:40
msgid "``LDAP_GROUP_DN``: The LDAP group search root DN, e.g. ``ou=groups,dc=domain,dc=com``."
msgstr ""
#: ../../admin/ldap.rst:41
msgid "``LDAP_GROUP_FILTER``: The LDAP group filter, e.g. ``(objectClass=groupOfNames)``."
msgstr ""
#: ../../admin/ldap.rst:42
msgid "``LDAP_REQUIRE_GROUP``: A group users must be a part of to authenticate, e.g. ``cn=enabled,ou=groups,dc=domain,dc=com``."
msgstr ""
#: ../../admin/ldap.rst:43
msgid "``LDAP_DENY_GROUP``: A group users must not be a part of to authenticate, e.g. ``cn=disabled,ou=groups,dc=domain,dc=com``."
msgstr ""

122
docs/locales/gettext/admin/migration.pot 100644
Wyświetl plik

@ -0,0 +1,122 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/migration.rst:2
msgid "Migrating to a New Server"
msgstr ""
#: ../../admin/migration.rst:4
msgid "Sometimes, it may be necessary or desirable to migrate your existing Funkwhale setup to a new server. This can be helpful if you need to boost resources or if you wish to use a different hosting platform."
msgstr ""
#: ../../admin/migration.rst:9
msgid "In this guide, the existing Funkwhale setup is called the origin server, and the new setup the destination server."
msgstr ""
#: ../../admin/migration.rst:12
msgid "Requirements"
msgstr ""
#: ../../admin/migration.rst:14
msgid "To get started with your new setup, you will need to have the following:"
msgstr ""
#: ../../admin/migration.rst:17
msgid "`rsync <https://linux.die.net/man/1/rsync>`_ installed on the **destination** server"
msgstr ""
#: ../../admin/migration.rst:18
msgid "SSH access set up between the two servers"
msgstr ""
#: ../../admin/migration.rst:21
msgid "Non-Docker"
msgstr ""
#: ../../admin/migration.rst:23
msgid "On the destination server, run through the :doc:`installation steps<../installation/debian>` with the exception of the following points:"
msgstr ""
#: ../../admin/migration.rst:25
msgid "Do not enable the extensions ``unaccent`` and ``citext`` when setting up the database;"
msgstr ""
#: ../../admin/migration.rst:26
msgid "Do not initialize the database by applying the migrate command;"
msgstr ""
#: ../../admin/migration.rst:27
msgid "Do not create an admin account."
msgstr ""
#: ../../admin/migration.rst:29
msgid "Stop all funkwhale related services on the destination server:"
msgstr ""
#: ../../admin/migration.rst:35
#: ../../admin/migration.rst:75
msgid "On the origin server, create a database backup:"
msgstr ""
#: ../../admin/migration.rst:41
msgid "On the destination server, use rsync to fetch the contents of ``/srv/funwkhale/data/media/music/`` and ``/srv/funkwhale/data/media/`` from the origin server, as well as the database dump and the ``.env`` file:"
msgstr ""
#: ../../admin/migration.rst:54
msgid "On the destination server, restore the database dump:"
msgstr ""
#: ../../admin/migration.rst:60
msgid "Once the database has been restored, follow the database migration steps from the non-docker installation guide to complete the installation on the destination server."
msgstr ""
#: ../../admin/migration.rst:62
msgid "Ensure that all DNS changes have been made and start the services:"
msgstr ""
#: ../../admin/migration.rst:69
msgid "Docker"
msgstr ""
#: ../../admin/migration.rst:71
msgid "On the destination server, run through the :doc:`installation steps<../installation/docker>` but skip the ``docker-compose run --rm api python manage.py migrate`` step."
msgstr ""
#: ../../admin/migration.rst:73
msgid "Stop all funkwhale related containers on the destination server."
msgstr ""
#: ../../admin/migration.rst:81
msgid "On the destination server, use rsync to fetch the contents of ``/srv/funwkhale/data/media/music`` and ``/srv/funkwhale/data/media`` from the origin server, as well as the database dump nd the ``.env`` file:"
msgstr ""
#: ../../admin/migration.rst:94
msgid "Initialize the Postgres container with the funkwhale database and its user. For easier, we create a db init dump file than we import in the postgres container:"
msgstr ""
#: ../../admin/migration.rst:105
msgid "After that, we can restore the database dump:"
msgstr ""
#: ../../admin/migration.rst:111
msgid "Once the database has been restored, run the migrations following the docker installation guide."
msgstr ""
#: ../../admin/migration.rst:113
msgid "Ensure that all DNS changes have been made and start the services."
msgstr ""

89
docs/locales/gettext/admin/mrf.pot 100644
Wyświetl plik

@ -0,0 +1,89 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/mrf.rst:2
msgid "Message Rewrite Facility (MRF)"
msgstr ""
#: ../../admin/mrf.rst:4
msgid "Funkwhale includes a feature that mimics `Pleroma's Message Rewrite Facility <https://docs-develop.pleroma.social/backend/configuration/mrf/>`_. Using the MRF, instance admins can write and configure custom and automated moderation rules that couldn't be implemented otherwise using :doc:`our other built-in moderation tools <../moderator/index>`."
msgstr ""
#: ../../admin/mrf.rst:9
msgid "Architecture"
msgstr ""
#: ../../admin/mrf.rst:11
msgid "The MRF is a pluggable system that will process messages and forward those to the list of registered policies, in turn. Each policy can mutate the message, leave it as is, or discard it entirely."
msgstr ""
#: ../../admin/mrf.rst:14
msgid "Some of our built-in moderation tools are actually implemented as a MRF policy, e.g:"
msgstr ""
#: ../../admin/mrf.rst:16
msgid "Allow-list, when checking incoming messages (`code <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/moderation/mrf_policies.py>`__)"
msgstr ""
#: ../../admin/mrf.rst:17
msgid "Domain and user blocking, when checking incoming messages (`code <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/mrf_policies.py>`__)"
msgstr ""
#: ../../admin/mrf.rst:21
msgid "While Pleroma MRF policies can also affect outgoing messages, this is not supported yet in Funkwhale."
msgstr ""
#: ../../admin/mrf.rst:25
msgid "Disclaimer"
msgstr ""
#: ../../admin/mrf.rst:27
msgid "Writing custom MRF can impact negatively the performance and stability of your pod, as well as message delivery. Your policy will be called everytime a message is delivered, so ensure you don't execute any slow operation here."
msgstr ""
#: ../../admin/mrf.rst:31
msgid "Please note that the Funkwhale developers consider custom MRF policy modules to fall under the purview of the AGPL. As such, you are obligated to release the sources to your custom MRF policy modules upon request."
msgstr ""
#: ../../admin/mrf.rst:34
msgid "Writing your first MRF policy"
msgstr ""
#: ../../admin/mrf.rst:36
msgid "MRF Policies are written as Python 3 functions that take at least one ``payload`` parameter. This payload is the raw ActivityPub message, received via HTTP, after the HTTP signature check."
msgstr ""
#: ../../admin/mrf.rst:39
msgid "In the example below we write a policy that discards all Follow requests from listed domains:"
msgstr ""
#: ../../admin/mrf.rst:66
msgid "This code must be stored in a Funkwhale plugin. To create one, just execute the following:"
msgstr ""
#: ../../admin/mrf.rst:89
msgid "Once you have a Funkwhale plugin, simply put your MRF policy code inside a ``mrf_policies.py`` file whithin the plugin directory. Then enable the plugin in your ``.env`` by adding its name to the coma-separated list of ``FUNKWHALE_PLUGINS`` (add the variable if it's not there)."
msgstr ""
#: ../../admin/mrf.rst:95
msgid "Testing a MRF policy"
msgstr ""
#: ../../admin/mrf.rst:97
msgid "To make the job of writing and debugging MRF policies easier, we provide a management command:"
msgstr ""

61
docs/locales/gettext/admin/optimization.pot 100644
Wyświetl plik

@ -0,0 +1,61 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/optimization.rst:2
msgid "Optimizing your Funkwhale instance"
msgstr ""
#: ../../admin/optimization.rst:4
msgid "Depending on your requirements, you may want to reduce as much as possible Funkwhale's memory footprint."
msgstr ""
#: ../../admin/optimization.rst:8
msgid "Reduce workers concurrency"
msgstr ""
#: ../../admin/optimization.rst:10
msgid "Asynchronous tasks are handled by a celery worker, which will by default spawn a worker process per CPU available. This can lead to a higher memory usage."
msgstr ""
#: ../../admin/optimization.rst:14
msgid "You can control this behavior using the ``--concurrency`` flag. For instance, setting ``--concurrency=1`` will spawn only one worker."
msgstr ""
#: ../../admin/optimization.rst:17
msgid "This flag should be appended after the ``celery -A funkwhale_api.taskapp worker`` command in your :file:`docker-compose.yml` file if your using Docker, or in your :file:`/etc/systemd/system/funkwhale-worker.service` otherwise."
msgstr ""
#: ../../admin/optimization.rst:23
msgid "Reducing concurrency comes at a cost: asynchronous tasks will be processed more slowly. However, on small instances, this should not be an issue."
msgstr ""
#: ../../admin/optimization.rst:28
msgid "Switch from prefork to solo pool"
msgstr ""
#: ../../admin/optimization.rst:30
msgid "Using a different pool implementation for Celery tasks may also help."
msgstr ""
#: ../../admin/optimization.rst:32
msgid "Using the ``solo`` pool type should reduce your memory consumption. You can control this behavior using the ``--pool=solo`` flag."
msgstr ""
#: ../../admin/optimization.rst:35
msgid "This flag should be appended after the ``celery -A funkwhale_api.taskapp worker`` command in your :file:`docker-compose.yml` file if you're using Docker, or in your :file:`/etc/systemd/system/funkwhale-worker.service` otherwise."
msgstr ""

290
docs/locales/gettext/admin/troubleshooting.pot 100644
Wyświetl plik

@ -0,0 +1,290 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/troubleshooting.rst:2
msgid "Troubleshooting"
msgstr ""
#: ../../admin/troubleshooting.rst:4
msgid "Various errors and issues can arise on your Funkwhale instance, caused by configuration errors, deployment/environment specific issues, or bugs in the software itself."
msgstr ""
#: ../../admin/troubleshooting.rst:7
msgid "On this document, you'll find:"
msgstr ""
#: ../../admin/troubleshooting.rst:9
msgid "Tools and commands you can use to better understand the issues"
msgstr ""
#: ../../admin/troubleshooting.rst:10
msgid "A list of common pitfalls and errors and how to solve them"
msgstr ""
#: ../../admin/troubleshooting.rst:11
msgid "A collection of links and advice to get help from the community and report new issues"
msgstr ""
#: ../../admin/troubleshooting.rst:14
msgid "Diagnose problems"
msgstr ""
#: ../../admin/troubleshooting.rst:16
msgid "Funkwhale is made of several components, each one being a potential cause for failure. Having an even basic overview of Funkwhale's technical architecture can help you understand what is going on. You can refer to :doc:`the technical architecture <../developers/architecture>` for that."
msgstr ""
#: ../../admin/troubleshooting.rst:19
msgid "Problems usually fall into one of those categories:"
msgstr ""
#: ../../admin/troubleshooting.rst:21
msgid "**Frontend**: Funkwhale's interface is not loading, not behaving as expected, music is not playing"
msgstr ""
#: ../../admin/troubleshooting.rst:22
msgid "**API**: the interface do not display any data or show errors"
msgstr ""
#: ../../admin/troubleshooting.rst:23
msgid "**Import**: uploaded/imported tracks are not imported correctly or at all"
msgstr ""
#: ../../admin/troubleshooting.rst:24
msgid "**Federation**: you cannot contact other Funkwhale servers, access their library, play federated tracks"
msgstr ""
#: ../../admin/troubleshooting.rst:25
msgid "**Everything else**"
msgstr ""
#: ../../admin/troubleshooting.rst:27
msgid "Each category comes with its own set of diagnose tools and/or commands we will detail below. We'll also give you simple steps for each type of problem. Please try those to see if it fix your issues. If none of those works, please report your issue on our issue tracker."
msgstr ""
#: ../../admin/troubleshooting.rst:33
msgid "To get detailed log messages, set the environment variable ``LOGLEVEL=debug``. If you are using the docker setup you can configure this in the ``.env`` file."
msgstr ""
#: ../../admin/troubleshooting.rst:37
msgid "Backend issues"
msgstr ""
#: ../../admin/troubleshooting.rst:39
#: ../../admin/troubleshooting.rst:98
#: ../../admin/troubleshooting.rst:109
msgid "Diagnostic tools:"
msgstr ""
#: ../../admin/troubleshooting.rst:42
msgid "Reverse proxy logs:"
msgstr ""
#: ../../admin/troubleshooting.rst:42
msgid "Apache logs should be available at :file:`/var/log/apache/access.log` and :file:`/var/log/apache/error.log`"
msgstr ""
#: ../../admin/troubleshooting.rst:43
msgid "Nginx logs should be available at :file:`/var/log/nginx/access.log` and :file:`/var/log/nginx/error.log`"
msgstr ""
#: ../../admin/troubleshooting.rst:46
#: ../../admin/troubleshooting.rst:112
msgid "API logs:"
msgstr ""
#: ../../admin/troubleshooting.rst:45
#: ../../admin/troubleshooting.rst:112
msgid "Docker setup: ``docker-compose logs -f --tail=50 api`` (remove the ``--tail`` flag to get the full logs)"
msgstr ""
#: ../../admin/troubleshooting.rst:46
#: ../../admin/troubleshooting.rst:113
msgid "Non-docker setup: ``journalctl -xn -u funkwhale-server``"
msgstr ""
#: ../../admin/troubleshooting.rst:50
msgid "If you edit your .env file to test a new configuration, you have to restart your services to pick up the changes:"
msgstr ""
#: ../../admin/troubleshooting.rst:52
msgid "Docker setup: ``docker-compose up -d``"
msgstr ""
#: ../../admin/troubleshooting.rst:53
msgid "Non-docker setup: ``systemctl restart funkwhale.target``"
msgstr ""
#: ../../admin/troubleshooting.rst:56
#: ../../admin/troubleshooting.rst:119
msgid "Common problems"
msgstr ""
#: ../../admin/troubleshooting.rst:59
msgid "Instance works properly, but audio files are not served (404 error)"
msgstr ""
#: ../../admin/troubleshooting.rst:61
msgid "If you're using docker, ensure the ``MEDIA_ROOT`` variable is commented in your env file"
msgstr ""
#: ../../admin/troubleshooting.rst:62
msgid "Ensure the ``_protected/media`` block points toward the path where media files are stored (``/srv/funkwhale/data/media``, by default)"
msgstr ""
#: ../../admin/troubleshooting.rst:63
msgid "If you're using in-place import, ensure :data:`MUSIC_DIRECTORY_PATH <config.settings.common.MUSIC_DIRECTORY_PATH>`, :data:`MUSIC_DIRECTORY_SERVE_PATH <config.settings.common.MUSIC_DIRECTORY_SERVE_PATH>` and :data:`REVERSE_PROXY_TYPE <config.settings.common.REVERSE_PROXY_TYPE>` are configured properly, and that the files are readable by the webserver"
msgstr ""
#: ../../admin/troubleshooting.rst:66
msgid "Weakref error when running ``python manage.py <command>``"
msgstr ""
#: ../../admin/troubleshooting.rst:68
msgid "On Python <3.6, you may see this kind of errors when running commands like ``python manage.py migrate``::"
msgstr ""
#: ../../admin/troubleshooting.rst:75
msgid "This is caused by a bug in Python (cf https://github.com/celery/celery/issues/3818), and is not affecting in any way the command you execute. You can safely ignore this error."
msgstr ""
#: ../../admin/troubleshooting.rst:79
msgid "``Your models have changes that are not yet reflected in a migration`` warning"
msgstr ""
#: ../../admin/troubleshooting.rst:81
msgid "When running ``python manage.py migrate`` (both in docker or non-docker), you may end-up with this::"
msgstr ""
#: ../../admin/troubleshooting.rst:91
msgid "This warning can be safely ignored. You should not run the suggested ``manage.py makemigrations`` command."
msgstr ""
#: ../../admin/troubleshooting.rst:94
msgid "File import issues"
msgstr ""
#: ../../admin/troubleshooting.rst:96
msgid "Unless you are using the CLI to import files, imports are send as tasks in a queue to a celery worker that will process them."
msgstr ""
#: ../../admin/troubleshooting.rst:102
#: ../../admin/troubleshooting.rst:116
msgid "Celery worker logs:"
msgstr ""
#: ../../admin/troubleshooting.rst:101
#: ../../admin/troubleshooting.rst:115
msgid "Docker setup: ``docker-compose logs -f --tail=50 celeryworker`` (remove the ``--tail`` flag to get the full logs)"
msgstr ""
#: ../../admin/troubleshooting.rst:102
#: ../../admin/troubleshooting.rst:116
msgid "Non-docker setup: ``journalctl -xn -u funkwhale-worker``"
msgstr ""
#: ../../admin/troubleshooting.rst:105
msgid "Federation issues"
msgstr ""
#: ../../admin/troubleshooting.rst:107
msgid "Received federations messages are sent to a dedicated task queue and processed asynchronously by a celery worker."
msgstr ""
#: ../../admin/troubleshooting.rst:122
msgid "I have no access to another instance library"
msgstr ""
#: ../../admin/troubleshooting.rst:124
msgid "Check if it works with the demo library (library@demo.funkwhale.audio)"
msgstr ""
#: ../../admin/troubleshooting.rst:125
msgid "Check if the remote library received your follow request and approved it"
msgstr ""
#: ../../admin/troubleshooting.rst:126
msgid "Trigger a scan via the interface"
msgstr ""
#: ../../admin/troubleshooting.rst:127
msgid "Have a look in the celery logs for potential errors during the scan"
msgstr ""
#: ../../admin/troubleshooting.rst:130
msgid "Other problems"
msgstr ""
#: ../../admin/troubleshooting.rst:132
msgid "It's a bit hard to give targeted advice about problems that do not fit in the previous categories. However, we can recommend to:"
msgstr ""
#: ../../admin/troubleshooting.rst:134
msgid "Try to identify the scope of the issue and reproduce it reliably"
msgstr ""
#: ../../admin/troubleshooting.rst:135
msgid "Ensure your instance is configured as detailed in the installation documentation, and if you did not use the default values, to check what you changed"
msgstr ""
#: ../../admin/troubleshooting.rst:137
msgid "To read the .env file carefully, as most of the options are described in the comments"
msgstr ""
#: ../../admin/troubleshooting.rst:141
msgid "Report an issue or get help"
msgstr ""
#: ../../admin/troubleshooting.rst:143
msgid "Well be more than happy to help you to debug installation and configuration issues. The main channel for receiving support about your Funkwhale installation is the `#funkwhale-troubleshooting:matrix.org <https://matrix.to/#/#funkwhale-troubleshooting:matrix.org>`_ Matrix channel."
msgstr ""
#: ../../admin/troubleshooting.rst:146
msgid "Before asking for help, we'd really appreciate if you took the time to go through this document and try to diagnose the problem yourself. But if you don't find anything relevant or don't have the time, we'll be there for you!"
msgstr ""
#: ../../admin/troubleshooting.rst:149
msgid "Here are a few recommendations on how to structure and what to include in your help requests:"
msgstr ""
#: ../../admin/troubleshooting.rst:151
msgid "Give us as much context as possible about your installation (OS, version, Docker/non-docker, reverse-proxy type, relevant logs and errors, etc.)"
msgstr ""
#: ../../admin/troubleshooting.rst:152
msgid "Including screenshots or small gifs or videos can help us considerably when debugging front-end issues"
msgstr ""
#: ../../admin/troubleshooting.rst:154
msgid "You can also open issues on our `issue tracker <https://dev.funkwhale.audio/funkwhale/funkwhale/issues>`_. Please have a quick look for similar issues before doing that, and use the issue tracker only to report bugs, suggest enhancements (both in the software and the documentation) or new features."
msgstr ""
#: ../../admin/troubleshooting.rst:159
msgid "If you ever need to share screenshots or urls with someone else, ensure those do not include your personal token. This token is binded to your account and can be used to connect and use your account."
msgstr ""
#: ../../admin/troubleshooting.rst:162
msgid "Urls that includes your token looks like: ``https://your.instance/api/v1/uploads/42/serve/?jwt=yoursecrettoken``"
msgstr ""
#: ../../admin/troubleshooting.rst:165
msgid "Improving this documentation"
msgstr ""
#: ../../admin/troubleshooting.rst:167
msgid "If you feel like something should be improved in this document (and in the documentation in general), feel free to :doc:`contribute to the documentation <../documentation/creating>`. If you're not comfortable contributing or would like to ask somebody else to do it, feel free to :doc:`request a change in documentation <../documentation/identifying>`."
msgstr ""

98
docs/locales/gettext/admin/uninstall.pot 100644
Wyświetl plik

@ -0,0 +1,98 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/uninstall.rst:2
msgid "Uninstall Funkwhale"
msgstr ""
#: ../../admin/uninstall.rst:4
msgid "The following instructions helps you remove Funkwhale from your server, for instance after migrating to another server, or if you do not want to use Funkwhale anymore."
msgstr ""
#: ../../admin/uninstall.rst:8
msgid "The following instructions cannot be undone and might result in loss of data. If necessary, please make a backup of your server following the :doc:`backup instructions<backup>`."
msgstr ""
#: ../../admin/uninstall.rst:10
msgid "Especially, it must be noted that:"
msgstr ""
#: ../../admin/uninstall.rst:12
#: ../../admin/uninstall.rst:81
msgid "Remote content hosted on an S3 or S3-compatible server will not be removed."
msgstr ""
#: ../../admin/uninstall.rst:13
msgid "In place imports will not be removed, provided they are located outside ``/srv/funkwhale/``"
msgstr ""
#: ../../admin/uninstall.rst:17
msgid "These instructions apply only for the manual installation on Debian or Arch Linux. It matches the default setup."
msgstr ""
#: ../../admin/uninstall.rst:19
msgid "First, stop the all funkwhale related services:"
msgstr ""
#: ../../admin/uninstall.rst:25
msgid "Remove the reverse proxy configuration data and reload the reverse proxy."
msgstr ""
#: ../../admin/uninstall.rst:27
msgid "If you are using nginx:"
msgstr ""
#: ../../admin/uninstall.rst:37
msgid "If you are using Apache2:"
msgstr ""
#: ../../admin/uninstall.rst:46
msgid "Remove the systemd services:"
msgstr ""
#: ../../admin/uninstall.rst:62
msgid "Then, remove the database:"
msgstr ""
#: ../../admin/uninstall.rst:69
msgid "Finally, remove the user ``funkwhale`` and all funkwhale related data, including the server and the data:"
msgstr ""
#: ../../admin/uninstall.rst:77
msgid "The last command will remove ``/srv/funkwhale/``. On the default setup, this directory contains all user data. Please proceed cautiously!"
msgstr ""
#: ../../admin/uninstall.rst:79
msgid "However, it must be noted that:"
msgstr ""
#: ../../admin/uninstall.rst:82
msgid "In place imports will not be removed, provided they are not located in the directory ``/srv/funkwhale/``"
msgstr ""
#: ../../admin/uninstall.rst:86
msgid "If relevant, you might also want to:"
msgstr ""
#: ../../admin/uninstall.rst:88
msgid "remove the SSL certificates;"
msgstr ""
#: ../../admin/uninstall.rst:89
msgid "remove the corresponding DNS entries."
msgstr ""

135
docs/locales/gettext/admin/upgrading.pot 100644
Wyświetl plik

@ -0,0 +1,135 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/upgrading.rst:2
msgid "Upgrading your Funkwhale instance to a newer version"
msgstr ""
#: ../../admin/upgrading.rst:6
msgid "Before upgrading your instance, we strongly advise you to make at least a database backup. Ideally, you should make a full backup, including the database and the media files."
msgstr ""
#: ../../admin/upgrading.rst:9
msgid "We're commited to make upgrade as easy and straightforward as possible, however, Funkwhale is still in development and you'll be safer with a backup."
msgstr ""
#: ../../admin/upgrading.rst:14
msgid "Reading the release notes"
msgstr ""
#: ../../admin/upgrading.rst:16
msgid "Please take a few minutes to read the :doc:`../changelog`: updates should work similarly from version to version, but some of them may require additional steps. Those steps would be described in the version release notes."
msgstr ""
#: ../../admin/upgrading.rst:22
msgid "Insights about new versions"
msgstr ""
#: ../../admin/upgrading.rst:24
msgid "Some versions may be bigger than usual, and we'll try to detail the changes when possible."
msgstr ""
#: ../../admin/upgrading.rst:34
msgid "Docker setup"
msgstr ""
#: ../../admin/upgrading.rst:36
msgid "If you've followed the setup instructions in :doc:`../installation/docker`, upgrade path is easy:"
msgstr ""
#: ../../admin/upgrading.rst:40
msgid "Mono-container installation"
msgstr ""
#: ../../admin/upgrading.rst:42
msgid "Basically, you need to pull the new container image, stop and delete your existing container, and relaunch a new one:"
msgstr ""
#: ../../admin/upgrading.rst:45
msgid "To upgrade your service, change the version number of the image in ``docker-compose.yml`` with the latest release (i.e. |version|)."
msgstr ""
#: ../../admin/upgrading.rst:47
msgid "Pull the new images:"
msgstr ""
#: ../../admin/upgrading.rst:53
msgid "Restart the service:"
msgstr ""
#: ../../admin/upgrading.rst:60
msgid "Multi-container installation"
msgstr ""
#: ../../admin/upgrading.rst:86
#: ../../admin/upgrading.rst:194
msgid "You may sometimes get the following warning while applying migrations::"
msgstr ""
#: ../../admin/upgrading.rst:90
#: ../../admin/upgrading.rst:198
msgid "This is a warning, not an error, and it can be safely ignored. Never run the ``makemigrations`` command yourself."
msgstr ""
#: ../../admin/upgrading.rst:94
msgid "Upgrading the Postgres container"
msgstr ""
#: ../../admin/upgrading.rst:96
msgid "With some Funkwhale releases, it is recommended to upgrade the version of the Postgres database server container. For example, Funkwhale 0.17 recommended Postgres 9.4, but Funkwhale 0.18 recommends Postgres 11. When upgrading Postgres, it is not sufficient to change the container referenced in ``docker-compose.yml``. New major versions of Postgres cannot read the databases created by older major versions. The data has to be exported from a running instance of the old version and imported by the new version."
msgstr ""
#: ../../admin/upgrading.rst:104
msgid "Thankfully, there is a Docker container available to automate this process. You can use the following snippet to upgrade your database in ``./postgres``, keeping a backup of the old version in ``./postgres-old``:"
msgstr ""
#: ../../admin/upgrading.rst:126
msgid "Non-docker setup"
msgstr ""
#: ../../admin/upgrading.rst:128
msgid "If you installed Funkwhale using the install script, upgrading is done using ``sh -c \"$(curl -sSL https://get.funkwhale.audio/upgrade.sh)\"``. Make sure to run this command with root permissions."
msgstr ""
#: ../../admin/upgrading.rst:130
msgid "If you manually installed Funkwhale, please use the following instructions."
msgstr ""
#: ../../admin/upgrading.rst:133
msgid "Upgrade the static files"
msgstr ""
#: ../../admin/upgrading.rst:135
msgid "On non-docker setups, the front-end app is updated separately from the API. This is as simple as downloading the zip with the static files and extracting it in the correct place."
msgstr ""
#: ../../admin/upgrading.rst:139
msgid "The following example assume your setup match :ref:`frontend-setup`."
msgstr ""
#: ../../admin/upgrading.rst:151
msgid "Upgrading the API"
msgstr ""
#: ../../admin/upgrading.rst:153
msgid "On non-docker, upgrade involves a few more commands. We assume your setup match what is described in :doc:`/installation/debian`:"
msgstr ""
#: ../../admin/upgrading.rst:187
msgid "If you see a PermissionError when running the ``migrate`` command, try running the following commands by hand, and relaunch the migrations::"
msgstr ""

85
docs/locales/gettext/admin/url.pot 100644
Wyświetl plik

@ -0,0 +1,85 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../admin/url.rst:2
msgid "Changing Your Instance URL"
msgstr ""
#: ../../admin/url.rst:6
msgid "We highly recommend not to change your instance URL. Members of the community tried to do this and documented their steps here. This guide might be incomplete or fail for your instance. There is no support for this procedure and likely no way back."
msgstr ""
#: ../../admin/url.rst:9
msgid "At some point, you may wish to change your instance URL. In order to do this, you will need to change the following:"
msgstr ""
#: ../../admin/url.rst:12
msgid "The instance URL in your .env file"
msgstr ""
#: ../../admin/url.rst:13
msgid "The instance URL in your ``/etc/nginx/sites-enabled/funkwhale.conf`` or ``/etc/apache2/sites-enabled/funkwhale.conf`` depending on your web server setup"
msgstr ""
#: ../../admin/url.rst:14
msgid "Any references to the old URL in your database"
msgstr ""
#: ../../admin/url.rst:16
msgid "The changes to the database can be achieved with the ``fix_federation_ids`` script in the ``manage.py`` file."
msgstr ""
#: ../../admin/url.rst:19
msgid "Example output:"
msgstr ""
#: ../../admin/url.rst:53
msgid "On Docker Installations"
msgstr ""
#: ../../admin/url.rst:55
msgid "If you have followed the :doc:`Docker installation instructions <../installation/docker>`, you will need to do the following:"
msgstr ""
#: ../../admin/url.rst:58
#: ../../admin/url.rst:81
msgid "Edit your .env file to change the ``FUNKWHALE_HOSTNAME`` and ``DJANGO_ALLOWED_HOSTS`` value to your new URL"
msgstr ""
#: ../../admin/url.rst:59
#: ../../admin/url.rst:82
msgid "Edit your ``/etc/nginx/sites-enabled/funkwhale.conf`` file to change the ``server_name`` values to your new URL"
msgstr ""
#: ../../admin/url.rst:60
#: ../../admin/url.rst:83
msgid "Run the following command to change all mentions of your old instance URL in the database:"
msgstr ""
#: ../../admin/url.rst:66
#: ../../admin/url.rst:89
msgid "Restart Nginx or Apache to pick up the new changes"
msgstr ""
#: ../../admin/url.rst:77
msgid "On Non-Docker Installations"
msgstr ""
#: ../../admin/url.rst:79
msgid "If you have followed the :doc:`non-docker setup <../installation/debian>`, you will need to do the following:"
msgstr ""

33
docs/locales/gettext/administrator_documentation/index.pot 100644
Wyświetl plik

@ -0,0 +1,33 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/index.md:1
msgid "Get started"
msgstr ""
#: ../../administrator_documentation/index.md:3
msgid "Follow the guides in this section to set up and administrate your pod."
msgstr ""
#: ../../administrator_documentation/index.md:9
msgid "Install Funkwhale on your server"
msgstr ""
#: ../../administrator_documentation/index.md:11
msgid "Funkwhale is self-hosted, meaning you run it on your own server. To set up your own Funkwhale pod, check out [our installation guides](installation_docs/index.md). Choose the installation method that works for you!"
msgstr ""

361
docs/locales/gettext/administrator_documentation/installation_docs/debian.pot 100644
Wyświetl plik

@ -0,0 +1,361 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/installation_docs/debian.md:1
msgid "Install Funkwhale on Debian"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:3
msgid "We support [Debian](https://debian.org) and Debian-based Linux distributions. Follow these steps to set up Funkwhale on a Debian server."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:10
msgid "Before you begin"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:12
msgid "Set a `FUNKWHALE_VERSION` variable to the version you want to install. You will use this version for all commands in this guide."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:18
msgid "Install `curl`."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:25
msgid "1. Install Funkwhale dependencies"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:27
msgid "To install Funkwhale on your server, you first need to install its dependencies. We provide all dependencies in a single file to enable you to install everything at once. You can pass the information from this file to `apt` using the following command:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:33
msgid "When prompted, hit {kbd}`y` to confirm the install."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:35
msgid "That's it! `apt` installs all dependencies and tells you once it has finished."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:37
msgid "2. Create a Funkwhale user"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:39
msgid "It's good practice to create a user on your server for Funkwhale administration. Doing this makes it easy to make sure you're running commands from the right place. Follow these steps to set up your user."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:41
msgid "Create the `funkwhale` user and set its shell to `bash` and its home directory to `/srv/funkwhale`."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:47
msgid "Create a password for the user. You need to do this so that you can use this user to perform database administration."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:53
msgid "Finally, give the user `sudo` privileges. You need to do this so that the user can run administrative tasks."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:59
msgid "That's it! You've created your `funkwhale` user. Log in as this user when you want to perform any Funkwhale related tasks."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:61
msgid "3. Download Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:63
msgid "Once you've created your `funkwhale` user you can download the Funkwhale software itself."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:65
msgid "Create the directory layout"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:67
msgid "Log in to your `funkwhale` account and go to the `/srv/funkwhale` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:74
msgid "Create the directories for Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:80
msgid "That's it! Your directory structure should look like this:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:93
msgid "Download the Funkwhale release"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:95
msgid "Once you've created the directory structure you can download Funkwhale. Funkwhale comes in two parts: the API and the Frontend. You need both to run the application."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:97
msgid "Download the API."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:106
msgid "Download the frontend"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:116
msgid "You're done! These commands put the software in the correct location for Funkwhale to serve them."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:118
msgid "4. Install Python dependencies"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:120
msgid "The Funkwhale API is written in Python. You need to install the API's dependencies to run the software. We use [Poetry](https://python-poetry.org) to handle Python dependencies."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:122
msgid "Install Poetry. Follow the steps in this wizard to set it up."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:128
msgid "Add Poetry to your `$PATH`. This allows you to use `poetry` commands."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:134
msgid "Set up poetry in your `/srv/funkwhale/api` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:141
msgid "You're done! Poetry installs all Python dependencies."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:143
msgid "5. Set up your environment file"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:145
msgid "The environment file contains options you can use to control your Funkwhale pod. Follow these steps to get a working environment up and running."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:147
msgid "Download the `.env` template to your `/srv/funkwhale/config` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:153
msgid "Generate a secret key for Django. This keeps your Funkwhale data secure. Do not share this key with anybody."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:159
msgid "Reduce the permissions on your `.env` file to `600`. This means that only the `funkwhale` user can read and write this file."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:165
msgid "Open the `.env` file in a text editor. For this example, we will use `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:171
msgid "Update the following settings:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:172
msgid "Paste the secret key in the `DJANGO_SECRET_KEY` field."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:173
msgid "Populate the `DATABASE_URL` field:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:179
msgid "Populate the `CACHE_URL` field:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:185
msgid "Populate the `FUNKWHALE_HOSTNAME` field with the URL of your server."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:187
msgid "Hit {kbd}`ctrl + x` then {kbd}`y` to save the file and close `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:189
msgid "You're done! Your environment file is now ready to go. You can check out a full list of configuration options in our Environment file guide."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:191
msgid "6. Set up your database"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:193
msgid "Funkwhale uses a [PostgreSQL](https://www.postgresql.org/) database to store information. Follow these steps to set up your database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:195
msgid "Install PostgreSQL and the `postgresql-contrib` package. This package contains extra features that Funkwhale uses."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:201
msgid "Once you've installed PostgreSQL, launch a `psql` shell as the `postgres` user to set up your database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:207
msgid "Create your Funkwhale database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:213
msgid "Create a user for Funkwhale. This user needs all privileges so it can manage the database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:220
msgid "Once you're finished, exit the shell"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:226
msgid "Run the following commands to create extra extensions for the `funkwhale` database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:233
msgid "Your database is ready to be populated! Use the `manage.py` script to create the database structure."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:241
msgid "You may see the following warning when applying migrations:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:247
msgid "You can safely ignore this warning."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:250
msgid "That's it! You've finished setting up your database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:252
msgid "7. Set up Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:254
msgid "Once you have got your database up and running, you can get Funkwhale ready to launch. Use the built-in `manage.py` script to get things ready."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:256
msgid "Create a superuser for your pod"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:259
msgid "You can create several superusers."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:262
msgid "To start using Funkwhale, you need to create a superuser for your pod. This user has all the permissions needed to administrate the pod. Follow these steps to create a superuser."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:268
msgid "That's it! You can log in as this user when you finish setting up Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:270
msgid "Collect static files"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:272
msgid "Funkwhale uses several static assets to serve its frontend. Use `manage.py` to collect these files so that the webserver can serve them."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:278
msgid "8. Set up systemd unit files"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:280
msgid "Funkwhale uses [systemd](https://www.freedesktop.org/wiki/Software/systemd/) to manage its services. systemd helps prevent downtime by bringing services back up if they fail. It also starts your Funkwhale services after a reboot. Follow these steps to set up Funkwhale services with systemd."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:282
msgid "Download the sample unit files from Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:291
msgid "Reload systemd to register the new services."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:297
msgid "Start all Funkwhale services."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:303
msgid "Enable the services. Systemd can then start the services after a reboot."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:311
msgid "That's it! systemd keeps these services running and starts them up in the correct order after a reboot."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:313
msgid "9. Set up a reverse proxy"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:315
msgid "Funkwhale uses a reverse proxy to serve content to users. We use [Nginx](https://nginx.com) to serve this proxy. Follow this guide to install an Nginx configuration using details from your `.env` file."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:317
msgid "Install Nginx."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:324
msgid "Download the Nginx templates from Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:332
msgid "Create an Nginx template with details from your `.env` file."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:355
msgid "That's it! You've created your Nginx file. Run the following command to check the `.env` details populated correctly."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:361
msgid "10. Set up TLS"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:363
msgid "To enable your users to connect to your pod securely, you need to set up {abbr}`TLS (Transport Layer Security)`. To do this, we recommend using the <acme.sh> script."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:365
msgid "Log in as the superuser account to run these commands."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:371
msgid "Create the `/etc/certs` folder to store the certificates."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:377
msgid "Download and run `acme.sh`. Replace `my@example.com` with your email address."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:383
msgid "Generate a certificate. Replace `example.com` with your Funkwhale pod name. Use `/srv/funkwhale/front` as your web root folder."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:389
msgid "Install the certificate to your Nginx config. Replace `example.com` with your Funkwhale pod name."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:398
msgid "That's it! acme.sh renews your certificate every 60 days, so you don't need to about renewing it."
msgstr ""

213
docs/locales/gettext/administrator_documentation/installation_docs/docker.pot 100644
Wyświetl plik

@ -0,0 +1,213 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/installation_docs/docker.md:1
msgid "Install Funkwhale using Docker"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:3
msgid "Funkwhale is available as a containerized application. This enables you to run each service in containers rather than install them on your server. You can run Funkwhale using [Docker](https://docker.com) and Docker-Compose."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:6
msgid "This guide assumes you are using a [Debian](https://debian.org)-based system."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:13
msgid "Before you begin"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:15
msgid "Set a `FUNKWHALE_VERSION` variable to the version you want to install. You will use this version for all commands in this guide."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:21
msgid "Install [Docker](https://docs.docker.com/engine/install/) and [Docker Compose](https://docs.docker.com/compose/install/)."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:22
msgid "Install `curl`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:29
msgid "1. Download the project files"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:31
msgid "Create the project directory structure."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:37
msgid "Navigate to the project directory"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:43
msgid "Download the `docker-compose` template. This contains information about the containers and how they work together."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:49
msgid "Download the nginx templates. You need these to set up your reverse proxy."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:56
msgid "That's it! You've set up your project files. The directory structure looks like this:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:66
msgid "2. Set up your environment file"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:68
msgid "The environment file contains options you can use to control your Funkwhale pod. Follow these steps to get a working environment up and running."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:70
msgid "Download the `.env` template to your `/srv/funkwhale` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:76
msgid "Update `FUNKWHALE_VERSION` in the `.env` file to the `$FUNKWHALE_VERSION` variable you set earlier."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:82
msgid "Reduce the permissions on your `.env` file to `600`. This means that only your user can read and write this file."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:88
msgid "Generate a secret key for Django. This keeps your Funkwhale data secure. Do not share this key with anybody."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:94
msgid "Open the `.env` file in a text editor. For this example, we will use `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:100
msgid "Update the following settings:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:101
msgid "Paste the secret key in the `DJANGO_SECRET_KEY` field."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:102
msgid "Populate the `FUNKWHALE_HOSTNAME` field with the URL of your server."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:104
msgid "Hit {kbd}`ctrl + x` then {kbd}`y` to save the file and close `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:106
msgid "You're done! Your environment file is now ready to go. You can check out a full list of configuration options in our Environment file guide."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:108
msgid "3. Set up Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:110
msgid "Once you've filled in your environment file, you can set up Funkwhale. Follow these steps to create your database and create a superuser."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:112
msgid "Pull the containers to download all the required services."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:119
msgid "Bring up the database container so you can run the database migrations."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:125
msgid "Run the database migrations."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:132
msgid "You may see the following warning when applying migrations:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:138
msgid "You can safely ignore this warning."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:141
msgid "Create your superuser."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:147
msgid "Launch all the containers to bring up your pod."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:153
msgid "That's it! Your Funkwhale pod is now up and running."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:155
msgid "4. Set up your reverse proxy"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:157
msgid "Funkwhale uses a reverse proxy to serve content to users. We use [Nginx](https://nginx.com) to serve this proxy. Follow this guide to install an Nginx configuration using details from your `.env` file."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:159
msgid "Install Nginx."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:166
msgid "Download the Nginx templates from Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:173
msgid "Create an Nginx template with details from your `.env` file."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:196
msgid "That's it! You've created your Nginx file. Run the following command to check the `.env` details populated correctly."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:202
msgid "5. Set up TLS"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:204
msgid "To enable your users to connect to your pod securely, you need to set up {abbr}`TLS (Transport Layer Security)`. To do this, we recommend using the <acme.sh> script."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:206
msgid "Log in as the superuser account to run these commands."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:212
msgid "Create the `/etc/certs` folder to store the certificates."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:218
msgid "Download and run `acme.sh`. Replace `my@example.com` with your email address."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:224
msgid "Generate a certificate. Replace `example.com` with your Funkwhale pod name. Use `/srv/funkwhale/front` as your web root folder."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:230
msgid "Install the certificate to your Nginx config. Replace `example.com` with your Funkwhale pod name."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:239
msgid "That's it! acme.sh renews your certificate every 60 days, so you don't need to about renewing it."
msgstr ""

42
docs/locales/gettext/administrator_documentation/installation_docs/index.pot 100644
Wyświetl plik

@ -0,0 +1,42 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/installation_docs/index.md:10
#: ../../administrator_documentation/installation_docs/index.md:10
msgid "Choose your installation method"
msgstr ""
#: ../../administrator_documentation/installation_docs/index.md:1
msgid "Install Funkwhale on your server"
msgstr ""
#: ../../administrator_documentation/installation_docs/index.md:3
msgid "Choose your installation method and follow the guides to set up your pod."
msgstr ""
#: ../../administrator_documentation/installation_docs/index.md:5
msgid "Funkwhale requires the following:"
msgstr ""
#: ../../administrator_documentation/installation_docs/index.md:7
msgid "__A dedicated domain or subdomain__ – you can't run Funkwhale in a subdirectory of a domain. You need to run it on a domain or a subdomain. For example: `https://mypod.io` or `https://funkwhale.mysite.io`."
msgstr ""
#: ../../administrator_documentation/installation_docs/index.md:8
msgid "__Access to ports `80` and `443`__ – Funkwhale uses these ports for federation."
msgstr ""

61
docs/locales/gettext/administrator_documentation/installation_docs/quick_install.pot 100644
Wyświetl plik

@ -0,0 +1,61 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/installation_docs/quick_install.md:1
msgid "Install Funkwhale with the quick install script"
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:3
msgid "The quick install script is the easiest way to install Funkwhale. Run this script on a [Debian](https://debian.org)-based server to get your pod set up."
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:5
msgid "Before you begin"
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:7
msgid "You need `sudo` access to run the quick install script."
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:8
msgid "The quick install script installs Nginx, PostgreSQL, and Redis by default. You can customize this behavior by selecting the options in the script."
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:10
msgid "1. Install dependencies"
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:12
msgid "To download the quick install script, install `curl`:"
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:19
msgid "2. Install Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:21
msgid "Now that you have `curl` installed, download and run the quick install script:"
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:27
msgid "The script will prompt you to enter information about your instance. Follow the onscreen prompts until the script completes."
msgstr ""
#: ../../administrator_documentation/installation_docs/quick_install.md:29
msgid "That's it! You've finished installing Funkwhale. You should now be able to visit your pod in your web browser."
msgstr ""

49
docs/locales/gettext/administrator_documentation/installation_docs/third_party.pot 100644
Wyświetl plik

@ -0,0 +1,49 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/installation_docs/third_party.md:1
msgid "Third-party installation methods"
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:3
msgid "These installation methods are not provided by the Funkwhale project. If you have any issues with your installation, please contact the installation maintainers."
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:5
msgid "[YunoHost](https://github.com/YunoHost-Apps/funkwhale_ynh)"
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:6
msgid "[Arch Linux](https://wiki.archlinux.org/index.php/Funkwhale)"
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:7
msgid "[NixOS](https://github.com/mmai/funkwhale-nixos)"
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:8
msgid "[Kubernetes helm chart](https://gitlab.com/ananace/charts/)"
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:9
msgid "[HomelabOS](https://homelabos.com/docs/software/funkwhale/)"
msgstr ""
#: ../../administrator_documentation/installation_docs/third_party.md:10
msgid "[Docker swarm](https://github.com/fedeb95/funkwhale-swarm)"
msgstr ""

25
docs/locales/gettext/api.pot 100644
Wyświetl plik

@ -0,0 +1,25 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../api.rst:2
msgid "Funkwhale API"
msgstr ""
#: ../../api.rst:4
msgid "Funkwhale API is still a work in progress and should not be considered as stable. We offer an `interactive documentation using swagger </swagger/>`_ were you can browse available endpoints and try the API."
msgstr ""

6548
docs/locales/gettext/changelog.pot 100644
Wyświetl plik

Plik diff jest za duży Load Diff

1016
docs/locales/gettext/contributing.pot 100644
Wyświetl plik

Plik diff jest za duży Load Diff

158
docs/locales/gettext/developers/architecture.pot 100644
Wyświetl plik

@ -0,0 +1,158 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../developers/architecture.rst:2
msgid "Architecture"
msgstr ""
#: ../../developers/architecture.rst:4
msgid "Funkwhale is made of several components, each of them fulfilling a specific mission:"
msgstr ""
#: ../../developers/architecture.rst:33
msgid "This graph may looks a bit scary, so we'll detail the role of each component below."
msgstr ""
#: ../../developers/architecture.rst:36
msgid "The user"
msgstr ""
#: ../../developers/architecture.rst:38
msgid "Funkwhale users can interact with your instance using:"
msgstr ""
#: ../../developers/architecture.rst:40
msgid "The official web interface"
msgstr ""
#: ../../developers/architecture.rst:41
#: ../../developers/architecture.rst:51
msgid "Third-party apps"
msgstr ""
#: ../../developers/architecture.rst:44
msgid "The web interface"
msgstr ""
#: ../../developers/architecture.rst:46
msgid "This refers to Funkwhale's built-in web interface, which is a Single Page application written in Vue JS. This application will interact with Funkwhale's API to retrieve or persist data."
msgstr ""
#: ../../developers/architecture.rst:53
msgid "Since Funkwhale implements a subset of the Subsonic API, it's compatible with existing :doc:`apps <../users/apps>` such as DSub, Ultrasonic or Clementine that support this API. Those apps can be used as a replacement or in conjunction of the web interface, but the underlying data is the same."
msgstr ""
#: ../../developers/architecture.rst:58
msgid "The reverse proxy"
msgstr ""
#: ../../developers/architecture.rst:60
msgid "Funkwhale's API server should never be exposed directly to the internet, as we require a reverse proxy (Apache or Nginx) for performance and security reasons. The reverse proxy will receive client HTTP or HTTPS requests, and:"
msgstr ""
#: ../../developers/architecture.rst:64
msgid "Proxy them to the API server"
msgstr ""
#: ../../developers/architecture.rst:65
msgid "Serve requested static files (audio files, stylesheets, javascript, fonts...)"
msgstr ""
#: ../../developers/architecture.rst:68
msgid "The API server"
msgstr ""
#: ../../developers/architecture.rst:70
msgid "Funkwhale's API server is the central piece of the project. This component is responsible for answering and processing user requests, manipulate data from the database, send long-running tasks to workers, etc."
msgstr ""
#: ../../developers/architecture.rst:74
msgid "It's a Python/Django application."
msgstr ""
#: ../../developers/architecture.rst:77
msgid "The database"
msgstr ""
#: ../../developers/architecture.rst:79
msgid "Most of the data such as user accounts, favorites, music metadata or playlist is stored in a PostgreSQL database."
msgstr ""
#: ../../developers/architecture.rst:83
msgid "The cache/message queue"
msgstr ""
#: ../../developers/architecture.rst:85
msgid "Fetching data from the database is sometimes slow or resource hungry. To reduce the load, Redis act as a cache for data that is considerably faster than a database."
msgstr ""
#: ../../developers/architecture.rst:88
msgid "It is also a message queue that will deliver tasks to the worker."
msgstr ""
#: ../../developers/architecture.rst:91
msgid "The worker"
msgstr ""
#: ../../developers/architecture.rst:93
msgid "Some operations are too long to live in the HTTP request/response cycle. Typically, importing a bunch of uploaded tracks could take a minute or two."
msgstr ""
#: ../../developers/architecture.rst:96
msgid "To keep the API response time as fast as possible, we offload long-running tasks to a background process, also known as the Celery worker."
msgstr ""
#: ../../developers/architecture.rst:99
msgid "Typical tasks include:"
msgstr ""
#: ../../developers/architecture.rst:101
msgid "Handling music imports"
msgstr ""
#: ../../developers/architecture.rst:102
msgid "Handling federation/ActivityPub messages"
msgstr ""
#: ../../developers/architecture.rst:103
msgid "Scanning other instances libraries"
msgstr ""
#: ../../developers/architecture.rst:105
msgid "This worker is also able to retry failed tasks, or spawn automatically more process when the number of received tasks increase."
msgstr ""
#: ../../developers/architecture.rst:109
msgid "The scheduler"
msgstr ""
#: ../../developers/architecture.rst:111
msgid "Some long-running tasks are not triggered by user or external input, but on a recurring basis instead. The scheduler is responsible for triggering those tasks and put the corresponding messages in the message queue so the worker can process them."
msgstr ""
#: ../../developers/architecture.rst:115
msgid "Recurring tasks include:"
msgstr ""
#: ../../developers/architecture.rst:117
msgid "Cache cleaning"
msgstr ""
#: ../../developers/architecture.rst:118
msgid "Music metadata refreshing"
msgstr ""

237
docs/locales/gettext/developers/authentication.pot 100644
Wyświetl plik

@ -0,0 +1,237 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../developers/authentication.rst:2
msgid "API Authentication"
msgstr ""
#: ../../developers/authentication.rst:4
msgid "Each Funkwhale API endpoint supports access from:"
msgstr ""
#: ../../developers/authentication.rst:6
msgid "Anonymous users (if the endpoint is configured to do so, for exemple via the ``API Authentication Required`` setting)"
msgstr ""
#: ../../developers/authentication.rst:7
msgid "Logged-in users"
msgstr ""
#: ../../developers/authentication.rst:8
msgid "Third-party apps (via OAuth2)"
msgstr ""
#: ../../developers/authentication.rst:10
msgid "To seamlessly support this range of access modes, we internally use oauth scopes to describes what permissions are required to perform any given operation."
msgstr ""
#: ../../developers/authentication.rst:14
msgid "OAuth"
msgstr ""
#: ../../developers/authentication.rst:17
msgid "Create an app"
msgstr ""
#: ../../developers/authentication.rst:19
msgid "To connect to Funkwhale API via OAuth, you need to create an application. There are two ways to do that:"
msgstr ""
#: ../../developers/authentication.rst:22
msgid "By visiting ``/settings/applications/new`` when logged in on your Funkwhale instance."
msgstr ""
#: ../../developers/authentication.rst:23
msgid "By sending a ``POST`` request to ``/api/v1/oauth/apps/``, as described in `our API documentation <https://docs.funkwhale.audio/swagger/>`_."
msgstr ""
#: ../../developers/authentication.rst:25
msgid "Both method will give you a client ID and secret."
msgstr ""
#: ../../developers/authentication.rst:28
msgid "Getting an access token"
msgstr ""
#: ../../developers/authentication.rst:30
msgid "Once you have a client ID and secret, you can request access tokens using the `authorization code grant flow <https://tools.ietf.org/html/rfc6749#section-4.1>`_."
msgstr ""
#: ../../developers/authentication.rst:33
msgid "We support the ``urn:ietf:wg:oauth:2.0:oob`` redirect URI for non-web applications, as well as traditionnal redirection-based flow."
msgstr ""
#: ../../developers/authentication.rst:36
msgid "Our authorization endpoint is located at ``/authorize``, and our token endpoint at ``/api/v1/oauth/token/``."
msgstr ""
#: ../../developers/authentication.rst:39
msgid "Refreshing tokens"
msgstr ""
#: ../../developers/authentication.rst:41
msgid "When your access token is expired, you can `request a new one as described in the OAuth specification <https://tools.ietf.org/html/rfc6749#section-6>`_."
msgstr ""
#: ../../developers/authentication.rst:44
msgid "Security considerations"
msgstr ""
#: ../../developers/authentication.rst:46
msgid "Grant codes are valid for a 5 minutes after authorization request is approved by the end user."
msgstr ""
#: ../../developers/authentication.rst:47
msgid "Access codes are valid for 10 hours. When expired, you will need to request a new one using your refresh token."
msgstr ""
#: ../../developers/authentication.rst:48
msgid "We return a new refresh token everytime an access token is requested, and invalidate the old one. Ensure you store the new refresh token in your app."
msgstr ""
#: ../../developers/authentication.rst:52
msgid "Scopes"
msgstr ""
#: ../../developers/authentication.rst:54
msgid "Scopes are defined in :file:`funkwhale_api/users/oauth/scopes.py:BASE_SCOPES`, and generally are mapped to a business-logic resources (follows, favorites, etc.). All those base scopes come in two flawours:"
msgstr ""
#: ../../developers/authentication.rst:56
msgid "`read:<base_scope>`: get read-only access to the resource"
msgstr ""
#: ../../developers/authentication.rst:57
msgid "`write:<base_scope>`: get write-only access to the ressource"
msgstr ""
#: ../../developers/authentication.rst:59
msgid "For example, ``playlists`` is a base scope, and ``write:playlists`` is the actual scope needed to perform write operations on playlists (via a ``POST``, ``PATCH``, ``PUT`` or ``DELETE``. ``read:playlists`` is used to perform read operations on playlists such as fetching a given playlist via ``GET``."
msgstr ""
#: ../../developers/authentication.rst:63
msgid "Having the generic ``read`` or ``write`` scope give you the corresponding access on *all* resources."
msgstr ""
#: ../../developers/authentication.rst:65
msgid "This is the list of OAuth scopes that third-party applications can request:"
msgstr ""
#: ../../developers/authentication.rst:69
msgid "Scope"
msgstr ""
#: ../../developers/authentication.rst:69
msgid "Description"
msgstr ""
#: ../../developers/authentication.rst:71
msgid "``read``"
msgstr ""
#: ../../developers/authentication.rst:71
msgid "Read-only access to all data (equivalent to all ``read:*`` scopes)"
msgstr ""
#: ../../developers/authentication.rst:74
msgid "``write``"
msgstr ""
#: ../../developers/authentication.rst:74
msgid "Write-only access to all data (equivalent to all ``write:*`` scopes)"
msgstr ""
#: ../../developers/authentication.rst:77
msgid "``<read/write>:profile``"
msgstr ""
#: ../../developers/authentication.rst:77
msgid "Access to profile data (e-mail address, username, etc.)"
msgstr ""
#: ../../developers/authentication.rst:79
msgid "``<read/write>:libraries``"
msgstr ""
#: ../../developers/authentication.rst:79
msgid "Access to library data (uploads, libraries tracks, albums, artists...)"
msgstr ""
#: ../../developers/authentication.rst:82
msgid "``<read/write>:favorites``"
msgstr ""
#: ../../developers/authentication.rst:82
msgid "Access to favorites"
msgstr ""
#: ../../developers/authentication.rst:84
msgid "``<read/write>:listenings``"
msgstr ""
#: ../../developers/authentication.rst:84
msgid "Access to history"
msgstr ""
#: ../../developers/authentication.rst:86
msgid "``<read/write>:follows``"
msgstr ""
#: ../../developers/authentication.rst:86
msgid "Access to followers"
msgstr ""
#: ../../developers/authentication.rst:88
msgid "``<read/write>:playlists``"
msgstr ""
#: ../../developers/authentication.rst:88
msgid "Access to playlists"
msgstr ""
#: ../../developers/authentication.rst:90
msgid "``<read/write>:radios``"
msgstr ""
#: ../../developers/authentication.rst:90
msgid "Access to radios"
msgstr ""
#: ../../developers/authentication.rst:92
msgid "``<read/write>:filters``"
msgstr ""
#: ../../developers/authentication.rst:92
msgid "Access to content filters"
msgstr ""
#: ../../developers/authentication.rst:94
msgid "``<read/write>:notifications``"
msgstr ""
#: ../../developers/authentication.rst:94
msgid "Access to notifications"
msgstr ""
#: ../../developers/authentication.rst:96
msgid "``<read/write>:edits``"
msgstr ""
#: ../../developers/authentication.rst:96
msgid "Access to metadata edits"
msgstr ""

25
docs/locales/gettext/developers/index.pot 100644
Wyświetl plik

@ -0,0 +1,25 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../developers/index.rst:2
msgid "Developer documentation"
msgstr ""
#: ../../developers/index.rst:4
msgid "This documentation is targeted primarily at developers who want to understand how Funkwhale works and how to build apps that integrate with Funkwhale's ecosystem."
msgstr ""

173
docs/locales/gettext/developers/plugins.pot 100644
Wyświetl plik

@ -0,0 +1,173 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../developers/plugins.rst:2
msgid "Funkwhale plugins"
msgstr ""
#: ../../developers/plugins.rst:4
msgid "Starting with Funkwhale 1.0, it is now possible to implement new features via plugins."
msgstr ""
#: ../../developers/plugins.rst:7
msgid "Some plugins are maintained by the Funkwhale team (e.g. this is the case of the ``scrobbler`` plugin), or by third-parties."
msgstr ""
#: ../../developers/plugins.rst:11
msgid "Installing a plugin"
msgstr ""
#: ../../developers/plugins.rst:13
msgid "To install a plugin, ensure its directory is present in the ``FUNKWHALE_PLUGINS_PATH`` directory."
msgstr ""
#: ../../developers/plugins.rst:15
msgid "Then, add its name to the ``FUNKWHALE_PLUGINS`` environment variable, like this::"
msgstr ""
#: ../../developers/plugins.rst:19
msgid "We provide a command to make it easy to install third-party plugins::"
msgstr ""
#: ../../developers/plugins.rst:25
msgid "If you use the command, you will still need to append the plugin name to ``FUNKWHALE_PLUGINS``"
msgstr ""
#: ../../developers/plugins.rst:29
msgid "Types of plugins"
msgstr ""
#: ../../developers/plugins.rst:31
msgid "There are two types of plugins:"
msgstr ""
#: ../../developers/plugins.rst:33
msgid "Plugins that are accessible to end-users, a.k.a. user-level plugins. This is the case of our Scrobbler plugin"
msgstr ""
#: ../../developers/plugins.rst:34
msgid "Pod-level plugins that are configured by pod admins and are not tied to a particular user"
msgstr ""
#: ../../developers/plugins.rst:36
msgid "Additionally, user-level plugins can be regular plugins or source plugins. A source plugin provides a way to import files from a third-party service, e.g via webdav, FTP or something similar."
msgstr ""
#: ../../developers/plugins.rst:40
msgid "Hooks and filters"
msgstr ""
#: ../../developers/plugins.rst:42
msgid "Funkwhale includes two kind of entrypoints for plugins to use: hooks and filters. B"
msgstr ""
#: ../../developers/plugins.rst:44
msgid "Hooks should be used when you want to react to some change. For instance, the ``LISTENING_CREATED`` hook notify each registered callback that a listening was created. Our ``scrobbler`` plugin has a callback registered to this hook, so that it can notify Last.fm properly:"
msgstr ""
#: ../../developers/plugins.rst:57
msgid "Filters work slightly differently, and expect callbacks to return a value that will be used by Funkwhale."
msgstr ""
#: ../../developers/plugins.rst:59
msgid "For instance, the ``PLUGINS_DEPENDENCIES`` filter can be used as a way to install additional dependencies needed by your plugin:"
msgstr ""
#: ../../developers/plugins.rst:72
msgid "To sum it up, hooks are used when you need to react to something, and filters when you need to alter something."
msgstr ""
#: ../../developers/plugins.rst:75
msgid "Writing a plugin"
msgstr ""
#: ../../developers/plugins.rst:77
msgid "Regardless of the type of plugin you want to write, lots of concepts are similar."
msgstr ""
#: ../../developers/plugins.rst:79
msgid "First, a plugin need three files:"
msgstr ""
#: ../../developers/plugins.rst:81
msgid "a ``__init__.py`` file, since it's a Python package"
msgstr ""
#: ../../developers/plugins.rst:82
msgid "a ``funkwhale_startup.py`` file, that is loaded during Funkwhale initialization"
msgstr ""
#: ../../developers/plugins.rst:83
msgid "a ``funkwhale_ready.py`` file, that is loaded when Funkwhale is configured and ready"
msgstr ""
#: ../../developers/plugins.rst:85
msgid "So your plugin directory should look like this::"
msgstr ""
#: ../../developers/plugins.rst:92
msgid "Now, let's write our plugin!"
msgstr ""
#: ../../developers/plugins.rst:94
msgid "``funkwhale_startup.py`` is where you declare your plugin and it's configuration options:"
msgstr ""
#: ../../developers/plugins.rst:114
msgid "Now that our plugin is declared and configured, let's implement actual functionality in ``funkwhale_ready.py``:"
msgstr ""
#: ../../developers/plugins.rst:149
msgid "And that's pretty much it. Now, login, visit https://yourpod.domain/settings/plugins, set a value in the ``greeting`` field and enable the plugin."
msgstr ""
#: ../../developers/plugins.rst:151
msgid "After that, you should be greeted properly if you go to https://yourpod.domain/greeting."
msgstr ""
#: ../../developers/plugins.rst:154
msgid "Hooks reference"
msgstr ""
#: ../../docstring of config.plugins.LISTENING_CREATED:1
msgid "Called when a track is being listened"
msgstr ""
#: ../../developers/plugins.rst:159
msgid "Filters reference"
msgstr ""
#: ../../docstring of config.plugins.PLUGINS_DEPENDENCIES:1
msgid "Called with an empty list, use this filter to append pip dependencies to the list for installation."
msgstr ""
#: ../../docstring of config.plugins.PLUGINS_APPS:1
msgid "Called with an empty list, use this filter to append apps to INSTALLED_APPS"
msgstr ""
#: ../../docstring of config.plugins.MIDDLEWARES_BEFORE:1
msgid "Called with an empty list, use this filter to prepend middlewares to MIDDLEWARE"
msgstr ""
#: ../../docstring of config.plugins.MIDDLEWARES_AFTER:1
msgid "Called with an empty list, use this filter to append middlewares to MIDDLEWARE"
msgstr ""
#: ../../docstring of config.plugins.URLS:1
msgid "Called with an empty list, use this filter to register new urls and views"
msgstr ""

165
docs/locales/gettext/developers/subsonic.pot 100644
Wyświetl plik

@ -0,0 +1,165 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../developers/subsonic.rst:2
msgid "Subsonic API"
msgstr ""
#: ../../developers/subsonic.rst:4
msgid "Funkwhale implements a subset of the `Subsonic API <http://www.subsonic.org/pages/api.jsp>`_ that makes it compatible with various apps in the Subsonic ecosystem (See :doc:`../users/apps`)."
msgstr ""
#: ../../developers/subsonic.rst:8
msgid "Supported endpoints"
msgstr ""
#: ../../developers/subsonic.rst:10
msgid "We seek the best compatibility with existing apps and will eventually implement all endpoints that match Funkwhale's feature set. However, the current implementation do not include folder-based endpoints, as it does not match our internal model at all and will require substantial effort to emulate."
msgstr ""
#: ../../developers/subsonic.rst:15
msgid "We'll try to keep this list up-to-date, but you can also browse `the relevant code <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/subsonic/views.py>`_ if needed."
msgstr ""
#: ../../developers/subsonic.rst:19
msgid "As of today, the following endpoints are implemented:"
msgstr ""
#: ../../developers/subsonic.rst:21
msgid "createPlaylist"
msgstr ""
#: ../../developers/subsonic.rst:22
msgid "deletePlaylist"
msgstr ""
#: ../../developers/subsonic.rst:23
msgid "getAlbum"
msgstr ""
#: ../../developers/subsonic.rst:24
msgid "getAlbumList2"
msgstr ""
#: ../../developers/subsonic.rst:25
msgid "getArtist"
msgstr ""
#: ../../developers/subsonic.rst:26
msgid "getArtistInfo2"
msgstr ""
#: ../../developers/subsonic.rst:27
msgid "getArtists"
msgstr ""
#: ../../developers/subsonic.rst:28
msgid "getAvatar"
msgstr ""
#: ../../developers/subsonic.rst:29
msgid "getCoverArt"
msgstr ""
#: ../../developers/subsonic.rst:30
msgid "getIndexes"
msgstr ""
#: ../../developers/subsonic.rst:31
msgid "getLicense"
msgstr ""
#: ../../developers/subsonic.rst:32
msgid "getMusicFolders"
msgstr ""
#: ../../developers/subsonic.rst:33
msgid "getPlaylist"
msgstr ""
#: ../../developers/subsonic.rst:34
msgid "getPlaylists"
msgstr ""
#: ../../developers/subsonic.rst:35
msgid "getRandomSongs"
msgstr ""
#: ../../developers/subsonic.rst:36
msgid "getSong"
msgstr ""
#: ../../developers/subsonic.rst:37
msgid "getStarred"
msgstr ""
#: ../../developers/subsonic.rst:38
msgid "getStarred2"
msgstr ""
#: ../../developers/subsonic.rst:39
msgid "getUser"
msgstr ""
#: ../../developers/subsonic.rst:40
msgid "ping"
msgstr ""
#: ../../developers/subsonic.rst:41
msgid "scrobble"
msgstr ""
#: ../../developers/subsonic.rst:42
msgid "search3"
msgstr ""
#: ../../developers/subsonic.rst:43
msgid "star"
msgstr ""
#: ../../developers/subsonic.rst:44
msgid "stream"
msgstr ""
#: ../../developers/subsonic.rst:45
msgid "unstar"
msgstr ""
#: ../../developers/subsonic.rst:46
msgid "updatePlaylist"
msgstr ""
#: ../../developers/subsonic.rst:48
msgid "We support both XML and JSON formats for all those endpoints."
msgstr ""
#: ../../developers/subsonic.rst:51
msgid "Additional properties"
msgstr ""
#: ../../developers/subsonic.rst:53
msgid "Regardless of the endpoints, we always return those additional properties in our payload, which you can use to adapt your client behaviour if needed:"
msgstr ""
#: ../../developers/subsonic.rst:66
msgid "Testing a Subsonic app"
msgstr ""
#: ../../developers/subsonic.rst:68
msgid "We maintain a demo server at https://demo.funkwhale.audio/, which you can use for your tests. Example with the ping endpoint: https://demo.funkwhale.audio/rest/ping.view?f=json"
msgstr ""

182
docs/locales/gettext/documentation/creating.pot 100644
Wyświetl plik

@ -0,0 +1,182 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/creating.rst:2
msgid "Adding New Documents"
msgstr ""
#: ../../documentation/creating.rst:5
msgid "Writing Documents"
msgstr ""
#: ../../documentation/creating.rst:7
msgid "Before you start writing documents:"
msgstr ""
#: ../../documentation/creating.rst:9
msgid "Make sure you have all the necessary information and :doc:`tools you need <tools>` to get started"
msgstr ""
#: ../../documentation/creating.rst:10
msgid "Check the `current documents <https://docs.funkwhale.audio>`_ carefully to make sure you're not repeating something somebody has already said"
msgstr ""
#: ../../documentation/creating.rst:11
msgid "Familiarize yourself with :doc:`reStructuredText <restructured>` and :doc:`the recommended document style <style>`"
msgstr ""
#: ../../documentation/creating.rst:13
msgid "Once you're ready to get started, you can start :ref:`working with Gitlab <work-with-gitlab>`"
msgstr ""
#: ../../documentation/creating.rst:18
msgid "Working With Gitlab"
msgstr ""
#: ../../documentation/creating.rst:20
msgid "Documents are managed in the Funkwhale `Gitlab <https://dev.funkwhale.audio>`_ repository along with the code. In order to add new documents, you will need to follow this process:"
msgstr ""
#: ../../documentation/creating.rst:23
msgid ":ref:`Sign up to Gitlab <sign-up>`"
msgstr ""
#: ../../documentation/creating.rst:24
msgid ":ref:`Fork the project <fork-project>`"
msgstr ""
#: ../../documentation/creating.rst:25
msgid ":ref:`Clone the Repository <clone-repo>`"
msgstr ""
#: ../../documentation/creating.rst:26
msgid ":ref:`Add documents to your branch <add-docs>`"
msgstr ""
#: ../../documentation/creating.rst:27
msgid ":ref:`Create a Merge Request <merge-request>`"
msgstr ""
#: ../../documentation/creating.rst:32
msgid "Signing up to Gitlab"
msgstr ""
#: ../../documentation/creating.rst:34
msgid "Before you can contribute documents to Funkwhale, you will need to set up an account on the project's `Gitlab <https://dev.funkwhale.audio>`_. To do this:"
msgstr ""
#: ../../documentation/creating.rst:37
msgid "Navigate to the https://dev.funkwhale.audio"
msgstr ""
#: ../../documentation/creating.rst:38
msgid "Click on \"register\" to bring up the registration form"
msgstr ""
#: ../../documentation/creating.rst:39
msgid "Fill in the relevant details, or alternatively sign up with Github if you already have an account"
msgstr ""
#: ../../documentation/creating.rst:40
msgid "[Optional]: You can then `set up an SSH key <https://docs.gitlab.com/ee/ssh/>`_ to enable easy management of your :ref:`repository <clone-repo>`"
msgstr ""
#: ../../documentation/creating.rst:45
msgid "Fork the project"
msgstr ""
#: ../../documentation/creating.rst:47
msgid "Once you have set up an account, you can `fork the project <https://help.github.com/en/articles/fork-a-repo>`_ to create a copy of the repository that you can make changes to."
msgstr ""
#: ../../documentation/creating.rst:50
#: ../../documentation/creating.rst:117
msgid "Navigate to the `Funkwhale repository <https://dev.funkwhale.audio/funkwhale/funkwhale>`_"
msgstr ""
#: ../../documentation/creating.rst:51
msgid "Click \"Fork\" at the top of the repository"
msgstr ""
#: ../../documentation/creating.rst:52
msgid "You will be redirected to a new version of the project. This one's all yours!"
msgstr ""
#: ../../documentation/creating.rst:57
msgid "Clone the Repository"
msgstr ""
#: ../../documentation/creating.rst:59
msgid "Once you have successfully forked the project, you can safely download a copy of this to your local computer to create documents."
msgstr ""
#: ../../documentation/creating.rst:72
msgid "Once you've cloned the repository, it's a good idea to create a new branch for your documents so that you can :ref:`merge it later <merge-request>`"
msgstr ""
#: ../../documentation/creating.rst:88
msgid "Add Documents to Your Branch"
msgstr ""
#: ../../documentation/creating.rst:90
msgid "When you've got your repository all set up, you can start writing your documents. Remember to keep in mind :doc:`who you are writing for <style>` when you are writing, and :doc:`check your syntax works <restructured>`."
msgstr ""
#: ../../documentation/creating.rst:93
msgid "Once you've written what you need to write, you can push these changes to your forked repository:"
msgstr ""
#: ../../documentation/creating.rst:112
msgid "Create a Merge Request"
msgstr ""
#: ../../documentation/creating.rst:114
msgid "Once you've pushed all of your documents, you can create a `Merge Request <https://docs.gitlab.com/ee/gitlab-basics/add-merge-request.html>`_ to request the documents be merged into the official Funkwhale develop branch."
msgstr ""
#: ../../documentation/creating.rst:118
msgid "Click \"Merge Requests\" on the left hand side"
msgstr ""
#: ../../documentation/creating.rst:119
msgid "Click on the \"New Merge Request\""
msgstr ""
#: ../../documentation/creating.rst:120
msgid "Under the \"Source Branch\" select your forked repository and the branch to which you've pushed changes"
msgstr ""
#: ../../documentation/creating.rst:121
msgid "Under \"Target Branch\", select the \"develop\" branch"
msgstr ""
#: ../../documentation/creating.rst:122
msgid "Click \"Compare Branches and Continue\""
msgstr ""
#: ../../documentation/creating.rst:123
msgid "In the form that comes up, provide a title/description of the changes you've made"
msgstr ""
#: ../../documentation/creating.rst:124
msgid "Click \"Submit Merge Request\" to submit"
msgstr ""
#: ../../documentation/creating.rst:126
msgid "That's it! If your merge request is successful, you will get a notification from one of the maintainers letting you know your changes have been accepted. Sometimes, you may need to make minor corrections. Don't worry! We'll let you know what needs correcting."
msgstr ""

57
docs/locales/gettext/documentation/identifying.pot 100644
Wyświetl plik

@ -0,0 +1,57 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/identifying.rst:2
msgid "Identifying Gaps in Funkwhale Documentation"
msgstr ""
#: ../../documentation/identifying.rst:4
msgid "As Funkwhale and its community continue to grow and develop, more and more processes and features will need to be documented. As users find interesting new ways to interact with the software, provide novel solutions to existing issues, and find information they need missing, the documents will need to be updated and added to."
msgstr ""
#: ../../documentation/identifying.rst:9
msgid "If you are trying to do something in Funkwhale and can't find any resources to help, you can help out by contributing in one of the following ways:"
msgstr ""
#: ../../documentation/identifying.rst:13
msgid "Providing Documentation"
msgstr ""
#: ../../documentation/identifying.rst:15
msgid "If you've identified a gap or mistake in the documentation and feel comfortable writing up new guides/correcting existing ones, please feel free to do so. The best way to do this is by following the :doc:`document creation guide <creating>` to make sure your documents get processed as quickly as possible."
msgstr ""
#: ../../documentation/identifying.rst:21
msgid "Requesting Documentation"
msgstr ""
#: ../../documentation/identifying.rst:23
msgid "If you're not comfortable with writing documents or don't feel like you can, you can help out by requesting a document be written. There are three ways to request new documents:"
msgstr ""
#: ../../documentation/identifying.rst:26
msgid "Open a new issue on `Gitlab <https://dev.funkwhale.audio/funkwhale/funkwhale/issues>`_, providing as much detail as possible"
msgstr ""
#: ../../documentation/identifying.rst:27
msgid "Start a new thread on `the forum <https://forum.funkwhale.audio/>`_ with more details about your requests"
msgstr ""
#: ../../documentation/identifying.rst:28
msgid "Ask somebody on our `chat room <https://matrix.to/#/#funkwhale:matrix.org>`_"
msgstr ""

33
docs/locales/gettext/documentation/index.pot 100644
Wyświetl plik

@ -0,0 +1,33 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/index.rst:2
msgid "Contribute to Funkwhale's Documentation"
msgstr ""
#: ../../documentation/index.rst:4
msgid "Funkwhale is constantly growing and changing, so good documentation is essential. If you find a gap or mistake in existing documents, or you want to create new documents to cover something that isn't covered yet, you can follow this procedure to contribute to Funkwhale's documentation store."
msgstr ""
#: ../../documentation/index.rst:10
msgid "Setup"
msgstr ""
#: ../../documentation/index.rst:20
msgid "Contributing"
msgstr ""

69
docs/locales/gettext/documentation/rearrange.pot 100644
Wyświetl plik

@ -0,0 +1,69 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/rearrange.rst:2
msgid "Rearranging Files"
msgstr ""
#: ../../documentation/rearrange.rst:4
msgid "Sometimes, rearranging the layout of documents in the docs folder can help to make things a bit clearer for users. However, this can present the following issues:"
msgstr ""
#: ../../documentation/rearrange.rst:7
msgid ":ref:`Orphaned document links <orphaned-doc>`"
msgstr ""
#: ../../documentation/rearrange.rst:8
msgid ":ref:`Orphaned URLs <orphaned-url>`"
msgstr ""
#: ../../documentation/rearrange.rst:13
msgid "Orphaned Document Links"
msgstr ""
#: ../../documentation/rearrange.rst:15
msgid "Documents frequently reference other documents to avoid repeating information. If you move a document, you need to be sure to update any orphaned references."
msgstr ""
#: ../../documentation/rearrange.rst:18
msgid "Running ``make html`` in the ``docs`` directory (assuming you have :doc:`Sphinx installed <tools>`) will generate a series of warnings letting you know if any links are orphaned."
msgstr ""
#: ../../documentation/rearrange.rst:25
msgid "You can then go to the file/line in question and update the link to its new location."
msgstr ""
#: ../../documentation/rearrange.rst:30
msgid "Orphaned URLs"
msgstr ""
#: ../../documentation/rearrange.rst:32
msgid "Once internal document links have been resolved, it is important to consider that the moved file may have also been linked externally elsewhere before. In order to ensure that anybody trying to access the file is properly redirected to its new location, we need to make use of the link redirector in the ``conf.py`` file."
msgstr ""
#: ../../documentation/rearrange.rst:37
msgid "The link redirector takes two arguments: the old location of the file (passed as a .html file at the relative path ``docs``), and the new location it should redirect to. For example, if a document was moved from ``docs/index.html`` to ``docs/admin/index.html``, we would add the following to the ``redirect_files`` section of ``conf.py``:"
msgstr ""
#: ../../documentation/rearrange.rst:53
msgid "If you are moving something from one folder to another, you would need to tell the redirect to move to the correct level. For example, if a file is moving from ``docs/admin/index.html`` to ``docs/users/index.html``, you will need to add the following to the ``redirect_files`` section of ``conf.py``:"
msgstr ""
#: ../../documentation/rearrange.rst:69
msgid "The script will then take these two arguments and create a redirect file in the original location so that anybody accessing the existing URL will be redirected."
msgstr ""

89
docs/locales/gettext/documentation/restructured.pot 100644
Wyświetl plik

@ -0,0 +1,89 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/restructured.rst:2
msgid "Writing reStructuredText"
msgstr ""
#: ../../documentation/restructured.rst:4
msgid "Funkwhale's documentation is written using a standard markup language called `reStructuredText <http://docutils.sourceforge.net/rst.html>`_. It is similar to Markdown and other web-based markup languages, but is better suited to technical documentation due to its standardized nature. A full syntax breakdown can be found `here <http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html>`_, but the following should be enough to get you started on writing docs for Funkwhale."
msgstr ""
#: ../../documentation/restructured.rst:11
msgid "Headings"
msgstr ""
#: ../../documentation/restructured.rst:13
msgid "Headings are useful for splitting up text into relevant subsections. With `Sphinx <http://www.sphinx-doc.org/>`_, major headers and direct subheaders are rendered as navigation links on Index pages, which makes them ideal for sharing specific information quickly."
msgstr ""
#: ../../documentation/restructured.rst:17
msgid "Headers are written like so:"
msgstr ""
#: ../../documentation/restructured.rst:32
msgid "Underlines should be **at least** as long as the words they underline"
msgstr ""
#: ../../documentation/restructured.rst:35
msgid "Links"
msgstr ""
#: ../../documentation/restructured.rst:37
msgid "Links can be rendered in several different ways depending on where they link to:"
msgstr ""
#: ../../documentation/restructured.rst:45
msgid "Inline references can also be generated using the following syntax:"
msgstr ""
#: ../../documentation/restructured.rst:56
msgid "Lists"
msgstr ""
#: ../../documentation/restructured.rst:58
msgid "Bullet point lists are usually written using dashes like so:"
msgstr ""
#: ../../documentation/restructured.rst:67
msgid "Blocks"
msgstr ""
#: ../../documentation/restructured.rst:69
msgid "Blocks can be used to easily and concisely present information to a reader and are particularly useful when demonstrating technical steps. Blocks in reStructuredText can be written as follows:"
msgstr ""
#: ../../documentation/restructured.rst:87
msgid "Other syntax highlighting is available. See the spec for full details."
msgstr ""
#: ../../documentation/restructured.rst:91
msgid "Content within code blocks should be indented by three spaces. You can end the code block by removing the indent."
msgstr ""
#: ../../documentation/restructured.rst:95
msgid "Notes and Warnings"
msgstr ""
#: ../../documentation/restructured.rst:97
msgid "Notes are great for presenting important information to users and providing additional context. Warnings can be very useful if a step you're writing about could potentially have adverse consequences."
msgstr ""
#: ../../documentation/restructured.rst:112
msgid "Content within notes and warnings should be indented by three spaces. You can end the block by removing the indent."
msgstr ""

65
docs/locales/gettext/documentation/style.pot 100644
Wyświetl plik

@ -0,0 +1,65 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/style.rst:2
msgid "Documentation Style Guide"
msgstr ""
#: ../../documentation/style.rst:5
msgid "End-user Documentation"
msgstr ""
#: ../../documentation/style.rst:7
msgid "End-user documentation is often the most difficult to write as it requires striking the right balance between technical and non-technical instruction. Typically, writing a document should start with you asking yourself the following question:"
msgstr ""
#: ../../documentation/style.rst:11
msgid "Why is the user reading this document?"
msgstr ""
#: ../../documentation/style.rst:13
msgid "The answer will usually be one of the following:"
msgstr ""
#: ../../documentation/style.rst:15
msgid "They are new to the project and are looking to learn more about it"
msgstr ""
#: ../../documentation/style.rst:16
msgid "They are trying to do something and are having difficulty"
msgstr ""
#: ../../documentation/style.rst:18
msgid "Documentation should be written with these two answers in mind. Information should be clearly laid out in small sections with plenty of clear examples and precise instructions. You should also try to pre-empt where the user might need to go next in order to ease their journey through the document by providing logical and relevant links to more documents."
msgstr ""
#: ../../documentation/style.rst:24
msgid "Administrator Documentation"
msgstr ""
#: ../../documentation/style.rst:26
msgid "Funkwhale is quite a technical project and is enjoyed by people who like setting up their own systems. These users can range from experienced server administrators to hobbyists, so administrator documentation should include plenty of technical instructions with an easy-to-read explanation of each step to cover both use-cases."
msgstr ""
#: ../../documentation/style.rst:32
msgid "Developer Documentation"
msgstr ""
#: ../../documentation/style.rst:34
msgid "Developer documentation should aim to be as technical and readable as possible. Since the reader is likely a developer themselves, providing as much technical detail as possible is the best course of action as it allows them to dive in to the project's internals with more confidence. It is safe to assume they are used to reading more technical work."
msgstr ""

85
docs/locales/gettext/documentation/tools.pot 100644
Wyświetl plik

@ -0,0 +1,85 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../documentation/tools.rst:2
msgid "Documentation Requirements"
msgstr ""
#: ../../documentation/tools.rst:4
msgid "Funkwhale's documentation is written using :doc:`reStructuredText <restructured>` and is built using `Sphinx <http://www.sphinx-doc.org/>`_."
msgstr ""
#: ../../documentation/tools.rst:8
msgid "Text Editor"
msgstr ""
#: ../../documentation/tools.rst:10
msgid "As reStructuredText is a writing standard, any text editor can be used to modify documents depending on preference. User-friendly programs such as `Retext <https://github.com/retext-project/retext>`_ are good options for those just getting started with writing reStructuredText. Many other editors such as `Vim <https://www.vim.org/>`_, `Emacs <https://www.gnu.org/software/emacs/>`_, `VS Code <https://code.visualstudio.com/>`_, and `Atom <https://atom.io/>`_ have addons which can help with syntax highlighting and live previewing."
msgstr ""
#: ../../documentation/tools.rst:17
msgid "Sphinx"
msgstr ""
#: ../../documentation/tools.rst:19
msgid "Sphinx is used to generate a static site based on the ``.rst`` files in the ``docs`` directory. When writing documents, it can be useful to build the site to see how your changes will look in production. To do this:"
msgstr ""
#: ../../documentation/tools.rst:22
msgid "Install Sphinx using `pip <https://pypi.org/project/pip/>`_"
msgstr ""
#: ../../documentation/tools.rst:28
msgid "Navigate to your local ``funkwhale/docs`` directory"
msgstr ""
#: ../../documentation/tools.rst:34
msgid "Use the make file to build the site"
msgstr ""
#: ../../documentation/tools.rst:40
msgid "Sphinx will generate the site in your ``funkwhale/docs/_build`` directory unless otherwise stated"
msgstr ""
#: ../../documentation/tools.rst:42
msgid "Once you have generated a local copy of the site, you can open it up by opening the index.html file in ``funkwhale/docs/_build``."
msgstr ""
#: ../../documentation/tools.rst:47
msgid "If you are familiar with `Docker <https://www.docker.com/>`_ and `docker-compose <https://docs.docker.com/compose/>`_, you can also hack on the documentation via a single command: ``docker-compose -f dev.yml up docs``."
msgstr ""
#: ../../documentation/tools.rst:50
msgid "This will make the documentation available at http://0.0.0.0:8001, with live-reloading enabled, so any change made in the ``.rst`` files will be reflected immediately in your browser."
msgstr ""
#: ../../documentation/tools.rst:55
msgid "Git"
msgstr ""
#: ../../documentation/tools.rst:57
msgid "In order to work on files on your computer, you will need to install `git <https://git-scm.com/>`_ for your operating system. Git is used to push and pull files to and from the Funkwhale repository and track changes made to documents/code alike."
msgstr ""
#: ../../documentation/tools.rst:62
msgid "Gitlab"
msgstr ""
#: ../../documentation/tools.rst:64
msgid "If you are only making minor changes to a document or don't wish to install anything, you can use `Gitlab's <https://dev.funkwhale.audio>`_ built-in IDE. Once you have made an account and :doc:`created a pull request <creating>`, you can click on the \"Open in Web IDE\" button to open up a fully-fledged editor in your web browser."
msgstr ""

609
docs/locales/gettext/federation/index.pot 100644
Wyświetl plik

@ -0,0 +1,609 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../federation/index.rst:2
msgid "Funkwhale Federation"
msgstr ""
#: ../../federation/index.rst:4
msgid "This documentation section is more technical, and targets people who want to understand how Funkwhale's federation works."
msgstr ""
#: ../../federation/index.rst:9
msgid "Technologies and standards"
msgstr ""
#: ../../federation/index.rst:11
msgid "Funkwhale's federation is built on top of the following technologies:"
msgstr ""
#: ../../federation/index.rst:13
msgid "`ActivityPub`_ as the high-level federation protocol"
msgstr ""
#: ../../federation/index.rst:14
msgid "`HTTP Signatures`_ as the primary mean to authenticate messages"
msgstr ""
#: ../../federation/index.rst:15
msgid "`Webfinger`_ to easily retrieve resources using human-friendly names"
msgstr ""
#: ../../federation/index.rst:16
msgid "`ActivityStreams`_ and `ActivityStreams vocabulary`_ as the mean to structure messages"
msgstr ""
#: ../../federation/index.rst:18
msgid "Support for the following is planned but not implemented-yet:"
msgstr ""
#: ../../federation/index.rst:20
msgid "`JSON-LD signatures`_ as an alternate mean to authenticate messages"
msgstr ""
#: ../../federation/index.rst:30
msgid "Philosophy"
msgstr ""
#: ../../federation/index.rst:32
msgid "Our goal is to stick to the specifications as much as possible, to ensure compatibility with existing applications such as Mastodon, Peertube, Plume, Pleroma or PixelFed."
msgstr ""
#: ../../federation/index.rst:35
msgid "However, this is not always possible for all our use cases. The ActivityPub and ActivityStreams specifications are really high-level and do not always fit our use cases. For such cases, we will use an ad-hoc solution, and document it here."
msgstr ""
#: ../../federation/index.rst:39
msgid "There are plenty of projects built using ActivityPub, and our goal is not to support all the existing activities. Instead, we want to support activities and objects that make sense for Funkwhale use cases, such as follows or likes."
msgstr ""
#: ../../federation/index.rst:43
msgid "If you think this document is not accurate or find evidence that Funkwhale is not behaving according to the behaviour documented here, please file a bug on our issue tracker, as we consider this a bug."
msgstr ""
#: ../../federation/index.rst:48
#: ../../federation/index.rst:157
#: ../../federation/index.rst:211
#: ../../federation/index.rst:266
#: ../../federation/index.rst:310
#: ../../federation/index.rst:361
#: ../../federation/index.rst:445
msgid "Internal logic"
msgstr ""
#: ../../federation/index.rst:50
msgid "This section is relevant if you're interested in how we handle things internally in our application code."
msgstr ""
#: ../../federation/index.rst:54
msgid "Database schema"
msgstr ""
#: ../../federation/index.rst:56
msgid "As much as possible, we try to map our internal model and database schema to ActivityPub entities, as this makes things easier to deal with."
msgstr ""
#: ../../federation/index.rst:59
msgid "We store received activities payload directly in the database before we attempt to process or deliver them. Storing the activities unlock some interesting use cases, such as debugging federation issues, replaying deliveries, or reprocess historical activities that were not supported before."
msgstr ""
#: ../../federation/index.rst:64
msgid "Each local user is bound to an ``Actor``. Remote and local actors share the same database table and all federated entities (such as uploads) are linked to an ``Actor`` and not to a user. This means that, internally, in general, there is no distinction between local and remote users."
msgstr ""
#: ../../federation/index.rst:69
#: ../../federation/index.rst:98
msgid "Links:"
msgstr ""
#: ../../federation/index.rst:71
msgid "`Federation models <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/models.py>`_"
msgstr ""
#: ../../federation/index.rst:75
msgid "Activity creation and delivery"
msgstr ""
#: ../../federation/index.rst:77
msgid "When a local actor is making an action that should trigger an ``Activity``, which roughly is equivalent to posting an activity to an outbox, we create an object, with the proper payload and store it in our ``Activity`` table. We then trigger two kind of deliveries:"
msgstr ""
#: ../../federation/index.rst:81
msgid "A delivery to local recipients: for each local recipient, we create an ``InboxItem``, linked to the activity. A local actor's feed is then made of all the available inbox items, which can also have a read/unread status"
msgstr ""
#: ../../federation/index.rst:84
msgid "A delivery to remote recipients: we collect all inboxes and shared inbox urls from remote recipients, and create a ``Delivery`` object in our database, linked to the initial activity and the inbox or shared inbox url. This ``Delivery`` object is then used by our worker to post the activity content to the url."
msgstr ""
#: ../../federation/index.rst:88
msgid "Receiving an activity from a remote actor in a local inbox is basically the same, but we skip step 2."
msgstr ""
#: ../../federation/index.rst:90
msgid "Funkwhale does not support all activities, and we have a basic routing logic to handle specific activities, and discard unsupported ones."
msgstr ""
#: ../../federation/index.rst:93
msgid "If a delivered activity matches one of our routes, a dedicated handler is called, which can trigger additional logic. For instance, if we receive a :ref:`activity-create` activity for an :ref:`object-audio` object, our handler will persist the proper data in our local ``Upload`` table, retrieve the audio cover, etc."
msgstr ""
#: ../../federation/index.rst:100
msgid "`Routing logic for activities <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/routes.py>`_"
msgstr ""
#: ../../federation/index.rst:101
msgid "`Delivery logic for activities <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/tasks.py>`_"
msgstr ""
#: ../../federation/index.rst:107
msgid "Service actor"
msgstr ""
#: ../../federation/index.rst:109
msgid "In some situations, we will send messages or authenticate our fetches using what we call the service actor. A service actor is an ActivityPub actor object that acts on behalf of a Funkwhale server."
msgstr ""
#: ../../federation/index.rst:113
msgid "The actor id usually looks like ``https://yourdomain.com/federation/actors/service``, but the reliable way to determine it is to query the nodeinfo endpoint and use the value available in the ``metadata > actorId`` field."
msgstr ""
#: ../../federation/index.rst:117
msgid "Funkwhale generally considers that the service actor has authority to send activities associated with any object on the same domain. For instance, the service actor could send a :ref:`activity-delete` activity linked to another users' library on the same domain."
msgstr ""
#: ../../federation/index.rst:123
msgid "Supported activities"
msgstr ""
#: ../../federation/index.rst:128
msgid "Follow"
msgstr ""
#: ../../federation/index.rst:131
#: ../../federation/index.rst:181
#: ../../federation/index.rst:236
#: ../../federation/index.rst:282
#: ../../federation/index.rst:332
#: ../../federation/index.rst:384
msgid "Supported on"
msgstr ""
#: ../../federation/index.rst:133
#: ../../federation/index.rst:387
msgid ":ref:`object-Library` objects"
msgstr ""
#: ../../federation/index.rst:136
msgid "Example of library follow"
msgstr ""
#: ../../federation/index.rst:153
msgid "In this example, Alice is following the :ref:`object-library` described in ``object``, which is owned by Bob."
msgstr ""
#: ../../federation/index.rst:159
msgid "When a follow is received on a :ref:`object-Library`, Funkwhale will behave differently depending on the visibility of the library:"
msgstr ""
#: ../../federation/index.rst:162
msgid "Automatic accept, when the library is public: a notification is sent to the library owner, and an :ref:`activity-accept` is sent automatically to the follow actor."
msgstr ""
#: ../../federation/index.rst:163
msgid "Manual accept, in all other cases: a notification is sent to the library owner. After manual approval from the owner, an :ref:`activity-accept` is sent to the follow actor."
msgstr ""
#: ../../federation/index.rst:165
msgid "Funkwhale uses library follow status to grant access to the follow actor. If a library is not public and an actor does not have an approved follow, library content will be inaccessible to the actor."
msgstr ""
#: ../../federation/index.rst:170
#: ../../federation/index.rst:225
#: ../../federation/index.rst:271
#: ../../federation/index.rst:318
#: ../../federation/index.rst:368
#: ../../federation/index.rst:451
msgid "Checks"
msgstr ""
#: ../../federation/index.rst:172
msgid "Before handling the activity, Funkwhale will ensure the library's owner is the activity recipient."
msgstr ""
#: ../../federation/index.rst:178
msgid "Accept"
msgstr ""
#: ../../federation/index.rst:183
#: ../../federation/index.rst:238
msgid ":ref:`activity-follow` objects"
msgstr ""
#: ../../federation/index.rst:186
#: ../../federation/index.rst:241
#: ../../federation/index.rst:287
#: ../../federation/index.rst:338
#: ../../federation/index.rst:469
#: ../../federation/index.rst:499
#: ../../federation/index.rst:541
#: ../../federation/index.rst:581
#: ../../federation/index.rst:626
msgid "Example"
msgstr ""
#: ../../federation/index.rst:208
msgid "In this example, Bob accepts Alice's follow."
msgstr ""
#: ../../federation/index.rst:213
msgid "When an :ref:`activity-accept` is received with a :ref:`activity-follow` object, the corresponding follow is marked as accepted in the database."
msgstr ""
#: ../../federation/index.rst:216
msgid "For library follows, this means that the actor will receive future activities occurring within this library, such as :ref:`activity-create` :ref:`object-audio`, :ref:`activity-delete` :ref:`object-audio` or :ref:`activity-delete` :ref:`object-library`"
msgstr ""
#: ../../federation/index.rst:220
msgid "The follow actor will also be able to browse the library pages and download the library's audio files. Have a look at :ref:`library-access` for more details."
msgstr ""
#: ../../federation/index.rst:227
msgid "Before handling the activity, Funkwhale will ensure the accept comes from the library's owner."
msgstr ""
#: ../../federation/index.rst:233
msgid "Undo"
msgstr ""
#: ../../federation/index.rst:263
msgid "In this example, Alice is notifying Bob she's undoing her follow."
msgstr ""
#: ../../federation/index.rst:268
msgid "When an undo is received, the corresponding follow is deleted from the database."
msgstr ""
#: ../../federation/index.rst:273
msgid "Before handling the activity, Funkwhale will ensure the undo actor is the follow actor."
msgstr ""
#: ../../federation/index.rst:279
msgid "Create"
msgstr ""
#: ../../federation/index.rst:284
#: ../../federation/index.rst:386
msgid ":ref:`object-audio` objects"
msgstr ""
#: ../../federation/index.rst:307
msgid "Refer to :ref:`object-audio` to see the structure of the ``object`` attribute."
msgstr ""
#: ../../federation/index.rst:312
msgid "When a :ref:`activity-create` is received with an :ref:`object-audio` object, Funkwhale will persist a local upload and bind it to the proper library and track. If no local track match the audio metadata, a track is created using the ``metadata`` attribute from the :ref:`object-audio` object."
msgstr ""
#: ../../federation/index.rst:320
msgid "Before handling the activity, Funkwhale will ensure the activity actor and the audio library's actor are the same."
msgstr ""
#: ../../federation/index.rst:323
msgid "If no local actor follows the audio's library, the activity will be discarded."
msgstr ""
#: ../../federation/index.rst:329
msgid "Update"
msgstr ""
#: ../../federation/index.rst:334
msgid ":ref:`object-library` objects"
msgstr ""
#: ../../federation/index.rst:335
msgid ":ref:`object-track` objects"
msgstr ""
#: ../../federation/index.rst:358
msgid "Refer to :ref:`object-library` or :ref:`object-track` to see the structure of the ``object`` attribute."
msgstr ""
#: ../../federation/index.rst:363
msgid "When a :ref:`activity-update` is received with a :ref:`object-library` or :ref:`object-track` object, Funkwhale will try to update the local copy of the corresponding object in it's database."
msgstr ""
#: ../../federation/index.rst:370
msgid "Checks vary depending of the type of object associated with the update."
msgstr ""
#: ../../federation/index.rst:372
msgid "For :ref:`object-library` objects, we ensure the actor sending the message is the owner of the library."
msgstr ""
#: ../../federation/index.rst:374
msgid "For musical entities such as :ref:`object-track`, we ensure the actor sending the message matches the :ref:`property-attributedTo` property declared on the local copy on the object, or the :ref:`service-actor`."
msgstr ""
#: ../../federation/index.rst:381
msgid "Delete"
msgstr ""
#: ../../federation/index.rst:390
msgid "Example (on :ref:`object-Library`)"
msgstr ""
#: ../../federation/index.rst:412
msgid "Example (on :ref:`object-audio`)"
msgstr ""
#: ../../federation/index.rst:437
msgid "In this example, Bob notifies the followers of their library that 3 objects were deleted."
msgstr ""
#: ../../federation/index.rst:441
msgid "For performance reason, when deleting :ref:`object-audio` objects, Funkwhale supports either a list of ids or a single id."
msgstr ""
#: ../../federation/index.rst:447
msgid "When a :ref:`activity-delete` is received, the corresponding objects are immediately deleted from the database."
msgstr ""
#: ../../federation/index.rst:453
msgid "Before handling deletion, Funkwhale ensures the actor initiating the activity is the owner of the deleted :ref:`object-audio` or :ref:`object-Library`."
msgstr ""
#: ../../federation/index.rst:457
msgid "Supported objects"
msgstr ""
#: ../../federation/index.rst:462
msgid "Artist"
msgstr ""
#: ../../federation/index.rst:466
#: ../../federation/index.rst:496
#: ../../federation/index.rst:538
msgid "This object is not standard."
msgstr ""
#: ../../federation/index.rst:482
#: ../../federation/index.rst:521
#: ../../federation/index.rst:559
#: ../../federation/index.rst:599
#: ../../federation/index.rst:649
msgid "Structure"
msgstr ""
#: ../../federation/index.rst:484
msgid "**id** (required): a uri identifying the artist over federation"
msgstr ""
#: ../../federation/index.rst:485
msgid "**name** (required): a name for the artist"
msgstr ""
#: ../../federation/index.rst:486
msgid "**published** (required): the publication date of the artist (on the federation)"
msgstr ""
#: ../../federation/index.rst:487
msgid "**musicbrainzId** (optional): the musicbrainz artist id"
msgstr ""
#: ../../federation/index.rst:492
msgid "Album"
msgstr ""
#: ../../federation/index.rst:523
msgid "**id** (required): a uri identifying the album over federation"
msgstr ""
#: ../../federation/index.rst:524
msgid "**name** (required): the title of the album"
msgstr ""
#: ../../federation/index.rst:525
msgid "**artists** (required): a list of :ref:`object-artist` objects involved in the album"
msgstr ""
#: ../../federation/index.rst:526
#: ../../federation/index.rst:564
#: ../../federation/index.rst:657
msgid "**published** (required): the publication date of the entity (on the federation)"
msgstr ""
#: ../../federation/index.rst:527
msgid "**released** (optional): the release date of the album"
msgstr ""
#: ../../federation/index.rst:528
msgid "**musicbrainzId** (optional): the musicbrainz release id"
msgstr ""
#: ../../federation/index.rst:529
msgid "**cover** (optional): a `Link` object representing the album cover"
msgstr ""
#: ../../federation/index.rst:534
msgid "Track"
msgstr ""
#: ../../federation/index.rst:561
msgid "**id** (required): a uri identifying the track over federation"
msgstr ""
#: ../../federation/index.rst:562
msgid "**name** (required): the title of the track"
msgstr ""
#: ../../federation/index.rst:563
msgid "**position** (required): the position of the :ref:`object-track` in the album"
msgstr ""
#: ../../federation/index.rst:565
msgid "**musicbrainzId** (optional): the musicbrainz recording id"
msgstr ""
#: ../../federation/index.rst:566
msgid "**album** (required): the :ref:`object-album` that contains the track"
msgstr ""
#: ../../federation/index.rst:567
msgid "**artists** (required): a list of :ref:`object-artist` objects involved in the track (they can differ from the album artists)"
msgstr ""
#: ../../federation/index.rst:572
msgid "Library"
msgstr ""
#: ../../federation/index.rst:576
msgid "This object is not standard but inherits its behaviour and properties from Actor and Collection."
msgstr ""
#: ../../federation/index.rst:601
msgid "**id** (required): a uri identifying the library over federation"
msgstr ""
#: ../../federation/index.rst:602
msgid "**actor** (required): the id of the actor managing the library"
msgstr ""
#: ../../federation/index.rst:603
msgid "**name** (required): the name of the library"
msgstr ""
#: ../../federation/index.rst:604
msgid "**followers** (required): the id of the library's followers collection"
msgstr ""
#: ../../federation/index.rst:605
msgid "**totalItems** (required): the number of audio objects available in the library"
msgstr ""
#: ../../federation/index.rst:606
msgid "**first** (required): the URL of the first page of the library"
msgstr ""
#: ../../federation/index.rst:607
msgid "**last** (required): the URL of the last page of the library"
msgstr ""
#: ../../federation/index.rst:608
msgid "**summary** (optional): a description for the library"
msgstr ""
#: ../../federation/index.rst:612
msgid "Crawling library pages requires authentication and an approved follow, unless the library is public."
msgstr ""
#: ../../federation/index.rst:618
msgid "Audio"
msgstr ""
#: ../../federation/index.rst:622
msgid "This object `is specified in ActivityStreams <https://www.w3.org/TR/activitystreams-vocabulary/#dfn-audio>`_, but Funkwhale needs non-standard attributes to handle it."
msgstr ""
#: ../../federation/index.rst:651
msgid "**id** (required): a uri identifying the audio over federation"
msgstr ""
#: ../../federation/index.rst:652
msgid "**name** (required): a human-friendly title for the audio (We concatenate track name, album title and artist name)"
msgstr ""
#: ../../federation/index.rst:653
msgid "**size** (required, non-standard): the size of the audio, in bytes"
msgstr ""
#: ../../federation/index.rst:654
msgid "**bitrate** (required, non-standard): the bitrate of the audio, in bytes/s"
msgstr ""
#: ../../federation/index.rst:655
msgid "**duration** (required): the duration of the audio, in seconds"
msgstr ""
#: ../../federation/index.rst:656
msgid "**library** (required, non-standard): the id of the :ref:`object-Library` object that contains the object"
msgstr ""
#: ../../federation/index.rst:658
msgid "**updated** (required): the last update date of the entity (on the federation)"
msgstr ""
#: ../../federation/index.rst:659
msgid "**url** (required): a ``Link`` object with an ``audio/`` mediaType where the audio file is downloadable"
msgstr ""
#: ../../federation/index.rst:660
msgid "**track** (required, non-standard): the :ref:`object-track` the :ref:`object-audio` is bound to"
msgstr ""
#: ../../federation/index.rst:664
msgid "Accessing the Audio file via its url requires authentication and an approved follow on the containing library, unless the library is public."
msgstr ""
#: ../../federation/index.rst:671
msgid "Audio fetching on restricted libraries"
msgstr ""
#: ../../federation/index.rst:673
msgid ":ref:`object-library` and :ref:`object-audio` url objects may require additional authentication to be accessed."
msgstr ""
#: ../../federation/index.rst:676
msgid "For :ref:`object-library` objects:"
msgstr ""
#: ../../federation/index.rst:678
msgid "If the library is public, library pages can be accessed without restriction"
msgstr ""
#: ../../federation/index.rst:679
msgid "Otherwise, the HTTP request must be signed by an actor with an approved follow on the library"
msgstr ""
#: ../../federation/index.rst:682
msgid "For :ref:`object-audio` url objects:"
msgstr ""
#: ../../federation/index.rst:684
msgid "If the audio's library is public, audio file can be accessed without restriction"
msgstr ""
#: ../../federation/index.rst:685
msgid "Otherwise, the HTTP request must be signed by an actor with an approved follow on the audio's library"
msgstr ""
#: ../../federation/index.rst:689
msgid "Properties"
msgstr ""
#: ../../federation/index.rst:694
msgid "attributedTo"
msgstr ""
#: ../../federation/index.rst:696
msgid "Funkwhale will generally use the ``attributedTo`` property to communicate who is responsible for a given object. When an object has the ``attributedTo`` attribute, the associated actor has the permission to :ref:`activity-update`, :ref:`activity-delete` or more generally apply any kind of activity on the object."
msgstr ""
#: ../../federation/index.rst:701
msgid "In addition, Funkwhale consider all the objects of a domain as attributed to its corresponding :ref:`service-actor`."
msgstr ""

73
docs/locales/gettext/glossary.pot 100644
Wyświetl plik

@ -0,0 +1,73 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../glossary.md:1
msgid "Glossary of terms"
msgstr ""
#: ../../glossary.md:3
msgid "Funkwhale glossary"
msgstr ""
#: ../../glossary.md:0
msgid "Pod"
msgstr ""
#: ../../glossary.md:7
msgid "A pod is an instance of Funkwhale running on a server. Pods can communicate with one another across the {term}`Fediverse`."
msgstr ""
#: ../../glossary.md:12
msgid "Channel glossary"
msgstr ""
#: ../../glossary.md:0
msgid "Fediverse"
msgstr ""
#: ../../glossary.md:16
msgid "A term used to refer to a collection of federated (interconnected) servers. These servers run software that enables users to publish and host their own content."
msgstr ""
#: ../../glossary.md:3
msgid "Podcatcher"
msgstr ""
#: ../../glossary.md:19
msgid "A podcatcher is a piece of software that can read podcast feeds. Podcatchers enable listeners to follow and listen to podcast content."
msgstr ""
#: ../../glossary.md:24
msgid "Plugin glossary"
msgstr ""
#: ../../glossary.md:0
msgid "Plugin"
msgstr ""
#: ../../glossary.md:28
msgid "A plugin is a piece of software that extends the functionality of another piece of software."
msgstr ""
#: ../../glossary.md:3
msgid "Scrobbling"
msgstr ""
#: ../../glossary.md:31
msgid "Scrobbling is the act of recording listen data. Services use this information to keep track of listening preferences and recommend music."
msgstr ""

97
docs/locales/gettext/index.pot 100644
Wyświetl plik

@ -0,0 +1,97 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../index.md:7
msgid "User documentation"
msgstr ""
#: ../../index.md:29
msgid "Admin documentation"
msgstr ""
#: ../../index.md:41
msgid "Moderator documentation"
msgstr ""
#: ../../index.md:58
msgid "Developer documentation"
msgstr ""
#: ../../index.md:70
msgid "Contributor documentation"
msgstr ""
#: ../../index.md:82
msgid "Reference"
msgstr ""
#: ../../index.md:93
msgid "Changes"
msgstr ""
#: ../../index.md:1
msgid "Welcome to Funkwhale's documentation"
msgstr ""
#: ../../index.md:3
msgid "Funkwhale is a self-hosted audio player and publication platform. It enables users to build libraries of existing content and publish their own."
msgstr ""
#: ../../index.md:5
msgid "Funkwhale uses the [ActivityPub protocol](https://www.w3.org/TR/activitypub/) to talk to other apps across the {term}`Fediverse`. Users can share content between {term}`Funkwhale pods <Pod>` or with other Fediverse software."
msgstr ""
#: ../../index.md:109
msgid "{fa}`user` Users"
msgstr ""
#: ../../index.md:112
msgid "Looking to use Funkwhale for your content? Read through our guides to master the app!"
msgstr ""
#: ../../index.md:124
msgid "{fa}`wrench` Admins"
msgstr ""
#: ../../index.md:127
msgid "Want to host your own Funkwhale pod? Our admin documentation guides you through the process."
msgstr ""
#: ../../index.md:138
msgid "{fa}`shield` Moderators"
msgstr ""
#: ../../index.md:141
msgid "Keeping your users safe from harassment and spam or clearing illegal content? Check out our moderator docs."
msgstr ""
#: ../../index.md:152
msgid "{fa}`code` Developers"
msgstr ""
#: ../../index.md:155
msgid "Want to use Funkwhale's API or help with the project? Our developer docs give you what you need to get started."
msgstr ""
#: ../../index.md:167
msgid "{fa}`users` Contributors"
msgstr ""
#: ../../index.md:170
msgid "Want to help make Funkwhale even better? Check out these guides for some ideas."
msgstr ""

355
docs/locales/gettext/installation/debian.pot 100644
Wyświetl plik

@ -0,0 +1,355 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../installation/debian.rst:2
msgid "Debian and Arch Linux installation"
msgstr ""
#: ../../installation/debian.rst:6
msgid "This guide targets Debian 10 (Buster), which is the latest version available, as well as Arch Linux."
msgstr ""
#: ../../installation/debian.rst:9
msgid "Cache setup (Redis)"
msgstr ""
#: ../../installation/debian.rst:11
msgid "Funkwhale requires a cache server:"
msgstr ""
#: ../../installation/debian.rst:13
msgid "to make the whole system faster, by caching network requests or database queries;"
msgstr ""
#: ../../installation/debian.rst:14
msgid "to handle asynchronous tasks such as music import."
msgstr ""
#: ../../installation/debian.rst:16
msgid "On Debian-like distributions, a redis package is available, and you can install it:"
msgstr ""
#: ../../installation/debian.rst:23
#: ../../installation/debian.rst:45
#: ../../installation/debian.rst:244
msgid "On Arch Linux and its derivatives:"
msgstr ""
#: ../../installation/debian.rst:29
msgid "This should be enough to have your redis server set up."
msgstr ""
#: ../../installation/debian.rst:32
msgid "Install system dependencies"
msgstr ""
#: ../../installation/debian.rst:34
msgid "On Debian-like systems, you can install them using:"
msgstr ""
#: ../../installation/debian.rst:56
msgid "External Authentication (LDAP)"
msgstr ""
#: ../../installation/debian.rst:58
msgid "LDAP support requires some additional dependencies to enable. On the OS level both ``libldap2-dev`` and ``libsasl2-dev`` are required, and the Python modules ``python-ldap`` and ``python-django-auth-ldap`` must be installed. These dependencies are all included in the ``requirements.*`` files so deploying with those will install these dependencies by default. However, they are not required unless LDAP support is explicitly enabled. See :doc:`../admin/ldap` for more details."
msgstr ""
#: ../../installation/debian.rst:61
msgid "Installation structure"
msgstr ""
#: ../../installation/debian.rst:63
msgid "All Funkwhale-related files will be located under ``/srv/funkwhale`` apart from database files and a few configuration files. We will also have a dedicated ``funkwhale`` user to launch the processes we need and own those files."
msgstr ""
#: ../../installation/debian.rst:67
msgid "You are free to use different values here, just remember to adapt those in the next steps."
msgstr ""
#: ../../installation/debian.rst:72
msgid "Create the user and the directory:"
msgstr ""
#: ../../installation/debian.rst:79
msgid "Log in as the newly created user from now on:"
msgstr ""
#: ../../installation/debian.rst:85
msgid "Now let's setup our directory layout. Here is how it will look like::"
msgstr ""
#: ../../installation/debian.rst:94
msgid "Create the aforementioned directories:"
msgstr ""
#: ../../installation/debian.rst:100
msgid "The ``virtualenv`` directory is a bit special and will be created separately."
msgstr ""
#: ../../installation/debian.rst:103
msgid "Download the latest Funkwhale release"
msgstr ""
#: ../../installation/debian.rst:105
msgid "Funkwhale is splitted in two components:"
msgstr ""
#: ../../installation/debian.rst:107
msgid "The API, which will handle music storage and user accounts;"
msgstr ""
#: ../../installation/debian.rst:108
msgid "The frontend, that will simply connect to the API to interact with its data."
msgstr ""
#: ../../installation/debian.rst:110
msgid "Those components are packaged in subsequent releases, such as 0.1, 0.2, etc. You can browse the :doc:`changelog </changelog>` for a list of available releases and pick the one you want to install, usually the latest one should be okay."
msgstr ""
#: ../../installation/debian.rst:114
msgid "In this guide, we will assume you want to install the latest version of Funkwhale, which is |version|:"
msgstr ""
#: ../../installation/debian.rst:116
msgid "First, we will download the latest api release:"
msgstr ""
#: ../../installation/debian.rst:126
msgid "Then we will download the frontend files:"
msgstr ""
#: ../../installation/debian.rst:137
msgid "You can also choose to get the code directly from the git repo. In this case, run::"
msgstr ""
#: ../../installation/debian.rst:146
msgid "The above clone command uses the stable branch instead of the default develop branch, as stable is stable and more suited for production setups."
msgstr ""
#: ../../installation/debian.rst:148
msgid "You'll also need to re-create the folders we make earlier::"
msgstr ""
#: ../../installation/debian.rst:152
msgid "You will still need to get the frontend files as specified before, because we're not going to build them."
msgstr ""
#: ../../installation/debian.rst:156
msgid "You can leave the ZIP archives in the directory, this will help you know which version you've installed next time you want to upgrade your installation."
msgstr ""
#: ../../installation/debian.rst:160
msgid "Install Python dependencies"
msgstr ""
#: ../../installation/debian.rst:162
msgid "We use `poetry <https://python-poetry.org/>`_ to manage Python dependencies. Poetry installs packages in a `virtualenv <https://docs.python.org/3/library/venv.html>`_. This prevents collisions with other Python packages on your system. To install poetry, check out `their documentation <https://python-poetry.org/docs/#installation>`_."
msgstr ""
#: ../../installation/debian.rst:167
msgid "By default, poetry creates a virtualenv in `{cache-dir}/virtualenvs`. We recommend creating your virtualenv inside your Funkwhale `api` directory. To do this, navigate to the directory and run the :command:`poetry config virtualenvs.in-project` command."
msgstr ""
#: ../../installation/debian.rst:177
msgid "Poetry creates a virtualenv in `/srv/funkwhale/api/.venv`."
msgstr ""
#: ../../installation/debian.rst:180
msgid "To run Funkwhale commands, you need to activate the virtualenv using poetry. To make copying and pasting from this guide easier, we prefix all commands with :command:`poetry run`. If you use :command:`poetry shell` to enter your virtualenv, make sure you remove :command:`poetry run` from each command."
msgstr ""
#: ../../installation/debian.rst:186
msgid "Once you have set up your virtualenv, install the dependencies using :command:`poetry install`."
msgstr ""
#: ../../installation/debian.rst:195
msgid "Environment file"
msgstr ""
#: ../../installation/debian.rst:197
msgid "You can now start to configure Funkwhale. The main way to achieve that is by adding an environment file that will host settings that are relevant to your installation."
msgstr ""
#: ../../installation/debian.rst:201
msgid "Download the sample environment file:"
msgstr ""
#: ../../installation/debian.rst:209
msgid "if you used git to get the latest version of the code earlier, you can instead do::"
msgstr ""
#: ../../installation/debian.rst:214
msgid "Generate a secret key for Django::"
msgstr ""
#: ../../installation/debian.rst:218
msgid "You can then edit the file: the file is heavily commented, and the most relevant configuration options are mentioned at the top of the file."
msgstr ""
#: ../../installation/debian.rst:226
msgid "Paste the secret key you generated earlier at the entry ``DJANGO_SECRET_KEY`` and populate the ``DATABASE_URL`` and ``CACHE_URL`` values based on how you configured your PostgreSQL and Redis servers in."
msgstr ""
#: ../../installation/debian.rst:232
msgid "Database setup"
msgstr ""
#: ../../installation/debian.rst:234
msgid "Funkwhale requires a PostgreSQL database to work properly. Please refer to the `PostgreSQL documentation <https://www.postgresql.org/download/>`_ for installation instructions specific to your os."
msgstr ""
#: ../../installation/debian.rst:238
msgid "On Debian-like systems, you would install the database server like this:"
msgstr ""
#: ../../installation/debian.rst:250
msgid "On Arch Linux, you'll also need to initialize the database. See `the Arch Linux wiki <https://wiki.archlinux.org/index.php/Postgresql#Initial_configuration>`_."
msgstr ""
#: ../../installation/debian.rst:252
msgid "The remaining steps are heavily inspired from `this Digital Ocean guide <https://www.digitalocean.com/community/tutorials/how-to-set-up-django-with-postgres-nginx-and-gunicorn-on-ubuntu-16-04>`_."
msgstr ""
#: ../../installation/debian.rst:254
msgid "Open a database shell:"
msgstr ""
#: ../../installation/debian.rst:260
msgid "Create the project database and user:"
msgstr ""
#: ../../installation/debian.rst:270
msgid "It's important that you use utf-8 encoding for your database, otherwise you'll end up with errors and crashes later on when dealing with music metadata that contains non-ascii chars."
msgstr ""
#: ../../installation/debian.rst:274
msgid "Assuming you already have :ref:`created your funkwhale user <create-funkwhale-user>`, you should now be able to open a postgresql shell:"
msgstr ""
#: ../../installation/debian.rst:281
msgid "Unless you give a superuser access to the database user, you should also enable some extensions on your database server, as those are required for Funkwhale to work properly:"
msgstr ""
#: ../../installation/debian.rst:290
msgid "Now that the database has been created, import the initial database structure using the virtualenv created before:"
msgstr ""
#: ../../installation/debian.rst:296
msgid "This creates the required tables and rows."
msgstr ""
#: ../../installation/debian.rst:300
msgid "You can safely execute this command any time you want, this will only run unapplied migrations."
msgstr ""
#: ../../installation/debian.rst:305
msgid "You may sometimes get the following warning while applying migrations::"
msgstr ""
#: ../../installation/debian.rst:309
msgid "This is a warning, not an error, and it can be safely ignored. Never run the ``makemigrations`` command yourself."
msgstr ""
#: ../../installation/debian.rst:313
msgid "Create an admin account"
msgstr ""
#: ../../installation/debian.rst:315
msgid "Using the virtualenv created before, create your first user account:"
msgstr ""
#: ../../installation/debian.rst:321
msgid "If you ever want to change a user's password from the command line, just run:"
msgstr ""
#: ../../installation/debian.rst:328
msgid "Collect static files"
msgstr ""
#: ../../installation/debian.rst:330
msgid "Static files are the static assets used by the API server (icon PNGs, CSS, etc.). We need to collect them explicitly, so they can be served by the webserver:"
msgstr ""
#: ../../installation/debian.rst:337
msgid "This should populate the directory you choose for the ``STATIC_ROOT`` variable in your ``.env`` file."
msgstr ""
#: ../../installation/debian.rst:341
msgid "Systemd unit file"
msgstr ""
#: ../../installation/debian.rst:345
msgid "All the command lines below should be executed as root."
msgstr ""
#: ../../installation/debian.rst:347
msgid "Systemd offers a convenient way to manage your Funkwhale instance if you're not using docker. We'll see how to setup systemd to properly start a Funkwhale instance."
msgstr ""
#: ../../installation/debian.rst:350
msgid "First, download the sample unitfiles:"
msgstr ""
#: ../../installation/debian.rst:359
msgid "This will download three unitfiles:"
msgstr ""
#: ../../installation/debian.rst:361
msgid "``funkwhale-server.service`` to launch the Funkwhale web server;"
msgstr ""
#: ../../installation/debian.rst:362
msgid "``funkwhale-worker.service`` to launch the Funkwhale task worker;"
msgstr ""
#: ../../installation/debian.rst:363
msgid "``funkwhale-beat.service`` to launch the Funkwhale task beat (this is for recurring tasks);"
msgstr ""
#: ../../installation/debian.rst:364
msgid "``funkwhale.target`` to easily stop and start all of the services at once."
msgstr ""
#: ../../installation/debian.rst:366
msgid "You can of course review and edit them to suit your deployment scenario if needed, but the defaults should be fine."
msgstr ""
#: ../../installation/debian.rst:369
msgid "Once the files are downloaded, reload systemd:"
msgstr ""
#: ../../installation/debian.rst:375
msgid "And start the services:"
msgstr ""
#: ../../installation/debian.rst:381
msgid "To ensure all Funkwhale processes are started automatically after a reboot, run:"
msgstr ""
#: ../../installation/debian.rst:389
msgid "You can check the statuses of all processes like this:"
msgstr ""
#: ../../installation/debian.rst:396
msgid "Reverse proxy setup"
msgstr ""
#: ../../installation/debian.rst:398
msgid "See :ref:`Reverse proxy <reverse-proxy-setup>`."
msgstr ""

204
docs/locales/gettext/installation/docker.pot 100644
Wyświetl plik

@ -0,0 +1,204 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../installation/docker.rst:2
msgid "Docker installation"
msgstr ""
#: ../../installation/docker.rst:4
msgid "Docker is the easiest way to get a Funkwhale instance up and running."
msgstr ""
#: ../../installation/docker.rst:6
msgid "We support two types of Docker deployments:"
msgstr ""
#: ../../installation/docker.rst:8
msgid ":ref:`Mono-container <docker-mono-container>`: all processes live in the same container (database, nginx, redis, etc.). It's easier to deploy and to integrate with container management systems like Portainer. However, it's not possible to scale this type of deployment on multiple servers."
msgstr ""
#: ../../installation/docker.rst:9
msgid ":ref:`Multi-container <docker-multi-container>`: each process lives in a dedicated container. This setup is more involved but also more flexible and scalable."
msgstr ""
#: ../../installation/docker.rst:13
#: ../../installation/docker.rst:23
msgid "The All-In-One-Container or Mono-Container installation is deprecated, don't use it for new installations. For more information, visit our blog: https://blog.funkwhale.audio/deprecation-all-in-one-container.html"
msgstr ""
#: ../../installation/docker.rst:19
msgid "Mono-container installation"
msgstr ""
#: ../../installation/docker.rst:28
msgid "This installation method was originally contributed by `@thetarkus <https://github.com/thetarkus>`_"
msgstr ""
#: ../../installation/docker.rst:30
msgid "These are the installation steps:"
msgstr ""
#: ../../installation/docker.rst:32
#: ../../installation/docker.rst:39
msgid "Install docker"
msgstr ""
#: ../../installation/docker.rst:33
#: ../../installation/docker.rst:44
msgid "Create ``funkwhale`` user"
msgstr ""
#: ../../installation/docker.rst:34
#: ../../installation/docker.rst:60
msgid "Create ``.env`` file"
msgstr ""
#: ../../installation/docker.rst:35
#: ../../installation/docker.rst:86
msgid "Create ``docker-compose.yml`` file"
msgstr ""
#: ../../installation/docker.rst:36
#: ../../installation/docker.rst:117
msgid "Start Funkwhale service"
msgstr ""
#: ../../installation/docker.rst:41
msgid "Ensure you have `Docker <https://docs.docker.com/engine/installation/>`_ and `docker-compose <https://docs.docker.com/compose/install/>`_ installed."
msgstr ""
#: ../../installation/docker.rst:46
msgid "Create the user and the directory:"
msgstr ""
#: ../../installation/docker.rst:53
msgid "Log in as the newly created user from now on:"
msgstr ""
#: ../../installation/docker.rst:62
msgid "Create a ``.env`` file to store a few important configuration options:"
msgstr ""
#: ../../installation/docker.rst:88
msgid "Create a ``docker-compose.yml`` file to set up the containers:"
msgstr ""
#: ../../installation/docker.rst:112
msgid "The version can be changed (after ``funkwhale/all-in-one:``), `select the version <https://hub.docker.com/r/funkwhale/all-in-one/tags>`_ you want to deploy."
msgstr ""
#: ../../installation/docker.rst:113
msgid "``PUID`` and ``PGID`` are optional but useful to prevent permission issues with docker volumes"
msgstr ""
#: ../../installation/docker.rst:114
msgid "``/path/to/your/music/dir`` should point to a path on your host where music you would like to import is located. You can safely remove the volume if you don't want to import music that way."
msgstr ""
#: ../../installation/docker.rst:119
msgid "Start the container:"
msgstr ""
#: ../../installation/docker.rst:125
msgid "Your container should start in the background, and your instance be available at ``yourip:5000`` shortly."
msgstr ""
#: ../../installation/docker.rst:127
msgid "You will need an admin account to login and manage your account, create one using the following command: ``docker exec -it funkwhale manage createsuperuser``"
msgstr ""
#: ../../installation/docker.rst:129
msgid "Useful commands:"
msgstr ""
#: ../../installation/docker.rst:131
msgid "You can start and stop your instance using ``docker-compose start`` and ``docker-compose stop``, respectively"
msgstr ""
#: ../../installation/docker.rst:132
msgid "You can examine the logs by running ``docker logs -f --tail=50 funkwhale``"
msgstr ""
#: ../../installation/docker.rst:133
msgid "To have a better idea of the resource usage of your instance (CPU, memory), run ``docker stats funkwhale``"
msgstr ""
#: ../../installation/docker.rst:135
#: ../../installation/docker.rst:218
msgid "Now, you just need to configure your :ref:`reverse-proxy <reverse-proxy-setup>`. Don't worry, it's quite easy."
msgstr ""
#: ../../installation/docker.rst:140
msgid "Multi-container installation"
msgstr ""
#: ../../installation/docker.rst:142
msgid "First, ensure you have `Docker <https://docs.docker.com/engine/installation/>`_ and `docker-compose <https://docs.docker.com/compose/install/>`_ installed."
msgstr ""
#: ../../installation/docker.rst:144
msgid "Export the `version you want <https://hub.docker.com/r/funkwhale/all-in-one/tags>`_ to deploy (e.g., ``0.21``):"
msgstr ""
#: ../../installation/docker.rst:150
msgid "Download the sample docker-compose file:"
msgstr ""
#: ../../installation/docker.rst:161
msgid "At this point, the architecture of ``/srv/funkwhale`` should look like that:"
msgstr ""
#: ../../installation/docker.rst:171
msgid "Create your env file:"
msgstr ""
#: ../../installation/docker.rst:181
msgid "Ensure to edit it to match your needs (this file is heavily commented), in particular ``DJANGO_SECRET_KEY`` and ``FUNKWHALE_HOSTNAME``. You should take a look at the `configuration reference <https://docs.funkwhale.audio/configuration.html#configuration-reference>`_ for more detailed information regarding each setting."
msgstr ""
#: ../../installation/docker.rst:184
msgid "Then, you should be able to pull the required images:"
msgstr ""
#: ../../installation/docker.rst:190
msgid "Run the database container and the initial migrations:"
msgstr ""
#: ../../installation/docker.rst:199
msgid "You may sometimes get the following warning while applying migrations::"
msgstr ""
#: ../../installation/docker.rst:203
msgid "This is a warning, not an error, and it can be safely ignored. Never run the ``makemigrations`` command yourself."
msgstr ""
#: ../../installation/docker.rst:206
msgid "Create your admin user:"
msgstr ""
#: ../../installation/docker.rst:212
msgid "Then launch the whole thing:"
msgstr ""
#: ../../installation/docker.rst:221
msgid "About music acquisition"
msgstr ""
#: ../../installation/docker.rst:223
msgid "If you want to :doc:`import music located on the server <../admin/importing-music>`, you can put it in the ``data/music`` directory and it will become readable by the importer."
msgstr ""

397
docs/locales/gettext/installation/index.pot 100644
Wyświetl plik

@ -0,0 +1,397 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../installation/index.rst:2
msgid "Installation"
msgstr ""
#: ../../installation/index.rst:5
msgid "Requirements"
msgstr ""
#: ../../installation/index.rst:7
msgid "Regardless of your chosen installation method, the following is required to successfully deploy Funkwhale:"
msgstr ""
#: ../../installation/index.rst:10
msgid "**A dedicated domain or subdomain**: it is not possible to deploy Funkwhale on a subdirectory of an existing domain."
msgstr ""
#: ../../installation/index.rst:11
msgid "**Access to ports 80 and/or 443**: if you cannot serve the Funkwhale web app and API on these ports, federation will not work"
msgstr ""
#: ../../installation/index.rst:15
msgid "Because of the federated nature of Funkwhale, **it is strongly recommended not to change the Funkwhale domain after initial deployment**, as it is likely to break your installation."
msgstr ""
#: ../../installation/index.rst:20
msgid "Project architecture"
msgstr ""
#: ../../installation/index.rst:22
msgid "The project relies on the following components and services to work:"
msgstr ""
#: ../../installation/index.rst:24
msgid "A web application server (Python/Django/Gunicorn)"
msgstr ""
#: ../../installation/index.rst:25
msgid "A PostgreSQL database to store application data"
msgstr ""
#: ../../installation/index.rst:26
msgid "A redis server to store cache and tasks data"
msgstr ""
#: ../../installation/index.rst:27
msgid "A celery worker to run asynchronous tasks (such as music import)"
msgstr ""
#: ../../installation/index.rst:28
msgid "A celery scheduler to run recurrent tasks"
msgstr ""
#: ../../installation/index.rst:29
msgid "A `ntp-synced clock <https://wiki.debian.org/NTP>`_ to ensure federation is working seamlessly"
msgstr ""
#: ../../installation/index.rst:33
msgid "The synced clock is needed for federation purpose, to assess the validity of incoming requests."
msgstr ""
#: ../../installation/index.rst:37
msgid "Hardware requirements"
msgstr ""
#: ../../installation/index.rst:39
msgid "Funkwhale is not especially CPU hungry. On a dockerized instance with 2 CPUs and a few active users, the memory footprint is around 500Mb::"
msgstr ""
#: ../../installation/index.rst:50
msgid "Some users have reported running Funkwhale on Raspberry Pis with a memory consumption of less than 350 MiB."
msgstr ""
#: ../../installation/index.rst:53
msgid "Thus, Funkwhale should run fine on commodity hardware, small hosting boxes and Raspberry Pi. We lack real-world examples of such deployments, so don't hesitate do give us your feedback (either positive or negative)."
msgstr ""
#: ../../installation/index.rst:57
msgid "Check out :doc:`../admin/optimization` for advice on how to tune your instance on small configurations."
msgstr ""
#: ../../installation/index.rst:61
msgid "Software requirements"
msgstr ""
#: ../../installation/index.rst:63
msgid "Software requirements will vary depending of your installation method. For Docker-based installations, the only requirement will be an Nginx reverse-proxy that will expose your instance to the outside world."
msgstr ""
#: ../../installation/index.rst:67
msgid "If you plan to install your Funkwhale instance without Docker, most of the dependencies should be available in your distribution's repositories."
msgstr ""
#: ../../installation/index.rst:72
msgid "Funkwhale works only with Python >= 3.5, as we need support for async/await. Older versions of Python are not supported."
msgstr ""
#: ../../installation/index.rst:76
msgid "Available installation methods"
msgstr ""
#: ../../installation/index.rst:78
msgid "Funkwhale can be installed using one of the following method:"
msgstr ""
#: ../../installation/index.rst:82
msgid "The All-In-One-Container or Mono-Container installation is deprecated, don't use it for new installations. For more information, visit our blog: https://blog.funkwhale.audio/deprecation-all-in-one-container.html"
msgstr ""
#: ../../installation/index.rst:85
msgid "Quick install, the most straight forward way to get Funkwhale;"
msgstr ""
#: ../../installation/index.rst:86
msgid "Mono-container Docker installation;"
msgstr ""
#: ../../installation/index.rst:87
msgid "Multi-container Docker installation;"
msgstr ""
#: ../../installation/index.rst:88
msgid "Manual Debian and Arch Linux installation;"
msgstr ""
#: ../../installation/index.rst:89
msgid "`Ansible role <https://dev.funkwhale.audio/funkwhale/ansible/>`_."
msgstr ""
#: ../../installation/index.rst:91
msgid "Further, Funkwhale packages are available for the following platforms:"
msgstr ""
#: ../../installation/index.rst:93
msgid "`YunoHost 3 <https://yunohost.org/>`_: https://github.com/YunoHost-Apps/funkwhale_ynh (kindly maintained by `@Jibec <https://github.com/Jibec>`_)"
msgstr ""
#: ../../installation/index.rst:94
msgid "ArchLinux (as an AUR package): if you'd rather use a package, check out this alternative installation method on ArchLinux: https://wiki.archlinux.org/index.php/Funkwhale (package and wiki kindly maintained by getzee)"
msgstr ""
#: ../../installation/index.rst:95
msgid "`NixOS <https://github.com/mmai/funkwhale-nixos>`_ (kindly maintained by @mmai)"
msgstr ""
#: ../../installation/index.rst:96
msgid "`Helm chart <https://gitlab.com/ananace/charts/>`_ to install Funkwhale on Kubernetes (kindly maintained by `@ananace <https://gitlab.com/ananace>`_)"
msgstr ""
#: ../../installation/index.rst:97
msgid "`HomelabOS <https://homelabos.com/docs/software/funkwhale/>`_"
msgstr ""
#: ../../installation/index.rst:100
msgid "Quick install"
msgstr ""
#: ../../installation/index.rst:102
msgid "To install the latest version of Funkwhale on a recent Debian or Ubuntu server, run::"
msgstr ""
#: ../../installation/index.rst:108
msgid "This installation script will ask you a few questions, install the required dependencies and set up your instance."
msgstr ""
#: ../../installation/index.rst:111
msgid "Additional info:"
msgstr ""
#: ../../installation/index.rst:113
msgid "This script is based on our `Ansible role <https://dev.funkwhale.audio/funkwhale/ansible/>`_."
msgstr ""
#: ../../installation/index.rst:114
msgid "By default, the script installs Nginx, PostgreSQL, Redis and Funkwhale itself but you can customize the installation procedure if you already have some of these services available on your machine"
msgstr ""
#: ../../installation/index.rst:115
msgid "Edit your pod configuration in ``/srv/funkwhale/ansible/playbook.yml`` and apply new configuration with ``sudo /srv/funkwhale/ansible/reconfigure``"
msgstr ""
#: ../../installation/index.rst:116
msgid "Upgrade is done using ``sh -c \"$(curl -sSL https://get.funkwhale.audio/upgrade.sh)\"``."
msgstr ""
#: ../../installation/index.rst:120
msgid "Alternative installation methods"
msgstr ""
#: ../../installation/index.rst:130
msgid "Running Funkwhale on the develop branch"
msgstr ""
#: ../../installation/index.rst:132
msgid "Traditional deployments are done using tagged releases. However, you may want to benefit from the latest changes available, or to help detect bugs before they are included in actual releases."
msgstr ""
#: ../../installation/index.rst:136
msgid "To do that, you'll need to run your instance on the develop branch, which contains all the unreleased changes and features of the next version."
msgstr ""
#: ../../installation/index.rst:139
msgid "Please take into account that the develop branch may be unstable and will contain bugs that may affect the well-being of your instance. If you are comfortable with that, you need to backup at least your database before pulling the latest changes from the develop branch."
msgstr ""
#: ../../installation/index.rst:144
msgid "Otherwise, the deployment process is similar to deploying with releases. You simply need to use ``export FUNKWHALE_VERSION=develop`` in the installation and upgrade process instead of a real version number, as we build artifacts on the development branch the same way we do for releases."
msgstr ""
#: ../../installation/index.rst:149
msgid "It's also recommended to check out the `develop release notes <https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/changes/notes.rst>`_ before upgrading, since you may have to apply manual actions for your instance to continue to work. Such actions are labelled with ``[manual action required]`` in the releases notes."
msgstr ""
#: ../../installation/index.rst:155
msgid "Serving only the frontend"
msgstr ""
#: ../../installation/index.rst:159
msgid "You do not need to do this if you are deploying using Docker, as frontend files are already included in the docker image."
msgstr ""
#: ../../installation/index.rst:162
msgid "You also do not need to do this if you are deploying manually on Debian or Arch, as this is covered by the corresponding documentation already."
msgstr ""
#: ../../installation/index.rst:166
msgid "Files for the web frontend are purely static and can simply be downloaded, unzipped and served from any webserver:"
msgstr ""
#: ../../installation/index.rst:177
msgid "Reverse proxy configuration"
msgstr ""
#: ../../installation/index.rst:179
msgid "In order to make Funkwhale accessible from outside your server and to play nicely with other applications on your machine, you should configure a reverse proxy."
msgstr ""
#: ../../installation/index.rst:183
msgid "We offer sample configurations for Nginx, Apache2 and Caddy."
msgstr ""
#: ../../installation/index.rst:187
msgid "You can freely adapt the proposed configuration to your own needs, as we cannot cover every use case with a single template, especially when it's related to SSL configuration."
msgstr ""
#: ../../installation/index.rst:192
msgid "Nginx"
msgstr ""
#: ../../installation/index.rst:194
msgid "Ensure you have a recent version of nginx on your server. On a Debian-based system use apt:"
msgstr ""
#: ../../installation/index.rst:202
msgid "On Arch Linux and its derivatives:"
msgstr ""
#: ../../installation/index.rst:208
msgid "To avoid configuration errors at this level, we will generate an nginx configuration using your .env file. This will ensure your reverse-proxy configuration always matches the application configuration and makes upgrade/maintenance easier."
msgstr ""
#: ../../installation/index.rst:215
msgid "The following commands need to be run as superuser."
msgstr ""
#: ../../installation/index.rst:217
msgid "On docker deployments, run the following commands:"
msgstr ""
#: ../../installation/index.rst:237
msgid "On non-docker deployments, run the following commands:"
msgstr ""
#: ../../installation/index.rst:259
msgid "The resulting file should not contain any variables such as ``${FUNKWHALE_HOSTNAME}``. You can check that using this command::"
msgstr ""
#: ../../installation/index.rst:264
msgid "Finally, enable the resulting configuration:"
msgstr ""
#: ../../installation/index.rst:272
msgid "If you plan to use in-place import, ensure the alias value in the ``_protected/music`` location matches your MUSIC_DIRECTORY_SERVE_PATH env var."
msgstr ""
#: ../../installation/index.rst:276
msgid "Finally, check that the configuration is valid with ``nginx -t`` then reload your nginx server with ``sudo systemctl reload nginx``."
msgstr ""
#: ../../installation/index.rst:279
msgid "Music (and other static) files are never served by the app itself, but by the reverse proxy. This is needed because a webserver is way more efficient at serving files than a Python process."
msgstr ""
#: ../../installation/index.rst:283
msgid "However, we do want to ensure users have the right to access music files, and it can't be done at the proxy's level. To tackle this issue, `we use nginx's internal directive <http://nginx.org/en/docs/http/ngx_http_core_module.html#internal>`_."
msgstr ""
#: ../../installation/index.rst:287
msgid "When the API receives a request on its music serving endpoint, it will check that the user making the request can access the file. Then, it will return an empty response with a ``X-Accel-Redirect`` header. This header will contain the path to the file to serve to the user, and will be picked by nginx, but never sent back to the client."
msgstr ""
#: ../../installation/index.rst:293
msgid "Using this technique, we can ensure music files are covered by the authentication and permission policy of your instance, while remaining as performant as possible."
msgstr ""
#: ../../installation/index.rst:298
msgid "Apache2"
msgstr ""
#: ../../installation/index.rst:302
msgid "These instructions are for Debian only. For Arch Linux please refer to the `Arch Linux wiki <https://wiki.archlinux.org/index.php/Apache>`_."
msgstr ""
#: ../../installation/index.rst:305
msgid "Ensure you have a recent version of Apache2 installed on your server. You'll also need the following dependencies::"
msgstr ""
#: ../../installation/index.rst:310
msgid "Add the following to your ``.env`` file::"
msgstr ""
#: ../../installation/index.rst:314
msgid "Then restart Funkwhale. This is needed to ensure Funkwhale provides proper headers for media file serving."
msgstr ""
#: ../../installation/index.rst:317
msgid "Then, download our sample virtualhost file:"
msgstr ""
#: ../../installation/index.rst:324
msgid "Tweak the configuration file according to your setup, especially the TLS configuration. Otherwise, defaults should work if you followed the installation guide."
msgstr ""
#: ../../installation/index.rst:328
msgid "Check the configuration with ``apache2ctl configtest`` and once you're done, load the new configuration with ``service apache2 restart``."
msgstr ""
#: ../../installation/index.rst:333
msgid "Caddy"
msgstr ""
#: ../../installation/index.rst:335
msgid "We currently do not support a Caddy-only setup, but you can `help develop it <https://dev.funkwhale.audio/funkwhale/funkwhale/-/merge_requests/1384>`_!"
msgstr ""
#: ../../installation/index.rst:338
msgid "To employ Caddy as a reverse proxy in front of your docker containers (either mono- or multi-container setup), use the following Caddyfile configuration:"
msgstr ""
#: ../../installation/index.rst:342
msgid "Caddy v2::"
msgstr ""
#: ../../installation/index.rst:348
msgid "Caddy v1::"
msgstr ""
#: ../../installation/index.rst:359
msgid "HTTPS configuration"
msgstr ""
#: ../../installation/index.rst:361
msgid "After configuring the reverse proxy, you need a SSL certificate to enable HTTPS on your server (unless you use Caddy, which handles them automatically)."
msgstr ""
#: ../../installation/index.rst:365
msgid "The default reverse proxy configuration assumes you have those available at ``/etc/letsencrypt/live/${FUNKWHALE_HOSTNAME}/``, which is the path used by `certbot <https://certbot.eff.org/docs/>`_ when generating certificates with Let's Encrypt."
msgstr ""
#: ../../installation/index.rst:368
msgid "If you already have a certificate you would like to use, simply update the reverse proxy configuration and replace the following values with the proper paths: - For nginx: ``ssl_certificate`` and ``ssl_certificate_key``; - For Apache2: ``SSLCertificateFile`` and ``SSLCertificateKeyFile``."
msgstr ""
#: ../../installation/index.rst:373
msgid "If you don't have one, comment or remove the lines starting with ``ssl_certificate`` and ``ssl_certificate_key`` for nginx, and ``SSLCertificateFile`` and ``SSLCertificateKeyFile`` for Apache2. You can then proceed to generate a certificate, as shown below. These instructions are provided by `certbot <https://certbot.eff.org/instructions>`:"
msgstr ""
#: ../../installation/index.rst:389
msgid "This creates a valid certificate and edit the nginx or Apache2 configuration to use the new certificate. The certificate will be automatically renewed when they expire."
msgstr ""

58
docs/locales/gettext/installation/non_amd64_architectures.pot 100644
Wyświetl plik

@ -0,0 +1,58 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../installation/non_amd64_architectures.rst:2
msgid "Running Funkwhale on non amd64 architectures"
msgstr ""
#: ../../installation/non_amd64_architectures.rst:4
msgid "Funkwhale should be runnable on any architecture assuming Funkwhale installation dependencies are satisfied."
msgstr ""
#: ../../installation/non_amd64_architectures.rst:6
msgid "On non-docker deployments (e.g. when deploying on debian), this should be completely transparent."
msgstr ""
#: ../../installation/non_amd64_architectures.rst:8
msgid "On docker deployments, you will need to build Funkwhale's image yourself, because we don't provide pre-built multi-arch images on the Docker Hub yet. The build process itself only requires git, Docker and is described below."
msgstr ""
#: ../../installation/non_amd64_architectures.rst:13
msgid "Building the mono-process Docker image (funkwhale/funkwhale)"
msgstr ""
#: ../../installation/non_amd64_architectures.rst:15
msgid "This image is intended to be used in conjunction with our :ref:`Multi-container installation guide <docker-multi-container>`."
msgstr ""
#: ../../installation/non_amd64_architectures.rst:23
#: ../../installation/non_amd64_architectures.rst:61
msgid "Replace by develop for building a development branch image."
msgstr ""
#: ../../installation/non_amd64_architectures.rst:44
msgid "Building the mono-container Docker image (funkwhale/all-in-one)"
msgstr ""
#: ../../installation/non_amd64_architectures.rst:48
msgid "The All-In-One-Container or Mono-Container installation is deprecated, don't use it for new installations. For more information, visit our blog: https://blog.funkwhale.audio/deprecation-all-in-one-container.html"
msgstr ""
#: ../../installation/non_amd64_architectures.rst:51
msgid "This image is intended to be used in conjunction with our :ref:`Mono-container installation guide <docker-mono-container>`. guide."
msgstr ""

124
docs/locales/gettext/moderator_documentation/allow_listing/add_domain.pot 100644
Wyświetl plik

@ -0,0 +1,124 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/allow_listing/add_domain.md:1
msgid "Add a domain to your allow-list"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:3
msgid "If you have allow-listing enabled, you need to add a domain to your allow-list to interact with it. You can add new domains in two ways:"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:13
msgid "Add a new domain"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:15
msgid "To add a domain that is not currently in your domains list:"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:0
#: ../../moderator_documentation/allow_listing/add_domain.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:19
#: ../../moderator_documentation/allow_listing/add_domain.md:31
#: ../../moderator_documentation/allow_listing/add_domain.md:49
#: ../../moderator_documentation/allow_listing/add_domain.md:61
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:20
#: ../../moderator_documentation/allow_listing/add_domain.md:50
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:21
#: ../../moderator_documentation/allow_listing/add_domain.md:33
#: ../../moderator_documentation/allow_listing/add_domain.md:51
#: ../../moderator_documentation/allow_listing/add_domain.md:63
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:22
#: ../../moderator_documentation/allow_listing/add_domain.md:34
#: ../../moderator_documentation/allow_listing/add_domain.md:52
#: ../../moderator_documentation/allow_listing/add_domain.md:64
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:23
#: ../../moderator_documentation/allow_listing/add_domain.md:35
msgid "Enter the URL of the Fediverse server you want to add in the {guilabel}`Add a domain` field."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:24
#: ../../moderator_documentation/allow_listing/add_domain.md:36
msgid "Check ({fa}`check-square`) the checkbox labeled {guilabel}`Add to allow-list`."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:25
#: ../../moderator_documentation/allow_listing/add_domain.md:37
msgid "Select {guilabel}`Add`."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:0
#: ../../moderator_documentation/allow_listing/add_domain.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:32
#: ../../moderator_documentation/allow_listing/add_domain.md:62
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:41
msgid "That's it! You've added the domain to your pod's allow-list."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:43
msgid "Add a known domain"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:45
msgid "To add a domain that is already in your pod's domain list:"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:53
#: ../../moderator_documentation/allow_listing/add_domain.md:65
msgid "Check ({fa}`check-square`) the checkbox next to the domain(s) you want to add to the allow-list."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:54
#: ../../moderator_documentation/allow_listing/add_domain.md:66
msgid "Select {guilabel}`Add to allow-list` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:55
#: ../../moderator_documentation/allow_listing/add_domain.md:67
msgid "Select {guilabel}`Go`. A green tick ({fa}`check`) appears next to the domain(s)"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:71
msgid "You're done! You've added the domain to your pod's allow-list."
msgstr ""

34
docs/locales/gettext/moderator_documentation/allow_listing/index.pot 100644
Wyświetl plik

@ -0,0 +1,34 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/allow_listing/index.md:7
#: ../../moderator_documentation/allow_listing/index.md:7
msgid "Manage your pod's allow-list"
msgstr ""
#: ../../moderator_documentation/allow_listing/index.md:1
msgid "Allow-listing"
msgstr ""
#: ../../moderator_documentation/allow_listing/index.md:3
msgid "By default, Funkwhale communicates with all reachable pods on the {term}`Fediverse`. If you want to lock down which pods you interact with, your pod admin can enable __allow-listing__. With this enabled, only pods on your allow-list can interact with your pod."
msgstr ""
#: ../../moderator_documentation/allow_listing/index.md:5
msgid "If you didn't use allow-listing before, you can remove all content from pods not on your list. Check out our guide on [purging content](../domains/purge_domain.md) to remove this content."
msgstr ""

83
docs/locales/gettext/moderator_documentation/allow_listing/remove_domain.pot 100644
Wyświetl plik

@ -0,0 +1,83 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/allow_listing/remove_domain.md:1
msgid "Remove a domain from your allow-list"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:3
msgid "You can remove a domain from your {term}`pod's <Pod>` allow-list to stop communicating with it."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:9
msgid "To remove a domain from your allow-list:"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:13
#: ../../moderator_documentation/allow_listing/remove_domain.md:25
msgid "Log in to your pod."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:14
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:15
#: ../../moderator_documentation/allow_listing/remove_domain.md:27
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:16
#: ../../moderator_documentation/allow_listing/remove_domain.md:28
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:17
#: ../../moderator_documentation/allow_listing/remove_domain.md:29
msgid "Check ({fa}`check-square`) the checkbox next to the domain(s) you want to add to the allow-list."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:18
#: ../../moderator_documentation/allow_listing/remove_domain.md:30
msgid "Select {guilabel}`Remove from allow-list` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:19
#: ../../moderator_documentation/allow_listing/remove_domain.md:31
msgid "Select {guilabel}`Go`."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:26
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:35
msgid "You're done! You've removed the domain from your pod's allow-list."
msgstr ""

197
docs/locales/gettext/moderator_documentation/content/delete_content.pot 100644
Wyświetl plik

@ -0,0 +1,197 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/content/delete_content.md:1
msgid "Delete content from your pod"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:4
msgid "Deleting content from your pod deletes the files from the server. Deleting objects like channels and libraries deletes all associated content. This action is irreversible."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:7
msgid "Moderators can delete content from their {term}`pod` if required. Use this feature to handle content that violates your pod's rules."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:10
msgid "{guilabel}`Moderation` – provides access to the administration menu."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:11
msgid "{guilabel}`Library` – provides access to the library menu."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:14
msgid "There are two ways to delete content:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:20
msgid "Delete individual objects"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:22
msgid "If you want to delete a specific object:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:0
#: ../../moderator_documentation/content/delete_content.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:26
#: ../../moderator_documentation/content/delete_content.md:46
#: ../../moderator_documentation/content/delete_content.md:72
#: ../../moderator_documentation/content/delete_content.md:93
msgid "Log in to your pod."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:27
#: ../../moderator_documentation/content/delete_content.md:73
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:28
#: ../../moderator_documentation/content/delete_content.md:48
#: ../../moderator_documentation/content/delete_content.md:74
#: ../../moderator_documentation/content/delete_content.md:95
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:29
#: ../../moderator_documentation/content/delete_content.md:49
#: ../../moderator_documentation/content/delete_content.md:75
#: ../../moderator_documentation/content/delete_content.md:96
msgid "Select the type of content you want to delete from the top of the page:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:30
#: ../../moderator_documentation/content/delete_content.md:50
#: ../../moderator_documentation/content/delete_content.md:76
#: ../../moderator_documentation/content/delete_content.md:97
msgid "{guilabel}`Channels`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:31
#: ../../moderator_documentation/content/delete_content.md:51
#: ../../moderator_documentation/content/delete_content.md:77
#: ../../moderator_documentation/content/delete_content.md:98
msgid "{guilabel}`Artists`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:32
#: ../../moderator_documentation/content/delete_content.md:52
#: ../../moderator_documentation/content/delete_content.md:78
#: ../../moderator_documentation/content/delete_content.md:99
msgid "{guilabel}`Albums`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:33
#: ../../moderator_documentation/content/delete_content.md:53
#: ../../moderator_documentation/content/delete_content.md:79
#: ../../moderator_documentation/content/delete_content.md:100
msgid "{guilabel}`Tracks`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:34
#: ../../moderator_documentation/content/delete_content.md:54
#: ../../moderator_documentation/content/delete_content.md:80
#: ../../moderator_documentation/content/delete_content.md:101
msgid "{guilabel}`Libraries`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:35
#: ../../moderator_documentation/content/delete_content.md:55
#: ../../moderator_documentation/content/delete_content.md:81
#: ../../moderator_documentation/content/delete_content.md:102
msgid "{guilabel}`Uploads`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:36
#: ../../moderator_documentation/content/delete_content.md:56
#: ../../moderator_documentation/content/delete_content.md:82
#: ../../moderator_documentation/content/delete_content.md:103
msgid "{guilabel}`Tags`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:37
#: ../../moderator_documentation/content/delete_content.md:57
#: ../../moderator_documentation/content/delete_content.md:83
#: ../../moderator_documentation/content/delete_content.md:104
msgid "Use the filters on the content page to find the object you want to delete."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:38
#: ../../moderator_documentation/content/delete_content.md:58
msgid "Select the object to go to its moderation page."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:39
#: ../../moderator_documentation/content/delete_content.md:59
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this {object}` warning appears."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:40
#: ../../moderator_documentation/content/delete_content.md:60
msgid "Select {guilabel}`Delete`."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:0
#: ../../moderator_documentation/content/delete_content.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:47
#: ../../moderator_documentation/content/delete_content.md:94
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:64
msgid "That's it! You've deleted the object."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:66
msgid "Delete objects in bulk"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:68
msgid "To delete several items at once:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:84
#: ../../moderator_documentation/content/delete_content.md:105
msgid "Select the checkbox ({fa}`square`) next to the objects you want to delete. Selected objects show a tick ({fa}`check-square`)."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:85
#: ../../moderator_documentation/content/delete_content.md:106
msgid "Select {guilabel}`Delete` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:86
#: ../../moderator_documentation/content/delete_content.md:107
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch delete on {count} items` warning appears."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:87
#: ../../moderator_documentation/content/delete_content.md:108
msgid "Select {guilabel}`Launch`."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:112
msgid "You're done! You've deleted the selected objects from your pod."
msgstr ""

123
docs/locales/gettext/moderator_documentation/content/handle_edits.pot 100644
Wyświetl plik

@ -0,0 +1,123 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/content/handle_edits.md:1
msgid "Handle edits"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:4
msgid "Users can edit content in their own libraries. Moderators don't need to approve these edits. The edits appear in the __Edits__ queue to give admins and moderators a full timeline of changes."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:7
msgid "Users can suggest metadata edits on objects they can access. When a user suggests an edit, it's sent to the __Edits__ queue for review. Moderators and pod admins can accept or reject these edits."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:10
msgid "{guilabel}`Moderation` – provides access to the administration menu."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:11
msgid "{guilabel}`Library` – provides access to the library menu."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:14
msgid "Each edit object contains the following information:"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:16
msgid "A {guilabel}`Modification` ID – the unique ID of the modification. Select this to show the modification in context with the edited object."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:17
msgid "A timestamp of when the user suggested the edit."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:18
msgid "The status of the edit."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:19
msgid "The {guilabel}`Field` that the user edited."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:20
msgid "The {guilabel}`Old value` that the user edited."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:21
msgid "The {guilabel}`New value` that the user entered."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:22
msgid "The user who suggested the edit."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:24
msgid "To review suggested edits:"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:28
#: ../../moderator_documentation/content/handle_edits.md:40
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:29
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:30
#: ../../moderator_documentation/content/handle_edits.md:42
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens. The {guilabel}`Library edits` section displays a list of unresolved edits."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:31
#: ../../moderator_documentation/content/handle_edits.md:43
msgid "Review the edit and select on of the following options:"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:32
#: ../../moderator_documentation/content/handle_edits.md:44
msgid "{guilabel}`Approve` – approve the edit and apply it to the object."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:33
#: ../../moderator_documentation/content/handle_edits.md:45
msgid "{guilabel}`Reject` – reject the edit and leave the object in its current state."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:34
#: ../../moderator_documentation/content/handle_edits.md:46
msgid "{guilabel}`Delete` – delete the edit suggestion without taking further action. The object remains in its current state."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:41
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:50
msgid "That's it! You've handled the edit request. You can use the filters on this page to search for historical requests."
msgstr ""

30
docs/locales/gettext/moderator_documentation/content/index.pot 100644
Wyświetl plik

@ -0,0 +1,30 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/content/index.md:5
#: ../../moderator_documentation/content/index.md:5
msgid "Manage your pod's content"
msgstr ""
#: ../../moderator_documentation/content/index.md:1
msgid "Moderate content on your pod"
msgstr ""
#: ../../moderator_documentation/content/index.md:3
msgid "If you have the __Library__ permission, you can change content on your pod. Use this permission to hide copyrighted content and remove offensive material."
msgstr ""

101
docs/locales/gettext/moderator_documentation/content/library_visibility.pot 100644
Wyświetl plik

@ -0,0 +1,101 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/content/library_visibility.md:1
msgid "Change the visibility of a library"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:4
msgid "You can only change the visibility of libraries stored on your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:7
msgid "If a user has put copyrighted material in a public library, you can change the visibility of the library. This lets the user keep the content and protects your pod from legal issues."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:10
msgid "{guilabel}`Moderation` – provides access to the administration menu."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:11
msgid "{guilabel}`Library` – provides access to the library menu."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:14
msgid "To change the visibility of a library:"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:18
#: ../../moderator_documentation/content/library_visibility.md:32
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:19
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:20
#: ../../moderator_documentation/content/library_visibility.md:34
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:21
#: ../../moderator_documentation/content/library_visibility.md:35
msgid "Select {guilabel}`Libraries` at the top of the page. The {guilabel}`Libraries` page opens."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:22
#: ../../moderator_documentation/content/library_visibility.md:36
msgid "Select the library you want to update. The library's moderation page opens."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:23
#: ../../moderator_documentation/content/library_visibility.md:37
msgid "Select one of the following options from the {guilabel}`Visibility` dropdown menu:"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:24
#: ../../moderator_documentation/content/library_visibility.md:38
msgid "{guilabel}`Private` – makes the library visible only to the owner and anyone they have shared it with."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:25
#: ../../moderator_documentation/content/library_visibility.md:39
msgid "{guilabel}`Instance` – makes the library visible only to users who have an account on your pod."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:26
#: ../../moderator_documentation/content/library_visibility.md:40
msgid "{guilabel}`Everyone` – makes the library visible to users across all pods."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:33
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:44
msgid "That's it! You've updated the library's visibility. You should contact the user informing them of the action."
msgstr ""

78
docs/locales/gettext/moderator_documentation/domains/add_domain.pot 100644
Wyświetl plik

@ -0,0 +1,78 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/domains/add_domain.md:1
msgid "Add a domain to your pod's domain list"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:3
msgid "Funkwhale records the domains of other {term}`Fediverse` servers when users interact with them. Once a domain is in your domains list, you can [add moderation rules](add_rules.md) to it."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:9
msgid "You can also add domains to this list at any time to create rules before users interact with them. To do this:"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:13
#: ../../moderator_documentation/domains/add_domain.md:24
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:14
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:15
#: ../../moderator_documentation/domains/add_domain.md:26
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:16
#: ../../moderator_documentation/domains/add_domain.md:27
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:17
#: ../../moderator_documentation/domains/add_domain.md:28
msgid "Enter the URL of the Fediverse server you want to add in the {guilabel}`Add a domain` field."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:18
#: ../../moderator_documentation/domains/add_domain.md:29
msgid "Select {guilabel}`Add` to add the domain. The domain moderation page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:25
msgid "Select the wrench icon ({fa}`wrench`) at the top of the page to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:33
msgid "That's it! The domain is now in your domains list. You can now add moderation rules to this domain."
msgstr ""

107
docs/locales/gettext/moderator_documentation/domains/add_rule.pot 100644
Wyświetl plik

@ -0,0 +1,107 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/domains/add_rule.md:1
msgid "Add a moderation rule"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:4
msgid "Purging a domain's data removes all objects and caches associated to that domain. This impacts users who have objects from these domains in their libraries."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:7
msgid "Add moderation rules to domains to control how they can interact with your {term}`pod`. Moderation rules enable you to restrict content from a domain showing on your pod."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:13
msgid "To add a moderation rule to a domain:"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:17
#: ../../moderator_documentation/domains/add_rule.md:33
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:18
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:19
#: ../../moderator_documentation/domains/add_rule.md:35
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:20
#: ../../moderator_documentation/domains/add_rule.md:36
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:21
#: ../../moderator_documentation/domains/add_rule.md:37
msgid "Select the domain you want to apply the rule to. The domain's moderation page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:22
#: ../../moderator_documentation/domains/add_rule.md:38
msgid "Select {guilabel}`Add a moderation policy`. The moderation policy form appears."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:23
#: ../../moderator_documentation/domains/add_rule.md:39
msgid "Enter the {guilabel}`Reason` you are applying the rule. Depending on your pod's configuration, users may be able to see this."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:24
#: ../../moderator_documentation/domains/add_rule.md:40
msgid "Choose your moderation rule:"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:25
#: ../../moderator_documentation/domains/add_rule.md:41
msgid "{guilabel}`Block everything` – purge all content from the domain and block all content."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:26
#: ../../moderator_documentation/domains/add_rule.md:42
msgid "{guilabel}`Reject media` – only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:27
#: ../../moderator_documentation/domains/add_rule.md:43
msgid "Select {guilabel}`Create` to save your rule."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:34
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:47
msgid "That's all there is to it! You've applied your moderation rule. The rule takes effect as soon as you create it."
msgstr ""

88
docs/locales/gettext/moderator_documentation/domains/delete_rule.pot 100644
Wyświetl plik

@ -0,0 +1,88 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/domains/delete_rule.md:1
msgid "Delete a moderation rule"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:3
msgid "If you no longer need a moderation rule, you can delete it completely. This allows the other server to interact with your pod normally."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:9
msgid "To delete an existing moderation rule:"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:13
#: ../../moderator_documentation/domains/delete_rule.md:26
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:14
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:15
#: ../../moderator_documentation/domains/delete_rule.md:28
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:16
#: ../../moderator_documentation/domains/delete_rule.md:29
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:17
#: ../../moderator_documentation/domains/delete_rule.md:30
msgid "Select the domain with the moderation rule you want to edit. The domain's moderation page opens."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:18
#: ../../moderator_documentation/domains/delete_rule.md:31
msgid "Select {guilabel}`Edit` under the {guilabel}`This domain is subject to specific moderation rules` header. The moderation policy form opens."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:19
#: ../../moderator_documentation/domains/delete_rule.md:32
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this moderation rule?` warning appears."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:20
#: ../../moderator_documentation/domains/delete_rule.md:33
msgid "Select {guilabel}`Delete moderation rule`."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:27
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:37
msgid "That's it! You've deleted your moderation rule. Content from the domain will no longer get blocked."
msgstr ""

117
docs/locales/gettext/moderator_documentation/domains/edit_rule.pot 100644
Wyświetl plik

@ -0,0 +1,117 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/domains/edit_rule.md:1
msgid "Edit a moderation rule"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:4
msgid "Purging a domain's data removes all objects and caches associated to that domain. This impacts users who have objects from these domains in their libraries."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:7
msgid "You can change a moderation rule on a domain at any time."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:13
msgid "To update an existing moderation rule:"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:17
#: ../../moderator_documentation/domains/edit_rule.md:35
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:18
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:19
#: ../../moderator_documentation/domains/edit_rule.md:37
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:20
#: ../../moderator_documentation/domains/edit_rule.md:38
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:21
#: ../../moderator_documentation/domains/edit_rule.md:39
msgid "Select the domain with the moderation rule you want to edit. The domain's moderation page opens."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:22
#: ../../moderator_documentation/domains/edit_rule.md:40
msgid "Select {guilabel}`Edit` under the {guilabel}`This domain is subject to specific moderation rules` header. The moderation policy form opens."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:23
#: ../../moderator_documentation/domains/edit_rule.md:41
msgid "__Optional__ – Edit the following settings:"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:24
#: ../../moderator_documentation/domains/edit_rule.md:42
msgid "{guilabel}`Enabled` – toggle this switch to enable or disable the rule without deleting it."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:25
#: ../../moderator_documentation/domains/edit_rule.md:43
msgid "{guilabel}`Reason` – update the reason for the moderation rule."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:26
#: ../../moderator_documentation/domains/edit_rule.md:44
msgid "__Optional__ – Update your moderation rule:"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:27
#: ../../moderator_documentation/domains/edit_rule.md:45
msgid "{guilabel}`Block everything` – purge all content from this domain and block all content."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:28
#: ../../moderator_documentation/domains/edit_rule.md:46
msgid "{guilabel}`Reject media` – only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:29
#: ../../moderator_documentation/domains/edit_rule.md:47
msgid "Select {guilabel}`Update` to save your rule."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:36
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:51
msgid "You're done! The changes to the rule take effect as soon as you update it."
msgstr ""

35
docs/locales/gettext/moderator_documentation/domains/index.pot 100644
Wyświetl plik

@ -0,0 +1,35 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/domains/index.md:5
#: ../../moderator_documentation/domains/index.md:5
msgid "Manage external domains"
msgstr ""
#: ../../moderator_documentation/domains/index.md:16
#: ../../moderator_documentation/domains/index.md:16
msgid "Manage moderation rules"
msgstr ""
#: ../../moderator_documentation/domains/index.md:1
msgid "Moderate external domains"
msgstr ""
#: ../../moderator_documentation/domains/index.md:3
msgid "You can add moderation rules to control how your {term}`pod` interacts with other domains. Use these rules to control access to content and interaction with users on other pods."
msgstr ""

92
docs/locales/gettext/moderator_documentation/domains/purge_domain.pot 100644
Wyświetl plik

@ -0,0 +1,92 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/domains/purge_domain.md:1
msgid "Purge domain data"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:4
msgid "Purging a domain's data removes all objects and caches associated to that domain. This impacts users who have objects from these domains in their libraries."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:7
msgid "When users follow content from another domain that content is visible on your {term}`pod`. If a domain hosts illegal or offensive content you can purge the content associated with it."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:13
msgid "To purge content from a domain:"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:17
#: ../../moderator_documentation/domains/purge_domain.md:30
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:18
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:19
#: ../../moderator_documentation/domains/purge_domain.md:32
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:20
#: ../../moderator_documentation/domains/purge_domain.md:33
msgid "Select {guilabel}`Domains` at the top of the page. The {guilabel}`Domains` page opens. You can see a list of known domains on this page."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:21
#: ../../moderator_documentation/domains/purge_domain.md:34
msgid "Select the checkbox ({fa}`square`) next to the domain(s) you want to purge. Selected domains show a tick ({fa}`check-square`)."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:22
#: ../../moderator_documentation/domains/purge_domain.md:35
msgid "Select {guilabel}`Purge` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:23
#: ../../moderator_documentation/domains/purge_domain.md:36
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch purge on {count} items` warning appears."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:24
#: ../../moderator_documentation/domains/purge_domain.md:37
msgid "Select {guilabel}`Launch`."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:31
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:41
msgid "You're done! Your pod clears all the content associated with the selected domains."
msgstr ""

107
docs/locales/gettext/moderator_documentation/external_users/add_rule.pot 100644
Wyświetl plik

@ -0,0 +1,107 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/external_users/add_rule.md:1
msgid "Add a moderation rule"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:4
msgid "Purging a user's data removes all objects and caches associated to that user. This impacts users who have objects from these users in their libraries."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:7
msgid "Add moderation rules to users to control how they can interact with your {term}`pod`. Moderation rules enable you to restrict content from a user showing on your pod."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:13
msgid "To add a moderation rule to a user:"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:17
#: ../../moderator_documentation/external_users/add_rule.md:33
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:18
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:19
#: ../../moderator_documentation/external_users/add_rule.md:35
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:20
#: ../../moderator_documentation/external_users/add_rule.md:36
msgid "Select {guilabel}`Accounts` at the top of the page. The {guilabel}`Accounts` page opens. You can see a list of known accounts on this page."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:21
#: ../../moderator_documentation/external_users/add_rule.md:37
msgid "Select the account you want to apply the rule to. The account's moderation page opens."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:22
#: ../../moderator_documentation/external_users/add_rule.md:38
msgid "Select {guilabel}`Add a moderation policy`. The moderation policy form appears."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:23
#: ../../moderator_documentation/external_users/add_rule.md:39
msgid "Enter the {guilabel}`Reason` you are applying the rule. Depending on your pod's configuration, users may be able to see this."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:24
#: ../../moderator_documentation/external_users/add_rule.md:40
msgid "Choose your moderation rule:"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:25
#: ../../moderator_documentation/external_users/add_rule.md:41
msgid "{guilabel}`Block everything` – purge all content from the user and block all content."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:26
#: ../../moderator_documentation/external_users/add_rule.md:42
msgid "{guilabel}`Reject media` – only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:27
#: ../../moderator_documentation/external_users/add_rule.md:43
msgid "Select {guilabel}`Create` to save your rule."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:34
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:47
msgid "That's all there is to it! You've applied your moderation rule. The rule takes effect as soon as you create it."
msgstr ""

88
docs/locales/gettext/moderator_documentation/external_users/delete_rule.pot 100644
Wyświetl plik

@ -0,0 +1,88 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/external_users/delete_rule.md:1
msgid "Delete a moderation rule"
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:3
msgid "If you no longer need a moderation rule, you can delete it completely. This allows the user to interact with your pod normally."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:9
msgid "To delete an existing moderation rule:"
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:13
#: ../../moderator_documentation/external_users/delete_rule.md:26
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:14
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:15
#: ../../moderator_documentation/external_users/delete_rule.md:28
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:16
#: ../../moderator_documentation/external_users/delete_rule.md:29
msgid "Select {guilabel}`Users` at the top of the page. The {guilabel}`Users` page opens. You can see a list of known users on this page."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:17
#: ../../moderator_documentation/external_users/delete_rule.md:30
msgid "Select the user with the moderation rule you want to edit. The user's moderation page opens."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:18
#: ../../moderator_documentation/external_users/delete_rule.md:31
msgid "Select {guilabel}`Edit` under the {guilabel}`This user is subject to specific moderation rules` header. The moderation policy form opens."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:19
#: ../../moderator_documentation/external_users/delete_rule.md:32
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this moderation rule?` warning appears."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:20
#: ../../moderator_documentation/external_users/delete_rule.md:33
msgid "Select {guilabel}`Delete moderation rule`."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:27
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/delete_rule.md:37
msgid "That's it! You've deleted your moderation rule. Content from the user will no longer get blocked."
msgstr ""

117
docs/locales/gettext/moderator_documentation/external_users/edit_rule.pot 100644
Wyświetl plik

@ -0,0 +1,117 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/external_users/edit_rule.md:1
msgid "Edit a moderation rule"
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:4
msgid "Purging a user's data removes all objects and caches associated to that user. This impacts users who have objects from these users in their libraries."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:7
msgid "You can change a moderation rule on a user at any time."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:13
msgid "To update an existing moderation rule:"
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:17
#: ../../moderator_documentation/external_users/edit_rule.md:35
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:18
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:19
#: ../../moderator_documentation/external_users/edit_rule.md:37
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:20
#: ../../moderator_documentation/external_users/edit_rule.md:38
msgid "Select {guilabel}`Users` at the top of the page. The {guilabel}`Users` page opens. You can see a list of known users on this page."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:21
#: ../../moderator_documentation/external_users/edit_rule.md:39
msgid "Select the user with the moderation rule you want to edit. The user's moderation page opens."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:22
#: ../../moderator_documentation/external_users/edit_rule.md:40
msgid "Select {guilabel}`Edit` under the {guilabel}`This user is subject to specific moderation rules` header. The moderation policy form opens."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:23
#: ../../moderator_documentation/external_users/edit_rule.md:41
msgid "__Optional__ – Edit the following settings:"
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:24
#: ../../moderator_documentation/external_users/edit_rule.md:42
msgid "{guilabel}`Enabled` – toggle this switch to enable or disable the rule without deleting it."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:25
#: ../../moderator_documentation/external_users/edit_rule.md:43
msgid "{guilabel}`Reason` – update the reason for the moderation rule."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:26
#: ../../moderator_documentation/external_users/edit_rule.md:44
msgid "__Optional__ – Update your moderation rule:"
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:27
#: ../../moderator_documentation/external_users/edit_rule.md:45
msgid "{guilabel}`Block everything` – purge all content from this user and block all content."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:28
#: ../../moderator_documentation/external_users/edit_rule.md:46
msgid "{guilabel}`Reject media` – only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:29
#: ../../moderator_documentation/external_users/edit_rule.md:47
msgid "Select {guilabel}`Update` to save your rule."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:36
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/edit_rule.md:51
msgid "You're done! The changes to the rule take effect as soon as you update it."
msgstr ""

35
docs/locales/gettext/moderator_documentation/external_users/index.pot 100644
Wyświetl plik

@ -0,0 +1,35 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/external_users/index.md:5
#: ../../moderator_documentation/external_users/index.md:5
msgid "Manage external users"
msgstr ""
#: ../../moderator_documentation/external_users/index.md:15
#: ../../moderator_documentation/external_users/index.md:15
msgid "Manage moderation rules"
msgstr ""
#: ../../moderator_documentation/external_users/index.md:1
msgid "Moderate external users"
msgstr ""
#: ../../moderator_documentation/external_users/index.md:3
msgid "You can add moderation rules to control how external users can interact with your {term}`pod`. This lets you filter users from other pods without applying rules to their whole [domain](../domains/index.md)."
msgstr ""

92
docs/locales/gettext/moderator_documentation/external_users/purge_users.pot 100644
Wyświetl plik

@ -0,0 +1,92 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/external_users/purge_users.md:1
msgid "Purge user data"
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:4
msgid "Purging a user's data removes all objects and caches associated to that user. This impacts users who have objects from these users in their libraries."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:7
msgid "When users follow users from another domain their content is visible on your {term}`pod`. If a user posts illegal or offensive content you can purge the content associated with them."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:13
msgid "To purge a user's content:"
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:17
#: ../../moderator_documentation/external_users/purge_users.md:30
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:18
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:19
#: ../../moderator_documentation/external_users/purge_users.md:32
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:20
#: ../../moderator_documentation/external_users/purge_users.md:33
msgid "Select {guilabel}`Accounts` at the top of the page. The {guilabel}`Accounts` page opens. You can see a list of known accounts on this page."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:21
#: ../../moderator_documentation/external_users/purge_users.md:34
msgid "Select the checkbox ({fa}`square`) next to the account(s) you want to purge. Selected accounts show a tick ({fa}`check-square`)."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:22
#: ../../moderator_documentation/external_users/purge_users.md:35
msgid "Select {guilabel}`Purge` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:23
#: ../../moderator_documentation/external_users/purge_users.md:36
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch purge on {count} element(s)` warning appears."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:24
#: ../../moderator_documentation/external_users/purge_users.md:37
msgid "Select {guilabel}`Launch`."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:31
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/external_users/purge_users.md:41
msgid "You're done! Your pod clears all the content associated with the selected users."
msgstr ""

85
docs/locales/gettext/moderator_documentation/index.pot 100644
Wyświetl plik

@ -0,0 +1,85 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/index.md:1
msgid "Get started"
msgstr ""
#: ../../moderator_documentation/index.md:3
msgid "{term}`Pod` moderators are responsible for enforcing the rules of a pod. Moderation permissions enable moderators to provide specific tasks:"
msgstr ""
#: ../../moderator_documentation/index.md:5
msgid "{guilabel}`Moderation` – enables the moderator to moderate users, domains, and the allow-list."
msgstr ""
#: ../../moderator_documentation/index.md:6
msgid "{guilabel}`Library` – enables the moderator to make changes to library content. This includes deleting local objects and handling edit suggestions."
msgstr ""
#: ../../moderator_documentation/index.md:8
msgid "Follow the guides in our moderator documentation to handle moderation tasks."
msgstr ""
#: ../../moderator_documentation/index.md:14
msgid "Handle user reports"
msgstr ""
#: ../../moderator_documentation/index.md:16
msgid "One of the most important duties of a moderator is handling reports. If a user finds content that violates your pod's rules or the law, they can report it. Users can also report other users if they have broken the rules of your pod. Follow the guides in the [Reports](reports/index.md) section to learn how to handle these reports."
msgstr ""
#: ../../moderator_documentation/index.md:18
msgid "Moderate your pod's users"
msgstr ""
#: ../../moderator_documentation/index.md:20
msgid "As a moderator, you are responsible for moderating the behavior of users on your pod. Funkwhale provides you with tools to help you handle users that violate your pod's rules. Check out our [Moderate your pod's users](internal_users/index.md) section for more information."
msgstr ""
#: ../../moderator_documentation/index.md:22
msgid "Moderate content on your pod"
msgstr ""
#: ../../moderator_documentation/index.md:24
msgid "Funkwhale's moderation tools enable moderators to handle the content on a pod. This means you can update, delete, or hide content. It also enables you to approve or reject edits submitted by users on your pod. Check out the guides in the [Moderate content on your pod](content/index.md) for more information."
msgstr ""
#: ../../moderator_documentation/index.md:26
msgid "Moderate external domains"
msgstr ""
#: ../../moderator_documentation/index.md:28
msgid "As {term}`fediverse` software, Funkwhale interacts with other software over federation. Read through the [Moderate external domains](domains/index.md) section to handle content from other servers."
msgstr ""
#: ../../moderator_documentation/index.md:30
msgid "Moderate external users"
msgstr ""
#: ../../moderator_documentation/index.md:32
msgid "You can moderate how external users interact with users on your pod. Check out the [Moderate external users](external_users/index.md) guides to learn how to manage users from other servers."
msgstr ""
#: ../../moderator_documentation/index.md:34
msgid "Manage your allow-list"
msgstr ""
#: ../../moderator_documentation/index.md:36
msgid "If your pod admin has set up allow-listing, you can add and remove domains from your pod's list. Follow the guides in the [Allow-listing](allow_listing/index.md) section to learn how to handle your allow-list."
msgstr ""

143
docs/locales/gettext/moderator_documentation/internal_users/handle_registration.pot 100644
Wyświetl plik

@ -0,0 +1,143 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/internal_users/handle_registration.md:1
msgid "Handle user registrations"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:3
msgid "{term}`Pod` admins can enable manual sign-up validation. This setting requires moderators to approve or refuse account creations."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:9
msgid "Requests appear in the {guilabel}`User Requests` list. Each request contains the following information:"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:11
msgid "The user the request was {guilabel}`Submitted by`"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:12
msgid "The {guilabel}`Creation date` of the request."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:13
msgid "__Optional__ – any responses the user left to fields in the sign-up form."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:14
msgid "The {guilabel}`Status` of the request."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:15
msgid "Which moderator the request is {guilabel}`Assigned to`."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:16
msgid "The {guilabel}`Resolution date` of the request."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:17
msgid "Any {guilabel}`Internal notes` left by the moderators."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:23
msgid "Approve a sign-up request"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:25
msgid "To approve a sign-up request:"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:0
#: ../../moderator_documentation/internal_users/handle_registration.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:29
#: ../../moderator_documentation/internal_users/handle_registration.md:40
#: ../../moderator_documentation/internal_users/handle_registration.md:57
#: ../../moderator_documentation/internal_users/handle_registration.md:68
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:30
#: ../../moderator_documentation/internal_users/handle_registration.md:58
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:31
#: ../../moderator_documentation/internal_users/handle_registration.md:42
#: ../../moderator_documentation/internal_users/handle_registration.md:59
#: ../../moderator_documentation/internal_users/handle_registration.md:70
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:32
#: ../../moderator_documentation/internal_users/handle_registration.md:43
#: ../../moderator_documentation/internal_users/handle_registration.md:60
#: ../../moderator_documentation/internal_users/handle_registration.md:71
msgid "Select {guilabel}`User Requests` at the top of the screen. A list of pending requests appears."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:33
#: ../../moderator_documentation/internal_users/handle_registration.md:44
#: ../../moderator_documentation/internal_users/handle_registration.md:61
#: ../../moderator_documentation/internal_users/handle_registration.md:72
msgid "Read through the details of the request."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:34
#: ../../moderator_documentation/internal_users/handle_registration.md:45
msgid "Select {guilabel}`Approve` in the {guilabel}`Actions` section."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:0
#: ../../moderator_documentation/internal_users/handle_registration.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:41
#: ../../moderator_documentation/internal_users/handle_registration.md:69
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:49
msgid "That's it! You've approved the user's sign-up request. The user can now log in."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:51
msgid "Refuse a sign-up request"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:53
msgid "To refuse a sign-up request:"
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:62
#: ../../moderator_documentation/internal_users/handle_registration.md:73
msgid "Select {guilabel}`Refuse` in the {guilabel}`Actions` section."
msgstr ""
#: ../../moderator_documentation/internal_users/handle_registration.md:77
msgid "That's it! You've refused the user's sign-up request. The user can't log in to your pod."
msgstr ""

39
docs/locales/gettext/moderator_documentation/internal_users/index.pot 100644
Wyświetl plik

@ -0,0 +1,39 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/internal_users/index.md:7
#: ../../moderator_documentation/internal_users/index.md:7
msgid "Moderate users"
msgstr ""
#: ../../moderator_documentation/internal_users/index.md:17
#: ../../moderator_documentation/internal_users/index.md:17
msgid "Handle user registrations"
msgstr ""
#: ../../moderator_documentation/internal_users/index.md:1
msgid "Moderate your pod's users"
msgstr ""
#: ../../moderator_documentation/internal_users/index.md:3
msgid "Funkwhale provides you the tools you need to moderate users on your pod. Use these tools to tackle harassment and problematic content."
msgstr ""
#: ../../moderator_documentation/internal_users/index.md:5
msgid "{term}`Pod` admins can also enable manual sign-up validation. With this setting enabled, moderators need to approve or reject any user who signs up."
msgstr ""

149
docs/locales/gettext/moderator_documentation/reports/handle_content.pot 100644
Wyświetl plik

@ -0,0 +1,149 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/reports/handle_content.md:1
msgid "Handle reported content"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:4
msgid "Deleting reported objects is irreversible. This action deletes the associated files from the pod."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:7
msgid "You can handle content reports from the {guilabel}`Reports` page or from the reported object's moderation page. You only need to open the moderation page to edit objects."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:10
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:11
msgid "{guilabel}`Library` – enables the moderator to delete objects."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:18
msgid "Handle reports from the Reports page"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:20
msgid "To handle a content report from the {guilabel}`Reports` page:"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:0
#: ../../moderator_documentation/reports/handle_content.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:24
#: ../../moderator_documentation/reports/handle_content.md:36
#: ../../moderator_documentation/reports/handle_content.md:54
#: ../../moderator_documentation/reports/handle_content.md:70
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:25
#: ../../moderator_documentation/reports/handle_content.md:55
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:26
#: ../../moderator_documentation/reports/handle_content.md:38
#: ../../moderator_documentation/reports/handle_content.md:56
#: ../../moderator_documentation/reports/handle_content.md:72
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:27
#: ../../moderator_documentation/reports/handle_content.md:39
#: ../../moderator_documentation/reports/handle_content.md:57
#: ../../moderator_documentation/reports/handle_content.md:73
msgid "[Search for the report](search_reports.md)."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:28
#: ../../moderator_documentation/reports/handle_content.md:40
msgid "Select an action from the {guilabel}`Actions` section:"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:29
#: ../../moderator_documentation/reports/handle_content.md:41
msgid "{guilabel}`Resolve` – resolve the report with no further action."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:30
#: ../../moderator_documentation/reports/handle_content.md:42
msgid "{guilabel}`Delete reported object` – delete the object associated with the report. If you delete an artist or album, this deletes all files associated with the object."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:0
#: ../../moderator_documentation/reports/handle_content.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:37
#: ../../moderator_documentation/reports/handle_content.md:71
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:46
#: ../../moderator_documentation/reports/handle_content.md:84
msgid "Resolving the report assigns it to you so other moderators know who handled the report. Add [internal notes](internal_notes.md) to keep a record of your changes."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:48
msgid "Edit content in the moderation page"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:50
msgid "If you want to edit an object to change its metadata:"
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:58
#: ../../moderator_documentation/reports/handle_content.md:74
msgid "Select {guilabel}`Open in moderation interface` in the {guilabel}`Reported object` section. The object's moderation page opens."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:59
#: ../../moderator_documentation/reports/handle_content.md:75
msgid "Select {guilabel}`Edit`. The {guilabel}`Edit` page opens."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:60
#: ../../moderator_documentation/reports/handle_content.md:76
msgid "Edit the details on this page. Leave a {guilabel}`Summary` of your changes for reference."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:61
#: ../../moderator_documentation/reports/handle_content.md:77
msgid "Select {guilabel}`Submit and apply edit`."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:62
#: ../../moderator_documentation/reports/handle_content.md:78
msgid "Return to the {guilabel}`Reports` page."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:63
#: ../../moderator_documentation/reports/handle_content.md:79
msgid "Search for the report."
msgstr ""
#: ../../moderator_documentation/reports/handle_content.md:64
#: ../../moderator_documentation/reports/handle_content.md:80
msgid "Select {guilabel}`Resolve` in the {guilabel}`Actions` section."
msgstr ""

84
docs/locales/gettext/moderator_documentation/reports/handle_users.pot 100644
Wyświetl plik

@ -0,0 +1,84 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/reports/handle_users.md:1
msgid "Handle reported users"
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:3
msgid "If a user has reported another user on your pod, you can make changes to the reported user's profile. Use the user's moderation page to take the appropriate steps to handle the report."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:9
msgid "To open a user's moderation page:"
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:13
#: ../../moderator_documentation/reports/handle_users.md:22
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:14
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:15
#: ../../moderator_documentation/reports/handle_users.md:24
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:16
#: ../../moderator_documentation/reports/handle_users.md:25
msgid "[Search for the report](search_reports.md) and select {guilabel}`Open in moderation interface` under {guilabel}`Reported object`. The user's moderation page opens."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:23
msgid "Select the wrench icon ({fa}`wrench`) at the top of the page to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:29
msgid "You can change the following settings in the moderation interface:"
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:31
msgid "{guilabel}`Login status` – disable this switch to prevent the user being able to log in."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:32
msgid "{guilabel}`Permissions` – add or remove permissions associated with the user."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:33
msgid "{guilabel}`Upload quota` – change the amount of data (in megabytes) that the user can upload."
msgstr ""
#: ../../moderator_documentation/reports/handle_users.md:35
msgid "Once you have made your changes, return to the {guilabel}`Reports` page and {guilabel}`Resolve` the report. Resolving the report assigns it to you so other moderators know who handled the report. Add [internal notes](internal_notes.md) to keep a record of your changes."
msgstr ""

76
docs/locales/gettext/moderator_documentation/reports/index.pot 100644
Wyświetl plik

@ -0,0 +1,76 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/reports/index.md:20
#: ../../moderator_documentation/reports/index.md:20
msgid "Use the reports page"
msgstr ""
#: ../../moderator_documentation/reports/index.md:32
#: ../../moderator_documentation/reports/index.md:1
#: ../../moderator_documentation/reports/index.md:32
msgid "Handle reports"
msgstr ""
#: ../../moderator_documentation/reports/index.md:3
msgid "As a Funkwhale moderator, you have extra permissions. These permissions enable you to handle reports submitted by users and anonymous browsers."
msgstr ""
#: ../../moderator_documentation/reports/index.md:5
msgid "When a user submits a report it ends up in the moderation queue on the {guilabel}`Reports` page. Moderators can use the tools on this page to handle the report."
msgstr ""
#: ../../moderator_documentation/reports/index.md:7
msgid "Each report contains information that can help you handle the reported object:"
msgstr ""
#: ../../moderator_documentation/reports/index.md:9
msgid "The user who submitted the report."
msgstr ""
#: ../../moderator_documentation/reports/index.md:10
msgid "The report {guilabel}`Category`. You can change this if it is not correct."
msgstr ""
#: ../../moderator_documentation/reports/index.md:11
msgid "The date the user submitted the report."
msgstr ""
#: ../../moderator_documentation/reports/index.md:12
msgid "The message the user posted with the report (if applicable)."
msgstr ""
#: ../../moderator_documentation/reports/index.md:13
msgid "The {guilabel}`Status` of the report."
msgstr ""
#: ../../moderator_documentation/reports/index.md:14
msgid "Any {guilabel}`Internal notes` left by moderators."
msgstr ""
#: ../../moderator_documentation/reports/index.md:15
msgid "A summary of the {guilabel}`Reported object`."
msgstr ""
#: ../../moderator_documentation/reports/index.md:16
msgid "A list of available {guilabel}`Actions`."
msgstr ""
#: ../../moderator_documentation/reports/index.md:18
msgid "Follow the guides in this section to start handling reports submitted to your {term}`pod`."
msgstr ""

110
docs/locales/gettext/moderator_documentation/reports/internal_notes.pot 100644
Wyświetl plik

@ -0,0 +1,110 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/reports/internal_notes.md:1
msgid "Use internal notes"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:3
msgid "Use internal notes to add information to a report. This can be a summary of your actions or an update on your investigation. Internal notes are only visible to pod admins and moderators."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:9
msgid "Add notes to a report"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:11
msgid "You can add notes to __Unresolved__ and __Resolved__ reports. To add an internal note:"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:0
#: ../../moderator_documentation/reports/internal_notes.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:15
#: ../../moderator_documentation/reports/internal_notes.md:26
#: ../../moderator_documentation/reports/internal_notes.md:45
#: ../../moderator_documentation/reports/internal_notes.md:56
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:16
#: ../../moderator_documentation/reports/internal_notes.md:46
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:17
#: ../../moderator_documentation/reports/internal_notes.md:28
#: ../../moderator_documentation/reports/internal_notes.md:47
#: ../../moderator_documentation/reports/internal_notes.md:58
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:18
#: ../../moderator_documentation/reports/internal_notes.md:29
#: ../../moderator_documentation/reports/internal_notes.md:48
#: ../../moderator_documentation/reports/internal_notes.md:59
msgid "[Search for the report](search_reports.md)."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:19
#: ../../moderator_documentation/reports/internal_notes.md:30
msgid "{guilabel}`Write` your note in the {guilabel}`Internal notes` section. This input field supports Markdown syntax. You can {guilabel}`Preview` how the note will look to other users."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:20
#: ../../moderator_documentation/reports/internal_notes.md:31
msgid "Select {guilabel}`Add note` to save your note."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:0
#: ../../moderator_documentation/reports/internal_notes.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:27
#: ../../moderator_documentation/reports/internal_notes.md:57
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:35
msgid "Delete notes from a report"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:38
msgid "Deleting an internal note is irreversible. Make sure you are not deleting anything important."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:41
msgid "You can delete your own notes and the notes of other moderators. You can do this for both __Resolved__ and __Unresolved__ reports. To delete an internal note:"
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:49
#: ../../moderator_documentation/reports/internal_notes.md:60
msgid "Find the note you want to delete in the {guilabel}`Internal notes` section."
msgstr ""
#: ../../moderator_documentation/reports/internal_notes.md:50
#: ../../moderator_documentation/reports/internal_notes.md:61
msgid "Select {guilabel}`Delete`"
msgstr ""

89
docs/locales/gettext/moderator_documentation/reports/search_reports.pot 100644
Wyświetl plik

@ -0,0 +1,89 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/reports/search_reports.md:1
msgid "Search for reports"
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:3
msgid "The {guilabel}`Reports` page contains filters that enable you to search for reports. Use these filters to find reports by category, status, or key words."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:11
#: ../../moderator_documentation/reports/search_reports.md:25
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:12
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:13
#: ../../moderator_documentation/reports/search_reports.md:27
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:14
#: ../../moderator_documentation/reports/search_reports.md:28
msgid "Use the filters to find the report you want:"
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:15
#: ../../moderator_documentation/reports/search_reports.md:29
msgid "Enter key words in the {guilabel}`Search` field. This enables you to search for content in the report's {guilabel}`Message` section. Hit {kbd}`⏎ Return` to update your search."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:16
#: ../../moderator_documentation/reports/search_reports.md:30
msgid "Filter reports by {guilabel}`Status`."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:17
#: ../../moderator_documentation/reports/search_reports.md:31
msgid "Filter reports by {guilabel}`Category`."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:18
#: ../../moderator_documentation/reports/search_reports.md:32
msgid "Select the criteria for {guilabel}`Ordering` of your search results."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:19
#: ../../moderator_documentation/reports/search_reports.md:33
msgid "Select which {guilabel}`Order` you want to see your search results in."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:26
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/search_reports.md:37
msgid "Once you have found the required report, you can handle the reported [user](handle_users.md) or [content](handle_content.md). You can also update the [internal notes](internal_notes.md) on the report."
msgstr ""

137
docs/locales/gettext/moderator_documentation/reports/view_reports.pot 100644
Wyświetl plik

@ -0,0 +1,137 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../moderator_documentation/reports/view_reports.md:1
msgid "View unresolved reports"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:3
msgid "When a user reports an object on your {term}`pod`, the report gets sent to a moderation queue. You can check this moderation queue to handle any reports that users have submitted."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:6
msgid "{guilabel}`Moderation` – provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:9
msgid "Check the Reports page"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:11
msgid "You can see a list of unresolved reports by going to the {guilabel}`Reports` page. To do this:"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:0
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:15
#: ../../moderator_documentation/reports/view_reports.md:23
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:16
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:17
#: ../../moderator_documentation/reports/view_reports.md:25
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:0
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:24
msgid "Select the wrench icon ({fa}`wrench`) at the top of the screen to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:29
msgid "That's it! A list of unresolved reports appears on the screen. The summary contains the following information:"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:31
#: ../../moderator_documentation/reports/view_reports.md:46
msgid "The user who submitted the report."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:32
msgid "The report {guilabel}`Category`."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:33
msgid "The date the user submitted the report."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:34
#: ../../moderator_documentation/reports/view_reports.md:50
msgid "The message the user posted with the report (if applicable)."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:35
msgid "The {guilabel}`Status` of the report."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:36
msgid "Any {guilabel}`Internal notes` left by moderators."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:37
msgid "A summary of the {guilabel}`Reported object`."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:38
msgid "A list of available {guilabel}`Actions`."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:40
msgid "Use the tools on this page the handle the reported [content](handle_content.md) or [user](handle_users.md)."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:42
msgid "Email notifications"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:44
msgid "When a user submits a report, an email gets sent to all pod moderators. This email contains a summary of the report including:"
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:47
msgid "The object that the user reported."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:48
msgid "A link to the object on your pod."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:49
msgid "A link to the object's moderation page."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:51
msgid "A link to the report."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:52
msgid "A link to the {guilabel}`Reports` page."
msgstr ""
#: ../../moderator_documentation/reports/view_reports.md:54
msgid "Follow the links in the email to view the report."
msgstr ""

125
docs/locales/gettext/translators.pot 100644
Wyświetl plik

@ -0,0 +1,125 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../../TRANSLATORS.rst:2
msgid "Translating Funkwhale"
msgstr ""
#: ../../../TRANSLATORS.rst:4
msgid "A step-by-step, beginner friendly guide is available at https://contribute.funkwhale.audio/guides/translate/"
msgstr ""
#: ../../../TRANSLATORS.rst:6
msgid "Thank you for reading this! If you want to help translate Funkwhale, you found the proper place :)"
msgstr ""
#: ../../../TRANSLATORS.rst:9
msgid "Translation is done via our own Weblate instance at https://translate.funkwhale.audio/projects/funkwhale/front/."
msgstr ""
#: ../../../TRANSLATORS.rst:11
msgid "You can signup/login using your Gitlab account (from https://dev.funkwhale.audio)."
msgstr ""
#: ../../../TRANSLATORS.rst:14
msgid "Translation workflow"
msgstr ""
#: ../../../TRANSLATORS.rst:16
msgid "Once you're logged-in on the Weblate instance, you can suggest translations. Your suggestions will then be reviewer by the project maintainer or other translators to ensure consistency."
msgstr ""
#: ../../../TRANSLATORS.rst:20
msgid "Guidelines"
msgstr ""
#: ../../../TRANSLATORS.rst:22
msgid "Respecting those guidelines is mandatory if you want your translation to be included:"
msgstr ""
#: ../../../TRANSLATORS.rst:24
msgid "Use gender-neutral language and wording"
msgstr ""
#: ../../../TRANSLATORS.rst:27
msgid "Submitting a new language"
msgstr ""
#: ../../../TRANSLATORS.rst:29
msgid "Pull the latest version of ``develop``"
msgstr ""
#: ../../../TRANSLATORS.rst:30
msgid "Create a new branch, e.g ``git checkout -b translations-new-fr-ca``"
msgstr ""
#: ../../../TRANSLATORS.rst:31
msgid "Add your new language code and name in ``front/src/locales.js``. Use the native language name, as it is what appears in the UI selector."
msgstr ""
#: ../../../TRANSLATORS.rst:32
msgid "Create the ``po`` file from template:"
msgstr ""
#: ../../../TRANSLATORS.rst:40
msgid "Then commit your changes, push, and submit a pull request on the ``develop`` branch"
msgstr ""
#: ../../../TRANSLATORS.rst:43
msgid "Requesting a new language"
msgstr ""
#: ../../../TRANSLATORS.rst:45
msgid "If you cannot submit a new language yourself, you can request it by opening an issue here: https://dev.funkwhale.audio/funkwhale/funkwhale/issues"
msgstr ""
#: ../../../TRANSLATORS.rst:49
msgid "Extracting messages from source"
msgstr ""
#: ../../../TRANSLATORS.rst:51
msgid "We offer a script to update existing ``po`` and ``pot`` files with new translations from the source code. This action should be run regularly, and in particular before lots of translation work is expected (e.g a few weeks before a new release), or when the UI code changes a lot. Otherwise, translators end up translating some obsolete messages, or not translationg new messages."
msgstr ""
#: ../../../TRANSLATORS.rst:57
msgid "`Lock the translations on weblate <https://translate.funkwhale.audio/projects/funkwhale/front/#repository>`_ (``Lock`` button in the sidebar). This will prevent translators from working, and help prevent potential conflicts in the source code"
msgstr ""
#: ../../../TRANSLATORS.rst:58
msgid "`Commit and push changes from weblate <https://translate.funkwhale.audio/projects/funkwhale/front/#repository>`_ (``Commit`` and ``Push`` buttons in the sidebar)"
msgstr ""
#: ../../../TRANSLATORS.rst:59
msgid "Pull ``develop`` in your local git repository to ensure you have the latest version of the translations"
msgstr ""
#: ../../../TRANSLATORS.rst:60
msgid "Create a dedicated branch with ``git checkout -b translations-integration``"
msgstr ""
#: ../../../TRANSLATORS.rst:61
msgid "Extract the translations with ``cd front && ./scripts/i18n-extract.sh``. This will update all ``po`` files as necessary"
msgstr ""
#: ../../../TRANSLATORS.rst:62
msgid "Review, commit and push the changes, then open a merge request on the ``develop`` branch"
msgstr ""
#: ../../../TRANSLATORS.rst:63
msgid "When the MR is merged, `Unlock the translations on weblate <https://translate.funkwhale.audio/projects/funkwhale/front/#repository>`_ (``Unlock`` button in the sidebar)."
msgstr ""

86
docs/locales/gettext/user_documentation/accounts/activity_visibility.pot 100644
Wyświetl plik

@ -0,0 +1,86 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/activity_visibility.md:1
msgid "Change your activity visibility"
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:3
msgid "Your __activity visibility__ determines who can see your listening activity on Funkwhale. There are three visibility options:"
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:5
msgid "__Nobody except me__ – only you can see your listening activity."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:6
msgid "__Everyone on this instance__ – users who have an account on the same {term}`pod` as you can see your listening activity."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:7
msgid "__Everyone, across all instances__ – anybody can see your listening activity."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:9
msgid "To change your activity visibility:"
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:13
#: ../../user_documentation/accounts/activity_visibility.md:24
msgid "Log in to your account."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:14
msgid "Select the cog icon ({fa}`cog`) or your avatar to expand the user menu."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:15
#: ../../user_documentation/accounts/activity_visibility.md:26
msgid "Select {guilabel}`Settings`."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:16
#: ../../user_documentation/accounts/activity_visibility.md:27
msgid "Find {guilabel}`Activity visibility` in the {guilabel}`Account settings` section."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:17
#: ../../user_documentation/accounts/activity_visibility.md:28
msgid "Select your visibility level from the dropdown menu."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:18
#: ../../user_documentation/accounts/activity_visibility.md:29
msgid "Select {guilabel}`Update settings` to save your changes."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:25
msgid "Select the cog icon ({fa}`cog`) or your avatar to open the {guilabel}`Options` menu."
msgstr ""
#: ../../user_documentation/accounts/activity_visibility.md:33
msgid "That's it! You've updated your activity visibility. This change takes effect as soon as you update your settings."
msgstr ""

73
docs/locales/gettext/user_documentation/accounts/add_avatar.pot 100644
Wyświetl plik

@ -0,0 +1,73 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/add_avatar.md:1
msgid "Add your avatar"
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:3
msgid "You can upload an avatar to your account. Other users can see this when they visit your profile. To add an avatar:"
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:7
#: ../../user_documentation/accounts/add_avatar.md:18
msgid "Log in to your account."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:8
msgid "Select the cog icon ({fa}`cog`) or your existing avatar to expand the user menu."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:9
#: ../../user_documentation/accounts/add_avatar.md:20
msgid "Select {guilabel}`Settings`."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:10
#: ../../user_documentation/accounts/add_avatar.md:21
msgid "Scroll down to the {guilabel}`Avatar` section."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:11
msgid "Select {guilabel}`Browse…` to open the file picker."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:12
#: ../../user_documentation/accounts/add_avatar.md:23
msgid "Select the image you want to use as your avatar and confirm."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:19
msgid "Select the cog icon ({fa}`cog`) or your existing avatar to open the {guilabel}`Options` menu."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:22
msgid "Select {guilabel}`Choose File` to open the file picker."
msgstr ""
#: ../../user_documentation/accounts/add_avatar.md:27
msgid "Congratulations! You've updated your avatar."
msgstr ""

75
docs/locales/gettext/user_documentation/accounts/change_email.pot 100644
Wyświetl plik

@ -0,0 +1,75 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/change_email.md:1
msgid "Change your email address"
msgstr ""
#: ../../user_documentation/accounts/change_email.md:3
msgid "You can update your email address whenever you need to. To do this:"
msgstr ""
#: ../../user_documentation/accounts/change_email.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/change_email.md:7
#: ../../user_documentation/accounts/change_email.md:19
msgid "Log in to your account."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:8
msgid "Select the cog icon ({fa}`cog`) or your avatar to expand the user menu."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:9
#: ../../user_documentation/accounts/change_email.md:21
msgid "Select {guilabel}`Settings`."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:10
#: ../../user_documentation/accounts/change_email.md:22
msgid "Scroll to the {guilabel}`Change my e-mail address` section."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:11
#: ../../user_documentation/accounts/change_email.md:23
msgid "Enter your {guilabel}`New e-mail address`."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:12
#: ../../user_documentation/accounts/change_email.md:24
msgid "Enter your {guilabel}`Password`."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:13
#: ../../user_documentation/accounts/change_email.md:25
msgid "Select {guilabel}`Update`."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/change_email.md:20
msgid "Select the cog icon ({fa}`cog`) or your avatar to open the {guilabel}`Options` menu."
msgstr ""
#: ../../user_documentation/accounts/change_email.md:29
msgid "That's it! If your pod admin has email verification enabled, you'll receive a confirmation email. Follow the instructions in this email to finish changing your email address."
msgstr ""

79
docs/locales/gettext/user_documentation/accounts/change_password.pot 100644
Wyświetl plik

@ -0,0 +1,79 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/change_password.md:1
msgid "Change your password"
msgstr ""
#: ../../user_documentation/accounts/change_password.md:4
msgid "Changing your account password also changes your Subsonic API password. If you are using a Subsonic app, you need to update your password in the app as well."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:7
msgid "You can update your account password whenever you need to. To do this:"
msgstr ""
#: ../../user_documentation/accounts/change_password.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/change_password.md:11
#: ../../user_documentation/accounts/change_password.md:23
msgid "Log in to your account."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:12
msgid "Select the cog icon ({fa}`cog`) or your avatar to expand the user menu."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:13
#: ../../user_documentation/accounts/change_password.md:25
msgid "Select {guilabel}`Settings`."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:14
#: ../../user_documentation/accounts/change_password.md:26
msgid "Scroll to the {guilabel}`Change my password` section."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:15
#: ../../user_documentation/accounts/change_password.md:27
msgid "Enter your {guilabel}`Current password`."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:16
#: ../../user_documentation/accounts/change_password.md:28
msgid "Enter your {guilabel}`New password`."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:17
#: ../../user_documentation/accounts/change_password.md:29
msgid "Select {guilabel}`Change password`."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/change_password.md:24
msgid "Select the cog icon ({fa}`cog`) or your avatar to open the {guilabel}`Options` menu."
msgstr ""
#: ../../user_documentation/accounts/change_password.md:33
msgid "That's it! Your password is reset. You need to use your new password to log in from now on."
msgstr ""

69
docs/locales/gettext/user_documentation/accounts/check_quota.pot 100644
Wyświetl plik

@ -0,0 +1,69 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/check_quota.md:1
msgid "Check your upload quota"
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:3
msgid "Your {term}`pod` admin can assign users an __upload quota__. This is the amount of storage you have access to. Pod admins can assign a default quota to all users. They can also increase or decrease quotas for individual users. Your upload quota applies to content in [libraries](../libraries/index.md) and [channels](../channels/index.md)."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:5
msgid "If you run out of space, you can contact your pod admin to request more."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:7
msgid "To check your upload quota:"
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:11
#: ../../user_documentation/accounts/check_quota.md:21
msgid "Log in to your pod."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:12
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:13
#: ../../user_documentation/accounts/check_quota.md:23
msgid "Select {guilabel}`Get started` under {guilabel}`Upload third-party content in a library`."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:14
#: ../../user_documentation/accounts/check_quota.md:24
msgid "The {guilabel}`My libraries` screen appears showing your upload quota and your libraries."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:15
#: ../../user_documentation/accounts/check_quota.md:25
msgid "The {guilabel}`Current usage` section shows you how much of your quota you are using."
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/check_quota.md:22
msgid "Select the upload icon ({fa}`upload`) at the top of the screen"
msgstr ""

126
docs/locales/gettext/user_documentation/accounts/create_account.pot 100644
Wyświetl plik

@ -0,0 +1,126 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/create_account.md:1
msgid "Create your Funkwhale account"
msgstr ""
#: ../../user_documentation/accounts/create_account.md:4
msgid "Use our [Pod Picker tool](https://network.funkwhale.audio/dashboards/d/overview/network-overview) to find the perfect pod for you!"
msgstr ""
#: ../../user_documentation/accounts/create_account.md:7
msgid "To use Funkwhale, you need to create an account on a {term}`Funkwhale pod <Pod>`. Signing up to a pod requires the following information:"
msgstr ""
#: ../../user_documentation/accounts/create_account.md:9
msgid "A valid email address. Administrators can use this to verify you are not a bot."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:10
msgid "A username."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:11
msgid "A password."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:13
msgid "Check your pod's policies"
msgstr ""
#: ../../user_documentation/accounts/create_account.md:15
msgid "Before you sign up to a pod, you should check its __policies__. You can find these by navigating to the pod's {guilabel}`About this pod` page."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:17
msgid "Navigate to the pod."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:18
msgid "Select the {guilabel}`About this pod` link in the sidebar."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:19
msgid "Select the {guilabel}`Learn more` button in the {guilabel}`About this pod` section."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:21
msgid "Administrators can add a pod's {guilabel}`Rules` and {guilabel}`Terms and privacy policy` to this page. Make sure to read through them before signing up. Also check the {guilabel}`Upload quota` to see how much space users have access to."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:23
msgid "Sign up"
msgstr ""
#: ../../user_documentation/accounts/create_account.md:25
msgid "Once you've found an instance you like the look of, you can create your account."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:27
msgid "Select the {guilabel}`Create an account` button in the sidebar."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:28
msgid "Enter the {guilabel}`Username` you have chosen."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:29
msgid "Enter your {guilabel}`Email` address."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:30
#: ../../user_documentation/accounts/create_account.md:41
msgid "Enter your {guilabel}`Password`."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:31
msgid "Pod administrators can add extra requirements for new accounts. Fields marked with an asterisk ({guilabel}`*`) are required."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:32
msgid "Select {guilabel}`Create my account`."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:33
msgid "Pod administrators may require you to verify your email address before you can use your account. Check your email for more instructions."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:35
msgid "Log in"
msgstr ""
#: ../../user_documentation/accounts/create_account.md:37
msgid "When you've created and activated your account, you can log in."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:39
msgid "Select the {guilabel}`Login` button in the sidebar."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:40
msgid "Enter your {guilabel}`Username or e-mail address`."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:42
msgid "Select {guilabel}`Login`."
msgstr ""
#: ../../user_documentation/accounts/create_account.md:44
msgid "Congratulations! You've set up your Funkwhale account. Check out what you can do now in our user documentation."
msgstr ""

115
docs/locales/gettext/user_documentation/accounts/delete_account.pot 100644
Wyświetl plik

@ -0,0 +1,115 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/delete_account.md:1
msgid "Delete your Funkwhale account"
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:3
msgid "If you have decided you no longer want your Funkwhale account, you can delete it. This action removes your profile and all your data from your {term}`pod`, including:"
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:5
msgid "Your user avatar."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:6
msgid "Your email address."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:7
msgid "The list of your followers."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:8
msgid "Music files you have uploaded."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:9
msgid "Radios you have created."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:10
msgid "Playlists you have created."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:11
msgid "Your favorites."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:13
msgid "When you delete your account, your pod sends a message to other Funkwhale pods notifying them. If these pods hold any of your data, they should also delete it."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:16
msgid "Other pods should delete local copies of your data in compliance with your request. There is no guarantee that they will do so, and some data may remain available. This can happen if a pod is offline or unavailable when your pod sends out the deletion message."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:19
msgid "To delete your account:"
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:23
#: ../../user_documentation/accounts/delete_account.md:35
msgid "Log in to your account."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:24
msgid "Select the cog icon ({fa}`cog`) or your avatar to expand the user menu."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:25
#: ../../user_documentation/accounts/delete_account.md:37
msgid "Select {guilabel}`Settings`."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:26
#: ../../user_documentation/accounts/delete_account.md:38
msgid "Scroll to the {guilabel}`Delete my account` section."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:27
#: ../../user_documentation/accounts/delete_account.md:39
msgid "Enter your {guilabel}`Password`."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:28
#: ../../user_documentation/accounts/delete_account.md:40
msgid "Select {guilabel}`Delete my account…`."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:29
#: ../../user_documentation/accounts/delete_account.md:41
msgid "Select {guilabel}`Delete my account` on the warning notice that appears."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:36
msgid "Select the cog icon ({fa}`cog`) or your avatar to open the {guilabel}`Options` menu."
msgstr ""
#: ../../user_documentation/accounts/delete_account.md:45
msgid "That's it! You've deleted your account. You can [create another account](create_account.md) at any time."
msgstr ""

65
docs/locales/gettext/user_documentation/accounts/delete_avatar.pot 100644
Wyświetl plik

@ -0,0 +1,65 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/delete_avatar.md:1
msgid "Remove your avatar"
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:3
msgid "If you don't want to have an avatar any more, you can remove it. To do this:"
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:7
#: ../../user_documentation/accounts/delete_avatar.md:17
msgid "Log in to your account."
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:8
msgid "Select your avatar to expand the user menu."
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:9
#: ../../user_documentation/accounts/delete_avatar.md:19
msgid "Select {guilabel}`Settings`."
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:10
#: ../../user_documentation/accounts/delete_avatar.md:20
msgid "Scroll down to the {guilabel}`Avatar` section."
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:11
#: ../../user_documentation/accounts/delete_avatar.md:21
msgid "Select {guilabel}`Remove`."
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:18
msgid "Select your avatar to open the {guilabel}`Options` menu."
msgstr ""
#: ../../user_documentation/accounts/delete_avatar.md:25
msgid "That's it! You've removed your avatar from your account. Other users will only see the initials of your username when they visit your profile."
msgstr ""

39
docs/locales/gettext/user_documentation/accounts/index.pot 100644
Wyświetl plik

@ -0,0 +1,39 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/accounts/index.md:7
#: ../../user_documentation/accounts/index.md:7
msgid "Manage your account"
msgstr ""
#: ../../user_documentation/accounts/index.md:19
#: ../../user_documentation/accounts/index.md:19
msgid "Change account settings"
msgstr ""
#: ../../user_documentation/accounts/index.md:1
msgid "Your account"
msgstr ""
#: ../../user_documentation/accounts/index.md:3
msgid "Your Funkwhale account is the key to your Funkwhale experience. Creating an account on a {term}`pod` gives you the ability to upload content, follow channels, and listen to audio."
msgstr ""
#: ../../user_documentation/accounts/index.md:5
msgid "Follow the guides in this section to manage your Funkwhale account."
msgstr ""

175
docs/locales/gettext/user_documentation/channels/create_channel.pot 100644
Wyświetl plik

@ -0,0 +1,175 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/create_channel.md:1
msgid "Create a channel"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:4
msgid "Your channel's __Fediverse handle__ needs to be unique. This is how other {term}`Fediverse` software identifies your channel. You can't change the __Fediverse handle__ once you've created your channel."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:7
msgid "Create a channel to start publishing your content on your {term}`Funkwhale pod <Pod>`. Users can access channel content from Funkwhale or other Fediverse software."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:9
msgid "You can create two types of channel:"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:15
msgid "Artist discography"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:17
msgid "To create an __Artist discography__ channel:"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:0
#: ../../user_documentation/channels/create_channel.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:21
#: ../../user_documentation/channels/create_channel.md:37
#: ../../user_documentation/channels/create_channel.md:59
#: ../../user_documentation/channels/create_channel.md:80
msgid "Log in to your pod."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:22
#: ../../user_documentation/channels/create_channel.md:60
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:23
#: ../../user_documentation/channels/create_channel.md:39
#: ../../user_documentation/channels/create_channel.md:61
#: ../../user_documentation/channels/create_channel.md:82
msgid "Select {guilabel}`Get started` under {guilabel}`Publish your work in a channel`. Your user profile opens."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:24
#: ../../user_documentation/channels/create_channel.md:40
#: ../../user_documentation/channels/create_channel.md:62
#: ../../user_documentation/channels/create_channel.md:83
msgid "Select {guilabel}`+ Add new` next to the {guilabel}`Channels` header. A {guilabel}`Create channel` pop-up window appears."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:25
#: ../../user_documentation/channels/create_channel.md:41
msgid "Select {guilabel}`Artist discography` and select {guilabel}`Next step`. The {guilabel}`Artist channel` form appears."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:26
#: ../../user_documentation/channels/create_channel.md:42
#: ../../user_documentation/channels/create_channel.md:64
#: ../../user_documentation/channels/create_channel.md:85
msgid "Enter the {guilabel}`Name` of your channel. Users see this when they visit your channel page."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:27
#: ../../user_documentation/channels/create_channel.md:43
#: ../../user_documentation/channels/create_channel.md:65
#: ../../user_documentation/channels/create_channel.md:86
msgid "Enter the {guilabel}`Fediverse handle` of your channel. This is how other Fediverse software identifies your channel."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:28
#: ../../user_documentation/channels/create_channel.md:44
#: ../../user_documentation/channels/create_channel.md:66
#: ../../user_documentation/channels/create_channel.md:87
msgid "__Optional__ – upload a {guilabel}`Channel picture`. Users see this when they visit your channel page. Select {guilabel}`Browse…` to open a file picker."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:29
#: ../../user_documentation/channels/create_channel.md:45
#: ../../user_documentation/channels/create_channel.md:67
#: ../../user_documentation/channels/create_channel.md:88
msgid "__Optional__ – add {guilabel}`Tags` that describe your channel. Start typing in the {guilabel}`Search…` input box to find existing tags. You can also create new tags by typing them in and selecting them or hitting {kbd}`⏎ Return`."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:30
#: ../../user_documentation/channels/create_channel.md:46
#: ../../user_documentation/channels/create_channel.md:69
#: ../../user_documentation/channels/create_channel.md:90
msgid "__Optional__ – enter a {guilabel}`Description` of your channel. You can {guilabel}`Write` using [Markdown](https://www.markdownguide.org/) syntax and {guilabel}`Preview` how it will look. Users see this when they visit your channel page."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:31
#: ../../user_documentation/channels/create_channel.md:47
#: ../../user_documentation/channels/create_channel.md:74
#: ../../user_documentation/channels/create_channel.md:95
msgid "Select {guilabel}`Create channel` to create your channel."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:0
#: ../../user_documentation/channels/create_channel.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:38
#: ../../user_documentation/channels/create_channel.md:81
msgid "Select the upload icon ({fa}`upload`) at the top of the screen."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:51
msgid "That's it! You've created your artist channel. You can now [add some music to it](upload_artist.md)."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:53
msgid "Podcast"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:55
msgid "To create a __Podcast__ channel:"
msgstr ""
#: ../../user_documentation/channels/create_channel.md:63
#: ../../user_documentation/channels/create_channel.md:84
msgid "Select {guilabel}`Podcasts` and select {guilabel}`Next step`. The {guilabel}`Podcast channel` form appears."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:68
#: ../../user_documentation/channels/create_channel.md:89
msgid "Choose the {guilabel}`Language` of your podcast."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:70
#: ../../user_documentation/channels/create_channel.md:91
msgid "Select the {guilabel}`Category` of your podcast. {term}`Podcatchers<Podcatcher>` use this information to sort your podcast content."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:71
#: ../../user_documentation/channels/create_channel.md:92
msgid "__Optional__ – select the {guilabel}`Subcategory` of your podcast."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:72
#: ../../user_documentation/channels/create_channel.md:93
msgid "__Optional__ – enter the {guilabel}`Owner e-mail address`. This populates the ``itunes:email`` field of your podcast's {abbr}`RSS (Really Simple Syndication)` feed."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:73
#: ../../user_documentation/channels/create_channel.md:94
msgid "__Optional__ – enter the {guilabel}`Owner name`. This populates the ``itunes:name`` field of your podcast's {abbr}`RSS (Really Simple Syndication)` feed."
msgstr ""
#: ../../user_documentation/channels/create_channel.md:99
msgid "You're done! You've created your podcast channel. Now you can [add some episodes to it](upload_podcast.md)."
msgstr ""

143
docs/locales/gettext/user_documentation/channels/delete_artist.pot 100644
Wyświetl plik

@ -0,0 +1,143 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/delete_artist.md:1
msgid "Delete content from an Artist channel"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:3
msgid "You can delete content from your artist channel. This means that your followers won't be able to listen to the deleted content any more."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:9
msgid "Delete a track"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:12
msgid "Deleting a track also deletes the file from your {term}`Funkwhale pod <Pod>`. This action is irreversible."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:15
msgid "To delete a single track from a channel:"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:0
#: ../../user_documentation/channels/delete_artist.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:19
#: ../../user_documentation/channels/delete_artist.md:33
#: ../../user_documentation/channels/delete_artist.md:57
#: ../../user_documentation/channels/delete_artist.md:70
msgid "Log in to your pod."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:20
#: ../../user_documentation/channels/delete_artist.md:58
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:21
#: ../../user_documentation/channels/delete_artist.md:35
#: ../../user_documentation/channels/delete_artist.md:59
#: ../../user_documentation/channels/delete_artist.md:72
msgid "Select {guilabel}`Get started` under {guilabel}`Publish your work in a channel`. Your user profile opens."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:22
#: ../../user_documentation/channels/delete_artist.md:36
#: ../../user_documentation/channels/delete_artist.md:60
#: ../../user_documentation/channels/delete_artist.md:73
msgid "Select the channel containing the content under the {guilabel}`Channels` header. The channel's page opens."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:23
#: ../../user_documentation/channels/delete_artist.md:37
msgid "Select the kebab menu ({fa}`ellipsis-v`) next to the track in question. This opens the track options menu."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:24
#: ../../user_documentation/channels/delete_artist.md:38
msgid "Select {guilabel}`ℹ︎ Track details`. The track details page opens."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:25
#: ../../user_documentation/channels/delete_artist.md:39
msgid "Select the kebab menu ({fa}`ellipsis-v`) at the top of the page."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:26
#: ../../user_documentation/channels/delete_artist.md:40
msgid "Select {guilabel}`Delete…`. A {guilabel}`Delete this track?` warning appears."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:27
#: ../../user_documentation/channels/delete_artist.md:41
msgid "Select {guilabel}`Delete` to delete the track."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:0
#: ../../user_documentation/channels/delete_artist.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:34
#: ../../user_documentation/channels/delete_artist.md:71
msgid "Select the upload icon ({fa}`upload`) at the top of the screen."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:45
msgid "That's it! You've deleted your track. You can add it again by [uploading it to your channel](upload_artist.md)."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:47
msgid "Delete an album"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:50
msgid "Deleting an album also deletes all tracks in the album and removes the files from the server. This action is irreversible."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:53
msgid "Delete an album to remove all tracks it contains. To do this:"
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:61
#: ../../user_documentation/channels/delete_artist.md:74
msgid "Select your album in the {guilabel}`Albums` section. The album detail page opens."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:62
#: ../../user_documentation/channels/delete_artist.md:75
msgid "Select the kebab menu ({fa}`ellipsis-v`) to open the options menu."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:63
#: ../../user_documentation/channels/delete_artist.md:76
msgid "Select {guilabel}`Delete…`. A {guilabel}`Delete this album?` warning appears."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:64
#: ../../user_documentation/channels/delete_artist.md:77
msgid "Select {guilabel}`Delete` to delete the album."
msgstr ""
#: ../../user_documentation/channels/delete_artist.md:81
msgid "You're done! You've deleted the album and all the tracks it contained. You can add them again by [uploading it to your channel](upload_artist.md)."
msgstr ""

79
docs/locales/gettext/user_documentation/channels/delete_channel.pot 100644
Wyświetl plik

@ -0,0 +1,79 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/delete_channel.md:1
msgid "Delete a channel"
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:4
msgid "Deleting a channel is irreversible. If you delete a channel you also delete the content associated with it. Users won't be able to access the channel any more. You can't re-use the channel's __Fediverse handle__ for another channel."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:7
msgid "If you want to delete your channel, follow these steps:"
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:11
#: ../../user_documentation/channels/delete_channel.md:23
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:12
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:13
#: ../../user_documentation/channels/delete_channel.md:25
msgid "Select {guilabel}`Get started` under {guilabel}`Publish your work in a channel`. Your user profile opens."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:14
#: ../../user_documentation/channels/delete_channel.md:26
msgid "Select the channel you want to delete under the {guilabel}`Channels` header. The channel's page opens."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:15
#: ../../user_documentation/channels/delete_channel.md:27
msgid "Select the kebab menu ({fa}`ellipsis-v`) to show the channel options."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:16
#: ../../user_documentation/channels/delete_channel.md:28
msgid "Select {guilabel}`Delete…`. A {guilabel}`Delete this Channel?` warning message appears"
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:17
#: ../../user_documentation/channels/delete_channel.md:29
msgid "Select {guilabel}`Delete`."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:24
msgid "Select the upload icon ({fa}`upload`) at the top of the screen."
msgstr ""
#: ../../user_documentation/channels/delete_channel.md:33
msgid "That's it! You deleted your channel."
msgstr ""

143
docs/locales/gettext/user_documentation/channels/delete_podcast.pot 100644
Wyświetl plik

@ -0,0 +1,143 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/delete_podcast.md:1
msgid "Delete content from a Podcast channel"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:3
msgid "You can delete content from your podcast channel. This means that your followers won't be able to listen to the deleted content any more."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:9
msgid "Delete an episode"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:12
msgid "Deleting an episode also deletes the file from the {term}`pod`. This action is irreversible."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:15
msgid "To delete a single episode from a channel:"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:0
#: ../../user_documentation/channels/delete_podcast.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:19
#: ../../user_documentation/channels/delete_podcast.md:33
#: ../../user_documentation/channels/delete_podcast.md:57
#: ../../user_documentation/channels/delete_podcast.md:70
msgid "Log in to your pod."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:20
#: ../../user_documentation/channels/delete_podcast.md:58
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:21
#: ../../user_documentation/channels/delete_podcast.md:35
#: ../../user_documentation/channels/delete_podcast.md:59
#: ../../user_documentation/channels/delete_podcast.md:72
msgid "Select {guilabel}`Get started` under {guilabel}`Publish your work in a channel`. Your user profile opens."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:22
#: ../../user_documentation/channels/delete_podcast.md:36
#: ../../user_documentation/channels/delete_podcast.md:60
#: ../../user_documentation/channels/delete_podcast.md:73
msgid "Select the channel containing the content under the {guilabel}`Channels` header. The channel's page opens."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:23
#: ../../user_documentation/channels/delete_podcast.md:37
msgid "Select the kebab menu ({fa}`ellipsis-v`) next to the episode in question. This opens the track options menu."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:24
#: ../../user_documentation/channels/delete_podcast.md:38
msgid "Select {guilabel}`ℹ︎ Episode details`. The episode details page opens."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:25
#: ../../user_documentation/channels/delete_podcast.md:39
msgid "Select the kebab menu ({fa}`ellipsis-v`) at the top of the page."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:26
#: ../../user_documentation/channels/delete_podcast.md:40
msgid "Select {guilabel}`Delete…`. A {guilabel}`Delete this track?` warning appears."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:27
#: ../../user_documentation/channels/delete_podcast.md:41
msgid "Select {guilabel}`Delete` to delete the episode."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:0
#: ../../user_documentation/channels/delete_podcast.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:34
#: ../../user_documentation/channels/delete_podcast.md:71
msgid "Select the upload icon ({fa}`upload`) at the top of the screen."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:45
msgid "That's it! You've deleted your episode. You can add it again by [uploading it to your channel](upload_podcast.md)."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:47
msgid "Delete a series"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:50
msgid "Deleting a series also deletes all episodes in the series and deletes the files from the {term}`pod`. This action is irreversible."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:53
msgid "Delete a series to remove all episodes it contains. To do this:"
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:61
#: ../../user_documentation/channels/delete_podcast.md:74
msgid "Select your series in the {guilabel}`Series` section. The series detail page opens."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:62
#: ../../user_documentation/channels/delete_podcast.md:75
msgid "Select the kebab menu ({fa}`ellipsis-v`) to open the options menu."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:63
#: ../../user_documentation/channels/delete_podcast.md:76
msgid "Select {guilabel}`Delete…`. A {guilabel}`Delete this album?` warning appears."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:64
#: ../../user_documentation/channels/delete_podcast.md:77
msgid "Select {guilabel}`Delete` to delete the series."
msgstr ""
#: ../../user_documentation/channels/delete_podcast.md:81
msgid "You're done! You've deleted the series and all the episodes it contained. You can add them again by [uploading it to your channel](upload_podcast.md)."
msgstr ""

179
docs/locales/gettext/user_documentation/channels/edit_channel.pot 100644
Wyświetl plik

@ -0,0 +1,179 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/edit_channel.md:1
msgid "Edit a channel"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:4
msgid "You can't change a channel's __Fediverse handle__."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:7
msgid "Channels are like user profiles on other {term}`Fediverse` software. This means you can edit their details at any time to reflect changes you've made."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:9
msgid "You can change different details depending on what type of channel you are editing:"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:15
msgid "Edit an Artist channel"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:17
msgid "To edit an __Artist channel__:"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:0
#: ../../user_documentation/channels/edit_channel.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:21
#: ../../user_documentation/channels/edit_channel.md:38
#: ../../user_documentation/channels/edit_channel.md:61
#: ../../user_documentation/channels/edit_channel.md:83
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:22
#: ../../user_documentation/channels/edit_channel.md:62
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:23
#: ../../user_documentation/channels/edit_channel.md:40
#: ../../user_documentation/channels/edit_channel.md:63
#: ../../user_documentation/channels/edit_channel.md:85
msgid "Select {guilabel}`Get started` under {guilabel}`Publish your work in a channel`. Your user profile opens."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:24
#: ../../user_documentation/channels/edit_channel.md:41
#: ../../user_documentation/channels/edit_channel.md:64
#: ../../user_documentation/channels/edit_channel.md:86
msgid "Select the channel you want to delete under the {guilabel}`Channels` header. The channel's page opens."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:25
#: ../../user_documentation/channels/edit_channel.md:42
#: ../../user_documentation/channels/edit_channel.md:65
#: ../../user_documentation/channels/edit_channel.md:87
msgid "Select the kebab menu ({fa}`ellipsis-v`) to show the channel options."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:26
#: ../../user_documentation/channels/edit_channel.md:43
#: ../../user_documentation/channels/edit_channel.md:66
#: ../../user_documentation/channels/edit_channel.md:88
msgid "Select {guilabel}`Edit…`. The {guilabel}`Artist channel` form appears."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:27
#: ../../user_documentation/channels/edit_channel.md:44
#: ../../user_documentation/channels/edit_channel.md:67
#: ../../user_documentation/channels/edit_channel.md:89
msgid "Change the details in any of these fields:"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:28
#: ../../user_documentation/channels/edit_channel.md:45
#: ../../user_documentation/channels/edit_channel.md:68
#: ../../user_documentation/channels/edit_channel.md:90
msgid "{guilabel}`Name`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:29
#: ../../user_documentation/channels/edit_channel.md:46
#: ../../user_documentation/channels/edit_channel.md:69
#: ../../user_documentation/channels/edit_channel.md:91
msgid "{guilabel}`Channel Picture`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:30
#: ../../user_documentation/channels/edit_channel.md:47
#: ../../user_documentation/channels/edit_channel.md:70
#: ../../user_documentation/channels/edit_channel.md:92
msgid "{guilabel}`Tags`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:31
#: ../../user_documentation/channels/edit_channel.md:48
#: ../../user_documentation/channels/edit_channel.md:72
#: ../../user_documentation/channels/edit_channel.md:94
msgid "{guilabel}`Description`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:32
#: ../../user_documentation/channels/edit_channel.md:49
#: ../../user_documentation/channels/edit_channel.md:77
#: ../../user_documentation/channels/edit_channel.md:99
msgid "Select {guilabel}`Update channel` to save your changes."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:0
#: ../../user_documentation/channels/edit_channel.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:39
#: ../../user_documentation/channels/edit_channel.md:84
msgid "Select the upload icon ({fa}`upload`) at the top of the screen."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:53
msgid "That's it! You've updated your channel details. Users see the new details when they visit your channel page."
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:55
msgid "Edit a Podcast channel"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:57
msgid "To edit a __Podcast channel__:"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:71
#: ../../user_documentation/channels/edit_channel.md:93
msgid "{guilabel}`Language`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:73
#: ../../user_documentation/channels/edit_channel.md:95
msgid "{guilabel}`Category`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:74
#: ../../user_documentation/channels/edit_channel.md:96
msgid "{guilabel}`Subcategory`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:75
#: ../../user_documentation/channels/edit_channel.md:97
msgid "{guilabel}`Owner e-mail address`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:76
#: ../../user_documentation/channels/edit_channel.md:98
msgid "{guilabel}`Owner name`"
msgstr ""
#: ../../user_documentation/channels/edit_channel.md:103
msgid "You're done! Users see the new details when they visit your channel page. The changes also reflect on your podcast's {abbr}`RSS (Really Simple Syndication)` feed."
msgstr ""

131
docs/locales/gettext/user_documentation/channels/follow_channel.pot 100644
Wyświetl plik

@ -0,0 +1,131 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/follow_channel.md:1
msgid "Follow a channel"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:3
msgid "Get access to a channel's content by following it. Following a channel makes its content visible to all users on your {term}`pod`."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:5
msgid "You can follow channels in a few different ways:"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:11
msgid "Follow a channel on your pod"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:13
msgid "If a user on your pod follows a channel or has published a channel, you can follow it from your pod. To do this:"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:15
#: ../../user_documentation/channels/follow_channel.md:53
msgid "Select the channel you want to follow. The channel details page opens."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:16
msgid "Select the {guilabel}`Subscribe` button. The label changes to {guilabel}`Subscribed`."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:18
msgid "That's it! You've subscribed to the channel. You can see the channel in the {guilabel}`Channels` page."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:20
msgid "Follow a remote channel"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:22
msgid "To follow a channel located on another pod, you need its __Federation handle__. A __Federation handle__ uses the following format: ``@{username}@{domain}``. Once you have the channel's __Federation handle__, you can follow it from the {guilabel}`Channels` page. To do this:"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:26
msgid "Select {guilabel}`Channels` in the sidebar. The {guilabel}`Channels` page opens."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:27
#: ../../user_documentation/channels/follow_channel.md:39
msgid "Select {guilabel}`+ Add new` at the top of the page. The {guilabel}`Subscriptions` screen appears."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:28
#: ../../user_documentation/channels/follow_channel.md:40
msgid "Select {guilabel}`Fediverse`."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:29
#: ../../user_documentation/channels/follow_channel.md:41
msgid "Enter the channel's __Federation handle__ in the {guilabel}`Fediverse object` input."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:30
#: ../../user_documentation/channels/follow_channel.md:42
msgid "Select {guilabel}`Subscribe`. The channel details page appears."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:31
#: ../../user_documentation/channels/follow_channel.md:43
msgid "Select the {guilabel}`Subscribe}` button. The label changes to {guilabel}`Subscribed`."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:37
msgid "Select the hamburger menu ({fa}`bars`) to open the menu bar."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:38
msgid "Select {guilabel}`Channels`. The {guilabel}`Channels` page opens."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:47
msgid "That's it! You can now see the channel's content on your pod. Other users of your pod can also see this channel."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:49
msgid "Follow a Funkwhale podcast with a podcatcher"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:51
msgid "You can follow podcasts published in channels using a standard podcatcher. To do this:"
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:54
msgid "Select the feed button ({fa}`feed`). The {guilabel}`Subscribe to this channel` window appears."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:55
msgid "Select {guilabel}`Copy` under the {guilabel}`Subscribe via RSS` to copy the channel's {abbr}`RSS (Really Simple Syndication)` feed URL."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:56
msgid "Paste the URL in your podcatcher."
msgstr ""
#: ../../user_documentation/channels/follow_channel.md:58
msgid "That's it! Your podcatcher fetches the podcast details from Funkwhale."
msgstr ""

56
docs/locales/gettext/user_documentation/channels/index.pot 100644
Wyświetl plik

@ -0,0 +1,56 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/index.md:12
#: ../../user_documentation/channels/index.md:12
msgid "Manage your channels"
msgstr ""
#: ../../user_documentation/channels/index.md:24
#: ../../user_documentation/channels/index.md:24
msgid "Manage channel content"
msgstr ""
#: ../../user_documentation/channels/index.md:37
#: ../../user_documentation/channels/index.md:37
msgid "Follow channels"
msgstr ""
#: ../../user_documentation/channels/index.md:1
msgid "Channels"
msgstr ""
#: ../../user_documentation/channels/index.md:3
msgid "Use channels to publish your own audio content on Funkwhale. Channels enable you to create and share your creations with the whole {term}`Fediverse`."
msgstr ""
#: ../../user_documentation/channels/index.md:5
msgid "Funkwhale supports two types of channel:"
msgstr ""
#: ../../user_documentation/channels/index.md:7
msgid "__Podcasts__ – broadcast your podcast over the Fediverse. Listeners can also use their favorite {term}`podcatcher` to listen to podcasts using {abbr}`RSS (Really Simple Syndication)`."
msgstr ""
#: ../../user_documentation/channels/index.md:8
msgid "__Artist Discography__ – upload your own music and create a following."
msgstr ""
#: ../../user_documentation/channels/index.md:10
msgid "Follow the guides in this section to get started."
msgstr ""

73
docs/locales/gettext/user_documentation/channels/subscribe_rss.pot 100644
Wyświetl plik

@ -0,0 +1,73 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/subscribe_rss.md:1
msgid "Subscribe to an RSS feed"
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:4
msgid "Other users on your pod can't see podcasts you import using RSS. They need to subscribe to the feed themselves."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:7
msgid "You can use Funkwhale as a {term}`podcatcher` to listen to your favorite podcasts. Funkwhale can read {abbr}`RSS (Really Simple Syndication)` feeds to import podcasts. To add an RSS feed to Funkwhale:"
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:11
msgid "Select {guilabel}`Channels` in the sidebar. The {guilabel}`Channels` page opens."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:12
#: ../../user_documentation/channels/subscribe_rss.md:23
msgid "Select {guilabel}`+ Add new` at the top of the page. The {guilabel}`Subscriptions` screen appears."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:13
#: ../../user_documentation/channels/subscribe_rss.md:24
msgid "Select {guilabel}`RSS`."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:14
#: ../../user_documentation/channels/subscribe_rss.md:25
msgid "Enter the URL of the RSS feed in the {guilabel}`RSS feed location` input."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:15
#: ../../user_documentation/channels/subscribe_rss.md:26
msgid "Select {guilabel}`Subscribe`."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:21
msgid "Select the hamburger menu ({fa}`bars`) to open the menu bar."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:22
msgid "Select {guilabel}`Channels`. The {guilabel}`Channels` page opens."
msgstr ""
#: ../../user_documentation/channels/subscribe_rss.md:30
msgid "That's it! Your favorite podcast is now available in the {guilabel}`Channels` page. Funkwhale updates the feed to make sure you always have the latest episodes."
msgstr ""

294
docs/locales/gettext/user_documentation/channels/upload_artist.pot 100644
Wyświetl plik

@ -0,0 +1,294 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: funkwhale 1.2.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-04-04 09:00+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../user_documentation/channels/upload_artist.md:1
msgid "Upload content to an Artist channel"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:3
msgid "Once you have [created a channel](create_channel.md), you can start to add content to it. Users who follow your channel can see and play your content from their {term}`pods <Pod>`."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:5
msgid "You can also create albums to organize your channel content."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:11
msgid "Create an album (optional)"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:13
msgid "Albums are a good way of organizing your content. You can create as many albums as you want. To create a new album:"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:0
#: ../../user_documentation/channels/upload_artist.md:0
#: ../../user_documentation/channels/upload_artist.md:0
msgid "Desktop"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:17
#: ../../user_documentation/channels/upload_artist.md:29
#: ../../user_documentation/channels/upload_artist.md:61
#: ../../user_documentation/channels/upload_artist.md:78
#: ../../user_documentation/channels/upload_artist.md:115
#: ../../user_documentation/channels/upload_artist.md:132
msgid "Log in to your pod."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:18
#: ../../user_documentation/channels/upload_artist.md:62
#: ../../user_documentation/channels/upload_artist.md:116
msgid "Select the upload icon ({fa}`upload`) in the top of the sidebar."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:19
#: ../../user_documentation/channels/upload_artist.md:31
#: ../../user_documentation/channels/upload_artist.md:63
#: ../../user_documentation/channels/upload_artist.md:80
#: ../../user_documentation/channels/upload_artist.md:117
#: ../../user_documentation/channels/upload_artist.md:134
msgid "Select {guilabel}`Get started` under {guilabel}`Publish your work in a channel`. Your user profile opens."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:20
#: ../../user_documentation/channels/upload_artist.md:32
msgid "Select the channel you want to add an album to under the {guilabel}`Channels` header. The channel's page opens."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:21
#: ../../user_documentation/channels/upload_artist.md:33
msgid "Select {guilabel}`+ Add new` next to the {guilabel}`Albums` section. A {guilabel}`New album` screen appears."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:22
#: ../../user_documentation/channels/upload_artist.md:34
msgid "Enter the {guilabel}`Title` of your album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:23
#: ../../user_documentation/channels/upload_artist.md:35
msgid "Select {guilabel}`Create` to create your new album. The album appears on the screen."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:0
#: ../../user_documentation/channels/upload_artist.md:0
#: ../../user_documentation/channels/upload_artist.md:0
msgid "Mobile"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:30
#: ../../user_documentation/channels/upload_artist.md:79
#: ../../user_documentation/channels/upload_artist.md:133
msgid "Select the upload icon ({fa}`upload`) at the top of the screen."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:39
msgid "Once you've created your album, you can add some details to it. To do this:"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:41
msgid "Select the album. The album details screen opens."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:42
msgid "Select the kebab menu ({fa}`ellipsis-v`) to show the album options."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:43
msgid "Select {guilabel}`Edit`. The {guilabel}`Edit this album` screen opens."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:44
#: ../../user_documentation/channels/upload_artist.md:97
msgid "Change the details in any of these fields:"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:45
msgid "{guilabel}`Title` – the title of the album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:46
msgid "{guilabel}`Description` – a description of the album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:47
msgid "{guilabel}`Release date` – the release date of the album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:48
msgid "{guilabel}`Cover` – the cover art of the album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:49
msgid "{guilabel}`Tags` – the genre of the album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:50
msgid "__Optional__ – enter a {guilabel}`Summary` of your changes."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:51
msgid "Select {guilabel}`Submit and apply edit` to save your changes."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:53
msgid "That's it! You can now add content to your album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:55
msgid "Add your content"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:57
msgid "To add content to your channel:"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:64
#: ../../user_documentation/channels/upload_artist.md:81
#: ../../user_documentation/channels/upload_artist.md:118
#: ../../user_documentation/channels/upload_artist.md:135
msgid "Select the channel you want to add content to under the {guilabel}`Channels` header. The channel's page opens."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:65
#: ../../user_documentation/channels/upload_artist.md:82
#: ../../user_documentation/channels/upload_artist.md:119
#: ../../user_documentation/channels/upload_artist.md:136
msgid "Select {guilabel}`⇧ Upload`. The {guilabel}`Publish audio` screen appears."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:66
#: ../../user_documentation/channels/upload_artist.md:83
#: ../../user_documentation/channels/upload_artist.md:120
#: ../../user_documentation/channels/upload_artist.md:137
msgid "Select the {guilabel}`Channel` you want to publish your audio in. This populates with the channel you selected by default."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:67
#: ../../user_documentation/channels/upload_artist.md:84
#: ../../user_documentation/channels/upload_artist.md:121
#: ../../user_documentation/channels/upload_artist.md:138
msgid "__Optional__ – choose which [{guilabel}`Album`](#create-an-album-optional) you want to publish the music in."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:68
#: ../../user_documentation/channels/upload_artist.md:85
#: ../../user_documentation/channels/upload_artist.md:122
#: ../../user_documentation/channels/upload_artist.md:139
msgid "__Optional__ – choose a {guilabel}`License` to apply to your music. Funkwhale supports [Creative Commons](https://creativecommons.org/) licenses."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:69
#: ../../user_documentation/channels/upload_artist.md:86
#: ../../user_documentation/channels/upload_artist.md:123
#: ../../user_documentation/channels/upload_artist.md:140
msgid "Select {guilabel}`Next step`. The {guilabel}`Files to upload` screen appears."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:70
msgid "Click on the section marked {guilabel}`Browse…` to open a file picker, or drag and drop your files on to it."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:71
msgid "If you opened the file picker, select the files you want to upload and confirm."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:72
#: ../../user_documentation/channels/upload_artist.md:88
msgid "The files appear at the top when you upload them. Select {guilabel}`Remove` to remove them."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:87
msgid "Click on the section marked {guilabel}`Browse…` to open a file picker. Select the files you want to upload and confirm."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:92
msgid "Edit your uploads"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:94
msgid "Once you have uploaded your files, you can change their details. To do this:"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:96
msgid "Select the edit icon ({fa}`edit`) to edit the track details. The {guilabel}`Upload details` screen appears."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:98
msgid "{guilabel}`Title` – the title of the track"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:99
msgid "{guilabel}`Track Picture` – the picture that shows up next to the track."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:100
msgid "{guilabel}`Tags` – the genre of the track."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:101
msgid "{guilabel}`Position` – the position of the track in the album."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:102
msgid "{guilabel}`Description` – a description of the track."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:103
msgid "Select {guilabel}`Update` to save the track details."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:104
msgid "Do this for all tracks you want to publish."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:105
msgid "Select {guilabel}`Publish` to publish the content. To save the content to [upload later](#continue-your-upload-later), select {menuselection}`Down arrow --> Finish later`."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:107
msgid "That's it! You've added content to your channel. Your followers can now listen to your content from their pods."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:109
msgid "Continue your upload later"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:111
msgid "If you selected {guilabel}`Finish later`, Funkwhale saves your files and edits. You can continue your upload later by doing the following:"
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:124
#: ../../user_documentation/channels/upload_artist.md:141
msgid "If there are pending uploads, a {guilabel}`You have some draft uploads pending publication` note shows. Select {guilabel}`Resume` to resume your upload."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:125
#: ../../user_documentation/channels/upload_artist.md:142
msgid "[Add new files](#add-your-content) or [edit the pending files](#edit-your-uploads)."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:126
#: ../../user_documentation/channels/upload_artist.md:143
msgid "Once you're finished, select {guilabel}`Publish` to publish your music."
msgstr ""
#: ../../user_documentation/channels/upload_artist.md:147
msgid "Congratulations! You've finished uploading the saved content. Your followers can now listen to your content from their pods."
msgstr ""

Some files were not shown because too many files have changed in this diff Show More