Lier des fils d'une page à l'autre

Un fil qui sort d'une page et se poursuit sur une autre se dessine dans QElectroTech avec une paire de renvois de folio — une flèche qui annonce « suite page 4 », une autre page 4 qui indique « vient de la page 2 », et un lien entre les deux.

Vocabulaire. Cette page dit page et fil ; le code et certains dialogues disent folio et conducteur. Ce sont les mêmes choses — voir le glossaire à la fin.

Sources : sources/qetgraphicsitem/reportelement.cpp, sources/undocommand/linkelementcommand.cpp, sources/pdf_links.cpp.

1. Les deux moitiés

Un renvoi de folio est un élément ordinaire dont le link_type vaut l'une de deux valeurs :

`link_type`	Libellé de l'éditeur	Signification
`next_report`	Renvoi de folio suivant	le fil continue à partir d'ici
`previous_report`	Renvoi de folio précédent	le fil arrive ici depuis ailleurs

Vous les posez comme n'importe quel élément, depuis la rubrique des bornes et renvois de la collection, et vous raccordez un fil à chacun. À ce stade, ce ne sont que deux flèches sans rapport : les poser ne les lie pas. Le lien est une étape distincte et explicite.

2. Créer le lien

Sélectionnez un renvoi et ouvrez ses propriétés. Il propose Lier l'élément, avec la liste des renvois libres du type opposé ailleurs dans le projet — libre signifiant « pas déjà lié à autre chose ». La liste affiche pour chaque candidat son numéro de fil, sa fonction, sa tension / protocole, sa position et le titre de son folio, de quoi distinguer deux flèches semblables.

Choisissez-en un, et la paire est liée. L'opération est annulable.

Pour relier ailleurs, déliez d'abord : un renvoi ne détient qu'un seul lien, et le lier à un nouveau partenaire remplace l'ancien — le partenaire précédent est libéré silencieusement.

3. Ce que QET vérifie, et ce qu'il ne vérifie pas

Cela mérite d'être dit précisément, car c'est moins que ce que l'on suppose généralement. Pour décider si deux éléments peuvent être liés, QET vérifie deux choses :

Le type — un next_report ne peut être lié qu'à un previous_report, et réciproquement.
La liberté — les deux doivent être non liés (ou déjà liés entre eux).

C'est tout le contrat. QET ne vérifie pas :

que les deux renvois sont sur des pages différentes — vous pouvez lier deux renvois du même folio ;
que l'un ou l'autre a seulement un fil raccordé ;
que les fils des deux extrémités appartiennent au même potentiel, portent le même numéro, ou ont le moindre rapport électrique ;
que les flèches pointent dans des directions cohérentes.

Un lien de renvoi est donc une affirmation que vous faites sur votre schéma, et QET la restitue fidèlement sans la contrôler. Deux flèches peuvent prétendre à la continuité entre des fils qui n'ont rien à voir, sans que rien ne proteste.

Si vous voulez que ce soit contrôlé, contrôlez-le vous-même — voir §6.

4. Ce qu'affiche l'étiquette

Le texte d'un renvoi ne parle pas de lui-même. Il décrit l'autre extrémité : où va le fil, ou d'où il vient.

Le format vient d'un réglage unique, valable pour tout le projet, dans Propriétés du projet → renvois, enregistré ainsi :

<report label="%f-%l%c"/>

Avec le %f-%l%c par défaut, un renvoi dont le partenaire se trouve page 4 en ligne B, colonne 7 affiche 4-B7. Changez ce seul réglage et tous les renvois du projet changent avec lui. Les variables sont les variables d'étiquette habituelles — voir Variables et formules.

Comme le texte est engendré à partir de la position du partenaire, il suit le partenaire. Déplacez l'autre flèche dans une autre colonne, insérez une page avant elle, et l'étiquette se met à jour d'elle-même.

Seules cinq variables fonctionnent dans le texte d'un renvoi

Le texte dynamique d'un renvoi est restreint à un petit jeu, bien plus réduit que celui d'un élément ordinaire :

Variable	Affiche
`%{label}`	le numéro de fil
`%{function}`	la fonction du conducteur
`%{tension_protocol}`	la tension / le protocole
`%{conductor_color}`	la couleur du fil
`%{conductor_section}`	la section du fil

Tout le reste, placé dans le texte composé d'un renvoi, est supprimé. Si vous attendiez de voir %{comment} ou un champ fabricant sur un renvoi de folio, voilà pourquoi il n'apparaît pas.

5. Numéros de fils et lien

Deux comportements découlent du fait qu'un renvoi est un repère de changement de page, non un véritable matériel :

Une borne de renvoi n'est pas comptée comme un raccordement. Lorsque QET construit la liste des numéros de fils, les bornes appartenant à un élément renvoi sont délibérément ignorées, car elles ne représentent pas une vraie borne sur un vrai matériel. Un fil passant d'une page à l'autre n'est pas compté avec deux extrémités supplémentaires.
La numérotation ne traverse pas le lien automatiquement. Les deux fils sont des conducteurs distincts sur des pages distinctes, chacun dans son potentiel. Donner le même numéro aux deux extrémités relève d'une numérotation cohérente — voir Numérotation automatique.

6. Vérifier et exporter les liens

Dans un PDF exporté, les liens deviennent cliquables. L'étiquette d'un renvoi devient un hyperlien qui saute vers son partenaire sur l'autre page : un lecteur peut suivre un fil à travers un jeu de plans à la souris.

Il y a une condition : le lien n'est injecté que si le texte affiche réellement l'étiquette, c'est-à-dire s'il s'agit du texte d'information label, ou d'un texte composé contenant %{label}. Un renvoi dont vous avez remplacé le texte reste lié, mais n'est pas cliquable dans le PDF.

Pour auditer tous les liens d'un projet, utilisez la ligne de commande :

qelectrotech --export-links monprojet.qet liens.csv

Cela liste chaque élément liable et ce à quoi il est lié, en signalant les maîtres, esclaves et renvois sans lien. Comme QET ne vous signalera pas une flèche oubliée pendant que vous dessinez, c'est le moyen pratique d'en trouver une — un renvoi sans partenaire est un fil qui ne mène nulle part.

7. Vocabulaire

Cette page dit	Le code dit	Interface
page	diagram	folio
fil	conductor	conducteur
lien entre pages	folio report	renvoi de folio
flèche de départ	`next_report`	renvoi de folio suivant
flèche d'arrivée	`previous_report`	renvoi de folio précédent
référence croisée	master / slave	référence croisée

8. Les renvois ne sont pas des références croisées

Les deux mécanismes se ressemblent et sont souvent confondus :

	Renvoi de folio	Référence croisée
Relie	un fil à sa continuation	une bobine à ses contacts
Types	`next_report` ↔ `previous_report`	`master` ↔ `slave`
Combien	exactement un partenaire chacun	un maître, plusieurs esclaves
Le texte montre	la position de l'autre extrémité	la liste des contacts, ou la position de la bobine

Les références croisées sont traitées dans Lier des éléments.

Une règle commune, et une qui ne l'est pas : les deux exigent des types correspondants et un partenaire libre, mais une paire maître/esclave a une restriction supplémentaire — un maître API ne se lie qu'à un esclave API, et un maître non-API qu'à un esclave non-API.

9. Ce qui surprend

Poser deux flèches ne les lie pas. Le lien est une action explicite ; un schéma peut sembler achevé sans contenir le moindre lien.
Rien ne valide le lien. Même page, aucun fil, potentiels sans rapport : tout est permis. --export-links est le contrôle.
Lier remplace, cela n'ajoute pas. Un renvoi a un partenaire ; le pointer vers un autre libère l'ancien silencieusement.
La plupart des variables ne fonctionnent pas dans le texte d'un renvoi — seulement les cinq du §4.
L'étiquette décrit le partenaire, pas elle-même. Si une étiquette semble fausse, c'est en général la flèche de l'autre bout qu'il faut déplacer.
Un renvoi dont le texte n'affiche pas %{label} n'est pas cliquable dans le PDF, même si le lien existe.