fix: rename all novelwriter icons/assets to umbraedit

- Rename novelwriter.iconset to umbraedit.iconset with all icon sizes
- Rename setup/icons/novelwriter.* to umbraedit.*
- Rename setup/data/hicolor/ novelwriter icons to umbraedit
- Rename setup/data/novelwriter.* to umbraedit.*
- Rename docs/source/_static/novelwriter-* to umbraedit-*
- Rename setup/flatpak/io.novelwriter.novelwriter.yml to io.umbraedit.umbraedit.yml
- Rename setup/data/novelwriter.desktop to umbraedit.desktop
- Update setup/macos/build.sh to reference umbraedit.iconset
- Rebuild macOS DMG with correct UmbraEdit icon

.env.example

@@ -0,0 +1,9 @@
+# Copy to .env and fill in for dev tooling
+
+# Crowdin Personal Access Token scoped to at least `project.report` (Read only)
+# Needed for `qtlimport --credits-since`
+CROWDIN_REPORT_READ_TOKEN=
+
+# Path for long-term cached files, like downloaded icon packs
+# Used by `icons` unless `--work-dir` is set
+CACHE_DIR=

.flake8

@@ -1,4 +0,0 @@
-[flake8]
-ignore = E133,E221,E226,E228,E241,W503
-max-line-length = 99
-exclude = docs/*

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @vkbo @saga-soft-bot

.github/ISSUE_TEMPLATE/01-bug-report.yml

@@ -0,0 +1,63 @@
+name: Bug Report
+description: Report a bug or issue.
+title: "[Bug] "
+labels: ["bug", "triage"]
+type: bug
+body:
+  - type: markdown
+    attributes:
+      value: >
+        Thank you for taking the time to fill out this bug report.
+        Note that issues without a description will not be considered.
+        Please also check if an issue already exists on this problem.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: >
+        Provide a clear and concise description of what happened.
+        Include screenshots where relevant.
+      placeholder: Tell us what you see.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: >
+        Explain what to do to reproduce the issue.
+        Include screenshots where relevant.
+      placeholder: Tell us what to do.
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of UmbraEdit are you running?
+      placeholder: "e.g. 26.2"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      description: What operating system are you running?
+      placeholder: "e.g. Windows 11, macOS 26, Ubuntu 26.04"
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Log or Error Output
+      description: >
+        If the error dialog popped up, copy/paste the content here.
+        Or provide relevant log output from the console.
+      render: shell
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/02-improvement.yml

@@ -0,0 +1,34 @@
+name: Suggest Improvement
+description: Suggest something that can be improved.
+title: "[Improve] "
+labels: ["enhancement", "triage"]
+type: feature
+body:
+  - type: markdown
+    attributes:
+      value: >
+        Thank you for taking the time to fill out this feature request.
+        Note that feature requests without a description will not be considered.
+        Please also check if a request already exists for this feature.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: The Problem
+      description: >
+        Explain the problem you're facing.
+        Include screenshots where relevant.
+      placeholder: Tell us about the issue.
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Your Suggestion
+      description: >
+        Provide a clear and concise description of what you'd like to see.
+        Include screenshots where relevant.
+      placeholder: Tell us what you need.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/03-feature.yml

@@ -0,0 +1,23 @@
+name: Feature Request
+description: Suggest a new feature you'd like added.
+title: "[Feat] "
+labels: ["enhancement", "triage"]
+type: feature
+body:
+  - type: markdown
+    attributes:
+      value: >
+        Thank you for taking the time to fill out this feature request.
+        Note that feature requests without a description will not be considered.
+        Please also check if a request already exists for this feature.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Your Suggestion
+      description: >
+        Provide a clear and concise description of what you'd like to see.
+        Include screenshots where relevant.
+      placeholder: Tell us what you need.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,16 +0,0 @@
----
-name: Bug Report
-about: Create a report to help us improve
-title: ""
-labels: bug
----
-
-**Note**: Issues without a description will not be considered.
-Please also check if an issue already exists on this problem.
-Please provide a description covering the following points, if applicable:
-
-* A clear and concise description of what the bug is.
-* Steps to reproduce the behaviour
-* A clear and concise description of what you expected to happen.
-* If applicable, add screenshots to help explain your problem.
-* If the error dialog popped up, copy/paste the content here.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: GitHub Community Support
+    url: https://github.com/saga-soft/UmbraEdit/discussions
+    about: Please ask and answer questions here.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -1,15 +0,0 @@
----
-name: Feature Request
-about: Suggest an idea for this project
-title: ""
-labels: enhancement
----
-
-**Note**: Feature requests without a description will not be considered.
-Please also check if an issue already exists on this feature.
-Please provide a description covering the following points, if applicable:
-
-* A clear and concise description of what the problem is. Ex. I'm always frustrated when ...
-* A clear and concise description of what you want to happen.
-* A clear and concise description of any alternative solutions or features you've considered.
-* If applicable, add screenshots to help explain your request.

.github/pull_request_template.md

@@ -1,24 +1,19 @@
-<!--
-Please check the following before you make a pull request:
+### Summary
 
-* The branch you are making the pull request from (in your own fork) has a unique and descriptive
-  name. Do not make a pull request directly from your copy of `main`.
-* If you are submitting translation files, only submit the files that you have added translations
-  to, not the other .ts files that may have been updated in the process.
-* Make sure your contribution follows the style guide and other requirements mentioned in the
-  CONTRIBUTING.md file in the repository.
-* Fill in the Summary section below, and if relevant, mention the issue numbers related to the PR.
--->
+### Related Issue(s)
 
-**Summary:**
+<!-- i.e. Closes #1234 -->
 
-**Related Issue(s):**
+### Submitter's Checklist
 
-**Reviewer's Checklist:**
+* [ ] I am familiar with, and have followed, the [Contributing Guide](https://github.com/saga-soft/UmbraEdit/blob/main/CONTRIBUTING.md)
+* [ ] I am familiar with, and have followed, the [AI Policy](https://github.com/saga-soft/UmbraEdit/blob/main/AI_POLICY.md)
+
+### Reviewer's Checklist
 
 * [ ] The header of all files contain a reference to the repository license
 * [ ] The overall test coverage is increased or remains the same as before
 * [ ] All tests are passing
-* [ ] All flake8 checks are passing and the style guide is followed
+* [ ] All linting checks are passing and the style guide is followed
 * [ ] Documentation (as docstrings) is complete and understandable
 * [ ] Only files that have been actively changed are committed

.github/workflows/auto_approve.yml

@@ -0,0 +1,26 @@
+name: Auto-Approve
+
+on:
+  pull_request:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - ready_for_review
+
+concurrency:
+  group: auto-approve-${{ github.event.pull_request.number }}
+
+permissions: {}
+
+jobs:
+  approve:
+    name: Approve Owner PRs
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.draft == false && github.event.pull_request.user.login == 'vkbo'
+    steps:
+      - name: Approve Pull Request
+        env:
+          GH_TOKEN: ${{ secrets.SAGA_SOFT_BOT_TOKEN }}
+          PR_URL: ${{ github.event.pull_request.html_url }}
+        run: gh pr review "$PR_URL" --approve

.github/workflows/build.yml

@@ -1,99 +0,0 @@
-name: Build
-
-on: workflow_dispatch
-
-jobs:
-  buildAssets:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Python Setup
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-          architecture: x64
-
-      - name: Install Packages (apt)
-        run: |
-          sudo apt update
-          sudo apt install qttools5-dev-tools latexmk texlive texlive-latex-extra
-
-      - name: Checkout Source
-        uses: actions/checkout@v4
-
-      - name: Install Packages (pip)
-        run: pip install -r docs/source/requirements.txt
-
-      - name: Build Assets
-        run: python pkgutils.py qtlrelease sample manual
-
-      - name: Upload Artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: nw-assets
-          path: |
-            novelwriter/assets/sample.zip
-            novelwriter/assets/manual.pdf
-            novelwriter/assets/i18n/*.qm
-          if-no-files-found: error
-          retention-days: 1
-
-  buildLinux:
-    needs: buildAssets
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.11"]
-        linux-tag: ["manylinux_2_24_x86_64", "manylinux_2_28_x86_64"]
-    steps:
-      - name: Python Setup
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-          architecture: x64
-
-      - name: Install Packages (pip)
-        run: pip install python-appimage
-
-      - name: Checkout Source
-        uses: actions/checkout@v4
-
-      - name: Download Artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: nw-assets
-          path: novelwriter/assets
-
-      - name: Build AppImage
-        run: python pkgutils.py build-appimage --linux-tag ${{ matrix.linux-tag }} --python-version ${{ matrix.python-version }}
-
-      - name: Upload Artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: AppImage-${{ matrix.python-version }}-${{ matrix.linux-tag }}
-          path: dist_appimage
-          if-no-files-found: error
-          retention-days: 1
-
-  buildMac:
-    needs: buildAssets
-    runs-on: macos-12
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Download Artifacts
-        uses: actions/download-artifact@v4
-        with:
-          name: nw-assets
-          path: novelwriter/assets
-
-      - name: Build App Bundle
-        run: ./setup/macos/build.sh
-
-      - name: Upload DMG
-        uses: actions/upload-artifact@v4
-        with:
-          name: MacOS-DMG
-          path: dist_macos
-          if-no-files-found: error
-          retention-days: 1

.github/workflows/build_all.yml

@@ -0,0 +1,30 @@
+name: Build All
+
+on: workflow_dispatch
+
+jobs:
+  buildAssets:
+    uses: ./.github/workflows/part_assets.yml
+    permissions:
+      contents: read
+
+  buildLinux-AppImage:
+    needs: buildAssets
+    uses: ./.github/workflows/part_appimage.yml
+    secrets: inherit
+    permissions:
+      contents: read
+
+  buildLinux-Flatpak:
+    needs: buildAssets
+    uses: ./.github/workflows/part_flatpak.yml
+    secrets: inherit
+    permissions:
+      contents: read
+
+  buildWin-X64:
+    needs: buildAssets
+    uses: ./.github/workflows/part_win_x64.yml
+    secrets: inherit
+    permissions:
+      contents: read

.github/workflows/build_linux_images.yml

@@ -0,0 +1,23 @@
+name: Build Linux Images
+
+on: workflow_dispatch
+
+jobs:
+  buildAssets:
+    uses: ./.github/workflows/part_assets.yml
+    permissions:
+      contents: read
+
+  buildLinux-AppImage:
+    needs: buildAssets
+    uses: ./.github/workflows/part_appimage.yml
+    secrets: inherit
+    permissions:
+      contents: read
+
+  buildLinux-Flatpak:
+    needs: buildAssets
+    uses: ./.github/workflows/part_flatpak.yml
+    secrets: inherit
+    permissions:
+      contents: read

.github/workflows/build_linux_native.yml

@@ -0,0 +1,147 @@
+name: Build Linux Native
+
+on:
+  workflow_dispatch:
+    inputs:
+      publish:
+        required: false
+        description: "Publish to Cloudsmith?"
+        type: boolean
+        default: false
+      build_number:
+        required: false
+        description: "Build Number"
+        type: string
+        default: "0"
+      debian12:
+        required: false
+        description: "Debian 12 (Bookworm)"
+        type: boolean
+        default: true
+      debian13:
+        required: false
+        description: "Debian 13 (Trixie)"
+        type: boolean
+        default: true
+      ubuntu2404:
+        required: false
+        description: "Ubuntu 24.04 (Noble)"
+        type: boolean
+        default: true
+      ubuntu2604:
+        required: false
+        description: "Ubuntu 26.04 (Resolute)"
+        type: boolean
+        default: true
+      ubuntu2610:
+        required: false
+        description: "Ubuntu 26.10 (Stonking)"
+        type: boolean
+        default: true
+      mint22:
+        required: false
+        description: "Linux Mint 22 (Wilma)"
+        type: boolean
+        default: true
+
+jobs:
+  buildAssets:
+    uses: ./.github/workflows/part_assets.yml
+    permissions:
+      contents: read
+
+  buildAndPublish-Debian12:
+    name: Debian 12 (Bookworm)
+    needs: buildAssets
+    uses: ./.github/workflows/part_debian.yml
+    with:
+      publish: ${{ inputs.publish }}
+      build_number: ${{ inputs.build_number }}
+      codename: bookworm
+      family: debian
+      image: debian:12
+    secrets: inherit
+    if: ${{ inputs.debian12 }}
+    permissions:
+      id-token: write
+      contents: read
+
+  buildAndPublish-Debian13:
+    name: Debian 13 (Trixie)
+    needs: buildAssets
+    uses: ./.github/workflows/part_debian.yml
+    with:
+      publish: ${{ inputs.publish }}
+      build_number: ${{ inputs.build_number }}
+      codename: trixie
+      family: debian
+      image: debian:13
+    secrets: inherit
+    if: ${{ inputs.debian13 }}
+    permissions:
+      id-token: write
+      contents: read
+
+  buildAndPublish-Ubuntu2404:
+    name: Ubuntu 24.04 (Noble)
+    needs: buildAssets
+    uses: ./.github/workflows/part_debian.yml
+    with:
+      publish: ${{ inputs.publish }}
+      build_number: ${{ inputs.build_number }}
+      codename: noble
+      family: ubuntu
+      image: ubuntu:24.04
+    secrets: inherit
+    if: ${{ inputs.ubuntu2404 }}
+    permissions:
+      id-token: write
+      contents: read
+
+  buildAndPublish-Ubuntu2604:
+    name: Ubuntu 26.04 (Resolute)
+    needs: buildAssets
+    uses: ./.github/workflows/part_debian.yml
+    with:
+      publish: ${{ inputs.publish }}
+      build_number: ${{ inputs.build_number }}
+      codename: resolute
+      family: ubuntu
+      image: ubuntu:26.04
+    secrets: inherit
+    if: ${{ inputs.ubuntu2604 }}
+    permissions:
+      id-token: write
+      contents: read
+
+  buildAndPublish-Ubuntu2610:
+    name: Ubuntu 26.10 (Stonking)
+    needs: buildAssets
+    uses: ./.github/workflows/part_debian.yml
+    with:
+      publish: ${{ inputs.publish }}
+      build_number: ${{ inputs.build_number }}
+      codename: stonking
+      family: ubuntu
+      image: ubuntu:26.10
+    secrets: inherit
+    if: ${{ inputs.ubuntu2610 }}
+    permissions:
+      id-token: write
+      contents: read
+
+  buildAndPublish-Mint22:
+    name: Linux Mint 22 (Wilma)
+    needs: buildAssets
+    uses: ./.github/workflows/part_debian.yml
+    with:
+      publish: ${{ inputs.publish }}
+      build_number: ${{ inputs.build_number }}
+      codename: wilma
+      family: linuxmint
+      image: linuxmintd/mint22-amd64
+    secrets: inherit
+    if: ${{ inputs.mint22 }}
+    permissions:
+      id-token: write
+      contents: read

.github/workflows/build_mac.yml

@@ -0,0 +1,23 @@
+name: Build MacOS
+
+on: workflow_dispatch
+
+jobs:
+  buildAssets:
+    uses: ./.github/workflows/part_assets.yml
+    permissions:
+      contents: read
+
+  buildMac-AMD64:
+    needs: buildAssets
+    uses: ./.github/workflows/part_macos_amd64.yml
+    secrets: inherit
+    permissions:
+      contents: read
+
+  buildMac-M1:
+    needs: buildAssets
+    uses: ./.github/workflows/part_macos_m1.yml
+    secrets: inherit
+    permissions:
+      contents: read

.github/workflows/build_pypi.yml

@@ -0,0 +1,26 @@
+name: Build PyPI
+
+on:
+  workflow_dispatch:
+    inputs:
+      publish:
+        required: false
+        description: "Publish to PyPI?"
+        type: boolean
+        default: false
+
+jobs:
+  buildAssets:
+    uses: ./.github/workflows/part_assets.yml
+    permissions:
+      contents: read
+
+  buildAndPublish-PyPI:
+    name: PyPI Package
+    needs: buildAssets
+    uses: ./.github/workflows/part_pypi.yml
+    with:
+      publish: ${{ inputs.publish }}
+    permissions:
+      id-token: write
+      contents: read

.github/workflows/build_win.yml

@@ -0,0 +1,16 @@
+name: Build Windows
+
+on: workflow_dispatch
+
+jobs:
+  buildAssets:
+    uses: ./.github/workflows/part_assets.yml
+    permissions:
+      contents: read
+
+  buildWin-X64:
+    needs: buildAssets
+    uses: ./.github/workflows/part_win_x64.yml
+    secrets: inherit
+    permissions:
+      contents: read

.github/workflows/build_win_launcher.yml

@@ -0,0 +1,47 @@
+name: Build Windows Launcher
+
+on: workflow_dispatch
+
+jobs:
+  buildLauncherWin64:
+    runs-on: windows-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Build Launcher
+        id: build
+        run: |
+          Set-Location setup\windows
+          .\make.ps1
+
+      - name: Upload Unsigned Artifacts
+        id: upload-unsigned-artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: launcher
+          path: setup/windows/UmbraEdit.exe
+          if-no-files-found: error
+          retention-days: 14
+
+      - name: Submit Signing Request
+        uses: signpath/github-action-submit-signing-request@v2
+        with:
+          api-token: "${{ secrets.SIGNPATH_API_TOKEN }}"
+          organization-id: "0471e52c-66fa-4e9a-bfb9-36167095ca3f"
+          project-slug: "UmbraEdit"
+          signing-policy-slug: "release-signing"
+          artifact-configuration-slug: "launcher"
+          github-artifact-id: "${{ steps.upload-unsigned-artifact.outputs.artifact-id }}"
+          wait-for-completion: true
+          output-artifact-directory: "."
+
+      - name: Upload Signed Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: launcher-signed
+          path: UmbraEdit.exe
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/i18n.yml

@@ -0,0 +1,41 @@
+name: i18n
+
+on:
+  pull_request:
+    branches:
+      - main
+      - release
+    paths:
+      - i18n/*.ts
+
+jobs:
+  buildI18n:
+    name: Build i18n
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Python Setup
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+          architecture: x64
+
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install System Packages
+        run: |
+          sudo apt update
+          sudo apt install qttools5-dev-tools
+
+      - name: Build Assets
+        run: python pkgutils.py qtlrelease
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: nw-i18n
+          path: umbraedit/assets/i18n/*.qm
+          if-no-files-found: error
+          retention-days: 7

.github/workflows/part_appimage.yml

@@ -0,0 +1,141 @@
+name: Part AppImage
+
+on: workflow_call
+
+jobs:
+  buildLinux-AppImage:
+    # Needs to stay on 22.04 as long as we're using manylinux_2_28
+    # as libxcb-cursor0 in 22.04 supports glibc >= 2.17
+    name: Build AppImage
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+    env:
+      PYTHON_VERSION: "3.14"
+      LINUX_TAG: "manylinux_2_28"
+      LINUX_ARCH: "x86_64"
+    steps:
+      - name: Python Setup
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+          architecture: x64
+
+      - name: Install Packages (apt)
+        run: |
+          sudo apt update
+          sudo apt install libxcb-cursor0
+
+      - name: Install Packages (pip)
+        run: pip install python-appimage setuptools
+
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Download Artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Build AppImage
+        id: build
+        run: |
+          wget https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-$LINUX_ARCH.AppImage
+          chmod +x appimagetool-$LINUX_ARCH.AppImage
+          export APPIMAGE_TOOL_EXEC="$(pwd)/appimagetool-$LINUX_ARCH.AppImage"
+          echo "BUILD_VERSION=$(python pkgutils.py version)" >> $GITHUB_OUTPUT
+          python pkgutils.py build-appimage $LINUX_TAG $LINUX_ARCH $PYTHON_VERSION
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: UmbraEdit-${{ steps.build.outputs.BUILD_VERSION }}-Linux-AppImage
+          path: dist_appimage/*.AppImage*
+          if-no-files-found: error
+          retention-days: 14
+
+  smokeTest:
+    name: Smoke Test AppImage (${{ matrix.distro }})
+    needs: buildLinux-AppImage
+    runs-on: ubuntu-22.04
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - distro: Ubuntu 22.04
+            image: ubuntu:22.04
+          - distro: Debian 12
+            image: debian:12
+          - distro: Fedora 40
+            image: fedora:40
+          - distro: Arch Linux
+            image: archlinux:latest
+          - distro: Manjaro
+            image: manjarolinux/base:latest
+    container:
+      image: ${{ matrix.image }}
+    steps:
+      - name: Install Runtime Dependencies
+        run: |
+          if command -v apt-get >/dev/null 2>&1; then
+            apt-get update
+            apt-get install -y ca-certificates libgl1 libxkbcommon0 libegl1 libfontconfig1 libglib2.0-0 libdbus-1-3
+          elif command -v dnf >/dev/null 2>&1; then
+            dnf install -y ca-certificates coreutils mesa-libGL mesa-libEGL libxkbcommon fontconfig glib2 dbus-libs
+          elif command -v pacman >/dev/null 2>&1; then
+            pacman -Syu --noconfirm --needed ca-certificates coreutils mesa libxkbcommon fontconfig glib2 dbus
+          fi
+
+      - name: Download AppImage Artifact
+        uses: actions/download-artifact@v8
+        with:
+          pattern: UmbraEdit-*-Linux-AppImage
+          merge-multiple: true
+          path: appimage-dist
+
+      - name: Run AppImage Smoke Test
+        run: |
+          set -eu
+          APPIMAGE_FILE="$(find appimage-dist -maxdepth 1 -name '*.AppImage' | head -n1)"
+          if [ -z "$APPIMAGE_FILE" ]; then
+            echo "No AppImage artifact found"
+            exit 1
+          fi
+
+          chmod +x "$APPIMAGE_FILE"
+          export QT_QPA_PLATFORM=offscreen
+          export QT_NO_XDG_DESKTOP_PORTAL=1
+          export APPIMAGE_EXTRACT_AND_RUN=1
+
+          set +e
+          timeout 25s "$APPIMAGE_FILE" > smoke.log 2>&1
+          EXIT_CODE=$?
+          set -e
+
+          if [ "$EXIT_CODE" -eq 139 ]; then
+            echo "AppImage crashed with segmentation fault"
+            exit 1
+          fi
+
+          if grep -Eiq 'segmentation fault|core dumped' smoke.log; then
+            echo "Crash signature found in smoke log"
+            exit 1
+          fi
+
+          if [ "$EXIT_CODE" -ne 0 ] && [ "$EXIT_CODE" -ne 124 ]; then
+            echo "Unexpected exit code: $EXIT_CODE"
+            cat smoke.log
+            exit 1
+          fi
+
+      - name: Upload Smoke Logs
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: appimage-smoke-log-${{ matrix.distro }}
+          path: smoke.log
+          if-no-files-found: ignore
+          retention-days: 14

.github/workflows/part_assets.yml

@@ -0,0 +1,44 @@
+name: Part Assets
+
+on:
+  workflow_call:
+
+jobs:
+  buildAssets:
+    name: Build Assets
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install System Packages
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y qttools5-dev-tools latexmk texlive texlive-latex-extra
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: "3.14"
+          enable-cache: true
+
+      - name: Install Dependencies
+        run: |
+          uv sync --no-dev --group docs
+
+      - name: Build Assets
+        run: |
+          uv run --no-sync pkgutils.py build-assets
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: nw-assets
+          path: |
+            umbraedit/assets/manual*.pdf
+            umbraedit/assets/sample.zip
+            umbraedit/assets/i18n/*.qm
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/part_debian.yml

@@ -0,0 +1,82 @@
+name: Part Debian
+
+on:
+  workflow_call:
+    inputs:
+      publish:
+        required: false
+        type: boolean
+        default: false
+      build_number:
+        required: false
+        type: string
+        default: "0"
+      codename:
+        required: true
+        type: string
+      family:
+        required: true
+        type: string
+      image:
+        required: true
+        type: string
+    secrets:
+      CLOUDSMITH_API_KEY:
+        required: false
+
+jobs:
+  buildPackage:
+    name: Build Debian Package
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    container:
+      image: ${{ inputs.image }}
+    steps:
+      - name: Install Checkout Prerequisites
+        run: |
+          apt-get update
+          apt-get install -y git ca-certificates python3
+
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Download Assets Artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Install Native Packages
+        run: apt-get install -y $(python3 pkgutils.py build-deb-depends ${{ inputs.codename }})
+
+      - name: Build Package
+        run: python3 pkgutils.py build-deb ${{ inputs.codename }} --build ${{ inputs.build_number }} --install-source Cloudsmith
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: nw-deb-${{ inputs.codename }}
+          path: dist_upload/*
+          if-no-files-found: error
+          retention-days: 14
+
+      - name: Set up Cloudsmith CLI with OIDC
+        if: ${{ inputs.publish }}
+        uses: cloudsmith-io/cloudsmith-cli-action@v3
+        with:
+          oidc-namespace: "saga-soft"
+          oidc-service-slug: "github-actions-lcpr"
+          verify-auth: true
+
+      - name: Publish to Cloudsmith
+        if: ${{ inputs.publish }}
+        run: |
+          CHANNEL="$(python3 pkgutils.py channel)"
+          REPO="stable"
+          if [ "$CHANNEL" = "pre" ]; then
+            REPO="testing"
+          fi
+          DEB_FILE="$(find dist_upload -name '*.deb')"
+          cloudsmith push deb "saga-soft/$REPO/${{ inputs.family }}/${{ inputs.codename }}" "$DEB_FILE" --republish

.github/workflows/part_flatpak.yml

@@ -0,0 +1,46 @@
+name: Part Flatpak
+
+on: workflow_call
+
+jobs:
+  buildLinux-Flatpak:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install Packages
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y flatpak flatpak-builder
+          flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo
+
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: "3.14"
+          enable-cache: true
+
+      - name: Install Dependencies
+        run: |
+          uv sync --no-dev --group build
+
+      - name: Download Artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Build Flatpak
+        id: build
+        run: |
+          echo "BUILD_VERSION=$(uv run pkgutils.py version)" >> $GITHUB_OUTPUT
+          uv run --no-sync pkgutils.py build-flatpak
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: UmbraEdit-${{ steps.build.outputs.BUILD_VERSION }}-Linux-Flatpak
+          path: dist_flatpak/*.flatpak*
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/part_macos_amd64.yml

@@ -0,0 +1,37 @@
+name: Part MacOS AMD64
+
+on: workflow_call
+
+jobs:
+  buildMac-AMD64:
+    name: Build on MACOS AMD64
+    runs-on: macos-latest
+    permissions:
+      contents: read
+    env:
+      PYTHON_VERSION: "3.13"
+      PACKAGE_ARCH: x86_64
+      MINICONDA_ARCH: x86_64
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Download Artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Build App Bundle
+        id: build
+        run: |
+          echo "BUILD_VERSION=$(python pkgutils.py version)" >> $GITHUB_OUTPUT
+          ./setup/macos/build.sh $PYTHON_VERSION $PACKAGE_ARCH $MINICONDA_ARCH
+
+      - name: Upload DMG
+        uses: actions/upload-artifact@v7
+        with:
+          name: UmbraEdit-${{ steps.build.outputs.BUILD_VERSION }}-MacOS-AMD64-DMG
+          path: dist_macos/*.dmg*
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/part_macos_m1.yml

@@ -0,0 +1,37 @@
+name: Part MacOS M1
+
+on: workflow_call
+
+jobs:
+  buildMac-M1:
+    name: Build on MacOS AARCH64
+    runs-on: macos-latest
+    permissions:
+      contents: read
+    env:
+      PYTHON_VERSION: "3.13"
+      PACKAGE_ARCH: aarch64
+      MINICONDA_ARCH: arm64
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Download Artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Build App Bundle
+        id: build
+        run: |
+          echo "BUILD_VERSION=$(python pkgutils.py version)" >> $GITHUB_OUTPUT
+          ./setup/macos/build.sh $PYTHON_VERSION $PACKAGE_ARCH $MINICONDA_ARCH
+
+      - name: Upload DMG
+        uses: actions/upload-artifact@v7
+        with:
+          name: UmbraEdit-${{ steps.build.outputs.BUILD_VERSION }}-MacOS-M1-DMG
+          path: dist_macos/*.dmg*
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/part_pypi.yml

@@ -0,0 +1,66 @@
+name: Part PyPI
+
+on:
+  workflow_call:
+    inputs:
+      publish:
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  buildPackage:
+    name: Build PyPI Package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Download Assets Artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: "3.14"
+          enable-cache: true
+
+      - name: Build Package
+        run: uv run pkgutils.py build-pypi
+
+      - name: Upload Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: nw-pypi
+          path: |
+            dist_pypi/*.whl
+            dist_pypi/*.tar.gz
+          if-no-files-found: error
+          retention-days: 14
+
+  publishPackage:
+    name: Publish to PyPI
+    needs: buildPackage
+    if: ${{ inputs.publish }}
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Download Package Artifact
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-pypi
+          path: dist_pypi
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v10.2.0
+
+      - name: Publish Package
+        run: uv publish dist_pypi/*

.github/workflows/part_win_x64.yml

@@ -0,0 +1,64 @@
+name: Part Windows X64
+
+on: workflow_call
+
+jobs:
+  buildWin-X64:
+    name: Build on Windows
+    runs-on: windows-2022
+    permissions:
+      contents: read
+    steps:
+      - name: Python Setup
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.14"
+          architecture: x64
+
+      - name: Install Packages (pip)
+        run: pip install tzdata
+
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Download Assets
+        uses: actions/download-artifact@v8
+        with:
+          name: nw-assets
+          path: umbraedit/assets
+
+      - name: Build Setup Installer
+        id: build
+        run: |
+          echo "BUILD_VERSION=$(python pkgutils.py version)" >> $Env:GITHUB_OUTPUT
+          python pkgutils.py build-win-exe
+
+      - name: Upload Unsigned Artifacts
+        id: upload-unsigned-artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: UmbraEdit-${{ steps.build.outputs.BUILD_VERSION }}-Win-Setup
+          path: dist/*.exe
+          if-no-files-found: error
+          retention-days: 14
+
+      - name: Submit Signing Request
+        uses: signpath/github-action-submit-signing-request@v1
+        with:
+          api-token: "${{ secrets.SIGNPATH_API_TOKEN }}"
+          organization-id: "0471e52c-66fa-4e9a-bfb9-36167095ca3f"
+          project-slug: "UmbraEdit"
+          signing-policy-slug: "release-signing "
+          github-artifact-id: "${{ steps.upload-unsigned-artifact.outputs.artifact-id }}"
+          wait-for-completion: true
+          output-artifact-directory: "dist/"
+          parameters: |
+            version: "${{ steps.build.outputs.BUILD_VERSION }}"
+
+      - name: Upload Signed Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: UmbraEdit-${{ steps.build.outputs.BUILD_VERSION }}-Win-Setup-Signed
+          path: dist/*.exe
+          if-no-files-found: error
+          retention-days: 14

.github/workflows/policy.yml

@@ -0,0 +1,17 @@
+name: Policy Checks
+
+on:
+  pull_request:
+    branches:
+      - main
+      - release
+
+jobs:
+  commitPolicy:
+    name: Commit Policy
+    uses: saga-soft/automation/.github/workflows/saga-soft-policy.yml@main
+    permissions:
+      contents: read
+      pull-requests: read
+    with:
+      policy-url: https://github.com/saga-soft/UmbraEdit/blob/main/AI_POLICY.md

.github/workflows/syntax.yml

@@ -1,30 +1,41 @@
-name: Flake8
+name: Syntax
 
 on:
   push:
     branches:
       - main
-      - dev
+      - release
   pull_request:
     branches:
       - main
-      - dev
+      - release
 
 jobs:
   checkSyntax:
+    name: Linting and Type Checking
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
-      - name: Python Setup
-        uses: actions/setup-python@v5
-        with:
-          python-version: 3
-          architecture: x64
       - name: Checkout Source
-        uses: actions/checkout@v4
-      - name: Install flake8
-        run: pip install flake8 flake8-pep585
-      - name: Syntax Check
+        uses: actions/checkout@v7
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          enable-cache: true
+
+      - name: Install Dependencies
         run: |
-          flake8 --version
-          flake8 novelwriter --count --show-source --statistics
-          flake8 tests --count --show-source --statistics
+          uv sync --no-dev --group lint --group test
+
+      - name: Ruff Check
+        run: |
+          uv run --no-sync ruff --version
+          uv run --no-sync ruff format --check
+          uv run --no-sync ruff check --output-format github
+
+      - name: Pyright Check
+        run: |
+          uv run --no-sync pyright --version
+          uv run --no-sync pyright

.github/workflows/test_linux.yml

@@ -1,41 +0,0 @@
-name: Linux
-
-on:
-  push:
-    branches:
-      - main
-      - dev
-  pull_request:
-    branches:
-      - main
-      - dev
-
-jobs:
-  testLinux:
-    strategy:
-      matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
-    runs-on: ubuntu-latest
-    steps:
-      - name: Python Setup
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-          architecture: x64
-      - name: Install Packages (apt)
-        run: |
-          sudo apt update
-          sudo apt install libenchant-2-dev qttools5-dev-tools aspell-en
-      - name: Checkout Source
-        uses: actions/checkout@v4
-      - name: Install Dependencies (pip)
-        run: |
-          pip install -U -r requirements.txt -r tests/requirements.txt
-      - name: Run Build Commands
-        run: python pkgutils.py qtlrelease sample
-      - name: Run Tests
-        run: |
-          export QT_QPA_PLATFORM=offscreen
-          pytest -v --cov=novelwriter --timeout=60
-      - name: Upload to Codecov
-        uses: codecov/codecov-action@v3

.github/workflows/test_mac.yml

@@ -1,35 +0,0 @@
-name: MacOS
-
-on:
-  push:
-    branches:
-      - main
-      - dev
-  pull_request:
-    branches:
-      - main
-      - dev
-
-jobs:
-  testMac:
-    runs-on: macos-latest
-    steps:
-      - name: Python Setup
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-          architecture: x64
-      - name: Install Packages (brew)
-        run: |
-          brew install enchant
-      - name: Checkout Source
-        uses: actions/checkout@v4
-      - name: Install Dependencies (pip)
-        run: |
-          pip install -U pyobjc -r requirements.txt -r tests/requirements.txt
-      - name: Run Tests
-        run: |
-          export QT_QPA_PLATFORM=offscreen
-          pytest -v --cov=novelwriter --timeout=60
-      - name: Upload to Codecov
-        uses: codecov/codecov-action@v3

.github/workflows/test_win.yml

@@ -1,31 +0,0 @@
-name: Windows
-
-on:
-  push:
-    branches:
-      - main
-      - dev
-  pull_request:
-    branches:
-      - main
-      - dev
-
-jobs:
-  testWin:
-    runs-on: windows-latest
-    steps:
-      - name: Python Setup
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-          architecture: x64
-      - name: Checkout Source
-        uses: actions/checkout@v4
-      - name: Install Dependencies (pip)
-        run: |
-          pip install -U -r requirements.txt -r tests/requirements.txt
-      - name: Run Tests
-        run: |
-          pytest -v --cov=novelwriter --timeout=60
-      - name: Upload to Codecov
-        uses: codecov/codecov-action@v3

.github/workflows/tests.yml

@@ -0,0 +1,308 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - main
+      - release
+  pull_request:
+    branches:
+      - main
+      - release
+
+jobs:
+  testLinux:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+          - "3.15"
+      fail-fast: false
+    name: Linux Python ${{ matrix.python-version }}
+    permissions:
+      contents: read
+    env:
+      COVERAGE_FILE: .coverage.py${{ matrix.python-version }}
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install System Packages
+        timeout-minutes: 5
+        run: |
+          sudo apt update
+          sudo apt install qttools5-dev-tools
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install Dependencies
+        run: |
+          uv sync --no-dev --group test
+
+      - name: Build Assets
+        run: |
+          uv run --no-sync pkgutils.py qtlrelease
+          uv run --no-sync pkgutils.py sample
+
+      - name: Run Tests
+        run: |
+          export QT_QPA_PLATFORM=offscreen
+          uv run --no-sync coverage run -m pytest -v --timeout=60
+          uv run --no-sync coverage report --skip-covered --show-missing
+
+      - name: Upload Coverage Data
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-data-py${{ matrix.python-version }}
+          path: ${{ env.COVERAGE_FILE }}
+          include-hidden-files: true
+          retention-days: 1
+
+  testMac:
+    runs-on: macos-latest
+    name: MacOS Python 3.14
+    permissions:
+      contents: read
+    env:
+      COVERAGE_FILE: .coverage.mac
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install System Packages
+        run: |
+          brew install enchant
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: "3.14"
+          enable-cache: true
+
+      - name: Install Dependencies
+        run: |
+          uv sync --no-dev --group test
+
+      - name: Build Assets
+        run: |
+          uv run --no-sync pkgutils.py sample
+
+      - name: Run Tests
+        run: |
+          export QT_QPA_PLATFORM=offscreen
+          uv run --no-sync coverage run -m pytest -v --timeout=60
+          uv run --no-sync coverage report --skip-covered --show-missing
+
+      - name: Upload Coverage Data
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-data-mac
+          path: ${{ env.COVERAGE_FILE }}
+          include-hidden-files: true
+          retention-days: 1
+
+  testWin:
+    runs-on: windows-latest
+    name: Windows Python 3.14
+    permissions:
+      contents: read
+    env:
+      COVERAGE_FILE: .coverage.win
+    defaults:
+      run:
+        shell: bash
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install UV and Python
+        uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: "3.14"
+          enable-cache: true
+
+      - name: Install Dependencies
+        run: |
+          uv sync --no-dev --group test
+
+      - name: Build Assets
+        run: |
+          uv run --no-sync pkgutils.py sample
+
+      - name: Run Tests
+        run: |
+          uv run --no-sync coverage run -m pytest -v --timeout=60
+          uv run --no-sync coverage report --skip-covered --show-missing
+
+      - name: Upload Coverage Data
+        uses: actions/upload-artifact@v7
+        with:
+          name: coverage-data-win
+          path: ${{ env.COVERAGE_FILE }}
+          include-hidden-files: true
+          retention-days: 1
+
+  coverageReport:
+    name: PR Coverage Report
+    needs:
+      - testLinux
+      - testMac
+      - testWin
+    if: github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Download Coverage Data
+        uses: actions/download-artifact@v8
+        with:
+          pattern: coverage-data-*
+          merge-multiple: true
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v10.2.0
+
+      - name: Combine Coverage Data
+        run: |
+          uvx coverage combine
+          uvx coverage report --skip-covered
+
+      - name: Build Comment Body
+        run: |
+          {
+            echo '<!-- coverage-report -->'
+            echo '### Coverage Report (Linux, macOS, Windows)'
+            echo
+            uvx coverage report --skip-covered --show-missing --format=markdown --precision=3
+            echo
+            echo "**Total: $(uvx coverage report --format=total --precision=3)%**"
+          } > coverage-comment.md
+
+      - name: Post PR Comment
+        env:
+          GH_TOKEN: ${{ github.token }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+          REPO: ${{ github.repository }}
+        run: |
+          comment_id=$(gh api "repos/$REPO/issues/$PR_NUMBER/comments" --paginate --jq '.[] | select(.body | startswith("<!-- coverage-report -->")) | .id' | head -n1)
+          if [ -n "$comment_id" ]; then
+            gh api --method PATCH "repos/$REPO/issues/comments/$comment_id" -F body=@coverage-comment.md
+          else
+            gh pr comment "$PR_NUMBER" --body-file coverage-comment.md
+          fi
+
+  coverageSummary:
+    name: Action Coverage Report
+    needs:
+      - testLinux
+      - testMac
+      - testWin
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Download Coverage Data
+        uses: actions/download-artifact@v8
+        with:
+          pattern: coverage-data-*
+          merge-multiple: true
+
+      - name: Install UV
+        uses: astral-sh/setup-uv@v10.2.0
+
+      - name: Combine Coverage Data
+        run: |
+          uvx coverage combine
+          uvx coverage report --skip-covered
+
+      - name: Write Coverage Summary
+        run: |
+          {
+            echo '### Coverage Report (Linux, macOS, Windows)'
+            echo
+            uvx coverage report --skip-covered --show-missing --format=markdown --precision=3
+            echo
+            echo "**Total: $(uvx coverage report --format=total --precision=3)%**"
+          } >> "$GITHUB_STEP_SUMMARY"
+
+  testUbuntu24:
+    name: Ubuntu 24.04 & Sys Packages
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Install System Packages
+        timeout-minutes: 5
+        run: |
+          sudo apt update
+          sudo apt install \
+            python3-pyqt6 \
+            python3-pyqt6.qtsvg \
+            python3-pytest \
+            python3-pytestqt \
+            python3-enchant \
+            python3-pytest-timeout \
+            qt6-image-formats-plugins
+
+      - name: Build Assets
+        run: |
+          python3 pkgutils.py sample
+
+      - name: Run Tests
+        run: |
+          export QT_QPA_PLATFORM=offscreen
+          python3 -m pytest -v --timeout=60
+
+  testFedoraLatest:
+    name: Fedora 44 & Sys Packages
+    runs-on: ubuntu-latest
+    container:
+      image: fedora:44
+    permissions:
+      contents: read
+    steps:
+      - name: Install System Packages
+        timeout-minutes: 5
+        run: |
+          dnf -y update
+          dnf -y install \
+            git \
+            python3-enchant \
+            python3-pyqt6 \
+            python3-pytest \
+            python3-pytest-qt \
+            python3-pytest-timeout \
+            qt6-linguist \
+            qt6-qtimageformats
+
+      - name: Checkout Source
+        uses: actions/checkout@v7
+
+      - name: Run Build Commands
+        run: |
+          python pkgutils.py qtlrelease
+          python pkgutils.py sample
+
+      - name: Run Tests
+        run: |
+          export QT_QPA_PLATFORM=offscreen
+          python3 -m pytest -v --timeout=60

.gitignore

@@ -1,55 +1,87 @@
 # Setup/Install
 /MANIFEST
 /build/
+/build_*/
 /deploy/
 /dist/
 /dist_*/
 *.spec
 *.egg-info
 setup.iss
