You are not logged in. Please login or register.
QElectroTech → Scripts → Python script for generate cross-references in .pdf file
You are welcome.
I don't know why it doesn't run on Ubuntu.
Oh, I don't know exactly whether it's row or column. I guess it is column.
My cross-references are numerical. For page 17 column 9 the cross-reference would be 17.9, for example. So it must be column?
I think I will try to integrate this format into the program. I don't know if I can do it.
But I also don't know to what extent Alfonso is still online here.
I don't know why it doesn't run on Ubuntu.
AppImage it the same like nuitka who translate and convert python code to C
The solution is to compile your application on the oldest Linux version that you intend to support. However, this process can be exhausting, involving setup complexities and security considerations since it exposes source code.
MacOS arm64 Sequoia package.
xattr -r -d com.apple.quarantine GNerador_PDFLink_v1.zipEnlarge the Windows to have buttons focus!
Enjoy! -)
I lost some ours to understand why my package shared internal in new Macos VM work and downloaded the same zip with Safari or Chrome didn't work !!!, Apple directly in quarantines the zip if downloaded from the internet, the file is the same but when you extract the archive Apple says that the application is damaged...
The solution is to remove attribut com.apple.quarantine before open it.
I have tried the tool from Alfonso.
I have adapted my cross-reference type for this.
It did not work for me that the program recognizes gaps in the circuit diagram. In other words, if page 12 was in the 10th position, the Alfonso program would jump to page 12. The direct connections are not recognized. In this respect, I can achieve the same with my tool and will not go to the trouble of trying to include the X.Y format.
Translated with DeepL.com (free version)
It did not work for me that the program recognizes gaps in the circuit diagram. In other words, if page 12 was in the 10th position, the Alfonso program would jump to page 12. The direct connections are not recognized. In this respect, I can achieve the same with my tool and will not go to the trouble of trying to include the X.Y format.
+100
I work on old project at my work, I need to move some folio so I rename it to special folio label :9-1, 9-2, 9-3 to insert after folio 9 and before folio 10 I didn't use position but folio label for my Xref. So when I try Alfonso python plugin PDF link was wrong.
I was expecting this not to work with the plugin when you use folio label for XRefs and report .
Example xref 9-3-A2 in PDF link pointing to folio 3... but 9-3-A2 was realy position is page 14 on the pdf..
I haven't had time to think about finding a workaround. 
I understand this avanced use of QET was very difficult and complex to implement it to use and program it when you analazyse an simple PDF file..with python program..
yes, that was the same problem I had when I created my program.
The PDF is missing the background information that you would have in the .qet file to enter the connection.
That's why I wrote in the description I included in my post that the PDF page must be the same as the page in the schematic.
This reads out, for example. "22.1" and then extracts the 22 and creates the reference to p. 22.
I would have preferred it differently, but I couldn't think of a way to create the actual connection.
Translated with DeepL.com (free version)
A workaround it's to program code that use PDF like yours python program and also read the .qet XML, also you didn't need to enter rows, columns counts, size, and maybe with the folio label found page position.
You neeed two file, PDF of your project and the project.qet, I think!
yes, that could be a damn good idea.
The problem I'm seeing right now is that it might be hard/problematic to tell from the PDF which cross-reference is supposed to be in the .qet file.
I think the x and y coordinates would be the only way to tell which cross-reference from the PDF file would be the cross-reference in the QET file. However, I don't know to what extent the x and y coordinates in the documents match.
Ich habe meine Funktion erweitert und habe den ersten Erfolg erzielt, dass die passenden Seiten verlinkt werden, auch wenn im Schaltplan Lücken sind.
Dies ist jetzt allerdings noch nicht zu 100% getestet.
Das Problem, dass auftreten kann ist, dass das Programm jetzt gerade absucht, ob es den Text "Seite: XY" findet. Ob dies in einer anderen Sprache oder wenn dort eine Abkürzung z.b. S. steht klappt, weiß ich nicht. Hier sind evtl eigene Anpassungen nötig.
Das Vorgehen ist, das eine Mapping erstellt wird, so das das Programm z.B. weiß, dass PDF S.35 Schaltplan S.55 entspricht. Demnach werden, wenn im Querverweis steht, dass die Verlinkung auf S.55 die PDF S.35 geöffnet.
Translation:
I have extended my function and have achieved the first success that the appropriate pages are linked, even if there are gaps in the circuit diagram.
However, this has not yet been 100% tested.
The problem that can occur is that the program is now searching whether it finds the text “Page: XY”. I do not know whether this works in another language or if there is an abbreviation, e.g. S.. You may need to make your own adjustments here.
The procedure is that a mapping is created so that the program knows, for example, that PDF p.35 corresponds to circuit diagram p.55. Accordingly, if the cross-reference says that the link is to p.55, the PDF p.35 is opened.
Translated with DeepL.com (free version)
Querverweise-Foliennummer.AppImage 32.42 mb, 143 downloads since 2025-07-10
The sourcecode
Querverweise.py 11.91 kb, 132 downloads since 2025-07-10
Ah shit.
This
whether it finds the text “Page: XY”.
Must be
whether it finds the text “Seite: XY”.
Hello scorpio810 and Kellermorph!
Como ya sabéis, mi programa lee la página + coordenada, y crea un enlace en la página correspondiente del archivo PDF con la coordenada fila/columna
Si el formato no es el correcto, o las páginas no son consecutivas, habrá problemas con las referencias y mi programa.
Es por esto, q
Hello scorpio810 and Kellermorph!
Thank you for moving forward with this kind of tools that greatly improve our diagrams!
As you know, my program reads the page+coordinate, and creates a link on the corresponding page of the PDF file with the row/column coordinate.
If the formatting is not correct, or the pages are not consecutive, there will be problems with the references in my program.
The tool adapts to our schema creation rules (use of row and column, use consecutive pages, etc.). We are trying to make it more universal by adding the most common cross-reference formats, but it will never be to the liking of all users.
Probably we can make a tool that reads the links directly from .qet, but we don't have the time to develop it right now.
This is why, the best thing would be to include this functionality directly in QET built-in PDF export tool.
A workaround it's to program code that use PDF like yours python program and also read the .qet XML, also you didn't need to enter rows, columns counts, size, and maybe with the folio label found page position.
You neeed two file, PDF of your project and the project.qet, I think!
I have implemented your idea.
The script is attached.
Currently, German and English are supported.
The settings currently supported in QET are:
Text alignment for slave elements: Top, Right, Bottom, Left
Settings for the master: Position below the master and display as contacts.
This means that the options for displaying as a table and showing the contacts at the bottom of the slide are still missing. I don't use these settings either.
For Commutator must be used slave elements which are marked with other
I have implemented an additional function:
You can also enter component information, such as manufacturer, function, etc.
To do this, an info box is placed on the upper left contact of the element. This allows you to see directly which component it is and you don't have to go to the component directory. Since I use the variables for my tool with the terminal diagram differently than their labeling, I have included the option to exclude any components of the terminal type for the info boxes.
Translated with DeepL.com (free version)
qet_linker.py 29.29 kb, 51 downloads since 2026-02-26
Hello Thomas, please share an example and an video, thanks.
B.R Laurent
I have attached everything.
I deleted many pages from a previous project. So don't be surprised that the plan doesn't make much sense as it stands.
2026-02-26 13-06-26.mkv 3.81 mb, 71 downloads since 2026-02-26
Example.pdf 164.45 kb, 61 downloads since 2026-02-26
Example.qet 2.21 mb, 65 downloads since 2026-02-26
Example_linked.pdf 221.87 kb, 56 downloads since 2026-02-26
Example_linked_marked.pdf 226.01 kb, 63 downloads since 2026-02-26
WOW
Unbelievable!!! Just one question: is it possible to use it only in command line? If so, QElectroTech could simply use it in post-processing a PDF export without the user even noticing. That would be a HUGE plus for QElectroTech. Well done for your work.
Thank you.
I think this should be possible.
i can take a look.
But that this works, i have to enter the different Settings from QET. This will take a bit of time. If u want, i can do that
WOW, great work Thomas, but for the latest documentation of a project I'm currently working on with very customised folio orders, the programme you wrote crashes. I suspected as much beforehand, but for other less exotic projects, the programme works very well.
Thanks for testing and reporting back. I'll look into where the problem lies, fix it, and upload an update.
would it be possible, that u give me .qet to test it? I have tried with a single page with 2-1 and it works.
Could someone give me all the translations for the component information? I think they are already in the Code? Then i could add them in my tool
componentinformation.xlsx 9.89 kb, 44 downloads since 2026-03-04
Hello everyone,
I’ve continued developing the script.
To do this, I’ve configured and programmed a wide variety of settings from QET.
Could you please test it and give me some feedback? There might still be some errors, for example because the page size is significantly different and the scaling isn’t quite right yet, or something like that.
Features that aren’t included yet:
Position of the cross-reference for the slave component: text alignment. I’m not exactly sure how this works yet. Can someone tell me?
Also, the component information isn’t available in languages other than German and English yet.
As soon as the script runs without errors, I'll adapt it for the command line
Translated with DeepL.com (free version)
qet_linker.py 45.35 kb, 43 downloads since 2026-03-13
Native PDF hyperlinks for cross-references – Feature Request
Currently, QElectroTech exports PDF files using Qt's QPrinter/QPainter, which renders content "flat" — text and shapes are drawn correctly, but there is no support for embedded hyperlink annotations in the PDF output.
This is why the workaround Python script (using PyMuPDF/fitz) was created: it post-processes the exported PDF to detect cross-reference labels, calculate target page positions, and inject clickable link annotations (/Annots) into the PDF.
It would be great to have this functionality built directly into QET's PDF export.
Why Qt6 is now the only way forward
Qt5 reached its end of life and is no longer receiving updates. This migration is not optional — it is a matter of long-term maintainability and security for QET. But beyond that, Qt6 also brings the technical solution to this very problem.
Qt5 was fundamentally limited to "painting" content onto PDF pages with no awareness of the document structure. There was no supported way to embed hyperlink annotations natively — hence the need for external post-processing tools like the Python script.
Qt6 introduced the QtPdf module, which works with PDF documents at a structural level rather than just drawing pixels. Starting from Qt 6.4, this module exposes proper PDF navigation and document structure capabilities, and the writing side is actively being extended. This makes it technically feasible to embed internal page-to-page hyperlinks (/Annots) directly at export time — no external library, no post-processing step, no Python script needed.
In short: the end of Qt5 support is already decided. The migration to Qt6 is inevitable. And Qt6 happens to bring exactly the PDF capabilities needed to implement native cross-reference links properly. This is the right moment to plan this feature as part of the Qt6 migration effort, rather than treating it as a separate task later.
Thanks to Alfonso and the community for the Python workaround in the meantime — it proves the concept works and that users genuinely need this feature!
Thanks for the info, Laurent.
Then we can go ahead and implement that.
As soon as QET has been upgraded to QT6, I was planning to start working on adding direct PDF import instead of just an image.
That would be brilliant, Laurent!
I can see that, between you all, you’re making the programme progress by leaps and bounds! It’s fantastic!
For example, at the company where I work, we’re developing a Python programme that uses .qetmak files to automatically generate a complete drawing. We’ve seen that it’s entirely feasible based on the tests we’ve run, but we’ve still got a lot of work ahead of us creating the .qetmak files to a specific standard, and we’re looking into how to maintain the link between elements with the same name, as they currently depend on their ‘uuid’, which is currently generated randomly and therefore changes from project to project.
The idea for the future is that, using AI to help understand client requirements, a code containing the schematic’s characteristics will be generated, and using this code and the Python programme, we will obtain a .qet file ready for minor adjustments.
Of course, we’ll share the solution once it’s more fully developed; although it might not be suitable for everyone, it could be useful for some people.
Thanks to Kellermorph for implementing .qetmak and other features!
I’d love to contribute code directly rather than Python applications, but we don’t have enough programming knowledge and much time to acquire it.
QElectroTech → Scripts → Python script for generate cross-references in .pdf file
Powered by PunBB, supported by Informer Technologies, Inc.
Generated in 0.029 seconds (20% PHP - 80% DB) with 12 queries