Add unverified French quick-start translation pilot
Gitea/canvas-pilot/pipeline/head This commit looks good
Details
Gitea/canvas-pilot/pipeline/head This commit looks good
Details
This commit is contained in:
parent
1ac01cbf65
commit
b35f42328f
|
|
@ -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.
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
||||

|
||||
|
||||
*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>
|
||||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Reference in New Issue