-/novelwriter.desktop
-/novelWriter.pyw
+/umbraedit.desktop
+/UmbraEdit.pyw
 /setup/macos/Info.plist
+/setup/windows/build
+.flatpak-builder
 .venv
+.env
 
 # Translations
-/novelwriter/assets/i18n/*.qm
+/umbraedit/assets/i18n/*.qm
 .qmake.stash
 i18n/*.qm
 i18n/*.qph
 
 # Documentation
 /docs/build/
-/novelwriter/assets/help/
-/novelwriter/assets/manual.pdf
-*.qch
-*.qhc
+/docs/source/locales/**/*.mo
+/umbraedit/assets/manual*.pdf
 .~lock.*
 
-# Python Temp
+# Python
+/.python-version
 __pycache__
 *.pyc
 
 # Sample Project
-/novelwriter/assets/sample.zip
-/sample/cache
+/umbraedit/assets/sample.zip
 /sample/meta
-*.bak
-*.lock
-ToC.txt
+/sample/**/*.bak
+/sample/*.lock
+/sample/ToC.txt
+/sample/manifest.json
 
 # PyTest
 /prof/
 /htmlcov/
 /tests/temp
-/tests/lipsum/cache
-/tests/lipsum/meta
+/tests/_temp
 /.pytest_cache
 /pytestdebug.log
 
 # Coverage
 /.coverage
+/.coveragerc
 /coverage.*
 
 # Other
-/test.py
+.config
+.local
+*.patch
+
+# IDE
+.vscode
+.ruff_cache
+.nvimlog
+
+# No AI files
+AGENTS.md
+CLAUSE.md
+GEMINI.md
+.claude/
+.cursor*
+.codex/
+.gemini/
+
+# Debug
+/debug/
+
+# Clean up accidentally committed files
+# Added by B.D. Murphy 2026: exclude files accidentally committed during branding transition
+Splh.jpeg
+Oldwelcome.webp
+.DS_Store
+UmbraEdit_Projects/
+Inner_Demon_1.2a.docm
+requirements.txt
+UmbraEdit_deb_Build_Script.txt

AI_POLICY.md

@@ -0,0 +1,59 @@
+# AI Policy
+
+This is the AI policy of UmbraEdit and associated projects.
+
+
+### Code Contributions
+
+We consider code to be creative work, and we have a strong preference for feature contributions designed by actual
+humans over the average and mediocre output of agentic and generative AI.
+
+While we do not have a strict No-AI policy, we want to limit its use in this project. In general, we expect any
+contributed code to hold up to maintainability and stability standards so that our users can rely on the software for
+their creative work. This implies careful review, thorough test coverage, and beta testing of all features before they
+reach live users. The requirements on code that isn't shipped to the user are less strict. This includes unit tests and
+build tooling.
+
+We recognise that AI tools can be useful in a developer's toolbox, alongside other tools that can edit or add code. In
+addition to read-only operations, it is generally fine to use them for boilerplate, fixes, and otherwise editing and
+extending existing code. However, you must not contribute fully or predominantly AI-generated features or other
+bulk-generated code. This applies especially to core functionality.
+
+In general, so-called vibe coding does not meet our code quality requirements, so this project is not suitable for such
+contributions in any case. The licensing implications around generated code are also unclear, as AI models are trained
+on material without consent or concern for original licensing.
+
+No AI automation or agentic tools are used anywhere in this project on GitHub. Do not use your AI agents on your
+contributions on GitHub either. Commits listed in any way as authored by, signed off by, or assisted by, AI tools are
+explicitly not allowed. Pull requests containing such commits will be rejected. You should also not commit AI-specific
+files into the code repository. Most of the common ones are in the git ignore file.
+
+
+### Design Work
+
+No design work generated by AI for UmbraEdit will be accepted. We do not control how third-party work like icon
+libraries are created, but any artwork added to the app must be made by actual people.
+
+
+### Translation Work
+
+This project uses Crowdin to host the translation files for the user interface. Crowdin has a lot of AI integration and
+tooling, which we do not use. The Crowdin translation interface provides AI translated suggestions, which the
+translators may choose to use. All translations are proofread and approved by speakers of the respective languages.
+
+
+### Application Features
+
+We do not believe creative writing and generative AI go together. Therefore, there will not be any tooling or features
+added to this project that will generate text for you. Language models have a real use case in text analysis that
+predates generative AI, and such supportive tools **may** be in scope depending on how intrusive they are.
+
+
+### Discussions and Comments
+
+Please refrain from using AI to generate or respond to discussions, issues, and pull requests. Especially do not use AI
+tools to generate long and verbose issue reports. It is OK to use AI for translations of comments or for accessibility
+reasons. All text in the code or posted to this project must be in English.
+
+
+*Last updated on 2026-10-03.*

BUILD_LINUX.md

@@ -0,0 +1,146 @@
+# UmbraEdit - Linux AMD64 Build Guide
+
+UmbraEdit is developed on macOS but builds natively on Linux AMD64 and ARM64.
+This guide covers building Linux install packages from source.
+
+## Source Distribution
+
+The source tarball (`umbraedit-2026.11.1.tar.gz`) includes everything needed to
+build Linux packages:
+
+```
+umbraedit-2026.11.1/
+├── pyproject.toml          # Project metadata & dependencies
+├── UmbraEdit.py            # Application entry point
+├── pkgutils.py             # Packaging utility
+├── run_tests.py            # Test runner
+├── setup/                  # Packaging assets
+│   ├── data/               # .desktop file, MIME type XML
+│   ├── macos/              # macOS-specific packaging
+│   └── windows/            # Windows-specific packaging
+├── utils/                  # Build scripts
+│   ├── build_debian.py     # .deb package builder
+│   ├── build_appimage.py   # AppImage builder
+│   ├── build_all.py        # Multi-platform build orchestrator
+│   └── ...
+├── umbraedit/              # Application source code
+└── tests/                  # Test suite
+```
+
+## Prerequisites on Linux
+
+### Debian/Ubuntu
+
+```bash
+sudo apt-get update
+sudo apt-get install \
+    python3 python3-pip \
+    python3-pyqt6 python3-pyqt6.qtsvg \
+    python3-enchant \
+    qt6-image-formats-plugins qt6-svg-plugins \
+    dh-python debhelper python3-build python3-setuptools \
+    python3-pytest python3-pytestqt python3-pytest-timeout \
+    appimagetool
+```
+
+### Fedora/RHEL
+
+```bash
+sudo dnf install \
+    python3 python3-pip \
+    python3-pyqt6 python3-enchant \
+    qt6-qtimageformats qt6-qtsvg \
+    python3-build python3-setuptools \
+    dpkg rpm-build appimagetool
+```
+
+### Arch Linux
+
+```bash
+sudo pacman -S \
+    python python-pip \
+    python-pyqt6 python-enchant \
+    qt6-imageformats qt6-svg \
+    python-build python-setuptools \
+    dpkg appimagetool
+```
+
+## Build Options
+
+### Option 1: Install via Wheel (Simplest)
+
+The pure Python wheel requires no compilation:
+
+```bash
+pip install umbraedit-2026.11.1-py3-none-any.whl
+umbraedit
+```
+
+### Option 2: Install from Source Tarball
+
+```bash
+tar xzf umbraedit-2026.11.1.tar.gz
+cd umbraedit-2026.11.1
+pip install .
+umbraedit
+```
+
+### Option 3: Build .deb Package
+
+```bash
+tar xzf umbraedit-2026.11.1.tar.gz
+cd umbraedit-2026.11.1
+
+# Build for Ubuntu Noble (24.04)
+python3 utils/build_debian.py --distro noble --build 1
+
+# The .deb will be in dist_deb/
+sudo dpkg -i dist_deb/umbraedit_*_amd64.deb
+```
+
+Available distro targets: `bookworm`, `trixie`, `noble`, `resolute`, `stonking`, `wilma`
+
+### Option 4: Build AppImage
+
+```bash
+pip install python-appimage
+sudo apt-get install appimagetool
+
+tar xzf umbraedit-2026.11.1.tar.gz
+cd umbraedit-2026.11.1
+
+python3 utils/build_appimage.py --linux ubuntu --arch amd64 --python 3.12
+
+chmod +x dist_appimage/umbraedit-2026.11-amd64.AppImage
+./dist_appimage/umbraedit-2026.11-amd64.AppImage
+```
+
+### Option 5: Build All Linux Packages
+
+```bash
+tar xzf umbraedit-2026.11.1.tar.gz
+cd umbraedit-2026.11.1
+
+python3 utils/build_all.py --platform linux --arch amd64
+```
+
+## Project Storage
+
+UmbraEdit projects are stored in plain folders with an `nwProject.nwx` file.
+The sample project included in the distribution can be used for testing:
+
+```bash
+umbraedit  # Opens the welcome dialog
+# Select "Sample Project" from the list, or browse to your .nwx file
+```
+
+## Version
+
+Current development version: **2026.11.0004**
+
+## License
+
+GPL-3.0-or-later AND Apache-2.0 AND ISC AND MIT
+
+UmbraEdit is based on novelWrite 2026.02 by Veronica Berglyd Olsen
+(novelWriter.io), licenced under the same GPL v3.0 license.

CODE_OF_CONDUCT.md

@@ -1,132 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the overall
-  community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or advances of
-  any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email address,
-  without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at issues (at)
-novelwriter.io. All complaints will be reviewed and investigated promptly and
-fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of
-actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or permanent
-ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the
-community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
-
-For answers to common questions about this code of conduct, see the FAQ at
-[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
-[https://www.contributor-covenant.org/translations][translations].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations

CONTRIBUTING.md

@@ -1,122 +1,179 @@
 # Contributing Guide
 
-When contributing to this repository, please first discuss the change you wish to make via the
-issue tracker or the discussions page with the owner of this repository. Especially if it is
-regarding new features. If you just want to make a minor correction, like fix a typo or similar,
-feel free to just make a pull request directly.
+See also our [Code of Conduct](https://github.com/saga-soft/UmbraEdit?tab=coc-ov-file#code-of-conduct)
+and our [AI Policy](https://github.com/saga-soft/UmbraEdit/blob/main/AI_POLICY.md).
 
-The following contributions are welcome:
+When contributing to this repository, please first discuss the change you wish to make with the
+maintainers. For new and complex ideas, it is better to open a discussion before adding a new
+feature request. If you just want to make a minor correction, like fix a typo or similar, feel free
+to just make a pull request directly.
+
+**The following contributions are welcome:**
 
 * Bugfixes for new or existing bugs. Please also report new bugs in the issue tracker even if you
-  also provide a fix. It makes it easier to keep track of what has been fixed and when.
-* Translations via the [crowdin project page](https://crowdin.com/project/novelwriter).
+  also provide a fix. It makes it easier to keep track of what has been fixed and when and to
+  populate our changelog.
+* Translations made via the [Crowdin project page](https://crowdin.com/project/umbraedit).
+* Translations of the documentation. These need to use Sphinx i18n tooling. Please start a
+  discussion before beginning such work as it requires some coordination.
 * Improvements to the documentation. Particularly if the documentation is unclear. Please don't
-  make any larger changes to the documentation without discussing if with the maintainer first.
+  make any larger changes to the documentation without discussing them with a maintainer first.
 * Adaptations, installation or packaging features targeting specific operating systems.
+* Using AI as a coding assistant is fine as long as the code is of good quality and the scope of
+  change is small, but do not generate large chunks of code. Generated code is not only hard to
+  maintain, but also poses licensing issues.
 
-Please do not:
+**Please do not:**
 
-* Make a pull request that restructures or reformats existing code. If you think some parts of the
+* Make a pull request that restructures or reformats existing code. If you think some part of the
   code could be improved, please make an issue thread or start a discussion. The same applies to
   any text document in the repository.
+* Make pull requests with AI generated code. This is not a project suitable for vibe coding.
+  Outright slop will result in the account being blocked.
 
-## Pull Requests
 
-This project follows the [OneFlow](https://www.endoflineblog.com/oneflow-a-git-branching-model-and-workflow)
-model. The `main` branch is the default branch. For general changes, please make a new branch in
-your own fork from the current `main` branch. Do not make pull requests from your own `main`
-branch.
+## Running from Source
 
-**Note:** If your contribution is a bugfix for a specific version, please make a bugfix branch from
-the tag you want the fix to be applied to, not directly from the `main` branch. This is important.
+This project uses [uv](https://docs.astral.sh/uv/) to maintain dependencies. In order to run
+UmbraEdit directly from checked out source, simply call from the root folder with:
 
-Also check the following:
-
-* Make sure your code passes all tests and conforms to the style guide. You can check that the
-  code generally conforms by running the Python linting tool `flake8` from the root of the project
-  folder, although it doesn't check everything. The same check is also run on pull requests by the
-  maintainer.
-* Please provide a description of the changes in the pull request under the summary section of the
-  pull request template, and reference any related issues by providing the issue number.
-* Do not change the version number.
-* Do not submit files that were not actively changed but have otherwise been modifed. This is
-  mostly an issue with translation files. The language tool may update all files in the `i18n`
-  folder.
-
-## Code of Conduct
-
-There is a code of conduct. Please follow it in all your interactions with the project.
-
-### Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as contributors and maintainers
-pledge to making participation in our project and our community a harassment-free experience for
-everyone, regardless of age, body size, disability, ethnicity, gender identity and expression,
-level of experience, nationality, personal appearance, race, religion, or sexual identity and
-orientation.
-
-Please see the [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) file for the full text.
-
-## Code Style Guide
-
-The source code of novelWriter broadly follows the [PEP8](https://www.python.org/dev/peps/pep-0008)
-style guide, but with a few exceptions. Some key points are listed below.
-
-**Line Length:**
-
-* Source code lines can extend to the upper limit of 99 characters allowed by PEP8. 79 characters
-  is the recommended line length in PEP8, but this is often too restrictive. 99 characters are
-  acceptable when that is more practical. Readability has priority. Generally, if a code statement
-  requires multiple lines, the lines should wrap at 79 characters if possible. If wrapping can be
-  avoided by going to 99, then that is generally preferrable.
-* For text files, the text should be wrapped at 99 character. The exception is markdown image tags
-  and urls which can run past that limit.
-
-**Variable and Function Names**
-
-* PEP8 allows for camelCase for consistency with existing code. The Qt library uses camelCase, so
-  the Python source code does too.
-* The exception to the above is for constants. They should always be in upper snake case, like PEP8
-  states.
-
-**Spaces, Indentation and Alignment**
-
-* Only indentation by multiples of 4 spaces is allowed.
-* No trailing spaces should occur on any line in the source code, including empty lines.
-* Ideally, a function should end on the same indention level as it started. Exceptions are allowed
-  if it makes the code easier to follow.
-* Aligning operators and attributes in columns with multiple spaces is not allowed by PEP8. The
-  rule is relaxed a bit here. Alignment is allowed when populating large dictionaries or setting
-  many class attributes. It does improve readability in such cases, but should not be overused.
-
-### Linting with `flake8`
-
-A good tool for checking Python code for errors and code style is `flake8`. The documentation is
-available [here](https://flake8.pycqa.org/en/latest/).
-
-The `setup.cfg` file in the root of this project has the following settings for `flake8` that
-matches the above code style:
-```conf
-[flake8]
-ignore = E133,E221,E226,E228,E241,W503
-max-line-length = 99
-exclude = docs/*
-```
-
-The command line equivalent, with reporting, is:
 ```bash
-flake8 . --count --ignore E133,E221,E226,E228,E241,W503 --max-line-length=99 --show-source --statistics
+uv run umbraedit
 ```
 
-Passing this check is required before contributions are merged. This is checked automatically when
-you make a pull request. You can run the `flake8` command locally to check beforehand. The full
-command will give you a detailed description of the code lines that do not conform to the standard.
+To set up a development environment with all needed dependencies, run:
 
-Two of the ignored errors are due to the relaxed restriction on column alignment, these are the
-E221 and E241 error codes.
+```bash
+uv sync
+```
 
-The code E226 is ignored becuse it doesn't actually follow the
-[PEP8 recommendation](https://www.python.org/dev/peps/pep-0008/#other-recommendations)
-of grouping longer equations by operator precedence like `2*a + 3*b` instead of `a * a + 3 * b`.
-Generally, don't use spaces around `*`, `/` and `**`, but _do_ use spaces around `+` and `-`.
-The same applies to the modulo operator `%`, hence E228 is also ignored.
+Many tasks, like building assets from source, are handled by the `pkgutils.py` helper tool.
+This tool requires no dependencies for most commands, so you can either run it directly with
+Python, or using `uv run`.
+
+```bash
+python pkgutils.py --help
+```
+
+The translation files needed at runtime can be built with:
+
+```bash
+python pkgutils.py qtlrelease
+```
+
+Default icon themes can be updated with:
+
+```bash
+python pkgutils.py icons default
+```
+
+
+### Running Tests
+
+* New code must not break any existing tests.
+* New code must come with tests that cover the code in full. This includes branch coverage. If the
+  code has branches that only runs on some OSes, they only need to be covered when test are run on
+  that OS. The test suite runs on Linux, Windows and MacOS.
+* It is ok to use `pragma` comments with `no cover` and `no branch` if the code is not expected to
+  touch those areas or branches at runtime.
+
+A helper script is provided for running tests. It simplifies coverage reporting and a few other
+things. Run the following to see all details:
+
+```bash
+uv run run_tests.py --help
+```
+
+For instance, this command will run all tests off screen (`-o`), generate a coverage XML report for
+your code editor (`-r`), and produce a terminal report with all missing lines and branches (`-l`).
+
+```bash
+uv run run_tests.py -orl
+```
+
+
+## Picking the Correct Branch for a Pull Request
+
+Pre-releases are generally made from the `main` branch, and full releases are always made from the
+`release` branch. If you are submitting a fix to a current release you must do so from the
+`release` branch. If you make such a fix on the `main` branch, **it cannot be included in a patch
+release**. This also applies to the documentation for the latest release published on the main
+website.
+
+New features are only added in full releases, so a feature pull request must be made to the `main`
+branch. However, if the `main` branch is very close to a new full release, pull requests may not be
+merged until the release is completed.
+
+This project uses GitHub milestones to plan releases, and only pull requests included in the
+current release cycle will be merged to `main`. Milestone tickets are not set in stone and are
+often moved to the next milestones.
+
+
+### Pull Request Check List
+
+Make sure the pull request follows these rules:
+
+* The `main` branch is the default branch. For general changes, please make a new branch in your
+  own fork from the current `main` branch. Do not make pull requests from your copy of the `main`
+  branch. The same applies to the `release` branch.
+* Please provide a description of the changes in the pull request under the summary section of the
+  pull request template, and reference any related issues by providing the issue number. Do not
+  post links to issue numbers as that breaks the integration. Stating the issue number on the form
+  `Closes #1234` is enough.
+* Do not change the version number. This is done during the release process.
+* Make sure the formatting and linting tools have been run locally before the pull request is made.
+
+
+## Code Style
+
+This code base uses camelCase convention for function and variable names. This differs from the
+common convention of snake_case in Python. The reason for this is that UmbraEdit is built on the
+Qt framework, where everything is camelCase.
+
+Pretty much everything else regarding formatting is handled by the linter and formatter. This
+project uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting and
+[pyright](https://github.com/microsoft/pyright) for type checking. The settings for these tools
+are defined in `pyproject.toml`, and any submitted code must pass the following three commands:
+
+```bash
+uv run ruff check
+uv run ruff format
+uv run pyright
+```
+
+### Line Length
+
+* The line length of the source code is enforced by the formatter, and is set to 120 characters.
+  Docstrings should be wrapped manually at 79 characters for better readability.
+* For text files, the text should be wrapped 120 character or less. The exception is Markdown image
+  tags and URLs which can run past that limit.
+
+
+### Internationalisation
+
+* All comments and docstrings in the code must be in English.
+* All text presented to the user must be wrapped in calls to Qt's translation framework, and the
+  spelling of this text **must** be British English. US English spelling **is not allowed** for
+  these strings. A US English translation is provided via the translation framework.
+* Commit descriptions and pull requests must also be in English.
+
+
+### License Headers and Credits
+
+All code should add the license header on the exact format as used in other files. Update the title
+as needed, and the copyright line. The year should be the year the code module was first created.
+The default is:
+
+```
+Copyright (C) <YEAR> <Original Author Name> and UmbraEdit contributors.
+```
+
+For major changes to an existing file, don't touch the year, but you can append your name. By major
+contributions is meant new code, like added new classes or larger functions, not modifications. Use
+common sense since "UmbraEdit contributors" includes most modifications and changes.
+
+```
+Copyright (C) <YEAR> <Original Author Name>, <Your Name> and UmbraEdit contributors.
+```
+
+Make sure the `CREDITS.md` and `credits_en.htm` files are updated too if appropriate.

CREDITS.md

@@ -1,70 +1,136 @@
 # Credits
 
-## Main Developer
+## Main Developer novelWriter
 
-* Veronica Berglyd Olsen (@vkbo)
+* Veronica Berglyd Olsen
+
+## Main Product Manager / Developer 
+
+* B.D. Murphy
 
 ## Contributors
 
-* Concept: Marian Lückhof (@Number042)
-* Internationalisation: Bruno Meneguello (@bkmeneguello)
-* Setup and Packaging: Rachel Powers (@Ryex)
+Larger contributions were made by:
 
-For other contributions, see the project's [Contributors](https://github.com/vkbo/novelWriter/graphs/contributors) page.
+* Early Concept: Marian Lückhof
+* Internationalisation: Bruno Meneguello
+* Setup and Packaging: Rachel Powers
+* Vim Mode: Alexis Dumelie
+* UmbraEdit Rebranding and Word DOCX/DOCM Import: B.D. Murphy
+
+For other contributions, see the project's [Contributors](https://github.com/saga-soft/UmbraEdit/graphs/contributors) page.
 
 ## Artwork
 
-The artwork on the Welcome dialog was created by [Louis Durrant](https://louisdurrant.art).
+The artwork on the Welcome dialog was generated with AI by B.D. Murphy. Reading print options through time.
+UmbraEdit icon by B.D. Murphy using AI.
 
 ## Translations
 
 The default language is English (UK) with English (US) as an option. These are the original
 translators for the languages currently available:
 
-* Dutch: Martijn van der Kleijn (@mvdkleijn)
-* French: Jan Lüdke (@jyhelle)
-* German: Myian (@heymyian)
-* Italian: Riccardo Mangili
-* Japanese: hebekeg (@hebekeg)
-* Latin American Spanish: Tommy Marplatt (@tmarplatt)
-* Norwegian: Veronica Berglyd Olsen (@vkbo)
-* Portuguese: Bruno Meneguello (@bkmeneguello)
-* Simplified Chinese: Qianzhi Long (@longqzh)
+* **Catalan:** Jaume Planas (jaumeplanas)
+* **Czech:** Tomáš Zmek (perteus)
+* **Dutch:** Martijn van der Kleijn (mvdkleijn)
+* **French:** Jan Lüdke (jyhelle)
+* **German:** Myian (HeyMyian)
+* **Italian:** Riccardo Mangili
+* **Japanese:** hebekeg
+* **Latin American Spanish:** Tommy Marplatt (tmarplatt)
+* **Norwegian:** Veronica Berglyd Olsen (vkbo)
+* **Polish:** Anna Maria Polak (Nauthiz)
+* **Portuguese:** Bruno Meneguello (bkmeneguello)
+* **Russian:** Konstantin Tan (k1kimosha)
+* **Simplified Chinese:** Qianzhi Long (longqzh)
 
 Additional larger translation contributions:
 
-* French: Albert Aribaud (@aaribaud)
+* **Dutch:** Lise Blok (risingphoenix73)
+* **French:** Albert Aribaud (aaribaud)
+* **Portuguese:** Oli Maia (olimaia)
 
-Translations are managed on [Crowdin](https://crowdin.com/project/novelwriter), and more
-contributions are listed on the project's [Members](https://crowdin.com/project/novelwriter/members) page.
+Translations of the documentation:
+
+* **French:** Jean-Michel Heras (Karduin)
+
+After the fork to UmbraEdit translations of text in the program are done via AI.
 
 ## Libraries
 
-The following libraries are dependencies of novelWriter:
+The following libraries are dependencies of UmbraEdit:
 
-* [Qt5](https://www.qt.io) by Qt Company
-* [PyQt5](https://www.riverbankcomputing.com/software/pyqt) by Riverbank Computing
-* [Enchant](https://abiword.github.io/enchant) by Dom Lachowicz
-* [PyEnchant](https://pyenchant.github.io/pyenchant) by Dimitri Merejkowsky
+* **Qt6** by Qt Company
+* **PyQt6** by Riverbank Computing
+* **Enchant** by Dom Lachowicz
+* **PyEnchant** by Dimitri Merejkowsky
 
-## Assets
+## Icon Themes
 
-Some of the assets bundled with novelWriter were adapted from the following sources:
+The default icon themes are subsets of icons from:
 
-* [Typicons](https://github.com/stephenhutchings/typicons.font) icons by Stephen Hutchings (CC BY-SA 4.0)
-* [Tomorrow](https://github.com/chriskempson/base16) syntax themes by Chris Kempson (MIT License)
-* [Owl](https://github.com/sdras/night-owl-vscode-theme) syntax themes by Sarah Drasner (MIT License)
-* [Solarized](https://github.com/altercation/solarized) themes by Ethan Schoonover (MIT License)
+* **Fluent UI** by Microsoft (MIT License)
+* **Lucide** by Cole Bemis and Lucide Contributors (ISC License)
+* **Material Symbols** by Google Inc (Apache 2.0)
+
+## Colour Themes
+
+Colour themes included with UmbraEdit were adapted from the following sources:
+
+* **Aura** themes by Dalton Menezes
+* **B2T** themes by Bram de Haan
+* **B4T** themes by Bram de Haan
+* **Catppuccin** themes by Catppuccin Org
+* **Dracula** theme by Zeno Rocha
+* **Espresso** theme by Sainnhe Park and Antoine Cotten
+* **Everforest** themes by Sainnhe Park
+* **Horizon** themes by Jonathan Olaleye
+* **New Moon** theme by Tania Rascia
+* **Noctis** themes by Liviu Schera and contributors
+* **Nord** theme by Sven Greb
+* **Owl** themes by Sarah Drasner
+* **Primer** themes by GitHub, Inc. and Myian
+* **Rosé Pine** themes by Rosé Pine
+* **Snazzy Light** theme by Florian Reuschel
+* **Solarized** themes by Ethan Schoonover
+* **Tango** themes by the Tango Desktop Project
+* **Tomorrow** themes by Chris Kempson
+
+Other themes were created for UmbraEdit:
+
+* **Aura Bright** theme by Myian
+* **Blue Streak** themes by Veronica Berglyd Olsen
+* **Castle** themes by Myian
+* **Chalky Soil** theme by Myian
+* **Chernozem** theme by Myian
+* **Cyberpunk Night** theme by Anders Lemvigh
+* **Dark Arts** theme by Myian
+* **Floral** themes by Myian
+* **Friendly** themes by Myian
+* **Full Moon** theme by Myian
+* **Jewel Case** themes by Myian
+* **LCARS** theme by Veronica Berglyd Olsen
+* **Nordlicht** theme by Myian
+* **Otium** themes by Myian
+* **Paragon** theme by Myian
+* **Ruby** themes by Myian
+* **Selenium** themes by Myian
+* **Sepia** themes by Myian
+* **Sultana** themes by Myian
+* **Today** themes by Veronica Berglyd Olsen
+* **Vivid** themes by Myian
+* **Warpgate** theme by Myian
+* **Waterlily** themes by Myian
 
 ## Fonts
 
-The font used for the main novelWriter logo, mimetype and text banners is Pridi. Other fonts are
-used on buttons and icons.
+The font used for the main UmbraEdit logo, mimetype and text banners is Pridi.
 
-* Pridi by Cadson Demak (Open Font License, Version 1.1)
-* Source Sans Pro by Paul D. Hunt (SIL Open Font License)
+* **Pridi** by Cadson Demak (Open Font License, Version 1.1)
+
+--> Caladea <--
 
 ## Special Mentions
 
-Additional thanks to @johnblommers who was an early user and who has provided a lot of very useful
+Additional thanks to John Blommers who was an early user and who has provided a lot of very useful
 feedback over the years.

MANIFEST.in

@@ -1,6 +1,28 @@
-include pkgutils.py
+include README.md
 include LICENSE.md
+include CONTRIBUTING.md
 include CREDITS.md
 include CHANGELOG.md
-recursive-include novelwriter/assets *
-recursive-include setup *
+include AI_POLICY.md
+include pyproject.toml
+include UmbraEdit.py
+include pkgutils.py
+include run_tests.py
+include build-linux.sh
+
+include setup/macos/*
+include setup/windows/*
+include setup/linux/*
+include setup/flatpak/*
+include setup/data/*
+include setup/appimage_launcher.sh
+
+include utils/*.py
+include utils/build_*.py
+
+recursive-include docs *
+recursive-include i18n *
+recursive-exclude *.pyc
+recursive-exclude __pycache__
+global-exclude .DS_Store
+global-exclude .gitkeep

README.md

@@ -1,68 +1,73 @@
-# novelWriter
+# UmbraEdit
 
-[![Linux](https://github.com/vkbo/novelWriter/actions/workflows/test_linux.yml/badge.svg?branch=main)](https://github.com/vkbo/novelWriter/actions/workflows/test_linux.yml)
-[![Windows](https://github.com/vkbo/novelWriter/actions/workflows/test_win.yml/badge.svg?branch=main)](https://github.com/vkbo/novelWriter/actions/workflows/test_win.yml)
-[![MacOS](https://github.com/vkbo/novelWriter/actions/workflows/test_mac.yml/badge.svg?branch=main)](https://github.com/vkbo/novelWriter/actions/workflows/test_mac.yml)
-[![Flake8](https://github.com/vkbo/novelWriter/workflows/flake8/badge.svg)](https://github.com/vkbo/novelWriter/actions)
-[![CodeCov](https://codecov.io/gh/vkbo/novelWriter/branch/main/graph/badge.svg)](https://codecov.io/gh/vkbo/novelWriter)
+<img align="left" style="margin: 0 0 4px 0;" src="https://git.umbratools.com/umbragit/UmbraEdit/raw/main/umbraedit/assets/icons/umbraedit.svg">
 
-<img align="left" style="margin: 0 0 4px 0;" src="https://raw.githubusercontent.com/vkbo/novelWriter/main/setup/novelwriter_readme.png">
-
-novelWriter is a plain text editor designed for writing novels assembled from many smaller text
+UmbraEdit is a plain text editor designed for writing novels assembled from many smaller text
 documents. It uses a minimal formatting syntax inspired by Markdown, and adds a meta data syntax
 for comments, synopsis, and cross-referencing. It's designed to be a simple text editor that allows
 for easy organisation of text and notes, using human readable text files as storage for robustness.
+The project format is well suited both for version control software and file synchronisation tools.
 
-The project storage is suitable for version control software, and also well suited for file
-synchronisation tools. All text is saved as plain text files with a meta data header. The core
-project structure is stored in a single project XML file. Other meta data is primarily saved as
-JSON files.
+UmbraEdit is based on novelWrite 2026.02 by Veronica Berglyd Olsen (novelWriter.io) and is
+licensed under the same GPL v3.0 license.
 
-For more details, and how to install and use novelWriter, please see the main website and
-documentation.
+B.D. Murphy is modifying the original using AI to make it part of his Umbratools publishing system.
+
+The ideas:
+
+1) Write the novel. Make it simple while writing. Formatting is later.
+2) Have the entire project together. Not the novel text here and metadata you need somewhere else. All together. 2.a) ePub, paperback (print pdf), audio all start with the same story text, but each needs something different. Put everything into one project ISBN, book blurb, search terms, genere/categories BISAC codes, cover, etc
+3) With everything together publishing is simpler
+4) The goal is to write (human written) a novel, then use AI to help with everything else. At the end of the process there will be ePub, Paperback/Hard cover, audio versions in 10 languages.
+
+For more details, and how to install and use UmbraEdit, please see the main website and documentation.
+
+This project is a fork of novelWrite. Taking the great start and extending it. I use AI to help.
 
 **Project Links**
 
-* Website: [novelwriter.io](https://novelwriter.io)
-* Documentation: [docs.novelwriter.io](https://docs.novelwriter.io)
-* Internationalisation: [crowdin.com/project/novelwriter](https://crowdin.com/project/novelwriter)
-* PyPi Project: [pypi.org/project/novelWriter](https://pypi.org/project/novelWriter)
-* Social Media: [fosstodon.org/@novelwriter](https://fosstodon.org/@novelwriter)
+* Website: [UmbraEdit](https://umbratools.com/umbraedit)
+* Documentation: [UmbraEdit Docs](https://umbratools.com/umbraedit/docs)
+
+This project is a fork of novelWrite. Taking the great start and extending it. I use AI to help._
 
 ## Implementation
 
-novelWriter is written with Python 3 (3.8+) using Qt5 and PyQt5 (5.10+), and is released on Linux,
-Windows and macOS. It can in principle run on any Operating System that also supports Qt, PyQt and
-Python.
+UmbraEdit is written in Python and uses Qt6 with PyQt6 Python binding as the UI framework. It
+runs on Linux, Windows and MacOS. It can in principle run on any Operating System that also
+supports Qt, PyQt and Python.
+
+<p align="center">
+  <img width="80%" src="https://raw.githubusercontent.com/saga-soft/UmbraEdit/main/setup/screenshot.png">
+</p>
+
 
 ## Project Contributions
 
 Please don't make feature pull requests without first having discussed them with the maintainer.
-You can make a feature request in the issue tracker, or if the idea isn't fully formed, start a
-discussion on the discussion page. Please also don't make pull requests to reformat or rewrite
-existing code unless there is a very good reason for doing so.
+You can make a feature request in the [issues tracker](https://github.com/saga-soft/UmbraEdit/issues),
+or if the idea isn't fully formed, start a [discussion](https://github.com/saga-soft/UmbraEdit/discussions).
+Please also don't make pull requests to reformat or rewrite existing code unless there is a very
+good reason for doing so. Please do not submit AI generated content.
+See our [AI Policy](https://github.com/saga-soft/UmbraEdit/blob/main/AI_POLICY.md) for details.
 
-Fixes and patches are welcome. Contributions related to packaging and installing novelWriter will
-also be appreciated, but please make an issue or a discussion topic first. Before contributing any
-code, please also read the full
-[Contributing Guide](https://github.com/vkbo/novelWriter/blob/main/CONTRIBUTING.md).
+Fixes and patches are welcome. Contributions related to packaging and installing UmbraEdit will
+also be appreciated. Before contributing any code, please read the full
+[Contributing Guide](https://github.com/saga-soft/UmbraEdit/blob/main/CONTRIBUTING.md).
 
-Project credits are available in [CREDITS.md](https://github.com/vkbo/novelWriter/blob/main/CREDITS.md).
+## Original Credits
 
-### Translations
+Project credits are available in [CREDITS.md](https://github.com/saga-soft/novelwriter/blob/main/CREDITS.md).
 
-New translations are always welcome. This project uses Crowdin to maintain translations, and you
-can contribute translations at the [Crowdin project page](https://crowdin.com/project/novelwriter).
-If you have any questions, feel free to post them to the
-[Translations of novelWriter](https://github.com/vkbo/novelWriter/issues/93) issue thread.
+**Note:** New features and most pre-releases are made on the `main` branch. Full releases are made
+from the `release` branch. So if you're submitting a fix to a current release, **including changes
+to documentation**, they must be made to the `release` branch.
 
-For more details, and how to use Qt Linguist for translations, see the
-[i18n instructions](https://github.com/vkbo/novelWriter/blob/main/i18n/README.md).
 
 ## Licence
 
-This is Open Source software, and novelWriter is licenced under GPLv3. See the
+This is Open Source software, and UmbraEdit is licensed under GPLv3. See the
 [GNU General Public License website](https://www.gnu.org/licenses/gpl-3.0.en.html) for more
-details, or consult the [License](https://github.com/vkbo/novelWriter/blob/main/LICENSE.md)
-document. Bundled assets and their licences are listed in the
-[Credits](https://github.com/vkbo/novelWriter/blob/main/CREDITS.md) document.
+details, or consult the [License](https://github.com/saga-soft/UmbraEdit/blob/main/LICENSE.md)
+document. Bundled assets and their licenses are listed in the
+[Credits](https://github.com/saga-soft/UmbraEdit/blob/main/CREDITS.md) document.

RELEASE.md

@@ -0,0 +1,157 @@
+# UmbraEdit - Release Process
+
+This document describes the release process for UmbraEdit, including versioning,
+platform support, build workflows, and publishing.
+
+## Versioning
+
+UmbraEdit uses a **YYYY/MM.P####** versioning scheme:
+
+| Component | Meaning |
+|-----------|---------|
+| `YYYY`    | Release year (e.g., 2026) |
+| `MM`      | Release month (e.g., 11) |
+| `####`    | Patch/build sequence (e.g., 0001) |
+
+Examples:
+- `2026.11`     - Major monthly release (November 2026)
+- `2026.11.0001` - First development build of November 2026
+- `2026.11.0002` - Second development build (e.g., new feature)
+
+Git tags follow the format: `v2026.11`, `v2026.11.0001`, etc.
+
+## Supported Platforms
+
+| Platform | Architecture | Package Format | Build Host |
+|----------|-------------|----------------|------------|
+| Linux    | amd64       | .deb, .rpm, AppImage | Linux |
+| Linux    | arm64       | .deb, .rpm, AppImage | Linux (ARM64) |
+| macOS    | arm64       | .dmg, .app | macOS (Apple Silicon) |
+| macOS    | amd64       | .dmg, .app | macOS (Intel) |
+| Windows  | amd64       | .msi, .exe | Windows |
+| Windows  | arm64       | .msi, .exe | Windows (ARM64) |
+| iOS/iPadOS | arm64     | **NOT SUPPORTED** | N/A |
+
+### iOS/iPadOS Support
+
+UmbraEdit is **not available for iOS/iPadOS**. PyQt6 does not support iOS,
+and UmbraEdit requires a full desktop Qt environment with keyboard, mouse,
+and file system access. Porting to iOS would require a complete rewrite
+using SwiftUI or a different cross-platform framework.
+
+Users on iPad should use UmbraEdit via a VNC/remote desktop connection to a
+desktop machine running UmbraEdit, or use a compatible web-based alternative.
+
+## Release Workflow
+
+### 1. Prepare Release
+
+```bash
+# Ensure working tree is clean
+git status
+
+# Update version in umbraedit/__init__.py
+# __version__ = "2026.12.0001"
+
+# Update CHANGELOG.md with new release entry
+
+# Commit and tag
+git add -A
+git commit -m "release: prepare v2026.12"
+git tag -a v2026.12 -m "Release v2026.12"
+git push origin main --tags
+```
+
+### 2. Build All Platforms
+
+On each target platform, run:
+
+```bash
+# Clone the tagged release
+git clone https://git.umbratools.com/umbragit/UmbraEdit.git
+cd UmbraEdit
+git checkout v2026.12
+
+# Build all packages for this platform
+python utils/build_all.py --platform <platform> --arch <arch>
+```
+
+Available platforms: `linux`, `macos`, `windows`
+Available architectures: `amd64`, `arm64`
+
+### 3. Publish
+
+Upload all build artifacts to the release server:
+
+```bash
+# Example: upload to Gitea releases
+# Files to upload:
+#   Linux:   dist_deb/umbraedit_*.deb, dist_appimage/*.AppImage
+#   macOS:   dist_macos/umbraedit-*.dmg
+#   Windows: dist_win/umbraedit-*.exe, dist_win/umbraedit-*.msi
+#   Source:  dist/umbraedit-*.tar.gz, dist/umbraedit-*.whl
+```
+
+Create a release on Gitea/GitHub and attach all artifacts.
+
+## Build Artifacts
+
+Each platform produces the following artifacts:
+
+### Linux (.deb + AppImage)
+
+| File | Location | Description |
+|------|----------|-------------|
+| `umbraedit_<version>_amd64.deb` | `dist_deb/` | Debian package |
+| `umbraedit-<version>-amd64.AppImage` | `dist_appimage/` | Portable AppImage |
+
+### macOS (.dmg + .app)
+
+| File | Location | Description |
+|------|----------|-------------|
+| `umbraedit-<version>-arm64.dmg` | `dist_macos/` | macOS disk image |
+| `UmbraEdit.app` | inside .dmg | macOS application bundle |
+
+### Windows (.exe + .msi)
+
+| File | Location | Description |
+|------|----------|-------------|
+| `umbraedit-<version>-amd64.exe` | `dist_win/` | Windows installer |
+| `umbraedit-<version>-amd64.msi` | `dist_win/` | Windows MSI installer |
+
+### Source
+
+| File | Location | Description |
+|------|----------|-------------|
+| `umbraedit-<version>.tar.gz` | `dist/` | Source tarball |
+| `umbraedit-<version>-py3-none-any.whl` | `dist/` | Pure Python wheel |
+
+## Build Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `utils/build_all.py` | Unified build orchestrator for all platforms |
+| `utils/build_debian.py` | Debian/Ubuntu .deb package builder |
+| `utils/build_appimage.py` | AppImage builder |
+| `utils/build_windows.py` | Windows installer builder |
+| `setup/macos/build.sh` | macOS .dmg builder |
+
+## Release Checklist
+
+- [ ] Update version in `umbraedit/__init__.py`
+- [ ] Update `CHANGELOG.md` with release notes
+- [ ] Tag release: `git tag -a vYYYY.MM -m "Release vYYYY.MM"`
+- [ ] Push tag: `git push origin vYYYY.MM`
+- [ ] Build packages for all platforms
+- [ ] Test installation on each platform
+- [ ] Create release on Gitea/GitHub
+- [ ] Attach all build artifacts
+- [ ] Publish release notes
+- [ ] Announce release
+
+## Credits
+
+UmbraEdit is based on novelWrite 2026.02 by Veronica Berglyd Olsen
+(novelWriter.io), licenced under the same GPL v3.0 license.
+
+Current development lead: B.D. Murphy

UMBRAEDIT.md

@@ -0,0 +1,213 @@
+# UmbraEdit — Project Scan & Structure
+
+Copyright (C) 2026 B.D. Murphy and novelWriter contributors.
+Documentation for the UmbraEdit project (renamed from novelWriter).
+
+This document is a structural scan of the **UmbraEdit** codebase. It is intended for developers who want to modify or extend the project.
+
+> UmbraEdit was created by cloning **novelWriter** (vkbo/saga-soft) into this folder and renaming the project to `UmbraEdit`. The full upstream git history is preserved (see §6).
+
+---
+
+## 1. Overview
+
+| Property | Value |
+|---|---|
+| **Project name** | UmbraEdit |
+| **Origin** | Renamed/rebased from [novelWriter](https://github.com/vkbo/novelWriter) (vkbo / saga-soft) |
+| **Inherited version** | 26.3b1 (novelWriter v26 series; see `umbraedit/__init__.py`) |
+| **Base version** | Based on novelWrite 2026.02 by Veronica Berglyd Olsen (novelWriter.io), GPL v3.0 |
+| **Language** | Python 3.11+ |
+| **UI framework** | Qt6 via PyQt6 |
+| **Platforms** | Linux, Windows, macOS |
+| **Storage model** | Plain-text project files (one document per scene + a project XML), well suited to Git and file-sync tools |
+| **Formatting** | Minimal Markdown-like syntax plus a metadata syntax for comments, synopsis, and cross-references |
+| **License** | `GPL-3.0-or-later AND Apache-2.0 AND ISC AND MIT` (see `pyproject.toml`, `LICENSE.md`) |
+| **Entry point** | `UmbraEdit.py` → `umbraedit:main()` |
+
+**Core idea:** a novel is built from many small plain-text documents organised in a binder/tree, with a composing editor and a compile/export step (DOCX, EPUB, HTML, ODT, Markdown, raw text, QDoc).
+
+---
+
+## 2. Repository layout (top level)
+
+```
+UmbraEdit/                          <- this folder (was novelWriter2)
+├── UmbraEdit.py                    <- application start script (imports umbraedit, calls main)
+├── pyproject.toml                  <- project metadata, dependencies, ruff/pytest config
+├── uv.lock                         <- dependency lockfile (regenerate if deps change)
+├── run_tests.py                    <- pytest runner wrapper
+├── pkgutils.py                     <- packaging / i18n utility script
+├── README.md                       <- user-facing project page (mechanically renamed to UmbraEdit)
+├── LICENSE.md
+├── CHANGELOG.md                    <- historical novelWriter changelog (retains original attribution)
+├── CONTRIBUTING.md
+├── CREDITS.md
+├── AI_POLICY.md
+├── .gitignore
+├── .env.example
+├── docs/                           <- Sphinx documentation source
+├── i18n/                           <- Qt translation sources (ue_XX.ts) — compiled .qm are gitignored
+├── sample/                         <- sample novel project (.nwx + content)
+├── setup/                          <- packaging: deb, windows, flatpak, macOS, appimage, icons
+├── tests/                          <- pytest suite (core, editor, gui, manuscript, models, story, text, tools, …)
+├── umbraedit/                      <- main Python package (was novelwriter/)
+└── utils/                          <- build scripts (appimage, debian, flatpak, pypi, windows, assets, docs)
+```
+
+**Note:** `AGENTS.md` is gitignored by this project (`.gitignore` line 68). This scan lives in `UMBRAEDIT.md` instead.
+
+---
+
+## 3. Package layout — `umbraedit/`
+
+| Module / package | Responsibility |
+|---|---|
+| `__init__.py` | Application bootstrap, `__version__`, `main()` entry |
+| `config.py` | Runtime configuration, paths, locale/i18n loading (`_ueLangPath`) |
+| `constants.py` | Application-wide constants |
+| `shared.py` | Shared data / singleton state |
+| `enum.py`, `types.py`, `error.py` | Enums, shared types, error handling |
+| `splash.py` | Splash screen |
+| `guimain.py` | Main window / GUI assembly |
+| `core/` | Project model: project, projectdata, projectxml, tree, item, document, storage, sessions, index, indexdata, projectsearch, spellcheck, status, options, coretools |
+| `editor/` | The composing editor: editor, editordocument, highlighter, history, hovercard, header/footer, toolbars, viewer, search, completion, vim mode |
+| `gui/` | Widgets/views: main menu, novel tree, project tree, sidebar, status bar, item details, search, theme |
+| `manuscript/` | Compile/export: manuscript build, document build, settings |
+| `models/` | Qt item models: item, novel, outline, search |
+| `story/` | Outline/story view, story settings |
+| `text/` | Text processing: counting, patterns, formats, autoreplace |
+| `tools/` | Dictionaries, lorem ipsum, welcome, writing stats |
+| `formats/` | Import/export filters: to/from DOCX, EPUB, HTML, ODT, Markdown, QDoc, raw text, TOML, QDoc |
+| `dialogs/` | Preferences, project settings, about, split/merge, labels, links, quotes, word list |
+| `extensions/` | Custom widgets: tab widget, switch, progress bars, event filters, etc. |
+| `assets/` | Icons, images, themes (`.toml`), i18n project JSON, manual, credits |
+
+---
+
+## 4. How to build and run
+
+### Requirements
+- Python ≥ 3.11 (system Python 3.9.6 is **too old** — `match`/`case` syntax requires 3.10+)
+- `pyqt6>=6.4`, `pyenchant>=3.3.0`
+- macOS only: `pyobjc-framework-Cocoa`
+
+### Run the application
+```bash
+cd /Volumes/1TB_APL_Storage/UmbraEdit
+python3 UmbraEdit.py
+# or, with the package on PYTHONPATH:
+python3 -c "import umbraedit; umbraedit.main()"
+```
+
+### Syntax check (Python 3.11+)
+```bash
+/Volumes/Dock/worstauthor/.local/bin/python3.11 -m py_compile umbraedit/*.py umbraedit/**/*.py
+```
+
+### Tests
+```bash
+python3 run_tests.py                 # full pytest suite
+python3 run_tests.py -m core         # run a test marker group
+```
+Test configuration lives in `pyproject.toml` (`[tool.pytest.ini_options]`, testpaths=`tests`).
+
+### Linting
+The project uses **ruff** (see `[tool.ruff]` in `pyproject.toml`) and **pyright**.
+
+### Packaging
+See `setup/` and `utils/`:
+- `utils/build_debian.py`, `build_windows.py`, `build_flatpak.py`, `build_appimage.py`, `build_pypi.py`
+- `setup/windows/`, `setup/macos/`, `setup/debian/`, `setup/flatpak/`
+
+---
+
+## 5. i18n (translations)
+
+- Translation sources: `i18n/ue_XX.ts` (renamed from `nw_XX.ts`)
+- Compiled `.qm` files are **gitignored** (`i18n/*.qm`, `/umbraedit/assets/i18n/*.qm`) and generated at build time
+- `umbraedit/config.py` loads `ue_<locale>.qm` from `_ueLangPath` (`umbraedit/assets/i18n`)
+- Add a new language: create `i18n/ue_XX.ts` and regenerate the `.qm` with Qt Linguist / `lrelease`
+
+---
+
+## 6. Git system & Gitea publishing
+
+### Current remote state
+```
+upstream   https://github.com/vkbo/novelWriter.git   (original novelWriter, preserved as reference)
+```
+There is **no `origin`** yet.
+
+### What was done in this session
+1. Cloned `https://github.com/vkbo/novelWriter.git` into this folder (`novelWriter2`).
+2. Renamed the project `novelWriter` → `UmbraEdit` (package `novelwriter` → `umbraedit`, entry `novelWriter.py` → `UmbraEdit.py`, i18n `nw_*.ts` → `ue_*.ts`, packaging files, all imports/docs/tests/workflows).
+3. Committed the rename:
+   - `70d74e675 chore: rename project from novelWriter to UmbraEdit` (474 files, all renames detected by git)
+4. Archived the previous UmbraEdit (Rust/Tauri, pre-implementation spec project) preserving its git history:
+   - `/Volumes/1TB_APL_Storage/Archive/UmbraEdit_archived_20261105/`
+5. Working tree is clean; branch is `main`.
+
+### To publish as UmbraEdit on your Gitea server
+A Gitea credential is **not** configured in this environment, and the Gitea server URL is not known yet, so `origin` was intentionally left unset. When ready:
+
+```bash
+# 1. Create the "UmbraEdit" repository on your Gitea server first
+# 2. Add it as origin
+git remote add origin <GITEA_URL>/UmbraEdit.git
+
+# 3. Push
+git push -u origin main
+
+# 4. (Optional) keep pulling upstream novelWriter improvements
+git fetch upstream
+git merge upstream/main   # or cherry-pick as desired
+```
+
+### Project URLs to update
+`README.md` and `pyproject.toml` currently carry mechanically-renamed GitHub URLs
+(`https://github.com/saga-soft/UmbraEdit`, etc.). Before publishing, replace these
+with your Gitee instance URLs, e.g.:
+- Repository → `https://<gitea>/<owner>/UmbraEdit`
+- Issues → `https://<gitea>/<owner>/UmbraEdit/issues`
+- Homepage / Documentation → your UmbraEdit docs site
+
+---
+
+## 7. Extension guidance (adding features)
+
+The codebase is organised by concern, which makes it straightforward to extend:
+
+| To add… | Touch… |
+|---|---|
+| New editor feature / syntax highlighting | `umbraedit/editor/` (editor, highlighter, history) |
+| New project-tree / binder operation | `umbraedit/core/` (tree, project, projectdata, projectxml) |
+| New import/export format | `umbraedit/formats/` (add a `toXxx` / `fromXxx` module) |
+| New settings / preferences UI | `umbraedit/dialogs/preferences.py`, `umbraedit/config.py` |
+| New view / dock panel | `umbraedit/gui/`, `umbraedit/guimain.py` |
+| New data model / Qt model | `umbraedit/models/`, `umbraedit/core/item.py` |
+| New compile/export target | `umbraedit/manuscript/` + a format module |
+| New theme | `umbraedit/assets/themes/*.toml` |
+| New translation | `i18n/ue_XX.ts` (§5) |
+
+### Recommended workflow for new features
+1. Create a feature branch off `main`: `git checkout -b feature/<name>`
+2. Implement + add tests under `tests/` mirroring the source layout
+3. Run `python3 run_tests.py` and `ruff` lint
+4. Commit on the feature branch, then merge to `main`
+5. Never let a week of work sit uncommitted (per project convention)
+
+---
+
+## 8. Files intentionally left as-is
+
+| File | Reason |
+|---|---|
+| `uv.lock` | Dependency lockfile; still references `novelwriter` — regenerate (`uv lock`) if dependencies change |
+| `setup/windows/novelWriter.exe` | Binary executable |
+| `umbraedit/assets/images/welcome.webp` | Binary image (may still render "novelWriter" text) |
+| `CHANGELOG.md`, `CREDITS.md` | Historical records retaining original novelWriter attribution |
+
+---
+
+*Generated as part of the UmbraEdit project setup. Scan date: 2026-11-05.*

UMBRAEDIT_UPDATE_PLAN.md

@@ -0,0 +1,245 @@
+# UmbraEdit — Toolchain & Dependency Update Plan
+
+Copyright (C) 2026 B.D. Murphy and novelWriter contributors.
+Plan for upgrading UmbraEdit (Python/PyQt6) toolchain and dependencies.
+
+**Goal:** Bring UmbraEdit (Python/PyQt6) up to the latest stable versions of its tools and dependencies, starting from the current baseline.
+
+**Baseline (as of 2026-11-05):**
+- System Python: 3.9.6 (`/usr/bin/python3`) — **below** the project's `requires-python >=3.11`
+- Available runtimes: Python 3.11.15, 3.12.13 (via `uv` in `~/.local/bin`)
+- `uv`: 0.11.7 (2026-04-15) — outdated
+- PyQt6: not yet installed in the 3.11 environment
+- `pyproject.toml` deps: `pyqt6>=6.4`, `pyenchant>=3.3.0`, `pyobjc-framework-Cocoa` (darwin)
+- Lockfile: `uv.lock` (references `novelwriter` package name — will need regen)
+
+---
+
+## 1. Target Versions
+
+| Tool | Current | Target | Source |
+|---|---|---|---|
+| Python runtime | 3.9.6 (system) | 3.12.x (latest 3.12) or 3.13.x | `uv` / python.org |
+| PyQt6 | not installed | latest 6.x | PyPI |
+| pyenchant | >=3.3.0 | latest 3.x | PyPI |
+| pyobjc-framework-Cocoa | pinned by pyproject | latest (macOS only) | PyPI |
+| uv | 0.11.7 | latest | github.com/astral-sh/uv |
+| ruff | (in `uv.lock`) | latest | PyPI |
+| pyright | (in `uv.lock`) | latest | npm/PyPI |
+| pytest | (in `uv.lock`) | latest 8.x | PyPI |
+| pytest-qt | (in `uv.lock`) | latest | PyPI |
+| coverage | (in `uv.lock`) | latest | PyPI |
+| Sphinx + theme | (in `uv.lock`) | latest | PyPI |
+| setuptools | 82.0.1 | latest | PyPI |
+| pip | 26.0.1 | latest | ensure via `uv` |
+
+> Prefer Python **3.12** as the primary target (mature, PyQt6 wheels widely available). Keep **3.11** as a secondary CI matrix entry since `requires-python` is `>=3.11`.
+
+---
+
+## 2. Phased Execution
+
+### Phase 0 — Preparation & Safety
+1. Ensure working tree is clean and all changes committed on `main` (already done).
+2. Tag the current state as a rollback point:
+   ```bash
+   git tag umbraedit/pre-toolchain-update
+   git push origin umbraedit/pre-toolchain-update
+   ```
+3. Record current working commands (`python3 UmbraEdit.py`, test runner) so you can compare before/after.
+4. Back up `uv.lock` and `pyproject.toml`.
+
+### Phase 1 — Upgrade `uv` and Python runtimes
+1. Upgrade `uv` itself:
+   ```bash
+   uv self upgrade
+   # or: curl -LsSf https://astral.sh/uv/install.sh | sh
+   ```
+2. Install the target Python(s) via `uv` (so they are isolated and reproducible):
+   ```bash
+   uv python install 3.12
+   uv python install 3.11   # keep for CI matrix
+   uv python list
+   uv python pin 3.12        # sets default for this project (writes .python-version)
+   ```
+3. Verify:
+   ```bash
+   uv run python --version   # should report 3.12.x
+   ```
+
+### Phase 2 — Upgrade core runtime dependencies
+Create a fresh virtual environment with the target Python and install the project's runtime deps at their latest compatible versions:
+
+```bash
+cd /Volumes/1TB_APL_Storage/UmbraEdit
+uv venv --python 3.12
+uv pip install "pyqt6>=6.4" "pyenchant>=3.3.0"
+# macOS only:
+uv pip install "pyobjc-framework-Cocoa"
+```
+
+Then:
+1. Run the app to confirm it starts:
+   ```bash
+   uv run python UmbraEdit.py
+   # or, after venv activation:
+   python UmbraEdit.py
+   ```
+2. If `pyqt6` wheels fail on the target Python, fall back to 3.11 or file an issue.
+
+### Phase 3 — Upgrade build / lint / test tooling
+Update the dependency groups in `pyproject.toml` (`build`, `docs`, `test`, `lint`) to latest, then sync:
+
+```toml
+[dependency-groups]
+dev = [
+    { include-group = "build" },
+    { include-group = "docs" },
+    { include-group = "test" },
+    { include-group = "lint" },
+]
+build = ["pyyaml", "tzdata; sys_platform == 'win32'"]
+docs = [
+    "docutils>=0.17.1",
+    "pygments>=2.7",
+    "sphinx-book-theme",
+    "sphinx-copybutton",
+    "sphinx-design",
+    "sphinx-favicon",
+    "sphinx-intl",
+    "sphinx>=5.0",
+]
+test = [
+    "coverage>=7.16.0",
+    "pytest-qt",
+    "pytest-timeout",
+    "pytest>=6.0.0",
+    "tzdata; sys_platform == 'win32'",
+]
+lint = ["pyright", "ruff"]
+```
+
+Suggested edits:
+- Bump `pytest>=6.0.0` → `pytest>=8.0` (check PyPI for latest 8.x)
+- Bump `coverage>=7.16.0` → latest
+- Bump `sphinx>=5.0` → latest 7.x/8.x
+- Keep `ruff` and `pyright` unpinned or with generous lower bounds so `uv lock` resolves latest
+
+Then sync:
+```bash
+uv lock --upgrade       # resolve all groups to latest
+uv sync --all-groups    # create .venv with everything
+```
+
+### Phase 4 — Regenerate `uv.lock`
+`uv.lock` currently references the old `novelwriter` package name and is stale.
+```bash
+uv lock --upgrade
+git diff uv.lock   # review before committing
+```
+Commit the regenerated lockfile with the toolchain update.
+
+### Phase 5 — Update `requires-python` and classifiers (optional)
+If you want to drop 3.11 and standardize on 3.12+:
+```toml
+requires-python = ">=3.12"
+```
+And update classifiers accordingly. Otherwise keep `>=3.11` and test both 3.11 and 3.12 in CI.
+
+### Phase 6 — Update Gitea CI workflows
+The `.github/workflows/*.yml` files reference Python setup steps. Update them to:
+- Use `actions/setup-python` with `python-version: ["3.11", "3.12"]` (or your Gitea Actions equivalent)
+- Install via `uv sync --all-groups` instead of `pip install -e .`
+- Run `uv run ruff check`, `uv run pyright`, `uv run pytest`
+
+If your Gitea instance uses Gitea Actions, mirror the same matrix. If not, update the workflows to call `uv` explicitly.
+
+### Phase 7 — Packaging scripts review
+The `utils/` build scripts (`build_appimage.py`, `build_debian.py`, `build_flatpak.py`, `build_pypi.py`, `build_windows.py`) and `setup/` packaging may pin Python/Qt versions. Check each for:
+- Hardcoded `python3` → should target the new runtime
+- `qt_version = "6.11"` in `[tool.novelwriter.build] flatpak` → verify against latest Qt6
+- `pyqt6>=6.4` lower bound → keep or raise
+
+### Phase 8 — Validation
+1. **Syntax/compile:** `uv run python -m py_compile umbraedit/ tests/ utils/`
+2. **Import smoke:** `uv run python -c "import umbraedit; umbraedit.main(['--help'])"`
+3. **Lint:** `uv run ruff check .` and `uv run pyright`
+4. **Tests:** `uv run pytest` (or `uv run python run_tests.py`)
+5. **App launch:** `uv run python UmbraEdit.py` — confirm main window opens
+6. **Export formats:** exercise DOCX/EPUB/HTML/ODT export paths if sample data exists
+
+### Phase 9 — Commit & publish
+```bash
+git add -A
+git commit -m "chore: upgrade toolchain to Python 3.12 and latest deps
+
+- Upgrade uv and pin Python 3.12 via .python-version
+- Refresh pyproject.toml dependency groups to latest compatible versions
+- Regenerate uv.lock
+- Update Gitea CI workflows for uv + Python 3.11/3.12 matrix
+- Review packaging scripts for hardcoded python/qt versions"
+git push origin main
+```
+
+---
+
+## 3. Rollback Plan
+
+If anything breaks after the update:
+
+```bash
+# Restore previous state
+git checkout umbraedit/pre-toolchain-update .
+# or reset hard to the tag
+git reset --hard umbraedit/pre-toolchain-update
+git push origin main --force   # only if already pushed and you need to undo
+```
+
+Also keep the old system Python 3.9.6 available (do not remove `/usr/bin/python3`), and keep the `upstream` remote pointing at the original novelWriter for reference.
+
+---
+
+## 4. Recommended Command Sequence (copy-paste ready)
+
+```bash
+cd /Volumes/1TB_APL_Storage/UmbraEdit
+
+# 0. Tag rollback point
+git tag umbraedit/pre-toolchain-update
+git push origin umbraedit/pre-toolchain-update
+
+# 1. Upgrade uv and pin Python 3.12
+uv self upgrade
+uv python install 3.12
+uv python pin 3.12
+uv run python --version
+
+# 2. Create venv and install runtime deps at latest
+uv venv --python 3.12
+uv pip install "pyqt6>=6.4" "pyenchant>=3.3.0"
+
+# 3. Smoke-test the app
+uv run python UmbraEdit.py
+
+# 4. Sync dev toolchains (lint/test/docs)
+uv sync --all-groups
+
+# 5. Regenerate lockfile
+uv lock --upgrade
+git diff uv.lock | head -100
+
+# 6. Validate
+uv run python -m py_compile umbraedit/ tests/ utils/
+uv run ruff check .
+uv run pytest
+```
+
+---
+
+## 5. Notes & Risks
+
+- **PyQt6 on Python 3.13:** Wheels may lag; if 3.13 is required, verify PyQt6 availability first. 3.12 is the safer target.
+- **`pyobjc-framework-Cocoa`:** macOS-only; only install/test on darwin.
+- **`uv.lock` diff:** Expect a large diff since the lockfile is stale; review that no unexpected major-version jumps occur (especially PyQt6 6.x → 7.x, which would be breaking).
+- **CI:** Gitea Actions runners must have `uv` installed, or the workflows must install it as a step.
+- **Application still runs on Python 3.9.6?** No — `match`/`case` syntax requires 3.10+, and `requires-python` is `>=3.11`. The system 3.9.6 must not be used to run UmbraEdit.

UmbraEdit.command

@@ -0,0 +1,12 @@
+#!/bin/zsh
+# UmbraEdit Launcher for macOS
+# Double-click to launch, or run: ./UmbraEdit.command
+#
+# Copyright (C) 2026 B.D. Murphy and novelWriter contributors.
+# Created: macOS launcher script for UmbraEdit (renamed from novelWriter).
+
+cd "$(dirname "$0")"
+
+# Use the project's uv-managed Python 3.12 virtual environment
+export UV_PYTHON_PREFERENCE="only-managed"
+exec uv run python UmbraEdit.py "$@"

UmbraEdit.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+"""
+UmbraEdit - Start Script
+==========================
+"""  # noqa
+
+import os
+import sys
+
+os.curdir = os.path.abspath(os.path.dirname(__file__))
+
+if __name__ == "__main__":
+    import umbraedit
+
+    umbraedit.main(sys.argv[1:])

build-linux.sh

@@ -0,0 +1,221 @@
+#!/usr/bin/env bash
+#=============================================================================
+# UmbraEdit Linux Build Script
+# ============================================================================
+# Downloads the UmbraEdit source tarball and builds a .deb package and/or
+# AppImage for Linux AMD64/ARM64.
+#
+# Usage:
+#   chmod +x build-linux.sh
+#   ./build-linux.sh [--arch amd64|arm64] [--distro ubuntu|debian] [--no-deb]
+#
+# No git clone required. Downloads the source tarball automatically.
+#=============================================================================
+
+set -euo pipefail
+
+#-----------------------------------------------------------------------------
+# Configuration
+#-----------------------------------------------------------------------------
+VERSION="2026.11.5"
+RELEASE_VERSION="2026.11.0007"
+GITEA_URL="http://192.168.123.18:2222/umbragit/UmbraEdit"
+TARBALL_URL="${GITEA_URL}/-/archive/v${RELEASE_VERSION}/umbraedit-${RELEASE_VERSION}.tar.gz"
+TARBALL="umbraedit-${RELEASE_VERSION}.tar.gz"
+EXTRACTED_DIR="umbraedit-${RELEASE_VERSION}"
+
+ARCH="${1:-amd64}"
+DISTRO="${2:-ubuntu}"
+BUILD_DEB="${3:-yes}"
+
+echo "============================================================"
+echo "  UmbraEdit Linux Build Script"
+echo "============================================================"
+echo ""
+echo "  Version:    ${RELEASE_VERSION}"
+echo "  Architecture: ${ARCH}"
+echo "  Distro:     ${DISTRO}"
+echo "  Build .deb: ${BUILD_DEB}"
+echo ""
+
+#--------------------------------------------------------------
+# Step 1: Check prerequisites
+#--------------------------------------------------------------
+echo "[1/5] Checking prerequisites..."
+
+MISSING=0
+for cmd in curl tar python3; do
+    if ! command -v "$cmd" &> /dev/null; then
+        echo "  MISSING: $cmd"
+        MISSING=1
+    fi
+done
+
+if command -v apt-get &> /dev/null; then
+    PKG_MGR="apt-get"
+elif command -v dnf &> /dev/null; then
+    PKG_MGR="dnf"
+elif command -v pacman &> /dev/null; then
+    PKG_MGR="pacman"
+else
+    PKG_MGR=""
+fi
+
+if [ "$PKG_MGR" = "" ]; then
+    echo ""
+    echo "ERROR: No supported package manager found (apt-get, dnf, or pacman)"
+    echo "Please install: python3, python3-pip, python3-pyqt6, python3-enchant,"
+    echo "                dh-python, debhelper, python3-build, appimagetool"
+    exit 1
+fi
+
+echo "  Package manager: $PKG_MGR"
+echo "  Prerequisites OK"
+
+#--------------------------------------------------------------
+# Step 2: Install system dependencies
+#--------------------------------------------------------------
+echo ""
+echo "[2/5] Installing system dependencies..."
+
+INSTALL_FAILED=0
+
+if [ "$PKG_MGR" = "apt-get" ]; then
+    echo "  Updating package lists..."
+    if ! sudo apt-get update 2>&1 | tail -5; then
+        echo ""
+        echo "============================================================"
+        echo "  ERROR: apt-get update failed!"
+        echo "============================================================"
+        echo ""
+        echo "  One of your package repositories is broken (likely a PPA or"
+        echo "  third-party repo like NVIDIA's)."
+        echo ""
+        echo "  To fix:"
+        echo "    1. Check /etc/apt/sources.list and /etc/apt/sources.list.d/"
+        echo "    2. Remove or disable any repositories that no longer exist"
+        echo "    3. Run: sudo apt-get update"
+        echo "    4. Then re-run this script: ./build-linux.sh"
+        echo ""
+        exit 1
+    fi
+fi
+
+echo ""
+echo "Installing packages..."
+install_pkg() {
+    if [ "$PKG_MGR" = "apt-get" ]; then
+        sudo apt-get install -y "$@" 2>&1 | tail -3
+    elif [ "$PKG_MGR" = "dnf" ]; then
+        sudo dnf install -y "$@" 2>&1 | tail -3
+    elif [ "$PKG_MGR" = "pacman" ]; then
+        sudo pacman -Sy --noconfirm "$@" 2>&1 | tail -3
+    fi
+}
+
+echo "  Installing: python3 python3-pip python3-pyqt6 python3-enchant"
+install_pkg python3 python3-pip python3-pyqt6 python3-enchant 2>&1 | tail -3 || {
+    echo ""
+    echo "============================================================"
+    echo "  ERROR: Failed to install core dependencies"
+    echo "============================================================"
+    echo ""
+    echo "  Please install manually and re-run:"
+    echo "    sudo apt-get install python3 python3-pip python3-pyqt6 python3-enchant"
+    echo ""
+    exit 1
+}
+
+echo ""
+echo "  Installing: dh-python debhelper python3-build appimagetool"
+install_pkg dh-python debhelper python3-build appimagetool 2>&1 | tail -3 || {
+    echo ""
+    echo "============================================================"
+    echo "  WARNING: Some build tools failed to install"
+    echo "============================================================"
+    echo ""
+    echo "  You may need to install these manually:"
+    echo "    sudo apt-get install dh-python debhelper python3-build appimagetool"
+    echo ""
+    echo "  Continuing anyway..."
+}
+
+echo "  System dependencies installed"
+
+#--------------------------------------------------------------
+# Step 3: Download source tarball
+#--------------------------------------------------------------
+echo ""
+echo "[3/5] Downloading source tarball..."
+echo "  URL: ${TARBALL_URL}"
+
+if [ -f "$TARBALL" ]; then
+    echo "  Archive already exists, skipping download"
+else
+    curl -L -o "$TARBALL" "$TARBALL_URL"
+    echo "  Downloaded: $(ls -lh "$TARBALL" | awk '{print $5}')"
+fi
+
+#--------------------------------------------------------------
+# Step 4: Extract source
+#--------------------------------------------------------------
+echo ""
+echo "[4/5] Extracting source..."
+
+rm -rf "$EXTRACTED_DIR"
+tar xzf "$TARBALL"
+cd "$EXTRACTED_DIR"
+
+echo "  Extracted to: $(pwd)"
+
+#--------------------------------------------------------------
+# Step 5: Install Python dependencies
+#--------------------------------------------------------------
+echo ""
+echo "[5/5] Installing Python dependencies..."
+
+python3 -m pip install --user --upgrade pip setuptools wheel 2>&1 | tail -1
+python3 -m pip install --user pyqt6 pyenchant 2>&1 | tail -1
+
+echo "  Python dependencies installed"
+
+#--------------------------------------------------------------
+# Step 6: Build packages
+#--------------------------------------------------------------
+echo ""
+echo "[6/6] Building packages..."
+
+# Build .deb (Debian/Ubuntu only)
+if [ "$BUILD_DEB" = "yes" ] && [ "$PKG_MGR" = "apt-get" ]; then
+    echo ""
+    echo "Building .deb package..."
+    python3 utils/build_debian.py --distro "$DISTRO" --build 1
+    echo ""
+    echo "  .deb package: dist_deb/umbraedit_*_${ARCH}.deb"
+fi
+
+# Build AppImage
+echo ""
+echo "Building AppImage..."
+python3 utils/build_appimage.py --linux manylinux_2_28 --arch "$ARCH" --python 3.12
+echo ""
+echo "  AppImage: dist_appimage/umbraedit-${RELEASE_VERSION}-${ARCH}.AppImage"
+
+#--------------------------------------------------------------
+# Done
+#--------------------------------------------------------------
+echo ""
+echo "============================================================"
+echo "  Build Complete!"
+echo "============================================================"
+echo ""
+echo "Artifacts:"
+ls -la dist_deb/ 2>/dev/null || true
+ls -la dist_appimage/ 2>/dev/null || true
+echo ""
+echo "To run UmbraEdit:"
+echo "  From AppImage:  chmod +x dist_appimage/umbraedit-${RELEASE_VERSION}-${ARCH}.AppImage"
+echo "                  ./dist_appimage/umbraedit-${RELEASE_VERSION}-${ARCH}.AppImage"
+echo "  From .deb:      sudo dpkg -i dist_deb/umbraedit_*_${ARCH}.deb && umbraedit"
+echo ""
+echo "Source directory: $(pwd)"

codecov.yml

@@ -1,22 +0,0 @@
-codecov:
-  require_ci_to_pass: yes
-
-coverage:
-  precision: 2
-  round: nearest
-  range: "70...95"
-
-  status:
-    project:
-      default:
-        threshold: 1%
-    patch: no
-    changes: no
-
-parsers:
-  gcov:
-    branch_detection:
-      conditional: yes
-      loop: yes
-      method: no
-      macro: no

docs/source/conf.py

@@ -1,31 +1,35 @@
 """
 Configuration file for the Sphinx documentation builder.
 Documentation: http://www.sphinx-doc.org/en/master/config
-"""
+"""  # noqa
 
 # -- Imports -----------------------------------------------------------------
 
+import datetime
 import os
 import time
-import datetime
 
 # -- Project Information -----------------------------------------------------
 
-project = "novelWriter"
-copyright = f"{datetime.date.today().year}"
-author = "Veronica Berglyd Olsen"
+project = "UmbraEdit"
+copyright = f"{datetime.date.today().year}"  # noqa: A001
 
-initFile = os.path.join(
-    os.path.dirname(__file__), os.pardir, os.pardir,
-    "novelwriter", "__init__.py"
-)
-with open(initFile) as inFile:
-    for aLine in inFile:
-        if aLine.startswith("__version__"):
-            release = aLine.split('"')[1].strip()
-            break
-    else:
-        release = "unknown"
+if override_authors := os.environ.get("SPHINX_I18N_AUTHORS"):
+    author = override_authors
+else:
+    author = "Veronica Berglyd Olsen"
+
+if override_version := os.environ.get("SPHINX_I18N_VERSION"):
+    release = override_version
+else:
+    initFile = os.path.join(os.path.dirname(__file__), os.pardir, os.pardir, "umbraedit", "__init__.py")
+    with open(initFile, encoding="utf-8") as inFile:
+        for aLine in inFile:
+            if aLine.startswith("__version__"):
+                release = "20" + aLine.split('"')[1].strip()
+                break
+        else:
+            release = "unknown"
 
 version = release.partition("-")[0]
 
@@ -35,12 +39,14 @@ os.environ["TZ"] = "Europe/Oslo"
 time.tzset()
 
 needs_sphinx = "5.0"
-extensions = ["sphinx_design"]
+extensions = ["sphinx_design", "sphinx_copybutton"]
 templates_path = ["_templates"]
-source_suffix = ".rst"
+source_suffix = {".rst": "restructuredtext"}
 master_doc = "index"
 today_fmt = "%A, %d %B %Y at %H:%M"
 language = "en"
+locale_dirs = ["locales/"]
+gettext_compact = False
 exclude_patterns = []
 
 # -- Options for HTML Output -------------------------------------------------
@@ -51,17 +57,17 @@ html_static_path = ["_static"]
 html_css_files = ["custom.css"]
 html_theme_options = {
     "logo": {
-        "image_light": "_static/novelwriter-light.png",
-        "image_dark": "_static/novelwriter-dark.png",
+        "image_light": "_static/umbraedit-light.png",
+        "image_dark": "_static/umbraedit-dark.png",
     },
     "show_toc_level": 2,
     "show_navbar_depth": 1,
-    "repository_url": "https://github.com/vkbo/novelwriter",
+    "repository_url": "https://github.com/saga-soft/umbraedit",
     "navigation_with_keys": True,
     "use_repository_button": True,
     "use_issues_button": True,
-    "pygment_light_style": "tango",
-    "pygment_dark_style": "dracula",
+    "pygments_light_style": "tango",
+    "pygments_dark_style": "dracula",
 }
 html_sidebars = {
     "**": ["navbar-logo", "sidebar-title", "sbt-sidebar-nav"],
@@ -72,13 +78,8 @@ html_sidebars = {
 latex_elements = {
     "papersize": "a4paper",
     "pointsize": "11pt",
-    "preamble": (
-        "\\usepackage[utf8]{inputenc}\n"
-        "\\DeclareUnicodeCharacter{2212}{\\textendash}\n"
-    ),
+    "preamble": ("\\usepackage[utf8]{inputenc}\n\\DeclareUnicodeCharacter{2212}{\\textendash}\n"),
     "figure_align": "htbp",
 }
-latex_logo = "_static/novelwriter-pdf.png"
-latex_documents = [(
-    master_doc, "manual.tex", "User Guide", author, "manual"
-)]
+latex_logo = "_static/umbraedit-pdf.png"
+latex_documents = [(master_doc, "manual.tex", None, author, "manual")]

docs/source/features/dialogue.rst

@@ -0,0 +1,92 @@
+.. _docs_features_dialogue:
+
+*********************
+Dialogue Highlighting
+*********************
+
+Dialogue recognition and colour highlighting is available both while you're writing and in
+generated manuscript documents.
+
+The default language settings in UmbraEdit are for English. That includes the dialogue
+highlighting settings. But many dialogue styles are supported. You can tune a number of settings
+to fit your language and style preferences in the "Text Highlighting" section in **Preferences**.
+You can mix and match these settings.
+
+.. figure:: images/fig_dialogue_highlighting.png
+
+   The **Text Highlighting** section of **Preferences**.
+
+
+Quoted Dialogue
+===============
+
+By default, dialogue highlighting is enabled for the double quote symbols you have defined in the
+**Quotation Style** section of **Preferences**.
+
+.. figure:: images/fig_dialogue_quote_styles.png
+
+   The **Quotation Style** section of **Preferences**.
+
+You can change which quote symbols are highlighted by selecting one of "None", "Single", "Double",
+or "Both" from the "Highlight dialogue" setting under **Text Highlighting**.
+
+You can also enable or disable the "Allow open-ended dialogue" setting to allow for the style where
+multi-paragraph dialogue is not closed until the last paragraph.
+
+.. admonition:: Limitations
+
+   Dialogue highlighting for single quotes is difficult to process when the same single quote
+   symbol is also used for apostrophes. There isn't a good solution to this. Your best option in
+   the cases where the highlighting is wrong is to insert an alternative apostrophe symbol instead.
+   See :ref:`docs_more_typographical_symbols_apostrophe` for more details.
+
+
+Alternative Dialogue
+====================
+
+You can use the "Alternative dialogue symbols" setting for custom dialogue wrapper symbols. These
+are highlighted in a different colour than regular dialogue.
+
+The intended use case here is if you use an alternative style to distinguish a different style of
+communication. The feature idea came from a science fiction series where mind-to-mind communication
+used a different quotation style.
+
+
+Dialogue Line Symbols
+=====================
+
+In some languages, a single symbol at the start of a paragraph can indicate that the whole
+paragraph is dialogue. For instance, this symbol can be a short dash (en dash).
+
+.. figure:: images/fig_dialogue_line.png
+
+   An example of dialogue starting with a short dash.
+
+You can enable this feature by adding the symbols to the "Dialogue line symbols" setting. Multiple
+symbols are allowed.
+
+
+Dialogue with Narrator Break
+============================
+
+The dialogue symbol setting will not detect if the dialogue ends in the paragraph. In some styles
+there is no way to actually indicate the switch from dialogue to narration; in others there are.
+These a narrator break symbols are usually dashes. You can select one of the supported dash symbols
+for narrator breaks. These can be used with any of the above dialogue recognition settings.
+
+.. figure:: images/fig_dialogue_narrator_break.png
+
+   An example of dialogue starting with a short dash and a long dash narrator break.
+
+
+Alternating Dialogue and Narration
+==================================
+
+The alternating dialogue and narration style is supported with the "Alternating dialogue/narration
+symbol" setting. It can be set to one of the supported dashes. This style will switch into dialogue
+mode when it first encounters the selected dash in a paragraph, and switch back out when it sees
+the next one, and so forth.
+
+.. figure:: images/fig_dialogue_alternating.png
+
+   An example of alternating dialogue and narration using a long dash.

docs/source/features/shortcuts.rst

@@ -1,17 +1,21 @@
-.. _a_kb:
+.. _docs_features_shortcuts:
 
 ******************
 Keyboard Shortcuts
 ******************
 
-Most features in novelWriter are available as keyboard shortcuts. This is a reference list of those
+Most features in UmbraEdit are available as keyboard shortcuts. This is a reference list of those
 shortcuts. Most of them are also listed in the application's user interface.
 
 .. note::
+
    On MacOS, replace :kbd:`Ctrl` with :kbd:`Cmd`.
 
+.. note::
+
+   Shortcuts marked with (*) are remapped when Vim Mode is enabled and no longer work as listed in
+   the tables below. See :ref:`docs_features_vim_mode` for more details.
 
-.. _a_kb_main:
 
 Main Window Shortcuts
 =====================
@@ -20,26 +24,24 @@ Main Window Shortcuts
    :header: "Shortcut", "Description"
 
    ":kbd:`F1`",           "Open the online user manual"
-   ":kbd:`F5`",           "Open the :guilabel:`Build Manuscript` tool"
-   ":kbd:`F6`",           "Open the :guilabel:`Writing Statistics` tool"
-   ":kbd:`F8`",           "Toggle :guilabel:`Focus Mode`"
+   ":kbd:`F5`",           "Open the **Manuscript Build** tool"
+   ":kbd:`F6`",           "Open the **Writing Statistics** tool"
+   ":kbd:`F8`",           "Toggle **Focus Mode**"
    ":kbd:`F9`",           "Re-build the project's index"
    ":kbd:`F11`",          "Toggle full screen mode"
-   ":kbd:`Ctrl+,`",       "Open the :guilabel:`Preferences` dialog"
-   ":kbd:`Ctrl+E`",       "Switch focus to the document editor"
+   ":kbd:`Ctrl+,`",       "Open the **Preferences** dialog"
+   ":kbd:`Ctrl+E`",       "Switch or toggle focus for the editor or viewer"
    ":kbd:`Ctrl+T`",       "Switch or toggle focus for the project tree or novel view"
-   ":kbd:`Ctrl+Q`",       "Exit novelWriter"
-   ":kbd:`Ctrl+Shift+,`", "Open the :guilabel:`Project Settings` dialog"
+   ":kbd:`Ctrl+Q`",       "Exit UmbraEdit"
+   ":kbd:`Ctrl+Shift+,`", "Open the **Project Settings** dialog"
    ":kbd:`Ctrl+Shift+O`", "Open the Welcome dialog to open or create a project"
    ":kbd:`Ctrl+Shift+S`", "Save the current project"
    ":kbd:`Ctrl+Shift+T`", "Switch focus to the outline view"
    ":kbd:`Ctrl+Shift+W`", "Close the current project"
    ":kbd:`Shift+F1`",     "Open the local user manual (PDF) if it is available"
-   ":kbd:`Shift+F6`",     "Open the :guilabel:`Project Details` dialog"
+   ":kbd:`Shift+F8`",     "Toggle tree pane visibility"
 
 
-.. _a_kb_tree:
-
 Project Tree Shortcuts
 ======================
 
@@ -53,17 +55,15 @@ Project Tree Shortcuts
    ":kbd:`Alt+Left`",       "Jump to the parent item in the tree"
    ":kbd:`Alt+Right`",      "Jump to the first child item in the project tree"
    ":kbd:`Ctrl+.`",         "Open the context menu on the selected item"
-   ":kbd:`Ctrl+L`",         "Open the :guilabel:`Quick Links` menu"
-   ":kbd:`Ctrl+N`",         "Open the :guilabel:`Create New Item` menu"
+   ":kbd:`Ctrl+L`",         "Open the **Quick Links** menu"
+   ":kbd:`Ctrl+N`",         "Open the **Create New Item** menu"
    ":kbd:`Ctrl+O`",         "Open the selected document in the editor"
-   ":kbd:`Ctrl+R`",         "Open the selected document in the viewer"
+   ":kbd:`Ctrl+R`",         "Open the selected document in the viewer (*)"
    ":kbd:`Ctrl+Up`",        "Move selected item one step up in the tree"
    ":kbd:`Ctrl+Down`",      "Move selected item one step down in the tree"
    ":kbd:`Ctrl+Shift+Del`", "Move the selected item to Trash"
 
 
-.. _a_kb_editor:
-
 Document Editor Shortcuts
 =========================
 
@@ -75,11 +75,12 @@ Text Search Shortcuts
    :header: "Shortcut", "Description"
 
    ":kbd:`F3`",           "Find the next occurrence of the search word"
-   ":kbd:`Ctrl+F`",       "Open the search bar and search for the selected word, if any is selected"
+   ":kbd:`Ctrl+F`",       "Open search and look for the selected word"
    ":kbd:`Ctrl+G`",       "Find the next occurrence of the search word"
-   ":kbd:`Ctrl+H`",       "Open the search tool and populate with the selected word (Mac :kbd:`Cmd+=`)"
-   ":kbd:`Ctrl+Shift+1`", "Replace selected occurrence of the search word, and move to the next"
+   ":kbd:`Ctrl+H`",       "Open replace and look for the selected word (Mac :kbd:`Cmd+=`)"
+   ":kbd:`Ctrl+Shift+1`", "Replace selected occurrence, and move to the next"
    ":kbd:`Ctrl+Shift+G`", "Find the previous occurrence of the search word"
+   ":kbd:`Ctrl+Shift+F`", "Open project search and look for the selected word"
    ":kbd:`Shift+F3`",     "Find the previous occurrence of the search word"
 
 
@@ -91,8 +92,7 @@ Text Formatting Shortcuts
 
    ":kbd:`Ctrl+'`",       "Wrap selected text, or word under cursor, in single quotes"
    ":kbd:`Ctrl+""`",      "Wrap selected text, or word under cursor, in double quotes"
-   ":kbd:`Ctrl+/`",       "Toggle block format as comment for block under cursor, or selected text"
-   ":kbd:`Ctrl+0`",       "Remove block formatting for block under cursor, or selected text"
+   ":kbd:`Ctrl+/`",       "Toggle comment format for block or selected text"
    ":kbd:`Ctrl+1`",       "Change block format to heading level 1"
    ":kbd:`Ctrl+2`",       "Change block format to heading level 2"
    ":kbd:`Ctrl+3`",       "Change block format to heading level 3"
@@ -102,11 +102,12 @@ Text Formatting Shortcuts
    ":kbd:`Ctrl+7`",       "Change block alignment to right-aligned"
    ":kbd:`Ctrl+8`",       "Add a left margin to the block"
    ":kbd:`Ctrl+9`",       "Add a right margin to the block"
-   ":kbd:`Ctrl+B`",       "Format selected text, or word under cursor, with strong emphasis (bold)"
+   ":kbd:`Ctrl+B`",       "Format selected text, or word under cursor, with bold"
    ":kbd:`Ctrl+D`",       "Format selected text, or word under cursor, with strike through"
-   ":kbd:`Ctrl+I`",       "Format selected text, or word under cursor, with emphasis (italic)"
-   ":kbd:`Ctrl+Shift+/`", "Remove block formatting for block under cursor, or selected text"
-   ":kbd:`Ctrl+Shift+D`", "Toggle block format as ignored text for block under cursor, or selected text"
+   ":kbd:`Ctrl+I`",       "Format selected text, or word under cursor, with italic"
+   ":kbd:`Ctrl+M`",       "Highlight selected text, or word under cursor"
+   ":kbd:`Ctrl+Shift+/`", "Remove format for block or selected text"
+   ":kbd:`Ctrl+Shift+D`", "Toggle ignored text format for block or selected text"
 
 
 Other Editor Shortcuts
@@ -115,26 +116,37 @@ Other Editor Shortcuts
 .. csv-table::
    :header: "Shortcut", "Description"
 
-   ":kbd:`F7`",             "Re-run the spell checker on the document"
-   ":kbd:`Ctrl+.`",         "Open the context menu at the current cursor location"
-   ":kbd:`Ctrl+A`",         "Select all text in the document"
-   ":kbd:`Ctrl+C`",         "Copy selected text to clipboard"
-   ":kbd:`Ctrl+K`",         "Activate the insert commands (see list in :ref:`a_kb_ins`)"
-   ":kbd:`Ctrl+R`",         "Open or reload the current document in the viewer"
-   ":kbd:`Ctrl+S`",         "Save the current document"
-   ":kbd:`Ctrl+V`",         "Paste text from clipboard to cursor position"
-   ":kbd:`Ctrl+W`",         "Close the current document"
-   ":kbd:`Ctrl+X`",         "Cut selected text to clipboard"
-   ":kbd:`Ctrl+Y`",         "Redo latest undo"
-   ":kbd:`Ctrl+Z`",         "Undo latest changes"
-   ":kbd:`Ctrl+Backspace`", "Delete the word before the cursor"
-   ":kbd:`Ctrl+Del`",       "Delete the word after the cursor"
-   ":kbd:`Ctrl+F7`",        "Toggle spell checking"
-   ":kbd:`Ctrl+Return`",    "Open the tag or reference under the cursor in the viewer"
-   ":kbd:`Ctrl+Shift+A`",   "Select all text in the current paragraph"
+   ":kbd:`F7`",                "Re-run the spell checker on the document"
+   ":kbd:`Ctrl+.`",            "Open the context menu at the current cursor location"
+   ":kbd:`Ctrl+A`",            "Select all text in the document"
+   ":kbd:`Ctrl+C`",            "Copy selected text to clipboard"
+   ":kbd:`Ctrl+K`",            "Activate the insert commands (see list in :ref:`docs_features_shortcuts_insert`)"
+   ":kbd:`Ctrl+R`",            "Open or reload the current document in the viewer (*)"
+   ":kbd:`Ctrl+S`",            "Save the current document"
+   ":kbd:`Ctrl+V`",            "Paste text from clipboard to cursor position"
+   ":kbd:`Ctrl+W`",            "Close the current document"
+   ":kbd:`Ctrl+X`",            "Cut selected text to clipboard"
+   ":kbd:`Ctrl+Y`",            "Redo latest undo"
+   ":kbd:`Ctrl+Z`",            "Undo latest changes"
+   ":kbd:`Ctrl+0`",            "Reset zoom"
+   ":kbd:`Ctrl++`",            "Zoom in"
+   ":kbd:`Ctrl+=`",            "Zoom in"
+   ":kbd:`Ctrl+-`",            "Zoom out"
+   ":kbd:`Ctrl+_`",            "Zoom out"
+   ":kbd:`Ctrl+Backspace`",    "Delete the word before the cursor"
+   ":kbd:`Ctrl+Del`",          "Delete the word after the cursor"
+   ":kbd:`Ctrl+F7`",           "Toggle spell checking"
+   ":kbd:`Ctrl+Return`",       "Open the tag or reference under the cursor in the viewer"
+   ":kbd:`Ctrl+Shift+Return`", "Open the tag or reference under the cursor in the editor"
+   ":kbd:`Ctrl+Shift+A`",      "Select all text in the current paragraph"
+   ":kbd:`Ctrl+Shift+V`",      "Paste text as plain text from clipboard to cursor position"
+   ":kbd:`Ctrl+Left`",         "Move to previous word."
+   ":kbd:`Ctrl+Right`",        "Move to next word."
+   ":kbd:`Ctrl+Up`",           "Move to previous paragraph."
+   ":kbd:`Ctrl+Down`",         "Move to next paragraph."
 
 
-.. _a_kb_ins:
+.. _docs_features_shortcuts_insert:
 
 Insert Shortcuts
 ----------------
@@ -150,7 +162,7 @@ a key or key combination for the inserted content.
    ":kbd:`Ctrl+K`, :kbd:`_`",           "Insert a long dash (em dash)"
    ":kbd:`Ctrl+K`, :kbd:`.`",           "Insert an ellipsis"
    ":kbd:`Ctrl+K`, :kbd:`'`",           "Insert a modifier apostrophe"
-   ":kbd:`Ctrl+K`, :kbd:`*`",           "Insert a list bullet"
+   ":kbd:`Ctrl+K`, :kbd:`*`",           "Insert a bullet symbol"
    ":kbd:`Ctrl+K`, :kbd:`%`",           "Insert a per mille symbol"
    ":kbd:`Ctrl+K`, :kbd:`~`",           "Insert a figure dash (same width as a number)"
    ":kbd:`Ctrl+K`, :kbd:`−`",           "Insert a short dash (en dash)"
@@ -164,6 +176,7 @@ a key or key combination for the inserted content.
    ":kbd:`Ctrl+K`, :kbd:`G`",           "Insert a ``@tag`` keyword"
    ":kbd:`Ctrl+K`, :kbd:`H`",           "Insert a short description comment"
    ":kbd:`Ctrl+K`, :kbd:`L`",           "Insert a ``@location`` keyword"
+   ":kbd:`Ctrl+K`, :kbd:`M`",           "Insert a ``@mention`` keyword"
    ":kbd:`Ctrl+K`, :kbd:`O`",           "Insert an ``@object`` keyword"
    ":kbd:`Ctrl+K`, :kbd:`P`",           "Insert a ``@plot`` keyword"
    ":kbd:`Ctrl+K`, :kbd:`S`",           "Insert a synopsis comment"
@@ -182,8 +195,6 @@ a key or key combination for the inserted content.
    ":kbd:`Ctrl+K`, :kbd:`Shift+Space`", "Insert a thin space"
 
 
-.. _a_kb_viewer:
-
 Document Viewer Shortcuts
 =========================
 
@@ -193,5 +204,10 @@ Document Viewer Shortcuts
    ":kbd:`Alt+Left`",     "Move backward in the view history"
    ":kbd:`Alt+Right`",    "Move forward in the view history"
    ":kbd:`Ctrl+C`",       "Copy selected text to clipboard"
+   ":kbd:`Ctrl+0`",       "Reset zoom"
+   ":kbd:`Ctrl++`",       "Zoom in"
+   ":kbd:`Ctrl+=`",       "Zoom in"
+   ":kbd:`Ctrl+-`",       "Zoom out"
+   ":kbd:`Ctrl+_`",       "Zoom out"
    ":kbd:`Ctrl+Shift+A`", "Select all text in the current paragraph"
-   ":kbd:`Ctrl+Shift+R`", "Close the document viewer"
+   ":kbd:`Ctrl+Shift+R`", "Close the document viewer (*)"

docs/source/features/story_comments.rst

@@ -0,0 +1,110 @@
+.. _docs_features_story:
+
+**************
+Story Comments
+**************
+
+A special set of comment styles allow for annotating your text with structure information. There
+are two styles of comments available. They are an extension to regular comments as described in
+:ref:`docs_usage_comments`.
+
+.. versionadded:: 2.7
+
+
+Story Structure Comments
+========================
+
+You can annotate story structure by using the ``%Story`` style of comment. To use the feature,
+make the first word of a comment ``Story``, followed by a period, a structure term, a colon, a
+space and the text for that term.
+
+
+Usage
+-----
+
+The story term can be anything that you want to track in the manuscript. This construct is intended
+to make it easier to extract metadata from a work to perform a structural analysis of the story.
+
+There are probably as many ways to examine story structure as there are authors and editors
+combined. For this reason the story tag is flexible. You can use any terms you want and track any
+aspect of the story that serves your purposes.
+
+An example method has been advanced by Shawn Coyne in *The Story Grid*. This method asserts that a
+story is composed of "beats", and that each beat has an inciting incident, a complication, a
+crisis, and a resolution. One might capture these elements of a beat where a character overcomes
+their fear of giving a speech as:
+
+:bdg-info:`Example`
+
+.. code-block:: md
+
+   ### Scene
+
+   %Synopsis: Carol overcomes her fear of giving a speech.
+
+   %Story.incite: Carol is pleased to be invited to a conference to see her boss deliver a keynote.
+   %Story.complication: Carol's boss calls in sick and asks her to deliver a big speech.
+   %Story.crisis: Carol has a fear of appearing on stage.
+   %Story.resolution: Carol engages the help of a coach who helps her overcome her fears and delivers a great speech.
+
+Other analytical models propose tracking a scene's pace, how it affects the mood of the story, or
+which element(s) of the story's genre are being satisfied. An author can use this mechanism to
+track any element of a scene. Some examples include time of day, how much time passes in the scene,
+or even the physical form of a shape-shifting character. If a story involves magic, one could track
+which wand a main character has in hand. It's up to the author.
+
+When the story and other scene metadata is extracted into a tabular form, it is possible to get a
+comprehensive overview of the story and to identify possible issues. For example, so many
+fast-paced scenes without a break that readers might become fatigued or over-stimulated.
+
+
+Output
+------
+
+The story structure comments can be included in the manuscript, and are formatted similarly to
+the synopsis comments:
+
+.. figure:: images/fig_story_structure_manuscript.png
+
+   A set of story structure comments as shown in the Manuscript tool.
+
+When you export your project data from the Outline View, all story structure terms are added as
+columns to the exported file, which can then be opened in the spread sheet software of your choice.
+
+
+Story Notes
+===========
+
+Story notes are similar to story structure comments, but have no predefined meaning. Essentially
+they are a generalisation of the story structure comment, and the only point of having this
+additional format is to allow you do filter them in and out of your manuscript independently.
+
+You can annotate story notes by using the ``%Note`` style of comment. To use the feature,
+make the first word of a comment ``Note``, followed by a period, a term, a colon, a space and the
+text for the note.
+
+
+Usage
+-----
+
+These notes are free form, but one intended use case is to add consistency annotations to your text
+to remind yourself where you have described something that must be checked against other parts of
+your text later on.
+
+:bdg-info:`Example`
+
+.. code-block:: md
+
+   ### Scene
+
+   %Synopsis: Carol overcomes her fear of giving a speech.
+
+   %Note.consistency: This is the first time in the story Carol gives a speech.
+
+
+Output
+------
+
+Story notes are included in the manuscript in exactly the same way story structure comments are,
+but has a separate inclusion setting in the build settings. They are also included in CSV exports
+from the **Outline View**.

docs/source/features/vim_mode.rst

@@ -0,0 +1,126 @@
+.. _docs_features_vim_mode:
+
+********
+Vim Mode
+********
+
+.. _Vim: https://www.vim.org/
+
+Vim_ is a keyboard-centric text editor. "Vim mode" refers to another editor implementing the
+ability to perform a subset of vim motions. This will allow you to write, select, edit, copy,
+paste, navigate, etc, efficiently by using keyboard commands.
+
+Vim is modal. Three such modes have been implemented in UmbraEdit:
+
+- **Normal** mode is the default mode used to navigate text.
+- **Insert** mode is where you can write text like in a 'normal' text editor.
+- **Visual** mode is for selecting text, with:
+
+  - **Visual** mode for per character selection.
+  - **V-Line** mode for per-line selection.
+
+The vim mode setting is found in the **Features** section of the **Preferences**.
+
+.. note::
+
+   Vim mode is an advanced feature. When you enable it, the text editor will behave very
+   differently than a standard text editor. A label in the footer of the editor will show which of
+   the vim modes it is in.
+
+
+Mode Switching
+==============
+
+To switch between the various vim modes, these keystrokes implemented:
+
+.. csv-table::
+   :header: "From Mode", "To Mode", "Keystrokes"
+
+   "Normal", "Insert", ":kbd:`i`, :kbd:`I`, :kbd:`a`, :kbd:`A`, :kbd:`o`, :kbd:`O`"
+   "Insert", "Normal", ":kbd:`Esc`"
+   "Normal", "Visual", ":kbd:`v`, :kbd:`V`"
+   "Visual", "V-Line", ":kbd:`V`"
+   "V-Line", "Visual", ":kbd:`v`"
+   "Visual", "Normal", ":kbd:`Esc`, :kbd:`v`"
+   "V-Line", "Normal", ":kbd:`Esc`, :kbd:`V`"
+
+You can exit visual mode back to normal mode by pressing :kbd:`Esc`, but all visual mode commands
+that logically "terminate" the visual mode usage will return you to normal mode.
+
+For instance, press :kbd:`V` to enter V-Line mode, extend the selection to the next line with
+:kbd:`j`, and press :kbd:`y` to yank (copy). You are now automatically put back in normal mode as
+you have completed selecting your text.
+
+
+Implemented Keystrokes (Vim Motions)
+====================================
+
+The table below shows the vim motions currently implemented in UmbraEdit.
+
+.. csv-table::
+   :header: "Motion", "Mode(s)", "Description"
+
+   ":kbd:`i`",      "Normal → Insert", "Enter insert mode"
+   ":kbd:`I`",      "Normal → Insert", "Jump to start of line and enter insert"
+   ":kbd:`v`",      "Normal → Visual", "Enter character-wise visual mode"
+   ":kbd:`V`",      "Normal → V-Line", "Enter line-wise visual mode"
+   ":kbd:`dd`",     "Normal",          "Delete (cut) current line"
+   ":kbd:`x`",      "Normal",          "Delete character under cursor"
+   ":kbd:`w`",      "Normal / Visual", "Move to next word start"
+   ":kbd:`b`",      "Normal / Visual", "Move to previous word start"
+   ":kbd:`e`",      "Normal / Visual", "Move to next word end"
+   ":kbd:`dw`",     "Normal",          "Delete from cursor to next word start"
+   ":kbd:`de`",     "Normal",          "Delete from cursor to next word end"
+   ":kbd:`db`",     "Normal",          "Delete from cursor to previous word start"
+   ":kbd:`d$`",     "Normal",          "Delete from cursor to end of line"
+   ":kbd:`yw`",     "Normal",          "Yank (copy) from cursor to next word start"
+   ":kbd:`gg`",     "Normal / Visual", "Jump to first line"
+   ":kbd:`G`",      "Normal / Visual", "Jump to last line"
+   ":kbd:`yy`",     "Normal",          "Yank current line"
+   ":kbd:`p`",      "Normal",          "Paste after current line or cursor"
+   ":kbd:`P`",      "Normal",          "Paste before current line or at cursor"
+   ":kbd:`o`",      "Normal → Insert", "Open new line below and enter insert"
+   ":kbd:`O`",      "Normal → Insert", "Open new line above and enter insert"
+   ":kbd:`$`",      "Normal / Visual", "Move to end of line"
+   ":kbd:`0`",      "Normal / Visual", "Move to start of line"
+   ":kbd:`a`",      "Normal → Insert", "Enter insert after cursor"
+   ":kbd:`A`",      "Normal → Insert", "Enter insert at end of line"
+   ":kbd:`u`",      "Normal",          "Undo last change"
+   ":kbd:`Ctrl+R`", "Normal",          "Redo last undone change (*)"
+   ":kbd:`zz`",     "Normal",          "Centre cursor vertically"
+   ":kbd:`h`",      "Normal / Visual", "Move left"
+   ":kbd:`j`",      "Normal / Visual", "Move down"
+   ":kbd:`k`",      "Normal / Visual", "Move up"
+   ":kbd:`l`",      "Normal / Visual", "Move right"
+   ":kbd:`d`",      "Visual / V-Line", "Delete selection"
+   ":kbd:`x`",      "Visual / V-Line", "Delete selection"
+   ":kbd:`y`",      "Visual / V-Line", "Yank selection"
+
+
+.. note::
+
+   Shortcuts marked with (*) are remapped when Vim Mode is enabled. These are shortcuts that
+   usually do other things when Vim Mode is off.
+
+
+Known Issues
+============
+
+* Differing behaviour from vim: :kbd:`j` and :kbd:`k` move by displayed line when a line is
+  wrapped, like :kbd:`gj` and :kbd:`gk` in vim. All other line commands act on the full line.
+* :kbd:`Esc` in normal mode will leave Focus Mode if there is no pending command to cancel.
+* Differing behaviour from vim: the :kbd:`e` command behaves a bit differently with regards to the
+  last character of a word. The behaviour is inconsistent with vim but functional and still logical
+  to use. The cursor is placed at the end of the word after the last character rather than on the
+  last character.
+
+  .. code-block::
+
+     test
+        ^ Cursor placed here in vim
+     test
+         ^ Cursor placed here in UmbraEdit vim mode
+
+  You will only really ever notice this behaviour if you try to combine the :kbd:`e` command with
+  another. For instance, :kbd:`de` will not delete the last character but delete forward as it
+  starts one character after the word boundary.

docs/source/index.rst

@@ -1,11 +1,11 @@
-######################
-novelWriter User Guide
-######################
+##########
+User Guide
+##########
 
 | **Release Version:** |release|
 | **Updated:** |today|
 
-novelWriter is an open source plain text editor designed for writing novels assembled from
+UmbraEdit is an open source plain text editor designed for writing novels assembled from
 individual text documents. It uses a minimal formatting syntax inspired by Markdown, and adds a
 meta data syntax for comments, synopsis, and cross-referencing. It is designed to be a simple text
 editor that allows for easy organisation of text and notes, using human readable text files as
@@ -16,82 +16,77 @@ storage for robustness.
    :align: center
    :width: 500
 
-The project storage is suitable for version control software, and also well suited for file
-synchronisation tools. All text is saved as plain text files with a meta data header. The core
-project structure is stored in a single project XML file. Other meta data is saved as JSON files.
-See the :ref:`a_breakdown_storage` section for more details.
-
-Any operating system that can run Python 3 and has the Qt 5 libraries should be able to run
-novelWriter. It runs fine on Linux, Windows and MacOS, and users have tested it on other platforms
-as well. novelWriter can be run directly from the Python source, or installed from packages or with
-pip. See :ref:`a_started` for more details.
-
 **Useful Links**
 
-* Website: https://novelwriter.io
-* Documentation: https://docs.novelwriter.io
-* Public Releases: https://releases.novelwriter.io
-* Internationalisation: https://crowdin.com/project/novelwriter
-* Source Code: https://github.com/vkbo/novelWriter
-* Source Releases: https://github.com/vkbo/novelWriter/releases
-* Issue Tracker: https://github.com/vkbo/novelWriter/issues
-* Feature Discussions: https://github.com/vkbo/novelWriter/discussions
-* PyPi Project: https://pypi.org/project/novelWriter
-* Social Media: https://fosstodon.org/@novelwriter
+* Website: https://umbraedit.io
+* Documentation: https://docs.umbraedit.io
+* Public Releases: https://releases.umbraedit.io
+* Internationalisation: https://crowdin.com/project/umbraedit
+* Source Code: https://github.com/saga-soft/UmbraEdit
+* Source Releases: https://github.com/saga-soft/UmbraEdit/releases
+* Issue Tracker: https://github.com/saga-soft/UmbraEdit/issues
+* Feature Discussions: https://github.com/saga-soft/UmbraEdit/discussions
+* PyPi Project: https://pypi.org/project/UmbraEdit
+* Social Media: https://fosstodon.org/@umbraedit
 
 .. toctree::
    :hidden:
 
-   Main Page <self>
+   self
+   More Documents <https://umbraedit.io/more/>
 
 .. toctree::
-   :maxdepth: 1
-   :caption: Introduction
+   :caption: Getting Started
    :hidden:
 
-   int_introduction
-   int_overview
-   int_started
-   int_howto
-   int_customise
-   int_glossary
+   usage/introduction
+   usage/organising_project
+   usage/chapters_and_scenes
+   usage/basic_formatting
+   usage/comments
+   usage/tags_and_references
+   usage/alignment_and_indent
+   usage/advanced_formatting
+   usage/front_back_matter
+   usage/howto
 
 .. toctree::
-   :maxdepth: 1
-   :caption: Using novelWriter
+   :caption: The User Interface
    :hidden:
 
-   usage_breakdown
-   usage_project
-   usage_writing
-   usage_format
-   usage_shortcuts
-   usage_typography
+   user_interface/main_window
+   user_interface/projects
+   user_interface/editor_viewer
+   user_interface/split_and_merge
+   user_interface/manuscript
+   user_interface/formatting
+   user_interface/statistics
 
 .. toctree::
-   :maxdepth: 1
-   :caption: Organising Your Project
+   :caption: Other Features
    :hidden:
 
-   project_overview
-   project_structure
-   project_references
-   project_manuscript
+   features/dialogue
+   features/story_comments
+   features/shortcuts
+   features/vim_mode
 
 .. toctree::
-   :maxdepth: 1
-   :caption: Additional Details
+   :caption: In-Depth Topics
    :hidden:
 
-   more_projectformat
-   more_counting
+   more/counting
+   more/typography
+   more/dictionaries
+   more/customise
+   more/handling_errors
+   more/project_format
 
 .. toctree::
-   :maxdepth: 1
    :caption: Technical Topics
    :hidden:
 
-   tech_locations
-   tech_storage
-   tech_source
-   tech_tests
+   technical/locations
+   technical/storage
+   technical/source
+   technical/tests

docs/source/int_customise.rst

@@ -1,199 +0,0 @@
-.. _a_custom:
-
-**************
-Customisations
-**************
-
-.. _Enchant: https://abiword.github.io/enchant
-.. _Free Desktop: https://cgit.freedesktop.org/libreoffice/dictionaries/tree/
-
-There are a few ways you can customise novelWriter yourself. Currently, you can add new GUI themes,
-your own syntax themes, and install additional dictionaries.
-
-
-.. _a_custom_dict:
-
-Spell Check Dictionaries
-========================
-
-novelWriter uses Enchant_ as the spell checking tool. Depending on your operating system, it may or
-may not load all installed spell check dictionaries automatically.
-
-Linux and MacOS
----------------
-
-On Linux and MacOS, you generally only have to install hunspell, aspell or myspell dictionaries on
-your system like you do for other applications. See your distro or OS documentation for how to do
-this. These dictionaries should show up as available spell check languages in novelWriter.
-
-Windows
--------
-
-For Windows, English is included with the installation. For other languages you have to download
-and add dictionaries yourself.
-
-**Install Tool**
-
-A small tool to assist with this can be found under :guilabel:`Tools > Add Dictionaries`. It will
-import spell checking dictionaries from Free Office or Libre Office extensions. The dictionaries
-are then installed in the install location for the Enchant library and should thus work for any
-application that uses Enchant for spell checking.
-
-**Manual Install**
-
-If you prefer to do this manually or want to use a different source than the ones mentioned above,
-You need to get compatible dictionary files for your language. You need two files files ending with
-``.aff`` and ``.dic``. These files must then be copied to the following location: 
-
-``C:\Users\<USER>\AppData\Local\enchant\hunspell``
-
-This assumes your user profile is stored at ``C:\Users\<USER>``. The last one or two folders may
-not exist, so you may need to create them.
-
-You can find the various dictionaries on the `Free Desktop`_ website.
-
-.. note::
-   The Free Desktop link points to a repository, and what may look like file links inside the
-   dictionary folder are actually links to web pages. If you right-click and download those, you
-   get HTML files, not dictionaries!
-
-   In order to download the actual dictionary files, right-click the "plain" label at the end of
-   each line and download that.
-
-
-.. _a_custom_theme:
-
-Syntax and GUI Themes
-=====================
-
-Adding your own GUI and syntax themes is relatively easy, although it requires that you manually
-edit config files with colour values. The themes are defined by simple plain text config files with
-meta data and colour settings.
-
-In order to make your own versions, first copy one of the existing files to your local computer and
-modify it as you like.
-
-* The existing syntax themes are stored in
-  `novelwriter/assets/syntax <https://github.com/vkbo/novelWriter/tree/main/novelwriter/assets/syntax>`_.
-* The existing GUI themes are stored in
-  `novelwriter/assets/themes <https://github.com/vkbo/novelWriter/tree/main/novelwriter/assets/themes>`_.
-* The existing icon themes are stored in
-  `novelwriter/assets/icons <https://github.com/vkbo/novelWriter/tree/main/novelwriter/assets/icons>`_.
-
-Remember to also change the name of your theme by modifying the ``name`` setting at the top of the
-file, otherwise you may not be able to distinguish them in :guilabel:`Preferences`.
-
-For novelWriter to be able to locate the custom theme files, you must copy them to the
-:ref:`a_locations_data` location in your home or user area. There should be a folder there named
-``syntax`` for syntax themes, just ``themes`` for GUI themes, and ``icons`` for icon themes. These
-folders are created the first time you start novelWriter.
-
-Once the files are copied there, they should show up in :guilabel:`Preferences` with the label you
-set as ``name`` inside the file.
-
-.. versionadded:: 2.0
-   The ``icontheme`` value was added to GUI themes. Make sure you set this value in existing custom
-   themes. Otherwise, novelWriter will try to guess your icon theme, and may not pick the most
-   suitable one.
-
-
-Custom GUI and Icons Theme
---------------------------
-
-A GUI theme ``.conf`` file consists of the following settings:
-
-.. code-block:: cfg
-
-   [Main]
-   name        = My Custom Theme
-   description = A description of my custom theme
-   author      = Jane Doe
-   credit      = John Doe
-   url         = https://example.com
-   license     = CC BY-SA 4.0
-   licenseurl  = https://creativecommons.org/licenses/by-sa/4.0/
-   icontheme   = typicons_light
-
-   [Palette]
-   window          = 100, 100, 100
-   windowtext      = 100, 100, 100
-   base            = 100, 100, 100
-   alternatebase   = 100, 100, 100
-   text            = 100, 100, 100
-   tooltipbase     = 100, 100, 100
-   tooltiptext     = 100, 100, 100
-   button          = 100, 100, 100
-   buttontext      = 100, 100, 100
-   brighttext      = 100, 100, 100
-   highlight       = 100, 100, 100
-   highlightedtext = 100, 100, 100
-   link            = 100, 100, 100
-   linkvisited     = 100, 100, 100
-
-   [GUI]
-   statusnone      = 100, 100, 100
-   statussaved     = 100, 100, 100
-   statusunsaved   = 100, 100, 100
-
-In the Main section you must at least define the ``name`` and ``icontheme`` settings. The
-``icontheme`` settings should correspond to one of the internal icon themes, either
-``typicons_light`` or ``typicons_dark``, or to an icon theme in your custom icons directory. The
-setting must match the icon theme's folder name.
-
-The Palette values correspond to the Qt enum values for ``QPalette::ColorRole``, see the
-`Qt documentation <https://doc.qt.io/qt-5.15/qpalette.html#ColorRole-enum>`_ for more details. The
-colour values are RGB numbers on the format ``r, g, b`` where each is an integer from ``0`` to
-``255``. Omitted values are not loaded and will use default values.
-
-
-Custom Syntax Theme
--------------------
-
-A syntax theme ``.conf`` file consists of the following settings:
-
-.. code-block:: cfg
-
-   [Main]
-   name       = My Syntax Theme
-   author     = Jane Doe
-   credit     = John Doe
-   url        = https://example.com
-   license    = CC BY-SA 4.0
-   licenseurl = https://creativecommons.org/licenses/by-sa/4.0/
-
-   [Syntax]
-   background     = 255, 255, 255
-   text           =   0,   0,   0
-   link           =   0,   0,   0
-   headertext     =   0,   0,   0
-   headertag      =   0,   0,   0
-   emphasis       =   0,   0,   0
-   straightquotes =   0,   0,   0
-   doublequotes   =   0,   0,   0
-   singlequotes   =   0,   0,   0
-   hidden         =   0,   0,   0
-   shortcode      =   0,   0,   0
-   keyword        =   0,   0,   0
-   value          =   0,   0,   0
-   optional       =   0,   0,   0
-   spellcheckline =   0,   0,   0
-   errorline      =   0,   0,   0
-   replacetag     =   0,   0,   0
-   modifier       =   0,   0,   0
-   texthighlight  = 255, 255, 255, 128
-
-In the Main section, you must define at least the ``name`` setting. The Syntax colour values are
-RGB(A) numbers of the format ``r, g, b, a`` where each is an integer from ``0`` to ``255``. The
-fourth value is the alpha channel, which can be omitted.
-
-Omitted syntax colours default to black, except ``background`` which defaults to white, and
-``texthighlight`` which defaults to white with half transparency.
-
-.. versionadded:: 2.2
-   The `shortcode` syntax colour entry was added.
-
-.. versionadded:: 2.3
-   The `optional` syntax colour entry was added.
-
-.. versionadded:: 2.4
-   The `texthighlight` syntax colour entry was added.

docs/source/int_glossary.rst

@@ -1,64 +0,0 @@
-.. _a_glossary:
-
-********
-Glossary
-********
-
-.. glossary::
-   :sorted:
-
-   Root Folder
-      A "Root Folder" is a top level folder of the project tree in novelWriter. Each type of root
-      folder has a specific icon to identify it. For an overview of available root folder types,
-      see :ref:`a_proj_roots`.
-
-   Novel Documents
-      These are documents that are created under a "Novel" :term:`root folder`. They behave
-      differently than :term:`Project Notes`, and have some more restrictions. For instance, they
-      can not exist in folders intended only for project notes. See the :ref:`a_struct` chapter for
-      more details.
-
-   Project Notes
-      Project Notes are unrestricted documents that can be placed anywhere in your project. You
-      should not use these documents for story elements, only for notes. Project notes are the
-      source files used by the Tags and References system. See the :ref:`a_references` chapter for
-      more details on how to use them.
-
-   Tag
-      A tag is a user defined value assigned as a tag to a section of your :term:`Project Notes`.
-      It is optional, and can be defined once per heading. It is set using the :term:`keyword`
-      syntax ``@tag: value``, where ``value`` is the user defined part. Each tag can be referenced
-      in another file using one of the :term:`reference` keywords. See :ref:`a_references` chapter
-      for more details.
-
-   Reference
-      A reference is one of a set of :term:`keywords<keyword>` that can be used to link to a
-      :term:`tag` in another document. The reference keywords are specific to the different
-      :term:`root folder` types. A full overview is available in the :ref:`a_references` chapter.
-
-   Project Index
-      The project index is a record of all headings in a project, with all their meta data like
-      synopsis comments, :term:`tags<tag>` and :term:`references<reference>`. The project index is
-      kept up to date automatically, but can also be regenerated manually from the
-      :guilabel:`Tools` menu or by pressing :kbd:`F9`.
-
-   Context Menu
-      A context menu is a menu that pops up when you right click something in the user interface.
-      In novelWriter, you can often also open a context menu by pressing the keyboard shortcut
-      :kbd:`Ctrl+.`.
-
-   Headings
-      Each level of headings in :term:`Novel Documents` have a specific meaning in terms of the
-      structure of the story. That is, they determine what novelWriter considers a partition, a
-      chapter, a scene or a text section. For :term:`Project Notes`, the heading levels don't
-      matter. For more details on headings in novel documents, see :ref:`a_struct_heads`.
-
-   Keyword
-      A keyword in novelWriter is a special command you put in the text of your documents. They are
-      not standard Markdown, but are used in novelWriter to add information that is interpreted by
-      the application. For instance, keywords are used for :term:`tags<tag>` and
-      :term:`references<reference>`.
-
-      Keywords must always be on their own line, and the first character of the line must always be
-      the ``@`` character. The keyword must also always be followed by a ``:`` character, and the
-      values passed to the command are added after this, separated by commas.

docs/source/int_howto.rst

@@ -1,92 +0,0 @@
-.. _a_howto:
-
-*************
-Tips & Tricks
-*************
-
-.. _Discussions Page: https://github.com/vkbo/novelWriter/discussions
-
-This is a list of hopefully helpful little tips on how to get the most out of novelWriter.
-
-.. note::
-   This section will be expanded over time. If you would like to have something added, feel free to
-   contribute, or start a discussion on the project's `Discussions Page`_.
-
-
-Managing the Project
-====================
-
-.. dropdown:: Merge Multiple Documents Into One
-   :animate: fade-in-slide-down
-
-   If you need to merge a set of documents in your project into a single document, you can achieve
-   this by first making a new folder for just that purpose, and drag all the files you want merged
-   into this folder. Then you can right click the folder, select :guilabel:`Transform` and
-   :guilabel:`Merge Documents in Folder`.
-
-   In the dialog that pops up, the documents will be in the same order as in the folder, but you
-   can rearrange them here of you wish. See :ref:`a_ui_tree_split_merge` for more details.
-
-
-Layout Tricks
-=============
-
-.. dropdown:: Create a Simple Table
-   :animate: fade-in-slide-down
-
-   The formatting tools available in novelWriter don't allow for complex structures like tables.
-   However, the editor does render tabs in a similar way that regular word processors do. You can
-   set the width of a tab in :guilabel:`Preferences`.
-
-   The tab key should have the same distance in the editor as in the viewer, so you can align text
-   in columns using the tab key, and it should look the same when viewed next to the editor.
-
-   This is most suitable for your notes, as the result in exported documents cannot be guaranteed
-   to match. Especially if you don't use the same font in your manuscript as in the editor.
-
-
-Organising Your Text
-====================
-
-.. dropdown:: Add Introductory Text to Chapters
-   :animate: fade-in-slide-down
-
-   Sometimes chapters have a short preface, like a brief piece of text or a quote to set the stage
-   before the first scene begins.
-
-   If you add separate files for chapters and scenes, the chapter file is the perfect place to add
-   such text. Separating chapter and scene files also allows you to make scene files child
-   documents of the chapter.
-
-   .. versionadded:: 2.0
-
-.. dropdown:: Distinguishing Soft and Hard Scene Breaks
-   :animate: fade-in-slide-down
-
-   Depending on your writing style, you may need to separate between soft and hard scene breaks
-   within chapters. Like for instance if you switch point-of-view character often.
-
-   In such cases you may want to use a scene heading for hard scene breaks and a section heading
-   for soft scene breaks. The :guilabel:`Build Manuscript` tool will let you add separate
-   formatting for the two when you generate your manuscript. You can for instance add the common
-   "``* * *``" for hard breaks and select to hide section breaks, which will just insert an empty
-   paragraph in their place. See :ref:`a_manuscript_settings` for more details.
-
-   Keep in mind that this is not what the section heading is intended for, so the app will not
-   understand the section heading as a scene, but it will be formatted correctly in the manuscript.
-
-   .. versionadded:: 2.4
-      You can now distinguish between soft and hard scene breaks with a modified scene header. See
-      :ref:`a_manuscript_settings_head_hard` for more details.
-
-
-Other Tools
-===========
-
-.. dropdown:: Convert Project to/from yWriter Format
-   :animate: fade-in-slide-down
-
-   There is a tool available that lets you convert a `yWriter <http://spacejock.com/yWriter7.html>`_
-   project to a novelWriter project, and vice versa.
-
-   The tool is available at `peter88213.github.io/yw2nw <https://peter88213.github.io/yw2nw/>`__

docs/source/int_introduction.rst

@@ -1,106 +0,0 @@
-.. _a_intro:
-
-************
-Key Features
-************
-
-.. _Snowflake: https://www.advancedfictionwriting.com/articles/snowflake-method/
-.. _Markdown: https://en.wikipedia.org/wiki/Markdown
-
-At its core, novelWriter is a multi-document plain text editor. It uses a markup syntax inspired by
-Markdown_ to apply simple formatting to the text. It also allows for some extended formatting codes
-using a shortcode format. See :ref:`a_fmt_shortcodes` for more details.
-
-.. admonition:: Limitations
-
-   novelWriter is designed for writing fiction, so the formatting features available are limited to
-   those relevant for this purpose. It is **not** suitable for technical writing, and it is **not**
-   a full-featured Markdown editor.
-
-   It is also not intended as a tool to organise research for writing, and therefore lacks
-   formatting features you may need for this purpose. The notes feature in novelWriter is mainly
-   intended for character profiles and plot outlines.
-
-Your novel project is organised as a collection of separate plain text documents instead of a
-single, large document. The idea is to make it easier to reorganise your project structure without
-having to cut and paste text between chapters.
-
-There are two kinds of documents in your project: :term:`Novel Documents` are documents that are
-part of your story. The other kind of documents are :term:`Project Notes`. These are intended for
-your notes about your characters, your world building, and so on.
-
-You can at any point split the individual documents by their headings up into multiple documents,
-or merge multiple documents into single documents. This makes it easier to use variations of the
-Snowflake_ method for writing. You can start by writing larger structure-focused documents, like
-one per act for instance, and later effortlessly split these up into chapters or scenes.
-
-Below are some key features of novelWriter.
-
-**Focus on writing**
-   The aim of the user interface is to let you focus on writing instead of spending time formatting
-   text. Formatting is therefore limited to a small set of formatting tags for simple things like
-   text emphasis and paragraph alignment. When you really want to focus on just writing, you can
-   switch the editor into :guilabel:`Focus Mode` where only the text editor panel itself is
-   visible, and the project structure view is hidden away.
-
-**Keep an eye on your notes**
-   The main window can optionally show a document viewer to the right of the editor. This view
-   panel is intended for displaying another scene document, your character notes, plot notes, or any
-   other document you may need to reference while writing. It is not intended as a preview panel
-   for the document you're editing, but if you wish, you can also use it for this purpose.
-
-**Organise your documents how you like**
-   You can split your novel project up into as many individual documents as you want to. When you
-   build the project into a manuscript, they are all glued together in the top-to-bottom order in
-   which they appear in the project tree. You can use as few text documents as you like, but
-   splitting the project up into chapters and scenes means you can easily reorder them using the
-   drag-and-drop feature of the project tree. You can also start out with fewer documents and then
-   later split them into multiple documents based on chapter and scene headings.
-
-**Multi-novel project support**
-   You can have multiple Novel type root folders in a project. This allows you to keep a series of
-   individual novels with the same characters and world building in the same project, and create
-   manuscripts for them individually.
-
-**Keep track of your story elements**
-   All notes in your project can be assigned a :term:`tag` that you can :term:`reference` from any
-   other document or note. In fact, you can add a new tag under each heading of a note if you need
-   to be able to reference specific sections of it.
-
-**Get an overview of your story**
-   In the :guilabel:`Outline View` on the main window you can see an outline of all the chapters,
-   scenes, and sections of your project. If they have any references in them, these are listed in
-   additional columns. You can also add a synopsis to each chapter or scene, which can be listed
-   here as well. You have the option to add or remove columns of information from this outline. A
-   subset of the outline information is also available in the :guilabel:`Novel View` as an
-   alternative view to the project tree.
-
-**Get an overview of your story elements**
-   Under the document viewer panel you will find a series of tabs that shows the different story
-   elements you have created tags for. The tabs are sorted into Characters, Plots, etc, depending
-   on which categories you are using in your story. This panel can be hidden to free up space when
-   you don't need it.
-
-**Assembling your manuscript**
-   Whether you want to assemble a manuscript, or export all your notes, or generate an outline of
-   your chapters and scenes with a synopsis, you can use the :guilabel:`Build Manuscript` tool to
-   do so. The tool lets you select what information you want to include in the generated document,
-   and how it is formatted. You can send the result to a printer, a PDF, or to an Open Document
-   file that can be opened by most office type word processors. You can also generate the result
-   as HTML, or Markdown, both suitable for further conversion to other formats.
-
-
-.. _a_intro_screenshots:
-
-Screenshots
-===========
-
-.. figure:: images/screenshot_default.png
-   :class: dark-light
-
-   novelWriter with light colour theme
-
-.. figure:: images/screenshot_dark.png
-   :class: dark-light
-
-   novelWriter with dark colour theme

docs/source/int_overview.rst

@@ -1,94 +0,0 @@
-.. _a_overview:
-
-********
-Overview
-********
-
-.. only:: html
-
-   .. image:: images/python_powered.png
-      :align: right
-      :width: 220
-
-novelWriter is built as a cross-platform application using `Python 3 <https://www.python.org/>`_ as
-the programming language, and `Qt 5 <https://www.qt.io/>`_ framework for the user interface.
-
-novelWriter is built for Linux first, so this is where it works best. However, it also runs fine
-on Windows and MacOS due to the cross-platform framework it's built on. The author of the
-application doesn't own a Mac, so on-going Mac support is dependent on user feedback and user
-contributions.
-
-Spell checking in novelWriter is provided by a third party library called
-`Enchant <https://abiword.github.io/enchant/>`_. Please see the section on :ref:`a_custom_dict` for
-how to install spell checking languages.
-
-For install instructions for novelWriter, see :ref:`a_started`.
-
-
-Using novelWriter
-=================
-
-In order to use novelWriter effectively, you need to know the basics of how it works. The following
-chapters will explain the main principles. It starts with the basics, and gets more detailed as you
-read on.
-
-:ref:`a_breakdown` – Essential Information
-   This chapter explains the basics of how the application works and what it can and cannot do.
-
-:ref:`a_ui_project` – Recommended Reading
-   This chapter will give you a more detailed explanation of how you can use the user interface
-   components to organise and view your project work.
-
-:ref:`a_ui_writing` – Recommended Reading
-   This chapter will give you a more detailed explanation of how the text editor and viewer work.
-
-:ref:`a_fmt` – Essential Information
-   This chapter covers how you should format your text. The editor is plain text, so text
-   formatting requires some basic markup. The structure of your novel is also inferred from how you
-   use headings. Tags and references are implemented by special keywords.
-
-:ref:`a_kb` – Optional / Lookup
-   This chapter lists all the keyboard shortcuts in novelWriter and what they do. Most of the
-   shortcuts are also listed next to their menu entries inside the app, or in tool tips. This
-   chapter is mostly for reference.
-
-:ref:`a_typ` – Optional
-   This chapter gives you an overview of the special typographical symbols available in
-   novelWriter. The auto-replace feature can handle the insertion of standard quote symbols for
-   your language, and other special characters. If you use any symbols aside from these, their
-   intended use is explained here.
-
-
-Organising Your Projects
-========================
-
-In addition to managing a collection of plain text files, novelWriter can interpret and map the
-structure of your novel and show you additional information about its flow and content. In order
-to take advantage of these features, you must structure your text in a specific way and add some
-meta data for it to extract.
-
-:ref:`a_proj` – Essential Information
-   This chapter explains how you organise the content of your project, and how to set up automated
-   backups of your work.
-
-:ref:`a_struct` – Essential Information
-   This chapter covers the way your novel's structure is encoded into the text documents. It
-   explains how the different levels of headings are used, and some special formatting for
-   different kinds of headings.
-
-:ref:`a_references` - Recommended Reading
-   This chapter explains how you organise your notes, and how the Tags and References system works.
-   This system lets you cross-link your documents in your project, and display these references in
-   the application interface.
-
-:ref:`a_manuscript` - Recommended Reading
-   This chapter explains how the :guilabel:`Manuscript Build` tool works, how you can control the
-   way chapter titles are formatted, and how scene and section breaks are handled.
-
-
-Additional Details & Technical Topics
-=====================================
-
-The Additional Details and the Technical Topics sections contain more in-depth information about
-how various bits of novelWriter works. This information is not essential to getting started using
-novelWriter.

docs/source/int_started.rst

@@ -1,179 +0,0 @@
-.. _a_started:
-
-***************
-Getting Started
-***************
-
-.. _Enchant: https://abiword.github.io/enchant/
-.. _GitHub: https://github.com/vkbo/novelWriter
-.. _Downloads page: https://download.novelwriter.io
-.. _PPA: https://launchpad.net/~vkbo/+archive/ubuntu/novelwriter
-.. _Pre-Release PPA: https://launchpad.net/~vkbo/+archive/ubuntu/novelwriter-pre
-.. _PyPi: https://pypi.org/project/novelWriter/
-.. _python.org: https://www.python.org/downloads/
-.. _Releases: https://github.com/vkbo/novelWriter/releases
-.. _AppImage: https://appimage.org/
-
-Ready-made packages and installers for novelWriter are available for all major platforms, including
-Linux, Windows and MacOS, from the `Downloads page`_. See below for install instructions for each
-platform.
-
-You can also install novelWriter from the Python Package Index (PyPi_). See :ref:`a_started_pip`.
-Installing from PyPi does not set up icon launchers, so you will either have to do this yourself,
-or start novelWriter from the command line.
-
-Spell checking in novelWriter is provided by a third party library called Enchant_. Generally, it
-should pull dictionaries from your operating system automatically. However, on Windows they must be
-installed manually. See :ref:`a_custom_dict` for more details.
-
-
-.. _a_started_windows:
-
-Installing on Windows
-=====================
-
-You can install novelWriter with both Python and library dependencies embedded using the Windows
-Installer (setup.exe) file from the `Downloads page`_, or from the Releases_ page on GitHub_.
-Installing it should be straightforward.
-
-If you have any issues, try uninstalling the previous version and making a fresh install. If you
-already had a version installed via a different method, you should uninstall that first as having
-multiple installations has been known to cause problems.
-
-.. note::
-   The novelWriter installer is not signed because Microsoft doesn't currently provide a way for
-   non-profit open source projects to properly sign their installers. The novelWriter project
-   doesn't have the funding to pay for commercial software signing certificates. You will therefore
-   see an additional warning about this when you download the installer.
-
-
-.. _a_started_linux:
-
-Installing on Linux
-===================
-
-A Debian package can be downloaded from the `Downloads page`_, or from the Releases_ page on
-GitHub_. This package should work on both Debian, Ubuntu and Linux Mint, at least.
-
-If you prefer, you can also add the novelWriter repository on Launchpad to your package manager.
-
-
-Ubuntu
-------
-
-You can add the Ubuntu PPA_ and install novelWriter with the following commands.
-
-.. code-block:: bash
-
-   sudo add-apt-repository ppa:vkbo/novelwriter
-   sudo apt update
-   sudo apt install novelwriter
-
-If you want the `Pre-Release PPA`_ instead, add the ``ppa:vkbo/novelwriter-pre`` repository.
-
-
-Debian and Mint
----------------
-
-Since this is a pure Python package, the Launchpad PPA can in principle also be used on Debian or
-Mint. However, the above command will fail to add the signing key, as it is Ubuntu-specific.
-
-Instead, run the following commands to add the repository and key:
-
-.. code-block:: bash
-
-   sudo gpg --no-default-keyring --keyring /usr/share/keyrings/novelwriter-ppa-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys F19F1FCE50043114
-   echo "deb [signed-by=/usr/share/keyrings/novelwriter-ppa-keyring.gpg] http://ppa.launchpad.net/vkbo/novelwriter/ubuntu noble main" | sudo tee /etc/apt/sources.list.d/novelwriter.list
-
-Then run the update and install commands as for Ubuntu:
-
-.. code-block:: bash
-
-   sudo apt update
-   sudo apt install novelwriter
-
-.. note::
-   You may need to use the Ubuntu 20.04 (focal) packages for Debian 11 or earlier. The newer Ubuntu
-   packages use a different compression algorithm that may not be supported.
-
-.. tip::
-   If you get an error message like ``gpg: failed to create temporary file`` when importing the key
-   from the Ubuntu keyserver, try creating the folder it fails on, and import the key again:
-
-   .. code-block:: bash
-
-      sudo mkdir /root/.gnupg/
-
-
-AppImage Releases
------------------
-
-For other Linux distros than the ones mentioned above, the primary option is AppImage_. These are
-completely standalone images for the app that include the necessary environment to run novelWriter.
-They can of course be run on any Linux distro, if you prefer this to native packages.
-
-.. note::
-   novelWriter generally doesn't support Python versions that have reached end of life. If your
-   Linux distro still uses older Python versions and novelWriter won't run, you may want to try the
-   AppImage instead.
-
-
-.. _a_started_macos:
-
-Installing on MacOS
-===================
-
-You can install novelWriter with both its Python and library dependencies embedded using the DMG
-application image file from the `Downloads page`_, or from the Releases_ page on GitHub_.
-Installing it should be straightforward.
-
-* Download the DMG file and open it. Then drag the novelWriter icon to the :guilabel:`Applications`
-  folder on the right. This will install it into your :guilabel:`Applications`.
-* The first time you try to launch it, it will say that the bundle cannot be verified, simply press
-  the :guilabel:`Open` button to add an exception.
-* If you are not presented with an :guilabel:`Open` button in the dialog, launch the application
-  again by right clicking on the application in Finder and selecting :guilabel:`Open` from the
-  context menu.
-
-The context menu can also be accessed by option-clicking if you have a one button mouse. This is
-done by holding down the option key on your keyboard and clicking on the application in Finder.
-
-.. note::
-   The novelWriter DMG is not signed because Apple doesn't currently provide a way for non-profit
-   open source projects to properly sign their installers. The novelWriter project doesn't have the
-   funding to pay for commercial software signing certificates.
-
-
-.. _a_started_pip:
-
-Installing from PyPi
-====================
-
-novelWriter is also available on the Python Package Index, or PyPi_. This install method works on
-all supported operating systems with a suitable Python environment.
-
-To install from PyPi you must first have the ``python`` and ``pip`` commands available on your
-system. You can download Python from `python.org`_. It is recommended that you install the latest
-version. If you are on Windows, also make sure to select the "Add Python to PATH" option during
-installation.
-
-To install novelWriter from PyPi, use the following command:
-
-.. code-block:: bash
-
-   pip install novelwriter
-
-To upgrade an existing installation, use:
-
-.. code-block:: bash
-
-   pip install --upgrade novelwriter
-
-When installing via pip, novelWriter can be launched from command line with:
-
-.. code-block:: bash
-
-   novelwriter
-
-Make sure the install location for pip is in your PATH variable. This is not always the case by
-default, and then you may get a "Not Found" error when running the ``novelwriter`` command.

docs/source/locales/config.toml

@@ -0,0 +1,3 @@
+[fr]
+version = "2.7"
+authors = ["Jean-Michel Heras", "Veronica Berglyd Olsen"]

docs/source/locales/fr/LC_MESSAGES/features/dialogue.po

@@ -0,0 +1,223 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-28 22:09+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/features/dialogue.rst:5
+msgid "Dialogue Highlighting"
+msgstr "Mise en évidence du dialogue"
+
+#: ../../source/features/dialogue.rst:7
+msgid ""
+"Dialogue recognition and colour highlighting is available both while "
+"you're writing and in generated manuscript documents."
+msgstr ""
+"La reconnaissance des dialogues et le surlignage des couleurs sont "
+"disponibles à la fois pendant que vous écrivez et dans les documents "
+"manuscrits générés."
+
+#: ../../source/features/dialogue.rst:10
+msgid ""
+"The default language settings in UmbraEdit are for English. That "
+"includes the dialogue highlighting settings. But many dialogue styles "
+"are supported. You can tune a number of settings to fit your language "
+"and style preferences in the \"Text Highlighting\" section in "
+"**Preferences**. You can mix and match these settings."
+msgstr ""
+"Les paramètres linguistiques par défaut de UmbraEdit sont ceux de "
+"l'anglais. Cela inclut les paramètres de mise en évidence des dialogues. "
+"Mais de nombreux styles de dialogue sont pris en charge. Vous pouvez "
+"ajuster un certain nombre de paramètres en fonction de vos préférences "
+"linguistiques et stylistiques dans la section « Surlignage du texte » "
+"des **Préférences**. Vous pouvez combiner ces paramètres.\n"
+"\n"
+"Traduit avec DeepL.com (version gratuite)"
+
+#: ../../source/features/dialogue.rst:17
+msgid "The **Text Highlighting** section of **Preferences**."
+msgstr "La section **Mise en évidence du texte** des **Préférences**."
+
+#: ../../source/features/dialogue.rst:21
+msgid "Quoted Dialogue"
+msgstr "Dialogue entre guillemets"
+
+#: ../../source/features/dialogue.rst:23
+msgid ""
+"By default, dialogue highlighting is enabled for the double quote "
+"symbols you have defined in the **Quotation Style** section of "
+"**Preferences**."
+msgstr ""
+"Par défaut, la mise en évidence du dialogue est activée pour les "
+"symboles de guillemets doubles que vous avez définis dans la section "
+"**Style de guillemets** des **Préférences**."
+
+#: ../../source/features/dialogue.rst:28
+msgid "The **Quotation Style** section of **Preferences**."
+msgstr "La section **Style de guillemets** des **Préférences**."
+
+#: ../../source/features/dialogue.rst:30
+msgid ""
+"You can change which quote symbols are highlighted by selecting one of "
+"\"None\", \"Single\", \"Double\", or \"Both\" from the \"Highlight "
+"dialogue\" setting under **Text Highlighting**."
+msgstr ""
+"Vous pouvez modifier les symboles de guillemets mis en évidence en "
+"sélectionnant « Aucun », « Simple », « Double » ou « Les deux » dans le "
+"paramètre « Mettre les dialogues en évidence » sous **Surlignage du "
+"texte**."
+
+#: ../../source/features/dialogue.rst:33
+msgid ""
+"You can also enable or disable the \"Allow open-ended dialogue\" setting "
+"to allow for the style where multi-paragraph dialogue is not closed "
+"until the last paragraph."
+msgstr ""
+"Vous pouvez également activer ou désactiver le paramètre « Autoriser les "
+"dialogues ouverts » pour autoriser le style dans lequel les dialogues à "
+"plusieurs paragraphes ne sont pas clos avant le dernier paragraphe."
+
+#: ../../source/features/dialogue.rst:36
+msgid "Limitations"
+msgstr "Restrictions"
+
+#: ../../source/features/dialogue.rst:38
+msgid ""
+"Dialogue highlighting for single quotes is difficult to process when the "
+"same single quote symbol is also used for apostrophes. There isn't a "
+"good solution to this. Your best option in the cases where the "
+"highlighting is wrong is to insert an alternative apostrophe symbol "
+"instead. See :ref:`docs_more_typographical_symbols_apostrophe` for more "
+"details."
+msgstr ""
+"La mise en évidence du dialogue pour les guillemets simples est "
+"difficile à traiter lorsque le même symbole de guillemet simple est "
+"également utilisé pour les apostrophes. Il n'existe pas de bonne "
+"solution à ce problème. Votre meilleure option dans les cas où la mise "
+"en évidence est erronée est d'insérer un symbole d'apostrophe alternatif "
+"à la place. Voir :ref:`docs_more_typographical_symbols_apostrophe` pour "
+"plus de détails."
+
+#: ../../source/features/dialogue.rst:45
+msgid "Alternative Dialogue"
+msgstr "Dialogue alternatif"
+
+#: ../../source/features/dialogue.rst:47
+msgid ""
+"You can use the \"Alternative dialogue symbols\" setting for custom "
+"dialogue wrapper symbols. These are highlighted in a different colour "
+"than regular dialogue."
+msgstr ""
+"Vous pouvez utiliser le paramètre « Symboles de dialogue alternatifs » "
+"pour les symboles de dialogue personnalisés. Ceux-ci sont mis en "
+"évidence dans une couleur différente de celle des dialogues normaux."
+
+#: ../../source/features/dialogue.rst:50
+msgid ""
+"The intended use case here is if you use an alternative style to "
+"distinguish a different style of communication. The feature idea came "
+"from a science fiction series where mind-to-mind communication used a "
+"different quotation style."
+msgstr ""
+"Le cas d'utilisation prévu ici est celui où vous utilisez un style "
+"alternatif pour distinguer un style de communication différent. L'idée "
+"est venue d'une série de science-fiction dans laquelle la communication "
+"d'esprit à esprit utilisait un style de citation différent."
+
+#: ../../source/features/dialogue.rst:56
+msgid "Dialogue Line Symbols"
+msgstr "Symboles des lignes de dialogue"
+
+#: ../../source/features/dialogue.rst:58
+msgid ""
+"In some languages, a single symbol at the start of a paragraph can "
+"indicate that the whole paragraph is dialogue. For instance, this symbol "
+"can be a short dash (en dash)."
+msgstr ""
+"Dans certaines langues, un seul symbole au début d'un paragraphe peut "
+"indiquer que tout le paragraphe est un dialogue. Par exemple, ce symbole "
+"peut être un tiret demi-cadratin."
+
+#: ../../source/features/dialogue.rst:63
+msgid "An example of dialogue starting with a short dash."
+msgstr "Exemple de dialogue commençant par un tiret demi-cadratin."
+
+#: ../../source/features/dialogue.rst:65
+msgid ""
+"You can enable this feature by adding the symbols to the \"Dialogue line "
+"symbols\" setting. Multiple symbols are allowed."
+msgstr ""
+"Vous pouvez activer cette fonction en ajoutant les symboles au paramètre "
+"« Symboles de la ligne de dialogue ». Plusieurs symboles sont autorisés."
+
+#: ../../source/features/dialogue.rst:70
+msgid "Dialogue with Narrator Break"
+msgstr "Dialogue avec incise"
+
+#: ../../source/features/dialogue.rst:72
+msgid ""
+"The dialogue symbol setting will not detect if the dialogue ends in the "
+"paragraph. In some styles there is no way to actually indicate the "
+"switch from dialogue to narration; in others there are. These a narrator "
+"break symbols are usually dashes. You can select one of the supported "
+"dash symbols for narrator breaks. These can be used with any of the "
+"above dialogue recognition settings."
+msgstr ""
+"Le réglage du symbole de dialogue ne détecte pas si le dialogue se "
+"termine dans le paragraphe. Dans certains styles, il n'y a aucun moyen "
+"d'indiquer le passage du dialogue à la narration ; dans d'autres, il y "
+"en a un. Ces symboles de rupture avec le narrateur sont généralement des "
+"tirets. Vous pouvez sélectionner l'un des symboles de tirets pris en "
+"charge pour les ruptures de narration. Ces symboles peuvent être "
+"utilisés avec n'importe lequel des paramètres de reconnaissance de "
+"dialogue ci-dessus."
+
+#: ../../source/features/dialogue.rst:79
+msgid ""
+"An example of dialogue starting with a short dash and a long dash "
+"narrator break."
+msgstr ""
+"Exemple de dialogue commençant par un tiret demi-cadratin, une incise "
+"par un tiret cadratin."
+
+#: ../../source/features/dialogue.rst:83
+msgid "Alternating Dialogue and Narration"
+msgstr "Dialogue et narration alternés"
+
+#: ../../source/features/dialogue.rst:85
+msgid ""
+"The alternating dialogue and narration style is supported with the "
+"\"Alternating dialogue/narration symbol\" setting. It can be set to one "
+"of the supported dashes. This style will switch into dialogue mode when "
+"it first encounters the selected dash in a paragraph, and switch back "
+"out when it sees the next one, and so forth."
+msgstr ""
+"Le style de dialogue et de narration alternés est pris en charge par le "
+"paramètre « Symbole de dialogue/narration alternés ». Il peut être "
+"défini sur l'un des tirets pris en charge. Ce style passe en mode "
+"dialogue lorsqu'il rencontre pour la première fois le tiret sélectionné "
+"dans un paragraphe, et revient en mode dialogue lorsqu'il rencontre le "
+"tiret suivant, et ainsi de suite."
+
+#: ../../source/features/dialogue.rst:92
+msgid "An example of alternating dialogue and narration using a long dash."
+msgstr ""
+"Exemple d'alternance de dialogue et de narration à l'aide d'un tiret "
+"cadratin."

docs/source/locales/fr/LC_MESSAGES/features/shortcuts.po

@@ -0,0 +1,978 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-28 22:50+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/features/shortcuts.rst:5
+msgid "Keyboard Shortcuts"
+msgstr "Raccourcis clavier"
+
+#: ../../source/features/shortcuts.rst:7
+msgid ""
+"Most features in UmbraEdit are available as keyboard shortcuts. This "
+"is a reference list of those shortcuts. Most of them are also listed in "
+"the application's user interface."
+msgstr ""
+"La plupart des fonctionnalités de UmbraEdit sont disponibles sous "
+"forme de raccourcis clavier. Il s'agit d'une liste de référence de ces "
+"raccourcis. La plupart d'entre eux sont également listés dans "
+"l'interface utilisateur de l'application."
+
+#: ../../source/features/shortcuts.rst:12
+msgid "On MacOS, replace :kbd:`Ctrl` with :kbd:`Cmd`."
+msgstr "Sous MacOS, remplacez :kbd:`Ctrl` par :kbd:`Cmd`."
+
+#: ../../source/features/shortcuts.rst:16
+msgid "Main Window Shortcuts"
+msgstr "Raccourcis de la fenêtre principale"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Shortcut"
+msgstr "Raccourci"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Description"
+msgstr "Description"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F1`"
+msgstr ":kbd:`F1`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the online user manual"
+msgstr "Ouvrir le manuel d'utilisation en ligne"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F5`"
+msgstr ":kbd:`F5`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Build Manuscript** tool"
+msgstr "Ouvrir l'outil **Compiler le manuscrit**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F6`"
+msgstr ":kbd:`F6`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Writing Statistics** tool"
+msgstr "Ouvrir l'outil **Statistiques d'écriture**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F8`"
+msgstr ":kbd:`F8`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Toggle **Focus Mode**"
+msgstr "Basculer **Mode sans distraction**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F9`"
+msgstr ":kbd:`F9`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Re-build the project's index"
+msgstr "Reconstruire l'index du projet"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F11`"
+msgstr ":kbd:`F11`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Toggle full screen mode"
+msgstr "Basculer en mode plein écran"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+,`"
+msgstr ":kbd:`Ctrl+,`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Preferences** dialog"
+msgstr "Ouvrir la boîte de dialogue **Préférences**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+E`"
+msgstr ":kbd:`Ctrl+E`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Switch or toggle focus for the editor or viewer"
+msgstr ""
+"Changement ou basculement du focus de l'éditeur ou du visualisateur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+T`"
+msgstr ":kbd:`Ctrl+T`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Switch or toggle focus for the project tree or novel view"
+msgstr ""
+"Changement de focalisation de l'arborescence du projet ou de la vue du "
+"roman"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Q`"
+msgstr ":kbd:`Ctrl+Q`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Exit UmbraEdit"
+msgstr "Quitter UmbraEdit"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+,`"
+msgstr ":kbd:`Ctrl+Maj+,`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Project Settings** dialog"
+msgstr "Ouvrir la boîte de dialogue **Paramètres du projet**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+O`"
+msgstr ":kbd:`Ctrl+Maj+O`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the Welcome dialog to open or create a project"
+msgstr ""
+"Ouvrir la boîte de dialogue de bienvenue pour ouvrir ou créer un projet"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+S`"
+msgstr ":kbd:`Ctrl+Maj+S`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Save the current project"
+msgstr "Enregistrer le projet en cours"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+T`"
+msgstr ":kbd:`Ctrl+Maj+T`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Switch focus to the outline view"
+msgstr "Basculer vers la vue d'ensemble"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+W`"
+msgstr ":kbd:`Ctrl+Maj+W`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Close the current project"
+msgstr "Fermer le projet en cours"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Shift+F1`"
+msgstr ":kbd:`Maj+F1`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the local user manual (PDF) if it is available"
+msgstr "Ouvrir le manuel d'utilisation local (PDF) s'il est disponible"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Shift+F6`"
+msgstr ":kbd:`Maj+F6`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Project Details** dialog"
+msgstr "Ouvrir la boîte de dialogue **Détails du projet**"
+
+#: ../../source/features/shortcuts.rst:41
+msgid "Project Tree Shortcuts"
+msgstr "Raccourcis de l'arborescence du projet"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F2`"
+msgstr ":kbd:`F2`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Edit the label of the selected item"
+msgstr "Modifier le libellé de l'élément sélectionné"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Return`"
+msgstr ":kbd:`Retour`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the selected document in the editor"
+msgstr "Ouvrir le document sélectionné dans l'éditeur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Alt+Up`"
+msgstr ":kbd:`Alt+Haut`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Jump or go to the previous item at same level in the tree"
+msgstr ""
+"Sauter ou aller à l'élément précédent au même niveau dans 'l'arborescence"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Alt+Down`"
+msgstr ":kbd:`Alt+Bas`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Jump or go to the next item at same level in the tree"
+msgstr ""
+"Sauter ou aller à l'élément suivant au même niveau dans l'arborescence"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Alt+Left`"
+msgstr ":kbd:`Alt+Gauche`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Jump to the parent item in the tree"
+msgstr "Sauter à l'élément parent dans l'arborescence"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Alt+Right`"
+msgstr ":kbd:`Alt+Droite`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Jump to the first child item in the project tree"
+msgstr "Sauter au premier élément enfant dans l'arborescence du projet"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+.`"
+msgstr ":kbd:`Ctrl+.`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the context menu on the selected item"
+msgstr "Ouvrir le menu contextuel de l'élément sélectionné"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+L`"
+msgstr ":kbd:`Ctrl+L`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Quick Links** menu"
+msgstr "Ouvrir le menu **Liens rapides**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+N`"
+msgstr ":kbd:`Ctrl+N`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the **Create New Item** menu"
+msgstr "Ouvrir le menu **Créer un nouvel élément**"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+O`"
+msgstr ":kbd:`Ctrl+O`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+R`"
+msgstr ":kbd:`Ctrl+R`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the selected document in the viewer"
+msgstr "Ouvrir le document sélectionné dans le visualisateur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Up`"
+msgstr ":kbd:`Ctrl+Haut`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Move selected item one step up in the tree"
+msgstr "Déplacer l'élément sélectionné d'un cran dans l'arborescence"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Down`"
+msgstr ":kbd:`Ctrl+Bas`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Move selected item one step down in the tree"
+msgstr "Déplacer l'élément sélectionné d'un cran dans l'arborescence"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+Del`"
+msgstr ":kbd:`Ctrl+Maj+Suppr`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Move the selected item to Trash"
+msgstr "Déplacer l'élément sélectionné vers la corbeille"
+
+#: ../../source/features/shortcuts.rst:63
+msgid "Document Editor Shortcuts"
+msgstr "Raccourcis de l'éditeur de documents"
+
+#: ../../source/features/shortcuts.rst:67
+msgid "Text Search Shortcuts"
+msgstr "Raccourcis de recherche de texte"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F3`"
+msgstr ":kbd:`F3`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Find the next occurrence of the search word"
+msgstr "Trouver la prochaine occurrence du mot recherché"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+F`"
+msgstr ":kbd:`Ctrl+F`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open search and look for the selected word"
+msgstr "Ouvrir la recherche et rechercher le mot sélectionné"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+G`"
+msgstr ":kbd:`Ctrl+G`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+H`"
+msgstr ":kbd:`Ctrl+H`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open replace and look for the selected word (Mac :kbd:`Cmd+=`)"
+msgstr ""
+"Ouvrir remplacer et rechercher le mot sélectionné (Mac :kbd:`Cmd+=`)"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+1`"
+msgstr ":kbd:`Ctrl+Maj+1`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Replace selected occurrence, and move to the next"
+msgstr "Remplacer l'occurrence sélectionnée et passer à la suivante"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+G`"
+msgstr ":kbd:`Ctrl+Maj+G`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Find the previous occurrence of the search word"
+msgstr "Trouver l'occurrence précédente du mot recherché"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+F`"
+msgstr ":kbd:`Ctrl+Maj+F`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open project search and look for the selected word"
+msgstr "Ouvrir la recherche de projet et recherchez le mot sélectionné"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Shift+F3`"
+msgstr ":kbd:`Maj+F3`"
+
+#: ../../source/features/shortcuts.rst:83
+msgid "Text Formatting Shortcuts"
+msgstr "Raccourcis de mise en forme du texte"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+'`"
+msgstr ":kbd:`Ctrl+'`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Wrap selected text, or word under cursor, in single quotes"
+msgstr ""
+"Mettre le texte sélectionné, ou le mot sous le curseur, entre guillemets "
+"simples"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+\"`"
+msgstr ":kbd:`Ctrl+\"`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Wrap selected text, or word under cursor, in double quotes"
+msgstr ""
+"Mettre le texte sélectionné, ou le mot sous le curseur, entre guillemets"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+/`"
+msgstr ":kbd:`Ctrl+/`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Toggle comment format for block or selected text"
+msgstr ""
+"Modifier le format des commentaires pour le bloc ou le texte sélectionné"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+0`"
+msgstr ":kbd:`Ctrl+0`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Remove format for block or selected text"
+msgstr "Supprimer le format d'un bloc ou d'un texte sélectionné"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+1`"
+msgstr ":kbd:`Ctrl+1`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block format to heading level 1"
+msgstr "Modifier le format du bloc au niveau de titre 1"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+2`"
+msgstr ":kbd:`Ctrl+2`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block format to heading level 2"
+msgstr "Modifier le format du bloc en titre de niveau 2"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+3`"
+msgstr ":kbd:`Ctrl+3`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block format to heading level 3"
+msgstr "Modifier le format du bloc en titre de niveau 3"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+4`"
+msgstr ":kbd:`Ctrl+4`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block format to heading level 4"
+msgstr "Modifier le format du bloc en titre de niveau 4"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+5`"
+msgstr ":kbd:`Ctrl+5`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block alignment to left-aligned"
+msgstr "Aligner le bloc à gauche"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+6`"
+msgstr ":kbd:`Ctrl+6`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block alignment to centred"
+msgstr "Aligner le bloc au centre"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+7`"
+msgstr ":kbd:`Ctrl+7`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Change block alignment to right-aligned"
+msgstr "Aligner le bloc à droite"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+8`"
+msgstr ":kbd:`Ctrl+8`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Add a left margin to the block"
+msgstr "Ajouter une marge gauche au bloc"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+9`"
+msgstr ":kbd:`Ctrl+9`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Add a right margin to the block"
+msgstr "Ajouter une marge droite au bloc"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+B`"
+msgstr ":kbd:`Ctrl+B`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Format selected text, or word under cursor, with bold"
+msgstr "Formater le texte sélectionné, ou le mot sous le curseur, en gras"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+D`"
+msgstr ":kbd:`Ctrl+D`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Format selected text, or word under cursor, with strike through"
+msgstr ""
+"Formater le texte sélectionné, ou le mot sous le curseur, en le barrant"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+I`"
+msgstr ":kbd:`Ctrl+I`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Format selected text, or word under cursor, with italic"
+msgstr ""
+"Formater le texte sélectionné, ou le mot sous le curseur, avec de "
+"l'italique"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+/`"
+msgstr ":kbd:`Ctrl+Maj+/`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+D`"
+msgstr ":kbd:`Ctrl+Maj+D`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Toggle ignored text format for block or selected text"
+msgstr ""
+"Basculer le format de texte ignoré pour le bloc ou le texte sélectionné"
+
+#: ../../source/features/shortcuts.rst:109
+msgid "Other Editor Shortcuts"
+msgstr "Autres raccourcis de l'éditeur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`F7`"
+msgstr ":kbd:`F7`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Re-run the spell checker on the document"
+msgstr "Ré-exécuter le correcteur orthographique sur le document"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the context menu at the current cursor location"
+msgstr "Ouvrir le menu contextuel à l'emplacement actuel du curseur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+A`"
+msgstr ":kbd:`Ctrl+A`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Select all text in the document"
+msgstr "Sélectionner tout le texte dans le document"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+C`"
+msgstr ":kbd:`Ctrl+C`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Copy selected text to clipboard"
+msgstr "Copier le texte sélectionné dans le presse-papiers"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`"
+msgstr ":kbd:`Ctrl+K`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ""
+"Activate the insert commands (see list in :ref:"
+"`docs_features_shortcuts_insert`)"
+msgstr ""
+"Activer les commandes d'insertion (voir la liste dans :ref:"
+"`docs_features_shortcuts_insert`)"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open or reload the current document in the viewer"
+msgstr "Ouvrir ou recharger le document en cours dans le visualisateur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+S`"
+msgstr ":kbd:`Ctrl+S`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Save the current document"
+msgstr "Enregistrer le document en cours"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+V`"
+msgstr ":kbd:`Ctrl+V`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Paste text from clipboard to cursor position"
+msgstr "Coller le texte du presse-papiers à la position du curseur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+W`"
+msgstr ":kbd:`Ctrl+W`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Close the current document"
+msgstr "Fermer le document en cours"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+X`"
+msgstr ":kbd:`Ctrl+X`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Cut selected text to clipboard"
+msgstr "Couper le texte sélectionné dans le presse-papiers"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Y`"
+msgstr ":kbd:`Ctrl+Y`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Redo latest undo"
+msgstr "Rétablir la dernière annulation"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Z`"
+msgstr ":kbd:`Ctrl+Z`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Undo latest changes"
+msgstr "Annuler les dernières modifications"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Backspace`"
+msgstr ":kbd:`Ctrl+Retour arrière`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Delete the word before the cursor"
+msgstr "Supprimer le mot précédant le curseur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Del`"
+msgstr ":kbd:`Ctrl+Suppr`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Delete the word after the cursor"
+msgstr "Supprimer le mot après le curseur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+F7`"
+msgstr ":kbd:`Ctrl+F7`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Toggle spell checking"
+msgstr "Vérifier l'orthographe"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Return`"
+msgstr ":kbd:`Ctrl+Retour`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Open the tag or reference under the cursor in the viewer"
+msgstr ""
+"Ouvrir la balise ou la référence sous le curseur dans le visualiseur"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+A`"
+msgstr ":kbd:`Ctrl+Maj+A`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Select all text in the current paragraph"
+msgstr "Sélectionner tout le texte du paragraphe en cours"
+
+#: ../../source/features/shortcuts.rst:136
+msgid "Insert Shortcuts"
+msgstr "Raccourcis d'insertion"
+
+#: ../../source/features/shortcuts.rst:138
+msgid ""
+"A set of insert features are also available through shortcuts, but they "
+"require a double combination of key sequences. The insert feature is "
+"activated with :kbd:`Ctrl+K`, followed by a key or key combination for "
+"the inserted content."
+msgstr ""
+"Un ensemble de fonctions d'insertion sont également disponibles par le "
+"biais de raccourcis, mais elles nécessitent une double combinaison de "
+"séquences de touches. La fonction d'insertion est activée avec :kbd:"
+"`Ctrl+K`, suivi d'une touche ou d'une combinaison de touches pour le "
+"contenu inséré."
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Space`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Espace`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a non-breaking space"
+msgstr "Insérer un espace insécable"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`_`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`_`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a long dash (em dash)"
+msgstr "Insérer un tiret long"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`.`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`.`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert an ellipsis"
+msgstr "Insérer un point de suspension"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`'`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`'`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a modifier apostrophe"
+msgstr "Insérer une apostrophe"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`*`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`*`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a list bullet"
+msgstr "Insérer une puce de liste"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`%`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`%`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a per mille symbol"
+msgstr "Insérer un symbole pour mille"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`~`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`~`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a figure dash (same width as a number)"
+msgstr "Insérer un tiret (de la même largeur qu'un chiffre)"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`−`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`−`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a short dash (en dash)"
+msgstr "Insérer un tiret court"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`1`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`1`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a left single quote"
+msgstr "Insérer un guillemet simple gauche"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`2`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`2`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a right single quote"
+msgstr "Insérer un guillemet simple à droite"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`3`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`3`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a left double quote"
+msgstr "Insérer un double guillemet gauche"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`4`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`4`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a right double quote"
+msgstr "Insérer un double guillemet droit"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`C`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`C`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@char`` keyword"
+msgstr "Insérer un mot-clé ``@char``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`E`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`E`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert an ``@entity`` keyword"
+msgstr "Insérer un mot-clé ``@entity``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`F`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`F`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@focus`` keyword"
+msgstr "Insérer un mot-clé ``@focus``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`G`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`G`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@tag`` keyword"
+msgstr "Insérer un mot-clé ``@tag``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`H`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`H`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a short description comment"
+msgstr "Insérer un bref commentaire de description"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`L`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`L`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@location`` keyword"
+msgstr "Insérer un mot-clé ``@location``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`M`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`M`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@mention`` keyword"
+msgstr "Insérer un mot-clé ``@mention``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`O`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`O`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert an ``@object`` keyword"
+msgstr "Insérer un mot-clé ``@object``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`P`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`P`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@plot`` keyword"
+msgstr "Insérer un mot-clé `@plot``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`S`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`S`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a synopsis comment"
+msgstr "Insérer un commentaire de synopsis"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`T`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`T`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@time`` keyword"
+msgstr "Insérer un mot-clé ``@time``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`V`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`V`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@pov`` keyword"
+msgstr "Insérer un mot-clé ``@pov``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`X`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`X`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a ``@custom`` keyword"
+msgstr "Insérer un mot-clé ``@custom``"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+Space`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+Espace`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a thin non-breaking space"
+msgstr "Insérer un espace fin insécable"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+_`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+_`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a horizontal bar (quotation dash)"
+msgstr "Insérer une barre horizontale"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+'`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+'`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a prime"
+msgstr "Insérer une prime"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+\"`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+\"`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a double prime"
+msgstr "Insérer une double prime"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+*`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+*`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a flower mark (alternative bullet)"
+msgstr "Insérer une fleur (puce alternative)"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+−`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+−`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a hyphen bullet (alternative bullet)"
+msgstr "Insérer une puce à tiret (puce alternative)"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+D`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+D`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a division sign"
+msgstr "Insérer un signe de division"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+O`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+O`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a degree symbol"
+msgstr "Insérer un symbole de degré"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Ctrl+X`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Ctrl+X`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a times sign"
+msgstr "Insert a times sign"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+K`, :kbd:`Shift+Space`"
+msgstr ":kbd:`Ctrl+K`, :kbd:`Maj+Espace`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Insert a thin space"
+msgstr "Insérer un espace fin"
+
+#: ../../source/features/shortcuts.rst:183
+msgid "Document Viewer Shortcuts"
+msgstr "Raccourcis de la fenêtre de visualisation des documents"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Move backward in the view history"
+msgstr "Reculer dans l'historique des vues"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Move forward in the view history"
+msgstr "Avancer dans l'historique des vues"
+
+#: ../../source/features/shortcuts.rst:1
+msgid ":kbd:`Ctrl+Shift+R`"
+msgstr ":kbd:`Ctrl+Maj+R`"
+
+#: ../../source/features/shortcuts.rst:1
+msgid "Close the document viewer"
+msgstr "Fermer l'afficheur de documents"

docs/source/locales/fr/LC_MESSAGES/features/story_comments.po

@@ -0,0 +1,221 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-28 22:28+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/features/story_comments.rst:5
+msgid "Story Comments"
+msgstr "Commentaires sur l'histoire"
+
+#: ../../source/features/story_comments.rst:7
+msgid ""
+"A special set of comment styles allow for annotating your text with "
+"structure information. There are two styles of comments available. They "
+"are an extension to regular comments as described in :ref:"
+"`docs_usage_comments`."
+msgstr ""
+"Un ensemble spécial de styles de commentaires permet d'annoter votre "
+"texte avec des informations sur la structure. Deux styles de "
+"commentaires sont disponibles. Ils sont une extension des commentaires "
+"normaux tels que décrits dans :ref:`docs_usage_comments`."
+
+#: ../../source/features/story_comments.rst:15
+msgid "Story Structure Comments"
+msgstr "Commentaires sur la structure de l'histoire"
+
+#: ../../source/features/story_comments.rst:17
+msgid ""
+"You can annotate story structure by using the ``%Story`` style of "
+"comment. To use the feature, make the first word of a comment ``Story``, "
+"followed by a period, a structure term, a colon, a space and the text "
+"for that term."
+msgstr ""
+"Vous pouvez annoter la structure de l'histoire en utilisant le style de "
+"commentaire ``%Story``. Pour utiliser cette fonctionnalité, le premier "
+"mot du commentaire doit être ``Story``, suivi d'un point, d'un terme de "
+"structure, de deux points, d'un espace et du texte correspondant à ce "
+"terme."
+
+#: ../../source/features/story_comments.rst:23
+#: ../../source/features/story_comments.rst:88
+msgid "Usage"
+msgstr "Utilisation"
+
+#: ../../source/features/story_comments.rst:25
+msgid ""
+"The story term can be anything that you want to track in the manuscript. "
+"This construct is intended to make it easier to extract metadata from a "
+"work to perform a structural analysis of the story."
+msgstr ""
+"Le terme de l'histoire peut être n'importe quoi que vous voulez suivre "
+"dans le manuscrit. Cette construction est destinée à faciliter "
+"l'extraction des métadonnées d'une œuvre afin d'effectuer une analyse "
+"structurelle de l'histoire."
+
+#: ../../source/features/story_comments.rst:28
+msgid ""
+"There are probably as many ways to examine story structure as there are "
+"authors and editors combined. For this reason the story tag is flexible. "
+"You can use any terms you want and track any aspect of the story that "
+"serves your purposes."
+msgstr ""
+"Il y a probablement autant de façons d'examiner la structure d'une "
+"histoire qu'il y a d'auteurs et d'éditeurs réunis. C'est la raison pour "
+"laquelle l'étiquette « histoire » est flexible. Vous pouvez utiliser les "
+"termes de votre choix et suivre tous les aspects de l'histoire qui vous "
+"intéressent."
+
+#: ../../source/features/story_comments.rst:32
+msgid ""
+"An example method has been advanced by Shawn Coyne in *The Story Grid*. "
+"This method asserts that a story is composed of \"beats\", and that each "
+"beat has an inciting incident, a complication, a crisis, and a "
+"resolution. One might capture these elements of a beat where a character "
+"overcomes their fear of giving a speech as:"
+msgstr ""
+"Un exemple de méthode a été proposé par Shawn Coyne dans *The Story "
+"Grid*. Cette méthode affirme qu'une histoire est composée de « temps » "
+"et que chaque temps comporte un incident déclencheur, une complication, "
+"une crise et une résolution. On pourrait saisir les éléments d'un temps "
+"où un personnage surmonte sa peur de faire un discours comme suit :"
+
+#: ../../source/features/story_comments.rst:37
+#: ../../source/features/story_comments.rst:94
+msgid ":bdg-info:`Example`"
+msgstr ":bdg-info:`Exemple`"
+
+#: ../../source/features/story_comments.rst:50
+msgid ""
+"Other analytical models propose tracking a scene's pace, how it affects "
+"the mood of the story, or which element(s) of the story's genre are "
+"being satisfied. An author can use this mechanism to track any element "
+"of a scene. Some examples include time of day, how much time passes in "
+"the scene, or even the physical form of a shape-shifting character. If a "
+"story involves magic, one could track which wand a main character has in "
+"hand. It's up to tha author."
+msgstr ""
+"D'autres modèles analytiques proposent de suivre le rythme d'une scène, "
+"la façon dont il affecte l'ambiance de l'histoire ou les éléments du "
+"genre de l'histoire qui sont satisfaits. Un auteur peut utiliser ce "
+"mécanisme pour suivre n'importe quel élément d'une scène. Il peut "
+"s'agir, par exemple, de l'heure, du temps qui s'écoule dans la scène ou "
+"même de la forme physique d'un personnage qui change de forme. Si "
+"l'histoire fait appel à la magie, il est possible de savoir quelle "
+"baguette le personnage principal tient en main. C'est à l'auteur de "
+"décider."
+
+#: ../../source/features/story_comments.rst:56
+msgid ""
+"When the story and other scene metadata is extracted into a tabular "
+"form, it is possible to get a comprehensive overview of the story and to "
+"identify possible issues. For example, so many fast-paced scenes without "
+"a break that readers might become fatigued or over-stimulated."
+msgstr ""
+"Lorsque les métadonnées de l'histoire et d'autres scènes sont extraites "
+"sous forme de tableau, il est possible d'obtenir une vue d'ensemble de "
+"l'histoire et d'identifier les problèmes éventuels. Par exemple, un si "
+"grand nombre de scènes au rythme rapide, sans pause, que les lecteurs "
+"risquent de se fatiguer ou d'être trop stimulés."
+
+#: ../../source/features/story_comments.rst:62
+#: ../../source/features/story_comments.rst:106
+msgid "Output"
+msgstr "Production"
+
+#: ../../source/features/story_comments.rst:64
+msgid ""
+"The story structure comments can be included in the manuscript, and are "
+"formatted similarly to the synopsis comments:"
+msgstr ""
+"Les commentaires sur la structure de l'histoire peuvent être inclus dans "
+"le manuscrit et sont formatés de la même manière que les commentaires "
+"sur le synopsis :"
+
+#: ../../source/features/story_comments.rst:69
+msgid "A set of story structure comments as shown in the Manuscript tool."
+msgstr ""
+"Une série de commentaires sur la structure de l'histoire, tels qu'ils "
+"apparaissent dans l'outil Manuscrit."
+
+#: ../../source/features/story_comments.rst:71
+msgid ""
+"When you export your project data from the Outline View, all story "
+"structure terms are added as columns to the exported file, which can "
+"then be opened in the spread sheet software of your choice."
+msgstr ""
+"Lorsque vous exportez les données de votre projet à partir de la vue en "
+"plan, tous les termes de la structure du récit sont ajoutés en tant que "
+"colonnes au fichier exporté, qui peut ensuite être ouvert dans le "
+"logiciel de feuille de calcul de votre choix."
+
+#: ../../source/features/story_comments.rst:76
+msgid "Story Notes"
+msgstr "Notes sur l'histoire"
+
+#: ../../source/features/story_comments.rst:78
+msgid ""
+"Story notes are similar to story structure comments, but have no "
+"predefined meaning. Essentially they are a generalisation of the story "
+"structure comment, and the only point of having this additional format "
+"is to allow you do filter them in and out of your manuscript "
+"independently."
+msgstr ""
+"Les notes de récit sont similaires aux commentaires de structure de "
+"récit, mais n'ont pas de signification prédéfinie. Il s'agit "
+"essentiellement d'une généralisation du commentaire de structure, et le "
+"seul intérêt de ce format supplémentaire est de vous permettre de les "
+"filtrer dans et hors de votre manuscrit de manière indépendante."
+
+#: ../../source/features/story_comments.rst:82
+msgid ""
+"You can annotate story notes by using the ``%Note`` style of comment. To "
+"use the feature, make the first word of a comment ``Note``, followed by "
+"a period, a term, a colon, a space and the text for the note."
+msgstr ""
+"Vous pouvez annoter les notes d'articles en utilisant le style de "
+"commentaire ``%Note``. Pour utiliser cette fonctionnalité, le premier "
+"mot du commentaire doit être « Note », suivi d'un point, d'un terme, de "
+"deux points, d'un espace et du texte de la note."
+
+#: ../../source/features/story_comments.rst:90
+msgid ""
+"These notes are free form, but one intended use case is to add "
+"consistency annotations to your text to remind yourself where you have "
+"described something that must be checked against other parts of your "
+"text later on."
+msgstr ""
+"Ces notes sont libres, mais l'une des utilisations prévues est d'ajouter "
+"des annotations de cohérence à votre texte pour vous rappeler où vous "
+"avez décrit quelque chose qui doit être vérifié ultérieurement par "
+"rapport à d'autres parties de votre texte."
+
+#: ../../source/features/story_comments.rst:108
+msgid ""
+"Story notes are included in the manuscript in exactly the same way story "
+"structure comments are, but has a separate inclusion setting in the "
+"build settings. They are also included in CSV exports from the **Outline "
+"View**."
+msgstr ""
+"Les notes de récit sont incluses dans le manuscrit de la même manière "
+"que les commentaires sur la structure du récit, mais elles ont un "
+"paramètre d'inclusion distinct dans les paramètres de construction. "
+"Elles sont également incluses dans les exportations CSV à partir de la "
+"**Vue d'ensemble**."

docs/source/locales/fr/LC_MESSAGES/index.po

@@ -0,0 +1,120 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-27 20:56+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/index.rst:32
+msgid "More Documents"
+msgstr "Plus d'informations"
+
+#: ../../source/index.rst:38
+msgid "Getting Started"
+msgstr "Pour commencer"
+
+#: ../../source/index.rst:53
+msgid "The User Interface"
+msgstr "Interface utilisateur"
+
+#: ../../source/index.rst:64
+msgid "Other Features"
+msgstr "Autres fonctionnalités"
+
+#: ../../source/index.rst:72
+msgid "In-Depth Topics"
+msgstr "En détail"
+
+#: ../../source/index.rst:82
+msgid "Technical Topics"
+msgstr "Rubriques techniques"
+
+#: ../../source/index.rst:3
+msgid "User Guide"
+msgstr "Guide d'utilisation"
+
+#: ../../source/index.rst:5
+msgid "**Release Version:** |release|"
+msgstr "**Version :** |release|"
+
+#: ../../source/index.rst:6
+msgid "**Updated:** |today|"
+msgstr "**Mise à jour :** |today|"
+
+#: ../../source/index.rst:8
+msgid ""
+"UmbraEdit is an open source plain text editor designed for writing "
+"novels assembled from individual text documents. It uses a minimal "
+"formatting syntax inspired by Markdown, and adds a meta data syntax for "
+"comments, synopsis, and cross-referencing. It is designed to be a simple "
+"text editor that allows for easy organisation of text and notes, using "
+"human readable text files as storage for robustness."
+msgstr ""
+"UmbraEdit est un éditeur de texte brut open source conçu pour écrire "
+"des romans assemblés à partir de documents texte individuels. Il utilise "
+"une syntaxe de formatage minimale inspirée de Markdown, et ajoute une "
+"syntaxe de métadonnées pour les commentaires, les synopsis et les "
+"références croisées. Il est conçu pour être un éditeur de texte simple "
+"qui permet d'organiser facilement le texte et les notes, en utilisant des "
+"fichiers texte lisibles par l'homme comme stockage pour plus de "
+"robustesse."
+
+#: ../../source/index.rst:19
+msgid "**Useful Links**"
+msgstr "**Liens utiles**"
+
+#: ../../source/index.rst:21
+msgid "Website: https://umbraedit.io"
+msgstr "Site web : https://umbraedit.io"
+
+#: ../../source/index.rst:22
+msgid "Documentation: https://docs.umbraedit.io"
+msgstr "Documentation: https://docs.umbraedit.io"
+
+#: ../../source/index.rst:23
+msgid "Public Releases: https://releases.umbraedit.io"
+msgstr "Public Releases: https://releases.umbraedit.io"
+
+#: ../../source/index.rst:24
+msgid "Internationalisation: https://crowdin.com/project/umbraedit"
+msgstr "Internationalisation: https://crowdin.com/project/umbraedit"
+
+#: ../../source/index.rst:25
+msgid "Source Code: https://github.com/saga-soft/UmbraEdit"
+msgstr "Code source : https://github.com/saga-soft/UmbraEdit"
+
+#: ../../source/index.rst:26
+msgid "Source Releases: https://github.com/saga-soft/UmbraEdit/releases"
+msgstr "Source Releases: https://github.com/saga-soft/UmbraEdit/releases"
+
+#: ../../source/index.rst:27
+msgid "Issue Tracker: https://github.com/saga-soft/UmbraEdit/issues"
+msgstr "Issue Tracker: https://github.com/saga-soft/UmbraEdit/issues"
+
+#: ../../source/index.rst:28
+msgid "Feature Discussions: https://github.com/saga-soft/UmbraEdit/discussions"
+msgstr "Feature Discussions: https://github.com/saga-soft/UmbraEdit/discussions"
+
+#: ../../source/index.rst:29
+msgid "PyPi Project: https://pypi.org/project/UmbraEdit"
+msgstr "PyPi Project: https://pypi.org/project/UmbraEdit"
+
+#: ../../source/index.rst:30
+msgid "Social Media: https://fosstodon.org/@umbraedit"
+msgstr "Social Media: https://fosstodon.org/@umbraedit"

docs/source/locales/fr/LC_MESSAGES/more/counting.po

@@ -0,0 +1,321 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-28 23:00+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/more/counting.rst:5
+msgid "Word and Text Counts"
+msgstr "Décompte des mots et des textes"
+
+#: ../../source/more/counting.rst:7
+msgid ""
+"This is an overview of how words and other counts of your text are performed. "
+"The counting rules should be relatively standard, and are comparable to Libre "
+"Office Writer rules."
+msgstr ""
+"Il s'agit d'une vue d'ensemble de la manière dont les mots et autres comptages "
+"de votre texte sont effectués. Les règles de comptage devraient être "
+"relativement standard, et sont comparables aux règles de Libre Office Writer."
+
+#: ../../source/more/counting.rst:10
+msgid ""
+"The counts provided in the app on the raw text are meant to be approximate. For "
+"more accurate counts, you need to build your manuscript in the **Manuscript "
+"Tool** and check the counts on the generated preview."
+msgstr ""
+"Les décomptes fournis dans l'application sur le texte brut sont approximatifs. "
+"Pour des décomptes plus précis, vous devez compiler votre manuscrit avec "
+"**Compiler le manuscrit** et vérifier les décomptes sur l'aperçu généré."
+
+#: ../../source/more/counting.rst:16
+msgid "Text Word Counts and Stats"
+msgstr "Décompte des mots du texte et statistiques"
+
+#: ../../source/more/counting.rst:18
+msgid ""
+"These are the rules for the main counts available for for each document in a "
+"project."
+msgstr ""
+"Il s'agit des règles relatives aux principaux décomptes disponibles pour chaque "
+"document d'un projet."
+
+#: ../../source/more/counting.rst:20
+msgid "For all counts, the following rules apply."
+msgstr "Pour tous les décomptes, les règles suivantes s'appliquent."
+
+#: ../../source/more/counting.rst:22 ../../source/more/counting.rst:56
+msgid "Short (–) and long (—) dashes are considered word separators."
+msgstr ""
+"Les tirets demi-cadratin (–) et cadratin (—) sont considérés comme des "
+"séparateurs de mots."
+
+#: ../../source/more/counting.rst:23
+msgid "Any line starting with ``%`` or ``@`` is ignored."
+msgstr "Toute ligne commençant par ``%`` ou ``@`` est ignorée."
+
+#: ../../source/more/counting.rst:24
+msgid "Trailing white spaces are ignored, including line breaks."
+msgstr ""
+"Les espaces blancs de fin de ligne sont ignorés, y compris les sauts de ligne."
+
+#: ../../source/more/counting.rst:25
+msgid "Leading ``>`` and trailing ``<`` are ignored with any spaces next to them."
+msgstr ""
+"Les ``>`` de début et les ``<`` de fin sont ignorés, de même que les espaces "
+"qui les accompagnent."
+
+#: ../../source/more/counting.rst:26
+msgid ""
+"Valid shortcodes and other commands wrapped in brackets ``[]`` are ignored."
+msgstr ""
+"Les shortcodes valides et les autres commandes entre crochets ``[]`` sont "
+"ignorés."
+
+#: ../../source/more/counting.rst:27
+msgid "In-line Markdown syntax in text paragraphs is treated as part of the text."
+msgstr ""
+"La syntaxe Markdown en ligne dans les paragraphes de texte est traitée comme "
+"faisant partie du texte."
+
+#: ../../source/more/counting.rst:29
+msgid ""
+"After the above preparation of the text, the following counts are available."
+msgstr "Après la préparation du texte, les chiffres suivants sont disponibles."
+
+#: ../../source/more/counting.rst:31
+msgid "**Character Count**"
+msgstr "**Décompte des caractères**"
+
+#: ../../source/more/counting.rst:32
+msgid ""
+"The character count is the sum of characters per line, including leading and in-"
+"text white space characters, but excluding trailing white space characters. "
+"Shortcodes in the text are not included, but Markdown codes are. Only headings "
+"and text are counted."
+msgstr ""
+"Le nombre de caractères est la somme des caractères par ligne, y compris les "
+"caractères d'en-tête et les caractères d'espacement dans le texte, mais pas les "
+"caractères d'espacement de fin. Les Shortcodes dans le texte ne sont pas "
+"inclus, mais les codes Markdown le sont. Seuls les en-têtes et le texte sont "
+"pris en compte."
+
+#: ../../source/more/counting.rst:36
+msgid "**Word Count**"
+msgstr "**Décompte des mots**"
+
+#: ../../source/more/counting.rst:37
+msgid ""
+"The words count is the sum of blocks of continuous character per line separated "
+"by any number of white space characters or dashes. Only headings and text are "
+"counted."
+msgstr ""
+"Le nombre de mots est la somme des blocs de caractères continus par ligne, "
+"séparés par un nombre quelconque de caractères d'espacement ou de tirets. Seuls "
+"les titres et le texte sont comptés."
+
+#: ../../source/more/counting.rst:40
+msgid "**Paragraph Count**"
+msgstr "**Décompte des paragraphes**"
+
+#: ../../source/more/counting.rst:41
+msgid ""
+"The paragraph count is the number of text blocks separated by one or more empty "
+"line. A line consisting only of white spaces is considered empty."
+msgstr ""
+"Le nombre de paragraphes est le nombre de blocs de texte séparés par une ou "
+"plusieurs lignes vides. Une ligne constituée uniquement d'espaces blancs est "
+"considérée comme vide."
+
+#: ../../source/more/counting.rst:46
+msgid "Manuscript Counts"
+msgstr "Décompte du manuscrit"
+
+#: ../../source/more/counting.rst:48
+msgid ""
+"These are the rules for the counts available for a manuscript in the "
+"**Manuscript Tool**. The rules have been tuned to agree with LibreOffice "
+"Writer, but will vary slightly depending on the content of your text. "
+"LibreOffice Writer also counts the text in the page header, which the "
+"**Manuscript Tool** does not."
+msgstr ""
+"Voici les règles pour les décomptes disponibles pour un manuscrit dans l'outil "
+"**Outil Manuscrit**. Les règles ont été ajustées pour correspondre à "
+"LibreOffice Writer, mais varieront légèrement en fonction du contenu de votre "
+"texte. LibreOffice Writer compte également le texte dans l'en-tête de la page, "
+"ce que ne fait pas l'outil **Outil Manuscrit**."
+
+#: ../../source/more/counting.rst:53
+msgid ""
+"The content of each line is counted after all formatting has been processed, so "
+"the result will be more accurate than the counts for text documents elsewhere "
+"in the app. The following rules apply:"
+msgstr ""
+"Le contenu de chaque ligne est compté après le traitement de toutes les mises "
+"en forme, de sorte que le résultat sera plus précis que les décomptes pour les "
+"documents textuels dans d'autres parties de l'application. Les règles suivantes "
+"s'appliquent :"
+
+#: ../../source/more/counting.rst:57
+msgid ""
+"Leading and trailing white spaces are generally included, but paragraph breaks "
+"are not."
+msgstr ""
+"Les espaces blancs de début et de fin sont généralement inclus, mais les sauts "
+"de paragraphe ne le sont pas."
+
+#: ../../source/more/counting.rst:58
+msgid "Hard line breaks within paragraph are considered white space characters."
+msgstr ""
+"Les retours à la ligne dans un paragraphe sont considérés comme des caractères "
+"d'espacement."
+
+#: ../../source/more/counting.rst:59
+msgid ""
+"All formatting codes are ignored, including shortcodes, commands and Markdown."
+msgstr ""
+"Tous les codes de formatage sont ignorés, y compris les shortcodes, les "
+"commandes et Markdown."
+
+#: ../../source/more/counting.rst:60
+msgid "Scene and section separators are counted."
+msgstr "Les séparateurs de scène et de section sont pris en compte."
+
+#: ../../source/more/counting.rst:61
+msgid "Comments and meta data lines are counted after they are formatted."
+msgstr ""
+"Les lignes de commentaires et de métadonnées sont comptées après leur mise en "
+"forme."
+
+#: ../../source/more/counting.rst:62
+msgid "Headers are counted after they are formatted with custom formats."
+msgstr ""
+"Les en-têtes sont comptés après avoir été formatés avec des formats "
+"personnalisés."
+
+#: ../../source/more/counting.rst:64
+msgid "The following counts are available:"
+msgstr "Les décomptes suivants sont disponibles :"
+
+#: ../../source/more/counting.rst:66
+msgid "**Headings**"
+msgstr "**En-têtes**"
+
+#: ../../source/more/counting.rst:67
+msgid "The number of headings in the manuscript."
+msgstr "Le nombre d'entêtes dans le manuscrit."
+
+#: ../../source/more/counting.rst:69
+msgid "**Paragraphs**"
+msgstr "**Paragraphes**"
+
+#: ../../source/more/counting.rst:70
+msgid "The number of body text paragraphs in the manuscript."
+msgstr "Le nombre de paragraphes dans le manuscrit."
+
+#: ../../source/more/counting.rst:72
+msgid "**Words**"
+msgstr "**Mots**"
+
+#: ../../source/more/counting.rst:73
+msgid ""
+"The number of words in the manuscript, including any comments and meta data "
+"text."
+msgstr ""
+"Le nombre de mots du manuscrit, y compris les commentaires et les métadonnées."
+
+#: ../../source/more/counting.rst:75
+msgid "**Words in Text**"
+msgstr "**Mots dans le texte**"
+
+#: ../../source/more/counting.rst:76
+msgid "The number of words in body text paragraphs, excluding all other text."
+msgstr "Nombre de mots dans les paragraphes, à l'exclusion de tout autre texte."
+
+#: ../../source/more/counting.rst:78
+msgid "**Words in Headings**"
+msgstr "**Mots dans les entêtes**"
+
+#: ../../source/more/counting.rst:79
+msgid ""
+"The number of words in headings, including inserted formatting like chapter "
+"numbers, etc."
+msgstr ""
+"Le nombre de mots dans les entêtes, y compris le formatage inséré comme les "
+"numéros de chapitre, etc."
+
+#: ../../source/more/counting.rst:81
+msgid "**Characters**"
+msgstr "**Caractères**"
+
+#: ../../source/more/counting.rst:82
+msgid ""
+"The number of characters in all lines, including any comments and meta data "
+"text. Paragraph breaks are not counted, but in-paragraph hard line breaks are."
+msgstr ""
+"Le nombre de caractères de toutes les lignes, y compris les commentaires et le "
+"texte des métadonnées. Les sauts de paragraphe ne sont pas comptés, mais les "
+"sauts de ligne dans les paragraphes le sont."
+
+#: ../../source/more/counting.rst:85
+msgid "**Character in Text**"
+msgstr "**Caractères dans le texte**"
+
+#: ../../source/more/counting.rst:86
+msgid ""
+"The number of characters in body text paragraphs. Paragraph breaks are not "
+"counted, but in-paragraph hard line breaks are."
+msgstr ""
+"Nombre de caractères dans les paragraphes. Les sauts de paragraphe ne sont pas "
+"comptés, mais les sauts de ligne dans les paragraphes le sont."
+
+#: ../../source/more/counting.rst:89
+msgid "**Characters in Headings**"
+msgstr "**Caractères dans les entêtes**"
+
+#: ../../source/more/counting.rst:90
+msgid "The number of characters in headings."
+msgstr "Le nombre de caractères dans les en-têtes."
+
+#: ../../source/more/counting.rst:92
+msgid "**Character in Text, No Spaces**"
+msgstr "**Caractères dans le texte, sans les espaces**"
+
+#: ../../source/more/counting.rst:93
+msgid ""
+"The number of characters in body text paragraphs considered part of a word or "
+"punctuation. That is, white space characters are not counted."
+msgstr ""
+"Le nombre de caractères dans les paragraphes considérés comme faisant partie "
+"d'un mot ou d'une ponctuation. En d'autres termes, les caractères d'espacement "
+"ne sont pas pris en compte."
+
+#: ../../source/more/counting.rst:96
+msgid "**Character in Headings, No Spaces**"
+msgstr "**Caractères dans les en-têtes, sans les espaces**"
+
+#: ../../source/more/counting.rst:97
+msgid ""
+"The number of characters in headings considered part of a word or punctuation. "
+"That is, white space characters are not counted."
+msgstr ""
+"Le nombre de caractères dans les en-têtes considérés comme faisant partie d'un "
+"mot ou de la ponctuation. En d'autres termes, les caractères d'espacement ne "
+"sont pas pris en compte."

docs/source/locales/fr/LC_MESSAGES/more/customise.po

@@ -0,0 +1,359 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-29 11:05+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/more/customise.rst:5
+msgid "Customisations"
+msgstr "Personnalisations"
+
+#: ../../source/more/customise.rst:10
+msgid ""
+"There are a few ways you can customise UmbraEdit yourself. Currently, "
+"you can add new GUI themes, your own syntax themes, and install additional "
+"dictionaries."
+msgstr ""
+"Vous pouvez personnaliser UmbraEdit de plusieurs façons. Actuellement, "
+"vous pouvez ajouter de nouveaux thèmes d'interface graphique, vos propres "
+"thèmes de syntaxe et installer des dictionnaires supplémentaires."
+
+#: ../../source/more/customise.rst:17
+msgid "Spell Check Dictionaries"
+msgstr "Dictionnaires de vérification orthographique"
+
+#: ../../source/more/customise.rst:19
+msgid ""
+"UmbraEdit uses Enchant_ as the spell checking tool. Depending on your "
+"operating system, it may or may not load all installed spell check "
+"dictionaries automatically."
+msgstr ""
+"UmbraEdit utilise Enchant_ comme outil de vérification orthographique. "
+"Selon votre système d'exploitation, il peut ou non charger automatiquement "
+"tous les dictionnaires de vérification orthographique installés."
+
+#: ../../source/more/customise.rst:24
+msgid "Linux and MacOS"
+msgstr "Linux et MacOS"
+
+#: ../../source/more/customise.rst:26
+msgid ""
+"On Linux and MacOS, you generally only have to install hunspell, aspell or "
+"myspell dictionaries on your system like you do for other applications. "
+"See your distro or OS documentation for how to do this. These dictionaries "
+"should show up as available spell check languages in UmbraEdit."
+msgstr ""
+"Sous Linux et MacOS, il vous suffit généralement d'installer les "
+"dictionnaires hunspell, aspell ou myspell sur votre système, comme vous le "
+"faites pour d'autres applications. Consultez la documentation de votre "
+"distro ou de votre système d'exploitation pour savoir comment procéder. "
+"Ces dictionnaires devraient apparaître comme des langues de vérification "
+"orthographique disponibles dans UmbraEdit."
+
+#: ../../source/more/customise.rst:32
+msgid "Windows"
+msgstr "Windows"
+
+#: ../../source/more/customise.rst:34
+msgid ""
+"For Windows, English is included with the installation. For other "
+"languages you have to download and add dictionaries yourself."
+msgstr ""
+"Pour Windows, l'anglais est inclus dans l'installation. Pour les autres "
+"langues, vous devez télécharger et ajouter les dictionnaires vous-même."
+
+#: ../../source/more/customise.rst:37
+msgid "**Install Tool**"
+msgstr "**Outil d'installation**"
+
+#: ../../source/more/customise.rst:39
+msgid ""
+"A small tool to assist with this can be found under **Tools > Add "
+"Dictionaries**. It will import spell checking dictionaries from Free "
+"Office or Libre Office extensions. The dictionaries are then installed in "
+"the install location for the Enchant library and should thus work for any "
+"application that uses Enchant for spell checking."
+msgstr ""
+"Un petit outil pour vous aider se trouve sous **Outils > Ajouter des "
+"dictionnaires**. Il importera des dictionnaires de vérification "
+"orthographique à partir des extensions Free Office ou Libre Office. Les "
+"dictionnaires sont alors installés dans l'emplacement d'installation de la "
+"bibliothèque Enchant et devraient donc fonctionner pour toute application "
+"qui utilise Enchant pour la vérification orthographique."
+
+#: ../../source/more/customise.rst:44
+msgid "**Manual Install**"
+msgstr "**Installation manuelle**"
+
+#: ../../source/more/customise.rst:46
+msgid ""
+"If you prefer to do this manually or want to use a different source than "
+"the ones mentioned above, You need to get compatible dictionary files for "
+"your language. You need two files files ending with ``.aff`` and ``.dic``. "
+"These files must then be copied to the following location:"
+msgstr ""
+"Si vous préférez le faire manuellement ou si vous voulez utiliser une "
+"source différente de celles mentionnées ci-dessus, vous devez obtenir des "
+"fichiers de dictionnaires compatibles avec votre langue. Vous avez besoin "
+"de deux fichiers se terminant par ``.aff`` et ``.dic``. Ces fichiers "
+"doivent ensuite être copiés à l'emplacement suivant :"
+
+#: ../../source/more/customise.rst:50
+msgid "``C:\\Users\\<USER>\\AppData\\Local\\enchant\\hunspell``"
+msgstr "``C:\\Users\\<USER>\\AppData\\Local\\enchant\\hunspell``"
+
+#: ../../source/more/customise.rst:52
+msgid ""
+"This assumes your user profile is stored at ``C:\\Users\\<USER>``. The "
+"last one or two folders may not exist, so you may need to create them."
+msgstr ""
+"Cela suppose que votre profil d'utilisateur est stocké dans ``C:"
+"\\Users\\<USER>``. Le dernier ou les deux derniers dossiers peuvent ne pas "
+"exister, vous devrez donc les créer."
+
+#: ../../source/more/customise.rst:55
+msgid "You can find the various dictionaries on the `Free Desktop`_ website."
+msgstr ""
+"Vous pouvez trouver les différents dictionnaires sur le site web `Free "
+"Desktop`_."
+
+#: ../../source/more/customise.rst:58
+msgid ""
+"The Free Desktop link points to a repository, and what may look like file "
+"links inside the dictionary folder are actually links to web pages. If you "
+"right-click and download those, you get HTML files, not dictionaries!"
+msgstr ""
+"Le lien Free Desktop pointe vers un référentiel, et ce qui peut ressembler "
+"à des liens de fichiers à l'intérieur du dossier du dictionnaire sont en "
+"fait des liens vers des pages web. Si vous cliquez avec le bouton droit de "
+"la souris et que vous les téléchargez, vous obtiendrez des fichiers HTML, "
+"pas des dictionnaires !"
+
+#: ../../source/more/customise.rst:62
+msgid ""
+"In order to download the actual dictionary files, right-click the "
+"\"plain\" label at the end of each line and download that."
+msgstr ""
+"Pour télécharger les fichiers du dictionnaire, cliquez avec le bouton "
+"droit de la souris sur l'étiquette « plain » à la fin de chaque ligne et "
+"téléchargez-la."
+
+#: ../../source/more/customise.rst:69
+msgid "Syntax and GUI Themes"
+msgstr "Syntaxe et thèmes de l'interface graphique"
+
+#: ../../source/more/customise.rst:71
+msgid ""
+"Adding your own GUI and syntax themes is relatively easy, although it "
+"requires that you manually edit config files with colour values. The "
+"themes are defined by simple plain text config files with meta data and "
+"colour settings."
+msgstr ""
+"L'ajout de vos propres thèmes d'interface graphique et de syntaxe est "
+"relativement facile, bien qu'il soit nécessaire d'éditer manuellement les "
+"fichiers de configuration avec les valeurs de couleur. Les thèmes sont "
+"définis par de simples fichiers de configuration en texte brut contenant "
+"des métadonnées et des paramètres de couleur."
+
+#: ../../source/more/customise.rst:75
+msgid ""
+"In order to make your own versions, first copy one of the existing files "
+"to your local computer and modify it as you like."
+msgstr ""
+"Pour créer vos propres versions, copiez d'abord l'un des fichiers "
+"existants sur votre ordinateur local et modifiez-le à votre guise."
+
+#: ../../source/more/customise.rst:78
+msgid ""
+"The existing syntax themes are stored in `umbraedit/assets/syntax "
+"<https://github.com/saga-soft/UmbraEdit/tree/main/umbraedit/assets/"
+"syntax>`_."
+msgstr ""
+"Les thèmes syntaxiques existants sont stockés dans `umbraedit/assets/"
+"syntax <https://github.com/saga-soft/UmbraEdit/tree/main/umbraedit/assets/"
+"syntax>`_."
+
+#: ../../source/more/customise.rst:80
+msgid ""
+"The existing GUI themes are stored in `umbraedit/assets/themes <https://"
+"github.com/saga-soft/UmbraEdit/tree/main/umbraedit/assets/themes>`_."
+msgstr ""
+"Les thèmes GUI existants sont stockés dans `umbraedit/assets/themes "
+"<https://github.com/saga-soft/UmbraEdit/tree/main/umbraedit/assets/"
+"themes>`_."
+
+#: ../../source/more/customise.rst:82
+msgid ""
+"The existing icon themes are stored in `umbraedit/assets/icons <https://"
+"github.com/saga-soft/UmbraEdit/tree/main/umbraedit/assets/icons>`_."
+msgstr ""
+"Les thèmes d'icônes existants sont stockés dans `umbraedit/assets/icons "
+"<https://github.com/saga-soft/UmbraEdit/tree/main/umbraedit/assets/icons>`_."
+
+#: ../../source/more/customise.rst:85
+msgid ""
+"Remember to also change the name of your theme by modifying the ``name`` "
+"setting at the top of the file, otherwise you may not be able to "
+"distinguish them in **Preferences**."
+msgstr ""
+"N'oubliez pas de changer également le nom de votre thème en modifiant le "
+"paramètre ``name`` en haut du fichier, sinon vous ne pourrez pas les "
+"distinguer dans les **Préférences**."
+
+#: ../../source/more/customise.rst:88
+msgid ""
+"For UmbraEdit to be able to locate the custom theme files, you must copy "
+"them to the :ref:`docs_technical_locations_data` location in your home or "
+"user area. There should be a folder there named ``syntax`` for syntax "
+"themes, just ``themes`` for GUI themes, and ``icons`` for icon themes. "
+"These folders are created the first time you start UmbraEdit."
+msgstr ""
+"Pour que UmbraEdit puisse localiser les fichiers de thèmes "
+"personnalisés, vous devez les copier dans l'emplacement :ref:"
+"`docs_technical_locations_data` dans votre espace personnel ou "
+"utilisateur. Il devrait y avoir un dossier nommé ``syntax`` pour les "
+"thèmes de syntaxe, juste ``themes`` pour les thèmes GUI, et ``icons`` pour "
+"les thèmes d'icônes. Ces dossiers sont créés la première fois que vous "
+"démarrez UmbraEdit.\n"
+"\n"
+"Traduit avec DeepL.com (version gratuite)"
+
+#: ../../source/more/customise.rst:93
+msgid ""
+"Once the files are copied there, they should show up in **Preferences** "
+"with the label you set as ``name`` inside the file."
+msgstr ""
+"Une fois les fichiers copiés, ils devraient apparaître dans les "
+"**Préférences** avec le nom que vous avez défini dans le fichier."
+
+#: ../../source/more/customise.rst:98
+msgid ""
+"The theme file formats change regularly in new releases. It is up to you "
+"to keep custom theme files up to date."
+msgstr ""
+"Les formats des fichiers de thème changent régulièrement dans les "
+"nouvelles versions. C'est à vous qu'il incombe de mettre à jour les "
+"fichiers des thèmes personnalisés."
+
+#: ../../source/more/customise.rst:103
+msgid "Custom GUI and Icons Theme"
+msgstr "Thème d'interface graphique et d'icônes personnalisé"
+
+#: ../../source/more/customise.rst:105
+msgid "A GUI theme ``.conf`` file consists of the following settings:"
+msgstr ""
+"Le fichier ``.conf`` d'un thème GUI est constitué des paramètres suivants :"
+
+#: ../../source/more/customise.rst:159
+msgid "In the Main section you must at least define the ``name`` settings."
+msgstr ""
+"Dans la section Main, vous devez au moins définir les paramètres ``name``."
+
+#: ../../source/more/customise.rst:161
+msgid ""
+"The Palette values correspond to the Qt enum values for ``QPalette::"
+"ColorRole``, see the `Qt documentation <https://doc.qt.io/qt-6/qpalette."
+"html#ColorRole-enum>`_ for more details. The colour values are RGB numbers "
+"on the format ``r, g, b`` where each is an integer from ``0`` to ``255``. "
+"Omitted values are not loaded and will use default values. If the "
+"``helptext`` colour is not defined, it is computed as a colour between the "
+"``window`` and ``windowtext`` colour. Additional shades of some of the "
+"colours are also computed. These are mainly used for 3D effects."
+msgstr ""
+"Les valeurs de la palette correspondent aux valeurs de l'enum Qt pour "
+"``QPalette::ColorRole``, voir la documentation Qt <https://doc.qt.io/qt-6/"
+"qpalette.html#ColorRole-enum>`_ pour plus de détails. Les valeurs de "
+"couleur sont des nombres RVB au format ``r, g, b`` où chacun est un entier "
+"de ``0`` à ``255``. Les valeurs omises ne sont pas chargées et utilisent "
+"les valeurs par défaut. Si la couleur ``helptext`` n'est pas définie, elle "
+"est calculée comme une couleur comprise entre les couleurs ``window`` et "
+"``windowtext``. Des nuances supplémentaires de certaines couleurs sont "
+"également calculées. Elles sont principalement utilisées pour les effets "
+"3D."
+
+#: ../../source/more/customise.rst:168
+msgid "The ``fadedtext`` and ``errortext`` theme colour entries were added."
+msgstr ""
+"Les entrées de couleur des thèmes ``fadedtext`` et ``errortext`` ont été "
+"ajoutées."
+
+#: ../../source/more/customise.rst:171
+msgid ""
+"The ``icontheme`` setting was dropped as the icon theme is now its own "
+"setting. The ``[Icons]`` and ``[Project]`` sections were added, and the "
+"``status*`` settings removed."
+msgstr ""
+"Le paramètre ``icontheme`` a été supprimé car le thème des icônes a "
+"maintenant son propre paramètre. Les sections ``[Icons]`` et ``[Project]`` "
+"ont été ajoutées, et le paramètre ``status*`` a été supprimé."
+
+#: ../../source/more/customise.rst:177
+msgid "Custom Syntax Theme"
+msgstr "Syntaxe des thèmes personnalisés"
+
+#: ../../source/more/customise.rst:179
+msgid "A syntax theme ``.conf`` file consists of the following settings:"
+msgstr ""
+"Un fichier ``.conf`` de thème est constitué des paramètres suivants :"
+
+#: ../../source/more/customise.rst:213
+msgid ""
+"In the Main section, you must define at least the ``name`` setting. The "
+"Syntax colour values are RGB(A) numbers of the format ``r, g, b, a`` where "
+"each is an integer from ``0`` to ``255``. The fourth value is the alpha "
+"channel, which can be omitted."
+msgstr ""
+"Dans la section Main, vous devez définir au moins le paramètre ``name``. "
+"Les valeurs de couleur de la syntaxe sont des nombres RVB(A) du format "
+"``r, g, b, a`` où chacun est un entier de ``0`` à ``255``. La quatrième "
+"valeur est le canal alpha, qui peut être omis."
+
+#: ../../source/more/customise.rst:217
+msgid ""
+"Omitted syntax colours default to black, except ``background`` which "
+"defaults to white, and ``texthighlight`` which defaults to white with half "
+"transparency."
+msgstr ""
+"Les couleurs omises dans la syntaxe prennent par défaut la couleur noire, "
+"à l'exception de ``background`` qui prend par défaut la couleur blanche, "
+"et de ``texthighlight`` qui prend par défaut la couleur blanche avec une "
+"demi-transparence."
+
+#: ../../source/more/customise.rst:220
+msgid "The ``shortcode`` syntax colour entry was added."
+msgstr "Le paramètre de couleur ``shortcode`` a été ajouté."
+
+#: ../../source/more/customise.rst:223
+msgid "The ``optional`` syntax colour entry was added."
+msgstr "Le paramètre de couleur ``optional`` a été ajouté."
+
+#: ../../source/more/customise.rst:226
+msgid "The ``texthighlight`` syntax colour entry was added."
+msgstr "Le paramètre de couleur ``texthighlight`` a été ajouté."
+
+#: ../../source/more/customise.rst:229
+msgid ""
+"The ``dialog``, ``altdialog``, ``note`` and ``tag`` syntax colour entries "
+"were added. ``straightquotes``, ``doublequotes`` and ``singlequotes`` were "
+"removed."
+msgstr ""
+"Les paramètres de couleur ``dialog``, ``altdialog``, ``note`` et ``tag`` "
+"ont été ajoutés. Les paramètres ``guillemets droits``, ``guillemets "
+"doubles`` et ``guillemets simples`` ont été supprimés."

docs/source/locales/fr/LC_MESSAGES/more/handling_errors.po

@@ -0,0 +1,159 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-29 11:11+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/more/handling_errors.rst:5
+msgid "Handling Errors"
+msgstr "Traitement des erreurs"
+
+#: ../../source/more/handling_errors.rst:7
+msgid ""
+"In case something goes wrong, UmbraEdit has a few built-in features to "
+"reduce the chance your work is lost. In case of a crash, it will also "
+"try to save whatever changes you have made before exiting, if this is at "
+"all possible."
+msgstr ""
+"En cas de problème, UmbraEdit dispose de quelques fonctions intégrées "
+"pour réduire le risque de perte de votre travail. En cas de panne, il "
+"essaiera également d'enregistrer les modifications que vous avez "
+"apportées avant de quitter, si cela est possible."
+
+#: ../../source/more/handling_errors.rst:11
+msgid ""
+"The storage solution is designed to save each text document "
+"independently, so only the document you're working on is actually at a "
+"risk of losing data in the event of a crash."
+msgstr ""
+"La solution de stockage est conçue pour sauvegarder chaque document "
+"texte indépendamment, de sorte que seul le document sur lequel vous "
+"travaillez risque de perdre des données en cas de panne."
+
+#: ../../source/more/handling_errors.rst:18
+msgid "Recovered Documents"
+msgstr "Documents récupérés"
+
+#: ../../source/more/handling_errors.rst:20
+msgid ""
+"If UmbraEdit crashes or otherwise exits without saving the project "
+"state, or if you're using a file synchronisation tool that runs out of "
+"sync, there may be files in the project storage folder that aren't "
+"tracked in the core project file. These files, when discovered, are "
+"recovered and added back into the project when a project is opened."
+msgstr ""
+"Si UmbraEdit se plante ou se termine sans sauvegarder l'état du "
+"projet, ou si vous utilisez un outil de synchronisation de fichiers qui "
+"se désynchronise, il peut y avoir des fichiers dans le dossier de "
+"stockage du projet qui ne sont pas suivis dans le fichier de base du "
+"projet. Ces fichiers, lorsqu'ils sont découverts, sont récupérés et "
+"ajoutés au projet lorsqu'un projet est ouvert."
+
+#: ../../source/more/handling_errors.rst:25
+msgid ""
+"The discovered files are scanned for metadata that give clues as to "
+"where the document may previously have been located in the project. The "
+"project loading routine will try to put them back as close as possible "
+"to this location, if it still exists. Generally, it will be appended to "
+"the end of the folder where it previously was located. If that folder "
+"doesn't exist, it will try to add it to the correct root folder type. If "
+"it cannot figure out which root folder is correct, the document will be "
+"added to the **Novel** root folder. Finally, if a **Novel** does not "
+"exist, one will be created."
+msgstr ""
+"Les fichiers découverts sont analysés à la recherche de métadonnées qui "
+"donnent des indices sur l'emplacement antérieur du document dans le "
+"projet. La routine de chargement du projet essaiera de les replacer "
+"aussi près que possible de cet emplacement, s'il existe toujours. En "
+"général, le document sera ajouté à la fin du dossier où il se trouvait "
+"auparavant. Si ce dossier n'existe pas, il essaiera de l'ajouter au type "
+"de dossier racine correct. S'il ne parvient pas à déterminer quel est le "
+"bon dossier racine, le document sera ajouté au dossier racine "
+"**Nouveau**. Enfin, si un **Nouveau** n'existe pas, il en sera créé un."
+
+#: ../../source/more/handling_errors.rst:33
+msgid ""
+"If the title of the document can be recovered, the word \"Recovered:\" "
+"will be added as a prefix to indicate that it may need further "
+"attention. If the title cannot be determined, the document will be named "
+"after its internal key, which is a string of characters and numbers."
+msgstr ""
+"Si le titre du document peut être récupéré, le mot « Récupéré : » sera "
+"ajouté comme préfixe pour indiquer qu'il peut nécessiter une attention "
+"supplémentaire. Si le titre ne peut être déterminé, le document sera "
+"nommé d'après sa clé interne, qui est une chaîne de caractères et de "
+"chiffres."
+
+#: ../../source/more/handling_errors.rst:41
+msgid "Project Lockfile"
+msgstr "Fichier de verrouillage du projet"
+
+#: ../../source/more/handling_errors.rst:43
+msgid ""
+"To prevent data loss caused by file conflicts when UmbraEdit projects "
+"are synchronised via file synchronisation tools, a project lockfile is "
+"written to the project storage folder when a project is open. If you try "
+"to open a project that already has such a file present, you will be "
+"presented with a warning, and some information about where else "
+"UmbraEdit thinks the project is also open. You will be given the "
+"option to ignore this warning, and continue opening the project at your "
+"own risk."
+msgstr ""
+"Pour éviter la perte de données causée par des conflits de fichiers "
+"lorsque les projets UmbraEdit sont synchronisés via des outils de "
+"synchronisation de fichiers, un fichier de verrouillage de projet est "
+"écrit dans le dossier de stockage du projet lorsqu'un projet est ouvert. "
+"Si vous essayez d'ouvrir un projet dans lequel un tel fichier est déjà "
+"présent, vous recevrez un avertissement et des informations sur "
+"l'endroit où UmbraEdit pense que le projet est également ouvert. Vous "
+"aurez la possibilité d'ignorer cet avertissement et de continuer à "
+"ouvrir le projet à vos risques et périls."
+
+#: ../../source/more/handling_errors.rst:52
+msgid ""
+"If, for some reason, UmbraEdit or your computer crashes, the lock file "
+"may remain even if there are no other instances keeping the project "
+"open. In such a case it is safe to ignore the lock file warning when re-"
+"opening the project."
+msgstr ""
+"Si, pour une raison quelconque, UmbraEdit ou votre ordinateur tombe en "
+"panne, le fichier de verrouillage peut subsister même si aucune autre "
+"instance ne maintient le projet ouvert. Dans ce cas, il est prudent "
+"d'ignorer l'avertissement relatif au fichier de verrouillage lors de la "
+"réouverture du projet."
+
+#: ../../source/more/handling_errors.rst:58
+msgid ""
+"If you choose to ignore the warning and continue opening the project, "
+"and multiple instances of the project are in fact open, you are likely "
+"to cause inconsistencies and create diverging project files, potentially "
+"resulting in loss of data and orphaned files. You are not likely to lose "
+"any actual text unless both instances have the same document open in the "
+"editor, and UmbraEdit will try to resolve project inconsistencies the "
+"next time you open the project."
+msgstr ""
+"Si vous choisissez d'ignorer l'avertissement et de continuer à ouvrir le "
+"projet, et que plusieurs instances du projet sont en fait ouvertes, vous "
+"risquez de provoquer des incohérences et de créer des fichiers de projet "
+"divergents, ce qui peut entraîner une perte de données et des fichiers "
+"orphelins. Il est peu probable que vous perdiez du texte à moins que les "
+"deux instances aient le même document ouvert dans l'éditeur, et "
+"UmbraEdit essaiera de résoudre les incohérences du projet la prochaine "
+"fois que vous l'ouvrirez."

docs/source/locales/fr/LC_MESSAGES/more/project_format.po

@@ -0,0 +1,298 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2025
+# This file is distributed under the same license as the UmbraEdit
+# package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2025.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: UmbraEdit 2.7rc1\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-05-27 19:59+0200\n"
+"PO-Revision-Date: 2025-05-29 11:21+0200\n"
+"Last-Translator: \n"
+"Language-Team: fr <LL@li.org>\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"Generated-By: Babel 2.16.0\n"
+"X-Generator: Poedit 3.4.2\n"
+
+#: ../../source/more/project_format.rst:5
+msgid "Project Format Changes"
+msgstr "Modifications du format des projets"
+
+#: ../../source/more/project_format.rst:7
+msgid ""
+"Most of the changes to the file formats over the history of UmbraEdit "
+"have no impact on the user side of things. The project files are "
+"generally updated automatically. However, some of the changes require "
+"minor actions from the user."
+msgstr ""
+"La plupart des modifications apportées aux formats de fichiers au cours "
+"de l'histoire de UmbraEdit n'ont pas d'impact sur l'utilisateur. Les "
+"fichiers de projet sont généralement mis à jour automatiquement. "
+"Cependant, certains changements nécessitent des actions mineures de la "
+"part de l'utilisateur."
+
+#: ../../source/more/project_format.rst:11
+msgid ""
+"The key changes in the formats are listed in this chapter, as well as "
+"the user actions required, where applicable."
+msgstr ""
+"Les principales modifications apportées aux formats sont énumérées dans "
+"ce chapitre, ainsi que les actions requises de la part de l'utilisateur, "
+"le cas échéant."
+
+#: ../../source/more/project_format.rst:14
+msgid ""
+"A full project file format specification is available under \"More "
+"Documents\"."
+msgstr ""
+"Une spécification complète du format de fichier du projet est disponible "
+"sous « Plus d'informations »."
+
+#: ../../source/more/project_format.rst:18
+msgid ""
+"When you update a project from one format version to the next, the "
+"project can no longer be opened by a version of UmbraEdit prior to the "
+"version where the new file format was introduced. You will get a "
+"notification about any updates to your project file format and will have "
+"the option to decline the upgrade."
+msgstr ""
+"Lorsque vous mettez à jour un projet d'une version de format à la "
+"suivante, le projet ne peut plus être ouvert par une version de "
+"UmbraEdit antérieure à la version où le nouveau format de fichier a "
+"été introduit. Vous recevrez une notification concernant toute mise à "
+"jour du format de fichier de votre projet et vous aurez la possibilité "
+"de refuser la mise à jour."
+
+#: ../../source/more/project_format.rst:27
+msgid "Format 1.5 Changes"
+msgstr "Format 1.5 Modifications"
+
+#: ../../source/more/project_format.rst:29
+msgid "This project format was introduced in UmbraEdit version 2.0 RC 2."
+msgstr ""
+"Ce format de projet a été introduit dans la version 2.0 RC 2 de "
+"UmbraEdit."
+
+#: ../../source/more/project_format.rst:31
+msgid ""
+"This is a modification of the 1.4 format. It makes the XML more "
+"consistent in that meta data have been moved to their respective section "
+"nodes as attributes, and key/value settings now have a consistent "
+"format. Logical flags are saved as yes/no instead of Python True/False, "
+"and the main heading of the document is now saved to the item rather "
+"than in the index. The conversion is done automatically the first time a "
+"project is loaded. No user action is required."
+msgstr ""
+"Il s'agit d'une modification du format 1.4. Il rend le XML plus cohérent "
+"en ce sens que les métadonnées ont été déplacées vers leurs nœuds de "
+"section respectifs en tant qu'attributs, et que les paramètres clé/"
+"valeur ont désormais un format cohérent. Les indicateurs logiques sont "
+"sauvegardés sous forme de oui/non au lieu de True/False de Python, et le "
+"titre principal du document est désormais sauvegardé dans l'article "
+"plutôt que dans l'index. La conversion est effectuée automatiquement "
+"lors du premier chargement d'un projet. Aucune action de l'utilisateur "
+"n'est nécessaire."
+
+#: ../../source/more/project_format.rst:41
+msgid "Format 1.4 Changes"
+msgstr "Format 1.4 Modifications"
+
+#: ../../source/more/project_format.rst:43
+msgid ""
+"This project format was introduced in UmbraEdit version 2.0 RC 1. "
+"Since this was a release candidate, it is unlikely that your project "
+"uses it, but it may be the case if you've installed a pre-release."
+msgstr ""
+"Ce format de projet a été introduit dans la version 2.0 RC 1 de "
+"UmbraEdit. Comme il s'agissait d'une version candidate, il est peu "
+"probable que votre projet l'utilise, mais c'est peut-être le cas si vous "
+"avez installé une préversion."
+
+#: ../../source/more/project_format.rst:47
+msgid ""
+"This format changes the way project items (folders, documents and notes) "
+"are stored. It is a more compact format that is simpler and faster to "
+"parse, and easier to extend. The conversion is done automatically the "
+"first time a project is loaded. No user action is required."
+msgstr ""
+"Ce format modifie la manière dont les éléments du projet (dossiers, "
+"documents et notes) sont stockés. Il s'agit d'un format plus compact, "
+"plus simple et plus rapide à analyser, et plus facile à étendre. La "
+"conversion se fait automatiquement lors du premier chargement d'un "
+"projet. Aucune action de l'utilisateur n'est nécessaire."
+
+#: ../../source/more/project_format.rst:55
+msgid "Format 1.3 Changes"
+msgstr "Format 1.3 Modifications"
+
+#: ../../source/more/project_format.rst:57
+msgid "This project format was introduced in UmbraEdit version 1.5."
+msgstr ""
+"Ce format de projet a été introduit dans la version 1.5 de UmbraEdit."
+
+#: ../../source/more/project_format.rst:59
+msgid ""
+"With this format, the number of document layouts was reduced from eight "
+"to two. The conversion of document layouts is performed automatically "
+"when the project is opened."
+msgstr ""
+"Avec ce format, le nombre de présentations de documents a été réduit de "
+"huit à deux. La conversion des présentations de documents s'effectue "
+"automatiquement lors de l'ouverture du projet."
+
+#: ../../source/more/project_format.rst:62
+msgid ""
+"Due to the reduction of layouts, some features that were previously "
+"controlled by these layouts will be lost. These features are instead now "
+"controlled by syntax codes, so to recover these features, some minor "
+"modification must be made to select documents by the user."
+msgstr ""
+"En raison de la réduction des présentations, certaines caractéristiques "
+"qui étaient auparavant contrôlées par ces présentations seront perdues. "
+"Ces fonctionnalités sont désormais contrôlées par des codes syntaxiques. "
+"Pour les récupérer, l'utilisateur doit donc apporter quelques "
+"modifications mineures aux documents sélectionnés."
+
+#: ../../source/more/project_format.rst:66
+msgid ""
+"The manual changes the user must make should be very few as they apply "
+"to document layouts that should be used only a few places in any given "
+"project. These are as follows:"
+msgstr ""
+"Les modifications manuelles que l'utilisateur doit apporter sont très "
+"peu nombreuses car elles s'appliquent à des mises en page de documents "
+"qui ne doivent être utilisées qu'à quelques endroits dans un projet "
+"donné. Ces modifications sont les suivantes :"
+
+#: ../../source/more/project_format.rst:69
+msgid "**Title Pages**"
+msgstr "**Pages de titres**"
+
+#: ../../source/more/project_format.rst:71
+msgid ""
+"The formatting of the level one title on the title page must be changed "
+"from ``# Title Text`` to ``#! Title Text`` in order to retain the "
+"previous functionality. See :ref:`docs_usage_headings_levels`."
+msgstr ""
+"Le formatage du titre de niveau 1 sur la page de titre doit être modifié "
+"de ``# Title Text`` à ``# ! Title Text`` afin de conserver la "
+"fonctionnalité précédente. Voir :ref:`docs_usage_headings_levels`."
+
+#: ../../source/more/project_format.rst:74
+msgid ""
+"Any text that was previously centred on the page must be manually "
+"centred using the text alignment feature. See :ref:"
+"`docs_usage_align_indent`."
+msgstr ""
+"Tout texte qui était précédemment centré sur la page doit être centré "
+"manuellement en utilisant la fonction d'alignement du texte. Voir :ref:"
+"`docs_usage_align_indent`."
+
+#: ../../source/more/project_format.rst:77
+msgid "**Unnumbered Chapters**"
+msgstr "**Chapitres non numérotés**"
+
+#: ../../source/more/project_format.rst:79
+msgid ""
+"Since the specific layout for unnumbered chapters has been dropped, such "
+"chapters must all use the ``##! Chapter Name`` formatting code instead "
+"of ``## Chapter Name``. This also includes chapters marked by an "
+"asterisk: ``## *Chapter Name``, as this feature has also been dropped. "
+"See :ref:`docs_usage_headings_levels`."
+msgstr ""
+"La mise en page spécifique pour les chapitres non numérotés ayant été "
+"abandonnée, ces chapitres doivent tous utiliser le code de formatage "
+"``# ! Nom du chapitre`` au lieu de `## Nom du chapitre``. Cela inclut "
+"également les chapitres marqués d'un astérisque : `## *Nom de "
+"chapitre``, car cette fonctionnalité a également été abandonnée. Voir :"
+"ref:`docs_usage_headings_levels`."
+
+#: ../../source/more/project_format.rst:84
+msgid "**Plain Pages**"
+msgstr "**Pages vierges**"
+
+#: ../../source/more/project_format.rst:86
+msgid ""
+"The layout named \"Plain Page\" has also been removed. The only feature "
+"of this layout was that it ensured that the content always started on a "
+"fresh page. In the new format, fresh pages can be set anywhere in the "
+"text with the ``[new page]`` code. See :ref:"
+"`docs_usage_formatting_breaks`."
+msgstr ""
+"La mise en page appelée « page simple » a également été supprimée. La "
+"seule caractéristique de cette mise en page était qu'elle garantissait "
+"que le contenu commençait toujours sur une nouvelle page. Dans le "
+"nouveau format, les nouvelles pages peuvent être placées n'importe où "
+"dans le texte avec le code ``[new page]``. Voir :ref:"
+"`docs_usage_formatting_breaks`."
+
+#: ../../source/more/project_format.rst:94
+msgid "Format 1.2 Changes"
+msgstr "Format 1.2 Modifications"
+
+#: ../../source/more/project_format.rst:96
+msgid "This project format was introduced in UmbraEdit version 0.10."
+msgstr ""
+"Ce format de projet a été introduit dans la version 0.10 de UmbraEdit."
+
+#: ../../source/more/project_format.rst:98
+msgid ""
+"With this format, the way auto-replace entries were stored in the main "
+"project XML file changed. Conversion from this format is done "
+"automatically."
+msgstr ""
+"Avec ce format, la façon dont les entrées de remplacement automatique "
+"étaient stockées dans le fichier XML du projet principal a changé. La "
+"conversion de ce format se fait automatiquement."
+
+#: ../../source/more/project_format.rst:105
+msgid "Format 1.1 Changes"
+msgstr "Format 1.1 Modifications"
+
+#: ../../source/more/project_format.rst:107
+msgid "This project format was introduced in UmbraEdit version 0.7."
+msgstr ""
+"Ce format de projet a été introduit dans la version 0.7 de UmbraEdit."
+
+#: ../../source/more/project_format.rst:109
+msgid ""
+"With this format, the ``content`` folder was introduced in the project "
+"storage. Previously, all UmbraEdit documents were saved in a series of "
+"folders numbered from ``data_0`` to ``data_f``."
+msgstr ""
+"Avec ce format, le dossier ``content`` a été introduit dans le stockage "
+"du projet. Auparavant, tous les documents de UmbraEdit étaient "
+"sauvegardés dans une série de dossiers numérotés de ``data_0`` à "
+"``data_f``."
+
+#: ../../source/more/project_format.rst:112
+msgid ""
+"It also reduces the number of meta data and cache files. These files are "
+"automatically deleted if an old project is opened. This was also when "
+"the Table of Contents file was introduced. Conversion from this format "
+"is done automatically."
+msgstr ""
+"Il réduit également le nombre de métadonnées et de fichiers de cache. "
+"Ces fichiers sont automatiquement supprimés lorsqu'un ancien projet est "
+"ouvert. C'est également à cette époque que le fichier de table des "
+"matières a été introduit. La conversion de ce format se fait "
+"automatiquement."
+
+#: ../../source/more/project_format.rst:120
+msgid "Format 1.0 Changes"
+msgstr "Format 1.0 Modifications"
+
+#: ../../source/more/project_format.rst:122
+msgid ""
+"This is the original file format and project structure. It was in use up "
+"to version 0.6.3."
+msgstr ""
+"Il s'agit du format de fichier et de la structure de projet d'origine. "
+"Il a été utilisé jusqu'à la version 0.6.3."