fix incorrect token in workflow

Fixed error in doxygen workflow, see https://github.com/qelectrotech/qelectrotech-source-mirror/issues/414#issue-3781358507

.gitattributes

@@ -0,0 +1 @@
+*.qch filter=lfs diff=lfs merge=lfs -text

.github/workflows/auto-doxygen.yml

@@ -0,0 +1,68 @@
+name: Auto-build doxygen docs
+on:
+  push:
+    branches:
+      - master
+   
+  
+  
+jobs:  
+  doxygen:
+    permissions:
+       contents: write    
+    runs-on: ubuntu-24.04
+    if: github.ref == 'refs/heads/master'
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        submodules: 'recursive'
+        show-progress: ''
+    - name: Setup and run doxygen
+      run: sudo apt install doxygen graphviz qhelpgenerator-qt5 -y
+    - name: Set up Git LFS
+      run: |
+          git lfs install
+          git lfs track "*.qch"  
+    - name: Run doxygen
+      run: doxygen Doxyfile
+    - name: Create Pull Request
+      uses: peter-evans/create-pull-request@v8
+      with:
+        token: ${{ secrets.MR_TOKEN }}
+        commit-message: update QCH file
+        committer: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
+        title: Update QCH Help file
+        body: |
+         - Updating QT Help file following commit ${{ github.sha }}.
+         - Auto-generated by [create-pull-request][1]
+
+         [1]: https://github.com/peter-evans/create-pull-request
+        branch: update-qch
+        labels: | 
+          qch
+          cicd
+        delete-branch: true
+        add-paths: doc/*.qch
+    - uses: actions/upload-pages-artifact@v3
+      with: 
+       path: ${{ github.workspace }}/doc/html/
+  deploy:
+    # Add a dependency to the build job
+    needs: doxygen
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write      # to deploy to Pages
+      id-token: write   # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    # Specify runner + deployment step
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4 # or specific "vX.X.X" version tag for this action

.gitignore

@@ -3,5 +3,7 @@
 # Qt build output
 *.user
 # doxygen Doxyfile output
-doc/
+doc/*
+!doc/QElectroTech.qch
 QElectroTech.tag
+!doc/doc-utils

.gitmodules

@@ -8,3 +8,6 @@
 	path = elements
 	url = https://github.com/qelectrotech/qelectrotech-elements.git
 
+[submodule "doxygen-awesome-css"]
+	path = doxygen-awesome-css
+	url = https://github.com/jothepro/doxygen-awesome-css.git

ChangeLog

@@ -1,3 +1,128 @@
+# QElectroTech - CHANGELOG
+
+## Version 0.100
+
+_Compiled from provided commit logs and contributor notes._
+
+## Overview
+
+This release (v0.100) collects a large set of new features, UI and editor improvements, element and symbol updates, build and packaging fixes, dependency upgrades, translations, and a broad set of bug fixes and stability improvements. It is intended as a stable, feature-rich stepping stone toward the next major workflows for symbol editing, terminal/strip handling and export improvements.
+
+## Highlights / Key Features
+
+- **Terminal Strip / Terminal Strip Editor**
+- New TerminalStripItem type and related editor workflow added.
+- Support for drawing and displaying terminal bridges and links in the editor.
+- Full editor support (layout preview, save/load into .qet files) and undo support for terminal strip operations.
+- **New Example Projects**
+- Several new example projects included, notably photovoltaic (PV) examples to help users getting started with PV designs.
+- **Improved Export / Print Handling**
+- Export limits adjusted and better handling of QPainter/printing boundaries to avoid export artefacts and out-of-range errors.
+- Export dialog updated to allow larger pixel limits where appropriate.
+- **Element & Symbol Additions**
+- New elements and symbols added (including vendor-specific elements and additional sensors/Arduino components).
+- Improvements to element import & metadata handling.
+- **Packaging & Multi-arch Support**
+- Updated packaging scripts for AppImage, Flatpak, Snap and macOS deployment. Improved aarch64/arm64 support.
+
+## Detailed Changes
+
+### Editor & UX
+
+- Better handling for **rotation, flip and mirror** operations in the element editor:
+- Primitives and text rotation behavior improved.
+- Finer rotation increments and predictable text orientation after flips/rotations.
+- **Wiring and conductor behavior**:
+- More robust creation and movement of wires and conductor bundles.
+- Improved text attachment and positioning for wires and improved stability while editing complex conductor networks.
+- **TerminalStrip editor**: see Highlights - includes drawing, preview, layout editing, persistent storage in the project file and undo support.
+- **Element Editor & Symbol Trim/Sort**:
+- Improved trimming/normalization of element metadata.
+- Better sorting and error handling for element imports (DXF and other formats).
+- Small UI improvements: About dialog updates, autosave spinbox ranges, improved tooltips and mouse-hover help for dynamic texts.
+
+### New & Updated Elements
+
+- New elements added for industrial and automation workflows (including Siemens-related elements, logic elements, sensors and Arduino components).
+- Symbol library additions and cleanup; improved defaults for newly added symbols.
+- Element meta-data cleanup: article numbers, descriptions, and manufacturer fields were normalized and trimmed on import.
+
+### Export / Printing / PDF
+
+- Adjusted internal export limits to avoid hitting QPainter size restrictions; users can now export larger, high-resolution images/prints in more cases.
+- Better handling of page sizes and printer-related geometry using QRectF improvements.
+- PDF export improvements to increase reliability of exported vector content.
+
+### Build, Dependencies, Packaging
+
+- Upgrades of core test and build dependencies:
+- Catch2 upgraded to v2.13.10.
+- googletest upgraded to v1.17.0.
+- CMake fixes and i18n handling corrected for nl_BE and other locales.
+- Packaging scripts updated across platforms (AppImage/Flatpak/Snap/macOS deploy) including fixes for aarch64/arm64.
+- Submodule updates (e.g., qelectrotech-elements, pugixml, SingleApplication) synchronized where needed.
+
+### Internationalization & Translations
+
+- Large translation updates across many languages: German (DE), French (FR), Dutch (NL, including nl_BE), Swedish (SV), Italian (IT), Polish (PL), Portuguese-BR (PT-BR), Serbian (SR), Chinese (Simplified) and others.
+- Fixes and corrections for many UI strings and localized resources.
+
+### Tests, QA & Logging
+
+- Improved logging and machine/config-path reporting; Git revision display refined to only show a revision when available.
+- Unit test updates and fixes to align with updated testing frameworks.
+
+## Bug Fixes (selected)
+
+- Fixed crashes and various null pointer access issues discovered by static and dynamic testing.
+- Resolved multiple reported bugs that caused build failures on some platforms (FTBFS fixes for macOS and others).
+- Fixed issues with automatic conductor/strand numbering in several edge cases (referenced Bug 293 in the commit logs).
+- Resolved text/summary headline issues in the German-language summary generator.
+- Fixes for a number of visually incorrect renderings and layout corner-cases during element transformation (rotate/flip/mirror).
+- Fixed issues that affected export sizes and caused export artifacts (referenced fixes for bug IDs around #329/#330 in commit notes).
+
+## Developer & Contributor Notes
+
+- Reworked parts of the codebase to use QRectF consistently for better compatibility with QPrinter and export pipelines.
+- Code-style cleanups and comment improvements applied throughout the project.
+- Expanded test coverage and dependency refresh to keep CI builds stable.
+
+## Contributors (selected)
+
+Thanks to the many contributors who made this release possible. Selected contributors mentioned in the commit logs include:
+
+- Laurent Trinques
+- joshua
+- plc-user
+- Achim
+- Pascal Sander
+- Andre Rummler
+- Magnus Hellströmer
+- Martin Marmsoler
+- Remi Collet
+
+(See the full commit history for the complete contributor list.)
+
+## Upgrade / Migration Notes
+
+- No database or project file format breaking changes were reported in the provided logs. As always, back up projects before opening them with a new version.
+- If you rely on custom element libraries or third-party submodules, verify submodule synchronization after upgrading.
+- If you are using custom packaging pipelines, review the updated packaging scripts for any changes required by new dependency versions, especially on aarch64/arm64.
+
+## Known Issues & Limitations
+
+- Some very large exports may still be limited by platform-specific rendering restrictions; the export dialog now allows larger pixel limits but extreme sizes may still hit system-level limits.
+- If you use niche element-import workflows (DXF → element import), occasionally metadata normalization may alter whitespace/trim rules - verify newly imported elements in the element editor.
+
+## How to get help / report bugs
+
+- Use the project issue tracker (see repository) to report regressions or new bugs with detailed reproduction steps and example .qet files where possible.
+- Include the output of Help → About (application version and Git revision) when reporting build/packaging issues.
+
+
+
+
+
 ====== ChangeLog from 0.8 to 0.9 ======
 
 

doc/QElectroTech.qch

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:56debcb415a5c3662b26ff8765daed9cd53a4c00f0b679a50160ac20d690fcfb
+size 528789504

doc/doc-utils/delete_me.html

@@ -0,0 +1,18 @@
+<!-- HTML footer for doxygen 1.12.0-->
+<!-- start footer part -->
+<!--BEGIN GENERATE_TREEVIEW-->
+<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
+  <ul>
+    $navpath
+    <li class="footer">$generatedby <a href="https://www.doxygen.org/index.html"><img class="footer" src="$relpath^doxygen.svg" width="104" height="31" alt="doxygen"/></a> $doxygenversion </li>
+  </ul>
+</div>
+<!--END GENERATE_TREEVIEW-->
+<!--BEGIN !GENERATE_TREEVIEW-->
+<hr class="footer"/><address class="footer"><small>
+$generatedby&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="$relpath^doxygen.svg" width="104" height="31" alt="doxygen"/></a> $doxygenversion
+</small></address>
+</div><!-- doc-content -->
+<!--END !GENERATE_TREEVIEW-->
+</body>
+</html>

doc/doc-utils/header.html

@@ -0,0 +1,88 @@
+<!-- HTML header for doxygen 1.12.0-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="$langISO">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=11"/>
+<meta name="generator" content="Doxygen $doxygenversion"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
+<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
+<!--BEGIN PROJECT_ICON-->
+<link rel="icon" href="$relpath^$projecticon" type="image/x-icon" />
+<!--END PROJECT_ICON-->
+<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
+<!--BEGIN DISABLE_INDEX-->
+  <!--BEGIN FULL_SIDEBAR-->
+<script type="text/javascript">var page_layout=1;</script>
+  <!--END FULL_SIDEBAR-->
+<!--END DISABLE_INDEX-->
+<script type="text/javascript" src="$relpath^jquery.js"></script>
+<script type="text/javascript" src="$relpath^dynsections.js"></script>
+<!--BEGIN COPY_CLIPBOARD-->
+<script type="text/javascript" src="$relpath^clipboard.js"></script>
+<!--END COPY_CLIPBOARD-->
+$treeview
+$search
+$mathjax
+$darkmode
+<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
+$extrastylesheet
+<script type="text/javascript" src="$relpath^doxygen-awesome-darkmode-toggle.js"></script>
+<script type="text/javascript">
+    DoxygenAwesomeDarkModeToggle.init()
+</script>
+<script type="text/javascript" src="$relpath^doxygen-awesome-fragment-copy-button.js"></script>
+<script type="text/javascript">
+    DoxygenAwesomeFragmentCopyButton.init()
+</script>
+</head>
+<body>
+<!--BEGIN DISABLE_INDEX-->
+  <!--BEGIN FULL_SIDEBAR-->
+<div id="side-nav" class="ui-resizable side-nav-resizable"><!-- do not remove this div, it is closed by doxygen! -->
+  <!--END FULL_SIDEBAR-->
+<!--END DISABLE_INDEX-->
+
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+
+<!--BEGIN TITLEAREA-->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr id="projectrow">
+  <!--BEGIN PROJECT_LOGO-->
+  <td id="projectlogo"><img alt="Logo" src="$relpath^$projectlogo"$logosize/></td>
+  <!--END PROJECT_LOGO-->
+  <!--BEGIN PROJECT_NAME-->
+  <td id="projectalign">
+   <div id="projectname">$projectname<!--BEGIN PROJECT_NUMBER--><span id="projectnumber">&#160;$projectnumber</span><!--END PROJECT_NUMBER-->
+   </div>
+   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
+  </td>
+  <!--END PROJECT_NAME-->
+  <!--BEGIN !PROJECT_NAME-->
+   <!--BEGIN PROJECT_BRIEF-->
+    <td>
+    <div id="projectbrief">$projectbrief</div>
+    </td>
+   <!--END PROJECT_BRIEF-->
+  <!--END !PROJECT_NAME-->
+  <!--BEGIN DISABLE_INDEX-->
+   <!--BEGIN SEARCHENGINE-->
+     <!--BEGIN !FULL_SIDEBAR-->
+    <td>$searchbox</td>
+     <!--END !FULL_SIDEBAR-->
+   <!--END SEARCHENGINE-->
+  <!--END DISABLE_INDEX-->
+ </tr>
+  <!--BEGIN SEARCHENGINE-->
+   <!--BEGIN FULL_SIDEBAR-->
+   <tr><td colspan="2">$searchbox</td></tr>
+   <!--END FULL_SIDEBAR-->
+  <!--END SEARCHENGINE-->
+ </tbody>
+</table>
+</div>
+<!--END TITLEAREA-->
+<!-- end header part -->