Add unverified French quick-start translation pilot
Gitea/canvas-pilot/pipeline/head This commit looks good Details

This commit is contained in:
Dandaedre 2026-11-16 14:30:59 +01:00
parent 1ac01cbf65
commit b35f42328f
7 changed files with 164 additions and 7 deletions

View File

@ -4,6 +4,10 @@
## Unreleased
- Added a French quick-start pilot with English fallback links and an explicit
unverified machine-translation notice. Screenshots and application labels remain
English; the source revision and update workflow are recorded for maintenance.
- Recorded the multi-screen design task, including shared layers, alignment and
automatic/custom proportional scaling. Existing-feature testing and a visual-only
prototype precede implementation; application behavior is unchanged.

View File

@ -0,0 +1,114 @@
<div lang="fr">
# Démarrage rapide : votre première composition
**Français** · [English — version de référence](../quickstart.md)
> **Traduction automatique non vérifiée.** Cette page n’a pas été relue ni validée
> par une personne francophone. Le [manuel anglais](../../introduction.md) fait
> référence et peut évoluer avant cette traduction. En cas de doute ou de différence,
> consultez la version anglaise. Seul ce démarrage rapide est traduit pour le moment.
> L’application et les captures restent en anglais ; les noms des commandes sont
> conservés tels qu’ils apparaissent à l’écran. Les liens vers les autres chapitres
> mènent à des pages en anglais.
<!-- Translation source: docs/canvas-pilot/guide/quickstart.md at 1ac01cbf65dbad206f5b989f24924333e688f646. Machine translated; human review pending. -->
Créez une composition simple avec les calques **Slides** (diapositives) et
**Presenter** (présentateur), enregistrez un projet modifiable, puis exportez sa
géométrie. Ce tutoriel utilise le canevas Full HD par défaut et fonctionne hors
ligne : aucun processeur vidéo n’est nécessaire.
## 1. Ouvrir une nouvelle composition
Suivez d’abord les [instructions d’installation et de mise à jour (en anglais)](../install.md),
puis lancez Canvas Pilot. Si vous travaillez depuis les sources du projet, exécutez
cette commande à la racine du dépôt :
```sh
cargo run --locked -p canvas-pilot
```
Consultez la [configuration de développement (en anglais)](../../../development/README.md)
si vous avez besoin des outils de compilation. Si une composition précédente a été
restaurée, enregistrez le travail à conserver, puis choisissez
**Project → New project…** et confirmez.
Le canevas par défaut mesure **1920 × 1080** et contient les calques **Slides** et
**Presenter**. Conservez cette résolution pour ce tutoriel.
![Composition Full HD par défaut avec Slides et Presenter ; Presenter est sélectionné](../../images/01-workspace.png)
*Capture de l’interface en anglais, réutilisée sans modification.*
## 2. Placer et dimensionner les calques
1. Cliquez sur **Presenter** dans la liste **Layers** ou sur le canevas.
2. Faites glisser le calque pour le déplacer. Faites glisser une poignée d’angle
pour le redimensionner ; laissez **Keep aspect ratio when resizing** coché
pour conserver ses proportions.
3. Pour un placement précis, utilisez les champs de position de l’inspecteur.
Vérifiez d’abord le coin de référence choisi : **From right** mesure la distance
depuis le bord droit, et non depuis le bord gauche.
4. Sélectionnez **Slides** et placez-le à côté du présentateur. Utilisez **Undo**
pour annuler un déplacement ou un redimensionnement qui ne vous convient pas.
Le champ de résolution du calque ouvre **Layer properties**, où vous pouvez saisir
une largeur et une hauteur exactes. Conservez les dimensions par défaut si vous
souhaitez seulement essayer le placement.
## 3. Essayer le cadrage du contenu
Avec **Presenter** sélectionné, ouvrez **Layer properties → Crop**. La mire de la
source montre comment le contenu s’inscrit dans le rectangle visible du calque.
Faites glisser le contenu pour ajuster sa position ou utilisez les poignées de
recadrage pour modifier son zoom.
Le rectangle visible du calque reste fixe pendant le recadrage. Utilisez
**Reset crop** pour retrouver le cadrage par défaut, puis revenez à l’onglet
**Layer** pour terminer. Vous pouvez ignorer cette étape si seules les positions
des rectangles vous intéressent.
## 4. Enregistrer le projet modifiable
Appliquez les modifications de propriétés en attente, puis choisissez
**Project → Save project…** et enregistrez le fichier sous
`first-layout.pilot.json`. C’est ce fichier qu’il faut rouvrir pour poursuivre
l’édition : il conserve le projet, notamment les réglages des sources, le recadrage
et les images de référence.
Utilisez **Project → Open project…** pour le charger ultérieurement.
## 5. Exporter la géométrie des calques
Choisissez **Project → Export → Export layers…**, sélectionnez **SVG** et
**All layers**, puis cliquez sur **Export…** et enregistrez le fichier. Pour exporter
uniquement les rectangles des calques, laissez désactivées les images d’arrière-plan
et les images de substitution. Le SVG peut être ouvert dans un éditeur vectoriel.
Comparez les possibilités des fichiers et du presse-papiers dans le
[tableau des fonctionnalités par format (en anglais)](../format-matrix.md)
avant de choisir un format d’échange.
Conservez aussi le projet `.pilot.json` : un export de géométrie ne garde pas tous
les réglages de l’éditeur. Le [catalogue de modèles (en anglais)](../../../templates/canvas-pilot/catalog.md)
propose des compositions équivalentes dans chaque format pris en charge si vous
préférez commencer dans une autre application.
## Poursuivre avec le guide avancé
Vous disposez maintenant d’un projet modifiable et d’un export de géométrie.
Choisissez la prochaine étape parmi ces chapitres **en anglais** :
- [Organiser et aligner les calques](../editing.md), avec les dossiers et les sélections multiples.
- [Ajouter des images de référence et ajuster la vue du canevas](../canvas.md).
- [Régler les formats des sources et le recadrage](../formats-and-crop.md).
- [Importer une géométrie existante ou choisir les éléments à exporter](../files.md).
- [Connecter un Eikos 4K et vérifier les transferts de calques](../device.md).
L’envoi vers un appareil est une action explicite ; l’édition locale ordinaire
n’envoie aucune modification.
Le [guide avancé (en anglais)](../overview.md) donne aussi accès aux réglages,
aux contrats de compatibilité et aux détails des vérifications matérielles.
</div>

