write_soft_hyphen.json

Le fichier JSON de l'exemple « Traits d'union conditionnels et insécables ». Une colonne justifiée composée deux fois : les mots longs coupés à leurs traits d'union conditionnels, trait d'union affiché, ou laissés entiers, et un nombre qu'une espace insécable garde d'un seul tenant.

JSON 98 lignes

Ce fichier est une requête : une application l'envoie par le réseau au serveur, qui crée le PDF et le renvoie. Il donne la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu'elle emploie, jamais le contenu de ces fichiers ; l'appel porte la requête et les fichiers ensemble. Une police que le serveur détient déjà, comme DejaVuSans, se nomme sans rien y joindre. Envoyez la requête à l'adresse que donne la page de l'API.

La bibliothèque écrit le paragraphe une seule fois et lui retire ses traits d'union conditionnels pour le panneau du haut ; la demande l'écrit deux fois, celui du haut déjà sans eux. La hauteur de chaque panneau est un nombre que la bibliothèque mesure sur les lignes qu'elle vient de composer, pour que le cadre se referme sur la dernière ; ici il est tapé à la main, et il faudrait le retaper si un mot changeait.

À quoi sert cet exemple

Une colonne étroite justifiée se relâche dès que les mots sont longs : les espaces s'étirent, des rivières blanches descendent la page, et l'œil tombe dedans au lieu de lire. Ce qui remet la page d'aplomb aujourd'hui, et ne coûte rien, c'est de dire dans le texte lui-même où tel mot a le droit d'être coupé (la coupure automatique des mots, avec un dictionnaire par langue derrière elle, est prévue pour une version à venir).

Ce que montre cet exemple

Télécharger le fichier Le même exemple en Rust Le même exemple en Python Voir ce qu'il crée 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
{
  "items": [
    {
      "type": "text",
      "rect": {
        "llx": 80.0,
        "lly": 750.4,
        "urx": 480.0,
        "ury": 760.0
      },
      "content": [
        "Without soft hyphens: justify opens the lines to fill the column."
      ],
      "font": "DejaVuSans",
      "font_size": 8.0
    },
    {
      "type": "text",
      "rect": {
        "llx": 80.0,
        "lly": 650.0,
        "urx": 230.0,
        "ury": 740.0
      },
      "content": [
        "Our international subscription, billed at 1\u00a0200\u00a0EUR, covers unlimited documents, priority support and quarterly statements."
      ],
      "font": "DejaVuSans",
      "font_size": 11.0,
      "align": "justify",
      "leading": 15.0
    },
    {
      "type": "rect",
      "rect": {
        "llx": 80.0,
        "lly": 650.0,
        "urx": 230.0,
        "ury": 740.0
      },
      "stroke": {
        "width": 0.5,
        "color": [
          0.8,
          0.8,
          0.8
        ]
      }
    },
    {
      "type": "text",
      "rect": {
        "llx": 80.0,
        "lly": 590.4,
        "urx": 480.0,
        "ury": 600.0
      },
      "content": [
        "With soft hyphens: the long words break, each break drawing a hyphen."
      ],
      "font": "DejaVuSans",
      "font_size": 8.0
    },
    {
      "type": "text",
      "rect": {
        "llx": 80.0,
        "lly": 490.0,
        "urx": 230.0,
        "ury": 580.0
      },
      "content": [
        "Our inter\u00adnational sub\u00adscription, billed at 1\u00a0200\u00a0EUR, covers unlimited docu\u00adments, prior\u00adity support and quarterly state\u00adments."
      ],
      "font": "DejaVuSans",
      "font_size": 11.0,
      "align": "justify",
      "leading": 15.0
    },
    {
      "type": "rect",
      "rect": {
        "llx": 80.0,
        "lly": 490.0,
        "urx": 230.0,
        "ury": 580.0
      },
      "stroke": {
        "width": 0.5,
        "color": [
          0.8,
          0.8,
          0.8
        ]
      }
    }
  ]
}