Skip to content

Conversation

@ArmandPhilippot
Copy link
Member

Description

Updates the French translations in guides to:

  • revert some unwanted translations (syntaxe frontale, matière première for frontmatter)
  • translate docs
  • replace the translation for inline (en ligne is usually the wrong translation)
  • fix some bad translations (backticks > accents graves, blockquotes > bloc de citation)
  • replace supporte with prend en charge (support is an anglicism)
  • use French quotes
  • fix some Astro docs links because of updates on the French version
  • translate plugin to be consistent with the other docs pages
  • add missing space before some punctuation
  • respect verb agreement (propriété > utilisée instead of utilisé)
  • translate package
  • replace actifs (financial/crypto word) with ressources for assets
  • use non breaking space before punctuation in some places to avoid:

starlight-without-non-breaking-spaces-example

(note the colon on a new line)


One thing I haven't updated for consistency: en-tête/titre. In Astro Docs we use titre for headings while in most places, Starlight uses en-tête. I could have replaced the titre occurrences in authoring-content but I'm a bit torn.
While titre de niveau 2 sounds correct to me, en-tête de niveau 2 sounds unusual to me. So I wasn't sure what to do and so I preferred to leave them as they are. For reference, LibreOffice uses titre in French when the English version uses heading:

French English
libre-office-french-heading libre-office-english-heading

Note: This is not necessarily blocking for this PR since I haven't updated that! But we might want to think about it to make things consistent in a future PR!

@changeset-bot
Copy link

changeset-bot bot commented Sep 16, 2025

⚠️ No Changeset found

Latest commit: bf75055

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@netlify
Copy link

netlify bot commented Sep 16, 2025

Deploy Preview for astro-starlight ready!

Name Link
🔨 Latest commit bf75055
🔍 Latest deploy log https://app.netlify.com/projects/astro-starlight/deploys/68ca95f4766ec30008bce130
😎 Deploy Preview https://deploy-preview-3431--astro-starlight.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 100 (no change from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added i18n Anything to do with internationalization & translation efforts 📚 docs Documentation website changes labels Sep 16, 2025
@astrobot-houston
Copy link
Contributor

astrobot-houston commented Sep 16, 2025

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

Locale File Note
fr guides/authoring-content.mdx Localization changed, will be marked as complete.
fr guides/css-and-tailwind.mdx Localization changed, will be marked as complete.
fr guides/customization.mdx Localization changed, will be marked as complete.
fr guides/i18n.mdx Localization changed, will be marked as complete.
fr guides/overriding-components.mdx Localization changed, will be marked as complete.
fr guides/pages.mdx Localization changed, will be marked as complete.
fr guides/project-structure.mdx Localization changed, will be marked as complete.
fr guides/site-search.mdx Localization changed, will be marked as complete.
fr reference/configuration.mdx Localization changed, will be marked as complete.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

Copy link
Member

@HiDeoo HiDeoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Amazing, definitely some old translations that probably predate both of us in there, really neat update 🙌

