# French translation of the Website
**URL:** https://forum.antennapod.org/t/french-translation-of-the-website/1454
**Category:** Translations
**Tags:** french
**Created:** [November 2, 2021, 10:56am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454 "2021-11-02T10:56:14Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@Kusco](https://forum.antennapod.org/u/Kusco)
#### Post date: [November 2, 2021, 10:56am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/1 "2021-11-02T10:56:14Z")
Hello,
Are there any plans to translate the website into other languages?
There are few texts today, I can easily offer you a French translation.
Ideally, going through Transifex, but I don’t know what is already in place in terms of the structure of the website.
Thank you for your work and for your time!
Francois
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 2, 2021, 7:17pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/2 "2021-11-02T19:17:03Z")
Thanks for offering your help!
> I don’t know what is already in place in terms of the structure of the website.
Currently only the general texts (main page, etc) can be translated. The blog posts and the documentation cannot be translated because keeping the translations up-to-date and not having conflicting information would be hard to do there.
I’m not 100% sure yet if we really want to have the website translations on Transifex. The reason is that these need special care (wording should be considered more carefully than in the app). However, we also have the Google Play description on Transifex, so maybe it actually is okay to put them there. What do you think, @keunes?
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 4, 2021, 9:45pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/3 "2021-11-04T21:45:39Z")
Actually I think it’s fine to have everything on Transifex, though I’m wondering if we (before connecting the site with Transifex) should look into moving to another (open source) platform as discussed in another thread. (Don’t know how much effort it is to connect the site with Transifex?)
As for what to translate: I believe we said everything (incl documentation) except the blog posts. Documentation shouldn’t change _too_ often, hopefully.
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 4, 2021, 10:21pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/4 "2021-11-04T22:21:45Z")
> [@keunes](#):
>
> I believe we said everything (incl documentation)
Hmm, the documentation currently does not seem to be translatable
> [@keunes](#):
>
> I’m wondering if we (before connecting the site with Transifex) should look into moving to another (open source) platform
I’m still not really convinced. It risks losing translators and does not really have advantages. The good (and bad) thing about large platforms is that that’s where the people are.
> [@keunes](#):
>
> Don’t know how much effort it is to connect the site with Transifex?
Transifex can read the main yaml translation file directly. The pages need to be added as individual resources, which could get pretty cluttered (and a bit of work). I don’t think other translation services have better support for translating a whole folder of text files. That also means that whenever a new markdown file is created, we need manual action to register the file with the translation service. Feels like it kind of destroys the advantages of automatically creating pages from markdown files.
If there really is no way to have all pages in a single resource, we probably need to use another project inside the organization anyway (otherwise the actual app will get lost between hundreds of website resources). Maybe we could do the website on another service and keep the app on Transifex.
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 5, 2021, 8:06am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/5 "2021-11-05T08:06:07Z")
> [@ByteHamster](#):
>
> Maybe we could do the website on another service and keep the app on Transifex.
That could be a nice middle ground. It seems that [neither pontoon](https://mozilla-pontoon.readthedocs.io/en/latest/index.html) [nor weblate](https://docs.weblate.org/en/latest/formats.html) can directly handle MD files. Weblate has support for simple [text](https://docs.weblate.org/en/latest/formats.html#txt) files in beta, however. A README file is given as an example, which is often in MD, so it might work.
From an [SO question](https://stackoverflow.com/questions/59681143/what-is-the-best-way-to-localize-markdown-files-in-weblate#59692247) it seems that new items can be created in Weblate automatically if new (site) content is added. But it seems that it’s still best to transform MD files to PO files first. Would be great if that could be automised in a GitHub action, but couldn’t find any hints or marketplace item for this.
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 5, 2021, 7:52pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/6 "2021-11-05T19:52:17Z")
> [@keunes](#):
>
> From an [SO question](https://stackoverflow.com/questions/59681143/what-is-the-best-way-to-localize-markdown-files-in-weblate#59692247) it seems that new items can be created in Weblate automatically if new (site) content is added.
Oh nice, that’s exactly what I was looking for 🙂
> [@keunes](#):
>
> Would be great if that could be automised in a GitHub action
Sounds like we would then need to have two versions of each file in the repo. That’s not really clean
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 5, 2021, 11:29pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/7 "2021-11-05T23:29:34Z")
Just found [https://mdpo.readthedocs.io](https://mdpo.readthedocs.io) which can create PO files from MD files.
> [@ByteHamster](#):
>
> Sounds like we would then need to have two versions of each file in the repo. That’s not really clean
Ideally multiple MD files are combined into a single PO file. E.g. one for Home, one for Documentation, one for Contribute, and one for About. Not sure that’s easy though. Quickly had a look at the `mdpo` docs but didn’t see a way to combine multiple MD files into one po file.
That would also help keep clean the translation tool; one Website project with four (section-based) resources.
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 6, 2021, 7:59am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/8 "2021-11-06T07:59:07Z")
What happens with the existing translations when the source file changes? Does that tool create po keys that are somehow reproducible?
Wouldn’t it be better to translate one documentation page as a whole instead of paragraph-by-paragraph? Makes it more consistent.
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 6, 2021, 8:22am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/9 "2021-11-06T08:22:43Z")
> [@ByteHamster](#):
>
> What happens with the existing translations when the source file changes? Does that tool create po keys that are somehow reproducible?
Since PO keys seem to be the source text, I don’t think keys are consistent throughout time. But that shouldn’t be a problem because the tools have a translation memory, and should normally suggest an old translation if there was a minor change.
> [@ByteHamster](#):
>
> Wouldn’t it be better to translate one documentation page as a whole instead of paragraph-by-paragraph? Makes it more consistent.
What do you mean with ‘as a whole’ - as one single ‘string’? (I wouldn’t want that as it’d be one massive text that is hard to translate and hard to spot errors in.)
At most I’d say we can have one string per category, but it sounds complicated to make that happen.
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 6, 2021, 9:30am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/10 "2021-11-06T09:30:42Z")
> [@keunes](#):
>
> PO keys seem to be the source text
OK, that should work then
> [@keunes](#):
>
> I wouldn’t want that as it’d be one massive text that is hard to translate and hard to spot errors in.
OK
* * *
Okay, so every time someone changes the translations, we would need a CI task that creates a second commit that re-creates the PO files?
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 6, 2021, 9:36am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/11 "2021-11-06T09:36:10Z")
> [@ByteHamster](#):
>
> Okay, so every time someone changes the translations, we would need a CI task that creates a second commit that re-creates the PO files?
I think so yeah, or in any case the POT files (which only contain the source strings).
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 6, 2021, 9:57am UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/12 "2021-11-06T09:57:33Z")
Hmm, that clutters the commit history so much 😕 More than every second commit would then be an automated one. Additionally, Weblate creates a bunch of commits (see [Commits · Etar-Group/Etar-Calendar · GitHub](https://github.com/Etar-Group/Etar-Calendar/commits/master) for example). Makes it very hard to see what the actual changes are and what’s just noise.
Transifex does handle markdown files directly.
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 6, 2021, 12:31pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/13 "2021-11-06T12:31:34Z")
I don’t think a cluttered git history is a big a problem as with the app, because it’s a much more simple (& stabl) codebase.
Weblate credits the translator for their work, rather than taking credit itself 😉
To limit history clutter we could have a dedicated translations branch, where once in a while we manually commit changes to main (e.g. when all languages are updated after a site change).
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 6, 2021, 1:22pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/14 "2021-11-06T13:22:13Z")
Update: mdpo can create a single PO file from multiple MD files: [Multiple MD files in one PO file · Issue #169 · mondeja/mdpo · GitHub](https://github.com/mondeja/mdpo/issues/169#issuecomment-962449983)
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 6, 2021, 1:46pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/15 "2021-11-06T13:46:04Z")
Okay, do you want to look into setting this up? I would suggest to use 3 resources:
- General user interface (`_i18n/en.yml`)
- Pages (`_i18n/en/*.md`)
- Documentation (not supported by the website yet, I would try the other things first and see how that goes)
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 6, 2021, 5:15pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/16 "2021-11-06T17:15:18Z")
Due to [Bring back arm/v7 images · Issue #968 · WeblateOrg/docker · GitHub](https://github.com/WeblateOrg/docker/issues/968) I’m not able to build Weblate on my RPi and Pontoon Docker throws an error as well (and is not intended for production anyway). I’m now trying to set up translations using hosted weblate (on my fork of the website). Let’s see how this goes 😛
---
### Author:  [@ByteHamster](https://forum.antennapod.org/u/ByteHamster)
#### Post date: [November 6, 2021, 5:20pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/17 "2021-11-06T17:20:43Z")
I think using the hosted version is better anyways because we do not need to maintain it and translators already have an account
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 6, 2021, 10:53pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/18 "2021-11-06T22:53:27Z")
Bon, I’m stuck for the moment: [Cannot push translations: "Fork creation failed: not found" · WeblateOrg · Discussion #6763 · GitHub](https://github.com/WeblateOrg/weblate/discussions/6763)
> [@ByteHamster](#):
>
> the hosted version is better anyways because we do not need to maintain it
For Weblate yes - but if we could’ve run Pontoon easily I would’ve preferred that given its Translator interface.
---
### Author:  [@keunes](https://forum.antennapod.org/u/keunes)
#### Post date: [November 10, 2021, 3:50pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/19 "2021-11-10T15:50:57Z")
@Kusco Just to give you an update: I’m trying to optimise the website for translations, and prepare some automation (so that when new website texts are added, they show up in the translations tool). It might take another week or two to complete it, but I’ll announce it here when the system is ready for translations. Thanks for putting this in motion!
---
### Author:  [@Kusco](https://forum.antennapod.org/u/Kusco)
#### Post date: [November 10, 2021, 4:04pm UTC](https://forum.antennapod.org/t/french-translation-of-the-website/1454/20 "2021-11-10T16:04:56Z")
No problem @keunes, I followed the whole conversation (I studied computer science).
Thank you for your time and for your work. I’ll be happy to participate when the time is right 🙂
[Next page](https://forum.antennapod.org/t/french-translation-of-the-website/1454.md?page=2)