Dans votre propre langue

En un coup d’œil

Si vous avez ouvert cette documentation, l’avez vue dans une langue que vous lisez vraiment — pas seulement une que vous savez déchiffrer — et que votre premier réflexe a été d’y revenir un instant, peut-être de relire une phrase ou deux juste pour vérifier qu’elles coulent bien, alors nous nous comprenons déjà. Ce petit temps d’arrêt, c’est toute la raison d’être de cette page. Si vous lisez ceci dans une autre langue que l’anglais en ce moment même, c’est exactement ce que nous espérions.

L’espace entre comprendre et aimer

Les langages de la conception logicielle s’écrivent en anglais, et pour la plupart des ingénieurs un manuel en anglais est la chose la plus ordinaire qui soit. Avec un peu d’outillage, on s’en accommode très bien. Mais si l’anglais n’est pas votre langue maternelle, vous connaissez cette sensation que quelque chose se glisse encore entre vous et la page — une fine couche de traduction, constante, que vous faites dans votre tête en lisant la référence, puis à nouveau en écrivant la vôtre.

Nous le savons parce que c’est aussi notre cas. Nous sommes des ingénieurs dont la langue maternelle n’est pas l’anglais, qui avons passé des années à lire des manuels en anglais et à écrire de la documentation et du code en anglais. Alors nous ressentons, plus vivement que la plupart, l’écart entre un article qu’on se contente de lire et un autre qu’il faut s’efforcer de comprendre. Les deux peuvent vous laisser informé. Un seul vous laisse à l’aise. Comprendre une chose et y prendre plaisir, ce n’est pas la même chose — et c’est de cette différence que parle tout ce travail.

Pourquoi dix-huit langues

Quand vous faites défiler la liste des langues et que vous en comptez près de vingt — dont certaines ne comptent pas parmi les plus dominantes à l’échelle mondiale —, ce n’est pas un hasard, et ce n’est pas une case à cocher. Elles sont là parce que nous voulons que vous aimiez tout cela : le produit lui-même, et ce autour de quoi il s’articule. Le PDF est un système bâti sur des règles — un format de document portable défini, jusque dans son modèle d’objets et sa syntaxe, par une norme formelle (ISO 32000-2). Nous trouvons cela discrètement fascinant, et nous aimerions que vous le trouviez fascinant vous aussi.

C’est aussi pour cela que certains de ces articles se lisent moins comme une référence aride que comme une histoire accessible sur le fonctionnement réel du PDF. Si l’un d’eux vous explique une chose dont vous n’aviez jamais entendu parler — ne vous inquiétez pas une seconde. Vous n’êtes pas le seul. Avant de nous y plonger et de lire nous-mêmes l’ISO 32000-2, nous ne la connaissions pas non plus. Une page qui vous apprend quelque chose de nouveau sur le format, dans une langue où vous pouvez vous détendre, est une page qui fait son travail.

Particulièrement pour l’Asie du Sud-Est

Les grandes langues mondiales allaient de soi. Ce que nous avons vraiment tenu à ajouter, ce sont les langues d’Asie du Sud-Est — l’indonésien, le thaï et le vietnamien. L’Europe, les Amériques et l’Asie du Nord-Est ont des cultures du logiciel anciennes et profondes, et disposent depuis longtemps d’une documentation à la hauteur. L’Asie du Sud-Est, elle, abrite l’une des scènes logicielles les plus en pleine ascension au monde — et pourtant, une documentation de premier ordre en langue locale est encore, le plus souvent, la dernière à lui parvenir. Nous ne voulions pas être un outil de plus qui la traite comme une arrière-pensée.

Et qui que vous soyez — un étudiant, une jeune ingénieure sur son premier vrai projet, un artisan indépendant, une équipe qui intègre le PDF dans sa pile technique —, nous vous souhaitons la même chose : la joie toute simple de fabriquer quelque chose qui fonctionne, et ces petites satisfactions bien réelles que l’on ne tire que de comprendre ce que l’on fait, à l’instant même où on le fait. On s’attache plus facilement à un métier quand le manuel ne fait pas, lui aussi, obstacle.

Ce que cela nous coûte vraiment

Rien de tout cela n’est gratuit, et nous n’allons pas prétendre le contraire. Même en nous appuyant sur la traduction automatique, chaque langue supplémentaire représente un coût de maintenance lourd et continu — et une ébauche traduite par machine n’est qu’une ligne de départ. Passer de « les mots sont traduits » à « l’article est vraiment compréhensible, et se lit naturellement pour quelqu’un qui pense dans cette langue » relève d’un travail humain et exigeant, et c’est un terrain sur lequel nous mettons un effort bien réel. Une bonne documentation est tenue à un niveau de qualité qui inclut le fait d’être compréhensible par son lecteur réel (ISO/IEC/IEEE 26514) ; pour nous, cette exigence ne fléchit pas sous prétexte que la langue du lecteur a changé.

Alors, quand une traduction tombe juste, voyez-y ce qu’elle veut être : non pas une fonctionnalité de confort, mais un petit geste d’attention d’un groupe d’ingénieurs envers un autre.

Un mot à quiconque nous lit

Soyons honnêtes : sur dix-huit langues, toutes les phrases ne seront pas parfaites, et certaines pages arrivent dans certaines langues avant d’autres. Si un passage vous semble rigide ou maladroit dans votre langue, dites-le-nous — nous traitons un défaut de documentation comme n’importe quel autre défaut d’ingénierie, et non comme un détail cosmétique. C’est ainsi que les choses s’améliorent.

Plus que tout, nous espérons que vous lisez ceci dans la langue où vous pensez, et que, quelque part dans ces pages, vous en viendrez à aimer le PDF un peu plus que vous ne l’auriez cru, et à aimer fabriquer des choses un peu plus que ce matin. Si c’est votre première vraie rencontre avec le PDF, ou avec PHP — bienvenue. Nous avons commencé exactement là où vous êtes : curieux, un peu en marge du centre de gravité anglophone, et heureux de tomber enfin sur un manuel qui semblait s’adresser à nous. Nous avons écrit celui-ci pour qu’il puisse s’adresser à vous.