Tous les documents ne naissent pas dans Word. Typst est devenu un moyen rapide d’écrire des articles, des lettres, des CV ou des notes de cours sans se battre avec LaTeX, et beaucoup d’équipes tiennent leurs manuels, leurs spécifications et leurs procédures d’exploitation en AsciiDoc. Puis quelqu’un réclame une copie signée et numérisée, et l’ordinateur devant vous ne contient que le fichier source.

Look Scanned ouvre désormais les deux. Utilisez Typst (.typ) en PDF numérisé pour les fichiers .typ et AsciiDoc (.adoc) en PDF numérisé pour les fichiers .adoc et .asciidoc. Le document est mis en pages dans votre navigateur. Vous le vérifiez dans l’aperçu, ajoutez l’effet de numérisation et téléchargez un PDF qui semble être passé dans un vrai scanner. Rien à installer, ni Typst CLI, ni Ruby, ni Asciidoctor PDF, et aucun compte auquel se connecter.

Typst : le vrai compilateur, dans votre navigateur

Look Scanned exécute le compilateur officiel de Typst (Typst 0.14), dans une version conçue pour le navigateur. C’est le même compilateur que celui de typst compile : les pages, les retours à la ligne, les équations et les tableaux sortent comme sur votre propre machine, avec le format de page et les marges définis dans votre document.

  • La première fois prend un moment. Le compilateur et les polices de Typst, environ 20 Mo au total, sont téléchargés depuis Look Scanned la première fois. Ensuite, ils proviennent du cache du navigateur, et les fichiers Typst s’ouvrent même hors ligne.
  • Un seul fichier, pas de paquets. Seuls les documents autonomes se compilent. Une ligne #import "@preview/…" échoue, faute de registre de paquets où les télécharger. Il en va de même pour tout ce qui lit un autre fichier : une image placée avec #image, un chapitre inclus avec #include ou des données chargées depuis un fichier CSV ou JSON.
  • Uniquement les polices par défaut de Typst. Le texte est composé avec les polices fournies avec Typst : Libertinus Serif, New Computer Modern et sa police mathématique, et DejaVu Sans Mono pour le code. Les polices installées sur votre ordinateur ne sont pas disponibles, donc une autre police nommée dans le document est remplacée par celles-ci. Elles couvrent les alphabets latin (vietnamien compris), grec, cyrillique et hébreu. Le chinois, le japonais et le coréen n’ont aucune police de repli, et des écritures comme l’arabe, le thaï ou le devanagari ne sont pas correctement prises en charge non plus : vérifiez l’aperçu si votre document les utilise.
  • La source doit compiler. Si Typst signale une erreur, vous obtenez un message d’erreur au lieu des pages.

Comme Typst produit un vrai PDF avant l’ajout de l’effet de numérisation, son texte peut être conservé. Quand vous enregistrez en PDF, activez « Conserver le texte original (similaire à l’OCR) » dans les Paramètres de sortie : le texte du PDF numérisé reste alors recherchable et copiable.

AsciiDoc : Asciidoctor sans Ruby

Les fichiers AsciiDoc sont convertis par Asciidoctor, le processeur de référence d’AsciiDoc, dans sa version JavaScript qui tourne dans votre navigateur. Le résultat est mis en pages au format A4 avec des marges d’un pouce, et voici ce qui est rendu :

  • L’en-tête du document : titre, auteur et ligne de révision, plus la table des matières quand le document définit :toc:.
  • Les sections, listes, tableaux, notes de bas de page, citations et annotations de code (callouts). Les avertissements (admonitions) affichent leur étiquette, comme Note ou Warning, en texte plutôt qu’en icône.
  • Les formules STEM, composées dans une vraie police mathématique quand le document définit :stem:. Les notations AsciiMath et LaTeX fonctionnent toutes les deux, dans le texte comme en bloc.
  • Les listings de code colorés selon la syntaxe quand le document définit :source-highlighter:, quel que soit le surligneur indiqué. Sans cet attribut, les listings restent sans couleur, comme partout ailleurs.
  • Les longs tableaux et listings se poursuivent sur la page suivante, et une ligne de tableau n’est jamais coupée en deux.

