Aller au contenu principal

Documentation en ligne

Le site Docusaurus est géré dans le dépôt oo-software/oodi-net-help, sous src.

Langues et structure​

Les pages sources anglaises se trouvent dans src/docs. Les traductions allemandes et françaises se trouvent dans src/i18n/<locale>/docusaurus-plugin-content-docs/current, avec les mêmes chemins relatifs. Les trois langues du site, en, de et fr, sont configurées dans src/docusaurus.config.ts. Les langues de l’interface de l’application ne créent pas automatiquement de manuels traduits.

src/sidebars.ts définit la navigation et l’ordre des chapitres PDF. Traduisez les textes de la page d’accueil dans src/i18n/<locale>/code.json et les catégories dans le fichier current.json de la langue.

Terminologie et liens d’aide​

Utilisez les libellés actuels de l’application. Un plan contient sa configuration, une version est un point de restauration enregistré et une exécution correspond à une opération. Distinguez la destination d’une sauvegarde de la cible écrasée par une restauration ou un clonage.

Conservez les chemins des pages et les ancres explicites utilisés par l’aide F1, même si le titre visible change. En particulier, rescue-media-fortress-mode#fortress-mode reste le lien de l’application vers l’environnement de récupération renommé.

La correspondance des identifiants d’aide se trouve dans le dépôt de l’application, dans src/OOSoftware.DiskImage.Shared/Configuration/OEM/SharedGlobals.cs. Vérifiez chaque chemin et chaque ancre dans toutes les langues générées.

Revue de la documentation du 9 octobre 2026​

La revue a comparé les pages anglaises et allemandes publiées avec le journal des modifications, les ressources de l’interface et l’implémentation de la branche B_OODI_ENG_23.0, jusqu’au commit 2e84cdf47f5547c4d523fc8e8fb2d2ee0b30f0be. Le point de départ de la documentation était 881a5f2 ; le site publié décrivait encore l’option supprimée permettant d’ignorer la validation des partitions de récupération.

Domaine modifiéDocumentation
Configuration des plans, valeurs automatiques, sources modifiables, sauvegarde complète ponctuellePremiers pas ; Sources de sauvegarde ; Plans et sauvegardes enregistrées
Préréglages d’historique, dépendances des chaînes et conservation permanenteOptions de sauvegarde ; Plans et sauvegardes enregistrées
Deuxièmes copies locales et cloud, nouvelles tentatives et restauration depuis la copieDeuxième copie ; Destinations de sauvegarde ; Restauration
Planification mensuelle, sortie de veille, rattrapage, service et zone de notificationPlanifications et automatisation
VHD/VHDX, points de contrôle, verrouillage des sources, limites de conversion et de restaurationOptions de sauvegarde ; Outils ; Restaurer des lecteurs
Exclusions des disques virtuels et réglages de versions verrouillésSources de sauvegarde ; Noms de fichiers et exclusions ; Paramètres
Environnement de récupération renommé, reprise après redémarrage, supports et recréationSupports de secours et environnement de récupération
Rapports, raisons des sauvegardes complètes, avertissements de copie, e-mails et diagnosticRapports et journaux ; Problèmes courants ; Paramètres
Navigation des utilitaires et vérification de WindowsOutils ; Questions fréquentes

Les projets inachevés ne sont pas présentés comme des fonctions disponibles. En particulier, l’offre automatique de rendre amorçable un lecteur de sauvegarde existant nécessite encore du travail sur l’interface et l’enchaînement des opérations, décrit dans docs/design/bootable-backup-drive.md du dépôt de l’application.

La traduction française reprend cette documentation révisée et conserve les mêmes chemins de pages et ancres d’aide.

Une modification des sources ne publie pas le site. Déployez le site reconstruit et les manuels régénérés avec la procédure habituelle de publication, puis vérifiez les pages publiques.

Développement local​

Depuis src :

npm ci
npm start

Générez toutes les langues configurées et vérifiez TypeScript avec :

npm run build
npm run typecheck

Générez les manuels PDF de toutes les langues avec :

npm run build:pdf

Les consignes de capture d’écran se trouvent dans SCREENSHOTS.md, à la racine du dépôt. Ajoutez des captures réelles, récentes et dans la langue correspondante lorsqu’elles sont disponibles. N’affichez pas de consignes de capture ni d’emplacements d’images manquantes dans le guide utilisateur.