docs/src/content/docs/fr-ca/index.mdx

+---
+title: Welcome 👋
+---
+
+import { LinkCard } from "@astrojs/starlight/components";
+
+Castopod is a free & open-source hosting platform made for podcasters who want
+engage and interact with their audience.
+
+Castopod is easy to install and was built on top of
+[CodeIgniter4](https://codeigniter.com/), a powerful PHP framework with a very
+small footprint.
+
+<LinkCard title="Install" href="./getting-started/install" />
+
+## Features
+
+- 🌱  Free & open-source (AGPL v3 License)
+- 🔐  Focused on data sovereignty: your content, audience, and analytics belong
+  to you, and you only
+- 🪄  Podcasting 2.0 features: GUID, locked, transcripts, funding, chapters,
+  location, persons, soundbites, …
+- 💬  Built-in social network:
+  - 🚀  Castopod is part of the Fediverse, a decentralized social network
+  - ❤️  Create posts, share, favourite, and comment on episodes
+- 📈  Built-in analytics:
+  - ⚖️  GDPR / CCPA / LGPD compliant
+  - 🪙  Standard IABv2 audience measurement
+  - 🏡  On-premises analytics, no third party involved
+- 📢  Built-in marketing tools:
+  - ✅  SEO ready (open-graph meta-tags, JSON-LD, …)
+  - 📱  PWA: install as a standalone app
+  - 🎨  Customizable theme colors
+  - 🎬  Generate ready-to-share Video clips from episodes
+  - 🔉  Generate soundbites
+  - ▶️  Embeddable player, embed your episodes on any website
+- 💸  Monetization:
+  - 🔗  Funding links
+  - 📲  listen-to-click ads
+  - 🤝  value4value / WebMonetization
+  - 💎  Premium podcasts
+- 📡  Publish your episodes everywhere with RSS:
+  - 📱  On all indexes and apps: Podcast Index, Apple Podcasts, Spotify, Google
+    Podcasts, Deezer, Podcast Addict, Podfriend, …
+  - ⚡  Broadcast your episodes instantly with WebSub
+- 📥  Podcast import: move your existing podcast into Castopod
+- 📤  Move your podcast out of Castopod
+- 🔀  Multi-tenant: host as many podcasts as you want
+- 👥  Multi-user: add contributors and set roles
+- 🌎  i18n support: translated in English, French, Polish, German, Brazilian
+  Portuguese, Spanish, simplified Chinese… and
+  [many more](https://translate.castopod.org)!
+
+## Motivation
+
+The podcasting ecosystem is decentralized by nature: you can create your podcast
+as an RSS file, publish it on the web and have it shared everywhere online.
+
+It is in fact one of the only media to have stayed this way for a long time.
+
+As usages are evolving, more and more people are getting into podcasts: whether
+it is creators finding new ways to share their ideas, or listeners in the search
+for better content.
+
+With podcasting becoming more widely used, some companies are trying to shift it
+towards a more controlled and centralized medium.
+
+Castopod was created in an effort to provide an open and sustainable alternative
+to hosting your podcasts, promoting decentralization to ensure that podcasters
+creativity can express itself.
+
+This project is pushed by the open-source community, and specifically by the
+[Fediverse](https://fediverse.party/en/fediverse/) and
+[Podcasting 2.0](https://podcastindex.org/) movements.
+
+## Comparison with other solutions
+
+We believe that a solution is not necessarily right for everyone, it highly
+depends on your needs. So, here are comparisons with other tools to help you to
+gauge whether Castopod is the right fit for you.
+
+### Castopod vs Wordpress
+
+Castopod is often referred to as "the Wordpress for podcasts" because of the
+similarities between the two. In some ways this is true. And actually, Castopod
+was greatly inspired by the Wordpress ecosystem, seeing the ease of adoption
+from the community and the number of websites running it.
+
+Just like Wordpress, Castopod is free & open source, built using PHP with a
+MySQL database and is packaged in a way that you can easily install on most web
+servers.
+
+Wordpress is a great way to create your website and extend it with plugins to
+get what you want. It is a full fledged CMS that helps you get any type of
+website online.
+
+On the other hand, Castopod is meant to address the podcasters needs
+specifically, focusing on podcasting, and nothing else. You don't need any
+plugin to get you started on your podcasting journey.
+
+This allows optimizing the processes specific to podcasting: ranging from the
+creation of your podcasts and the publication of new episodes all the way to
+broadcasting, marketing and analytics.
+
+Finally, depending on your needs, Wordpress and Castopod can even live side by
+side as they share the same requirements!
+
+### Castopod vs Funkwhale
+
+Funkwhale is a self-hosted, modern free and open-source music server. Just as
+Castopod, Funkwhale is on the fediverse, a decentralized social network allowing
+interoperability between the two.
+
+Funkwhale was initially built around music. And later on, as the project
+evolved, the ability to host podcasts was introduced.
+
+Unlike Funkwhale, Castopod has been designed and built around podcasting
+exclusively. This allows easier implementation for features related to the
+podcasting ecosystem, such as the podcasting 2.0 features (transcripts,
+chapters, locations, persons, …).
+
+So, you should probably use Funkwhale if you want to host your music, and use
+Castopod if you want to host your podcasts.
+
+### Castopod vs other podcast hosts
+
+There are many solutions for you to host your podcasts, some of which are really
+great and [a lot of them](https://podcastindex.org/apps) are jumping into the
+Podcasting 2.0 wagon just like Castopod!
+
+Each of these solutions differ from one another, you may compare with the
+[list of features](#features).
+
+That being said, there are two main differences with other podcasting solutions:
+
+- Castopod can be self-hosted and is the only solution that allows you to keep
+  full control over what you produce. Also, as it is open-source, you can even
+  customize it as you wish.
+
+- Castopod is the only solution that currently integrates both a decentralized
+  social network with ActivityPub as well as many of the podcasting 2.0
+  features, hoping to bridge the gap between the two.
+
+## Contributing
+
+Love Castopod and would like to help? Take a look at the following documentation
+to get you started.
+
+### Code of conduct
+
+Castopod has adopted a Code of Conduct that we expect project participants to
+adhere to. Please read the
+[CODE_OF_CONDUCT manual](https://code.castopod.org/adaures/castopod/-/blob/beta/CODE_OF_CONDUCT.md)
+so that you can understand what actions will and will not be tolerated.
+
+### Contributing guide
+
+Read our
+[contributing guide](https://code.castopod.org/adaures/castopod/-/blob/develop/CONTRIBUTING.md)
+to learn about our development process, how to propose bugfixes and
+improvements, and how to build and test your changes to Castopod.
+
+## Contact
+
+You may reach us for help or ask any question you have on:
+
+- [Discord](https://castopod.org/discord) (for direct interaction with
+  developers and the community)
+- [Issue tracker](https://code.castopod.org/adaures/castopod/-/issues) (for
+  feature requests & bug reports)
+
+Alternatively, you can follow us on social media platforms to get news about
+Castopod:
+
+- [podlibre.social](https://podlibre.social/@Castopod) (Mastodon instance)
+- [Twitter](https://twitter.com/castopod)
+- [LinkedIn](https://linkedin.com/company/castopod)
+- [Facebook](https://www.facebook.com/castopod)
+
+## Sponsors
+
+The ongoing development of Castopod is made possible with the support of its
+backers. If you'd like to help, please consider
+[sponsoring Castopod's development](https://opencollective.com/castopod/contribute).
+
+[![Ad Aures Logo](../../../assets/images/sponsors/adaures.svg)](https://adaures.com/)
+
+[![NLnet Logo](../../../assets/images/sponsors/nlnet.svg)](https://nlnet.nl/)
+
+## License
+
+[GNU Affero General Public License v3.0](https://choosealicense.com/licenses/agpl-3.0/)
+
+Copyright © 2020-present, [Ad Aures](https://adaures.com/).

docs/src/content/docs/fr/getting-started/auth.mdx

+---
+title: Authentification et Autorisation
+---
+
+Castopod gère l'authentification et l'autorisation à l'aide de
+`codeigniter/shield` associés à des règles personnalisées. Les rôles et les
+autorisations sont définis sur deux niveaux :
+
+1. [à l'échelle de l'instance](#1-instance-wide-roles-and-permissions)
+2. [par podcast](#2-per-podcast-roles-and-permissions)
+
+## 1. Rôles et autorisations à l'échelle de l'instance
+
+### Instance roles
+
+{/* AUTH-INSTANCE-ROLES-LIST:START - Do not remove or modify this section */}
+
+| role                       | description                         | permissions                                                                                            |
+| -------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| Super administrat·rice·eur | A un contrôle complet sur Castopod. | admin.\*, plugins.\*, podcasts.\*, users.manage, persons.manage, pages.manage, fediverse.manage-blocks |
+| Gestionnaire               | Gère le contenu de Castopod.        | podcasts.create, podcasts.import, persons.manage, pages.manage                                         |
+| Podcast·rice·eur           | Utilisateurs généraux de Castopod.  | admin.access                                                                                           |
+
+{/* AUTH-INSTANCE-ROLES-LIST:END */}
+
+### Autorisations dans l'instance
+
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission              | description                                                          |
+| ----------------------- | -------------------------------------------------------------------- |
+| admin.access            | Peut accéder à la zone d'administration Castopod.                    |
+| admin.settings          | Peut accéder aux paramètres de Castopod.                             |
+| plugins.manage          | Auth.instance_permissions.plugins.manage                             |
+| users.manage            | Peut gérer les utilisateurs de Castopod.                             |
+| persons.manage          | Permet de gérer les personnes.                                       |
+| pages.manage            | Permet de gérer les pages.                                           |
+| podcasts.view           | Peut voir tous les podcasts.                                         |
+| podcasts.create         | Peut créer de nouveaux podcasts.                                     |
+| podcasts.import         | Peut importer des podcasts.                                          |
+| fediverse.manage-blocks | Peut empêcher des act·rice·eur·s/domaines d'interagir avec Castopod. |
+
+{/* AUTH-INSTANCE-PERMISSIONS-LIST:END */}
+
+## 2. Rôles et autorisations par podcast
+
+### Rôles par podcast
+
+{/* AUTH-PODCAST-ROLES-LIST:START - Do not remove or modify this section */}
+
+| role             | description                                                       | permissions                                                                                                                                                                                                                                                                                 |
+| ---------------- | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Administrateur   | A un contrôle total sur le podcast #\{id\}.                       | \*                                                                                                                                                                                                                                                                                          |
+| Éditeur          | Gère le contenu et les publications du podcast #\{id\}.           | view, edit, manage-import, manage-persons, manage-platforms, manage-publications, manage-notifications, interact-as, episodes.view, episodes.create, episodes.edit, episodes.delete, episodes.manage-persons, episodes.manage-clips, episodes.manage-publications, episodes.manage-comments |
+| Auteur / Autrice | Gère le contenu du podcast #\{id\} , mais ne peut pas le publier. | view, manage-persons, episodes.view, episodes.create, episodes.edit, episodes.manage-persons, episodes.manage-clips                                                                                                                                                                         |
+| Invité           | Contributeur général du podcast #\{id\}.                          | view, episodes.view                                                                                                                                                                                                                                                                         |
+
+{/* AUTH-PODCAST-ROLES-LIST:END */}
+
+### Permissions par podcast
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:START - Do not remove or modify this section */}
+
+| permission                   | description                                                                                          |
+| ---------------------------- | ---------------------------------------------------------------------------------------------------- |
+| view                         | Peut voir le tableau de bord et les analyses du podcast #\{id\}.                                     |
+| edit                         | Peut éditer le podcast #\{id\}.                                                                      |
+| delete                       | Peut supprimer le podcast #\{id\}.                                                                   |
+| manage-import                | Peut synchroniser le podcast importé #\{id\}.                                                        |
+| manage-persons               | Permet de gérer les abonnements au podcast #\{id\}.                                                  |
+| manage-subscriptions         | Permet de gérer les abonnements au podcast #\{id\}.                                                  |
+| manage-contributors          | Permet de gérer les contributeurs du podcast #\{id\}.                                                |
+| manage-platforms             | Peut configurer/supprimer les liens de la plateforme du podcast #\{id\}.                             |
+| manage-publications          | Peut publier le podcast #\{id\}.                                                                     |
+| manage-notifications         | Peut afficher et marquer les notifications comme lues pour le podcast #\{id\}.                       |
+| interact-as                  | Peut interagir en tant que podcast #\{id\} pour mettre en favori, partager ou répondre aux messages. |
+| episodes.view                | Peut voir le tableau de bord et les statistiques du podcast #\{id\}.                                 |
+| episodes.create              | Peut créer des épisodes pour le podcast #\{id\}.                                                     |
+| episodes.edit                | Peut modifier les épisodes du podcast #\{id\}.                                                       |
+| episodes.delete              | Peut supprimer les épisodes du podcast #\{id\}.                                                      |
+| episodes.manage-persons      | Peut gérer les intervenants des épisodes du podcast #\{id\}.                                         |
+| episodes.manage-clips        | Permet de gérer les clips vidéo ou les parties sonores du podcast #\{id\}.                           |
+| episodes.manage-publications | Peut publier/dépublier des épisodes et des messages de podcast #\{id\}.                              |
+| episodes.manage-comments     | Peut créer/supprimer les commentaires de l'épisode du podcast #\{id\}.                               |
+
+{/* AUTH-PODCAST-PERMISSIONS-LIST:END */}

docs/src/content/docs/fr/getting-started/docker.mdx

+---
+title: Images officielles de Docker
+---
+
+Castopod envoie 3 images Docker au Hub Docker pendant son processus de
+construction automatisée :
+
+- [**`castopod/castopod`**](https://hub.docker.com/r/castopod/castopod): une
+  image castopod tout-en-un sous nginx unit
+- [**`castopod/app`**](https://hub.docker.com/r/castopod/app): le paquet
+  d'applications avec toutes les dépendances de Castopod
+- [**`castopod/web-server`**](https://hub.docker.com/r/castopod/web-server): une
+  configuration Nginx pour Castopod
+
+De plus, Castopod nécessite une base de données compatible avec MySQL. Une base
+de données Redis peut être ajoutée en tant que gestionnaire de cache.
+
+## Tags supportés
+
+- `développer` [unstable], la dernière version de la branche de développement
+- `beta` [stable], dernière version bêta
+- `beta` [stable], dernière version bêta
+- `1.x.x` [stable], version spécifique (depuis `1.0.0`)
+
+## Exemple d'utilisation
+
+1. Installez [docker](https://docs.docker.com/get-docker/) et
+   [docker-compose](https://docs.docker.com/compose/install/)
+
+2. Créez un fichier `docker-compose.yml` avec les éléments suivants :
+
+   ```yml
+   version: "3.7"
+
+   services:
+     app:
+       image: castopod/castopod:latest
+       container_name: "castopod-app"
+       volumes:
+         - castopod-media:/var/www/castopod/public/media
+       environment:
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+         CP_BASEURL: "https://castopod.example.com"
+         CP_ANALYTICS_SALT: changeme
+         CP_CACHE_HANDLER: redis
+         CP_REDIS_HOST: redis
+         CP_REDIS_PASSWORD: changeme
+       networks:
+         - castopod-app
+         - castopod-db
+       ports:
+         - 8000:8000
+       restart: unless-stopped
+
+     mariadb:
+       image: mariadb:10.5
+       container_name: "castopod-mariadb"
+       networks:
+         - castopod-db
+       volumes:
+         - castopod-db:/var/lib/mysql
+       environment:
+         MYSQL_ROOT_PASSWORD: changeme
+         MYSQL_DATABASE: castopod
+         MYSQL_USER: castopod
+         MYSQL_PASSWORD: changeme
+       restart: unless-stopped
+
+     redis:
+       image: redis:7.0-alpine
+       container_name: "castopod-redis"
+       command: --requirepass changeme
+       volumes:
+         - castopod-cache:/data
+       networks:
+         - castopod-app
+
+   volumes:
+     castopod-media:
+     castopod-db:
+     castopod-cache:
+
+   networks:
+     castopod-app:
+     castopod-db:
+   ```
+
+   Vous devez adapter certaines variables à vos besoins (p. ex. `CP_BASEURL`,
+   `MYSQL_ROOT_PASSWORD`, `MYSQL_PASSWORD` et `CP_ANALYTICS_SALT`).
+
+3. Setup a reverse proxy for TLS (SSL/HTTPS)
+
+   TLS is mandatory for ActivityPub to work. This job can easily be handled by a
+   reverse proxy, for example with [Caddy](https://caddyserver.com/):
+
+   ```
+   #castopod
+   castopod.example.com {
+       reverse_proxy localhost:8000
+   }
+   ```
+
+4. Exécutez `docker-compose up -d`, attendez qu'il s'initialise sur
+   `https://castopod.example.com/cp-install` pour terminer la configuration de
+   Castopod !
+
+5. Vous êtes prêt, commencez à podcaster! 🎙️🚀
+
+## Environment Variables
+
+- **castopod/castopod** and **castopod/app**
+
+  | Variable name                         | Type (`default`)        | Par défaut       |
+  | ------------------------------------- | ----------------------- | ---------------- |
+  | **`CP_BASEURL`**                      | string                  | `undefined`      |
+  | **`CP_MEDIA_BASEURL`**                | ?string                 | `CP_BASEURL`     |
+  | **`CP_ADMIN_GATEWAY`**                | ?string                 | `"cp-admin"`     |
+  | **`CP_AUTH_GATEWAY`**                 | ?string                 | `"cp-auth"`      |
+  | **`CP_ANALYTICS_SALT`**               | string                  | `undefined`      |
+  | **`CP_DATABASE_HOSTNAME`**            | ?string                 | `"mariadb"`      |
+  | **`CP_DATABASE_NAME`**                | ?string                 | `MYSQL_DATABASE` |
+  | **`CP_DATABASE_USERNAME`**            | ?string                 | `MYSQL_USER`     |
+  | **`CP_DATABASE_PASSWORD`**            | ?string                 | `MYSQL_PASSWORD` |
+  | **`CP_DATABASE_PREFIX`**              | ?string                 | `"cp_"`          |
+  | **`CP_CACHE_HANDLER`**                | [`"file"` or `"redis"`] | `"file"`         |
+  | **`CP_REDIS_HOST`**                   | ?string                 | `"localhost"`    |
+  | **`CP_REDIS_PASSWORD`**               | ?string                 | `null`           |
+  | **`CP_REDIS_PORT`**                   | ?number                 | `6379`           |
+  | **`CP_REDIS_DATABASE`**               | ?number                 | `0`              |
+  | **`CP_EMAIL_SMTP_HOST`**              | ?string                 | `undefined`      |
+  | **`CP_EMAIL_FROM`**                   | ?string                 | `undefined`      |
+  | **`CP_EMAIL_SMTP_USERNAME`**          | ?string                 | `"localhost"`    |
+  | **`CP_EMAIL_SMTP_PASSWORD`**          | ?string                 | `null`           |
+  | **`CP_EMAIL_SMTP_PORT`**              | ?number                 | `25`             |
+  | **`CP_EMAIL_SMTP_CRYPTO`**            | [`"tls"` or `"ssl"`]    | `"tls"`          |
+  | **`CP_ENABLE_2FA`**                   | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_FILE_MANAGER`**           | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_ENDPOINT`**            | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_KEY`**                 | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_SECRET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_REGION`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_BUCKET`**              | ?string                 | `undefined`      |
+  | **`CP_MEDIA_S3_PROTOCOL`**            | ?number                 | `undefined`      |
+  | **`CP_MEDIA_S3_PATH_STYLE_ENDPOINT`** | ?boolean                | `undefined`      |
+  | **`CP_MEDIA_S3_KEY_PREFIX`**          | ?string                 | `undefined`      |
+  | **`CP_DISABLE_HTTPS`**                | ?[`0` or `1`]           | `undefined`      |
+  | **`CP_MAX_BODY_SIZE`**                | ?number (with suffix)   | `512M`           |
+  | **`CP_PHP_MEMORY_LIMIT`**             | ?number (with suffix)   | `512M`           |
+  | **`CP_TIMEOUT`**                      | ?number                 | `900`            |
+
+- **castopod/web-server**
+
+  | Variable name          | Type                  | Par défaut |
+  | ---------------------- | --------------------- | ---------- |
+  | **`CP_APP_HOSTNAME`**  | ?string               | `"app"`    |
+  | **`CP_MAX_BODY_SIZE`** | ?number (with suffix) | `512M`     |
+  | **`CP_TIMEOUT`**       | ?number               | `900`      |