Fichiers Markdown

Markdown est un format de fichier en texte brut populaire pour créer du texte formaté. Par exemple, de nombreux développeurs de logiciels l’utilisent pour créer facilement de la documentation. Il a de nombreuses variantes différentes (également appelées saveurs). memoQ prend en charge la saveur la plus largement utilisée, CommonMark, et montre un aperçu de l’apparence du fichier lorsqu’il est converti en HTML.

La syntaxe CommonMark a des règles très compliquées sur la façon d’écrire certains éléments, afin que la conversion en HTML fonctionne de la manière la plus claire possible. Cette discussion ne traite pas tous les détails. Pour en savoir plus, lisez la dernière version des CommonMark Caractéristiques.

Comment se rendre ici

Commencez à importer un fichier Markdown.
Dans la fenêtre Options d’importation de documents, sélectionnez le fichier MD, puis cliquez sur Modifier le filtre et la configuration.
La fenêtre Paramètres d’importation de document apparaît. Dans la liste déroulante Filtre, choisissez le filtre Markdown.

Que pouvez-vous faire?

Choisissez comment gérer la mise en forme

Markdown utilise des caractères spéciaux comme des astérisques (*) et des traits de soulignement (_) pour la mise en forme du texte. La règle de base est: une paire d’astérisques ou de traits de soulignement simples signifie italique (comme le tag HTML ), et une paire d’astérisques ou de traits de soulignement doubles signifie gras (comme le tag HTML).

Voir une telle mise en forme comme des balises internes () : Choisissez le bouton radio des balises internes memoQ.
Voir une telle mise en forme dans la grille de traduction () : Choisissez le bouton radio du contenu formaté memoQ (lorsque possible ).

memoQ montre les types de mise en forme de texte les plus courants dans la grille de traduction. Markdown a plus. memoQ les montre sous forme de balises internes gris.

Choisissez comment gérer les sauts de ligne

Sauts de ligne doux (lorsque la ligne se termine par un caractère de nouvelle ligne ) :

Voir une balise interne où se trouvent des sauts de ligne souples: Choisissez le bouton radio Importer en tant que balises internes.
Ignorer les sauts de ligne souples: Choisissez le bouton radio Ne pas importer.
Ignorer les sauts de ligne souples mais produire un texte plus uniforme dans le fichier traduit: Choisissez le bouton radio Ne pas importer, mais générer des lignes de longueur moyenne à l’exportation.

Sauts de ligne dure (lorsque la ligne se termine par deux espaces ou une balise HTML) :

Pour commencer un nouveau segment à chaque saut de ligne dure: Choisissez le bouton Démarrer la radio de segment.
Voir une balise interne où se trouvent des sauts de ligne: Choisissez le bouton radio Importer en tant que balises internes.
D’avoir les deux Choisissez l’importation en tant que balises internes et démarrez le nouveau bouton radio de segment.
Ignorer les sauts de ligne dures: Choisissez le bouton radio Ne pas importer.

Choisissez comment gérer les blocs de code

Il existe deux types de blocs de code en Markdown:

Les blocs de code en retrait sont une ou plusieurs lignes voisines qui commencent par quatre espaces ou plus.
Les blocs de code délimités sont une ou plusieurs lignes voisines entre des lignes de trois backticks (`) ou plus, ou des tildes (~).

memoQ importe toujours des blocs de code indentés. Les paramètres dans les blocs de code définissent ce qui se passe avec les blocs de code clôturés.

Pour importer des blocs de code clôturés dans le document de traduction principal: Choisissez le bouton radio Importer en tant que bouton radio à traduire et laissez la case à cocher objets incorporés Importer les blocs de code clôturés décochée.
Importer des blocs de code clôturés dans des documents séparés sous le document de traduction principal: Choisissez le bouton radio Importer en tant que bouton radio à traduire et cochez la case Importer des blocs de code clôturés comme objets incorporés.
Ignorer les blocs de code clôturés: Choisissez le bouton radio Ne pas importer.

Même si vous n’importez pas de blocs de code clôturés pour la traduction, ils seront visibles dans l’aperçu.

Choisissez comment gérer le contenu HTML

Les fichiers Markdown peuvent contenir du contenu HTML à l’intérieur. Lorsque le contenu HTML est dans des blocs de lignes voisines, vous pouvez les importer en tant que fichiers incorporés séparés sous le fichier Markdown. Pour ce faire, au bas de la fenêtre Options d’importation de document, cochez la case Importer les objets incorporés.

memoQ importe ces fichiers incorporés en utilisant son filtre HTML, qui, au moment de la rédaction (T2 2024), n’est pas configurable et n’importe pas les commentaires HTML.

Lorsqu’un commentaire n’est pas à l’intérieur d’un bloc HTML (c’est-à-dire qu’il se trouve entre des lignes de contenu non HTML), vous pouvez l’importer directement dans le fichier Markdown. Pour ce faire, dans la section HTML de la configuration du filtre Markdown, cochez la case Importer les commentaires HTML de niveau supérieur comme traduisibles.

Dans la version actuelle, memoQ ne peut pas importer de commentaires HTML à l’intérieur des blocs HTML.

Lorsque vous avez terminé

Pour confirmer les paramètres et revenir à la fenêtre Options d’importation de documents: Cliquez sur OK.

Pour retourner à la fenêtre des options d’importation de documents, et ne pas changer les paramètres du filtre: Cliquez sur Annuler.

Dans la fenêtre Options d’importation de documents: Cliquez à nouveau sur OK pour commencer l’importation des documents.