View File

@ -1,5 +1,7 @@
# Quick start: your first layout
**English — authoritative version** · [Français — traduction automatique non vérifiée](fr/quickstart.md)
[Introduction](../introduction.md) · [Advanced guide](overview.md) · [Starter files](../../templates/canvas-pilot/catalog.md)
Make a simple Slides + Presenter layout, save an editable project, and export its

View File

@ -14,6 +14,9 @@ a supported Midra 4K or Aquilon / LivePremier device when you are ready to revie
[Install and update](guide/install.md) · [Quick start](guide/quickstart.md) · [Advanced guide](guide/overview.md) · [Starter files for all formats](../templates/canvas-pilot/catalog.md) · [Changelog](changelog.md)
[Démarrage rapide en français — traduction automatique non vérifiée](guide/fr/quickstart.md).
The rest of the manual remains in English, the authoritative source.
## Start a layout
Run the desktop app from the repository root:

View File

@ -104,7 +104,9 @@ Publication is pending an issue-enabled token; the current token lacks
- [ ] **Localization: book first, application second.** Follow the
[localization roadmap](../development/localization.md) for language selection,
translation workflow, publishing, UI catalogs and compatibility checks. Detailed
tasks and acceptance criteria live there; no translations are shipped yet.
tasks and acceptance criteria live there. A French quick-start pilot is available
as an unverified machine translation; the rest of the book and application remain
English. Human review and broader localization are still pending.
- [ ] **Video showcase, manual and optional chapter demonstrations.** Record a
short showcase for the README and book introduction, then a guided video manual

View File

@ -2,13 +2,44 @@
[Development](README.md) · [Project plan](../canvas-pilot/plan.md)
Deliver the translated **book first**, then the **application**. This is a task
list, not an announcement of available languages. Keep detailed completion status
here and the overall milestone in the project plan.
## Current pilot: French quick start only
English remains the source language. French is the suggested first translation
for proving the workflow; confirm the initial languages before starting translation.
Keep the process small enough to maintain without a dedicated translation service.
The [French quick start](../canvas-pilot/guide/fr/quickstart.md) is an explicitly
unverified machine translation, requested as a small first step. English remains
authoritative. No application translation, screenshot changes or human review is
claimed. The rest of the manual remains English, with explicit fallback links.
For this one-chapter pilot, use translated Markdown in `guide/fr/` and the existing
mdBook build. The summary and reciprocal chapter links expose the language choice;
a `lang="fr"` wrapper identifies French content while the book navigation stays
English. The warning appears in the chapter and print view. Existing assets and
English URLs remain unchanged. Do not duplicate the whole book for this pilot.
The translation comment records the English source commit. When updating the English
quick start, compare it with that revision, update the French text (or visibly mark
it outdated), and advance the recorded revision only after translating the changes.
For the initial source revision:
```sh
git diff 1ac01cbf65dbad206f5b989f24924333e688f646 -- docs/canvas-pilot/guide/quickstart.md
```
The initial difference is only the new reciprocal language link. Human review remains
pending; build/link checks are not linguistic verification. Keep the visible warning
until an actual review establishes a new status. Run the pinned manual build after
updates and check French accents, links, screenshots, search and print output.
For a larger translation effort, evaluate
[mdbook-i18n-helpers / gettext](https://github.com/google/mdbook-i18n-helpers/blob/main/i18n-helpers/USAGE.md)
for extracting messages and tracking changed translations. mdBook's
[language setting](https://rust-lang.github.io/mdBook/format/configuration/general.html)
sets book language metadata; it does not manage translation freshness. Separate
language builds and a full language selector remain future work. Do not introduce
both Markdown and gettext as competing maintained translation sources.
The checklist below describes that broader future work. The pilot intentionally
ships without a reviewer, with the explicit warning above; the later reviewed-book
publication criteria do not describe its current status.
## 1. Localize the book

View File

@ -6,6 +6,7 @@
- [Install and update](../../canvas-pilot/guide/install.md)
- [Your first layout](../../canvas-pilot/guide/quickstart.md)
- [Français — démarrage rapide (non vérifié)](../../canvas-pilot/guide/fr/quickstart.md)
- [Starter files for every format](../../templates/canvas-pilot/catalog.md)
# Using Canvas Pilot