Certaines choses ne passent pas :

  • include:: n’est pas suivi. Chaque directive include s’affiche comme un lien vers son chemin, à la place du contenu inclus. Réunissez d’abord les parties dans un seul fichier.
  • Les images ont besoin d’une adresse complète. Une image désignée par un chemin relatif comme images/diagram.png reste introuvable, car le fichier est ouvert seul, sans son dossier. Une image avec une adresse https:// complète est chargée depuis le site qui l’héberge, ce qui demande une connexion Internet.
  • Les diagrammes restent sous forme de code. Asciidoctor Diagram n’est pas disponible : un bloc PlantUML ou Mermaid s’affiche tel que vous l’avez saisi.
  • Les polices sont celles de votre appareil. Le texte est composé avec les polices installées sur votre ordinateur ou votre téléphone, si bien que le même fichier peut changer de page à des endroits différents sur une autre machine.
  • Les fichiers très longs peuvent manquer de temps. La mise en pages doit se terminer en 30 secondes environ ; découpez un document de la taille d’un livre en fichiers plus petits.
  • Les fichiers .asc ne sont pas acceptés. Cette extension désigne en général des clés et des signatures PGP. Renommez un fichier AsciiDoc en .adoc avant de l’ouvrir.

Comment transformer un fichier .typ ou .adoc en PDF numérisé

  1. Ouvrez Typst (.typ) en PDF numérisé ou AsciiDoc (.adoc) en PDF numérisé et sélectionnez votre fichier.
  2. Patientez un instant pendant la préparation des pages, puis parcourez l’aperçu page par page. Vérifiez les titres, les équations, les tableaux et le code.
  3. Réglez l’effet de numérisation. Gardez le flou et le bruit faibles si le document contient de petits caractères ou des formules denses.
  4. Cliquez sur « Générer le PDF numérisé », puis sur « Télécharger le PDF numérisé ».

Vous préférez des images ? Vous pouvez exporter chaque page en JPG ou en PNG. Notre guide PDF, JPG et PNG explique quand choisir l’un ou l’autre. Avec Pro, la numérisation par lots traite plusieurs fichiers .typ ou .adoc à la fois.

Votre fichier reste sur votre appareil

Les deux formats sont convertis et numérisés dans votre navigateur, et le fichier source n’est jamais envoyé à un serveur. Pour Typst, les seuls téléchargements sont le compilateur et ses polices, depuis le site de Look Scanned lui-même ; aucun paquet ni autre fichier n’est récupéré. Pour AsciiDoc, la seule exception est une image avec une adresse https:// complète, récupérée sur le site qui l’héberge, comme si vous ouvriez la page dans votre navigateur.

Bon à savoir

  • Le résultat est composé d’images. Comme pour une vraie numérisation, le texte du PDF ne peut être ni sélectionné ni recherché, sauf si vous avez utilisé l’option de texte ci-dessus pour un fichier Typst. Conservez votre source .typ ou .adoc pour la modifier.
  • Un effet de numérisation est toujours appliqué. Look Scanned sert à donner aux documents l’aspect d’une numérisation. Si vous avez seulement besoin d’un PDF propre, exportez-le avec Typst ou Asciidoctor PDF.
  • Besoin de paquets, d’includes ou de diagrammes ? Générez le PDF sur une machine où Typst ou Asciidoctor PDF est installé, puis ajoutez l’effet de numérisation à ce PDF dans Look Scanned. Cela fonctionne avec n’importe quel document, puisque l’outil d’origine a déjà fait le plus difficile.

Vous écrivez dans un autre format ? Découvrez comment Look Scanned traite les fichiers LaTeX et les fichiers Markdown, HTML et TXT.

Vous avez un fichier .typ ou .adoc qui doit avoir l’air numérisé ? Essayez avec Typst ou avec AsciiDoc.