Initial commit of BudgetPro

2026-05-24 23:21:33 +02:00
commit f3096faee6
575 changed files with 90288 additions and 0 deletions
@@ -0,0 +1,98 @@
+# Webkit style was loosely based on the Qt style
+BasedOnStyle: WebKit
+
+Standard: Cpp11
+
+
+IndentWidth : 4
+TabWidth : 4
+UseTab : ForIndentation
+# Indent width for line continuations.
+ContinuationIndentWidth: 4
+
+# Leave the line breaks up to the user.
+# Note that this may be changed at some point in the future.
+ColumnLimit: 120
+# How much weight do extra characters after the line length limit have.
+PenaltyExcessCharacter: 4
+
+# Disable reflow of qdoc comments: indentation rules are different.
+# Translation comments are also excluded.
+CommentPragmas: "^!|^:"
+
+# We want a space between the type and the star for pointer types.
+PointerBindsToType: false
+
+# We use template< without space.
+SpaceAfterTemplateKeyword: false
+
+# We want to break before the operators, but not before a '='.
+BreakBeforeBinaryOperators: NonAssignment
+
+# Braces are usually attached, but not after functions or class declarations.
+BreakBeforeBraces: Custom
+BraceWrapping:
+    AfterClass: true
+    AfterControlStatement: false
+    AfterEnum: true
+    AfterFunction: true
+    AfterNamespace: true
+    AfterObjCDeclaration: false
+    AfterStruct: true
+    AfterUnion: false
+    BeforeCatch: false
+    BeforeElse: false
+    IndentBraces: false
+
+# When constructor initializers do not fit on one line, put them each on a new line.
+ConstructorInitializerAllOnOneLineOrOnePerLine: true
+# Indent initializers by 4 spaces
+ConstructorInitializerIndentWidth: 4
+
+# No indentation for namespaces.
+NamespaceIndentation: None
+
+# Horizontally align arguments after an open bracket.
+# The coding style does not specify the following, but this is what gives
+# results closest to the existing code.
+AlignAfterOpenBracket: true
+AlwaysBreakTemplateDeclarations: true
+
+# Ideally we should also allow less short function in a single line, but
+# clang-format does not handle that.
+AllowShortFunctionsOnASingleLine: false
+AllowShortIfStatementsOnASingleLine: false
+#
+BinPackParameters: false
+BinPackArguments: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AlwaysBreakAfterReturnType: None
+
+#
+PenaltyReturnTypeOnItsOwnLine: 5000
+PenaltyBreakAssignment: 5000
+PenaltyBreakBeforeFirstCallParameter: 5000
+
+# The coding style specifies some include order categories, but also tells to
+# separate categories with an empty line. It does not specify the order within
+# the categories. Since the SortInclude feature of clang-format does not
+# re-order includes separated by empty lines, the feature is not used.
+SortIncludes: false
+
+# macros for which the opening brace stays attached.
+ForEachMacros:   [ foreach, Q_FOREACH, BOOST_FOREACH, forever, Q_FOREVER, QBENCHMARK, QBENCHMARK_ONCE ]
+
+# there are define by czy
+
+PointerAlignment: Left
+AlignOperands: true
+BreakConstructorInitializersBeforeComma: true
+SpacesBeforeTrailingComments: 2
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: false
+AlignTrailingComments: true
+ReflowComments:  true
+SpacesInSquareBrackets: true
+SpacesInAngles: true
+
+KeepEmptyLinesAtTheStartOfBlocks: true
@@ -0,0 +1,39 @@
+name: CMake-Linux-Qt5.12LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [5.12.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+    
+    - name: Install Linux dependencies
+      run: sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,39 @@
+name: CMake-Linux-Qt5.13
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [5.13.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+    
+    - name: Install Linux dependencies
+      run: sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,39 @@
+name: CMake-Linux-Qt5.14
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [5.14.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+    
+    - name: Install Linux dependencies
+      run: sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,39 @@
+name: CMake-Linux-Qt5.15LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [5.15.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+    
+    - name: Install Linux dependencies
+      run: sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.0
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.0.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.1
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.1.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.2LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.2.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.3
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.3.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.4
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.4.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.5LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.5.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,40 @@
+name: CMake-Linux-Qt6.6
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  build:
+    runs-on: ubuntu-${{ matrix.ubuntu_version }}
+    name: Ubuntu-${{ matrix.ubuntu_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ubuntu_version: [20.04, latest]
+        qt_version: [6.6.*]
+        shared: [ON]
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v3
+
+    - name: Install Qt
+      uses: jurplel/install-qt-action@v3
+      with:
+          version: ${{ matrix.qt_version }}
+          cache: 'true'
+          cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+          dir: ${{ github.workspace }}/Qt
+
+    - name: Install Linux dependencies
+      run: |
+        sudo apt install -y libgl1-mesa-dev libxcb1-dev libgtk-3-dev
+
+    - name: Configure CMake
+      run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+    - name: Build
+      run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt5.12LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [5.12.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt5.13
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [5.13.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt5.14
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [5.14.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt5.15LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [5.15.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.0
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.0.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.1
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.1.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.2LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.2.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.3
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.3.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.4
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.4.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.5LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.5.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Mac-Qt6.6
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  macos:
+    runs-on: macos-${{ matrix.macos_version }}
+    name: macos-${{ matrix.macos_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    strategy:
+      fail-fast: false
+      matrix:
+        macos_version: [11, latest]
+        qt_version: [6.6.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt5.12LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [5.12.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt5.13
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [5.13.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt5.14
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [5.14.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt5.15LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [5.15.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.0
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.0.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.1
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.1.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.2LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.2.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.3
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.3.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.4
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.4.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.5LTS
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.5.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,36 @@
+name: CMake-Windows-Qt6.6
+
+on: [pull_request,push]
+
+env:
+  # Customize the CMake build type here (Release, Debug, RelWithDebInfo, etc.)
+  BUILD_TYPE: Release
+
+jobs:
+  MSVC:
+    name: windows-${{ matrix.win_version }}-Qt-${{ matrix.qt_version }}-shared-${{ matrix.shared }}
+    runs-on: windows-${{ matrix.win_version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        win_version: [2019, latest]
+        qt_version: [6.*]
+        shared: [ON]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Install Qt
+        uses: jurplel/install-qt-action@v3
+        with:
+            version: ${{ matrix.qt_version }}
+            cache: 'true'
+            cache-key-prefix: ${{ runner.os }}-Qt-Cache-${{ matrix.qt_version }}
+            dir: ${{ github.workspace }}/Qt
+
+      - name: Configure CMake
+        run: cmake -DCMAKE_BUILD_TYPE="${{env.BUILD_TYPE}}" -DBUILD_SHARED_LIBS=${{ matrix.shared }} -DBUILD_EXAMPLES=OFF -B "${{github.workspace}}/build"
+
+      - name: Build
+        run: cmake --build ${{github.workspace}}/build --config ${{env.BUILD_TYPE}}
@@ -0,0 +1,96 @@
+bin_*
+build*
+*.user
+*.autosave
+*.dll
+*.lib
+*.zip
+*.tar
+*.tar.gz
+*.user.*
+~*.pptx
+~*.docx
+*.drawio.bkp
+tmp
+tmp-file
+.$*
+.vs
+
+# vscode 的隐藏文件
+.vscode
+
+# This file is used to ignore files which are generated
+# ----------------------------------------------------------------------------
+
+*~
+*.autosave
+*.a
+*.core
+*.moc
+*.o
+*.obj
+*.orig
+*.rej
+*.so
+*.so.*
+*_pch.h.cpp
+*_resource.rc
+*.qm
+.#*
+*.*#
+core
+!core/
+tags
+.DS_Store
+.directory
+*.debug
+Makefile*
+*.prl
+*.app
+moc_*.cpp
+ui_*.h
+qrc_*.cpp
+Thumbs.db
+*.res
+*.rc
+/.qmake.cache
+/.qmake.stash
+compile_commands.json
+
+# qtcreator generated files
+*.pro.user*
+.qtc_clangd
+
+# xemacs temporary files
+*.flc
+
+# Vim temporary files
+.*.swp
+
+# Visual Studio generated files
+CMakeSettings.json
+*.ib_pdb_index
+*.idb
+*.ilk
+*.pdb
+*.sln
+*.suo
+*.vcproj
+*vcproj.*.*.user
+*.ncb
+*.sdf
+*.opensdf
+*.vcxproj
+*vcxproj.*
+
+# MinGW generated files
+*.Debug
+*.Release
+
+# Python byte code
+*.pyc
+
+# Binaries
+# --------
+*.dll
+*.exe
@@ -0,0 +1,3 @@
+[submodule "src/SARibbonBar/3rdparty/qwindowkit"]
+	path = src/SARibbonBar/3rdparty/qwindowkit
+	url = https://github.com/czyt1988/qwindowkit
@@ -0,0 +1,188 @@
+
+# Cmake的命令不区分大小写，例如message，set等命令；但Cmake的变量区分大小写
+# 为统一风格，本项目的Cmake命令全部采用小写，变量全部采用大写加下划线组合。
+
+cmake_minimum_required(VERSION 3.5)
+
+set(SARIBBON_VERSION_MAJOR 2)
+set(SARIBBON_VERSION_MINOR 2)
+set(SARIBBON_VERSION_PATCH 5)
+set(SARIBBON_VERSION "${SARIBBON_VERSION_MAJOR}.${SARIBBON_VERSION_MINOR}.${SARIBBON_VERSION_PATCH}")
+message(STATUS "SARibbon v${SARIBBON_VERSION}")
+project(SARibbon VERSION ${SARIBBON_VERSION} LANGUAGES CXX)
+
+# option(BUILD_SHARED_LIBS "build the SARibbonBar in shared lib mode" ON)
+option(SARIBBON_BUILD_EXAMPLES "build the examples" ON)
+# frameless能提供windows的窗口特效，如边缘吸附，且对高分屏多屏幕的支持更好,默认开启
+option(SARIBBON_USE_FRAMELESS_LIB "Using the QWindowKit library as a frameless solution" OFF)
+# frameless能提供windows的窗口特效，如边缘吸附，且对高分屏多屏幕的支持更好,默认开启
+option(SARIBBON_ENABLE_SNAPLAYOUT "Whether to enable the Snap Layout effect in Windows 11, this option only takes effect when SARIBBON_USE_FRAMELESS_LIB=ON" OFF)
+# 在当前目录安装，此操作会让库安装在当前目录下，新建类似bin_qt5.14.2_msvc_x64这样的文件夹，否则就安装到默认位置，windows的默认位置一般位于C:\Program Files
+option(SARIBBON_INSTALL_IN_CURRENT_DIR "Whether to install in the current directory" ON)
+
+# load Qt library, minimum version required is 5.8
+# cn:Qt库加载,最低版本要求为5.8
+set(SARIBBON_MIN_QT_VERSION 5.8)
+find_package(QT NAMES Qt6 Qt5 COMPONENTS Core REQUIRED)
+find_package(Qt${QT_VERSION_MAJOR} ${SARIBBON_MIN_QT_VERSION} COMPONENTS
+    Core
+    Gui
+    Widgets
+    REQUIRED
+)
+message(STATUS "current Qt version is Qt${QT_VERSION_MAJOR}.${QT_VERSION_MINOR}.${QT_VERSION_PATCH}")
+
+# 根据qt版本确认能否使用frameless库，目前frameless库支持qt5.14,qt5.15,qt6.1+,除了上诉版本，都使用不了
+# 上述版本的qt如果设置SARIBBON_USE_FRAMELESS_LIB=ON也会改为OFF
+set(_SARIBBON_USE_FRAMELESS_LIB ${SARIBBON_USE_FRAMELESS_LIB})
+if(SARIBBON_USE_FRAMELESS_LIB)
+    if(${QT_VERSION_MAJOR} EQUAL 5)
+        # qt版本为5，判断是否小版本小于14，小于14无法使用
+        if(${QT_VERSION_MINOR} LESS 14)
+            #5.14和5.15可以使用frameless
+            set(_SARIBBON_USE_FRAMELESS_LIB OFF)
+            message(WARNING "QT_VERSION = Qt${QT_VERSION} QT version minor is ${QT_VERSION_MINOR},less 14,will set SARIBBON_USE_FRAMELESS_LIB OFF")
+        endif()
+    elseif(${QT_VERSION_MAJOR} EQUAL 6)
+        # qt版本为6，判断是否小版本大于6.1
+        if(${QT_VERSION_MINOR} LESS_EQUAL 1)
+            #6.0及bug多多无法使用frameless
+            set(_SARIBBON_USE_FRAMELESS_LIB OFF)
+            message(WARNING "QT_VERSION = Qt${QT_VERSION} QT version minor is ${QT_VERSION_MINOR},less 1,will set SARIBBON_USE_FRAMELESS_LIB OFF")
+        endif()
+    endif()
+endif()
+
+# 如果是使用frameless库，需要c++17，否则c++14
+if(_SARIBBON_USE_FRAMELESS_LIB)
+    set(CMAKE_CXX_STANDARD 17)
+    set(CMAKE_CXX_STANDARD_REQUIRED ON)
+    if(MSVC)
+        # CMAKE_CXX_STANDARD对有些版本的msvc无效
+        set(CMAKE_CXX_FLAGS"${CMAKE_CXX_FLAGS} /std:c++17")
+    endif()
+    message(STATUS "The current QT version can use the frameless library and enable C++17")
+else()
+    set(CMAKE_CXX_STANDARD 14)
+    set(CMAKE_CXX_STANDARD_REQUIRED ON)
+    if(MSVC)
+        # CMAKE_CXX_STANDARD对有些版本的msvc无效
+        set(CMAKE_CXX_FLAGS"${CMAKE_CXX_FLAGS} /std:c++14")
+    endif()
+    message(STATUS "The current qt version cannot use the frameless library, enable C++14")
+endif()
+
+set(CMAKE_DEBUG_POSTFIX "d" CACHE STRING "add a postfix, usually d on windows")
+set(CMAKE_RELEASE_POSTFIX "" CACHE STRING "add a postfix, usually empty on windows")
+set(CMAKE_RELWITHDEBINFO_POSTFIX "rd" CACHE STRING "add a postfix, usually empty on windows")
+set(CMAKE_MINSIZEREL_POSTFIX "s" CACHE STRING "add a postfix, usually empty on windows")
+# Set the build postfix extension according to what configuration is being built.
+
+if(CMAKE_BUILD_TYPE MATCHES "Release")
+    set(CMAKE_BUILD_POSTFIX "${CMAKE_RELEASE_POSTFIX}")
+elseif (CMAKE_BUILD_TYPE MATCHES "MinSizeRel")
+    set(CMAKE_BUILD_POSTFIX "${CMAKE_MINSIZEREL_POSTFIX}")
+elseif(CMAKE_BUILD_TYPE MATCHES "RelWithDebInfo")
+    set(CMAKE_BUILD_POSTFIX "${CMAKE_RELWITHDEBINFO_POSTFIX}")
+elseif(CMAKE_BUILD_TYPE MATCHES "Debug")
+    set(CMAKE_BUILD_POSTFIX "${CMAKE_DEBUG_POSTFIX}")
+else()
+    set(CMAKE_BUILD_POSTFIX "")
+endif()
+
+if(MSVC)
+    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /wd4819")
+endif()
+
+
+# 平台判断
+if("${CMAKE_SIZEOF_VOID_P}" STREQUAL "4")
+    set(SARIBBON_PLATFORM "x86")
+else()
+    set(SARIBBON_PLATFORM "x64")
+endif()
+
+# The bin file directory is one level above the current directory
+# cn:bin文件目录在当前目录的上上一级
+# 安装目录默认名字为bin_qt5.14.2_msvc_x64
+set(SARIBBON_LOCAL_INSTALL_BIN_NAME bin_qt${QT_VERSION}_${CMAKE_CXX_COMPILER_ID}_${SARIBBON_PLATFORM})
+set(SARIBBON_LOCAL_INSTALL_BIN_DIR ${CMAKE_CURRENT_LIST_DIR}/${SARIBBON_LOCAL_INSTALL_BIN_NAME})
+
+# windows系统下，默认直接安装到当前文件夹下
+if(SARIBBON_INSTALL_IN_CURRENT_DIR)
+    if(WIN32)
+        set(CMAKE_INSTALL_PREFIX "${SARIBBON_LOCAL_INSTALL_BIN_DIR}")
+        message(STATUS "SARIBBON_INSTALL_IN_CURRENT_DIR=ON,will install in:${CMAKE_INSTALL_PREFIX}")
+    endif()
+endif()
+##################################
+# subdirectory
+##################################
+
+if(_SARIBBON_USE_FRAMELESS_LIB)
+    if(NOT QWindowKit_DIR)
+        message(STATUS "option SARIBBON_USE_FRAMELESS_LIB=ON,but QWindowKit_DIR not defined,will set QWindowKit_DIR=${SARIBBON_LOCAL_INSTALL_BIN_DIR}/lib/cmake/QWindowKit")
+        set(__qwk_dir ${SARIBBON_LOCAL_INSTALL_BIN_DIR}/lib/cmake/QWindowKit)
+        if(EXISTS ${__qwk_dir})
+            set(QWindowKit_DIR ${__qwk_dir})
+        else()
+            message(WARNING "SARIBBON_USE_FRAMELESS_LIB=ON,but not defined QWindowKit_DIR path")
+        endif()
+        # 再次尝试加载QWindowKit
+        find_package(QWindowKit QUIET)
+        if(NOT QWindowKit_FOUND)
+            set(_SARIBBON_USE_FRAMELESS_LIB OFF)
+            message(WARNING "can not find package QWindowKit at ${__qwk_dir},set SARIBBON_USE_FRAMELESS_LIB=OFF")
+        endif()
+    else()
+        message(STATUS "QWindowKit_DIR=${QWindowKit_DIR}")
+        find_package(QWindowKit QUIET)
+        if(NOT QWindowKit_FOUND)
+            set(_SARIBBON_USE_FRAMELESS_LIB OFF)
+            message(WARNING "can not find package QWindowKit at ${__qwk_dir},set SARIBBON_USE_FRAMELESS_LIB=OFF")
+        endif()
+    endif()
+endif()
+
+include(cmake/WinResource.cmake)
+
+########################################################
+# 自动化生成配置头文件
+########################################################
+configure_file (
+  "${CMAKE_CURRENT_LIST_DIR}/src/SARibbonBar/SARibbonBarVersionInfo.h.in"
+  "${CMAKE_CURRENT_LIST_DIR}/src/SARibbonBar/SARibbonBarVersionInfo.h"
+)
+
+##################################
+# 代码目录
+##################################
+
+add_subdirectory(src)
+
+if(SARIBBON_BUILD_EXAMPLES)
+    message(STATUS "build example")
+    add_subdirectory(example)
+endif()
+##################################
+# install
+##################################
+
+# document-文档
+set(SARIBBON_DOC_FILES
+    ${CMAKE_CURRENT_SOURCE_DIR}/readme.md
+    ${CMAKE_CURRENT_SOURCE_DIR}/readme-cn.md
+    ${CMAKE_CURRENT_SOURCE_DIR}/LICENSE
+    )
+
+
+# 把针对cmake安装的两个pri文件复制到根目录下
+set(SARIBBON_QMAKE_FILES
+    ${CMAKE_CURRENT_SOURCE_DIR}/cmake/common.pri
+    ${CMAKE_CURRENT_SOURCE_DIR}/cmake/SARibbonBar.pri
+    )
+install(FILES
+    ${SARIBBON_QMAKE_FILES}
+    DESTINATION lib/qmake/SARibbonBar
+    COMPONENT qmake
+)
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 czyt1988
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
@@ -0,0 +1,16 @@
+TEMPLATE = subdirs
+SUBDIRS += \
+           src/SARibbonBar \
+           example/NormalMenuBarExample\
+           example/WidgetWithRibbon \
+           example/MdiAreaWindowExample \
+           example/StaticExample \
+           example/MainWindowExample
+
+
+CONFIG += ordered
+
+OTHER_FILES += \
+           readme.md \
+           readme-cn.md \
+           update-record.md \
@@ -0,0 +1,24 @@
+include($$PWD/common.pri)
+INCLUDEPATH += $$PWD/src/SARibbonBar
+DEPENDPATH += $$PWD/src/SARibbonBar
+
+
+######################################
+#SA_RIBBON_CONFIG 用于定义一些编译选项：
+# SA_RIBBON_CONFIG+=use_frameless 此选项在common.pri中定义，注意必须保证编译和使用统一，否则会发生不可预估的异常
+######################################
+
+contains( SA_RIBBON_CONFIG, use_frameless ) {
+    !contains(CONFIG,C++17){
+        CONFIG += c++17
+    }
+    # 定义SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=1是的使用framelss库
+    DEFINES += SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=1
+}else{
+    !contains(CONFIG,C++14){
+        CONFIG += c++14
+    }
+    DEFINES += SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=0
+}
+LIBS += -L$${SARIBBON_BIN_DIR}/bin -l$${SARIBBON_LIB_NAME}
+
@@ -0,0 +1,178 @@
+# 版本记录(change log):
+
+## 2024-10-17 -> 2.2.5
+- 原有的qt关键宏替换为Q_SIGNAL\Q_SLOT\Q_EMIT，以适应no_keywords设置
+- 调整目录结构，单独把example提取出来
+- 完善mdi窗口的例子，可以结合qwk实现mdi窗口的最大最小化按钮的显示
+
+## 2024-09-12 -> 2.2.4
+- 修正自定义过程调用setRibbonBar后，会导致最大最小化按钮被遮挡的问题
+- 调整Mdi例子中cmake的文件大小写，避免在linux系统下大小写敏感
+- 修正qwk开启后，eventfilter没有捕获的问题
+
+## 2024-07-25 -> 2.2.1
+- 增加setPannelSpacing接口，可调节pannel按钮的间距
+- SARibbonToolButton的icon尺寸可设置，在小按钮模式下，用户可指定icon尺寸
+- 把SARibbonMainWindow的事件处理通过eventfilter实现，避免用户在重写事件时误操作
+- 修正SARibbonGalleryButton的样式错误
+- 修正SystemBar在qwk下会位置有偏离的问题
+
+## 2024-07-15 -> 2.2.0
+- 增加了mdi窗口的示例
+- 增加了SARibbonTabBar的tab尺寸计算方式，可以让tab高度按照tabbar高度自动调整
+- 示例增加了尺寸设置的配置，可以任意调整titlebar，tabbar，pannel title height的高度
+- 修正调整category高度后，pannel高度不跟着改变的问题
+- 添加snap layout的开关，在依赖qwk下，可以设置是否开启snap layout
+
+## 2024-05-23 -> 2.1.0
+- 添加actionTriggered信号
+- 修正了滚动action显示效果
+- 把SARibbonTheme从SARibbonMainWindow中转移到SARibbonGloabls.h中并作为枚举类(enum class)
+- 添加SARibbonWidget，同时调整example/widget示例
+- 调整了布局移动的实现方式，不会出现压缩式移动
+
+## 2024-02-07 -> 2.0.3
+- 调整SAColorToolButton的实现，使之更简单
+- 修正qwk库引入的cmake
+- 调整文档
+
+## 2024-02-07 -> 2.0.2 
+- 修正SARibbonSystemButtonBar的编码问题，可能会导致vs下无法编译成功
+- SARibbonContextCategory的标签颜色调整
+
+## 2024-01-27 -> 2.0.1【失效，请使用v2.0.2及以上版本】
+- 调整qss，让SARibbonApplicationButton的下拉箭头不显示
+- 文档添加gallery
+- 修正了一个布局可能异常的点
+
+## 2024-01-09 -> 2.0.0
+
+- `SARibbonCategory`和`SARibbonPannel`可以通过qss定制
+- `SARibbonPannel`的文字使用`SARibbonPannelLabel(QLabel)`显示，可以通过qss进行自定义
+- `SARibbonSeparatorWidget`分割线也支持qss定制
+- `SARibbonBar`的样式`RibbonStyle`改为`QFlags`
+- `SARibbonBar`添加了相关的迭代函数，可快速遍历所有的category和pannel
+- 尺寸的计算重新进行了调整
+- 默认的qss进行了重新调整，适用更多的屏幕尺寸
+- `SARibbonBar`添加了如下接口：
+  1.`SARibbonBar::setCornerWidgetVisible` 可以设置`cornerwidget`的显示隐藏与否
+  2.属性`enableShowPannelTitle`，控制是否显示pannel的标题
+  3.属性`pannelTitleHeight`，控制pannel标题栏高度
+  4.属性`pannelLayoutMode`，可控制pannel的布局方式
+  5.属性`tabOnTitle`，可控制tab放置在title栏上
+  6.`titleBarHeight`，`tabBarHeight`，`categoryHeight`这三个高度支持用户自定义，默认会根据字体大小计算
+  7.`setTabBarBaseLineColor`控制tabbar下基线颜色，某些主题需要设置颜色（窗口标题栏和category区域颜色一样的情况下如office 2013主题）可通过此函数设置，传入`QColor()`取消颜色
+- 添加了`SARibbonBar::initHighDpi()`静态函数，方便开启高分屏设置
+- 【注意】frameless库更换为qwindowkit(https://github.com/stdware/qwindowkit)，qwindowkit源码不作为项目一部分，使用`git submodule`管理，因此，项目clone下来后，需要执行`git submodule update --init --recursive`
+- 【注意】如果开启`SARIBBON_USE_FRAMELESS_LIB`（默认不开启），需要先构建`qwindowkit`，目前`qwindowkit`不提供qmake，只提供cmake，编译完`qwindowkit`后，SARibbon支持qmake和cmake
+- `SARibbonMainWindow`支持非ribbon模式
+- 原`SAWindowButtonGroup`改名为`SARibbonSystemButtonGroupBar`，同时支持添加action
+
+【警告】编译过程会在当前目录下生成bin_qtx.x.x_[MSVC/GNU]_x[64/86]这样的文件夹，请确保有写入权限，否则执行qmake过程会报错
+
+由于接口函数有明显调整，因此版本变更为2.0
+
+## 2023-12-29 -> 1.1.2
+
+- 合并了lixinchang的修改(https://gitee.com/lixinchang)
+- 添加了SARibbonControlToolButton，ControlBar不再使用QToolButton，避免和QToolButton的qss冲突
+- ControlBar支持按钮菜单样式的指定
+- 调整了默认样式的内容
+
+## 2023-12-25 -> 1.1.1
+
+- 修正了SARibbonBar的布局过程对窗体隐藏的判断方式，使得在窗口没显示时也能正确布局
+
+## 2023-12-25 -> 1.1.0
+
+- 修正了尺寸刷新的问题，在首次显示不会出现控件跳动的状态
+- 修正了一些问题
+- 调整了创建RibbonButton的方式
+- 调整了SARibbonPannel一些接口，使得创建更加规范
+- 调整了ToolButton的渲染方式
+
+  ------------------------
+
+## 2023-11-19 -> 1.0.6
+
+- 添加Office2016主题
+- Category可以居中对齐
+- QuickAccessBar的图标调小一像素，且用户可设置
+
+## 2023-11-10 -> 1.0.5
+
+- 自动根据Qt版本来适配是否加载frameless库
+
+## 2023-11-02 -> 1.0.4
+
+cn:因为引入了framelss库，导致很多版本的qt无法编译，为了兼容不同版本的qt编译问题，进行了版本自适应，
+不符合framelss的qt版本自动使用原来的framelss方案，从而实现了qt5.9到qt6的完全支持
+
+en:Because of the introduction of the framelss library, many versions of qt cannot be compiled.
+In order to be compatible with different versions of qt compilation, version adaptation is carried out.
+The qt version that does not conform to the framelss automatically uses the original framelss scheme, thus realizing full support for qt5.9 to qt6
+
+## 2023-10-26 -> 1.0.2
+
+- 添加了SARibbonBar在QWidget窗口上使用的例子
+- 整理了SARibbon.h和SARibbon.cpp,调整了静态使用的例子
+- frameless库更新到c4a7bc8版本（20231022）
+
+## 2023-10-14 -> 1.0.1
+
+cn:
+- 引入第三方库frameless
+- 支持ubuntu和macos
+- 解决windwos系统的多屏幕移动问题
+- 依赖frameless，实现windows系统的一些界面操作，如边缘触发半屏
+- 添加深色主题
+- 优化了一些界面刷新逻辑
+- 最低C++版本要求为c++17
+- 一些接口的调整和一些枚举名称的调整
+- 添加了QWidget使用SARibbonBar的例子
+- 同步把自定义ribbon的SARibbonMainWindow的依赖去除
+- 完善了文档包括高分屏问题和linux编译的方法
+
+en(machine translation):
+- import third-party library:frameless
+- Supports ubuntu and macos
+- Solving the problem of multi screen movement in Windwos system
+- Relying on frameless library to implement some interface operations in Windows systems, such as edge triggered half screen
+- Add a dark theme
+- Optimized some interface refresh logic
+- The minimum C++version requirement is c++17
+- Some interface adjustments and some enumeration name adjustments
+- Added an example of using SARibbonBar for QWidgets
+- Synchronize the removal of dependencies on SARibbonMainWindow for custom ribbons
+- Improved documentation including high resolution issues and methods for compiling Linux
+
+## 2023-10-09 -> 0.7.1
+
+- 增加了深色主题
+- 调整了枚举的命名方式
+- 增加了一些重绘方式
+
+## 2023-10-09 -> 0.7.0
+
+- 修正了category的布局问题
+
+## 2023-09-27 -> 0.6.0
+
+- 添加了Amalgamate，修正了一些显示的bug，修正cmake的异常
+- 添加了上下文标签中category标题名字改变的信号
+
+## 2023-05-28 -> 0.5.0
+
+- 调整了大按钮模式下的显示方案，去除了原来SARibbonToolButton的Lite和Normal模式，以WordWrap来表征
+- 支持文字自定义换行
+- 调整了RibbonPannel的标题栏的高度计算方案
+
+## 0.5.1
+
+- 不使用QString::simplified,而是简单的仅仅替换\n的simplified，这样中文换行不会多出空格
+
+## 0.5.2
+
+- SARibbonColorToolButton\SARibbonToolButton修正&操作在三项表达式未加括号问题
+- SARibbonStyleOption添加虚析构函数
+- 原来SARibbonElementCreateDelegate类改名为SARibbonElementFactory
@@ -0,0 +1,35 @@
+# lib/qmake/this-file
+# include/SARibbonBar/
+
+include($$PWD/common.pri)
+INCLUDEPATH += $${SARIBBON_INCLUDE_DIR}
+DEPENDPATH += $${SARIBBON_INCLUDE_DIR}
+
+
+greaterThan(QT_MAJOR_VERSION, 4){
+    # 目前 frameless支持qt5.14,qt5.15,qt6.4+,除了上诉版本，都使用不了
+    greaterThan(QT_MINOR_VERSION, 13){
+        SA_RIBBON_CONFIG += use_frameless
+    }
+}else{
+    # Qt6,qt6.4+可使用frameless
+    greaterThan(QT_MAJOR_VERSION, 5){
+        greaterThan(QT_MINOR_VERSION, 3){
+            SA_RIBBON_CONFIG += use_frameless
+        }
+    }
+}
+
+contains( SA_RIBBON_CONFIG, use_frameless ) {
+    !contains(CONFIG,C++17){
+        CONFIG += c++17
+    }
+    # 定义FRAMELESSHELPER_FEATURE_static_build为-1让frameless也作为库的一部分
+    DEFINES += FRAMELESSHELPER_FEATURE_static_build=-1
+    # 定义SARIBBON_USE_3RDPARTY_FRAMELESSHELPER为1
+    DEFINES += SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=1
+}else{
+    DEFINES += SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=0
+}
+LIBS += -L$${SARIBBON_LIB_DIR} -l$${SARIBBON_LIB_NAME}
+
@@ -0,0 +1,16 @@
+macro(saribbon_set_bin_name _var)
+    set(DA_MIN_QT_VERSION 5.14)
+    find_package(QT NAMES Qt6 Qt5 COMPONENTS Core REQUIRED)
+    ########################################################
+    # 平台判断
+    ########################################################
+    if("${CMAKE_SIZEOF_VOID_P}" STREQUAL "4")
+        set(_platform_name "x86")
+    else()
+        set(_platform_name "x64")
+    endif()
+    ########################################################
+    # 安装路径设置
+    ########################################################
+    set(_var bin_qt${QT_VERSION}_${CMAKE_BUILD_TYPE}_${_platform_name})
+endmacro(damacro_set_bin_name)
@@ -0,0 +1,119 @@
+macro(create_win32_resource_version)
+	if(MSVC) # TODO: MinGW (http://www.mingw.org/wiki/MS_resource_compiler)
+		set(_target)
+		set(_filename)
+		set(_version ${PROJECT_VERSION})
+		set(_ext "ico")
+		set(_companyname "https://github.com/czyt1988/SARibbon")
+		set(_copyright "Copyright (C) 2020 by czyt1988")
+		set(_description "Ribbon Control for Qt")
+		set(cmd "_target")
+		foreach(arg ${ARGN})
+			if(arg STREQUAL "TARGET")
+				set(cmd "_target")
+			elseif(arg STREQUAL "FILENAME")
+				set(cmd "_filename")
+			elseif(arg STREQUAL "VERSION")
+				set(cmd "_version")
+			elseif(arg STREQUAL "EXT")
+				set(cmd "_ext")
+			elseif(arg STREQUAL "COMPANYNAME")
+				set(cmd "_companyname")
+			elseif(arg STREQUAL "COPYRIGHT")
+				set(cmd "_copyright")
+			elseif(arg STREQUAL "DESCRIPTION")
+				set(cmd "_description")
+			else()
+				if("${cmd}" STREQUAL "_target")
+					set(_target ${arg})
+				elseif("${cmd}" STREQUAL "_filename")
+					set(_filename ${arg})
+				elseif("${cmd}" STREQUAL "_version")
+					set(_version ${arg})
+				elseif("${cmd}" STREQUAL "_ext")
+					set(_ext ${arg})
+				elseif("${cmd}" STREQUAL "_companyname")
+					set(_companyname ${arg})
+				elseif("${cmd}" STREQUAL "_copyright")
+					set(_copyright ${arg})
+				elseif("${cmd}" STREQUAL "_description")
+					set(_description ${arg})
+				else()
+				endif()
+			endif()
+		endforeach()
+		string(REGEX MATCHALL "[.]" matches "${_version}")
+		list(LENGTH matches n_matches)
+		while(n_matches LESS 3)
+			string(APPEND _version ".0")
+			string(REGEX MATCHALL "[.]" matches "${_version}")
+			list(LENGTH matches n_matches)
+		endwhile()
+		string(REPLACE "." "," PC ${_version})
+		set(RC_FILE ${CMAKE_CURRENT_BINARY_DIR}/${_target}.rc)
+		file(WRITE  ${RC_FILE} "#include <winres.h>\n\n")
+		file(APPEND ${RC_FILE} "#define TARGET_NAME \"${_target}\"\n")
+		file(APPEND ${RC_FILE} "#define FILE_VERSION_C ${PC}\n")
+		file(APPEND ${RC_FILE} "#define FILE_VERSION_S \"${_version}\"\n")
+		if("${_ext}" STREQUAL "exe")
+			set(_filetype "0x1L")
+			file(APPEND ${RC_FILE} "#define FILE_NAME \"${_filename}.exe\"\n")
+		else()
+			set(_filetype "0x2L")
+			file(APPEND ${RC_FILE} "#ifdef _DEBUG\n")
+			file(APPEND ${RC_FILE} "#define FILE_NAME \"${_filename}${CMAKE_DEBUG_POSTFIX}.dll\"\n")
+			file(APPEND ${RC_FILE} "#else\n")
+			file(APPEND ${RC_FILE} "#define FILE_NAME \"${_filename}.dll\"\n")
+			file(APPEND ${RC_FILE} "#endif\n")
+		endif()
+		file(APPEND ${RC_FILE} "\nVS_VERSION_INFO VERSIONINFO\n")
+		file(APPEND ${RC_FILE} " FILEVERSION FILE_VERSION_C\n")
+		file(APPEND ${RC_FILE} " PRODUCTVERSION FILE_VERSION_C\n")
+		file(APPEND ${RC_FILE} " FILEFLAGSMASK 0x3fL\n")
+		file(APPEND ${RC_FILE} "#ifdef _DEBUG\n")
+		file(APPEND ${RC_FILE} " FILEFLAGS 0x1L\n")
+		file(APPEND ${RC_FILE} "#else\n")
+		file(APPEND ${RC_FILE} " FILEFLAGS 0x0L\n")
+		file(APPEND ${RC_FILE} "#endif\n")
+		file(APPEND ${RC_FILE} " FILEOS 0x40004L\n")
+		file(APPEND ${RC_FILE} " FILETYPE ${_filetype}\n")
+		file(APPEND ${RC_FILE} " FILESUBTYPE 0x0L\n")
+		file(APPEND ${RC_FILE} "BEGIN\n")
+		file(APPEND ${RC_FILE} "    BLOCK \"StringFileInfo\"\n")
+		file(APPEND ${RC_FILE} "    BEGIN\n")
+		file(APPEND ${RC_FILE} "        BLOCK \"040704b0\"\n")
+		file(APPEND ${RC_FILE} "        BEGIN\n")
+		file(APPEND ${RC_FILE} "            VALUE \"CompanyName\", \"${_companyname}\"\n")
+		file(APPEND ${RC_FILE} "            VALUE \"FileDescription\", \"${_description}\"\n")
+		file(APPEND ${RC_FILE} "            VALUE \"FileVersion\", FILE_VERSION_S\n")
+		file(APPEND ${RC_FILE} "            VALUE \"InternalName\", FILE_NAME\n")
+		file(APPEND ${RC_FILE} "            VALUE \"LegalCopyright\", \"${_copyright}\"\n")
+		file(APPEND ${RC_FILE} "            VALUE \"OriginalFilename\", FILE_NAME\n")
+		file(APPEND ${RC_FILE} "            VALUE \"ProductName\", TARGET_NAME\n")
+		file(APPEND ${RC_FILE} "            VALUE \"ProductVersion\", FILE_VERSION_S\n")
+		file(APPEND ${RC_FILE} "        END\n")
+		file(APPEND ${RC_FILE} "    END\n")
+		file(APPEND ${RC_FILE} "    BLOCK \"VarFileInfo\"\n")
+		file(APPEND ${RC_FILE} "    BEGIN\n")
+		file(APPEND ${RC_FILE} "        VALUE \"Translation\", 0x407, 1200\n")
+		file(APPEND ${RC_FILE} "    END\n")
+		file(APPEND ${RC_FILE} "END\n")
+		target_sources(${_target} PRIVATE ${RC_FILE})
+	endif()
+endmacro(create_win32_resource_version)
+
+macro(visual_studio_qt_helper)
+	if(MSVC AND TARGET Qt::qmake)
+		get_target_property(_qt_qmake_location Qt::qmake IMPORTED_LOCATION)
+		execute_process(COMMAND "${_qt_qmake_location}" -query QT_INSTALL_PREFIX RESULT_VARIABLE return_code OUTPUT_VARIABLE qt_install_prefix OUTPUT_STRIP_TRAILING_WHITESPACE)
+		set(VSUSER_FILE ${CMAKE_CURRENT_BINARY_DIR}/${ARGV0}.vcxproj.user)
+		file(WRITE  ${VSUSER_FILE} "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n")
+		file(APPEND ${VSUSER_FILE} "<Project xmlns=\"http://schemas.microsoft.com/developer/msbuild/2003\">\n")
+		file(APPEND ${VSUSER_FILE} "  <PropertyGroup>\n")
+		file(APPEND ${VSUSER_FILE} "    <LocalDebuggerEnvironment>PATH=$(SolutionDir)src\\SARibbonBar\\$(Configuration);${qt_install_prefix}\\bin;$(Path)\n")
+		file(APPEND ${VSUSER_FILE} "$(LocalDebuggerEnvironment)</LocalDebuggerEnvironment>\n")
+		file(APPEND ${VSUSER_FILE} "    <DebuggerFlavor>WindowsLocalDebugger</DebuggerFlavor>\n")
+		file(APPEND ${VSUSER_FILE} "  </PropertyGroup>\n")
+		file(APPEND ${VSUSER_FILE} "</Project>\n")
+	endif()
+endmacro(visual_studio_qt_helper)
@@ -0,0 +1,22 @@
+# this file for cmake install
+
+msvc {
+    QMAKE_CFLAGS += /utf-8
+    QMAKE_CXXFLAGS += /utf-8
+}
+
+#生成一个区别debug和release模式的lib名,输入一个lib名字
+defineReplace(saRibbonLibNameMake) {
+    LibName = $$1
+    CONFIG(debug, debug|release){
+        LibName = $${LibName}d
+    }else{
+        LibName = $${LibName}
+    }
+    return ($${LibName})
+}
+SARIBBON_LIB_DIR = $$PWD/../../
+SARIBBON_BIN_DIR = $$PWD/../../../bin
+SARIBBON_INCLUDE_DIR = $$PWD/../../../include/SARibbonBar
+SARIBBONBAR_PRI_FILE_PATH = $$PWD/SARibbonBar.pri # 源代码路径
+SARIBBON_LIB_NAME=$$saRibbonLibNameMake(SARibbonBar)
@@ -0,0 +1,53 @@
+CONFIG(debug, debug|release){
+    contains(QT_ARCH, i386) {
+        SARIBBON_BIN_DIR = $$PWD/bin_qt$$[QT_VERSION]_Debug_x86
+    }else {
+        SARIBBON_BIN_DIR = $$PWD/bin_qt$$[QT_VERSION]_Debug_x64
+    }
+}else{
+    contains(QT_ARCH, i386) {
+        SARIBBON_BIN_DIR = $$PWD/bin_qt$$[QT_VERSION]_Release_x86
+    }else {
+        SARIBBON_BIN_DIR = $$PWD/bin_qt$$[QT_VERSION]_Release_x64
+    }
+}
+
+msvc {
+    QMAKE_CFLAGS += /utf-8
+    QMAKE_CXXFLAGS += /utf-8
+}
+
+#生成一个区别debug和release模式的lib名,输入一个lib名字
+defineReplace(saRibbonLibNameMake) {
+    LibName = $$1
+    CONFIG(debug, debug|release){
+        LibName = $${LibName}d
+    }else{
+        LibName = $${LibName}
+    }
+    return ($${LibName})
+}
+
+
+SARIBBON_SRC_DIR = $$PWD/src # 源代码路径
+SARIBBONBAR_PRI_FILE_PATH = $$PWD/SARibbonBar.pri # 源代码路径
+SARIBBON_LIB_NAME=$$saRibbonLibNameMake(SARibbonBar)
+
+######################################
+# Config  |  配置
+######################################
+#SA_RIBBON_CONFIG 用于定义一些编译选项：
+# SA_RIBBON_CONFIG+=use_frameless
+#     此选项将使用frameless第三方库，这个选项在SARibbonBar.pri中会自动判断，如果，达到frameless的使用要求将会自动定义
+#     frameless第三方库必须C++17且只有几个版本的qt可用，目前支持（qt5.14,qt5.15,qt6.4以上）
+#     除了上诉版本SA_RIBBON_CONFIG中不会加入use_frameless
+#     frameless库能实现Ubuntu下和mac下的显示，同时多屏幕的支持也较好
+# 使用frameless库，需要定义QWindowKit的安装目录，默认在SARIBBON_BIN_DIR
+# SA_RIBBON_QWindowKit_Install_DIR = $$SARIBBON_BIN_DIR
+# 
+# SA_RIBBON_CONFIG+=enable_snap_layout
+#      此选项将允许开启windows11的snap layout效果，目前在qt6.5下是正常显示位置，其它已知qt版本的snap layout位置会有偏移
+#      此选项必须在 SA_RIBBON_CONFIG+=use_frameless 下才有效
+######################################
+# SA_RIBBON_CONFIG += use_frameless
+# SA_RIBBON_CONFIG += enable_snap_layout
@@ -0,0 +1 @@
+html/
@@ -0,0 +1,157 @@
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2021 - 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+class DoxygenAwesomeDarkModeToggle extends HTMLElement {
+    // SVG icons from https://fonts.google.com/icons
+    // Licensed under the Apache 2.0 license:
+    // https://www.apache.org/licenses/LICENSE-2.0.html
+    static lightModeIcon = `<svg xmlns="http://www.w3.org/2000/svg" enable-background="new 0 0 24 24" height="24px" viewBox="0 0 24 24" width="24px" fill="#FCBF00"><rect fill="none" height="24" width="24"/><circle cx="12" cy="12" opacity=".3" r="3"/><path d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"/></svg>`
+    static darkModeIcon = `<svg xmlns="http://www.w3.org/2000/svg" enable-background="new 0 0 24 24" height="24px" viewBox="0 0 24 24" width="24px" fill="#FE9700"><rect fill="none" height="24" width="24"/><path d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27 C17.45,17.19,14.93,19,12,19c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z" opacity=".3"/><path d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"/></svg>`
+    static title = "Toggle Light/Dark Mode"
+
+    static prefersLightModeInDarkModeKey = "prefers-light-mode-in-dark-mode"
+    static prefersDarkModeInLightModeKey = "prefers-dark-mode-in-light-mode"
+
+    static _staticConstructor = function() {
+        DoxygenAwesomeDarkModeToggle.enableDarkMode(DoxygenAwesomeDarkModeToggle.userPreference)
+        // Update the color scheme when the browsers preference changes
+        // without user interaction on the website.
+        window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', event => {
+            DoxygenAwesomeDarkModeToggle.onSystemPreferenceChanged()
+        })
+        // Update the color scheme when the tab is made visible again.
+        // It is possible that the appearance was changed in another tab 
+        // while this tab was in the background.
+        document.addEventListener("visibilitychange", visibilityState => {
+            if (document.visibilityState === 'visible') {
+                DoxygenAwesomeDarkModeToggle.onSystemPreferenceChanged()
+            }
+        });
+    }()
+
+    static init() {
+        $(function() {
+            $(document).ready(function() {
+                const toggleButton = document.createElement('doxygen-awesome-dark-mode-toggle')
+                toggleButton.title = DoxygenAwesomeDarkModeToggle.title
+                toggleButton.updateIcon()
+
+                window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', event => {
+                    toggleButton.updateIcon()
+                })
+                document.addEventListener("visibilitychange", visibilityState => {
+                    if (document.visibilityState === 'visible') {
+                        toggleButton.updateIcon()
+                    }
+                });
+
+                $(document).ready(function(){
+                    document.getElementById("MSearchBox").parentNode.appendChild(toggleButton)
+                })
+                $(window).resize(function(){
+                    document.getElementById("MSearchBox").parentNode.appendChild(toggleButton)
+                })
+            })
+        })
+    }
+
+    constructor() {
+        super();
+        this.onclick=this.toggleDarkMode
+    }
+
+    /**
+     * @returns `true` for dark-mode, `false` for light-mode system preference
+     */
+    static get systemPreference() {
+        return window.matchMedia('(prefers-color-scheme: dark)').matches
+    }
+
+    /**
+     * @returns `true` for dark-mode, `false` for light-mode user preference
+     */
+    static get userPreference() {
+        return (!DoxygenAwesomeDarkModeToggle.systemPreference && localStorage.getItem(DoxygenAwesomeDarkModeToggle.prefersDarkModeInLightModeKey)) || 
+        (DoxygenAwesomeDarkModeToggle.systemPreference && !localStorage.getItem(DoxygenAwesomeDarkModeToggle.prefersLightModeInDarkModeKey))
+    }
+
+    static set userPreference(userPreference) {
+        DoxygenAwesomeDarkModeToggle.darkModeEnabled = userPreference
+        if(!userPreference) {
+            if(DoxygenAwesomeDarkModeToggle.systemPreference) {
+                localStorage.setItem(DoxygenAwesomeDarkModeToggle.prefersLightModeInDarkModeKey, true)
+            } else {
+                localStorage.removeItem(DoxygenAwesomeDarkModeToggle.prefersDarkModeInLightModeKey)
+            }
+        } else {
+            if(!DoxygenAwesomeDarkModeToggle.systemPreference) {
+                localStorage.setItem(DoxygenAwesomeDarkModeToggle.prefersDarkModeInLightModeKey, true)
+            } else {
+                localStorage.removeItem(DoxygenAwesomeDarkModeToggle.prefersLightModeInDarkModeKey)
+            }
+        }
+        DoxygenAwesomeDarkModeToggle.onUserPreferenceChanged()
+    }
+
+    static enableDarkMode(enable) {
+        if(enable) {
+            DoxygenAwesomeDarkModeToggle.darkModeEnabled = true
+            document.documentElement.classList.add("dark-mode")
+            document.documentElement.classList.remove("light-mode")
+        } else {
+            DoxygenAwesomeDarkModeToggle.darkModeEnabled = false
+            document.documentElement.classList.remove("dark-mode")
+            document.documentElement.classList.add("light-mode")
+        }
+    }
+
+    static onSystemPreferenceChanged() {
+        DoxygenAwesomeDarkModeToggle.darkModeEnabled = DoxygenAwesomeDarkModeToggle.userPreference
+        DoxygenAwesomeDarkModeToggle.enableDarkMode(DoxygenAwesomeDarkModeToggle.darkModeEnabled)
+    }
+
+    static onUserPreferenceChanged() {
+        DoxygenAwesomeDarkModeToggle.enableDarkMode(DoxygenAwesomeDarkModeToggle.darkModeEnabled)
+    }
+
+    toggleDarkMode() {
+        DoxygenAwesomeDarkModeToggle.userPreference = !DoxygenAwesomeDarkModeToggle.userPreference
+        this.updateIcon()
+    }
+
+    updateIcon() {
+        if(DoxygenAwesomeDarkModeToggle.darkModeEnabled) {
+            this.innerHTML = DoxygenAwesomeDarkModeToggle.darkModeIcon
+        } else {
+            this.innerHTML = DoxygenAwesomeDarkModeToggle.lightModeIcon
+        }
+    }
+}
+
+customElements.define("doxygen-awesome-dark-mode-toggle", DoxygenAwesomeDarkModeToggle);
@@ -0,0 +1,85 @@
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2022 - 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+class DoxygenAwesomeFragmentCopyButton extends HTMLElement {
+    constructor() {
+        super();
+        this.onclick=this.copyContent
+    }
+    static title = "Copy to clipboard"
+    static copyIcon = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z"/></svg>`
+    static successIcon = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41L9 16.17z"/></svg>`
+    static successDuration = 980
+    static init() {
+        $(function() {
+            $(document).ready(function() {
+                if(navigator.clipboard) {
+                    const fragments = document.getElementsByClassName("fragment")
+                    for(const fragment of fragments) {
+                        const fragmentWrapper = document.createElement("div")
+                        fragmentWrapper.className = "doxygen-awesome-fragment-wrapper"
+                        const fragmentCopyButton = document.createElement("doxygen-awesome-fragment-copy-button")
+                        fragmentCopyButton.innerHTML = DoxygenAwesomeFragmentCopyButton.copyIcon
+                        fragmentCopyButton.title = DoxygenAwesomeFragmentCopyButton.title
+                
+                        fragment.parentNode.replaceChild(fragmentWrapper, fragment)
+                        fragmentWrapper.appendChild(fragment)
+                        fragmentWrapper.appendChild(fragmentCopyButton)
+            
+                    }
+                }
+            })
+        })
+    }
+
+
+    copyContent() {
+        const content = this.previousSibling.cloneNode(true)
+        // filter out line number from file listings
+        content.querySelectorAll(".lineno, .ttc").forEach((node) => {
+            node.remove()
+        })
+        let textContent = content.textContent
+        // remove trailing newlines that appear in file listings
+        let numberOfTrailingNewlines = 0
+        while(textContent.charAt(textContent.length - (numberOfTrailingNewlines + 1)) == '\n') {
+            numberOfTrailingNewlines++;
+        }
+        textContent = textContent.substring(0, textContent.length - numberOfTrailingNewlines)
+        navigator.clipboard.writeText(textContent);
+        this.classList.add("success")
+        this.innerHTML = DoxygenAwesomeFragmentCopyButton.successIcon
+        window.setTimeout(() => {
+            this.classList.remove("success")
+            this.innerHTML = DoxygenAwesomeFragmentCopyButton.copyIcon
+        }, DoxygenAwesomeFragmentCopyButton.successDuration);
+    }
+}
+
+customElements.define("doxygen-awesome-fragment-copy-button", DoxygenAwesomeFragmentCopyButton)
@@ -0,0 +1,81 @@
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2022 - 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+class DoxygenAwesomeInteractiveToc {
+    static topOffset = 38
+    static hideMobileMenu = true
+    static headers = []
+
+    static init() {
+        window.addEventListener("load", () => {
+            let toc = document.querySelector(".contents > .toc")
+            if(toc) {
+                toc.classList.add("interactive")
+                if(!DoxygenAwesomeInteractiveToc.hideMobileMenu) {
+                    toc.classList.add("open")
+                }
+                document.querySelector(".contents > .toc > h3")?.addEventListener("click", () => {
+                    if(toc.classList.contains("open")) {
+                        toc.classList.remove("open")
+                    } else {
+                        toc.classList.add("open")
+                    }
+                })
+
+                document.querySelectorAll(".contents > .toc > ul a").forEach((node) => {
+                    let id = node.getAttribute("href").substring(1)
+                    DoxygenAwesomeInteractiveToc.headers.push({
+                        node: node,
+                        headerNode: document.getElementById(id)
+                    })
+
+                    document.getElementById("doc-content")?.addEventListener("scroll", () => {
+                        DoxygenAwesomeInteractiveToc.update()
+                    })
+                })
+                DoxygenAwesomeInteractiveToc.update()
+            }
+        })
+    }
+
+    static update() {
+        let active = DoxygenAwesomeInteractiveToc.headers[0]?.node
+        DoxygenAwesomeInteractiveToc.headers.forEach((header) => {
+            let position = header.headerNode.getBoundingClientRect().top
+            header.node.classList.remove("active")
+            header.node.classList.remove("aboveActive")
+            if(position < DoxygenAwesomeInteractiveToc.topOffset) {
+                active = header.node
+                active?.classList.add("aboveActive")
+            }
+        })
+        active?.classList.add("active")
+        active?.classList.remove("aboveActive")
+    }
+}
@@ -0,0 +1,51 @@
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2022 - 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+class DoxygenAwesomeParagraphLink {
+    // Icon from https://fonts.google.com/icons
+    // Licensed under the Apache 2.0 license:
+    // https://www.apache.org/licenses/LICENSE-2.0.html
+    static icon = `<svg xmlns="http://www.w3.org/2000/svg" height="20px" viewBox="0 0 24 24" width="20px"><path d="M0 0h24v24H0V0z" fill="none"/><path d="M17 7h-4v2h4c1.65 0 3 1.35 3 3s-1.35 3-3 3h-4v2h4c2.76 0 5-2.24 5-5s-2.24-5-5-5zm-6 8H7c-1.65 0-3-1.35-3-3s1.35-3 3-3h4V7H7c-2.76 0-5 2.24-5 5s2.24 5 5 5h4v-2zm-3-4h8v2H8z"/></svg>`
+    static title = "Permanent Link"
+    static init() {
+        $(function() {
+            $(document).ready(function() {
+                document.querySelectorAll(".contents a.anchor[id], .contents .groupheader > a[id]").forEach((node) => {
+                    let anchorlink = document.createElement("a")
+                    anchorlink.setAttribute("href", `#${node.getAttribute("id")}`)
+                    anchorlink.setAttribute("title", DoxygenAwesomeParagraphLink.title)
+                    anchorlink.classList.add("anchorlink")
+                    node.classList.add("anchor")
+                    anchorlink.innerHTML = DoxygenAwesomeParagraphLink.icon
+                    node.parentElement.appendChild(anchorlink)
+                })
+            })
+        })
+    }
+}
@@ -0,0 +1,40 @@
+
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2021 - 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+@media screen and (min-width: 768px) {
+
+    #MSearchBox {
+        width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)) - var(--searchbar-height) - 1px);
+    }
+
+    #MSearchField {
+        width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)) - 66px - var(--searchbar-height));
+    }
+}
@@ -0,0 +1,116 @@
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2021 - 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+ */
+
+html {
+    /* side nav width. MUST be = `TREEVIEW_WIDTH`.
+     * Make sure it is wide enough to contain the page title (logo + title + version)
+     */
+    --side-nav-fixed-width: 335px;
+    --menu-display: none;
+
+    --top-height: 120px;
+    --toc-sticky-top: -25px;
+    --toc-max-height: calc(100vh - 2 * var(--spacing-medium) - 25px);
+}
+
+#projectname {
+    white-space: nowrap;
+}
+
+
+@media screen and (min-width: 768px) {
+    html {
+        --searchbar-background: var(--page-background-color);
+    }
+
+    #side-nav {
+        min-width: var(--side-nav-fixed-width);
+        max-width: var(--side-nav-fixed-width);
+        top: var(--top-height);
+        overflow: visible;
+    }
+
+    #nav-tree, #side-nav {
+        height: calc(100vh - var(--top-height)) !important;
+    }
+
+    #nav-tree {
+        padding: 0;
+    }
+
+    #top {
+        display: block;
+        border-bottom: none;
+        height: var(--top-height);
+        margin-bottom: calc(0px - var(--top-height));
+        max-width: var(--side-nav-fixed-width);
+        overflow: hidden;
+        background: var(--side-nav-background);
+    }
+    #main-nav {
+        float: left;
+        padding-right: 0;
+    }
+
+    .ui-resizable-handle {
+        cursor: default;
+        width: 1px !important;
+        background: var(--separator-color);
+        box-shadow: 0 calc(-2 * var(--top-height)) 0 0 var(--separator-color);
+    }
+
+    #nav-path {
+        position: fixed;
+        right: 0;
+        left: var(--side-nav-fixed-width);
+        bottom: 0;
+        width: auto;
+    }
+
+    #doc-content {
+        height: calc(100vh - 31px) !important;
+        padding-bottom: calc(3 * var(--spacing-large));
+        padding-top: calc(var(--top-height) - 80px);
+        box-sizing: border-box;
+        margin-left: var(--side-nav-fixed-width) !important;
+    }
+
+    #MSearchBox {
+        width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)));
+    }
+
+    #MSearchField {
+        width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)) - 65px);
+    }
+
+    #MSearchResultsWindow {
+        left: var(--spacing-medium) !important;
+        right: auto;
+    }
+}
@@ -0,0 +1,90 @@
+/**
+
+Doxygen Awesome
+https://github.com/jothepro/doxygen-awesome-css
+
+MIT License
+
+Copyright (c) 2023 jothepro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+*/
+
+class DoxygenAwesomeTabs {
+
+    static init() {
+        window.addEventListener("load", () => {
+            document.querySelectorAll(".tabbed:not(:empty)").forEach((tabbed, tabbedIndex) => {
+                let tabLinkList = []           
+                tabbed.querySelectorAll(":scope > ul > li").forEach((tab, tabIndex) => {
+                    tab.id = "tab_" + tabbedIndex + "_" + tabIndex
+                    let header = tab.querySelector(".tab-title")
+                    let tabLink = document.createElement("button")
+                    tabLink.classList.add("tab-button")
+                    tabLink.appendChild(header)
+                    header.title = header.textContent
+                    tabLink.addEventListener("click", () => {
+                        tabbed.querySelectorAll(":scope > ul > li").forEach((tab) => {
+                            tab.classList.remove("selected")
+                        })
+                        tabLinkList.forEach((tabLink) => {
+                            tabLink.classList.remove("active")
+                        })
+                        tab.classList.add("selected")
+                        tabLink.classList.add("active")
+                    })
+                    tabLinkList.push(tabLink)
+                    if(tabIndex == 0) {
+                        tab.classList.add("selected")
+                        tabLink.classList.add("active")
+                    }
+                })
+                let tabsOverview = document.createElement("div")
+                tabsOverview.classList.add("tabs-overview")
+                let tabsOverviewContainer = document.createElement("div")
+                tabsOverviewContainer.classList.add("tabs-overview-container")
+                tabLinkList.forEach((tabLink) => {
+                    tabsOverview.appendChild(tabLink)
+                })
+                tabsOverviewContainer.appendChild(tabsOverview)
+                tabbed.before(tabsOverviewContainer)
+
+                function resize() {
+                    let maxTabHeight = 0
+                    tabbed.querySelectorAll(":scope > ul > li").forEach((tab, tabIndex) => {
+                        let visibility = tab.style.display
+                        tab.style.display = "block"
+                        maxTabHeight = Math.max(tab.offsetHeight, maxTabHeight)
+                        tab.style.display = visibility
+                    })
+                    tabbed.style.height = `${maxTabHeight + 10}px`
+                }
+
+                resize()
+                new ResizeObserver(resize).observe(tabbed)
+            })
+        })
+        
+    }
+
+    static resize(tabbed) {
+        
+    }
+}
@@ -0,0 +1,252 @@
+此文会详细介绍如何构建和引入SARibbon
+
+# 准备工作
+
+SARibbon使用了[QWindowkit](https://github.com/stdware/qwindowkit)作为无边框方案，同时也支持简单的无边框方案，如果你需要操作系统原生的窗口支持，如windows7以后的贴边处理，windows11的Snap Layout效果，建议开启[QWindowkit](https://github.com/stdware/qwindowkit)库，[QWindowkit](https://github.com/stdware/qwindowkit)库还能较好解决多屏幕移动问题
+
+开启QWindowkit将能实现如下效果：
+
+![](./pic/set-qwindowkit-on-snap.gif)
+
+如果你要开启[QWindowkit](https://github.com/stdware/qwindowkit)，需要先编译[QWindowkit](https://github.com/stdware/qwindowkit)库，[QWindowkit](https://github.com/stdware/qwindowkit)库作为SARibbon项目的submodules，如果在`git clone`时没有附带`--recursive`参数，需要执行`submodule update`命令:
+
+```shell
+git submodule update --init --recursive
+```
+
+# 编译QWindowkit库(如果不开启跳过此步)
+
+`QWindowkit`库只提供了cmake的编译方式，必须使用cmake
+
+为了简单，在`src/SARibbonBar/3rdparty`下提供了一个`CMakeLists.txt`文件，已经对此库的必要配置进行了设置，直接调用`src/SARibbonBar/3rdparty/CMakeLists.txt`文件编译即可
+
+使用Qt Creator和使用visual studio构建和安装基本一样
+
+## 使用Qt Creator构建和安装QWindowkit库
+
+使用qt creator编译`QWindowkit`库，直接用qt creator打开`src/SARibbonBar/3rdparty/CMakeLists.txt`文件
+
+![](./pic/build-cmake-qwk-qtc-01.png)
+
+点击运行（Ctrl+R）
+
+![](./pic/build-cmake-qwk-qtc-02.png)
+
+切换到项目模式（Ctrl+5）
+
+build步骤选择install（有些版本qt creator无法all和install一起选中，那么就先选all，编译完成后选install再执行安装）
+
+![](./pic/build-cmake-qwk-qtc-03.png)
+
+再点击运行（Ctrl+R）
+
+这时你会在SARibbon根目录下看到形如`bin_qt5.14.2_MSVC_x64`这样的安装目录，这里自动把`QWindowkit`库安装在此目录下
+
+![](./pic/build-cmake-qwk-qtc-04.png)
+
+此时完成`QWindowkit`库的编译和安装
+
+## 使用visual studio构建和安装QWindowkit库
+
+使用visual studio编译`QWindowkit`库，用visual studio打开->CMake，选择`src/SARibbonBar/3rdparty/CMakeLists.txt`文件
+
+![](./pic/build-cmake-vs-01.png)
+
+选中CMake菜单->全部生成（有些版本没有CMake菜单，可以在CMakeLists.txt点右键）
+
+![](./pic/build-cmake-vs-03.png)
+
+选中CMake菜单->安装（有些版本没有CMake菜单，可以在CMakeLists.txt点右键）
+
+![](./pic/build-cmake-vs-04.png)
+
+> 不同的vs操作有点不一样，没有CMake菜单的，可以在CMakeLists.txt点右键
+
+![](./pic/build-cmake-vs-04-other.png)
+
+这时你会在SARibbon根目录下看到形如`bin_qt5.14.2_MSVC_x64`这样的安装目录，这里自动把`QWindowkit`库安装在此目录下
+
+![](./pic/build-cmake-qwk-qtc-04.png)
+
+此时完成`QWindowkit`库的编译和安装
+
+## 使用命令行构建(适用Qt5及vs2019以下)
+
+由于`QWindowkit`库要求的cmake版本较高，vs2019及以下版本内置的cmake版本基本都无法满足，因此需要通过命令行对`QWindowkit`库进行构建，这里介绍在windows下如何通过cmd命令行构建`QWindowkit`库
+
+首先你要安装一个高版本的cmake工具,假设安装在了`C:\Program Files (x86)\cmake3.27.9\bin\cmake.exe`,同时你要确认你的qt版本路径和编译器，这里以Qt5.14.2 MSVC 2017版本举例
+
+找到你qt的安装路径下Qt5Config.cmake所在的文件夹，例如：`C:\Qt\Qt5.14.2\5.14.2\msvc2017_64\lib\cmake\Qt5`
+
+打开命令行，cd到`src/SARibbonBar/3rdparty`目录，首先执行下面语句：
+
+```
+"C:\Program Files (x86)\cmake3.27.9\bin\cmake.exe" -B build -S . -G "Visual Studio 15 2017" -A x64 -DQt5_DIR="C:\Qt\Qt5.14.2\5.14.2\msvc2017_64\lib\cmake\Qt5"
+```
+
+一般你的cmake.exe无法不在环境变量中，你在cmd命令中可以指定完整cmake路径，执行完后会看到如下输出：
+
+![](./pic/cmd-build-qwk.png)
+
+接着你再执行下面两个命令即可
+
+```
+"C:\Program Files (x86)\cmake3.27.9\bin\cmake.exe" --build build --target install --config Debug
+"C:\Program Files (x86)\cmake3.27.9\bin\cmake.exe" --build build --target install --config Release
+```
+
+# 构建SARibbonBar库
+
+`SARibbonBar`库提供`cmake`和`qmake`两种方式构建，推荐使用`cmake`
+
+> qt6之后不再维护`qmake`，逐渐转移到`cmake`中，`SARibbon`的未来版本不排除移除`qmake`
+
+## 基于`CMake`构建`SARibbonBar`库
+
+### vs下基于`cmake`的构建
+
+如果要开启`QWindowKit`，在`CMakeLists.txt`中把`SARIBBON_USE_FRAMELESS_LIB`的option值手动改为ON
+
+点击文件->打开->Cmake 选中CMakeLists.txt
+
+![](./pic/build-cmake-vs-01.png)
+
+将会形成如下的构建树
+
+![](./pic/build-cmake-vs-02.png)
+
+直接点击CMake菜单->全部生成（有些版本没有CMake菜单，可以在CMakeLists.txt点右键）
+
+![](./pic/build-cmake-vs-03.png)
+
+全部生成完成后，CMake菜单->安装->SARibbon（有些版本没有CMake菜单，可以在CMakeLists.txt点右键）
+
+![](./pic/build-cmake-vs-04.png)
+
+这时候你会看到源码的根目录下多出一个文件夹,文件夹命名方式为`bin_qt{version}_[MSVC/GNU]_x[64/86]`（你可以使用默认安装位置，把`SARIBBON_INSTALL_IN_CURRENT_DIR`变量设置为OFF即可:`SARIBBON_INSTALL_IN_CURRENT_DIR=OFF`）
+
+![](./pic/build-cmake-install-dir.png)
+
+### qtcreator下基于cmake的构建
+
+点击文件->打开文件或项目选中CMakeLists.txt，加载完成后形成如下的构建树
+
+![](./pic/build-cmake-qtc-01.png)
+
+Qt Creator可以在界面修改`SARIBBON_USE_FRAMELESS_LIB`值，也可以手动修改，在Qt Creator中，点击左侧边，切换到项目模式（Ctrl+5）,如下图，在Current Configuration中设置`SARIBBON_USE_FRAMELESS_LIB`为ON即可开启`QWindowKit`，前提是要先编译`QWindowKit`
+
+![](./pic/build-cmake-qtc-01-enable-qwk.png)
+
+点击运行按钮
+
+![](./pic/build-cmake-qtc-02.png)
+
+运行结束，会弹出例子窗口，点击左侧边栏的项目标签，Build的步骤，选中install
+
+![](./pic/build-cmake-qtc-03.png)
+
+再次点击运行按钮，这时候你会看到源码的根目录下多出一个文件夹,文件夹命名方式为`bin_qt{version}_[MSVC/GNU]_x[64/86]`（前提是你没有改变CMAKE_INSTALL_PREFIX）
+
+![](./pic/build-cmake-install-dir.png)
+
+使用SARibbon的所有内容都在这个文件夹下
+
+## 基于QMake构建SARibbonBar
+
+qmake构建SARibbonBar只需使用Qt Creator打开`SARibbon.pro`文件即可
+
+> 注意，如果使用Qt Creator打开`SARibbon.pro`文件过程报错，那么你的账户可能是没有足够的写权限，不同版本的Qt Creator在不同操作系统由不一样的表现，建议使用cmake
+
+# 使用SARibbonBar库
+
+## 基于cmake引入SARibbonBar库
+
+首先要通过cmake编译并执行安装，在自己的工程CMakeLists.txt按照如下步骤执行：
+
+1. 指定SARibbonBar的安装目录，把安装目录下的`lib/cmake/SARibbonBar`位置设置给`SARibbonBar_DIR`变量(CMake在执行`find_package(xx)`时，会先查看是否有`xx_DIR`变量，如果有，会先查询`xx_DIR`下是否有对应的`xxConfig.cmake`文件)
+
+```cmake
+set(SARibbonBar_DIR "C:\src\Qt\SARibbon\bin_qt5.14.2_MSVC_x64\lib\cmake\SARibbonBar")
+```
+
+2. 使用find_package找到SARibbonBar的Config文件，这个函数实际上是调用`lib/cmake/SARibbonBar/SARibbonBarConfig.cmake`文件，这里会把需要include的路径、预定义的宏，和需要添加的库给指定好，此时`SARibbonBar_INCLUDE_DIR`就是SARibbonBar的include文件路径
+
+```cmake
+find_package(SARibbonBar)
+```
+
+3. 最后调用`target_link_libraries`添加SARibbonBar库到自己的工程中,这里${myapp_target_name}是自己工程的target名字
+
+```cmake
+target_link_libraries(${myapp_target_name} PUBLIC
+    SARibbonBar
+)
+```
+
+## 基于qmake引入SARibbonBar库
+
+> Qt6开始，不再推荐使用`qmake`，SARibbon未来的版本有可能会取消qmake的支持
+
+qmake的编译过程会在SARibbon下生成`bin_qt{Qt version}_{MSVC/GNU}_x{32/64}`文件夹，库文件和dll文件都在此文件夹下，importSARibbonBarLib.pri会自动把这个文件夹下的库引用进来，在引入之前需要先进行配置，配置内容位于`common.pri`中
+
+步骤如下：
+
+1. 先在你的工程中建立一个`3rdparty`文件夹，再把整个`SARibbon`文件夹拷贝过去
+
+> SARibbon内部已经有几个pri文件可以很方便的让你把工程引入到自己目录中，`./importSARibbonBarLib.pri`文件就是用于引入SARibbon库的
+
+importSARibbonBarLib.pri文件按照本库目录结构引入了依赖和头文件，如果你自己需要调整目录结构，可参考此文件进行修改
+
+2. 配置common.pri文件
+
+按照你实际的库的编译情况，配置SARibbon/common.pri文件，目前可选配置如下：
+
+```shell
+# SA_RIBBON_CONFIG+=use_frameless
+#     此选项将使用frameless第三方库，这个选项在SARibbonBar.pri中会自动判断，如果，达到frameless的使用要求将会自动定义
+#     frameless第三方库必须C++17且只有几个版本的qt可用，目前支持（qt5.14,qt5.15,qt6.4以上）
+#     除了上诉版本SA_RIBBON_CONFIG中不会加入use_frameless
+#     frameless库能实现Ubuntu下和mac下的显示，同时多屏幕的支持也较好
+# 使用frameless库，需要定义QWindowKit的安装目录，默认在SARIBBON_BIN_DIR
+# SA_RIBBON_QWindowKit_Install_DIR = $$SARIBBON_BIN_DIR
+# 
+# SA_RIBBON_CONFIG+=enable_snap_layout
+#      此选项将允许开启windows11的snap layout效果，目前在qt6.5下是正常显示位置，其它已知qt版本的snap layout位置会有偏移
+#      此选项必须在 SA_RIBBON_CONFIG+=use_frameless 下才有效
+```
+
+你根据实际情况打开配置项（把注释去掉）
+
+3. 在自己的Qt工程pro文件中加入如下语句即可
+
+```shell
+include($$PWD/3rdparty/SARibbon/importSARibbonBarLib.pri)
+```
+
+此时你的工程目录结构大致如下：
+
+```
+|-[you-project-dir]
+|  |-you-project.pro
+|  |-[3rdparty]
+|     |-[SARibbon](直接把SARibbon完整复制过来)
+|        |-importSARibbonBarLib.pri（这个是方面你的qmake工程导入的文件，实际是引入了SARibbonBar.pri）
+|        |-SARibbonBar.pri（用于引入库和依赖）
+|        |-common.pri（这里是你的配置内容）
+|        |-[bin_qtx.x.x_{MSVC/GNU}_x{32/64}]
+|        |-[src]
+|        |   |-[SARibbonBar]
+```
+
+`importSARibbonBarLib.pri`、`SARibbonBar.pri`、`common.pri`这三个文件是引入工程的关键文件
+
+> 再次声明：Qt6.0版本后已经放弃qmake，建议使用cmake来管理工程
+
+# 公开的预定义宏
+
+SARibbon在编译过程中有些预定义宏，这些宏在基于visual studio的库引入是必须的
+
+`SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=1/0`,此宏用来定义是否引入了`QWindowkit`库
+
+`SARIBBON_ENABLE_SNAP_LAYOUT=1/0`,此宏在SARIBBON_USE_3RDPARTY_FRAMELESSHELPER=1时才有用，用于定义是否开始windows11的snap layout效果
+
@@ -0,0 +1,192 @@
+This document will detail how to build and introduce SARibbon.
+
+# Preparation
+
+SARibbon uses [QWindowkit](https://github.com/stdware/qwindowkit) as a borderless solution, while also supporting a simpler approach. If you require native window support from the operating system, such as edge sticking in Windows 7 or later, and hover effects on the maximize button in Windows 11, it is recommended to enable the [QWindowkit](https://github.com/stdware/qwindowkit) library. The [QWindowkit](https://github.com/stdware/qwindowkit) library can also better handle multi-screen movement issues.
+
+Enabling QWindowkit will achieve the following effects:
+
+![](./pic/set-qwindowkit-on-snap.gif)
+
+If you want to enable [QWindowkit](https://github.com/stdware/qwindowkit), you need to first compile the [QWindowkit](https://github.com/stdware/qwindowkit) library. As the [QWindowkit](https://github.com/stdware/qwindowkit) library is a submodule of the SARibbon project, if you did not include the `--recursive` parameter during `git clone`, you need to execute the `submodule update` command:
+
+```shell
+git submodule update --init --recursive
+```
+
+# Compile QWindowkit Library (Skip this step if not enabled)
+
+`QWindowkit` library provides only cmake compilation method, and cmake must be used.
+
+For simplicity, a `CMakeLists.txt` file is provided under `src/SARibbonBar/3rdparty`, which has already set up the necessary configurations for this library. Simply call the `src/SARibbonBar/3rdparty/CMakeLists.txt` file to compile.
+
+Building with Qt Creator is similar to using Visual Studio.
+
+## Build and Install QWindowkit Library with Qt Creator
+
+Compile the `QWindowkit` library using Qt Creator by directly opening the `src/SARibbonBar/3rdparty/CMakeLists.txt` file.
+
+![](./pic/build-cmake-qwk-qtc-01.png)
+
+Click run (Ctrl+R).
+
+![](./pic/build-cmake-qwk-qtc-02.png)
+
+Switch to the Projects mode (Ctrl+5).
+
+Select the 'install' option for the build step.
+
+![](./pic/build-cmake-qwk-qtc-03.png)
+
+Click run again (Ctrl+R).
+
+You will now see an installation directory like `bin_qt5.14.2_MSVC_x64` in the SARibbon root directory. The `QWindowkit` library is automatically installed in this directory.
+
+![](./pic/build-cmake-qwk-qtc-04.png)
+
+This completes the compilation and installation of the `QWindowkit` library.
+
+## Build and Install QWindowkit Library with Visual Studio
+
+Compile the `QWindowkit` library using Visual Studio by opening CMake and selecting the `src/SARibbonBar/3rdparty/CMakeLists.txt` file.
+
+![](./pic/build-cmake-vs-01.png)
+
+Select CMake menu->Generate All.
+
+![](./pic/build-cmake-vs-03.png)
+
+Select CMake menu->Install.
+
+![](./pic/build-cmake-vs-04.png)
+
+You will now see an installation directory like `bin_qt5.14.2_MSVC_x64` in the SARibbon root directory. The `QWindowkit` library is automatically installed in this directory.
+
+![](./pic/build-cmake-qwk-qtc-04.png)
+
+This completes the compilation and installation of the `QWindowkit` library.
+
+# Build SARibbonBar Library
+
+SARibbonBar library provides two ways to build: cmake and qmake. It is recommended to use cmake.
+
+## Build SARibbonBar Library with CMake
+
+### Building with CMake in Visual Studio
+
+To enable `QWindowKit`, manually set the value of the `SARIBBON_USE_FRAMELESS_LIB` option to ON in the CMakeLists.txt file:
+
+```
+option(SARIBBON_USE_FRAMELESS_LIB "Using the QWindowKit library as a frameless solution" ON)
+```
+
+Open file->Open->CMake and select CMakeLists.txt.
+
+![](./pic/build-cmake-vs-01.png)
+
+The build tree will look like this:
+
+![](./pic/build-cmake-vs-02.png)
+
+Click CMake menu->Generate All.
+
+![](./pic/build-cmake-vs-03.png)
+
+After generation, click CMake menu->Install->SARibbon.
+
+![](./pic/build-cmake-vs-04.png)
+
+You will see a new folder in the root directory named `bin_qt{version}_{MSVC/GNU}_x{64/86}` (assuming you did not change CMAKE_INSTALL_PREFIX).
+
+![](./pic/build-cmake-install-dir.png)
+
+### Building with CMake in Qt Creator
+
+Click File->Open File or Project and select CMakeLists.txt. Once loaded, the project tree will appear as follows:
+
+![](./pic/build-cmake-qtc-01.png)
+
+In Qt Creator, you can modify the value of `SARIBBON_USE_FRAMELESS_LIB` in the interface or manually. Switch to the Projects mode (Ctrl+5), navigate to Current Configuration, and set `SARIBBON_USE_FRAMELESS_LIB` to ON to enable `QWindowKit`, assuming you have compiled `QWindowKit` first.
+
+![](./pic/build-cmake-qtc-01-enable-qwk.png)
+
+Click the run button.
+
+![](./pic/build-cmake-qtc-02.png)
+
+After completion, a sample window will pop up. Click the Build steps in the sidebar, and select install.
+
+![](./pic/build-cmake-qtc-03.png)
+
+Click run again, and you will see a new folder in the root directory named `bin_qt{version}_{MSVC/GNU}_x{64/86}` (assuming you did not change CMAKE_INSTALL_PREFIX).
+
+![](./pic/build-cmake-install-dir.png)
+
+All contents related to using SARibbon are located in this folder.
+
+## Build SARibbonBar Library with QMake
+
+Building SARibbonBar with qmake only requires opening the SARibbon.pro file in Qt Creator.
+
+Note: If there are errors during the process of opening the SARibbon.pro file in Qt Creator, your account may lack sufficient write permissions. Different versions of Qt Creator exhibit different behaviors on different operating systems. It is recommended to use cmake.
+
+# Using SARibbonBar Library
+
+## Introducing SARibbonBar with CMake
+
+First, compile and install SARibbonBar using cmake in your project:
+
+1. Specify the SARibbonBar installation directory and set the `SARibbonBar_DIR` variable to point to the `lib/cmake/SARibbonBar` location in the installation directory.
+
+```cmake
+set(SARibbonBar_DIR "C:\src\Qt\SARibbon\bin_qt5.14.2_MSVC_x64\lib\cmake\SARibbonBar")
+```
+
+2. Use `find_package` to locate the SARibbonBar Config file. This function actually calls the `lib/cmake/SARibbonBar/SARibbonBarConfig.cmake` file, which sets up the necessary include paths, predefined macros, and libraries to add. At this point, `SARibbonBar_INCLUDE_DIR` is the path to the SARibbonBar include files.
+
+```cmake
+find_package(SARibbonBar)
+```
+
+3. Finally, use `target_link_libraries` to add the SARibbonBar library to your project. Here, `${myapp_target_name}` is the target name of your project.
+
+```cmake
+target_link_libraries(${myapp_target_name} PUBLIC
+    SARibbonBar
+)
+```
+
+## Introducing SARibbonBar with QMake
+
+During the qmake compilation process, a `bin_qt{Qt version}_{MSVC/GNU}_x{32/64}` folder will be generated under SARibbon, containing library and dll files. The `importSARibbonBarLib.pri` file will automatically reference the libraries in this folder.
+
+Follow these steps:
+
+1. Create a `3rdparty` folder in your project and copy the entire SARibbon folder into it.
+
+> Inside SARibbon, there are several `.pri` files that can easily integrate the project into your directory. The `importSARibbonBarLib.pri` file is used to import the SARibbon library.
+
+2. Add the following statement to your project's Qt project pro file:
+
+```shell
+include($$PWD/3rdparty/SARibbon/importSARibbonBarLib.pri)
+```
+
+Your project directory structure should look roughly like this:
+
+```
+|-[you-project-dir]
+|  |-you-project.pro
+|  |-[3rdparty]
+|     |-[SARibbon](Copy SARibbon entirely here)
+|        |-importSARibbonBarLib.pri
+|        |-SARibbonBar.pri
+|        |-common.pri
+|        |-[bin_qtx.x.x_{MSVC/GNU}_x{32/64}]
+|        |-[src]
+|        |   |-[SARibbonBar]
+```
+
+These three files (`importSARibbonBarLib.pri`, `SARibbonBar.pri`, `common.pri`) are crucial for integrating the project.
+
+> Note: Starting from Qt 6.0, qmake has been abandoned. It is recommended to use cmake to manage projects.
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2023-05-28T13:48:40.826Z" agent="5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/19.0.3 Chrome/102.0.5005.63 Electron/19.0.3 Safari/537.36" etag="VUcCu14FYz5cpfwmjXz9" version="19.0.3" type="device"><diagram id="yGERRYrwaGF77KkQtr55" name="RibbonToolButton">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</diagram></mxfile>
@@ -0,0 +1,60 @@
+Ribbon界面无法用普通的tab+toolbutton组合来实现主要就是因为ribbon界面对工具按钮有特殊的渲染方式，和经典菜单按钮是有很大不同的，在没有菜单的情况下没有什么区别，但有菜单的情况下，会有明显不同
+
+差别主要通过下面这个动图可以提现，尤其是在MenuPopup模式下，按钮会被拆分为两部分，普通的工具栏是左右拆分，而ribbon的工具按钮是上下拆分
+
+![ribbon工具按钮](./pic/ribbon-toolbutton.gif)
+
+# ribbon工具栏按钮绘制方案
+
+`SARibbon`的工具栏按钮为`SARibbonToolButton`，它继承`QToolButton`，重写了其绘图方法
+
+工具栏按钮分3个矩形区域，一个是icon绘制区域，一个是文本显示区域，一个是indicator绘制区域
+
+三个区域会有两种布局方案，根据文本是否换行来进行布局
+
+## 文字换行显示的布局方案
+
+换行模式下，文本区域会占据两行行高，office的word就是这种布局方案
+
+![](./pic/office-word-wrodwrap.png)
+
+可以看到，第一个pannel文本没有换行，会有一行的留白，第二个pannel文本都换行，充满了文本区域,且能看到菜单的箭头在第二行最右边
+
+对于没有换行的文本，但有菜单的情况下，indicator在第二行文本处
+
+![](./pic/office-word-wrodwrap2.png)
+
+下图为`SARibbonToolButton`文本换行的布局方案
+
+![](./pic/ribbon-toolbutton-largebutton.png)
+
+indicator是有菜单时的下箭头提示，在文本确切要换行时，下箭头在第二行文本的最右边，若在换行模式，但文本没有换行，第二行的位置就用来显示indicator
+
+> 注意，如果文本太长，`SARibbonToolButton`会尝试换行，由于英文的文本每个单词不是定长，因此会在原有文本单行显示的长度基础上先尝试1/2的长度能否换行完全显示，如果显示不了，就把长度递增为1/2+1/3，并继续尝试，如果3次都无法容纳下，就显示为原来的长度
+
+> 注意，换行模式下，用户可以手动给文本换行，就是加入`\n`换行，加入`\n`的文本，`SARibbonToolButton`就不用进行换行估算
+
+> 注意，带有`\n`的文本在不换行模式下也可正常显示，此时`\n`会被忽略掉
+
+## 文字不换行显示的布局方案
+
+对于不换行的方案，最经典的就是wps的布局方案，wps-word所有文字都是一行，不存在换行的情况，indicator布置在最右边
+
+![](./pic/wps-word-nowrodwrap.png)
+
+wps的方案尤其适合显示中文文本，但英文会有可能放不下，或者英文太长，单行很难显示全，因此如果要显示英文，建议使用换行方案，要显示中文，建议使用不换行方案
+
+`SARibbonToolButton`不换行的布局方案如下
+
+![](./pic/ribbon-toolbutton-largebutton-nowordwrap.png)
+
+# 如何布置一个更美观的Ribbon界面
+
+如果文字都比较短，又没有菜单情况下，使用换行模式显示会有一行文本的留白，如果很多的话会不太美观
+
+![](./pic/office-excel-oneline-spacing.png)
+
+此时又如下几种方案：
+
+- 大小搭配，如2个大按钮搭配3个小按钮
+- 使用\n强制换行,尤其是4个文字的情况下可以两个两个
--- a/Show More
+++ b/Show More
				`@@ -0,0 +1 @@`
				<mxfile host="Electron" modified="2023-05-28T13:48:40.826Z" agent="5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/19.0.3 Chrome/102.0.5005.63 Electron/19.0.3 Safari/537.36" etag="VUcCu14FYz5cpfwmjXz9" version="19.0.3" type="device"><diagram id="yGERRYrwaGF77KkQtr55" name="RibbonToolButton">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</diagram></mxfile>