diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md index 46d18ff..7189f5f 100644 --- a/docs/canvas-pilot/changelog.md +++ b/docs/canvas-pilot/changelog.md @@ -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. diff --git a/docs/canvas-pilot/guide/fr/quickstart.md b/docs/canvas-pilot/guide/fr/quickstart.md new file mode 100644 index 0000000..43a1437 --- /dev/null +++ b/docs/canvas-pilot/guide/fr/quickstart.md @@ -0,0 +1,114 @@ +
+ +# 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. + + + +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. + +
diff --git a/docs/canvas-pilot/guide/quickstart.md b/docs/canvas-pilot/guide/quickstart.md index f0761d6..4e6449e 100644 --- a/docs/canvas-pilot/guide/quickstart.md +++ b/docs/canvas-pilot/guide/quickstart.md @@ -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 diff --git a/docs/canvas-pilot/introduction.md b/docs/canvas-pilot/introduction.md index fd803cc..c978a29 100644 --- a/docs/canvas-pilot/introduction.md +++ b/docs/canvas-pilot/introduction.md @@ -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: diff --git a/docs/canvas-pilot/plan.md b/docs/canvas-pilot/plan.md index ee556ca..4a3a438 100644 --- a/docs/canvas-pilot/plan.md +++ b/docs/canvas-pilot/plan.md @@ -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 diff --git a/docs/development/localization.md b/docs/development/localization.md index 03780b7..52aa69c 100644 --- a/docs/development/localization.md +++ b/docs/development/localization.md @@ -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 diff --git a/docs/manuals/canvas-pilot/SUMMARY.md b/docs/manuals/canvas-pilot/SUMMARY.md index 6482eb2..1f57e46 100644 --- a/docs/manuals/canvas-pilot/SUMMARY.md +++ b/docs/manuals/canvas-pilot/SUMMARY.md @@ -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