Regarding "titre" vs "en-tête", while some websites like MDN or even the W3C use both of them, I think I personally like the explicit different word for headings in the Starlight context. In Starlight, we have the project title in the Astro config that impacts the document <title>, we have the page title in content files that also impacts the document <title> and what is displayed in the <PageTitle/> component. I think having a dedicated word for headings, like in English, can avoid some potential confusions (but maybe I'm wrong).

@ArmandPhilippot
Copy link
Member Author

Thanks for the feedback, I know you've explained this in the past but reading "en-tête de niveau 2" made me doubt. 😅

So, before merging this one, I'll add a new update to make the use of en-tête/title consistent, no need for a separate PR for this!

@ArmandPhilippot
Copy link
Member Author

Done! I spotted another one in reference/configuration so I included it here.

Copy link
Member

@HiDeoo HiDeoo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the follow-up 🌟

@ArmandPhilippot ArmandPhilippot merged commit 341dd28 into withastro:main Sep 17, 2025
16 checks passed
@ArmandPhilippot ArmandPhilippot deleted the i18n/fr-update-guides branch September 17, 2025 11:18
HiDeoo added a commit to HiDeoo/starlight that referenced this pull request Oct 2, 2025
* main: (26 commits)
  i18n(ja): resources/themes (withastro#3442)
  add openstatus showcase (withastro#3436)
  [ci] release (withastro#3434)
  Add `head` config validation for `meta` tags with `content` (withastro#3380)
  Fix Astro Island margins in Markdown (withastro#3340)
  Ensure tab links span the full tab height (withastro#3427)
  Move `<summary>` to top of `<details>` for validity (withastro#3423)
  Run all tests on CI workflow changes (withastro#3433)
  [ci] format
  i18n(fr): small rewording and fixes in top-level pages (withastro#3432)
  i18n(fr): small rewording and fixes in `guides` (withastro#3431)
  i18n(fr): fix typo and links in `reference` files (withastro#3429)
  i18n(fr): small rewording in `components` (withastro#3430)
  [ci] release (withastro#3384)
  i18n(de): Update `page.lastUpdated` translation to be more in‐line with the English translation (withastro#3416)
  Remove invalid value attribute from `<select>` (withastro#3421)
  Convert invalid `<div>` child of `<summary>` to `<span>` (withastro#3422)
  [i18nIgnore] Fix typo in Spanish docs documentation (withastro#3408)
  chore(deps): update actions/labeler action to v6.0.1 (withastro#3407)
  [i18nIgnore] Fix duplicate i18n collection definition (withastro#3409)
  ...
HiDeoo added a commit to HiDeoo/starlight that referenced this pull request Oct 7, 2025
* main: (72 commits)
  Showcase: Add Saucer (withastro#3454)
  i18n(ja): resources/themes (withastro#3442)
  add openstatus showcase (withastro#3436)
  [ci] release (withastro#3434)
  Add `head` config validation for `meta` tags with `content` (withastro#3380)
  Fix Astro Island margins in Markdown (withastro#3340)
  Ensure tab links span the full tab height (withastro#3427)
  Move `<summary>` to top of `<details>` for validity (withastro#3423)
  Run all tests on CI workflow changes (withastro#3433)
  [ci] format
  i18n(fr): small rewording and fixes in top-level pages (withastro#3432)
  i18n(fr): small rewording and fixes in `guides` (withastro#3431)
  i18n(fr): fix typo and links in `reference` files (withastro#3429)
  i18n(fr): small rewording in `components` (withastro#3430)
  [ci] release (withastro#3384)
  i18n(de): Update `page.lastUpdated` translation to be more in‐line with the English translation (withastro#3416)
  Remove invalid value attribute from `<select>` (withastro#3421)
  Convert invalid `<div>` child of `<summary>` to `<span>` (withastro#3422)
  [i18nIgnore] Fix typo in Spanish docs documentation (withastro#3408)
  chore(deps): update actions/labeler action to v6.0.1 (withastro#3407)
  ...
HiDeoo added a commit to HiDeoo/starlight that referenced this pull request Oct 14, 2025
* main: (87 commits)
  i18n(ja): sync outdated aside page (withastro#3465)
  i18n(ja): sync outdated icon reference (withastro#3467)
  chore(deps): update pnpm/action-setup action to v4.2.0 (withastro#3460)
  Showcase: Add Saucer (withastro#3454)
  i18n(ja): resources/themes (withastro#3442)
  add openstatus showcase (withastro#3436)
  [ci] release (withastro#3434)
  Add `head` config validation for `meta` tags with `content` (withastro#3380)
  Fix Astro Island margins in Markdown (withastro#3340)
  Ensure tab links span the full tab height (withastro#3427)
  Move `<summary>` to top of `<details>` for validity (withastro#3423)
  Run all tests on CI workflow changes (withastro#3433)
  [ci] format
  i18n(fr): small rewording and fixes in top-level pages (withastro#3432)
  i18n(fr): small rewording and fixes in `guides` (withastro#3431)
  i18n(fr): fix typo and links in `reference` files (withastro#3429)
  i18n(fr): small rewording in `components` (withastro#3430)
  [ci] release (withastro#3384)
  i18n(de): Update `page.lastUpdated` translation to be more in‐line with the English translation (withastro#3416)
  Remove invalid value attribute from `<select>` (withastro#3421)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

📚 docs Documentation website changes i18n Anything to do with internationalization & translation efforts

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants