Repository navigation
folio_links FR
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.
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.
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.
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_reportne peut être lié qu'à unprevious_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.
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.
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.
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.
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.csvCela 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.
| 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 |
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.
- 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-linksest 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.
Voir aussi : Lier des éléments · Variables et formules · Numérotation automatique · Automatiser QElectroTech
