chore(docs): update pot files

Part-of: <https://dev.funkwhale.audio/funkwhale/funkwhale/-/merge_requests/2353>
This commit is contained in:
jo 2023-03-01 14:06:34 +01:00 committed by Ciarán Ainsworth
parent 41a9f16a23
commit ab435897d7
185 changed files with 10370 additions and 9143 deletions

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -41,7 +41,7 @@ msgid "Any references to the old URL in your database."
msgstr ""
#: ../../administrator_documentation/configuration_docs/change_url.md:13
msgid "To clean the database, the {file}`manage.py` script contains a `fix_federation_ids` command."
msgid "To clean the database, the `funkwhale-manage` command line interface contains a `fix_federation_ids` command."
msgstr ""
#: ../../administrator_documentation/configuration_docs/change_url.md:16

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -65,19 +65,11 @@ msgid "Database and redis configuration"
msgstr ""
#: ../../docstring of config.settings.common.DATABASE_URL:1
msgid "The URL used 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>``"
msgid "The URL used to connect to the PostgreSQL database. Defaults to an auto generated url build using the `DATABASE_HOST`, `DATABASE_PORT`, `DATABASE_USER`, `DATABASE_PASSWORD` and `DATABASE_NAME` variables."
msgstr ""
#: ../../docstring of config.settings.common.DATABASE_URL:5
msgid "``postgresql://funkwhale:passw0rd@localhost:5432/funkwhale_database``"
msgid "Examples: - ``postgresql://funkwhale@:5432/funkwhale`` - ``postgresql://<user>:<password>@<host>:<port>/<database>`` - ``postgresql://funkwhale:passw0rd@localhost:5432/funkwhale_database``"
msgstr ""
#: ../../docstring of config.settings.common.DB_CONN_MAX_AGE:1
@ -113,8 +105,8 @@ msgstr ""
msgid "The celery task broker URL. Defaults to :attr:`CACHE_URL`. You don't need to tweak this unless you want to use a different server or use Redis sockets to connect."
msgstr ""
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:5
#: ../../docstring of config.settings.common.AWS_S3_REGION_NAME:4
#: ../../docstring of config.settings.common.CELERY_BROKER_URL:5
#: ../../docstring of config.settings.common.THROTTLING_RATES:6
msgid "Example:"
msgstr ""
@ -147,11 +139,11 @@ msgstr ""
msgid "List of usernames that can't be used for registration. Given as a list of strings."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:85
#: ../../administrator_documentation/configuration_docs/env_file.md:80
msgid "Whether to enable LDAP authentication."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:87
#: ../../administrator_documentation/configuration_docs/env_file.md:82
msgid "See {doc}`/administrator_documentation/configuration_docs/ldap` for more information."
msgstr ""
@ -204,6 +196,14 @@ msgid "Don't insert a slash at the end of this path."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:111
msgid "Controls the maximum size of file that users can upload."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:114
msgid "You can control how much total storage a user can access with the :term:`Upload Quota` setting."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:118
msgid "S3 storage configuration"
msgstr ""
@ -239,8 +239,8 @@ msgstr ""
msgid "If you use a S3-compatible storage such as minio, set the following variable to the full URL to the storage server."
msgstr ""
#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:4
#: ../../docstring of config.settings.common.ADMIN_URL:3
#: ../../docstring of config.settings.common.AWS_S3_ENDPOINT_URL:4
#: ../../docstring of config.settings.common.MUSICBRAINZ_HOSTNAME:5
msgid "Examples:"
msgstr ""
@ -265,7 +265,7 @@ msgstr ""
msgid "A directory in your S3 bucket where you store files. Use this if you plan to share the bucket between services."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:130
#: ../../administrator_documentation/configuration_docs/env_file.md:137
msgid "In-place import configuration"
msgstr ""
@ -294,7 +294,7 @@ msgstr ""
msgid "In this case, you need to set :attr:`MUSIC_DIRECTORY_SERVE_PATH` to ``/srv/funkwhale/data/music``. The webserver needs to be able to read this directory."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:141
#: ../../administrator_documentation/configuration_docs/env_file.md:148
msgid "API configuration"
msgstr ""
@ -310,7 +310,7 @@ msgstr ""
msgid "``signup=5/d,password-reset=2/d,anonymous-reports=5/d``"
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:151
#: ../../administrator_documentation/configuration_docs/env_file.md:158
msgid "See [Rate limit API endpoints](rate-limiting.md) for a list of available endpoints and their default limits."
msgstr ""
@ -338,7 +338,7 @@ msgstr ""
msgid "Default timeout for external requests."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:161
#: ../../administrator_documentation/configuration_docs/env_file.md:168
msgid "Federation configuration"
msgstr ""
@ -350,7 +350,7 @@ msgstr ""
msgid "The delay in seconds between two manual fetches of the same remote object."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:170
#: ../../administrator_documentation/configuration_docs/env_file.md:177
msgid "Metadata configuration"
msgstr ""
@ -374,7 +374,7 @@ msgstr ""
msgid "Length of time in seconds to cache MusicBrainz results."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:180
#: ../../administrator_documentation/configuration_docs/env_file.md:187
msgid "Channels and podcast configuration"
msgstr ""
@ -398,7 +398,7 @@ msgstr ""
msgid "Changing this value only affect new podcasts."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:190
#: ../../administrator_documentation/configuration_docs/env_file.md:197
msgid "Subsonic configuration"
msgstr ""
@ -406,7 +406,7 @@ msgstr ""
msgid "The default format files are transcoded into when using the Subsonic API."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:198
#: ../../administrator_documentation/configuration_docs/env_file.md:205
msgid "Email configuration"
msgstr ""
@ -458,7 +458,7 @@ msgstr ""
msgid "Subject prefix for system emails."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:210
#: ../../administrator_documentation/configuration_docs/env_file.md:217
msgid "Plugin configuration"
msgstr ""
@ -466,11 +466,11 @@ msgstr ""
msgid "Path to a directory containing Funkwhale plugins. These are imported at runtime."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:223
#: ../../administrator_documentation/configuration_docs/env_file.md:226
msgid "List of Funkwhale plugins to load."
msgstr ""
#: ../../administrator_documentation/configuration_docs/env_file.md:226
#: ../../administrator_documentation/configuration_docs/env_file.md:233
msgid "Other settings"
msgstr ""
@ -497,3 +497,11 @@ msgstr ""
#: ../../docstring of config.settings.common.LINKIFIER_SUPPORTED_TLDS:1
msgid "Additional TLDs to support with our markdown linkifier."
msgstr ""
#: ../../docstring of config.settings.common.LOGLEVEL:1
msgid "str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str"
msgstr ""
#: ../../docstring of config.settings.common.LOGLEVEL:4
msgid "Create a new string object from the given object. If encoding or errors is specified, then the object must expose a data buffer that will be decoded using the given encoding and error handler. Otherwise, returns the result of object.__str__() (if defined) or repr(object). encoding defaults to sys.getdefaultencoding(). errors defaults to 'strict'."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -112,7 +112,6 @@ msgstr ""
msgid "Once you've created your {file}`settings.json` file you need to configure your reverse proxy to serve it."
msgstr ""
#: ../../administrator_documentation/configuration_docs/frontend.md:0
#: ../../administrator_documentation/configuration_docs/frontend.md:0
msgid "Nginx"
msgstr ""
@ -121,7 +120,6 @@ msgstr ""
msgid "Add the following snippet to your {file}`/etc/nginx/sites-available/funkwhale.conf` config file:"
msgstr ""
#: ../../administrator_documentation/configuration_docs/frontend.md:0
#: ../../administrator_documentation/configuration_docs/frontend.md:0
msgid "Apache"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -28,7 +28,6 @@ msgstr ""
msgid "Frontend customization"
msgstr ""
#: ../../administrator_documentation/configuration_docs/index.md:5
#: ../../administrator_documentation/configuration_docs/index.md:5
msgid "Configuration options"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,17 +32,17 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:12
#: ../../administrator_documentation/configuration_docs/instance_settings.md:21
#: ../../administrator_documentation/configuration_docs/instance_settings.md:13
#: ../../administrator_documentation/configuration_docs/instance_settings.md:22
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:13
#: ../../administrator_documentation/configuration_docs/instance_settings.md:14
msgid "Select the wrench icon ({fa}`wrench`) at the top of the sidebar to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:14
#: ../../administrator_documentation/configuration_docs/instance_settings.md:23
#: ../../administrator_documentation/configuration_docs/instance_settings.md:15
#: ../../administrator_documentation/configuration_docs/instance_settings.md:24
msgid "Select {guilabel}`Settings`. The {guilabel}`Instance settings` page opens."
msgstr ""
@ -50,15 +50,15 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:22
#: ../../administrator_documentation/configuration_docs/instance_settings.md:23
msgid "Select the wrench icon ({fa}`wrench`) at the top of the page to open the {guilabel}`Administration` menu."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:27
#: ../../administrator_documentation/configuration_docs/instance_settings.md:28
msgid "Available settings"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:29
#: ../../administrator_documentation/configuration_docs/instance_settings.md:30
msgid "Instance information"
msgstr ""
@ -66,7 +66,7 @@ msgstr ""
msgid "Pod name"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:33
#: ../../administrator_documentation/configuration_docs/instance_settings.md:34
msgid "The public name of your Funkwhale pod. This is displayed on the \"Home\" and \"About\" pages."
msgstr ""
@ -74,7 +74,7 @@ msgstr ""
msgid "Short description"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:36
#: ../../administrator_documentation/configuration_docs/instance_settings.md:37
msgid "A short description of your pod. Users see this on the pod's \"Home\" page."
msgstr ""
@ -82,7 +82,7 @@ msgstr ""
msgid "Long description"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:39
#: ../../administrator_documentation/configuration_docs/instance_settings.md:40
msgid "A longer description of your pod. Users see this on the pod's \"About\" page. Supports markdown formatting."
msgstr ""
@ -90,7 +90,7 @@ msgstr ""
msgid "Contact email"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:42
#: ../../administrator_documentation/configuration_docs/instance_settings.md:43
msgid "A contact email address that users and visitors can use to contact the pod administrator."
msgstr ""
@ -98,7 +98,7 @@ msgstr ""
msgid "Rules"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:45
#: ../../administrator_documentation/configuration_docs/instance_settings.md:46
msgid "A free text field for you to add your pod's rules and code of conduct. This is seen on the pod's \"About\" page. Supports markdown formatting"
msgstr ""
@ -106,7 +106,7 @@ msgstr ""
msgid "Terms of service"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:48
#: ../../administrator_documentation/configuration_docs/instance_settings.md:49
msgid "A free text field for you to add your pod's terms of service and privacy policy. This is seen on the pod's \"About\" page. Supports markdown formatting."
msgstr ""
@ -114,7 +114,7 @@ msgstr ""
msgid "Banner image"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:51
#: ../../administrator_documentation/configuration_docs/instance_settings.md:52
msgid "A large image seen on the pod's \"Home\" and \"About\" pages. The image should be at least 600x100px."
msgstr ""
@ -122,11 +122,11 @@ msgstr ""
msgid "Support message"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:54
#: ../../administrator_documentation/configuration_docs/instance_settings.md:55
msgid "A short message you can display to your pod's users to ask for support or just send a periodic message. Supports markdown."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:61
#: ../../administrator_documentation/configuration_docs/instance_settings.md:62
msgid "Sign-ups"
msgstr ""
@ -134,7 +134,7 @@ msgstr ""
msgid "Open registration to new users"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:65
#: ../../administrator_documentation/configuration_docs/instance_settings.md:66
msgid "Enable this setting to allow new users to create an account on your pod."
msgstr ""
@ -142,7 +142,7 @@ msgstr ""
msgid "Enable manual sign-up validation"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:68
#: ../../administrator_documentation/configuration_docs/instance_settings.md:69
msgid "Enable this setting to require all new registrations to be validated by a moderator."
msgstr ""
@ -150,11 +150,11 @@ msgstr ""
msgid "Sign-up form customization"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:71
#: ../../administrator_documentation/configuration_docs/instance_settings.md:72
msgid "Use this tool to create a custom sign-up form. New users see this form when creating a new account. Supports markdown"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:78
#: ../../administrator_documentation/configuration_docs/instance_settings.md:79
msgid "Security"
msgstr ""
@ -162,11 +162,11 @@ msgstr ""
msgid "API Requires authentication"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:82
#: ../../administrator_documentation/configuration_docs/instance_settings.md:83
msgid "Controls whether {term}`unauthenticated users <Anonymous>` can access content on your pod. If __enabled__, users need to have an account on your pod to access content. If __disabled__, users without an account can listen to content stored in public libraries."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:85
#: ../../administrator_documentation/configuration_docs/instance_settings.md:86
msgid "{doc}`../../moderator_documentation/content/library_visibility`."
msgstr ""
@ -174,7 +174,7 @@ msgstr ""
msgid "Default permissions"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:89
#: ../../administrator_documentation/configuration_docs/instance_settings.md:90
msgid "A list of {term}`permissions` that are added to users by default. If your pod is publicly accessible, you should leave this empty."
msgstr ""
@ -182,15 +182,15 @@ msgstr ""
msgid "Upload quota"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:92
#: ../../administrator_documentation/configuration_docs/instance_settings.md:93
msgid "The default upload quota for users in MB. You can override this on a per-user basis."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:95
#: ../../administrator_documentation/configuration_docs/instance_settings.md:96
msgid "{doc}`../../moderator_documentation/reports/handle_users`"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:103
#: ../../administrator_documentation/configuration_docs/instance_settings.md:104
msgid "Music"
msgstr ""
@ -198,7 +198,7 @@ msgstr ""
msgid "Transcoding enabled"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:107
#: ../../administrator_documentation/configuration_docs/instance_settings.md:108
msgid "Enable this setting to let your server transcode files into a different format if the client requests it. This is useful if a device doesn't support formats like Ogg or FLAC."
msgstr ""
@ -206,11 +206,11 @@ msgstr ""
msgid "Transcoding cache duration"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:110
#: ../../administrator_documentation/configuration_docs/instance_settings.md:111
msgid "The number of minutes you want to store transcoded files on your server. Funkwhale removes transcoded tracks that haven't been downloaded within this duration to save space."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:115
#: ../../administrator_documentation/configuration_docs/instance_settings.md:116
msgid "Channels"
msgstr ""
@ -218,7 +218,7 @@ msgstr ""
msgid "Enable channels"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:119
#: ../../administrator_documentation/configuration_docs/instance_settings.md:120
msgid "Whether user channels can be created and followed on your pod."
msgstr ""
@ -226,11 +226,11 @@ msgstr ""
msgid "Max channels allowed per user"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:122
#: ../../administrator_documentation/configuration_docs/instance_settings.md:123
msgid "The maximum number of channels each user can create."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:129
#: ../../administrator_documentation/configuration_docs/instance_settings.md:130
msgid "Playlists"
msgstr ""
@ -238,11 +238,11 @@ msgstr ""
msgid "Max tracks per playlist"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:133
#: ../../administrator_documentation/configuration_docs/instance_settings.md:134
msgid "The maximum number of tracks a user can add to a playlist."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:140
#: ../../administrator_documentation/configuration_docs/instance_settings.md:141
msgid "Moderation"
msgstr ""
@ -250,7 +250,7 @@ msgstr ""
msgid "Enable allow-listing"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:144
#: ../../administrator_documentation/configuration_docs/instance_settings.md:145
msgid "Enable this setting to ensure your pod only communicates with pods you have added to your allow list. When this setting is disabled, your pod will communicate with all other servers not included in your deny list."
msgstr ""
@ -258,7 +258,7 @@ msgstr ""
msgid "Publish your allowed-domains list"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:147
#: ../../administrator_documentation/configuration_docs/instance_settings.md:148
msgid "Whether to make your list of allowed domains public. Enable this if you want users to check who you are federating with."
msgstr ""
@ -266,11 +266,11 @@ msgstr ""
msgid "Accountless report categories"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:150
#: ../../administrator_documentation/configuration_docs/instance_settings.md:151
msgid "A list of {term}`categories <Report categories>` that {term}`anonymous` users can submit."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:157
#: ../../administrator_documentation/configuration_docs/instance_settings.md:158
msgid "Federation"
msgstr ""
@ -278,7 +278,7 @@ msgstr ""
msgid "Federation enabled"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:161
#: ../../administrator_documentation/configuration_docs/instance_settings.md:162
msgid "Whether to enable federation features on your pod."
msgstr ""
@ -286,7 +286,7 @@ msgstr ""
msgid "Enable public index"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:164
#: ../../administrator_documentation/configuration_docs/instance_settings.md:165
msgid "Whether to allow other pods and bots to index public content on your pod."
msgstr ""
@ -294,7 +294,7 @@ msgstr ""
msgid "Federation collection page size"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:167
#: ../../administrator_documentation/configuration_docs/instance_settings.md:168
msgid "The number of items to display in ActivityPub collections."
msgstr ""
@ -302,7 +302,7 @@ msgstr ""
msgid "Music cache duration"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:170
#: ../../administrator_documentation/configuration_docs/instance_settings.md:171
msgid "The number of minutes you want to store local copies of federated tracks on your server. Funkwhale removes federated tracks that haven't been downloaded within this duration to save space."
msgstr ""
@ -310,11 +310,11 @@ msgstr ""
msgid "Federation actor fetch delay"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:173
#: ../../administrator_documentation/configuration_docs/instance_settings.md:174
msgid "The number of minutes the server waits before refetching actors on request authentication."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:180
#: ../../administrator_documentation/configuration_docs/instance_settings.md:181
msgid "Subsonic"
msgstr ""
@ -322,11 +322,11 @@ msgstr ""
msgid "Enabled Subsonic API"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:184
#: ../../administrator_documentation/configuration_docs/instance_settings.md:185
msgid "Whether to enable the Subsonic API. This controls whether users are able to connect to your pod using Subsonic apps."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:191
#: ../../administrator_documentation/configuration_docs/instance_settings.md:192
msgid "User Interface"
msgstr ""
@ -334,7 +334,7 @@ msgstr ""
msgid "Custom CSS code"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:195
#: ../../administrator_documentation/configuration_docs/instance_settings.md:196
msgid "Add CSS rules to control the look and feel of your pod. These rules are added to a `<style>` tag on each page."
msgstr ""
@ -342,11 +342,11 @@ msgstr ""
msgid "Funkwhale Support message"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:198
#: ../../administrator_documentation/configuration_docs/instance_settings.md:199
msgid "Whether to show a notification to your pod's users to support the Funkwhale project."
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:205
#: ../../administrator_documentation/configuration_docs/instance_settings.md:206
msgid "Statistics"
msgstr ""
@ -354,7 +354,7 @@ msgstr ""
msgid "Enable usage and library stats in nodeinfo endpoint"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:209
#: ../../administrator_documentation/configuration_docs/instance_settings.md:210
msgid "Whether to share anonymized usage and library statistics in your pod's nodeinfo endpoint."
msgstr ""
@ -362,6 +362,6 @@ msgstr ""
msgid "Private mode in nodeinfo"
msgstr ""
#: ../../administrator_documentation/configuration_docs/instance_settings.md:213
#: ../../administrator_documentation/configuration_docs/instance_settings.md:214
msgid "Enable this setting to indicate you don't want your instance to be tracked by third-party services."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -72,39 +72,39 @@ msgstr ""
msgid "Basic features"
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:40
#: ../../administrator_documentation/configuration_docs/ldap.md:34
msgid "Set this to `True` to enable LDAP support"
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:49
#: ../../administrator_documentation/configuration_docs/ldap.md:44
msgid "The LDAP {abbr}`URI (Uniform Resource Identifier)` of your authentication server."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:58
msgid "LDAP user {abbr}`DN (Distinguised Name)` to bind on so you can perform searches."
#: ../../administrator_documentation/configuration_docs/ldap.md:53
msgid "LDAP user {abbr}`DN (Distinguished Name)` to bind on so you can perform searches."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:67
msgid "LDAP user password for bind {abbr}`DN (Distinguised Name)`."
#: ../../administrator_documentation/configuration_docs/ldap.md:62
msgid "LDAP user password for bind {abbr}`DN (Distinguished Name)`."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:76
#: ../../administrator_documentation/configuration_docs/ldap.md:71
msgid "The LDAP user filter, using `{0}` as the username placeholder. Uses standard [LDAP search syntax](https://social.technet.microsoft.com/wiki/contents/articles/5392.active-directory-ldap-syntax-filters.aspx)."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:85
#: ../../administrator_documentation/configuration_docs/ldap.md:80
msgid "Set to `True` to enable LDAP StartTLS support."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:94
msgid "The LDAP search root {abbr}`DN (Distinguised Name)`. Supports several entries in a comma-delimited list."
#: ../../administrator_documentation/configuration_docs/ldap.md:89
msgid "The LDAP search root {abbr}`DN (Distinguished Name)`. Supports several entries in a comma-delimited list."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:103
#: ../../administrator_documentation/configuration_docs/ldap.md:98
msgid "A mapping of Django user attributes to LDAP values."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:112
#: ../../administrator_documentation/configuration_docs/ldap.md:107
msgid "Controls whether to use direct binding."
msgstr ""
@ -120,18 +120,18 @@ msgstr ""
msgid "[Django's LDAP documentation](https://django-auth-ldap.readthedocs.io/en/latest/groups.html) for groups."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:129
msgid "The LDAP group search root {abbr}`DN (Distinguised Name)`. This needs to be set to `True` to enable group features."
#: ../../administrator_documentation/configuration_docs/ldap.md:124
msgid "The LDAP group search root {abbr}`DN (Distinguished Name)`. This needs to be set to `True` to enable group features."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:138
#: ../../administrator_documentation/configuration_docs/ldap.md:133
msgid "The LDAP group filter."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:147
#: ../../administrator_documentation/configuration_docs/ldap.md:142
msgid "The group that users need to be a member of to authenticate."
msgstr ""
#: ../../administrator_documentation/configuration_docs/ldap.md:156
#: ../../administrator_documentation/configuration_docs/ldap.md:151
msgid "A group whose members can't authenticate."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -92,18 +92,10 @@ msgstr ""
msgid "List registered MRF policies."
msgstr ""
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
#: ../../administrator_documentation/configuration_docs/mrf.md:0
msgid "Docker"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -136,12 +136,10 @@ msgstr ""
msgid "Open your Nginx configuration file in an editor."
msgstr ""
#: ../../administrator_documentation/configuration_docs/object_storage.md:0
#: ../../administrator_documentation/configuration_docs/object_storage.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/configuration_docs/object_storage.md:0
#: ../../administrator_documentation/configuration_docs/object_storage.md:0
msgid "Docker"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -60,7 +60,7 @@ msgstr ""
msgid "Add the `--pool=solo` flag to the `ExecStart` line of your unit file."
msgstr ""
#: ../../administrator_documentation/configuration_docs/optimize.md:37
#: ../../administrator_documentation/configuration_docs/optimize.md:42
msgid "Restart the Celery service."
msgstr ""
@ -68,10 +68,10 @@ msgstr ""
msgid "Docker"
msgstr ""
#: ../../administrator_documentation/configuration_docs/optimize.md:48
#: ../../administrator_documentation/configuration_docs/optimize.md:53
msgid "Add the `--pool=solo` flag to the `celerybeat` command in `docker-compose.yml`."
msgstr ""
#: ../../administrator_documentation/configuration_docs/optimize.md:56
#: ../../administrator_documentation/configuration_docs/optimize.md:61
msgid "Restart Celery."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,7 +16,6 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/django/index.md:10
#: ../../administrator_documentation/django/index.md:10
msgid "Administrative tasks"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -40,18 +40,10 @@ msgstr ""
msgid "To see a full list of options, run the command with the `--help` flag."
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
msgid "Docker"
msgstr ""
@ -244,6 +236,66 @@ msgstr ""
msgid "File deleted removes the file from the database."
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:0
msgid "Watched metadata"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:220
msgid "The `import_files --watch` command watches for changes to the following metadata fields:"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:222
msgid "Track mbid"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:223
msgid "Track title"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:224
msgid "Track position and disc number"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:225
msgid "Track license and copyright"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:226
msgid "Track genre"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:227
msgid "Album cover"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:228
msgid "Album title"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:229
msgid "Album mbid"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:230
msgid "Album release date"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:231
msgid "Artist name"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:232
msgid "Artist mbid"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:233
msgid "Album artist name"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:234
msgid "Album artist mbid"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:259
msgid "Prune dangling metadata"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -33,7 +33,7 @@ msgid "Set a `FUNKWHALE_VERSION` variable to the version you want to install. Yo
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:18
msgid "Install `curl`."
msgid "Install `curl`"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:25
@ -64,298 +64,286 @@ msgstr ""
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."
#: ../../administrator_documentation/installation_docs/debian.md:48
msgid "To perform any tasks as the `funkwhale` user, prefix your commands with `sudo -u funkwhale`."
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."
#: ../../administrator_documentation/installation_docs/debian.md:54
msgid "Or log in as `funkwhale` with `sudo su funkwhale` before running your commands."
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."
#: ../../administrator_documentation/installation_docs/debian.md:62
msgid "That's it! You've created your `funkwhale` user."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:61
#: ../../administrator_documentation/installation_docs/debian.md:64
msgid "3. Download Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:63
#: ../../administrator_documentation/installation_docs/debian.md:66
msgid "Once you've created your `funkwhale` user you can download the Funkwhale software itself."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:65
#: ../../administrator_documentation/installation_docs/debian.md:68
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."
#: ../../administrator_documentation/installation_docs/debian.md:70
msgid "Go to the `/srv/funkwhale` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:74
#: ../../administrator_documentation/installation_docs/debian.md:76
msgid "Create the directories for Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:80
#: ../../administrator_documentation/installation_docs/debian.md:82
msgid "Allow the Funkwhale user to write to the data directories."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:88
msgid "That's it! Your directory structure should look like this:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:93
#: ../../administrator_documentation/installation_docs/debian.md:101
msgid "Download the Funkwhale release"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:95
#: ../../administrator_documentation/installation_docs/debian.md:103
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
#: ../../administrator_documentation/installation_docs/debian.md:105
msgid "Download the API."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:106
#: ../../administrator_documentation/installation_docs/debian.md:114
msgid "Download the frontend"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:116
#: ../../administrator_documentation/installation_docs/debian.md:123
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"
#: ../../administrator_documentation/installation_docs/debian.md:125
msgid "4. Install the Funkwhale API"
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."
#: ../../administrator_documentation/installation_docs/debian.md:127
msgid "The Funkwhale API is written in Python. You need to install the API's package to run the software:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:122
msgid "Install Poetry. Follow the steps in this wizard to set it up."
#: ../../administrator_documentation/installation_docs/debian.md:129
msgid "Set up a Python virtual environment:"
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."
#: ../../administrator_documentation/installation_docs/debian.md:137
msgid "Install the Funkwhale API package and dependencies:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:143
msgid "5. Set up your environment file"
msgid "You're done!"
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."
msgid "5. Set up your environment file"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:147
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:149
msgid "Download the `.env` template to your `/srv/funkwhale/config` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:153
#: ../../administrator_documentation/installation_docs/debian.md:155
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
#: ../../administrator_documentation/installation_docs/debian.md:161
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
#: ../../administrator_documentation/installation_docs/debian.md:168
msgid "Open the `.env` file in a text editor. For this example, we will use `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:171
#: ../../administrator_documentation/installation_docs/debian.md:174
msgid "Update the following settings:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:172
#: ../../administrator_documentation/installation_docs/debian.md:176
msgid "Paste the secret key in the `DJANGO_SECRET_KEY` field."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:173
#: ../../administrator_documentation/installation_docs/debian.md:177
msgid "Populate the `DATABASE_URL` field:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:179
#: ../../administrator_documentation/installation_docs/debian.md:183
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."
msgid "Populate the `FUNKWHALE_HOSTNAME` field with the domain name of your server."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:191
msgid "6. Set up your database"
msgid "Hit {kbd}`ctrl + x` then {kbd}`y` to save the file and close `nano`."
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."
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:195
msgid "6. Set up your database"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:197
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:199
msgid "Install PostgreSQL and the `postgresql-contrib` package. This package contains extra features that Funkwhale uses."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:201
#: ../../administrator_documentation/installation_docs/debian.md:205
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
#: ../../administrator_documentation/installation_docs/debian.md:211
msgid "Create your Funkwhale database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:213
#: ../../administrator_documentation/installation_docs/debian.md:217
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
#: ../../administrator_documentation/installation_docs/debian.md:224
msgid "Once you're finished, exit the shell"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:226
#: ../../administrator_documentation/installation_docs/debian.md:230
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."
#: ../../administrator_documentation/installation_docs/debian.md:237
msgid "Your database is ready to be populated! Use the `funkwhale-manage` command line interface to create the database structure."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:241
#: ../../administrator_documentation/installation_docs/debian.md:245
msgid "You may see the following warning when applying migrations:"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:247
#: ../../administrator_documentation/installation_docs/debian.md:251
msgid "You can safely ignore this warning."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:250
#: ../../administrator_documentation/installation_docs/debian.md:254
msgid "That's it! You've finished setting up your database."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:252
#: ../../administrator_documentation/installation_docs/debian.md:256
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."
#: ../../administrator_documentation/installation_docs/debian.md:258
msgid "Once you've got your database up and running, you can get Funkwhale ready to launch. Use the built-in `funkwhale-manage` command line interface to get things ready."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:256
#: ../../administrator_documentation/installation_docs/debian.md:260
msgid "Create a superuser for your pod"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:259
#: ../../administrator_documentation/installation_docs/debian.md:263
msgid "You can create several superusers."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:262
#: ../../administrator_documentation/installation_docs/debian.md:266
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
#: ../../administrator_documentation/installation_docs/debian.md:272
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
#: ../../administrator_documentation/installation_docs/debian.md:274
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."
#: ../../administrator_documentation/installation_docs/debian.md:276
msgid "Funkwhale uses several static assets to serve its frontend. Use the `funkwhale-manage` command line interface to collect these files so that the webserver can serve them."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:282
msgid "8. Set up systemd unit files"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:284
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:286
msgid "Download the sample unit files from Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:291
#: ../../administrator_documentation/installation_docs/debian.md:295
msgid "Reload systemd to register the new services."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:297
#: ../../administrator_documentation/installation_docs/debian.md:301
msgid "Start all Funkwhale services."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:303
#: ../../administrator_documentation/installation_docs/debian.md:307
msgid "Enable the services. Systemd can then start the services after a reboot."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:311
#: ../../administrator_documentation/installation_docs/debian.md:313
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
#: ../../administrator_documentation/installation_docs/debian.md:315
msgid "9. Set up a reverse proxy"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:315
#: ../../administrator_documentation/installation_docs/debian.md:317
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
#: ../../administrator_documentation/installation_docs/debian.md:319
msgid "Install Nginx."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:324
#: ../../administrator_documentation/installation_docs/debian.md:326
msgid "Download the Nginx templates from Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:332
#: ../../administrator_documentation/installation_docs/debian.md:333
msgid "Create an Nginx template with details from your `.env` file."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:355
#: ../../administrator_documentation/installation_docs/debian.md:356
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
#: ../../administrator_documentation/installation_docs/debian.md:362
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."
#: ../../administrator_documentation/installation_docs/debian.md:364
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 [certbot](https://certbot.eff.org/)."
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:365
msgid "Log in as the superuser account to run these commands."
#: ../../administrator_documentation/installation_docs/debian.md:366
msgid "Install certbot"
msgstr ""
#: ../../administrator_documentation/installation_docs/debian.md:371
msgid "Create the `/etc/certs` folder to store the certificates."
#: ../../administrator_documentation/installation_docs/debian.md:373
msgid "Run certbot"
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."
#: ../../administrator_documentation/installation_docs/debian.md:379
msgid "That's it! certbot renews your certificate every 60 days, so you don't need to worry about renewing it."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -21,7 +21,7 @@ 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."
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)."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:6
@ -37,7 +37,7 @@ msgid "Set a `FUNKWHALE_VERSION` variable to the version you want to install. Yo
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/)."
msgid "Install [Docker](https://docs.docker.com/engine/install/) and the [compose plugin](https://docs.docker.com/compose/install/linux/#install-using-the-repository)."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:22
@ -45,165 +45,213 @@ msgid "Install `curl`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:29
msgid "1. Download the project files"
msgid "1. Create a Funkwhale user"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:31
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/docker.md:33
msgid "Create the `funkwhale` user and set its shell to `bash` and its home directory to `/srv/funkwhale`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:40
msgid "To perform any tasks as the `funkwhale` user, prefix your commands with `sudo -u funkwhale`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:46
msgid "Or log in as `funkwhale` with `sudo su funkwhale` before running your commands."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:54
msgid "That's it! You've created your `funkwhale` user."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:56
msgid "2. Download the project files"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:58
msgid "Create the project directory structure."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:37
#: ../../administrator_documentation/installation_docs/docker.md:64
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."
#: ../../administrator_documentation/installation_docs/docker.md:70
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
#: ../../administrator_documentation/installation_docs/docker.md:76
msgid "That's it! You've set up your project files."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:51
msgid "2. Set up your environment file"
#: ../../administrator_documentation/installation_docs/docker.md:78
msgid "3. Set up your environment file"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:53
#: ../../administrator_documentation/installation_docs/docker.md:80
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:55
#: ../../administrator_documentation/installation_docs/docker.md:82
msgid "Download the `.env` template to your `/srv/funkwhale` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:61
#: ../../administrator_documentation/installation_docs/docker.md:88
msgid "Update `FUNKWHALE_VERSION` in the `.env` file to the `$FUNKWHALE_VERSION` variable you set earlier."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:67
#: ../../administrator_documentation/installation_docs/docker.md:94
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:73
#: ../../administrator_documentation/installation_docs/docker.md:100
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:79
#: ../../administrator_documentation/installation_docs/docker.md:106
msgid "Open the `.env` file in a text editor. For this example, we will use `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:85
#: ../../administrator_documentation/installation_docs/docker.md:112
msgid "Update the following settings:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:86
#: ../../administrator_documentation/installation_docs/docker.md:114
msgid "Paste the secret key in the `DJANGO_SECRET_KEY` field."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:87
#: ../../administrator_documentation/installation_docs/docker.md:115
msgid "Populate the `FUNKWHALE_HOSTNAME` field with the URL of your server."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:89
#: ../../administrator_documentation/installation_docs/docker.md:117
msgid "Hit {kbd}`ctrl + x` then {kbd}`y` to save the file and close `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:91
#: ../../administrator_documentation/installation_docs/docker.md:119
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:93
msgid "3. Set up Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:95
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:97
msgid "Pull the containers to download all the required services."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:104
msgid "Bring up the database container so you can run the database migrations."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:110
msgid "Run the database migrations."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:117
msgid "You may see the following warning when applying migrations:"
#: ../../administrator_documentation/installation_docs/docker.md:121
msgid "4. Set up Funkwhale"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:123
msgid "You can safely ignore this warning."
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:126
msgid "Create your superuser."
#: ../../administrator_documentation/installation_docs/docker.md:125
msgid "Pull the containers to download all the required services."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:132
msgid "Launch all the containers to bring up your pod."
msgid "Bring up the database container so you can run the database migrations."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:138
msgid "That's it! Your Funkwhale pod is now up and running."
msgid "Run the database migrations."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:140
msgid "4. Set up your reverse proxy"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:142
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:144
msgid "Install Nginx."
#: ../../administrator_documentation/installation_docs/docker.md:145
msgid "You may see the following warning when applying migrations:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:151
msgid "You can safely ignore this warning."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:154
msgid "Create your superuser."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:160
msgid "Launch all the containers to bring up your pod."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:166
msgid "That's it! Your Funkwhale pod is now up and running."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:168
msgid "5. Set up your reverse proxy"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:170
msgid "Funkwhale requires a reverse proxy to serve content to users. We recommend using [Nginx](https://nginx.com) to handle requests to your container. To do this:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:172
msgid "Install Nginx."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:179
msgid "Download the Nginx templates from Funkwhale."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:158
#: ../../administrator_documentation/installation_docs/docker.md:186
msgid "Create an Nginx template with details from your `.env` file."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:181
#: ../../administrator_documentation/installation_docs/docker.md:209
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:187
msgid "5. Set up TLS"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:189
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:191
msgid "Log in as the superuser account to run these commands."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:197
msgid "Create the `/etc/certs` folder to store the certificates."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:203
msgid "Download and run `acme.sh`. Replace `my@example.com` with your email address."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:209
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:215
msgid "Install the certificate to your Nginx config. Replace `example.com` with your Funkwhale pod name."
msgid "Override default Nginx templates"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:224
msgid "That's it! acme.sh renews your certificate every 60 days, so you don't need to worry about renewing it."
#: ../../administrator_documentation/installation_docs/docker.md:217
msgid "The frontend container ships default Nginx templates which serve content to the reverse proxy. These files read variables from your `.env` file to correctly serve content. In some cases, you might want to override these defaults. To do this:"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:219
msgid "Create a `/srv/funkwhale/nginx` directory to house your files."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:225
msgid "Download the Nginx template files to the `/srv/funkwhale/nginx` directory."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:232
msgid "Make any changes you want to make to these files."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:233
msgid "Open your `docker-compose.yml` file in a text editor. For this example, we will use `nano`."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:239
msgid "Uncomment the lines in the `volumes` section of the `front` service by deleting the `#` in front of them."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:253
msgid "Bring the `front` container up again to pick up the changes."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:259
msgid "That's it! The container mounts your custom nginx files and uses its values to serve Funkwhale content. To revert to the default values, comment out the volumes by adding a `#` in front of them and bring the `front` container back up."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:261
msgid "6. Set up TLS"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:263
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 [certbot](https://certbot.eff.org/)."
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:265
msgid "Install certbot"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:272
msgid "Run certbot"
msgstr ""
#: ../../administrator_documentation/installation_docs/docker.md:278
msgid "That's it! certbot renews your certificate every 60 days, so you don't need to worry about renewing it."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,12 +16,10 @@ msgstr ""
"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:23
#: ../../administrator_documentation/installation_docs/index.md:23
msgid "Migrate your installation"
msgstr ""
@ -39,9 +37,9 @@ 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`."
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."
msgid "**Access to ports `80` and `443`** Funkwhale uses these ports for federation."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -72,9 +72,6 @@ msgstr ""
msgid "Before you move your data, you need to install Funkwhale on your {term}`destination server`."
msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:0
#: ../../administrator_documentation/installation_docs/migrate.md:0
#: ../../administrator_documentation/installation_docs/migrate.md:0
#: ../../administrator_documentation/installation_docs/migrate.md:0
msgid "Debian"
msgstr ""
@ -89,7 +86,7 @@ msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:44
#: ../../administrator_documentation/installation_docs/migrate.md:60
msgid "Don't run the `manage.py migrate` command to migrate the database."
msgid "Don't run the `funkwhale-manage migrate` command to migrate the database."
msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:45
@ -102,9 +99,6 @@ msgstr ""
msgid "Once you have finished the installation, stop the Funkwhale services. These shouldn't be running when you copy your existing data over."
msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:0
#: ../../administrator_documentation/installation_docs/migrate.md:0
#: ../../administrator_documentation/installation_docs/migrate.md:0
#: ../../administrator_documentation/installation_docs/migrate.md:0
msgid "Docker"
msgstr ""
@ -175,7 +169,7 @@ msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:140
#: ../../administrator_documentation/installation_docs/migrate.md:170
msgid "When the import finishes, run the `manage.py migrate` command to set up the database."
msgid "When the import finishes, run the `funkwhale-manage migrate` command to set up the database."
msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:152
@ -195,7 +189,7 @@ msgid "5. Check your DNS settings"
msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:180
msgid "Before you start Funkwhale on your {term}`destination server`, check your DNS changes have propogated. Once your hostname is pointing to your {term}`destination server's <destination server>` IP address, proceed to the next step."
msgid "Before you start Funkwhale on your {term}`destination server`, check your DNS changes have propagated. Once your hostname is pointing to your {term}`destination server's <destination server>` IP address, proceed to the next step."
msgstr ""
#: ../../administrator_documentation/installation_docs/migrate.md:182

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -0,0 +1,124 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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/manage_script/create_library.md:1
msgid "Create a library"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:3
msgid "Use the `create_library` command to create new libraries for a given user."
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:9
msgid "Parameter"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:10
msgid "Data type"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:11
msgid "Description"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:13
msgid "`username`*"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:14
#: ../../administrator_documentation/manage_script/create_library.md:18
msgid "String"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:15
msgid "The user you want to create the library for."
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:17
msgid "`--name`"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:19
msgid "The name of the library. Defaults to \"default\"."
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:21
msgid "`--privacy-level`"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:22
msgid "Enum (String)"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:23
msgid "The [privacy level](../../user_documentation/libraries/create_library.md) of the library"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:24
msgid "`\"me\"` (default)"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:25
msgid "`\"instance\"`"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:26
msgid "`\"everyone\"`"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:29
msgid "Examples"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:31
msgid "Create a new library"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:33
msgid "Use the following command to create a new library with a custom name and privacy level."
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:0
msgid "Docker"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:57
#: ../../administrator_documentation/manage_script/create_library.md:89
#: ../../administrator_documentation/manage_script/create_library.md:121
msgid "Returns"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:63
msgid "Create a new library with no name or privacy level"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:65
msgid "You can create a library using only a username. The script substitutes default values for the library name and privacy level."
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:95
msgid "Library with the same name already exists"
msgstr ""
#: ../../administrator_documentation/manage_script/create_library.md:97
msgid "If a library with the same name already exists for the given user, the script will **not** create a new library."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -36,18 +36,10 @@ msgstr ""
msgid "Check and fix file mimetypes with the `--mimetype` flag. This helps prevent issues with serving music files."
msgstr ""
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
#: ../../administrator_documentation/manage_script/fix_uploads.md:0
msgid "Docker"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,15 +32,14 @@ msgstr ""
msgid "Add album and artist tags"
msgstr ""
#: ../../administrator_documentation/manage_script/index.md:5
#: ../../administrator_documentation/manage_script/index.md:5
msgid "Administration tasks"
msgstr ""
#: ../../administrator_documentation/manage_script/index.md:1
msgid "Funkwhale management script"
msgid "Funkwhale management command line interface"
msgstr ""
#: ../../administrator_documentation/manage_script/index.md:3
msgid "Funkwhale includes a {file}`manage.py` script that can help you automate a lot of admin tasks. Check out the guides in this section for instructions on how to use this tool."
msgid "Funkwhale includes a `funkwhale-manage` command line interface that can help you automate a lot of admin tasks. Check out the guides in this section for instructions on how to use this tool."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -29,7 +29,7 @@ msgid "Sometimes you may want to clear out dangling metadata. For example, if yo
msgstr ""
#: ../../administrator_documentation/manage_script/library.md:7
msgid "To help with this, the {file}`manage.py` script includes commands to prune dangling metadata from your database. All prune commands are available under the python manage.py prune_library namespace. To ensure you don't remove data by accident, all commands run in dry run mode by default. Run commands with the `--no-dry-run` flag to perform the pruning action."
msgid "To help with this, the `funkwhale-manage` command line interface includes commands to prune dangling metadata from your database. All prune commands are available under the `funkwhale-manage prune_library` namespace. To ensure you don't remove data by accident, all commands run in dry run mode by default. Run commands with the `--no-dry-run` flag to perform the pruning action."
msgstr ""
#: ../../administrator_documentation/manage_script/library.md:10
@ -44,18 +44,10 @@ msgstr ""
msgid "Prune tracks with no associated uploads"
msgstr ""
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
#: ../../administrator_documentation/manage_script/library.md:0
msgid "Docker"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -21,7 +21,7 @@ msgid "Add artist and album tags from track metadata"
msgstr ""
#: ../../administrator_documentation/manage_script/tags.md:3
msgid "Funkwhale extracts track tags from the file's metadata. Funkwhale applies these tags to the track's album and artist by running a check every few days. You can run the process at any time using the `manage.py` script."
msgid "Funkwhale extracts track tags from the file's metadata. Funkwhale applies these tags to the track's album and artist by running a check every few days. You can run the process at any time using the `funkwhale-manage` command line interface."
msgstr ""
#: ../../administrator_documentation/manage_script/tags.md:5
@ -48,7 +48,6 @@ msgstr ""
msgid "To add tags to untagged albums:"
msgstr ""
#: ../../administrator_documentation/manage_script/tags.md:0
#: ../../administrator_documentation/manage_script/tags.md:0
msgid "Debian"
msgstr ""
@ -69,10 +68,9 @@ msgstr ""
#: ../../administrator_documentation/manage_script/tags.md:28
#: ../../administrator_documentation/manage_script/tags.md:46
msgid "Run the `manage.py` script to generate tags for untagged albums."
msgid "Run the `funkwhale-manage` command line interface to generate tags for untagged albums."
msgstr ""
#: ../../administrator_documentation/manage_script/tags.md:0
#: ../../administrator_documentation/manage_script/tags.md:0
msgid "Docker"
msgstr ""
@ -87,5 +85,5 @@ msgstr ""
#: ../../administrator_documentation/manage_script/tags.md:71
#: ../../administrator_documentation/manage_script/tags.md:89
msgid "Run the `manage.py` script to generate tags for untagged artists."
msgid "Run the `funkwhale-manage` command line interface to generate tags for untagged artists."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -21,7 +21,7 @@ msgid "Regenerate thumbnails"
msgstr ""
#: ../../administrator_documentation/manage_script/thumbnails.md:3
msgid "We increased the quality of thumbnails from 70px to 95px in Funkwhale 1.0. This action removes visual artifacts that affect lower quality thumbnails. You can run the `manage.py` script to generate new thumbnails. If you want to keep thumbnails at their original quality, add `THUMBNAIL_JPEG_RESIZE_QUALITY=70` to your `.env` file."
msgid "We increased the quality of thumbnails from 70px to 95px in Funkwhale 1.0. This action removes visual artifacts that affect lower quality thumbnails. You can run the `funkwhale-manage` command line interface to generate new thumbnails. If you want to keep thumbnails at their original quality, add `THUMBNAIL_JPEG_RESIZE_QUALITY=70` to your `.env` file."
msgstr ""
#: ../../administrator_documentation/manage_script/thumbnails.md:6
@ -53,7 +53,7 @@ msgstr ""
#: ../../administrator_documentation/manage_script/thumbnails.md:30
#: ../../administrator_documentation/manage_script/thumbnails.md:54
msgid "Run the `manage.py` script to regenerate the thumbnails."
msgid "Run the `funkwhale-manage` command line interface to regenerate the thumbnails."
msgstr ""
#: ../../administrator_documentation/manage_script/thumbnails.md:0

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -17,15 +17,15 @@ msgstr ""
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/manage_script/users.md:1
msgid "Manage users with manage.py"
msgid "Manage users"
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:3
msgid "The {file}`manage.py` script includes commands for user management. Use these commands to automate managing users from the command line."
msgid "The `funkwhale-manage` command line interface includes commands for user management. Use these commands to automate managing users from the command line."
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:5
msgid "All users-related commands are available under the `python manage.py fw users` namespace."
msgid "All users-related commands are available under the `funkwhale-manage fw users` namespace."
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:7
@ -33,43 +33,17 @@ msgid "Create users"
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:9
msgid "You can create users with the {file}`manage.py` script. There are different ways to create users depending on what approach you want to take."
msgid "You can create users with the `funkwhale-manage` command line interface. There are different ways to create users depending on what approach you want to take."
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:11
msgid "Create a user interactively"
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
#: ../../administrator_documentation/manage_script/users.md:0
msgid "Docker"
msgstr ""
@ -91,7 +65,7 @@ msgid "Update users"
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:107
msgid "You can update user accounts using the {file}`manage.py` script. Update commands are available under the `python manage.py fw users set` namespace."
msgid "You can update user accounts using the `funkwhale-manage` command line interface. Update commands are available under the `funkwhale-manage fw users set` namespace."
msgstr ""
#: ../../administrator_documentation/manage_script/users.md:109

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -33,7 +33,7 @@ msgid "If you have access to the Funkwhale backend, you can use logs to get more
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:9
msgid "__Reverse proxy logs__ check these logs if you have connectivity issues."
msgid "**Reverse proxy logs** check these logs if you have connectivity issues."
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:0
@ -45,25 +45,19 @@ msgid "Apache2"
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:33
msgid "__API logs__ check these if you are having issues with the Funkwhale app, federation, or imports."
msgid "**API logs** check these if you are having issues with the Funkwhale app, federation, or imports."
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:0
#: ../../administrator_documentation/troubleshooting/backend.md:0
#: ../../administrator_documentation/troubleshooting/backend.md:0
#: ../../administrator_documentation/troubleshooting/backend.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:0
#: ../../administrator_documentation/troubleshooting/backend.md:0
#: ../../administrator_documentation/troubleshooting/backend.md:0
#: ../../administrator_documentation/troubleshooting/backend.md:0
msgid "Docker"
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:56
msgid "__Celery logs__ check these if a federation or import task isn't working."
msgid "**Celery logs** check these if a federation or import task isn't working."
msgstr ""
#: ../../administrator_documentation/troubleshooting/backend.md:79

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,7 +16,6 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/troubleshooting/index.md:13
#: ../../administrator_documentation/troubleshooting/index.md:13
msgid "Troubleshoot"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,7 +16,6 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/uninstall_docs/index.md:9
#: ../../administrator_documentation/uninstall_docs/index.md:9
msgid "Choose your setup"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -28,14 +28,10 @@ msgstr ""
msgid "Back up your database."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:0
#: ../../administrator_documentation/upgrade_docs/backup.md:0
#: ../../administrator_documentation/upgrade_docs/backup.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:0
#: ../../administrator_documentation/upgrade_docs/backup.md:0
#: ../../administrator_documentation/upgrade_docs/backup.md:0
msgid "Docker"
msgstr ""
@ -51,3 +47,44 @@ msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:77
msgid "If you are performing regular backups, you may need deduplication and compression to keep the size down. In this case, a tool like [`borg`](https://www.borgbackup.org/) is more appropriate."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:79
msgid "Restore a backup"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:81
msgid "Restore your files"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:83
msgid "To restart your files, do the following:"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:85
msgid "Rename your current file directories."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:92
msgid "Restore your backed-up files to the original directories."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:99
msgid "Restore the database"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:101
msgid "To restore your database, do the following:"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:109
msgid "Restore your database backup:"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:115
#: ../../administrator_documentation/upgrade_docs/backup.md:133
msgid "Run the `funkwhale-manage migrate` command to set up the database."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/backup.md:127
msgid "Restore your database backup."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -21,81 +21,65 @@ msgid "Upgrade your Debian Funkwhale installation"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:3
msgid "If you installed Funkwhale following the [Debian guide](../installation_docs/debian), follow these steps to upgrade."
msgid "If you installed Funkwhale following the [Debian guide](../installation_docs/debian.md), follow these steps to upgrade."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:5
msgid "Download the updated files"
msgid "Cleanup old funkwhale files"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:7
msgid "SSH into your server."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:8
msgid "Log in as your `funkwhale` user."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:14
msgid "Navigate to your Funkwhale directory."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:20
msgid "Stop the Funkwhale services."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:26
#: ../../administrator_documentation/upgrade_docs/debian.md:13
msgid "Navigate to your Funkwhale directory."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:19
msgid "Remove the old files."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:25
msgid "Download Funkwhale"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:27
msgid "Export the Funkwhale version you want to update to. You'll use this in the rest of the commands in this guide."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:32
msgid "Download the API files for your chosen Funkwhale version."
#: ../../administrator_documentation/upgrade_docs/debian.md:33
msgid "Follow the [Download Funkwhale](../installation_docs/debian.md#3-download-funkwhale) instructions in the installation guide."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:38
msgid "Extract the downloaded archive to a new directory."
#: ../../administrator_documentation/upgrade_docs/debian.md:35
msgid "Follow the [Install the Funkwhale API](../installation_docs/debian.md#4-install-the-funkwhale-api) instructions in the installation guide."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:44
msgid "Remove the old `api` directory and move the extracted directory to the `api` directory."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:50
msgid "Remove the downloaded archive file."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:56
#: ../../administrator_documentation/upgrade_docs/debian.md:37
msgid "Update your Funkwhale instance"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:58
#: ../../administrator_documentation/upgrade_docs/debian.md:39
msgid "Once you have downloaded the new files, you can update your Funkwhale instance. To do this:"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:60
#: ../../administrator_documentation/upgrade_docs/debian.md:41
msgid "Install or upgrade all OS dependencies using the dependencies script."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:66
msgid "Enter the `api` directory to run the following commands."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:72
msgid "Install all Python dependencies using `poetry`."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:78
#: ../../administrator_documentation/upgrade_docs/debian.md:47
msgid "Collect the new static files to serve."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:84
#: ../../administrator_documentation/upgrade_docs/debian.md:53
msgid "Apply new database migrations."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:90
#: ../../administrator_documentation/upgrade_docs/debian.md:59
msgid "Restart the Funkwhale services."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/debian.md:96
#: ../../administrator_documentation/upgrade_docs/debian.md:65
msgid "That's it! You've updated your Funkwhale pod. You should now see the new version running in your web browser."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -21,7 +21,7 @@ msgid "Upgrade your Docker Funkwhale installation"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:3
msgid "If you installed Funkwhale following the [Docker guide](../installation_docs/docker), follow these steps to upgrade."
msgid "If you installed Funkwhale following the [Docker guide](../installation_docs/docker.md), follow these steps to upgrade."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:5
@ -49,69 +49,73 @@ msgid "Change the version number in your `.env` file. Update this to the same ve
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:32
msgid "Load the configuration from your `.env` file."
msgid "Log in as `su` to load the configuration from your `.env` file."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:38
#: ../../administrator_documentation/upgrade_docs/docker.md:39
msgid "Pull the updated containers."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:44
#: ../../administrator_documentation/upgrade_docs/docker.md:45
msgid "Apply the database migrations."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:50
#: ../../administrator_documentation/upgrade_docs/docker.md:51
msgid "Relaunch your containers."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:56
#: ../../administrator_documentation/upgrade_docs/docker.md:57
msgid "Exit the root shell."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:63
msgid "Thats it! Youve updated your Funkwhale pod. You should now see the new version running in your web browser."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:58
#: ../../administrator_documentation/upgrade_docs/docker.md:65
msgid "Upgrade the postgres container"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:60
#: ../../administrator_documentation/upgrade_docs/docker.md:67
msgid "Funkwhale depends on postgres for its database container. To upgrade postgres, you need to export your database and import it into the new container."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:62
#: ../../administrator_documentation/upgrade_docs/docker.md:69
msgid "To upgrade postgres on Docker we use the [`postgres-upgrade`](https://hub.docker.com/r/tianon/postgres-upgrade/) container. This Docker container automates the process of upgrading between major versions of postgres. Use these commands to upgrade your postgres container:"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:64
#: ../../administrator_documentation/upgrade_docs/docker.md:71
msgid "Export your current postgres version number. You can find this in your `docker-compose.yml` file."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:70
#: ../../administrator_documentation/upgrade_docs/docker.md:77
msgid "Export the major version number you want to upgrade to."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:76
#: ../../administrator_documentation/upgrade_docs/docker.md:83
msgid "Stop the postgres container. This means no data changes while you are upgrading."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:82
#: ../../administrator_documentation/upgrade_docs/docker.md:89
msgid "Run the migration using the `postgres-upgrade` container. This creates a new version of the database in the `/srv/funkwhale/data/postgres-new` directory."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:91
#: ../../administrator_documentation/upgrade_docs/docker.md:98
msgid "Re-add the access control rules required by Funkwhale."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:97
#: ../../administrator_documentation/upgrade_docs/docker.md:104
msgid "Swap your old database out with your new database."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:104
#: ../../administrator_documentation/upgrade_docs/docker.md:111
msgid "Pull the new postgres version."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:110
#: ../../administrator_documentation/upgrade_docs/docker.md:117
msgid "Restart your containers."
msgstr ""
#: ../../administrator_documentation/upgrade_docs/docker.md:116
#: ../../administrator_documentation/upgrade_docs/docker.md:123
msgid "That's it! Your Funkwhale pod is now running the new version of postgres. The old database is available in `/srv/funkwhale/data/postgres-old`. You can back this up and remove it from your server once you've confirmed everything is working."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,7 +16,6 @@ msgstr ""
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/upgrade_docs/index.md:11
#: ../../administrator_documentation/upgrade_docs/index.md:11
msgid "Prepare for the upgrade"
msgstr ""
@ -33,7 +32,6 @@ msgstr ""
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/index.md:21
#: ../../administrator_documentation/upgrade_docs/index.md:21
msgid "Choose your installation method"
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -21,7 +21,7 @@ msgid "Upgrade using the quick install script"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/quick_install.md:3
msgid "If you installed Funkwhale using the [quick install script](../installation_docs/quick_install), upgrading your instance is as simple as running the following command on your server:"
msgid "If you installed Funkwhale using the [quick install script](../installation_docs/quick_install.md), upgrading your instance is as simple as running the following command on your server:"
msgstr ""
#: ../../administrator_documentation/upgrade_docs/quick_install.md:9

View File

@ -1,25 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,173 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../contributor_documentation/documentation.md:1
msgid "Document Funkwhale"
msgstr ""
#: ../../contributor_documentation/documentation.md:4
msgid "If you notice something missing in our documentation but don't feel confident contributing, submit a request [in our forum](https://forum.funkwhale.audio/t/documentation)."
msgstr ""
#: ../../contributor_documentation/documentation.md:7
msgid "We try to document Funkwhale as thoroughly as possible to make it easy for users, admins, developers, and contributors to understand how everything works."
msgstr ""
#: ../../contributor_documentation/documentation.md:13
msgid "Requirements"
msgstr ""
#: ../../contributor_documentation/documentation.md:15
msgid "To work on Funkwhale's documentation, you need the following:"
msgstr ""
#: ../../contributor_documentation/documentation.md:17
msgid "[Git](https://git-scm.com): our version control system"
msgstr ""
#: ../../contributor_documentation/documentation.md:18
msgid "[Docker](https://docs.docker.com/engine/install/) and [Docker Compose](https://docs.docker.com/compose/install/): used to run our development environment"
msgstr ""
#: ../../contributor_documentation/documentation.md:19
msgid "A text editor of your choice"
msgstr ""
#: ../../contributor_documentation/documentation.md:21
msgid "Tooling"
msgstr ""
#: ../../contributor_documentation/documentation.md:23
msgid "We use [Sphinx](https://www.sphinx-doc.org/) to generate our documentation. Sphinx provides excellent tooling for documenting Python projects. We write documentation in Markdown using the [MyST parser](https://myst-parser.readthedocs.io/en/latest/) to access Sphinx's features."
msgstr ""
#: ../../contributor_documentation/documentation.md:25
msgid "All documentation in Funkwhale is stored in the [main Funkwhale Git repository](https://dev.funkwhale.audio/funkwhale/funkwhale/-/tree/develop/docs)."
msgstr ""
#: ../../contributor_documentation/documentation.md:27
msgid "Style guide"
msgstr ""
#: ../../contributor_documentation/documentation.md:29
msgid "We broadly follow the [Microsoft writing style guide](https://learn.microsoft.com/en-us/style-guide/welcome/) for language and tone. You should aim to keep your language simple and clear enough for readers of all levels. You can use a free tool like [Hemingway](https://hemingwayapp.com) to check the complexity of your sentences."
msgstr ""
#: ../../contributor_documentation/documentation.md:31
msgid "Here are some basic rules to follow:"
msgstr ""
#: ../../contributor_documentation/documentation.md:33
msgid "Write in American English"
msgstr ""
#: ../../contributor_documentation/documentation.md:34
msgid "Always use sentence casing for headers. For example: \"Contribute to Funkwhale documentation\" rather than \"Contribute To Funkwhale Documentation\""
msgstr ""
#: ../../contributor_documentation/documentation.md:35
msgid "Use contractions such as \"don't\" and \"can't\" to make your writing feel conversational. Only use the full words if you're trying to emphasize something"
msgstr ""
#: ../../contributor_documentation/documentation.md:37
msgid "Local setup"
msgstr ""
#: ../../contributor_documentation/documentation.md:39
msgid "We provide a docker container for our documentation to make it easy to work on docs with a real-time preview. Once you install [Docker](https://docs.docker.com/engine/install/) and [Docker Compose](https://docs.docker.com/compose/install/), do the following to get a live preview:"
msgstr ""
#: ../../contributor_documentation/documentation.md:41
msgid "Create a dummy `.env` file"
msgstr ""
#: ../../contributor_documentation/documentation.md:47
msgid "Create a dummy federation network"
msgstr ""
#: ../../contributor_documentation/documentation.md:53
msgid "Build the container"
msgstr ""
#: ../../contributor_documentation/documentation.md:59
msgid "Run the container"
msgstr ""
#: ../../contributor_documentation/documentation.md:65
msgid "A real-time preview of the documentation is available on `http://0.0.0.1:8001`"
msgstr ""
#: ../../contributor_documentation/documentation.md:67
msgid "Redirects"
msgstr ""
#: ../../contributor_documentation/documentation.md:69
msgid "If you move content to a new location, you need to set up a redirect. This ensures that any bookmarks or links posted before the change still take the user where they expect to go."
msgstr ""
#: ../../contributor_documentation/documentation.md:71
msgid "All redirects are stored in a {file}`redirects.txt` file. This is a simple text file containing one redirect per line. Each line contains the old URL and new URL as relative URLs."
msgstr ""
#: ../../contributor_documentation/documentation.md:73
msgid "In this example, the `architecture.html` file redirects to `https://docs.funkwhale.audio/developers/architecture.html`."
msgstr ""
#: ../../contributor_documentation/documentation.md:79
msgid "Contribution flow"
msgstr ""
#: ../../contributor_documentation/documentation.md:81
msgid "Here's an example of the typical workflow for creating documentation:"
msgstr ""
#: ../../contributor_documentation/documentation.md:83
msgid "[Create a fork](https://docs.gitlab.com/ee/user/project/repository/forking_workflow.html) of the Funkwhale codebase"
msgstr ""
#: ../../contributor_documentation/documentation.md:84
msgid "Create a new branch for your documentation. In this example `my-branch-name` is the name of the branch"
msgstr ""
#: ../../contributor_documentation/documentation.md:90
msgid "Make your changes and verify them by running the [Docker container](#local-setup)"
msgstr ""
#: ../../contributor_documentation/documentation.md:91
msgid "Add [redirects](#redirects) if required"
msgstr ""
#: ../../contributor_documentation/documentation.md:92
msgid "Add a [changelog fragment](../developer_documentation/workflows/changelog.md)"
msgstr ""
#: ../../contributor_documentation/documentation.md:93
msgid "Add your changed files to a commit"
msgstr ""
#: ../../contributor_documentation/documentation.md:100
msgid "Create a commit with a meaningful commit message"
msgstr ""
#: ../../contributor_documentation/documentation.md:106
msgid "Push your changes to your fork"
msgstr ""
#: ../../contributor_documentation/documentation.md:112
msgid "Create a merge request in the [main Funkwhale repository](https://dev.funkwhale.audio/funkwhale/funkwhale)"
msgstr ""

View File

@ -0,0 +1,45 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../contributor_documentation/index.md:1
msgid "Get started"
msgstr ""
#: ../../contributor_documentation/index.md:4
msgid "Are you a software developer? Check out our [developer documentation](../developer_documentation/index.md) to contribute to our codebase."
msgstr ""
#: ../../contributor_documentation/index.md:7
msgid "Funkwhale is a community-led software project, so we depend on our community donating their time and skills. Whether you're experienced in a specific field or just starting out, we welcome any contributions and will support you with any task you take on."
msgstr ""
#: ../../contributor_documentation/index.md:9
msgid "Contribute to Funkwhale's documentation"
msgstr ""
#: ../../contributor_documentation/index.md:11
msgid "Got a knack for writing? Want to teach people how things work? Our [documentation guide](documentation.md) takes you through everything you need to know to contribute to the Funkwhale documentation hub."
msgstr ""
#: ../../contributor_documentation/index.md:13
msgid "Translate Funkwhale"
msgstr ""
#: ../../contributor_documentation/index.md:15
msgid "Are you a confident linguist? We're always looking to expand the number of languages we offer in our apps, websites, and documentation. Check out the [translation guide](translation.md) to start contributing translations in your language."
msgstr ""

View File

@ -0,0 +1,89 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../contributor_documentation/translation.md:1
msgid "Translate Funkwhale"
msgstr ""
#: ../../contributor_documentation/translation.md:3
msgid "Funkwhale depends on community translations to provide a localized experience to all users. All of our UX copy and documentation is written in American English. This isn't accessible to all users."
msgstr ""
#: ../../contributor_documentation/translation.md:5
msgid "If you are interested in helping us reach more users, we welcome contributions in all languages!"
msgstr ""
#: ../../contributor_documentation/translation.md:7
msgid "Language coordination"
msgstr ""
#: ../../contributor_documentation/translation.md:9
msgid "Each language team requires a lead who can verify translations. You can see a list of languages and team leads [on our forum](https://forum.funkwhale.audio/d/107-coordinate-translations). If your language isn't available in our platform yet, reach out on the forum and we'll set it up."
msgstr ""
#: ../../contributor_documentation/translation.md:11
msgid "We can also create language-specific sections of the forum to enable users to discuss things in languages other than English. Language-specific sections require moderators who can enforce the code of conduct. If you're interested in moderating a language-specific section, let us know [on the forum](https://forum.funkwhale.audio/d/18-language-specific-communities)."
msgstr ""
#: ../../contributor_documentation/translation.md:13
msgid "Weblate"
msgstr ""
#: ../../contributor_documentation/translation.md:15
msgid "Funkwhale uses [Weblate](https://weblate.org) as its translation platform. Weblate provides an easy-to-use web frontend for submitting localized strings."
msgstr ""
#: ../../contributor_documentation/translation.md:17
msgid "To get started, sign up to our [Weblate instance](https://translate.funkwhale.audio) and follow the instructions to set up your language preferences. The following projects are available for translation:"
msgstr ""
#: ../../contributor_documentation/translation.md:19
msgid "Funkwhale: The Funkwhale web app"
msgstr ""
#: ../../contributor_documentation/translation.md:20
msgid "Funkwhale for Android: Our official Android app"
msgstr ""
#: ../../contributor_documentation/translation.md:21
msgid "Funkwhale.audio: Our website"
msgstr ""
#: ../../contributor_documentation/translation.md:22
msgid "Documentation: This documentation hub"
msgstr ""
#: ../../contributor_documentation/translation.md:24
msgid "Guidelines"
msgstr ""
#: ../../contributor_documentation/translation.md:26
msgid "We trust each language team to deliver translations that are tonally consistent with the source language. Where applicable, follow these guidelines:"
msgstr ""
#: ../../contributor_documentation/translation.md:28
msgid "Use gender-neutral language"
msgstr ""
#: ../../contributor_documentation/translation.md:29
msgid "Use informal speech patterns, including contractions"
msgstr ""
#: ../../contributor_documentation/translation.md:30
msgid "Use sentence case for all content, including titles. For example: \"Language coordination\" rather than \"Language Coordination\""
msgstr ""

View File

@ -0,0 +1,287 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/api/authentication.md:1
msgid "API authentication"
msgstr ""
#: ../../developer_documentation/api/authentication.md:3
msgid "Funkwhale uses the OAuth [authorization grant flow](https://tools.ietf.org/html/rfc6749#section-4.1) for external apps. This flow is a secure way to authenticate apps that requires a user's explicit consent to perform actions."
msgstr ""
#: ../../developer_documentation/api/authentication.md:27
msgid "Steps"
msgstr ""
#: ../../developer_documentation/api/authentication.md:32
msgid "1. Create an application"
msgstr ""
#: ../../developer_documentation/api/authentication.md:34
msgid "To connect to the Funkwhale API using OAuth, you need to create an **application**. This represents the entity credentials are related to."
msgstr ""
#: ../../developer_documentation/api/authentication.md:36
msgid "When creating an application you need to define the [**scopes**](https://www.rfc-editor.org/rfc/rfc6749#section-3.3) the application has access to. Scopes define what information your application can access. Each scope can be granted with the following rights:"
msgstr ""
#: ../../developer_documentation/api/authentication.md:38
msgid "`read:<scope>`: grants read-only access to the resource"
msgstr ""
#: ../../developer_documentation/api/authentication.md:39
msgid "`write:<scope>`: grants write-only access to the resource"
msgstr ""
#: ../../developer_documentation/api/authentication.md:41
msgid "`read` rights are required to fetch information using a `GET` request. All other actions (`POST`, `PATCH`, `PUT`, and `DELETE`) require `write` privileges. You may give an application **both** `read` and `write` access to any scope."
msgstr ""
#: ../../developer_documentation/api/authentication.md:47
msgid "Scope"
msgstr ""
#: ../../developer_documentation/api/authentication.md:48
msgid "Description"
msgstr ""
#: ../../developer_documentation/api/authentication.md:49
msgid "`read`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:50
#: ../../developer_documentation/api/authentication.md:52
msgid "Read-only access to all data"
msgstr ""
#: ../../developer_documentation/api/authentication.md:51
msgid "`write`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:53
msgid "`<read/write>:profile`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:54
msgid "Access to profile data (email address, username, etc.)"
msgstr ""
#: ../../developer_documentation/api/authentication.md:55
msgid "`<read/write>:libraries`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:56
msgid "Access to library data (uploads, libraries, tracks, albums, artists, etc.)"
msgstr ""
#: ../../developer_documentation/api/authentication.md:57
msgid "`<read/write>:favorites`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:58
msgid "Access to favorites"
msgstr ""
#: ../../developer_documentation/api/authentication.md:59
msgid "`<read/write>:listenings`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:60
msgid "Access to history"
msgstr ""
#: ../../developer_documentation/api/authentication.md:61
msgid "`<read/write>:follows`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:62
msgid "Access to followers"
msgstr ""
#: ../../developer_documentation/api/authentication.md:63
msgid "`<read/write>:playlists`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:64
msgid "Access to playlists"
msgstr ""
#: ../../developer_documentation/api/authentication.md:65
msgid "`<read/write>:radios`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:66
msgid "Access to radios"
msgstr ""
#: ../../developer_documentation/api/authentication.md:67
msgid "`<read/write>:filters`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:68
msgid "Access to content filters"
msgstr ""
#: ../../developer_documentation/api/authentication.md:69
msgid "`<read/write>:notifications`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:70
msgid "Access to notifications"
msgstr ""
#: ../../developer_documentation/api/authentication.md:71
msgid "`<read/write>:edits`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:72
msgid "Access to metadata edits"
msgstr ""
#: ../../developer_documentation/api/authentication.md:75
msgid "Next, you need to define a [**Redirect URI**](https://www.rfc-editor.org/rfc/rfc6749#section-3.1.2). This is the location the user is redirected to once they authenticate your app. This can be any URI you want."
msgstr ""
#: ../../developer_documentation/api/authentication.md:78
msgid "Funkwhale supports the `urn:ietf:wg:oauth:2.0:oob` redirect URI for non-web applications. If you use this URI, the user is shown a token to copy and paste."
msgstr ""
#: ../../developer_documentation/api/authentication.md:81
msgid "Once you've decided on your scopes and your redirect URI, you can create your app using one of the following methods:"
msgstr ""
#: ../../developer_documentation/api/authentication.md:83
msgid "Visit `/settings/applications/new` on your Funkwhale pod while logged in"
msgstr ""
#: ../../developer_documentation/api/authentication.md:84
msgid "Send a `POST` request to `/api/v1/oauth/apps`. See our [API documentation](https://docs.funkwhale.audio/swagger/) for more information"
msgstr ""
#: ../../developer_documentation/api/authentication.md:86
msgid "Both methods return a [**client ID**](https://www.rfc-editor.org/rfc/rfc6749#section-2.2) and a [**secret**](https://www.rfc-editor.org/rfc/rfc6749#section-2.3.1)."
msgstr ""
#: ../../developer_documentation/api/authentication.md:88
msgid "2. Get an authorization code"
msgstr ""
#: ../../developer_documentation/api/authentication.md:91
msgid "Authorization codes are only valid for 5 minutes after the user approves the request."
msgstr ""
#: ../../developer_documentation/api/authentication.md:94
msgid "You need an [**authorization code**](https://www.rfc-editor.org/rfc/rfc6749#section-1.3.1) to request an access token for your user. This code confirms to the server that a user has authorized access to their account."
msgstr ""
#: ../../developer_documentation/api/authentication.md:96
msgid "To fetch an authorization code, you need to send the user to their Funkwhale pod to authenticate. This sends an [authorization request](https://www.rfc-editor.org/rfc/rfc6749#section-4.1.2) to the server."
msgstr ""
#: ../../developer_documentation/api/authentication.md:98
msgid "To do this, call the `/authorize` endpoint with the following URL encoded query parameters:"
msgstr ""
#: ../../developer_documentation/api/authentication.md:100
msgid "`client_id`\\* - Your application's client ID"
msgstr ""
#: ../../developer_documentation/api/authentication.md:101
msgid "`response_type`\\* - Must be set to `code`."
msgstr ""
#: ../../developer_documentation/api/authentication.md:102
msgid "`redirect_uri` - Your redirect URI"
msgstr ""
#: ../../developer_documentation/api/authentication.md:103
#: ../../developer_documentation/api/authentication.md:135
msgid "`scope` - A list of scopes"
msgstr ""
#: ../../developer_documentation/api/authentication.md:104
msgid "`state` - Used to maintain state between the request and the callback to prevent cross-site request forgery. Typically corresponds with a location in the app (e.g. `/library`)"
msgstr ""
#: ../../developer_documentation/api/authentication.md:106
msgid "Here is an example URL: `https://demo.funkwhale.audio/authorize?response_type=code&scope=read%20write&redirect_uri=http%3A%2F%2Flocalhost%3A8080%2Fauth%2Fcallback&state=/library&client_id=jDOUfhqLlrbuOkToDCanZmBKEiyorMb9ZUgD2tFQ`."
msgstr ""
#: ../../developer_documentation/api/authentication.md:108
msgid "When the user authorizes your app, the server responds with an authorization code. See [the OAuth spec](https://www.rfc-editor.org/rfc/rfc6749#section-4.1.2) for more information about this response."
msgstr ""
#: ../../developer_documentation/api/authentication.md:110
msgid "3. Get an access token"
msgstr ""
#: ../../developer_documentation/api/authentication.md:112
msgid "Once you receive your authorization code, you need to [request an access token](https://www.rfc-editor.org/rfc/rfc6749#section-4.1.3). To request an access token, call the `/api/v1/oauth/token` endpoint with the following information:"
msgstr ""
#: ../../developer_documentation/api/authentication.md:114
msgid "`grant_type`\\* - Must be set to `authorization_code`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:115
msgid "`code`\\* - Your application's authorization code"
msgstr ""
#: ../../developer_documentation/api/authentication.md:116
msgid "`redirect_uri`\\* - Your redirect URI"
msgstr ""
#: ../../developer_documentation/api/authentication.md:117
msgid "`client_id`\\* Your application's client ID"
msgstr ""
#: ../../developer_documentation/api/authentication.md:119
msgid "The server responds with an [`access_token`](https://www.rfc-editor.org/rfc/rfc6749#section-1.4) and a [`refresh_token`](https://www.rfc-editor.org/rfc/rfc6749#section-1.5). See [the OAuth spec](https://www.rfc-editor.org/rfc/rfc6749#section-4.1.4) for more information about this response."
msgstr ""
#: ../../developer_documentation/api/authentication.md:121
msgid "You can use this token to authenticate calls from your application to the Funkwhale API by passing it as a request header with the following format: `Authorization: Bearer <token>`."
msgstr ""
#: ../../developer_documentation/api/authentication.md:123
msgid "4. Refresh your access token"
msgstr ""
#: ../../developer_documentation/api/authentication.md:126
msgid "When you refresh your token the endpoint returns a new `refresh_token`. You must update your refresh token each time you request a new access token."
msgstr ""
#: ../../developer_documentation/api/authentication.md:129
msgid "By default, Funkwhale access tokens are valid for **10 hours**. Pod admins can configure this by setting the `ACCESS_TOKEN_EXPIRE_SECONDS` variable in their `.env` file."
msgstr ""
#: ../../developer_documentation/api/authentication.md:131
msgid "After the access token expires, you must request a new access token by calling the `/api/v1/oauth/token` endpoint with the following information:"
msgstr ""
#: ../../developer_documentation/api/authentication.md:133
msgid "`grant_type`\\* - Must be set to `refresh_token`"
msgstr ""
#: ../../developer_documentation/api/authentication.md:134
msgid "`refresh_token`\\* - Your current refresh token"
msgstr ""
#: ../../developer_documentation/api/authentication.md:137
msgid "See [the OAuth spec](https://www.rfc-editor.org/rfc/rfc6749#section-6) for more information about this response."
msgstr ""

View File

@ -0,0 +1,37 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/api/index.md:7
msgid "API explorer"
msgstr ""
#: ../../developer_documentation/api/index.md:7
msgid "Resources"
msgstr ""
#: ../../developer_documentation/api/index.md:1
msgid "Funkwhale API"
msgstr ""
#: ../../developer_documentation/api/index.md:3
msgid "The Funkwhale API is a [REST API](https://developer.mozilla.org/en-US/docs/Glossary/REST) written in [Python](https://www.python.org/) using the [Django REST framework](https://www.django-rest-framework.org/). It is the central component of the project and houses the application's logic."
msgstr ""
#: ../../developer_documentation/api/index.md:5
msgid "The current API (v1) is **stable**, meaning we are committed to not introducing breaking changes and to maintaining compatibility. We are currently working on Funkwhale API v2, but this is a work in progress and not yet ready for production use."
msgstr ""

View File

@ -0,0 +1,165 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/api/rate_limit.md:1
msgid "Rate limiting"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:3
msgid "Funkwhale supports rate-limiting as of version 0.2.0. Pod admins can choose to rate limit specific endpoints to prevent abuse and improve the stability of the service. If the server drops a request due to rate-limiting, it returns a `429` status code."
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:5
msgid "By default, rate limits follow these rules:"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:7
msgid "Anonymous (unauthenticated) requests are subject to lower limits than authenticated requests"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:8
msgid "`PUT`, `DELETE`, `PUT`, `POST`, and `PATCH` requests are subject to lower limits than `GET` requests"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:10
msgid "You can return a full list of scope with their corresponding rate-limits by making a `GET` request to `/api/v1/rate-limit`."
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:12
msgid "HTTP headers"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:14
msgid "Each API call returns HTTP headers to pass the following information:"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:16
msgid "What was the scope of the request"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:17
msgid "What is the rate-limit associated with the request scope"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:18
msgid "How many more requests in the scope can be made within the rate-limit timeframe"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:19
msgid "How much time does the client need to wait to send another request"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:21
msgid "Here is a full list of supported headers"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:27
msgid "Header"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:28
msgid "Example value"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:29
msgid "Description"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:30
msgid "`X-RateLimit-Limit`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:31
msgid "50"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:32
msgid "The number of requests allowed within a given period"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:33
msgid "`X-RateLimit-Duration`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:34
msgid "3600"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:35
msgid "The time window, in seconds, during which the number of requests are measured"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:36
msgid "`X-RateLimit-Scope`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:37
msgid "`login`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:38
msgid "The name of the scope computed for the request"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:39
msgid "`X-RateLimit-Remaining`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:40
msgid "42"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:41
msgid "How many requests can be sent with the same scope before the rate-limit applies"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:42
msgid "`Retry-After`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:43
msgid "3543"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:44
msgid "How many seconds the client must wait before it can retry. Only applies if `X-RateLimit-Remaining` is `0`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:45
msgid "`X-RateLimit-Reset`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:46
msgid "1568126089"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:47
msgid "A timestamp indicating when the `X-RateLimit-Remaining` value will reset"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:48
msgid "`X-RateLimit-ResetSeconds`"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:49
msgid "3599"
msgstr ""
#: ../../developer_documentation/api/rate_limit.md:50
msgid "The number of seconds until the `X-RateLimit-Remaining` value resets"
msgstr ""

View File

@ -0,0 +1,198 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/api/subsonic.md:1
msgid "Subsonic API"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:3
msgid "Funkwhale supports a subset of the [Subsonic API's](http://www.subsonic.org/pages/api.jsp) endpoints. This enables users to listen to music stored on their Funkwhale pod through a Subsonic-compatible app."
msgstr ""
#: ../../developer_documentation/api/subsonic.md:5
msgid "We aim to support as many endpoints as we can to give Subsonic users the best possible experience. However, some endpoints require a folder-based endpoint. This doesn't match Funkwhale's internal structure, which means emulating them is difficult."
msgstr ""
#: ../../developer_documentation/api/subsonic.md:7
msgid "Supported endpoints"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:10
msgid "We aim to keep this list up-to-date. If you think something is missing, you can see all supported endpoints in the [API views](https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/subsonic/views.py)."
msgstr ""
#: ../../developer_documentation/api/subsonic.md:13
msgid "Funkwhale supports both XML and JSON formats for the following Subsonic endpoints:"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:15
msgid "[`createPlaylist`](http://www.subsonic.org/pages/api.jsp#createPlaylist)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:16
msgid "[`deletePlaylist`](http://www.subsonic.org/pages/api.jsp#deletePlaylist)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:17
msgid "[`getAlbum`](http://www.subsonic.org/pages/api.jsp#getAlbum)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:18
msgid "[`getAlbumList2`](http://www.subsonic.org/pages/api.jsp#getAlbumList2)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:19
msgid "[`getArtist`](http://www.subsonic.org/pages/api.jsp#getArtist)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:20
msgid "[`getArtistInfo2`](http://www.subsonic.org/pages/api.jsp#getArtistInfo2)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:21
msgid "[`getArtists`](http://www.subsonic.org/pages/api.jsp#getArtists)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:22
msgid "[`getAvatar`](http://www.subsonic.org/pages/api.jsp#getAvatar)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:23
msgid "[`getCoverArt`](http://www.subsonic.org/pages/api.jsp#getCoverArt)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:24
msgid "[`getIndexes`](http://www.subsonic.org/pages/api.jsp#getIndexes)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:25
msgid "[`getLicense`](http://www.subsonic.org/pages/api.jsp#getLicense)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:26
msgid "[`getMusicFolders`](http://www.subsonic.org/pages/api.jsp#getMusicFolders)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:27
msgid "[`getPlaylist`](http://www.subsonic.org/pages/api.jsp#getPlaylist)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:28
msgid "[`getPlaylists`](http://www.subsonic.org/pages/api.jsp#getPlaylists)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:29
msgid "[`getRandomSongs`](http://www.subsonic.org/pages/api.jsp#getRandomSongs)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:30
msgid "[`getSong`](http://www.subsonic.org/pages/api.jsp#getSong)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:31
msgid "[`getStarred`](http://www.subsonic.org/pages/api.jsp#getStarred)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:32
msgid "[`getStarred2`](http://www.subsonic.org/pages/api.jsp#getStarred2)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:33
msgid "[`getUser`](http://www.subsonic.org/pages/api.jsp#getUser)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:34
msgid "[`ping`](http://www.subsonic.org/pages/api.jsp#ping)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:35
msgid "[`scrobble`](http://www.subsonic.org/pages/api.jsp#scrobble)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:36
msgid "[`search3`](http://www.subsonic.org/pages/api.jsp#search3)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:37
msgid "[`star`](http://www.subsonic.org/pages/api.jsp#star)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:38
msgid "[`stream`](http://www.subsonic.org/pages/api.jsp#stream)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:39
msgid "[`unstar`](http://www.subsonic.org/pages/api.jsp#unstar)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:40
msgid "[`updatePlaylist`](http://www.subsonic.org/pages/api.jsp#updatePlaylist)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:42
msgid "Additional properties"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:44
msgid "Funkwhale returns some additional properties to Subsonic payloads. You can use these properties to adapt your client behavior if needed:"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:47
msgid "Property"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:48
msgid "Data type"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:49
msgid "Description"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:50
msgid "`type`"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:51
#: ../../developer_documentation/api/subsonic.md:54
msgid "String"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:52
msgid "The name of the app (`funkwhale`)"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:53
msgid "`funkwhaleVersion`"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:55
msgid "The Funkwhale version the pod is running"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:67
msgid "Test a Subsonic app"
msgstr ""
#: ../../developer_documentation/api/subsonic.md:69
msgid "We host a demo server at <https://demo.funkwhale.audio> which you can use to test your Subsonic app."
msgstr ""
#: ../../developer_documentation/api/subsonic.md:71
msgid "You can test the Subsonic API by logging in with a Subsonic client or by directly by calling an endpoint. For example, call this URL to test the `ping` endpoint: <https://demo.funkwhale.audio/rest/ping.view?f=json>"
msgstr ""

View File

@ -0,0 +1,197 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/architecture.md:1
msgid "Project architecture"
msgstr ""
#: ../../developer_documentation/architecture.md:3
msgid "Funkwhale is made up of several components. Understanding these components and what they do is important when contributing to Funkwhale's codebase. In this article, we'll break down each part of Funkwhale's architecture to help you understand what each component does."
msgstr ""
#: ../../developer_documentation/architecture.md:5
msgid "Below is a diagram of Funkwhale's project setup."
msgstr ""
#: ../../developer_documentation/architecture.md:29
msgid "Select a link below to see information about each component."
msgstr ""
#: ../../developer_documentation/architecture.md:35
msgid "Entrypoints"
msgstr ""
#: ../../developer_documentation/architecture.md:37
msgid "Users can access Funkwhale using a variety of entrypoints. They can make use of a Funkwhale application, a Subsonic-compatible application, or by calling the API directly. Each entrypoint interacts with the Funkwhale backend in the same way."
msgstr ""
#: ../../developer_documentation/architecture.md:39
msgid "Funkwhale web app"
msgstr ""
#: ../../developer_documentation/architecture.md:41
msgid "The Funkwhale web app is a {abbr}`SPA (Single Page Application)` written in [Vue.js](https://vuejs.org) and [Typescript](https://typescriptlang.org). This is the application most people associate with Funkwhale. Server admins usually run an instance of the web app alongside their Funkwhale {term}`pod`, but you can also connect a standalone web app to another pod."
msgstr ""
#: ../../developer_documentation/architecture.md:43
msgid "The Funkwhale web app interacts with the Funkwhale API to fetch and update data. Using a service worker, the web app caches important information for offline use."
msgstr ""
#: ../../developer_documentation/architecture.md:45
msgid "Funkwhale for Android"
msgstr ""
#: ../../developer_documentation/architecture.md:47
msgid "Funkwhale for Android is the Funkwhale collective's official Android app written in [Kotlin](https://kotlinlang.org/). It interacts with the Funkwhale API to fetch and update data and stores information for offline playback."
msgstr ""
#: ../../developer_documentation/architecture.md:49
msgid "Subsonic app"
msgstr ""
#: ../../developer_documentation/architecture.md:51
msgid "Funkwhale supports a limited subset of the [Subsonic API](http://www.subsonic.org/pages/api.jsp) to support existing Subsonic apps. These apps can request data stored on a Funkwhale server by calling these endpoints."
msgstr ""
#: ../../developer_documentation/architecture.md:53
msgid "Nginx/Apache reverse proxy"
msgstr ""
#: ../../developer_documentation/architecture.md:55
msgid "The reverse proxy acts as a layer between a Funkwhale pod and the open internet. It enhances the pod's security and provides additional options to help increase performance."
msgstr ""
#: ../../developer_documentation/architecture.md:57
msgid "When a user tries to communicate with a Funkwhale pod, the reverse proxy:"
msgstr ""
#: ../../developer_documentation/architecture.md:59
msgid "Handles the HTTP/HTTPS requests and proxies them to the Funkwhale API server"
msgstr ""
#: ../../developer_documentation/architecture.md:60
msgid "Serves requested static files, such as audio files and stylesheets"
msgstr ""
#: ../../developer_documentation/architecture.md:62
msgid "Backend"
msgstr ""
#: ../../developer_documentation/architecture.md:64
msgid "The Funkwhale backend is made up of a few components which are responsible for:"
msgstr ""
#: ../../developer_documentation/architecture.md:66
msgid "Communicating with the user's entrypoint and actioning requests"
msgstr ""
#: ../../developer_documentation/architecture.md:67
msgid "Maintaining data consistency"
msgstr ""
#: ../../developer_documentation/architecture.md:68
msgid "Communicating with other Funkwhale pods (if federation is enabled)"
msgstr ""
#: ../../developer_documentation/architecture.md:70
msgid "Django API server"
msgstr ""
#: ../../developer_documentation/architecture.md:72
msgid "The Funkwhale API is a [REST API](https://developer.mozilla.org/en-US/docs/Glossary/REST) written in [Python](https://www.python.org/) using the [Django REST framework](https://www.django-rest-framework.org/). It is the central piece of the project and houses the application's logic."
msgstr ""
#: ../../developer_documentation/architecture.md:74
msgid "The Funkwhale API is responsible for:"
msgstr ""
#: ../../developer_documentation/architecture.md:76
msgid "Fetching requested data from the cache/database and returning it to the requester in a meaningful way"
msgstr ""
#: ../../developer_documentation/architecture.md:77
msgid "Processing incoming data and writing it to the database in a meaningful way"
msgstr ""
#: ../../developer_documentation/architecture.md:78
msgid "Delegating long-running tasks to workers to reduce load"
msgstr ""
#: ../../developer_documentation/architecture.md:80
msgid "PostgreSQL database"
msgstr ""
#: ../../developer_documentation/architecture.md:82
msgid "Funkwhale uses a [PostgreSQL database](https://www.postgresql.org/) to store data. All information that is served by and sent to the Funkwhale API is stored in this database."
msgstr ""
#: ../../developer_documentation/architecture.md:84
msgid "The Funkwhale database makes heavy use of [indexes](https://www.postgresql.org/docs/current/indexes.html) for enhanced performance."
msgstr ""
#: ../../developer_documentation/architecture.md:86
msgid "Redis cache and message queue"
msgstr ""
#: ../../developer_documentation/architecture.md:88
msgid "Funkwhale uses [Redis](https://redis.io/) to cache information from the database and to store a queue of messages to send. We use this cache to avoid locking database resources and to speed up requests."
msgstr ""
#: ../../developer_documentation/architecture.md:90
msgid "Celery worker"
msgstr ""
#: ../../developer_documentation/architecture.md:92
msgid "Funkwhale has to handle a lot of tasks that take longer than the average HTTP request/response cycle. To ensure these tasks complete and don't impact the API's performance, they are offloaded to a [Celery](https://docs.celeryq.dev/en/stable/userguide/workers.html) task worker. The worker then works through all the tasks in its queue while the API handles real-time responses."
msgstr ""
#: ../../developer_documentation/architecture.md:94
msgid "Some common tasks the Celery worker handles are:"
msgstr ""
#: ../../developer_documentation/architecture.md:96
msgid "Importing uploaded music to the database"
msgstr ""
#: ../../developer_documentation/architecture.md:97
msgid "Handling [ActivityPub](https://www.w3.org/TR/activitypub/) messages from other {term}`Fediverse` servers"
msgstr ""
#: ../../developer_documentation/architecture.md:98
msgid "Scanning new content on remote pods"
msgstr ""
#: ../../developer_documentation/architecture.md:100
msgid "Celery beat task scheduler"
msgstr ""
#: ../../developer_documentation/architecture.md:102
msgid "In addition to handling tasks from the API, the Celery worker also needs to handle some recurring tasks. To manage these, we implement a [Celery beat](https://docs.celeryq.dev/en/stable/reference/celery.apps.beat.html#celery.apps.beat.Beat) scheduler. The scheduler is responsible for triggering tasks on a schedule and adding messages to the [queue](#redis-cache-and-message-queue) so the worker can work through them."
msgstr ""
#: ../../developer_documentation/architecture.md:104
msgid "Some common recurring tasks are:"
msgstr ""
#: ../../developer_documentation/architecture.md:106
msgid "Clearing the cache"
msgstr ""
#: ../../developer_documentation/architecture.md:107
msgid "Refreshing content metadata"
msgstr ""

View File

@ -0,0 +1,145 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/contribute/api.md:1
msgid "Contribute to the API"
msgstr ""
#: ../../developer_documentation/contribute/api.md:3
msgid "The Funkwhale API is the core of the Funkwhale ecosystem. It powers all actions in the Funkwhale app as well as other apps such as the CLI and mopidy plugin. The API is written in [Django rest framework](https://www.django-rest-framework.org/)."
msgstr ""
#: ../../developer_documentation/contribute/api.md:5
msgid "Before you start work on the API, you should open up a conversation in [the forum](https://forum.funkwhale.audio) to discuss the changes you want to make. All API changes need to be defined and scoped before code changes are made. If you are fixing a bug, you don't need to discuss this in the forum first."
msgstr ""
#: ../../developer_documentation/contribute/api.md:7
msgid "Each API endpoint is made up of the following:"
msgstr ""
#: ../../developer_documentation/contribute/api.md:9
msgid "Model defines the shape of data and how it is stored in the database"
msgstr ""
#: ../../developer_documentation/contribute/api.md:10
msgid "View defines what data is reflected by an endpoint"
msgstr ""
#: ../../developer_documentation/contribute/api.md:11
msgid "Serializer defines how data is serialized and deserialized by the endpoint"
msgstr ""
#: ../../developer_documentation/contribute/api.md:13
msgid "The API directory is structured as follows:"
msgstr ""
#: ../../developer_documentation/contribute/api.md:15
msgid "`config` contains the project settings, URL structure, and web server gateway information setup"
msgstr ""
#: ../../developer_documentation/contribute/api.md:16
msgid "`settings` contains all Django settings files"
msgstr ""
#: ../../developer_documentation/contribute/api.md:17
msgid "`funkwhale_api` contains the Funkwhale API logic"
msgstr ""
#: ../../developer_documentation/contribute/api.md:18
msgid "`pyproject.toml` contains the Python requirements"
msgstr ""
#: ../../developer_documentation/contribute/api.md:19
msgid "`tests` contains all tests. This directory matches the structure of the `funkwhale_api` directory"
msgstr ""
#: ../../developer_documentation/contribute/api.md:21
msgid "Write tests"
msgstr ""
#: ../../developer_documentation/contribute/api.md:23
msgid "You should write tests to ensure that your code does what you expect it to. We use [pytest](https://pytest.org) and [factory-boy](https://factoryboy.readthedocs.io) to power our API testing suite."
msgstr ""
#: ../../developer_documentation/contribute/api.md:25
msgid "Writing tests is outside the scope of this documentation, but here are some useful links to help you get started:"
msgstr ""
#: ../../developer_documentation/contribute/api.md:27
msgid "[A quick introduction to writing unit tests with pytest](https://semaphoreci.com/community/tutorials/testing-python-applications-with-pytest)"
msgstr ""
#: ../../developer_documentation/contribute/api.md:28
msgid "[A complete guide to Test-Driven Development](https://www.obeythetestinggoat.com/)"
msgstr ""
#: ../../developer_documentation/contribute/api.md:29
msgid "[pytest documentation](https://docs.pytest.org/en/latest)"
msgstr ""
#: ../../developer_documentation/contribute/api.md:30
msgid "[pytest-mock documentation](https://pypi.org/project/pytest-mock)"
msgstr ""
#: ../../developer_documentation/contribute/api.md:31
msgid "[factory-boy documentation](http://factoryboy.readthedocs.io)"
msgstr ""
#: ../../developer_documentation/contribute/api.md:33
msgid "Try to keep your tests small and focused. Each test should test a single function, so if you need to test multiple things you should write multiple tests."
msgstr ""
#: ../../developer_documentation/contribute/api.md:36
msgid "Test files must target a module and follow the `funkwhale_api` directory structure. If you write tests for `funkwhale_api/myapp/views.py`, you should put them in `tests/myapp/test_views.py`."
msgstr ""
#: ../../developer_documentation/contribute/api.md:39
msgid "We provide utilities and fixtures to make writing tests as easy as possible. You can see the list of available fixtures by running `sudo docker compose -f dev.yml run --rm api pytest --fixtures`."
msgstr ""
#: ../../developer_documentation/contribute/api.md:41
msgid "Factories"
msgstr ""
#: ../../developer_documentation/contribute/api.md:43
msgid "Each directory includes a `factories.py` file which contains factories for the models in the directory. You can use these to create arbitrary objects"
msgstr ""
#: ../../developer_documentation/contribute/api.md:76
msgid "Mocking"
msgstr ""
#: ../../developer_documentation/contribute/api.md:78
msgid "Use mocks to fake logic in your tests. This is useful when testing components that depend on one another."
msgstr ""
#: ../../developer_documentation/contribute/api.md:132
msgid "Run tests"
msgstr ""
#: ../../developer_documentation/contribute/api.md:134
msgid "You can run all tests in the pytest suite with the following command:"
msgstr ""
#: ../../developer_documentation/contribute/api.md:140
msgid "Run a specific test file by calling pytest against it:"
msgstr ""
#: ../../developer_documentation/contribute/api.md:146
msgid "You can check the full list of options by passing the `-h` flag:"
msgstr ""

View File

@ -0,0 +1,49 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/contribute/copy.md:1
msgid "Update UI copy"
msgstr ""
#: ../../developer_documentation/contribute/copy.md:4
msgid "Funkwhale is localized into several languages using [Weblate](https://translate.funkwhale.audio). You must make sure that any frontend strings are properly marked for localization. We use the [vue-i18n package](https://kazupon.github.io/vue-i18n/) to handle translation of frontend files."
msgstr ""
#: ../../developer_documentation/contribute/copy.md:7
msgid "All UI strings are stored in `front/locales/en.json` file. The file is structured to mimic the format of the repository. Each string should be labeled following the semantic naming for the item it applies to."
msgstr ""
#: ../../developer_documentation/contribute/copy.md:9
msgid "UI strings can be added to both the `<script>` and `<template>` part of a Vue file using following syntax:"
msgstr ""
#: ../../developer_documentation/contribute/copy.md:0
msgid "Locale file"
msgstr ""
#: ../../developer_documentation/contribute/copy.md:0
msgid "Script"
msgstr ""
#: ../../developer_documentation/contribute/copy.md:0
msgid "Template"
msgstr ""
#: ../../developer_documentation/contribute/copy.md:58
msgid "Some strings change depending on whether they are plural or not. You can create plural strings using the [vue-i18n pluralization syntax](https://kazupon.github.io/vue-i18n/guide/pluralization.html)"
msgstr ""

View File

@ -0,0 +1,77 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/contribute/frontend.md:1
msgid "Contribute to the frontend"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:3
msgid "The Funkwhale frontend is a {abbr}`SPA (Single Page Application)` written in [Typescript](https://typescriptlang.org) and [Vue.js](https://vuejs.org)."
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:5
msgid "Styles"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:7
msgid "We currently use [Fomantic UI](https://fomantic-ui.com) as our UI framework. We customize this with our own SCSS files located in `front/src/styles/_main.scss`."
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:9
msgid "We apply changes to the Fomantic CSS files before we import them:"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:11
msgid "We replace hardcoded color values with CSS variables to make themin easier. For example: `color: orange` is replaced by `color: var(--vibrant-color)`"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:12
msgid "We remove unused values from the CSS files to keep the size down"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:14
msgid "These changes are applied when you run `yarn install` through a `postinstall` hook. If you want to modify these changes, check the `front/scripts/fix-fomantic-css.py` script."
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:16
msgid "We plan to replace Fomantic with our own UI framework in the near future. Check our [Penpot](https://design.funkwhale.audio) to see what we've got planned."
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:18
msgid "Components"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:20
msgid "Our [component library](https://ui.funkwhale.audio) contains reusable Vue components that you can add to the Funkwhale frontend. If you want to add a new component, check out [the repository](https://dev.funkwhale.audio/funkwhale/vui)."
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:22
msgid "Testing"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:24
msgid "The Funkwhale frontend contains some tests to catch errors before changes go live. The coverage is still fairly low, so we welcome any contributions."
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:26
msgid "To run the test suite, run the following command:"
msgstr ""
#: ../../developer_documentation/contribute/frontend.md:32
msgid "To run tests as you make changes, launch the test suite with the `-w` flag:"
msgstr ""

View File

@ -0,0 +1,25 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/contribute/index.md:1
msgid "Contribute to the Funkwhale codebase"
msgstr ""
#: ../../developer_documentation/contribute/index.md:3
msgid "Funkwhale is an open source project, which means we welcome contributions from anyone! If you want to get involved with Funkwhale development, check the guides in this section."
msgstr ""

View File

@ -0,0 +1,823 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/federation/index.md:1
msgid "Funkwhale federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:4
msgid "We aim to keep this document up-to-date to reflect the current state of federation. If you notice an issue, please open a thread on [our forum](https://forum.funkwhale.audio/t/documentation)."
msgstr ""
#: ../../developer_documentation/federation/index.md:7
msgid "Funkwhale is a federated platform. Funkwhale pods can share information between one another, and can also communicate with other {term}`Fediverse` software. This article outlines which tools we use, our approach to federation, and how we implement standards."
msgstr ""
#: ../../developer_documentation/federation/index.md:14
msgid "Technologies and standards"
msgstr ""
#: ../../developer_documentation/federation/index.md:16
msgid "Funkwhale's federation is built on top of the following technologies:"
msgstr ""
#: ../../developer_documentation/federation/index.md:18
msgid "[`ActivityPub`](https://www.w3.org/TR/activitypub/): Our federation protocol"
msgstr ""
#: ../../developer_documentation/federation/index.md:19
msgid "[`HTTP Signatures`](https://www.ietf.org/archive/id/draft-ietf-httpbis-message-signatures-01.html): A library for authenticating messages sent over the federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:20
msgid "[`Webfinger`](https://tools.ietf.org/html/rfc7033): A protocol for discovering resources using readable names"
msgstr ""
#: ../../developer_documentation/federation/index.md:21
msgid "[`ActivityStreams`](https://www.w3.org/TR/activitystreams-core/) and [`ActivityStreams vocabulary`](https://www.w3.org/TR/activitystreams-vocabulary/): Our approach to structuring messages"
msgstr ""
#: ../../developer_documentation/federation/index.md:23
msgid "We plan for support [`JSON-LD signatures`](https://w3c-dvcg.github.io/ld-signatures/) in the future as an alternative to `HTTP Signatures`."
msgstr ""
#: ../../developer_documentation/federation/index.md:25
msgid "Our philosophy"
msgstr ""
#: ../../developer_documentation/federation/index.md:27
msgid "Funkwhale aims to align with the above specifications where possible to maintain compatibility with other ActivityPub-aware platforms. This documentation covers where we have departed from the specifications."
msgstr ""
#: ../../developer_documentation/federation/index.md:29
msgid "While we will always aim for compatibility with other services where it makes sense, Funkwhale to Funkwhale interaction is our focus. We use these standards to support activities and objects that fit in with our use cases, such as **follows** and **likes**."
msgstr ""
#: ../../developer_documentation/federation/index.md:31
#: ../../developer_documentation/federation/index.md:84
#: ../../developer_documentation/federation/index.md:126
#: ../../developer_documentation/federation/index.md:166
#: ../../developer_documentation/federation/index.md:206
#: ../../developer_documentation/federation/index.md:247
#: ../../developer_documentation/federation/index.md:293
msgid "Internal logic"
msgstr ""
#: ../../developer_documentation/federation/index.md:33
msgid "This section covers how we handle federation within the Funkwhale ecosystem."
msgstr ""
#: ../../developer_documentation/federation/index.md:35
msgid "Database schema"
msgstr ""
#: ../../developer_documentation/federation/index.md:37
msgid "We use ActivityPub entities as a guide when creating [our models](https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/models.py) and database schemas. This ensures compatibility with other ActivityPub projects."
msgstr ""
#: ../../developer_documentation/federation/index.md:39
msgid "Funkwhale pods store received activities payloads in the database before attempting to process or deliver them. This enables us to debug federation issues, resend messages, or process historical activities that weren't previously supported."
msgstr ""
#: ../../developer_documentation/federation/index.md:41
msgid "Funkwhale users are associated to an `Actor`. Remote and local actors are stord in the same database table. Any federated entities, such as uploads, are linked to the `Actor` rather than the user. We don't distinguish between local and remote users on the database level."
msgstr ""
#: ../../developer_documentation/federation/index.md:43
msgid "Activity creation and delivery"
msgstr ""
#: ../../developer_documentation/federation/index.md:45
msgid "Any action carried out by a local actor should trigger an `Activity`. This is the equivalent to posting an activity to an object. Funkwhale creates an object with the activity payload and stores it in the `Activity` table. Funkwhale triggers 2 types of deliveries:"
msgstr ""
#: ../../developer_documentation/federation/index.md:47
msgid "Local recipients: Funkwhale creates an `InboxItem` linked to the activity for each local recipient. Funkwhale then creates a feed of available inbox items for each local actor. Items in this feed have both a `Read` and `Unread` status to allow users to mark items as handled."
msgstr ""
#: ../../developer_documentation/federation/index.md:48
msgid "Remote recipients: Funkwhale collects the inboxes and shared inbox URLs of all remote recipients. Funkwhale then creates a `Delivery` object and linked to the initial activity and the inbox or shared inbox URL. The worker uses this `Delivery` object to post the activity to the correct inbox."
msgstr ""
#: ../../developer_documentation/federation/index.md:50
msgid "When a local inbox receives an activity from a remote actor, it ends up in their inbox for them to handle."
msgstr ""
#: ../../developer_documentation/federation/index.md:52
msgid "Funkwhale doesn't support all activities. Our routing logic enables the software to handle supported activities and discard unsupported ones. When Funkwhale receives an activity it checks if there is a route to handle it. If there is, Funkwhale calls a dedicated handler."
msgstr ""
#: ../../developer_documentation/federation/index.md:54
msgid "For example: if Funkwhale receives an [`activity-create`](#create) activity for an `object-audio` object, Funkwhale calls a handler to:"
msgstr ""
#: ../../developer_documentation/federation/index.md:56
msgid "Persist the data in the local `Upload` table"
msgstr ""
#: ../../developer_documentation/federation/index.md:57
msgid "Retrieve data associated with the audio"
msgstr ""
#: ../../developer_documentation/federation/index.md:59
msgid "You can find the code for our routing logic here:"
msgstr ""
#: ../../developer_documentation/federation/index.md:61
msgid "[Routing logic for activities](https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/routes.py)"
msgstr ""
#: ../../developer_documentation/federation/index.md:62
msgid "[Delivery logic for activities](https://dev.funkwhale.audio/funkwhale/funkwhale/blob/develop/api/funkwhale_api/federation/tasks.py)"
msgstr ""
#: ../../developer_documentation/federation/index.md:64
msgid "Service actor"
msgstr ""
#: ../../developer_documentation/federation/index.md:66
msgid "Funkwhale uses a dedicated service actor to send messages or authenticate fetches. This actor isn't associated to a user."
msgstr ""
#: ../../developer_documentation/federation/index.md:68
msgid "You can query a pod's nodeinfo endpoint to return the ID of the service actor in the `metadata > actorId` field. See the [API explorer](https://docs.funkwhale.audio/swagger/) for more information about this endpoint."
msgstr ""
#: ../../developer_documentation/federation/index.md:70
msgid "Funkwhale considers a pod's service actor to be an authoritative source for activities associated with **all** objects on its pod's domain. If the service actor sends an activity linked to an object on its domain, remote pods will recognize its authority."
msgstr ""
#: ../../developer_documentation/federation/index.md:72
msgid "Supported activities"
msgstr ""
#: ../../developer_documentation/federation/index.md:74
msgid "Follow"
msgstr ""
#: ../../developer_documentation/federation/index.md:76
msgid "A **follow** enables actors to access and retrieve content from other actors as soon as it updates."
msgstr ""
#: ../../developer_documentation/federation/index.md:0
msgid "Supported on"
msgstr ""
#: ../../developer_documentation/federation/index.md:80
msgid "[Library objects](#library)"
msgstr ""
#: ../../developer_documentation/federation/index.md:86
msgid "When Funkwhale receives a follow on a [library object](#library), it performs one of the following actions depending on the library's visibility:"
msgstr ""
#: ../../developer_documentation/federation/index.md:88
msgid "Automatically accept: If the library is public, Funkwhale automatically accepts the follow activity. Funkwhale sends a notification to the owner of the library and an [`Accept`](#accept) activity to the actor who sent the follow"
msgstr ""
#: ../../developer_documentation/federation/index.md:89
msgid "Accept request: If the library isn't public, Funkwhale sends a notification to the library owner. If the owner approves the request, Funkwhale sends an [`Accept`](#accept) activity to the actor who sent the follow"
msgstr ""
#: ../../developer_documentation/federation/index.md:91
msgid "Funkwhale uses the library follow status to grant access to the actor who sent the follow request. If the library isn't public and the owner doesn't send an approval, the requesting actor can't access the library's content."
msgstr ""
#: ../../developer_documentation/federation/index.md:93
#: ../../developer_documentation/federation/index.md:130
#: ../../developer_documentation/federation/index.md:170
#: ../../developer_documentation/federation/index.md:214
#: ../../developer_documentation/federation/index.md:255
#: ../../developer_documentation/federation/index.md:297
msgid "Checks"
msgstr ""
#: ../../developer_documentation/federation/index.md:95
msgid "Funkwhale ensures the activity is being sent to the library's owner before handling it."
msgstr ""
#: ../../developer_documentation/federation/index.md:97
#: ../../developer_documentation/federation/index.md:134
#: ../../developer_documentation/federation/index.md:174
#: ../../developer_documentation/federation/index.md:218
#: ../../developer_documentation/federation/index.md:264
#: ../../developer_documentation/federation/index.md:301
#: ../../developer_documentation/federation/index.md:392
#: ../../developer_documentation/federation/index.md:442
#: ../../developer_documentation/federation/index.md:501
#: ../../developer_documentation/federation/index.md:560
#: ../../developer_documentation/federation/index.md:627
msgid "Example"
msgstr ""
#: ../../developer_documentation/federation/index.md:99
msgid "In this example, **Alice** sends a follow activity for a [library object](#library) owned by **Bob**."
msgstr ""
#: ../../developer_documentation/federation/index.md:116
msgid "Accept"
msgstr ""
#: ../../developer_documentation/federation/index.md:118
msgid "The `Accept` activity sends a positive response, such as confirming a [`Follow` activity](#follow)."
msgstr ""
#: ../../developer_documentation/federation/index.md:122
msgid "`Activity` objects"
msgstr ""
#: ../../developer_documentation/federation/index.md:128
msgid "When Funkwhale receives an `Accept` activity related to a [`Follow`](#follow) activity, it marks the `Follow` as accepted in the database. If the `Follow` activity relates to a [`Library` object](#library), the requester receives future activities associated with the library. This includes [`Create`](#create), [`Audio`](#audio), and [`Delete`](#delete) activities. They can also browse and download the library's audio files. See the section on [Audio fetching on restricted libraries](#audio-fetching-on-restricted-libraries) for more details."
msgstr ""
#: ../../developer_documentation/federation/index.md:132
msgid "Funkwhale ensures the activity is sent by the library's owner before handling it."
msgstr ""
#: ../../developer_documentation/federation/index.md:136
msgid "In this example, **Bob** accepts a follow request from **Alice**."
msgstr ""
#: ../../developer_documentation/federation/index.md:158
msgid "Undo"
msgstr ""
#: ../../developer_documentation/federation/index.md:162
msgid "[`Follow` objects](#follow)"
msgstr ""
#: ../../developer_documentation/federation/index.md:168
msgid "When Funkwhale receives an `Undo` activity, it deletes the corresponding `Follow` from the database."
msgstr ""
#: ../../developer_documentation/federation/index.md:172
msgid "Funkwhale ensures the request actor is the same actor who sent the `Follow` activity before handling it."
msgstr ""
#: ../../developer_documentation/federation/index.md:176
msgid "In this example, **Alice** notifies **Bob** that she's undoing her follow."
msgstr ""
#: ../../developer_documentation/federation/index.md:198
msgid "Create"
msgstr ""
#: ../../developer_documentation/federation/index.md:202
#: ../../developer_documentation/federation/index.md:288
msgid "[`Audio` objects](#audio)"
msgstr ""
#: ../../developer_documentation/federation/index.md:209
msgid "See [the `Audio` object reference](#audio) for details on the object's structure."
msgstr ""
#: ../../developer_documentation/federation/index.md:212
msgid "When Funkwhale receives a `Create` activity with an [`Audio` object](#audio), it persists a local upload in the database. It then associates the upload to related library and track information. If no track matches the audio metadata, Funkwhale creates on using the `metadata` attribute in the object."
msgstr ""
#: ../../developer_documentation/federation/index.md:216
msgid "Funkwhale ensures the activity actor and library owner are the same before handling the activity. If the associated library has no local followers, Funkwhale discards the activity."
msgstr ""
#: ../../developer_documentation/federation/index.md:220
msgid "In this example, **Bob** creates new content in his library and sends a message to its followers."
msgstr ""
#: ../../developer_documentation/federation/index.md:238
msgid "Update"
msgstr ""
#: ../../developer_documentation/federation/index.md:242
#: ../../developer_documentation/federation/index.md:289
msgid "[`Library` objects](#library)"
msgstr ""
#: ../../developer_documentation/federation/index.md:243
msgid "[`Track` objects](#track)"
msgstr ""
#: ../../developer_documentation/federation/index.md:250
msgid "See [the `Track` object reference](#track) and [`Library` object reference](#library) for details on the object's structure."
msgstr ""
#: ../../developer_documentation/federation/index.md:253
msgid "When Funkwhale receives an update associated with a [`Library`](#library) or [`Track`](#track) object, it attempts to update the corresponding object in its database."
msgstr ""
#: ../../developer_documentation/federation/index.md:257
msgid "Funkwhale performs different checks depending on the target of the update:"
msgstr ""
#: ../../developer_documentation/federation/index.md:259
msgid "For [`Library`](#library) objects, Funkwhale ensures the actor sending the message is the library owner"
msgstr ""
#: ../../developer_documentation/federation/index.md:260
msgid "For [`Track`](#track) objects, Funkwhale ensures the actor sending the message **either**:"
msgstr ""
#: ../../developer_documentation/federation/index.md:261
msgid "Matches the [`attributedTo`](#attributedto) property on the local copy of the object"
msgstr ""
#: ../../developer_documentation/federation/index.md:262
msgid "Is the [service actor](#service-actor)"
msgstr ""
#: ../../developer_documentation/federation/index.md:266
msgid "In this example, **Bob** updates his library and sends a message to its followers."
msgstr ""
#: ../../developer_documentation/federation/index.md:284
msgid "Delete"
msgstr ""
#: ../../developer_documentation/federation/index.md:295
msgid "When Funkwhale receives a `Delete` activity, it deletes the associated object from the database."
msgstr ""
#: ../../developer_documentation/federation/index.md:299
msgid "Funkwhale ensures the actor initiating the activity is the owner of the associated object before handling it."
msgstr ""
#: ../../developer_documentation/federation/index.md:0
#: ../../developer_documentation/federation/index.md:518
msgid "Library"
msgstr ""
#: ../../developer_documentation/federation/index.md:308
msgid "In this example, **Bob** deletes a library and notifies its followers."
msgstr ""
#: ../../developer_documentation/federation/index.md:0
#: ../../developer_documentation/federation/index.md:576
msgid "Audio"
msgstr ""
#: ../../developer_documentation/federation/index.md:333
msgid "In this example, **Bob** deletes three audio objects in a library and notifies the library's followers."
msgstr ""
#: ../../developer_documentation/federation/index.md:361
msgid "Supported objects"
msgstr ""
#: ../../developer_documentation/federation/index.md:363
msgid "Artist"
msgstr ""
#: ../../developer_documentation/federation/index.md:365
msgid "An `Artist` is a custom object used to store musical artist and podcast creator information."
msgstr ""
#: ../../developer_documentation/federation/index.md:367
#: ../../developer_documentation/federation/index.md:408
#: ../../developer_documentation/federation/index.md:467
#: ../../developer_documentation/federation/index.md:526
#: ../../developer_documentation/federation/index.md:584
msgid "Properties"
msgstr ""
#: ../../developer_documentation/federation/index.md:372
#: ../../developer_documentation/federation/index.md:413
#: ../../developer_documentation/federation/index.md:472
#: ../../developer_documentation/federation/index.md:531
#: ../../developer_documentation/federation/index.md:589
msgid "Property"
msgstr ""
#: ../../developer_documentation/federation/index.md:373
#: ../../developer_documentation/federation/index.md:414
#: ../../developer_documentation/federation/index.md:473
#: ../../developer_documentation/federation/index.md:532
#: ../../developer_documentation/federation/index.md:590
msgid "Data type"
msgstr ""
#: ../../developer_documentation/federation/index.md:374
#: ../../developer_documentation/federation/index.md:415
#: ../../developer_documentation/federation/index.md:474
#: ../../developer_documentation/federation/index.md:533
#: ../../developer_documentation/federation/index.md:591
msgid "Description"
msgstr ""
#: ../../developer_documentation/federation/index.md:375
#: ../../developer_documentation/federation/index.md:416
#: ../../developer_documentation/federation/index.md:475
#: ../../developer_documentation/federation/index.md:534
#: ../../developer_documentation/federation/index.md:592
msgid "`type`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:376
#: ../../developer_documentation/federation/index.md:382
#: ../../developer_documentation/federation/index.md:417
#: ../../developer_documentation/federation/index.md:423
#: ../../developer_documentation/federation/index.md:476
#: ../../developer_documentation/federation/index.md:482
#: ../../developer_documentation/federation/index.md:535
#: ../../developer_documentation/federation/index.md:541
#: ../../developer_documentation/federation/index.md:556
#: ../../developer_documentation/federation/index.md:593
#: ../../developer_documentation/federation/index.md:599
msgid "String"
msgstr ""
#: ../../developer_documentation/federation/index.md:377
msgid "The object type (`Artist`)"
msgstr ""
#: ../../developer_documentation/federation/index.md:378
#: ../../developer_documentation/federation/index.md:419
#: ../../developer_documentation/federation/index.md:478
#: ../../developer_documentation/federation/index.md:537
#: ../../developer_documentation/federation/index.md:595
msgid "`id`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:379
#: ../../developer_documentation/federation/index.md:420
#: ../../developer_documentation/federation/index.md:479
#: ../../developer_documentation/federation/index.md:538
#: ../../developer_documentation/federation/index.md:544
#: ../../developer_documentation/federation/index.md:550
#: ../../developer_documentation/federation/index.md:553
#: ../../developer_documentation/federation/index.md:596
#: ../../developer_documentation/federation/index.md:611
msgid "String (URI)"
msgstr ""
#: ../../developer_documentation/federation/index.md:380
msgid "A URI that identifies the artist over federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:381
#: ../../developer_documentation/federation/index.md:422
#: ../../developer_documentation/federation/index.md:481
#: ../../developer_documentation/federation/index.md:540
#: ../../developer_documentation/federation/index.md:598
msgid "`name`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:383
msgid "The artist's name"
msgstr ""
#: ../../developer_documentation/federation/index.md:384
#: ../../developer_documentation/federation/index.md:428
#: ../../developer_documentation/federation/index.md:487
#: ../../developer_documentation/federation/index.md:613
msgid "`published`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:385
#: ../../developer_documentation/federation/index.md:429
#: ../../developer_documentation/federation/index.md:432
#: ../../developer_documentation/federation/index.md:488
#: ../../developer_documentation/federation/index.md:614
#: ../../developer_documentation/federation/index.md:617
msgid "Datetime"
msgstr ""
#: ../../developer_documentation/federation/index.md:386
#: ../../developer_documentation/federation/index.md:430
msgid "The date on which the artist was published over the federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:387
#: ../../developer_documentation/federation/index.md:434
#: ../../developer_documentation/federation/index.md:490
msgid "`musicbrainzId`"
msgstr ""
#: ../../developer_documentation/federation/index.md:388
#: ../../developer_documentation/federation/index.md:435
#: ../../developer_documentation/federation/index.md:491
msgid "String (UUID)"
msgstr ""
#: ../../developer_documentation/federation/index.md:389
msgid "The Musicbrainz artist ID"
msgstr ""
#: ../../developer_documentation/federation/index.md:404
msgid "Album"
msgstr ""
#: ../../developer_documentation/federation/index.md:406
msgid "An `Album` is a custom object used to store album and podcast series information."
msgstr ""
#: ../../developer_documentation/federation/index.md:418
msgid "The object type (`Album`)"
msgstr ""
#: ../../developer_documentation/federation/index.md:421
msgid "A URI that identifies the album over federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:424
msgid "The album's title"
msgstr ""
#: ../../developer_documentation/federation/index.md:425
#: ../../developer_documentation/federation/index.md:496
msgid "`artists`"
msgstr ""
#: ../../developer_documentation/federation/index.md:426
msgid "Array of strings"
msgstr ""
#: ../../developer_documentation/federation/index.md:427
msgid "A list of [`Artist` objects](#artist) associated with the albums"
msgstr ""
#: ../../developer_documentation/federation/index.md:431
msgid "`released`"
msgstr ""
#: ../../developer_documentation/federation/index.md:433
msgid "The date on which the album was released"
msgstr ""
#: ../../developer_documentation/federation/index.md:436
msgid "The Musicbrainz release ID"
msgstr ""
#: ../../developer_documentation/federation/index.md:437
msgid "`cover`"
msgstr ""
#: ../../developer_documentation/federation/index.md:438
#: ../../developer_documentation/federation/index.md:620
msgid "[`Link` object](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-link)"
msgstr ""
#: ../../developer_documentation/federation/index.md:439
msgid "A `Link` object representing the album cover"
msgstr ""
#: ../../developer_documentation/federation/index.md:463
msgid "Track"
msgstr ""
#: ../../developer_documentation/federation/index.md:465
msgid "A `Track` is a custom object used to store track information."
msgstr ""
#: ../../developer_documentation/federation/index.md:477
msgid "The object type (`Track`)"
msgstr ""
#: ../../developer_documentation/federation/index.md:480
msgid "A URI that identifies the track over federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:483
msgid "The track title"
msgstr ""
#: ../../developer_documentation/federation/index.md:484
msgid "`position`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:485
#: ../../developer_documentation/federation/index.md:547
#: ../../developer_documentation/federation/index.md:602
#: ../../developer_documentation/federation/index.md:605
#: ../../developer_documentation/federation/index.md:608
msgid "Integer"
msgstr ""
#: ../../developer_documentation/federation/index.md:486
msgid "The position of the track in the album"
msgstr ""
#: ../../developer_documentation/federation/index.md:489
msgid "The date on which the track was published over the federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:492
msgid "The Musicbrainz recording ID"
msgstr ""
#: ../../developer_documentation/federation/index.md:493
msgid "`album`"
msgstr ""
#: ../../developer_documentation/federation/index.md:494
msgid "[`Album` object](#album)"
msgstr ""
#: ../../developer_documentation/federation/index.md:495
msgid "The album that contains the track"
msgstr ""
#: ../../developer_documentation/federation/index.md:497
msgid "Array of [`Artist` objects](#artist)"
msgstr ""
#: ../../developer_documentation/federation/index.md:498
msgid "A list of artists associated to the track. This can differ from the album artists"
msgstr ""
#: ../../developer_documentation/federation/index.md:521
msgid "Crawling library pages requires authentication and an approved follow unless the library is public."
msgstr ""
#: ../../developer_documentation/federation/index.md:524
msgid "A `Library` is a custom object used to store music collection information. It inherits its behavior and properties from ActivityPub's [`Actor`](https://www.w3.org/TR/activitypub/#actors) and [`Collection`](https://www.w3.org/TR/activitypub/#collections) objects."
msgstr ""
#: ../../developer_documentation/federation/index.md:536
msgid "The object type (`Library`)"
msgstr ""
#: ../../developer_documentation/federation/index.md:539
msgid "A URI that identifies the library over federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:542
msgid "The library's name"
msgstr ""
#: ../../developer_documentation/federation/index.md:543
msgid "`followers`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:545
msgid "The ID of the library's followers collection"
msgstr ""
#: ../../developer_documentation/federation/index.md:546
msgid "`totalItems`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:548
msgid "The number of [`Audio` objects](#audio) in the library"
msgstr ""
#: ../../developer_documentation/federation/index.md:549
msgid "`first`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:551
msgid "The URL of the library's first page"
msgstr ""
#: ../../developer_documentation/federation/index.md:552
msgid "`last`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:554
msgid "The URL of the library's last page"
msgstr ""
#: ../../developer_documentation/federation/index.md:555
msgid "`summary`"
msgstr ""
#: ../../developer_documentation/federation/index.md:557
msgid "The library's description"
msgstr ""
#: ../../developer_documentation/federation/index.md:579
msgid "Accessing audio files requires authentication and an approved follow for the containing library unless the library is public."
msgstr ""
#: ../../developer_documentation/federation/index.md:582
msgid "An `Audio` object is a custom object used to store upload information. It extends the [ActivityStreams Audio object](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-audio) with custom attributes."
msgstr ""
#: ../../developer_documentation/federation/index.md:594
msgid "The object type (`Audio`)"
msgstr ""
#: ../../developer_documentation/federation/index.md:597
msgid "A URI that identifies the audio over federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:600
msgid "A readable title for the order. Funkwhale concatenates the track name, album title, and artist name"
msgstr ""
#: ../../developer_documentation/federation/index.md:601
msgid "`size`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:603
msgid "The size of the audio in bytes"
msgstr ""
#: ../../developer_documentation/federation/index.md:604
msgid "`bitrate`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:606
msgid "The bitrate of the audio in bytes/s"
msgstr ""
#: ../../developer_documentation/federation/index.md:607
msgid "`duration`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:609
msgid "The duration of the audio in seconds"
msgstr ""
#: ../../developer_documentation/federation/index.md:610
msgid "`library`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:612
msgid "The ID of the audio's containing [`Library` object](#library)"
msgstr ""
#: ../../developer_documentation/federation/index.md:615
msgid "The date on which the audio was published over the federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:616
msgid "`updated`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:618
msgid "The date on which the audio was last updated over the federation"
msgstr ""
#: ../../developer_documentation/federation/index.md:619
msgid "`url`*"
msgstr ""
#: ../../developer_documentation/federation/index.md:621
msgid "A `Link` object object containing the download location of the audio file"
msgstr ""
#: ../../developer_documentation/federation/index.md:622
msgid "`track`"
msgstr ""
#: ../../developer_documentation/federation/index.md:623
msgid "[`Track` object](#track)"
msgstr ""
#: ../../developer_documentation/federation/index.md:624
msgid "The track associated with the audio file"
msgstr ""
#: ../../developer_documentation/federation/index.md:649
msgid "Audio fetching on restricted libraries"
msgstr ""
#: ../../developer_documentation/federation/index.md:651
msgid "[`Library` objects](#library) and [`Audio` objects] are subject to the following access rules:"
msgstr ""
#: ../../developer_documentation/federation/index.md:658
msgid "Public libraries can be accessed by actors without restriction"
msgstr ""
#: ../../developer_documentation/federation/index.md:659
msgid "Restricted libraries can only be accessed if the HTTP request is signed by an actor who has an associated **approved** [`Follow` activity](#follow)"
msgstr ""
#: ../../developer_documentation/federation/index.md:665
msgid "Audio items in public libraries can be accessed by actors without restriction"
msgstr ""
#: ../../developer_documentation/federation/index.md:666
msgid "Audio items in restricted libraries can only be accessed if the HTTP request is signed by an actor who has an associated **approved** [`Follow` activity](#follow)"
msgstr ""
#: ../../developer_documentation/federation/index.md:671
msgid "Custom properties"
msgstr ""
#: ../../developer_documentation/federation/index.md:673
msgid "attributedTo"
msgstr ""
#: ../../developer_documentation/federation/index.md:675
msgid "Funkwhale uses the `attributedTo` property to denote the actor responsible for an object. If an object has an `attributedTo` attributed, the associated actor can perform activities to it, including [`Update`](#update) and [`Delete`](#delete)."
msgstr ""
#: ../../developer_documentation/federation/index.md:677
msgid "Funkwhale also attributes all objects on a domain with the domain's [Service actor](#service-actor)"
msgstr ""

View File

@ -0,0 +1,49 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/index.md:1
msgid "Get started"
msgstr ""
#: ../../developer_documentation/index.md:3
msgid "Funkwhale welcomes contributions from all developers. If this is your first time contributing to an open source project, don't be afraid to get stuck in! The Funkwhale community will guide you through the process and help you grow your confidence."
msgstr ""
#: ../../developer_documentation/index.md:5
msgid "Set up your development environment"
msgstr ""
#: ../../developer_documentation/index.md:7
msgid "Before you begin, you need to set up a development environment. Follow the [guides in the setup section](setup/index.md) to set up an environment that's right for you."
msgstr ""
#: ../../developer_documentation/index.md:9
msgid "Read up on our processes"
msgstr ""
#: ../../developer_documentation/index.md:11
msgid "The Funkwhale project follows a few processes to make managing contributions easier. If you're not sure how to get started, check out the [guides in the workflows section](workflows/index.md) to get a better understanding of what you need to do."
msgstr ""
#: ../../developer_documentation/index.md:13
msgid "Contribute to the codebase"
msgstr ""
#: ../../developer_documentation/index.md:15
msgid "Ready to get stuck in? Take a look at the [contribution guides](contribute/index.md) and start making your changes!"
msgstr ""

View File

@ -0,0 +1,284 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/plugins/create.md:1
msgid "Write a plugin"
msgstr ""
#: ../../developer_documentation/plugins/create.md:3
msgid "You can write plugins to extend the features of your Funkwhale pod. Follow the instructions in this guide to get started with your first plugin."
msgstr ""
#: ../../developer_documentation/plugins/create.md:10
msgid "Before you begin"
msgstr ""
#: ../../developer_documentation/plugins/create.md:12
msgid "Before you start writing your plugin, you need to understand the following core concepts:"
msgstr ""
#: ../../developer_documentation/plugins/create.md:19
msgid "We'll explain each of these concepts in the next few sections"
msgstr ""
#: ../../developer_documentation/plugins/create.md:21
msgid "Scopes"
msgstr ""
#: ../../developer_documentation/plugins/create.md:23
msgid "Plugins fall into two different **scopes**:"
msgstr ""
#: ../../developer_documentation/plugins/create.md:25
msgid "User-level plugins that are configured by end-users for their own use"
msgstr ""
#: ../../developer_documentation/plugins/create.md:26
msgid "Pod-level plugins that are configured by pod admins and are not connected to a particular user"
msgstr ""
#: ../../developer_documentation/plugins/create.md:28
msgid "User-level plugins can also be used to import files from a third-party service, such as cloud storage or FTP."
msgstr ""
#: ../../developer_documentation/plugins/create.md:30
msgid "Hooks"
msgstr ""
#: ../../developer_documentation/plugins/create.md:32
msgid "**Hooks** are entrypoints that allow your plugin to listen to changes. You can create hooks to react to different events that occur in the Funkwhale application."
msgstr ""
#: ../../developer_documentation/plugins/create.md:34
msgid "An example of this can be seen in our Scrobbler plugin. We register a `LISTENING_CREATED` hook to notify any registered callback function when a listening is recorded. When a user listens to a track, the `notfy_lastfm` function fires."
msgstr ""
#: ../../developer_documentation/plugins/create.md:45
msgid "Available hooks"
msgstr ""
#: ../../docstring of config.plugins.LISTENING_CREATED:1
msgid "Called when a track is being listened"
msgstr ""
#: ../../developer_documentation/plugins/create.md:51
msgid "Filters"
msgstr ""
#: ../../developer_documentation/plugins/create.md:53
msgid "**Filters** are entrypoints that allow you to modify or add information. When you use the `register_filter` decorator, your function should return a value to be used by the server."
msgstr ""
#: ../../developer_documentation/plugins/create.md:55
msgid "In this example, the `PLUGINS_DEPENDENCIES` filter is used to install additional dependencies required by your plugin. The `dependencies` function returns the additional dependency `django_prometheus` to request the dependency be installed by the server."
msgstr ""
#: ../../developer_documentation/plugins/create.md:68
msgid "Available filters"
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 ""
#: ../../developer_documentation/plugins/create.md:78
msgid "Write your plugin"
msgstr ""
#: ../../developer_documentation/plugins/create.md:80
msgid "Once you know what type of plugin you want to write and what entrypoint you want to use, you can start writing your plugin."
msgstr ""
#: ../../developer_documentation/plugins/create.md:82
msgid "Plugins are made up of the following 3 files:"
msgstr ""
#: ../../developer_documentation/plugins/create.md:84
msgid "`__init__.py` - indicates that the directory is a Python package"
msgstr ""
#: ../../developer_documentation/plugins/create.md:85
msgid "`funkwhale_startup.py` - the file that loads during Funkwhale initialization"
msgstr ""
#: ../../developer_documentation/plugins/create.md:86
msgid "`funkwhale_ready.py` - the file that loads when Funkwhale is configured and ready"
msgstr ""
#: ../../developer_documentation/plugins/create.md:88
msgid "Declare your plugin"
msgstr ""
#: ../../developer_documentation/plugins/create.md:90
msgid "You need to declare your plugin and its configuration options so that Funkwhale knows how to load the plugin. To do this, you must declare a new `plugins` instance in your `funkwhale_startup.py` file."
msgstr ""
#: ../../developer_documentation/plugins/create.md:92
msgid "Your `plugins` should include the following information:"
msgstr ""
#: ../../developer_documentation/plugins/create.md:98
msgid "Parameter"
msgstr ""
#: ../../developer_documentation/plugins/create.md:99
msgid "Data type"
msgstr ""
#: ../../developer_documentation/plugins/create.md:100
msgid "Description"
msgstr ""
#: ../../developer_documentation/plugins/create.md:101
msgid "`name`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:102
#: ../../developer_documentation/plugins/create.md:105
#: ../../developer_documentation/plugins/create.md:108
#: ../../developer_documentation/plugins/create.md:111
msgid "String"
msgstr ""
#: ../../developer_documentation/plugins/create.md:103
msgid "The name of your plugin, used in the `.env` file"
msgstr ""
#: ../../developer_documentation/plugins/create.md:104
msgid "`label`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:106
msgid "The readable label that appears in the Funkwhale frontend"
msgstr ""
#: ../../developer_documentation/plugins/create.md:107
msgid "`description`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:109
msgid "A meaningful description of your plugin and what it does"
msgstr ""
#: ../../developer_documentation/plugins/create.md:110
msgid "`version`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:112
msgid "The version number of your plugin"
msgstr ""
#: ../../developer_documentation/plugins/create.md:113
msgid "`user`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:114
msgid "Boolean"
msgstr ""
#: ../../developer_documentation/plugins/create.md:115
msgid "Whether the plugin is a **user-level** plugin or a **pod-level** plugin. See [scopes](#scopes) for more information"
msgstr ""
#: ../../developer_documentation/plugins/create.md:116
msgid "`conf`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:117
msgid "Array of Objects"
msgstr ""
#: ../../developer_documentation/plugins/create.md:118
msgid "A list of configuration options"
msgstr ""
#: ../../developer_documentation/plugins/create.md:121
msgid "In this example, we declare a new **user-level** plugin called \"My Plugin\". The user can configure a `greeting` in the plugin configuration."
msgstr ""
#: ../../developer_documentation/plugins/create.md:140
msgid "Write your plugin logic"
msgstr ""
#: ../../developer_documentation/plugins/create.md:142
msgid "Once you've declared your plugin, you can write the plugin code in your `funkwhale_ready.py` file."
msgstr ""
#: ../../developer_documentation/plugins/create.md:145
msgid "You must import your plugin declaration from your `funkwhale_startup.py` file."
msgstr ""
#: ../../developer_documentation/plugins/create.md:148
msgid "In this example, we create a simple API endpoint that returns a greeting to the user. To do this:"
msgstr ""
#: ../../developer_documentation/plugins/create.md:150
msgid "We create a new APIView class that accepts a `GET` request"
msgstr ""
#: ../../developer_documentation/plugins/create.md:151
msgid "We read the greeting value from the plugin `conf`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:152
msgid "We return the greeting value with the user's username"
msgstr ""
#: ../../developer_documentation/plugins/create.md:153
msgid "We register this view at the endpoint `/greeting`"
msgstr ""
#: ../../developer_documentation/plugins/create.md:193
msgid "Result"
msgstr ""
#: ../../developer_documentation/plugins/create.md:195
msgid "Here is an example of how the above plugin works:"
msgstr ""
#: ../../developer_documentation/plugins/create.md:197
msgid "User \"Harry\" enables the plugin"
msgstr ""
#: ../../developer_documentation/plugins/create.md:198
msgid "\"Harry\" changes the greeting to \"You're a wizard\""
msgstr ""
#: ../../developer_documentation/plugins/create.md:199
msgid "\"Harry\" visits the `/greeting` endpoint in their browser"
msgstr ""
#: ../../developer_documentation/plugins/create.md:200
msgid "The browser returns the message \"You're a wizard Harry\""
msgstr ""

View File

@ -0,0 +1,33 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/plugins/index.md:7
msgid "Resources"
msgstr ""
#: ../../developer_documentation/plugins/index.md:1
msgid "Funkwhale plugins"
msgstr ""
#: ../../developer_documentation/plugins/index.md:3
msgid "Plugins can be used to extend Funkwhale's featureset without needing to touch the underlying code. Plugins can extend existing features, add support for third-party services, or introduce cosmetic changes to the Funkwhale webapp."
msgstr ""
#: ../../developer_documentation/plugins/index.md:5
msgid "Plugins have been supported since Funkwhale 1.0. Some core plugins, such as the standard Scrobbler plugin, are maintained by the Funkwhale team."
msgstr ""

View File

@ -0,0 +1,67 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/plugins/install.md:1
msgid "Install a plugin"
msgstr ""
#: ../../developer_documentation/plugins/install.md:3
msgid "Once you have [created your plugin](create.md), you can install it on your Funkwhale pod."
msgstr ""
#: ../../developer_documentation/plugins/install.md:5
msgid "Install a local plugin"
msgstr ""
#: ../../developer_documentation/plugins/install.md:7
msgid "To install a plugin located on your server:"
msgstr ""
#: ../../developer_documentation/plugins/install.md:9
msgid "Add the plugin directory to the `FUNKWHALE_PLUGINS_PATH` variable in your `.env` file"
msgstr ""
#: ../../developer_documentation/plugins/install.md:10
#: ../../developer_documentation/plugins/install.md:22
msgid "Add the plugin name to the `FUNKWHALE_PLUGINS` variable in your `.env` file"
msgstr ""
#: ../../developer_documentation/plugins/install.md:16
#: ../../developer_documentation/plugins/install.md:50
msgid "Restart Funkwhale to pick up the changes"
msgstr ""
#: ../../developer_documentation/plugins/install.md:18
msgid "Install a third-party plugin"
msgstr ""
#: ../../developer_documentation/plugins/install.md:20
msgid "You can install third-party plugins using the `funkwhale-manage` command line interface. To do this:"
msgstr ""
#: ../../developer_documentation/plugins/install.md:28
msgid "Call the `funkwhale-manage` command line interface with the location of the plugin archive"
msgstr ""
#: ../../developer_documentation/plugins/install.md:0
msgid "Debian"
msgstr ""
#: ../../developer_documentation/plugins/install.md:0
msgid "Docker"
msgstr ""

View File

@ -0,0 +1,197 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/setup/docker.md:1
msgid "Develop using Docker"
msgstr ""
#: ../../developer_documentation/setup/docker.md:3
msgid "Funkwhale can be run in Docker containers for local development. You can work on any part of the Funkwhale codebase and run the container setup to test your changes. To work with Docker:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:5
msgid "[Install Docker](https://docs.docker.com/install)"
msgstr ""
#: ../../developer_documentation/setup/docker.md:6
msgid "[Install docker compose](https://docs.docker.com/compose/install)"
msgstr ""
#: ../../developer_documentation/setup/docker.md:7
msgid "Clone the Funkwhale repository to your system. The `develop` branch is checked out by default"
msgstr ""
#: ../../developer_documentation/setup/docker.md:0
msgid "SSH"
msgstr ""
#: ../../developer_documentation/setup/docker.md:0
msgid "HTTPS"
msgstr ""
#: ../../developer_documentation/setup/docker.md:31
msgid "Set up your Docker environment"
msgstr ""
#: ../../developer_documentation/setup/docker.md:35
msgid "Funkwhale provides a `dev.yml` file that contains the required docker compose setup. You need to pass the `-f dev.yml` flag you run docker compose commands to ensure it uses this file. If you don't want to add this each time, you can export it as a `COMPOSE_FILE` variable:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:43
msgid "To set up your Docker environment:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:45
msgid "Create a `.env` file to enable customization of your setup."
msgstr ""
#: ../../developer_documentation/setup/docker.md:51
msgid "Add the following variables to load images and enable access to Django admin pages:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:58
msgid "Create a network for federation support"
msgstr ""
#: ../../developer_documentation/setup/docker.md:64
msgid "Once you've set everything up, you need to build the containers. Run this command any time there are upstream changes or dependency changes to ensure you're up-to-date."
msgstr ""
#: ../../developer_documentation/setup/docker.md:70
msgid "Set up the database"
msgstr ""
#: ../../developer_documentation/setup/docker.md:72
msgid "Funkwhale relies on a postgresql database to store information. To set this up, you need to run the `funkwhale-manage migrate` command:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:78
msgid "This command creates all the required tables. You need to run this whenever there are changes to the API schema. You can run this at any time without causing issues."
msgstr ""
#: ../../developer_documentation/setup/docker.md:80
msgid "Set up local data"
msgstr ""
#: ../../developer_documentation/setup/docker.md:82
msgid "You need to create some local data to mimic a production environment."
msgstr ""
#: ../../developer_documentation/setup/docker.md:84
msgid "Create a superuser so you can log in to your local app:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:90
msgid "Add some fake data to populate the database. The following command creates 25 artists with random albums, tracks, and metadata."
msgstr ""
#: ../../developer_documentation/setup/docker.md:98
msgid "Manage services"
msgstr ""
#: ../../developer_documentation/setup/docker.md:100
msgid "Once you have set up your containers, bring them up to start working on them."
msgstr ""
#: ../../developer_documentation/setup/docker.md:102
msgid "Compile the translations:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:108
msgid "Launch all services:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:114
msgid "This gives you access to the following:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:116
msgid "The Funkwhale webapp on `http://localhost:8000`"
msgstr ""
#: ../../developer_documentation/setup/docker.md:117
msgid "The Funkwhale API on `http://localhost:8000/api/v1`"
msgstr ""
#: ../../developer_documentation/setup/docker.md:118
msgid "The Django admin interface on `http://localhost:8000/api/admin`"
msgstr ""
#: ../../developer_documentation/setup/docker.md:120
msgid "Once you're done with the containers, you can stop them all:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:126
msgid "If you want to destroy your containers, run the following:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:132
msgid "Set up federation support"
msgstr ""
#: ../../developer_documentation/setup/docker.md:134
msgid "Working on federation features requires some additional setup. You need to do the following:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:136
msgid "Update your DNS resolver to resolve all your .dev hostnames locally"
msgstr ""
#: ../../developer_documentation/setup/docker.md:137
msgid "Set up a reverse proxy (such as traefik) to catch .dev requests with a TLS certificate"
msgstr ""
#: ../../developer_documentation/setup/docker.md:138
msgid "Set up two or more local instances"
msgstr ""
#: ../../developer_documentation/setup/docker.md:140
msgid "To resolve hostnames locally, run the following:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:0
msgid "dnsmasq"
msgstr ""
#: ../../developer_documentation/setup/docker.md:0
msgid "NetworkManager"
msgstr ""
#: ../../developer_documentation/setup/docker.md:164
msgid "To add a wildcard certificate, copy the test certificate from the `docker/ssl` folder. This certificate is a wildcard for `*.funkwhale.test`"
msgstr ""
#: ../../developer_documentation/setup/docker.md:171
msgid "To run a reverse proxy for your app:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:173
msgid "Add the following configuration to your `.env` file:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:186
msgid "Launch traefik using the bundled configuration:"
msgstr ""
#: ../../developer_documentation/setup/docker.md:192
msgid "Set up as many different projects as you need. Make sure the `COMPOSE_PROJECT_NAME` and `VUE_PORT` variables are unique per instance"
msgstr ""
#: ../../developer_documentation/setup/docker.md:202
msgid "You can access your project at `https://{COMPOSE_PROJECT_NAME}.funkwhale.test`."
msgstr ""

View File

@ -0,0 +1,182 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/setup/gitpod.md:1
msgid "Develop using Gitpod"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:4
msgid "You need a GitHub or GitLab.com account to log in to Gitpod."
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:7
msgid "Funkwhale has a Gitpod instance that gives you all the tools you need to work on Funkwhale's code. You can work on the code in-browser using a hosted VS Code install or open VS Code on your desktop over SSH."
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:9
msgid "You can open Gitpod directly by clicking the link below. This checks out the `develop` branch for you to work on directly."
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:11
msgid "[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://dev.funkwhale.audio/funkwhale/funkwhale)"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:11
msgid "Open in Gitpod"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:13
msgid "If you want to work on a particular branch, commit, or merge request, you can do this straight from the GitLab interface. Select the arrow icon on the {guilabel}`Web IDE` button and select {guilabel}`Gitpod` to open Gitpod with the currently selected branch checked out."
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:15
msgid "![Select Gitpod as the default web IDE](./gitpod-select-gitpod-in-gitlab.png)"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:15
msgid "Select Gitpod as the default web IDE"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:17
msgid "When you start Gitpod, it creates the following using the selected branch:"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:19
msgid "A Funkwhale API instance"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:20
msgid "A Funkwhale frontend instance"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:22
msgid "You can access the web app at `http://localhost:8000`. Log in with the following credentials:"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:24
msgid "Username `gitpod`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:25
msgid "Password `gitpod`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:27
msgid "Work on the frontend"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:29
msgid "By default, Gitpod spins up an entire Funkwhale stack. If you want to work only on the frontend:"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:31
msgid "Select `File` > `Open Folder`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:32
msgid "Select `/workspace/funkwhale/front`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:34
msgid "Gitpod starts a new Vite server on port 4000. This creates a frontend that isn't connected to any instance."
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:36
msgid "GitLab Workflow extension"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:38
msgid "Gitpod offers a GitLab workflow extension to help manage GitLab issues, merge requests, and pipelines. If you want to use it:"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:40
msgid "Navigate to the personal access token section of your [GitLab profile settings](https://dev.funkwhale.audio/-/profile/personal_access_tokens)"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:41
msgid "Create a personal access token with `api` and `read_user` scopes"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:42
msgid "Paste your token into your [Gitpod variables](https://gitpod.io/variables)"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:44
msgid "Use the following settings to automatically sign in to the extension with Gitpod. The `funkwhale/*` scope ensures you can use the settings for all Funkwhale-hosted projects."
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:46
#: ../../developer_documentation/setup/gitpod.md:64
msgid "Environment variables"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:49
#: ../../developer_documentation/setup/gitpod.md:67
msgid "Name"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:50
#: ../../developer_documentation/setup/gitpod.md:68
msgid "Value"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:51
#: ../../developer_documentation/setup/gitpod.md:69
msgid "Scope"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:52
msgid "`GITLAB_WORKFLOW_INSTANCE_URL`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:53
msgid "`https://dev.funkwhale.audio`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:54
#: ../../developer_documentation/setup/gitpod.md:57
msgid "`funkwhale/*`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:55
msgid "`GITLAB_WORKFLOW_TOKEN`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:56
msgid "Your token"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:60
msgid "Configure custom instance URL"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:62
msgid "You can configure Gitpod to use your Funkwhale pod as the default server. This means you can test frontend changes on your pod without selecting it each time. To do this, add the following to your [Gitpod variables](https://gitpod.io/variables):"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:70
msgid "`VUE_APP_INSTANCE_URL`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:71
msgid "`https://funkwhale.example.com`"
msgstr ""
#: ../../developer_documentation/setup/gitpod.md:72
msgid "`funkwhale/funkwhale`"
msgstr ""

View File

@ -0,0 +1,29 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/setup/index.md:5
msgid "Choose your setup"
msgstr ""
#: ../../developer_documentation/setup/index.md:1
msgid "Set up your development environment"
msgstr ""
#: ../../developer_documentation/setup/index.md:3
msgid "Follow the instructions in these guides to set up your development environment."
msgstr ""

View File

@ -0,0 +1,57 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/setup/vite.md:1
msgid "Develop using Vite"
msgstr ""
#: ../../developer_documentation/setup/vite.md:3
msgid "If you want to make changes to the frontend, you can use Vite to run a development server. This allows you to run a Funkwhale web app and see changes in real time"
msgstr ""
#: ../../developer_documentation/setup/vite.md:5
msgid "Clone the repository:"
msgstr ""
#: ../../developer_documentation/setup/vite.md:0
msgid "SSH"
msgstr ""
#: ../../developer_documentation/setup/vite.md:0
msgid "HTTPS"
msgstr ""
#: ../../developer_documentation/setup/vite.md:29
msgid "Install [Node.js](https://nodejs.org/en/download/package-manager/) and [Yarn](https://classic.yarnpkg.com/lang/en/docs/install/)"
msgstr ""
#: ../../developer_documentation/setup/vite.md:30
msgid "Install all dependencies:"
msgstr ""
#: ../../developer_documentation/setup/vite.md:36
msgid "Compile the translations:"
msgstr ""
#: ../../developer_documentation/setup/vite.md:42
msgid "Launch the development server:"
msgstr ""
#: ../../developer_documentation/setup/vite.md:48
msgid "You can access the Funkwhale web app at `http://localhost:8000/front`. Connect this app to your pod by selecting {guilabel}`Switch instance` in the sidebar."
msgstr ""

View File

@ -0,0 +1,73 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/workflows/changelog.md:1
msgid "Changelog fragments"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:3
msgid "We try to add changelog fragments when we make changes so that we can show users what we've done. These fragments are small text files that contain a summary of changes. When we make a release, we compile these into a full changelog using [towncrier](https://pypi.org/project/towncrier/)."
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:5
msgid "Each changelog fragment should contain a short and meaningful summary of changes and include the issue number (where applicable). For example:"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:11
msgid "If there's no issue, insert the merge request identifier instead:"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:17
msgid "Naming"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:19
msgid "Changelog fragments use the following naming convention: `changes/changelog.d/<name>.category>`. The `<name>` can be anything that describes your work, or the issue ID. The category can be one of the following:"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:21
msgid "`feature` a new feature"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:22
msgid "`enhancement` an extension of an existing feature"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:23
msgid "`bugfix` a bugfix or patch"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:24
msgid "`refactoring` refactored code"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:25
msgid "`doc` new documentation"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:26
msgid "`i18n` internationalization-related work"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:27
msgid "`misc` any work that doesn't fit into the above categories"
msgstr ""
#: ../../developer_documentation/workflows/changelog.md:29
msgid "You can create these files manually or use the following command to create a fragment:"
msgstr ""

View File

@ -0,0 +1,73 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/workflows/git.md:1
msgid "Git workflow"
msgstr ""
#: ../../developer_documentation/workflows/git.md:3
msgid "Funkwhale uses GitLab's merge requests to manage changes. The workflow looks like this:"
msgstr ""
#: ../../developer_documentation/workflows/git.md:5
msgid "Assign the issue you are working on to yourself, or create one if it doesn't exist"
msgstr ""
#: ../../developer_documentation/workflows/git.md:6
msgid "Create a fork of the project"
msgstr ""
#: ../../developer_documentation/workflows/git.md:7
msgid "Check out the `develop` branch. If you're making a minor change (such as fixing a typo) you can check out the `stable` branch"
msgstr ""
#: ../../developer_documentation/workflows/git.md:8
msgid "Create a new branch based on the checked out branch. Make sure to give your branch a meaningful name and include the issue number if required"
msgstr ""
#: ../../developer_documentation/workflows/git.md:9
msgid "Work on your changes locally. Try to keep each commit small to make reviews easier"
msgstr ""
#: ../../developer_documentation/workflows/git.md:10
msgid "Add a changelog fragment summarizing your changes"
msgstr ""
#: ../../developer_documentation/workflows/git.md:11
msgid "Lint the codebase using the following command:"
msgstr ""
#: ../../developer_documentation/workflows/git.md:0
msgid "API code"
msgstr ""
#: ../../developer_documentation/workflows/git.md:0
msgid "Frontend code"
msgstr ""
#: ../../developer_documentation/workflows/git.md:34
msgid "Push your branch"
msgstr ""
#: ../../developer_documentation/workflows/git.md:35
msgid "Create a merge request in the GitLab frontend"
msgstr ""
#: ../../developer_documentation/workflows/git.md:36
msgid "We'll review your request and feed back"
msgstr ""

View File

@ -0,0 +1,29 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/workflows/index.md:5
msgid "Workflows"
msgstr ""
#: ../../developer_documentation/workflows/index.md:1
msgid "Development workflows"
msgstr ""
#: ../../developer_documentation/workflows/index.md:3
msgid "Funkwhale follows workflows for each area of development and release management. You can find a breakdown of these in this section."
msgstr ""

View File

@ -0,0 +1,49 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/workflows/pre-commit.md:1
msgid "Pre-commit"
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:3
msgid "Funkwhale uses [pre-commit](https://pre-commit.com/) to ensure that the files you commit are properly formatted, follow best practice, and don't contain syntax or spelling errors."
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:5
msgid "You can install and setup pre-commit using the [quick-start guide on the pre-commit documentation](https://pre-commit.com/#quick-start). Make sure to install pre-commit and setup the git pre-commit hook so pre-commit runs before you commit any changes to the repository."
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:7
msgid "The workflow looks like this:"
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:9
msgid "Install `pre-commit`."
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:10
msgid "After cloning the repository, setup the pre-commit git hooks:"
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:19
msgid "Make your changes and commit them."
msgstr ""
#: ../../developer_documentation/workflows/pre-commit.md:20
msgid "If `pre-commit` fails to validate your changes, the commit process stops. Fix any reported errors and try again."
msgstr ""

View File

@ -0,0 +1,81 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2023, 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.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
#: ../../developer_documentation/workflows/release.md:1
msgid "Make a release"
msgstr ""
#: ../../developer_documentation/workflows/release.md:3
msgid "Once we're ready to release a new version of the software, we can use the following process:"
msgstr ""
#: ../../developer_documentation/workflows/release.md:5
msgid "Export the new release version"
msgstr ""
#: ../../developer_documentation/workflows/release.md:11
msgid "Export the previous release version"
msgstr ""
#: ../../developer_documentation/workflows/release.md:17
msgid "Pull the latest version of the `develop` branch. Use `stable` if you're releasing a bugfix."
msgstr ""
#: ../../developer_documentation/workflows/release.md:0
msgid "Bugfix release"
msgstr ""
#: ../../developer_documentation/workflows/release.md:0
msgid "Feature release"
msgstr ""
#: ../../developer_documentation/workflows/release.md:43
msgid "Compile the changelog"
msgstr ""
#: ../../developer_documentation/workflows/release.md:49
msgid "Check the output and fix typos and mistakes"
msgstr ""
#: ../../developer_documentation/workflows/release.md:50
msgid "Add a list of contributors"
msgstr ""
#: ../../developer_documentation/workflows/release.md:58
msgid "Update the `__version__` variable to the next release version"
msgstr ""
#: ../../developer_documentation/workflows/release.md:64
msgid "Commit all changes"
msgstr ""
#: ../../developer_documentation/workflows/release.md:71
msgid "Create a tag"
msgstr ""
#: ../../developer_documentation/workflows/release.md:77
msgid "Publish the new tag to GitLab"
msgstr ""
#: ../../developer_documentation/workflows/release.md:83
msgid "Merge your changes into the alternate branch"
msgstr ""
#: ../../developer_documentation/workflows/release.md:107
msgid "Don't forget to create a blog post to announce the new release!"
msgstr ""

View File

@ -1,158 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 `apps <https://funkwhale.audio/en_US/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 ""

View File

@ -1,241 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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:67
msgid "Oauth scopes"
msgstr ""
#: ../../developers/authentication.rst:70
msgid "Scope"
msgstr ""
#: ../../developers/authentication.rst:71
msgid "Description"
msgstr ""
#: ../../developers/authentication.rst:72
msgid "``read``"
msgstr ""
#: ../../developers/authentication.rst:73
msgid "Read-only access to all data (equivalent to all ``read:*`` scopes)."
msgstr ""
#: ../../developers/authentication.rst:74
msgid "``write``"
msgstr ""
#: ../../developers/authentication.rst:75
msgid "Read-only access to all data (equivalent to all ``write:*`` scopes)."
msgstr ""
#: ../../developers/authentication.rst:76
msgid "``<read/write>:profile``"
msgstr ""
#: ../../developers/authentication.rst:77
msgid "Access to profile data (e-mail address, username, etc.)"
msgstr ""
#: ../../developers/authentication.rst:78
msgid "``<read/write>:libraries``"
msgstr ""
#: ../../developers/authentication.rst:79
msgid "Access to library data (uploads, libraries, tracks, albums, artists…)"
msgstr ""
#: ../../developers/authentication.rst:80
msgid "``<read/write>:favorites``"
msgstr ""
#: ../../developers/authentication.rst:81
msgid "Access to favorites"
msgstr ""
#: ../../developers/authentication.rst:82
msgid "``<read/write>:listenings``"
msgstr ""
#: ../../developers/authentication.rst:83
msgid "Access to history"
msgstr ""
#: ../../developers/authentication.rst:84
msgid "``<read/write>:follows``"
msgstr ""
#: ../../developers/authentication.rst:85
msgid "Access to followers"
msgstr ""
#: ../../developers/authentication.rst:86
msgid "``<read/write>:playlists``"
msgstr ""
#: ../../developers/authentication.rst:87
msgid "Access to playlists"
msgstr ""
#: ../../developers/authentication.rst:88
msgid "``<read/write>:radios``"
msgstr ""
#: ../../developers/authentication.rst:89
msgid "Access to radios"
msgstr ""
#: ../../developers/authentication.rst:90
msgid "``<read/write>:filters``"
msgstr ""
#: ../../developers/authentication.rst:91
msgid "Access to content filters"
msgstr ""
#: ../../developers/authentication.rst:92
msgid "``<read/write>:notifications``"
msgstr ""
#: ../../developers/authentication.rst:93
msgid "Access to notifications"
msgstr ""
#: ../../developers/authentication.rst:94
msgid "``<read/write>:edits``"
msgstr ""
#: ../../developers/authentication.rst:95
msgid "Access to metadata edits"
msgstr ""

View File

@ -1,25 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,173 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,165 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 `our list of supported apps <https://funkwhale.audio/en_US/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 ""

View File

@ -1,182 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,57 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,33 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,69 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,89 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,65 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,85 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,609 +0,0 @@
# 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.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+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 ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:20+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,15 +32,15 @@ msgstr ""
msgid "Developer documentation"
msgstr ""
#: ../../index.md:78
#: ../../index.md:84
msgid "Contributor documentation"
msgstr ""
#: ../../index.md:90
#: ../../index.md:97
msgid "Reference"
msgstr ""
#: ../../index.md:101
#: ../../index.md:108
msgid "Changes"
msgstr ""
@ -56,50 +56,50 @@ msgstr ""
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:118
#: ../../index.md:125
msgid "{fa}`user` Users"
msgstr ""
#: ../../index.md:121
#: ../../index.md:128
msgid "Looking to use Funkwhale for your content? Read through our guides to master the app!"
msgstr ""
#: ../../index.md:125
#: ../../index.md:146
#: ../../index.md:167
#: ../../index.md:188
#: ../../index.md:213
#: ../../index.md:132
#: ../../index.md:153
#: ../../index.md:174
#: ../../index.md:195
#: ../../index.md:220
msgid "Get started"
msgstr ""
#: ../../index.md:139
#: ../../index.md:146
msgid "{fa}`wrench` Admins"
msgstr ""
#: ../../index.md:142
#: ../../index.md:149
msgid "Want to host your own Funkwhale pod? Our admin documentation guides you through the process."
msgstr ""
#: ../../index.md:160
#: ../../index.md:167
msgid "{fa}`shield` Moderators"
msgstr ""
#: ../../index.md:163
#: ../../index.md:170
msgid "Keeping your users safe from harassment and spam or clearing illegal content? Check out our moderator docs."
msgstr ""
#: ../../index.md:181
#: ../../index.md:188
msgid "{fa}`code` Developers"
msgstr ""
#: ../../index.md:184
#: ../../index.md:191
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:206
#: ../../index.md:213
msgid "{fa}`users` Contributors"
msgstr ""
#: ../../index.md:209
#: ../../index.md:216
msgid "Want to help make Funkwhale even better? Check out these guides for some ideas."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -28,101 +28,99 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:12
#: ../../moderator_documentation/allow_listing/add_domain.md:13
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:15
#: ../../moderator_documentation/allow_listing/add_domain.md:16
msgid "Add a new domain"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:17
#: ../../moderator_documentation/allow_listing/add_domain.md:18
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:25
#: ../../moderator_documentation/allow_listing/add_domain.md:38
#: ../../moderator_documentation/allow_listing/add_domain.md:60
#: ../../moderator_documentation/allow_listing/add_domain.md:73
#: ../../moderator_documentation/allow_listing/add_domain.md:26
#: ../../moderator_documentation/allow_listing/add_domain.md:39
#: ../../moderator_documentation/allow_listing/add_domain.md:61
#: ../../moderator_documentation/allow_listing/add_domain.md:74
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:26
#: ../../moderator_documentation/allow_listing/add_domain.md:61
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:27
#: ../../moderator_documentation/allow_listing/add_domain.md:40
#: ../../moderator_documentation/allow_listing/add_domain.md:62
#: ../../moderator_documentation/allow_listing/add_domain.md:75
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:28
#: ../../moderator_documentation/allow_listing/add_domain.md:41
#: ../../moderator_documentation/allow_listing/add_domain.md:63
#: ../../moderator_documentation/allow_listing/add_domain.md:76
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:29
#: ../../moderator_documentation/allow_listing/add_domain.md:42
msgid "Enter the URL of the Fediverse server you want to add in the {guilabel}`Add a domain` field."
#: ../../moderator_documentation/allow_listing/add_domain.md:64
#: ../../moderator_documentation/allow_listing/add_domain.md:77
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:30
#: ../../moderator_documentation/allow_listing/add_domain.md:43
msgid "Check ({fa}`check-square`) the checkbox labeled {guilabel}`Add to allow-list`."
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:31
#: ../../moderator_documentation/allow_listing/add_domain.md:44
msgid "Check ({fa}`check-square`) the checkbox labeled {guilabel}`Add to allow-list`."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:32
#: ../../moderator_documentation/allow_listing/add_domain.md:45
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:39
#: ../../moderator_documentation/allow_listing/add_domain.md:74
#: ../../moderator_documentation/allow_listing/add_domain.md:40
#: ../../moderator_documentation/allow_listing/add_domain.md:75
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:48
#: ../../moderator_documentation/allow_listing/add_domain.md:49
msgid "That's it! You've added the domain to your pod's allow-list."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:50
#: ../../moderator_documentation/allow_listing/add_domain.md:51
msgid "Add a known domain"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:52
#: ../../moderator_documentation/allow_listing/add_domain.md:53
msgid "To add a domain that is already in your pod's domain list:"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:64
#: ../../moderator_documentation/allow_listing/add_domain.md:77
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:65
#: ../../moderator_documentation/allow_listing/add_domain.md:78
msgid "Select {guilabel}`Add to allow-list` in the {guilabel}`Actions` dropdown."
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:66
#: ../../moderator_documentation/allow_listing/add_domain.md:79
msgid "Select {guilabel}`Add to allow-list` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:67
#: ../../moderator_documentation/allow_listing/add_domain.md:80
msgid "Select {guilabel}`Go`. A green tick ({fa}`check`) appears next to the domain(s)"
msgstr ""
#: ../../moderator_documentation/allow_listing/add_domain.md:83
#: ../../moderator_documentation/allow_listing/add_domain.md:84
msgid "You're done! You've added the domain to your pod's allow-list."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,7 +16,6 @@ msgstr ""
"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 ""
@ -26,7 +25,7 @@ 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."
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

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -28,11 +28,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:8
#: ../../moderator_documentation/allow_listing/remove_domain.md:9
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:11
#: ../../moderator_documentation/allow_listing/remove_domain.md:12
msgid "To remove a domain from your allow-list:"
msgstr ""
@ -40,37 +40,37 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:19
#: ../../moderator_documentation/allow_listing/remove_domain.md:32
#: ../../moderator_documentation/allow_listing/remove_domain.md:20
#: ../../moderator_documentation/allow_listing/remove_domain.md:33
msgid "Log in to your pod."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:20
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:21
#: ../../moderator_documentation/allow_listing/remove_domain.md:34
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:22
#: ../../moderator_documentation/allow_listing/remove_domain.md:35
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:23
#: ../../moderator_documentation/allow_listing/remove_domain.md:36
msgid "Check ({fa}`check-square`) the checkbox next to the domain(s) you want to add to the allow-list."
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:24
#: ../../moderator_documentation/allow_listing/remove_domain.md:37
msgid "Select {guilabel}`Remove from allow-list` in the {guilabel}`Actions` dropdown."
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:25
#: ../../moderator_documentation/allow_listing/remove_domain.md:38
msgid "Select {guilabel}`Remove from allow-list` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:26
#: ../../moderator_documentation/allow_listing/remove_domain.md:39
msgid "Select {guilabel}`Go`."
msgstr ""
@ -78,10 +78,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/allow_listing/remove_domain.md:33
#: ../../moderator_documentation/allow_listing/remove_domain.md:34
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:42
#: ../../moderator_documentation/allow_listing/remove_domain.md:43
msgid "You're done! You've removed the domain from your pod's allow-list."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,170 +32,168 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:12
#: ../../moderator_documentation/content/delete_content.md:13
msgid "{guilabel}`Moderation` provides access to the administration menu."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:13
#: ../../moderator_documentation/content/delete_content.md:14
msgid "{guilabel}`Library` provides access to the library menu."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:16
#: ../../moderator_documentation/content/delete_content.md:17
msgid "There are two ways to delete content:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:22
#: ../../moderator_documentation/content/delete_content.md:23
msgid "Delete individual objects"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:24
#: ../../moderator_documentation/content/delete_content.md:25
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:32
#: ../../moderator_documentation/content/delete_content.md:53
#: ../../moderator_documentation/content/delete_content.md:83
#: ../../moderator_documentation/content/delete_content.md:105
#: ../../moderator_documentation/content/delete_content.md:33
#: ../../moderator_documentation/content/delete_content.md:54
#: ../../moderator_documentation/content/delete_content.md:84
#: ../../moderator_documentation/content/delete_content.md:106
msgid "Log in to your pod."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:33
#: ../../moderator_documentation/content/delete_content.md:84
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:34
#: ../../moderator_documentation/content/delete_content.md:55
#: ../../moderator_documentation/content/delete_content.md:85
#: ../../moderator_documentation/content/delete_content.md:107
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens."
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:35
#: ../../moderator_documentation/content/delete_content.md:56
#: ../../moderator_documentation/content/delete_content.md:86
#: ../../moderator_documentation/content/delete_content.md:108
msgid "Select the type of content you want to delete from the top of the page:"
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:36
#: ../../moderator_documentation/content/delete_content.md:57
#: ../../moderator_documentation/content/delete_content.md:87
#: ../../moderator_documentation/content/delete_content.md:109
msgid "{guilabel}`Channels`"
msgid "Select the type of content you want to delete from the top of the page:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:37
#: ../../moderator_documentation/content/delete_content.md:58
#: ../../moderator_documentation/content/delete_content.md:88
#: ../../moderator_documentation/content/delete_content.md:110
msgid "{guilabel}`Artists`"
msgid "{guilabel}`Channels`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:38
#: ../../moderator_documentation/content/delete_content.md:59
#: ../../moderator_documentation/content/delete_content.md:89
#: ../../moderator_documentation/content/delete_content.md:111
msgid "{guilabel}`Albums`"
msgid "{guilabel}`Artists`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:39
#: ../../moderator_documentation/content/delete_content.md:60
#: ../../moderator_documentation/content/delete_content.md:90
#: ../../moderator_documentation/content/delete_content.md:112
msgid "{guilabel}`Tracks`"
msgid "{guilabel}`Albums`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:40
#: ../../moderator_documentation/content/delete_content.md:61
#: ../../moderator_documentation/content/delete_content.md:91
#: ../../moderator_documentation/content/delete_content.md:113
msgid "{guilabel}`Libraries`"
msgid "{guilabel}`Tracks`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:41
#: ../../moderator_documentation/content/delete_content.md:62
#: ../../moderator_documentation/content/delete_content.md:92
#: ../../moderator_documentation/content/delete_content.md:114
msgid "{guilabel}`Uploads`"
msgid "{guilabel}`Libraries`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:42
#: ../../moderator_documentation/content/delete_content.md:63
#: ../../moderator_documentation/content/delete_content.md:93
#: ../../moderator_documentation/content/delete_content.md:115
msgid "{guilabel}`Tags`"
msgid "{guilabel}`Uploads`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:43
#: ../../moderator_documentation/content/delete_content.md:64
#: ../../moderator_documentation/content/delete_content.md:94
#: ../../moderator_documentation/content/delete_content.md:116
msgid "Use the filters on the content page to find the object you want to delete."
msgid "{guilabel}`Tags`"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:44
#: ../../moderator_documentation/content/delete_content.md:65
msgid "Select the object to go to its moderation page."
#: ../../moderator_documentation/content/delete_content.md:95
#: ../../moderator_documentation/content/delete_content.md:117
msgid "Use the filters on the content page to find the object you want to delete."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:45
#: ../../moderator_documentation/content/delete_content.md:66
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this {object}` warning appears."
msgid "Select the object to go to its moderation page."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:46
#: ../../moderator_documentation/content/delete_content.md:67
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this {object}` warning appears."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:47
#: ../../moderator_documentation/content/delete_content.md:68
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:54
#: ../../moderator_documentation/content/delete_content.md:106
#: ../../moderator_documentation/content/delete_content.md:55
#: ../../moderator_documentation/content/delete_content.md:107
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:71
#: ../../moderator_documentation/content/delete_content.md:72
msgid "That's it! You've deleted the object."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:73
#: ../../moderator_documentation/content/delete_content.md:74
msgid "Delete objects in bulk"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:75
#: ../../moderator_documentation/content/delete_content.md:76
msgid "To delete several items at once:"
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:95
#: ../../moderator_documentation/content/delete_content.md:117
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:96
#: ../../moderator_documentation/content/delete_content.md:118
msgid "Select {guilabel}`Delete` in the {guilabel}`Actions` dropdown."
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:97
#: ../../moderator_documentation/content/delete_content.md:119
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch delete on {count} items` warning appears."
msgid "Select {guilabel}`Delete` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:98
#: ../../moderator_documentation/content/delete_content.md:120
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch delete on {count} items` warning appears."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:99
#: ../../moderator_documentation/content/delete_content.md:121
msgid "Select {guilabel}`Launch`."
msgstr ""
#: ../../moderator_documentation/content/delete_content.md:124
#: ../../moderator_documentation/content/delete_content.md:125
msgid "You're done! You've deleted the selected objects from your pod."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -25,54 +25,54 @@ msgid "Users can edit content in their own libraries. Moderators don't need to a
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."
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:0
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:12
#: ../../moderator_documentation/content/handle_edits.md:13
msgid "{guilabel}`Moderation` provides access to the administration menu."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:13
#: ../../moderator_documentation/content/handle_edits.md:14
msgid "{guilabel}`Library` provides access to the library menu."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:16
#: ../../moderator_documentation/content/handle_edits.md:17
msgid "Each edit object contains the following information:"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:18
#: ../../moderator_documentation/content/handle_edits.md:19
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:19
#: ../../moderator_documentation/content/handle_edits.md:20
msgid "A timestamp of when the user suggested the edit."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:20
#: ../../moderator_documentation/content/handle_edits.md:21
msgid "The status of the edit."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:21
#: ../../moderator_documentation/content/handle_edits.md:22
msgid "The {guilabel}`Field` that the user edited."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:22
#: ../../moderator_documentation/content/handle_edits.md:23
msgid "The {guilabel}`Old value` that the user edited."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:23
#: ../../moderator_documentation/content/handle_edits.md:24
msgid "The {guilabel}`New value` that the user entered."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:24
#: ../../moderator_documentation/content/handle_edits.md:25
msgid "The user who suggested the edit."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:26
#: ../../moderator_documentation/content/handle_edits.md:27
msgid "To review suggested edits:"
msgstr ""
@ -80,37 +80,37 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:34
#: ../../moderator_documentation/content/handle_edits.md:47
#: ../../moderator_documentation/content/handle_edits.md:35
#: ../../moderator_documentation/content/handle_edits.md:48
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:35
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:36
#: ../../moderator_documentation/content/handle_edits.md:49
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens. The {guilabel}`Library edits` section displays a list of unresolved edits."
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:37
#: ../../moderator_documentation/content/handle_edits.md:50
msgid "Review the edit and select on of the following options:"
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:38
#: ../../moderator_documentation/content/handle_edits.md:51
msgid "{guilabel}`Approve` approve the edit and apply it to the object."
msgid "Review the edit and select on of the following options:"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:39
#: ../../moderator_documentation/content/handle_edits.md:52
msgid "{guilabel}`Reject` reject the edit and leave the object in its current state."
msgid "{guilabel}`Approve` approve the edit and apply it to the object."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:40
#: ../../moderator_documentation/content/handle_edits.md:53
msgid "{guilabel}`Reject` reject the edit and leave the object in its current state."
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:41
#: ../../moderator_documentation/content/handle_edits.md:54
msgid "{guilabel}`Delete` delete the edit suggestion without taking further action. The object remains in its current state."
msgstr ""
@ -118,10 +118,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/content/handle_edits.md:48
#: ../../moderator_documentation/content/handle_edits.md:49
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:57
#: ../../moderator_documentation/content/handle_edits.md:58
msgid "That's it! You've handled the edit request. You can use the filters on this page to search for historical requests."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,7 +16,6 @@ msgstr ""
"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 ""
@ -26,5 +25,5 @@ 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."
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 ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,15 +32,15 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:12
#: ../../moderator_documentation/content/library_visibility.md:13
msgid "{guilabel}`Moderation` provides access to the administration menu."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:13
#: ../../moderator_documentation/content/library_visibility.md:14
msgid "{guilabel}`Library` provides access to the library menu."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:16
#: ../../moderator_documentation/content/library_visibility.md:17
msgid "To change the visibility of a library:"
msgstr ""
@ -48,47 +48,47 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:24
#: ../../moderator_documentation/content/library_visibility.md:39
#: ../../moderator_documentation/content/library_visibility.md:25
#: ../../moderator_documentation/content/library_visibility.md:40
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:25
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:26
#: ../../moderator_documentation/content/library_visibility.md:41
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens."
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:27
#: ../../moderator_documentation/content/library_visibility.md:42
msgid "Select {guilabel}`Libraries` at the top of the page. The {guilabel}`Libraries` page opens."
msgid "Select {guilabel}`Library`. The {guilabel}`Edits` page opens."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:28
#: ../../moderator_documentation/content/library_visibility.md:43
msgid "Select the library you want to update. The library's moderation page opens."
msgid "Select {guilabel}`Libraries` at the top of the page. The {guilabel}`Libraries` page opens."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:29
#: ../../moderator_documentation/content/library_visibility.md:44
msgid "Select one of the following options from the {guilabel}`Visibility` dropdown menu:"
msgid "Select the library you want to update. The library's moderation page opens."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:30
#: ../../moderator_documentation/content/library_visibility.md:45
msgid "{guilabel}`Private` makes the library visible only to the owner and anyone they have shared it with."
msgid "Select one of the following options from the {guilabel}`Visibility` dropdown menu:"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:31
#: ../../moderator_documentation/content/library_visibility.md:46
msgid "{guilabel}`Instance` makes the library visible only to users who have an account on your pod."
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:32
#: ../../moderator_documentation/content/library_visibility.md:47
msgid "{guilabel}`Instance` makes the library visible only to users who have an account on your pod."
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:33
#: ../../moderator_documentation/content/library_visibility.md:48
msgid "{guilabel}`Everyone` makes the library visible to users across all pods."
msgstr ""
@ -96,10 +96,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/content/library_visibility.md:40
#: ../../moderator_documentation/content/library_visibility.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/library_visibility.md:51
#: ../../moderator_documentation/content/library_visibility.md:52
msgid "That's it! You've updated the library's visibility. You should contact the user informing them of the action."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -28,11 +28,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:8
#: ../../moderator_documentation/domains/add_domain.md:9
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:11
#: ../../moderator_documentation/domains/add_domain.md:12
msgid "You can also add domains to this list at any time to create rules before users interact with them. To do this:"
msgstr ""
@ -40,32 +40,32 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:19
#: ../../moderator_documentation/domains/add_domain.md:31
#: ../../moderator_documentation/domains/add_domain.md:20
#: ../../moderator_documentation/domains/add_domain.md:32
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:20
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:21
#: ../../moderator_documentation/domains/add_domain.md:33
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:22
#: ../../moderator_documentation/domains/add_domain.md:34
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:23
#: ../../moderator_documentation/domains/add_domain.md:35
msgid "Enter the URL of the Fediverse server you want to add in the {guilabel}`Add a domain` field."
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:24
#: ../../moderator_documentation/domains/add_domain.md:36
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:25
#: ../../moderator_documentation/domains/add_domain.md:37
msgid "Select {guilabel}`Add` to add the domain. The domain moderation page opens."
msgstr ""
@ -73,10 +73,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/add_domain.md:32
#: ../../moderator_documentation/domains/add_domain.md:33
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:40
#: ../../moderator_documentation/domains/add_domain.md:41
msgid "That's it! The domain is now in your domains list. You can now add moderation rules to this domain."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,11 +32,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:12
#: ../../moderator_documentation/domains/add_rule.md:13
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:15
#: ../../moderator_documentation/domains/add_rule.md:16
msgid "To add a moderation rule to a domain:"
msgstr ""
@ -44,57 +44,57 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:23
#: ../../moderator_documentation/domains/add_rule.md:40
#: ../../moderator_documentation/domains/add_rule.md:24
#: ../../moderator_documentation/domains/add_rule.md:41
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:24
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:25
#: ../../moderator_documentation/domains/add_rule.md:42
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:26
#: ../../moderator_documentation/domains/add_rule.md:43
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:27
#: ../../moderator_documentation/domains/add_rule.md:44
msgid "Select the domain you want to apply the rule to. The domain's moderation page opens."
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:28
#: ../../moderator_documentation/domains/add_rule.md:45
msgid "Select {guilabel}`Add a moderation policy`. The moderation policy form appears."
msgid "Select the domain you want to apply the rule to. The domain's moderation page opens."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:29
#: ../../moderator_documentation/domains/add_rule.md:46
msgid "Enter the {guilabel}`Reason` you are applying the rule. Depending on your pod's configuration, users may be able to see this."
msgid "Select {guilabel}`Add a moderation policy`. The moderation policy form appears."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:30
#: ../../moderator_documentation/domains/add_rule.md:47
msgid "Choose your moderation rule:"
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:31
#: ../../moderator_documentation/domains/add_rule.md:48
msgid "{guilabel}`Block everything` purge all content from the domain and block all content."
msgid "Choose your moderation rule:"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:32
#: ../../moderator_documentation/domains/add_rule.md:49
msgid "{guilabel}`Reject media` only reject media files such as audio files, avatars, and album art."
msgid "{guilabel}`Block everything` purge all content from the domain and block all content."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:33
#: ../../moderator_documentation/domains/add_rule.md:50
msgid "{guilabel}`Reject media` only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:34
#: ../../moderator_documentation/domains/add_rule.md:51
msgid "Select {guilabel}`Create` to save your rule."
msgstr ""
@ -102,10 +102,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/add_rule.md:41
#: ../../moderator_documentation/domains/add_rule.md:42
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:54
#: ../../moderator_documentation/domains/add_rule.md:55
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 ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -28,11 +28,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:8
#: ../../moderator_documentation/domains/delete_rule.md:9
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:11
#: ../../moderator_documentation/domains/delete_rule.md:12
msgid "To delete an existing moderation rule:"
msgstr ""
@ -40,42 +40,42 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:19
#: ../../moderator_documentation/domains/delete_rule.md:33
#: ../../moderator_documentation/domains/delete_rule.md:20
#: ../../moderator_documentation/domains/delete_rule.md:34
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:20
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:21
#: ../../moderator_documentation/domains/delete_rule.md:35
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:22
#: ../../moderator_documentation/domains/delete_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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:23
#: ../../moderator_documentation/domains/delete_rule.md:37
msgid "Select the domain with the moderation rule you want to edit. The domain's moderation page opens."
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:24
#: ../../moderator_documentation/domains/delete_rule.md:38
msgid "Select {guilabel}`Edit` under the {guilabel}`This domain is subject to specific moderation rules` header. The moderation policy form opens."
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:25
#: ../../moderator_documentation/domains/delete_rule.md:39
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this moderation rule?` warning appears."
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:26
#: ../../moderator_documentation/domains/delete_rule.md:40
msgid "Select {guilabel}`Delete`. A {guilabel}`Delete this moderation rule?` warning appears."
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:27
#: ../../moderator_documentation/domains/delete_rule.md:41
msgid "Select {guilabel}`Delete moderation rule`."
msgstr ""
@ -83,10 +83,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/delete_rule.md:34
#: ../../moderator_documentation/domains/delete_rule.md:35
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:44
#: ../../moderator_documentation/domains/delete_rule.md:45
msgid "That's it! You've deleted your moderation rule. Content from the domain will no longer get blocked."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,11 +32,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:12
#: ../../moderator_documentation/domains/edit_rule.md:13
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:15
#: ../../moderator_documentation/domains/edit_rule.md:16
msgid "To update an existing moderation rule:"
msgstr ""
@ -44,67 +44,67 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:23
#: ../../moderator_documentation/domains/edit_rule.md:42
#: ../../moderator_documentation/domains/edit_rule.md:24
#: ../../moderator_documentation/domains/edit_rule.md:43
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:24
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:25
#: ../../moderator_documentation/domains/edit_rule.md:44
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:26
#: ../../moderator_documentation/domains/edit_rule.md:45
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:27
#: ../../moderator_documentation/domains/edit_rule.md:46
msgid "Select the domain with the moderation rule you want to edit. The domain's moderation page opens."
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:28
#: ../../moderator_documentation/domains/edit_rule.md:47
msgid "Select {guilabel}`Edit` under the {guilabel}`This domain is subject to specific moderation rules` header. The moderation policy form opens."
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:29
#: ../../moderator_documentation/domains/edit_rule.md:48
msgid "__Optional__ Edit the following settings:"
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:30
#: ../../moderator_documentation/domains/edit_rule.md:49
msgid "{guilabel}`Enabled` toggle this switch to enable or disable the rule without deleting it."
msgid "**Optional** Edit the following settings:"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:31
#: ../../moderator_documentation/domains/edit_rule.md:50
msgid "{guilabel}`Reason` update the reason for the moderation rule."
msgid "{guilabel}`Enabled` toggle this switch to enable or disable the rule without deleting it."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:32
#: ../../moderator_documentation/domains/edit_rule.md:51
msgid "__Optional__ Update your moderation rule:"
msgid "{guilabel}`Reason` update the reason for the moderation rule."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:33
#: ../../moderator_documentation/domains/edit_rule.md:52
msgid "{guilabel}`Block everything` purge all content from this domain and block all content."
msgid "**Optional** Update your moderation rule:"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:34
#: ../../moderator_documentation/domains/edit_rule.md:53
msgid "{guilabel}`Reject media` only reject media files such as audio files, avatars, and album art."
msgid "{guilabel}`Block everything` purge all content from this domain and block all content."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:35
#: ../../moderator_documentation/domains/edit_rule.md:54
msgid "{guilabel}`Reject media` only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:36
#: ../../moderator_documentation/domains/edit_rule.md:55
msgid "Select {guilabel}`Update` to save your rule."
msgstr ""
@ -112,10 +112,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/edit_rule.md:43
#: ../../moderator_documentation/domains/edit_rule.md:44
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:58
#: ../../moderator_documentation/domains/edit_rule.md:59
msgid "You're done! The changes to the rule take effect as soon as you update it."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -16,12 +16,10 @@ msgstr ""
"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 ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,11 +32,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:12
#: ../../moderator_documentation/domains/purge_domain.md:13
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:15
#: ../../moderator_documentation/domains/purge_domain.md:16
msgid "To purge content from a domain:"
msgstr ""
@ -44,42 +44,42 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:23
#: ../../moderator_documentation/domains/purge_domain.md:37
#: ../../moderator_documentation/domains/purge_domain.md:24
#: ../../moderator_documentation/domains/purge_domain.md:38
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:24
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:25
#: ../../moderator_documentation/domains/purge_domain.md:39
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:26
#: ../../moderator_documentation/domains/purge_domain.md:40
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:27
#: ../../moderator_documentation/domains/purge_domain.md:41
msgid "Select the checkbox ({fa}`square`) next to the domain(s) you want to purge. Selected domains show a tick ({fa}`check-square`)."
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:28
#: ../../moderator_documentation/domains/purge_domain.md:42
msgid "Select {guilabel}`Purge` in the {guilabel}`Actions` dropdown."
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:29
#: ../../moderator_documentation/domains/purge_domain.md:43
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch purge on {count} items` warning appears."
msgid "Select {guilabel}`Purge` in the {guilabel}`Actions` dropdown."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:30
#: ../../moderator_documentation/domains/purge_domain.md:44
msgid "Select {guilabel}`Go`. A {guilabel}`Do you want to launch purge on {count} items` warning appears."
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:31
#: ../../moderator_documentation/domains/purge_domain.md:45
msgid "Select {guilabel}`Launch`."
msgstr ""
@ -87,10 +87,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/domains/purge_domain.md:38
#: ../../moderator_documentation/domains/purge_domain.md:39
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:48
#: ../../moderator_documentation/domains/purge_domain.md:49
msgid "You're done! Your pod clears all the content associated with the selected domains."
msgstr ""

View File

@ -1,14 +1,14 @@
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# Copyright (C) 2023, 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.7\n"
"Project-Id-Version: funkwhale 1.3.0-rc3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
"POT-Creation-Date: 2023-03-01 14:05+0100\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"
@ -32,11 +32,11 @@ msgstr ""
msgid "Required permissions"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:12
#: ../../moderator_documentation/external_users/add_rule.md:13
msgid "{guilabel}`Moderation` provides access to the administration and moderation menus."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:15
#: ../../moderator_documentation/external_users/add_rule.md:16
msgid "To add a moderation rule to a user:"
msgstr ""
@ -44,57 +44,57 @@ msgstr ""
msgid "Desktop"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:23
#: ../../moderator_documentation/external_users/add_rule.md:40
#: ../../moderator_documentation/external_users/add_rule.md:24
#: ../../moderator_documentation/external_users/add_rule.md:41
msgid "Log in to your {term}`pod`."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:24
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:25
#: ../../moderator_documentation/external_users/add_rule.md:42
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
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:26
#: ../../moderator_documentation/external_users/add_rule.md:43
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."
msgid "Select {guilabel}`Moderation`. The {guilabel}`Reports` page opens."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:27
#: ../../moderator_documentation/external_users/add_rule.md:44
msgid "Select the account you want to apply the rule to. The account's moderation page opens."
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:28
#: ../../moderator_documentation/external_users/add_rule.md:45
msgid "Select {guilabel}`Add a moderation policy`. The moderation policy form appears."
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:29
#: ../../moderator_documentation/external_users/add_rule.md:46
msgid "Enter the {guilabel}`Reason` you are applying the rule. Depending on your pod's configuration, users may be able to see this."
msgid "Select {guilabel}`Add a moderation policy`. The moderation policy form appears."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:30
#: ../../moderator_documentation/external_users/add_rule.md:47
msgid "Choose your moderation rule:"
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:31
#: ../../moderator_documentation/external_users/add_rule.md:48
msgid "{guilabel}`Block everything` purge all content from the user and block all content."
msgid "Choose your moderation rule:"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:32
#: ../../moderator_documentation/external_users/add_rule.md:49
msgid "{guilabel}`Reject media` only reject media files such as audio files, avatars, and album art."
msgid "{guilabel}`Block everything` purge all content from the user and block all content."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:33
#: ../../moderator_documentation/external_users/add_rule.md:50
msgid "{guilabel}`Reject media` only reject media files such as audio files, avatars, and album art."
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:34
#: ../../moderator_documentation/external_users/add_rule.md:51
msgid "Select {guilabel}`Create` to save your rule."
msgstr ""
@ -102,10 +102,10 @@ msgstr ""
msgid "Mobile"
msgstr ""
#: ../../moderator_documentation/external_users/add_rule.md:41
#: ../../moderator_documentation/external_users/add_rule.md:42
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:54
#: ../../moderator_documentation/external_users/add_rule.md:55
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 ""

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