Aller au contenu principal

Importer depuis Markdown, Obsidian et Word

Ce tutoriel présente les deux chemins les plus courants vers un Project Scribe bien organisé :

  • Partie A — Markdown ou Obsidian vers Scribe ;
  • Partie B — Word (.docx) vers Scribe.

Dans les deux cas, les chapitres deviennent des documents Markdown, les images sont placées dans les ressources du Project et l’arborescence est préparée pour l’aperçu et l’export.

Prévoyez environ 30 minutes par partie pour un manuscrit de la longueur d’un roman.

Avant de commencer​

Préparez :

  • un manuscrit terminé ou en cours au format Markdown, Obsidian ou Word ;
  • Scribe installé et connecté, avec n’importe quelle offre ;
  • une sauvegarde du dossier source ou du fichier .docx.

L’import ne remplace pas cette sauvegarde. Contrôlez le contenu importé avant de choisir où vous continuerez à maintenir le manuscrit.

Partie A — Markdown ou Obsidian vers Scribe​

A1. Créer un Project vide​

  1. Ouvrez Scribe et choisissez Nouveau projet sur l’écran d’accueil.
  2. Dans le sélecteur du système, créez ou sélectionnez un dossier vide portant le nom du manuscrit.
  3. Scribe ouvre ce dossier comme Project vide.

Conservez le manuscrit source hors de ce dossier jusqu’au moment de l’import.

A2. Importer les dossiers et fichiers​

Un coffre Obsidian ou dossier Markdown peut déjà ressembler à ceci :

mon-roman/
├── 01-ouverture.md
├── 02-rencontre.md
├── 03-progression.md
└── images/
    ├── carte.png
    └── separateur-chapitre-3.png

Dans le nouveau Project, choisissez Importer > Importer un dossier dans la barre d’actions de l’arborescence. Scribe peut importer ensemble les fichiers .md, .markdown, .txt et .docx, en conservant la hiérarchie d’origine lorsque cela est possible.

Pour organiser vous-même les fichiers, placez les chapitres Markdown dans le dossier du manuscrit et rassemblez les images sous assets/. Scribe détecte les nouveaux fichiers et actualise l’arborescence.

A3. Contrôler les noms, la structure et le front matter​

L’import utilise le nom de chaque fichier comme base du nom de document. Vérifiez les noms, la hiérarchie et la structure du texte.

Le front matter YAML d’Obsidian n’est pas copié dans Paramètres du projet. Examinez les champs tels que tags, cssclass et publish, puis conservez-les, réécrivez-les ou supprimez-les selon vos besoins. Saisissez séparément les informations du livre et de publication dans Paramètres du projet.

A4. Adapter la syntaxe propre à Obsidian​

Syntaxe ObsidianRemplacement conseillé dans Scribe
[[Lien interne]]Lien Markdown [Lien interne](./autre-chapitre.md) ou titre en italique.
[[Image.png]] intégréeImage Markdown ![](assets/Image.png).
![[Note#Titre]]Copiez manuellement le contenu nécessaire. Scribe n’insère pas le contenu d’une note liée.
==surlignage==Remplacez par *emphase* ou supprimez-le.
%%commentaire%%Commentaire HTML <!-- commentaire -->.
Encadré > [!note]Citation Markdown ordinaire ou texte sans la ligne de marqueur.

Pour une conversion en série, ouvrez le dossier dans un éditeur capable d’effectuer un remplacement dans plusieurs fichiers, puis appliquez les changements du moins invasif au plus invasif.

Les liens non reconnus apparaissent comme du texte et n’endommagent pas le Project. Vous pouvez les corriger pendant la relecture.

A5. Vérifier l’ordre des chapitres​

Lorsque les chapitres apparaissent dans l’arborescence, faites-les glisser dans l’ordre de lecture et ouvrez-en quelques-uns pour contrôler le contenu.

A6. Renseigner les informations du Project​

Ouvrez Paramètres du projet et renseignez le titre, le sous-titre, l’auteur, la langue, le résumé et, si nécessaire, la couverture EPUB. Ces informations servent aux shortcodes et à l’export EPUB.

Partie B — Word (.docx) vers Scribe​

Scribe peut importer directement les fichiers .docx. Nettoyez d’abord les styles dans Word, puis choisissez Fichier > Importer un document… pour un fichier ou Importer > Importer un dossier pour plusieurs fichiers. L’import conserve les structures de texte courantes, mais ne reproduit pas l’intégralité de la mise en page Word.

B1. Nettoyer le document Word​

  • Acceptez ou refusez toutes les modifications suivies.
  • Supprimez les commentaires.
  • Utilisez Titre 1 pour les titres de chapitre, Titre 2 ou trois astérisques centrés pour les séparateurs de scène, et le style de corps normal pour les paragraphes.
  • Supprimez les sauts de page ajoutés manuellement à l’intérieur des chapitres.
  • Conservez le texte des légendes dont vous avez besoin. Les images doivent être ajoutées de nouveau après l’import et Scribe ne propose pas de champ séparé pour les légendes.

B2. Importer le fichier​

Pour un document unique, utilisez Fichier > Importer un document…. Si le livre est déjà divisé en plusieurs fichiers de chapitre, choisissez Importer > Importer un dossier.

Après l’import, vérifiez en priorité :

  • l’ordre des titres, paragraphes, caractères gras et italiques, liens, listes, citations et blocs de code ;
  • l’emplacement des séparateurs de scène ;
  • les tableaux, images et notes qui doivent être recréés ou réécrits.

B3. Diviser selon les titres​

Avant d’importer un long document, activez Diviser le document par titre # si chaque titre de niveau 1 doit devenir un document Scribe distinct. Des documents séparés facilitent l’ordre de l’arborescence, l’inclusion dans la compilation et le choix de la portée d’export.

B4. Nettoyer les traces de conversion​

  • Supprimez les retours souples indésirables au milieu des paragraphes.
  • Conservez les guillemets typographiques si l’import les a correctement repris.
  • Supprimez les ancres de signet inutiles.
  • Remplacez les styles de caractères Word par *italique* ou **gras** lorsque cela convient.
  • Réécrivez les tableaux complexes sous forme de paragraphes, listes ou images.
  • Ajoutez de nouveau les images avec Insérer une image > Importer depuis le disque….

B5. Utiliser pandoc si nécessaire​

Pour un processus en ligne de commande ou une conversion en série, vous pouvez convertir les fichiers .docx en Markdown compatible GitHub avec pandoc, puis suivre la partie A. Cette méthode permet de contrôler les fichiers convertis avant leur import dans Scribe.

Ce que vous avez appris​

  • adapter un coffre Obsidian à l’organisation d’un Project Scribe ;
  • remplacer la syntaxe Obsidian non prise en charge ;
  • importer un fichier Word, contrôler la structure préservée et recréer les éléments non pris en charge ;
  • préparer les informations, les images, l’ordre de compilation et les exports.

Pour continuer​