latextify 0.3.2__tar.gz → 0.3.4__tar.gz

{latextify-0.3.2 → latextify-0.3.4}/.github/workflows/ci.yml

@@ -147,14 +147,18 @@ jobs:
         with:
           python-version: "3.13"
       - name: Install
-        run: uv sync --locked --group portable
+        run: |
+          uv sync --locked --group portable
+          # setup-uv may select GitHub's hosted interpreter, which is not a
+          # relocatable payload. Install an explicit uv-managed copy to bundle.
+          uv python install 3.13 --no-bin --no-registry
       - name: Set up the TARGET Python 3.10 (what install.py will run under)
         id: py310
         uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
         with:
           python-version: "3.10"
-      - name: Build a GUI kit covering Python 3.10 and warm one journal (network ON)
-        run: uv run latextify make-kit --target current --python-versions 3.10 --with-gui --journals revtex4-2 --output build
+      - name: Build a GUI/dev kit covering Python 3.10 and 3.13 (network ON)
+        run: uv run latextify make-kit --target current --python-versions 3.10 --python-versions 3.13 --with-gui --with-dev --journals revtex4-2 --output build
       - name: Install the kit under Python 3.10, network POISONED
         env:
           # Same reasoning as the Linux offline-kit job: uppercase only, one
@@ -197,6 +201,8 @@ jobs:
             Get-Content "build/portable/LaTeXtify-Windows-Portable/latextify-startup.log" -ErrorAction SilentlyContinue
             throw "portable self-test failed (exit $($selfTest.ExitCode))"
           }
+          $verify = Start-Process -FilePath $app -ArgumentList "--verify-installation" -PassThru -Wait -WindowStyle Hidden
+          if ($verify.ExitCode -ne 0) { throw "portable integrity verification failed" }
           $env:LATEXTIFY_NO_BROWSER = "1"
           $env:LATEXTIFY_PORT = "8765"
           $process = Start-Process -FilePath $app -PassThru -WindowStyle Hidden
@@ -220,3 +226,42 @@ jobs:
           } finally {
             if (-not $process.HasExited) { Stop-Process -Id $process.Id -Force }
           }
+      - name: Build and exercise the editable offline repository
+        env:
+          HTTPS_PROXY: http://127.0.0.1:9
+          HTTP_PROXY: http://127.0.0.1:9
+          ALL_PROXY: http://127.0.0.1:9
+        run: |
+          $python = uv python find --managed-python 3.13
+          uv run --group portable python tools/build_windows_offline_repo.py `
+            --kit build/latextify-offline-windows-x64 `
+            --python-runtime $python `
+            --output build/offline-repo
+          if ($LASTEXITCODE -ne 0) { throw "offline repository build failed" }
+          $repo = Resolve-Path "build/offline-repo/LaTeXtify-Windows-Offline-Repo"
+          & "$repo/.runtime/python/python.exe" "$repo/.offline-kit/install.py" --dir $repo
+          if ($LASTEXITCODE -ne 0) { throw "offline repository setup failed" }
+          Push-Location $repo
+          try {
+            $env:LATEXTIFY_OFFLINE = "1"
+            $env:PATH = "$repo/.offline-kit/tectonic;$env:PATH"
+            $env:TECTONIC_CACHE_DIR = "$repo/.offline-kit/tex-bundle-cache"
+            & ".venv/Scripts/python.exe" -c "import pathlib, latextify; assert pathlib.Path(latextify.__file__).resolve().is_relative_to(pathlib.Path.cwd())"
+            if ($LASTEXITCODE -ne 0) { throw "offline repository did not import editable source" }
+            & ".venv/Scripts/python.exe" -m pytest -q tests/test_portable.py
+            if ($LASTEXITCODE -ne 0) { throw "offline repository test command failed" }
+            & ".runtime/python/python.exe" "verify_installation.py"
+            if ($LASTEXITCODE -ne 0) { throw "offline repository integrity verification failed" }
+            & ".venv/Scripts/python.exe" -m latextify convert `
+              examples/04-combined-emf/Combined-Manuscript-with-EMF.docx `
+              -j revtex4-2 -o offline-repo-demo --pdf --inline-supplement `
+              --columns two --inline-supplement-columns one `
+              --figure-column 1=one --figure-column 2=two
+            if ($LASTEXITCODE -ne 0) { throw "combined Word/EMF scenario failed" }
+            $body = Get-Content "offline-repo-demo/revtex4-2/generated/body.tex" -Raw
+            foreach ($marker in @("\begin{figure}", "\begin{figure*}", "\clearpage", "\onecolumn")) {
+              if (-not $body.Contains($marker)) { throw "combined Word/EMF output is missing $marker" }
+            }
+          } finally {
+            Pop-Location
+          }

{latextify-0.3.2 → latextify-0.3.4}/.github/workflows/publish.yml

@@ -1,10 +1,9 @@
 name: Publish to PyPI
 
-# Publishes the sdist + wheel to PyPI. Triggers ONLY on a published GitHub
-# Release -- never on a plain push, a pull request, or even a tag push (tag
-# pushes drive release.yml's offline-kit build instead). This is the
-# machinery only: it cannot fire a real publish until an OWNER completes the
-# two one-time setup steps below.
+# Publishes the sdist + wheel to PyPI. Normally dispatched by release.yml only
+# after every offline artifact has built and passed its acceptance tests. The
+# published-release trigger remains as a backwards-compatible/manual path.
+# Neither a plain branch push nor a pull request can publish a package.
 #
 # ---------------------------------------------------------------------------
 # OWNER SETUP REQUIRED before the first real publish (both are one-time,
@@ -21,17 +20,25 @@ name: Publish to PyPI
 #      successful publish from this trusted publisher -- no manual project
 #      creation needed.)
 #
-#   2. Publish a GitHub Release (e.g. tag v0.1.0). The `release: published`
-#      event below is what triggers the `publish` job -- nothing publishes
-#      before that happens.
+#   2. Push a version tag (e.g. v0.1.0). release.yml builds and verifies all
+#      artifacts, creates a draft GitHub release, dispatches this workflow for
+#      that exact tag, and publishes the GitHub release only after PyPI passes.
 # ---------------------------------------------------------------------------
 
 on:
   release:
     types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Exact version tag to build and publish"
+        required: true
+        type: string
+
+run-name: Publish ${{ inputs.tag || github.event.release.tag_name }} to PyPI
 
 concurrency:
-  group: publish-${{ github.ref }}
+  group: publish-${{ inputs.tag || github.event.release.tag_name }}
   cancel-in-progress: false
 
 permissions:
@@ -42,6 +49,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          ref: ${{ inputs.tag || github.event.release.tag_name }}
       - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0
         # No python-version here on purpose: setup-uv reads .python-version,
         # so the repo file is the single declaration (toolchain-version rule).
@@ -70,3 +79,5 @@ jobs:
           name: dist
           path: dist/
       - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          skip-existing: true

{latextify-0.3.2 → latextify-0.3.4}/.github/workflows/release.yml

@@ -1,10 +1,9 @@
 name: Release kits
 
-# On a version tag, build the three offline kits and attach them (plus a
-# source zip and checksums) to a GitHub release, so an air-gapped machine can
-# "download from the releases page" with no online build host at all.
-# Complements the CI `offline-kit` job, which proves one kit installs and
-# compiles a PDF offline on every push.
+# On a version tag, build and test the native Windows portable app, editable
+# offline repository, three platform kits, source archive, and checksums. The
+# assets stay in a draft release while the exact tag is published to PyPI; the
+# GitHub release becomes public only after every preceding step succeeds.
 
 on:
   push:
@@ -21,6 +20,7 @@ on:
 
 permissions:
   contents: write # create the release and upload assets
+  actions: write # dispatch and verify the trusted PyPI publishing workflow
 
 concurrency:
   group: release-${{ github.ref }}
@@ -45,11 +45,15 @@ jobs:
             ~/.cache/Tectonic
           key: tectonic-${{ runner.os }}-v1
       - name: Install build dependencies
-        run: uv sync --locked --no-dev --extra gui --group portable
+        run: |
+          uv sync --locked --no-dev --extra gui --group portable
+          # The hosted interpreter is runner infrastructure, not a portable
+          # payload. Install a complete uv-managed runtime for the repo bundle.
+          uv python install 3.13 --no-bin --no-registry
       - name: Build native Windows runtime assets
         env:
           GITHUB_TOKEN: ${{ github.token }}
-        run: uv run latextify make-kit --target current --python-versions 3.13 --with-gui -o build
+        run: uv run latextify make-kit --target current --python-versions 3.13 --with-gui --with-dev -o build
       - name: Freeze and verify the portable application
         env:
           HTTPS_PROXY: http://127.0.0.1:9
@@ -63,10 +67,82 @@ jobs:
             Get-Content "build/portable/LaTeXtify-Windows-Portable/latextify-startup.log" -ErrorAction SilentlyContinue
             throw "portable self-test failed (exit $($selfTest.ExitCode))"
           }
+          $verify = Start-Process -FilePath $app -ArgumentList "--verify-installation" -PassThru -Wait -WindowStyle Hidden
+          if ($verify.ExitCode -ne 0) { throw "portable integrity verification failed" }
+
+      - name: Build and verify the editable offline repository
+        env:
+          HTTPS_PROXY: http://127.0.0.1:9
+          HTTP_PROXY: http://127.0.0.1:9
+          ALL_PROXY: http://127.0.0.1:9
+        run: |
+          # setup-uv already installed this managed interpreter. Copying its
+          # complete runtime makes the target independent of system Python.
+          $python = uv python find --managed-python 3.13
+          uv run --group portable python tools/build_windows_offline_repo.py `
+            --kit build/latextify-offline-windows-x64 `
+            --python-runtime $python `
+            --output build/offline-repo
+          if ($LASTEXITCODE -ne 0) { throw "offline repository build failed" }
+
+          $repo = Resolve-Path "build/offline-repo/LaTeXtify-Windows-Offline-Repo"
+          $process = Start-Process -FilePath "cmd.exe" `
+            -ArgumentList "/c", "startup.bat --port 8766 --no-browser --keep-alive" `
+            -WorkingDirectory $repo -PassThru -WindowStyle Hidden
+          try {
+            $ready = $false
+            for ($i = 0; $i -lt 60; $i++) {
+              Start-Sleep -Seconds 1
+              try {
+                $response = Invoke-WebRequest "http://127.0.0.1:8766/" -UseBasicParsing -NoProxy
+                if ($response.StatusCode -eq 200 -and $response.Content -match "LaTeXtify") {
+                  $ready = $true
+                  break
+                }
+              } catch {}
+              if ($process.HasExited) { break }
+            }
+            if (-not $ready) {
+              Get-Content "$repo/latextify-startup.log" -ErrorAction SilentlyContinue
+              throw "offline repository GUI did not start"
+            }
+          } finally {
+            if (-not $process.HasExited) { Stop-Process -Id $process.Id -Force }
+          }
+
+          Push-Location $repo
+          try {
+            $env:LATEXTIFY_OFFLINE = "1"
+            $env:PATH = "$repo/.offline-kit/tectonic;$env:PATH"
+            $env:TECTONIC_CACHE_DIR = "$repo/.offline-kit/tex-bundle-cache"
+            & ".venv/Scripts/python.exe" -c "import pathlib, latextify; assert pathlib.Path(latextify.__file__).resolve().is_relative_to(pathlib.Path.cwd())"
+            if ($LASTEXITCODE -ne 0) { throw "offline repository did not import editable source" }
+            & ".venv/Scripts/python.exe" -m pytest -q tests/test_portable.py
+            if ($LASTEXITCODE -ne 0) { throw "offline repository test command failed" }
+            & ".runtime/python/python.exe" "verify_installation.py"
+            if ($LASTEXITCODE -ne 0) { throw "offline repository integrity verification failed" }
+            & ".venv/Scripts/python.exe" -m latextify convert `
+              examples/04-combined-emf/Combined-Manuscript-with-EMF.docx `
+              -j revtex4-2 -o offline-repo-demo --pdf --inline-supplement `
+              --columns two --inline-supplement-columns one `
+              --figure-column 1=one --figure-column 2=two
+            if ($LASTEXITCODE -ne 0) { throw "offline repository conversion failed" }
+            if (-not (Test-Path "offline-repo-demo/revtex4-2/main.pdf")) {
+              throw "offline repository did not compile a PDF"
+            }
+            $body = Get-Content "offline-repo-demo/revtex4-2/generated/body.tex" -Raw
+            foreach ($marker in @("\begin{figure}", "\begin{figure*}", "\clearpage", "\onecolumn")) {
+              if (-not $body.Contains($marker)) { throw "combined Word/EMF output is missing $marker" }
+            }
+          } finally {
+            Pop-Location
+          }
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
-          name: windows-portable
-          path: build/portable/LaTeXtify-Windows-Portable.zip
+          name: windows-offline-packages
+          path: |
+            build/portable/LaTeXtify-Windows-Portable.zip
+            build/offline-repo/LaTeXtify-Windows-Offline-Repo.zip
           if-no-files-found: error
 
   build-kits:
@@ -161,16 +237,22 @@ jobs:
 
       - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
         with:
-          name: windows-portable
+          name: windows-offline-packages
           path: build
 
-      - name: Add the portable Windows application to checksums
+      - name: Add the Windows packages to checksums
         run: |
           cd build
+          # upload-artifact preserves the common `build/`-relative directory
+          # structure when given files from two different subdirectories.
+          # Flatten those two known assets before checksumming/uploading them.
+          mv portable/LaTeXtify-Windows-Portable.zip .
+          mv offline-repo/LaTeXtify-Windows-Offline-Repo.zip .
           sha256sum LaTeXtify-Windows-Portable.zip >> SHA256SUMS.txt
+          sha256sum LaTeXtify-Windows-Offline-Repo.zip >> SHA256SUMS.txt
           cat SHA256SUMS.txt
 
-      - name: Create release (if missing) and upload assets
+      - name: Create draft release (if missing) and upload assets
         env:
           GH_TOKEN: ${{ github.token }}
           TAG: ${{ github.event.inputs.tag || github.ref_name }}
@@ -181,6 +263,7 @@ jobs:
             latextify-offline-linux-x64.zip
             latextify-offline-macos-arm64.zip
             LaTeXtify-Windows-Portable.zip
+            LaTeXtify-Windows-Offline-Repo.zip
             latextify-source.zip
             SHA256SUMS.txt
           )
@@ -191,6 +274,37 @@ jobs:
           else
             gh release create "$TAG" \
               --title "LaTeXtify $TAG" \
+              --draft \
               --generate-notes \
               "${assets[@]}"
           fi
+
+      - name: Publish the exact tag to PyPI and wait for it
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.event.inputs.tag || github.ref_name }}
+        run: |
+          tag_sha=$(git rev-parse "$TAG^{commit}")
+          previous_id=$(gh run list --workflow publish.yml --event workflow_dispatch \
+            --commit "$tag_sha" --limit 1 --json databaseId \
+            --jq '.[0].databaseId // empty')
+          gh workflow run publish.yml --ref "$TAG" -f tag="$TAG"
+          run_id=""
+          for attempt in $(seq 1 30); do
+            candidate=$(gh run list --workflow publish.yml --event workflow_dispatch \
+              --commit "$tag_sha" --limit 1 --json databaseId \
+              --jq '.[0].databaseId // empty')
+            if [ -n "$candidate" ] && [ "$candidate" != "$previous_id" ]; then
+              run_id="$candidate"
+              break
+            fi
+            sleep 2
+          done
+          [ -n "$run_id" ] || { echo "PyPI workflow did not start" >&2; exit 1; }
+          gh run watch "$run_id" --exit-status
+
+      - name: Publish the verified GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ github.event.inputs.tag || github.ref_name }}
+        run: gh release edit "$TAG" --draft=false

{latextify-0.3.2 → latextify-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: latextify
-Version: 0.3.2
+Version: 0.3.4
 Summary: Convert Word manuscripts to journal-ready LaTeX projects and PDFs
 Project-URL: Homepage, https://github.com/pquarterman17/LaTeXtify
 Project-URL: Repository, https://github.com/pquarterman17/LaTeXtify
@@ -331,8 +331,10 @@ To start the web GUI without touching a command line, double-click
 **`startup.bat`** (Windows) or run **`./startup.sh`** (macOS/Linux). It installs
 dependencies on first run, opens the GUI in your browser, and — if anything
 goes wrong — writes an easy-to-find `latextify-startup.log` next to the script
-and prints it for you to copy. This source-tree launcher needs internet access
-on its first run.
+and prints it for you to copy. On Windows, `startup.bat` is offline-first and
+never downloads missing software. A connected source checkout can explicitly
+opt into the old online bootstrap by running **`startup-online.bat`** instead.
+The macOS/Linux source launcher still needs internet access on its first run.
 
 ### Offline / firewalled Windows computer
 
@@ -360,6 +362,37 @@ Python already present on the work computer. Embedded EMF/WMF figures work,
 but preserving them as vectors requires an offline installation of LibreOffice
 or Inkscape; otherwise Windows attempts a 600-DPI raster fallback.
 
+For an **editable source checkout** on an air-gapped Windows computer, use
+**`LaTeXtify-Windows-Offline-Repo.zip`**. It contains the complete tracked
+repository, a portable Python 3.13 runtime, pinned runtime and development
+dependencies, Pandoc, Tectonic, and the warmed TeX cache. Extract the whole
+folder and double-click `startup.bat`; its first launch creates `.venv` from
+the local wheelhouse without contacting any service. Code changes under
+`latextify\` are used on the next launch, and the bundled environment can run
+the offline test, lint, and type-check commands described in
+`README-OFFLINE-REPO.txt`.
+
+Both Windows downloads include `Verify-LaTeXtify.bat` and a file-level
+integrity manifest. Run it after transfer/extraction if antivirus, endpoint
+security, or an incomplete unzip may have removed a component. The GUI also
+has a **System check** panel that tests Pandoc, Tectonic, the TeX cache,
+writable storage, offline PDF compilation, and the available EMF/WMF path,
+then saves a content-free report suitable for IT.
+
+The downloads also include the synthetic combined Word+EMF acceptance sample.
+It is the same merged main-text + supplement scenario exercised by the release
+gate and can be used to check a work computer before opening an unpublished
+manuscript.
+
+These packages serve different purposes:
+
+| Release asset | Intended use | Python required |
+|---|---|---|
+| `LaTeXtify-Windows-Portable.zip` | Normal GUI use | No |
+| `LaTeXtify-Windows-Offline-Repo.zip` | Editable/debuggable/testable source | No |
+| `latextify-offline-windows-x64.zip` | Inspectable installed Python package | Yes |
+| GitHub/source ZIP | Connected development | Yes |
+
 ## Usage
 
 > Installed from source with `uv sync`? Prefix these with `uv run` (e.g.
@@ -380,6 +413,10 @@ latextify convert paper.docx --journal revtex4-2 --supplement si.docx --pdf
 # Material", or "Supporting Information" at the boundary.
 latextify convert merged.docx --journal revtex4-2 --inline-supplement --pdf
 
+# Switch the inline supplement to one column after the page break
+latextify convert merged.docx --journal revtex4-2 --inline-supplement \
+  --columns two --inline-supplement-columns one --pdf
+
 # Inline supplements cannot be combined with --figures-at-end: delayed floats
 # would cross the numbering boundary. LaTeXtify rejects that combination.
 # If the merged file contains separate main and supplementary reference lists,

{latextify-0.3.2 → latextify-0.3.4}/README.md

@@ -285,8 +285,10 @@ To start the web GUI without touching a command line, double-click
 **`startup.bat`** (Windows) or run **`./startup.sh`** (macOS/Linux). It installs
 dependencies on first run, opens the GUI in your browser, and — if anything
 goes wrong — writes an easy-to-find `latextify-startup.log` next to the script
-and prints it for you to copy. This source-tree launcher needs internet access
-on its first run.
+and prints it for you to copy. On Windows, `startup.bat` is offline-first and
+never downloads missing software. A connected source checkout can explicitly
+opt into the old online bootstrap by running **`startup-online.bat`** instead.
+The macOS/Linux source launcher still needs internet access on its first run.
 
 ### Offline / firewalled Windows computer
 
@@ -314,6 +316,37 @@ Python already present on the work computer. Embedded EMF/WMF figures work,
 but preserving them as vectors requires an offline installation of LibreOffice
 or Inkscape; otherwise Windows attempts a 600-DPI raster fallback.
 
+For an **editable source checkout** on an air-gapped Windows computer, use
+**`LaTeXtify-Windows-Offline-Repo.zip`**. It contains the complete tracked
+repository, a portable Python 3.13 runtime, pinned runtime and development
+dependencies, Pandoc, Tectonic, and the warmed TeX cache. Extract the whole
+folder and double-click `startup.bat`; its first launch creates `.venv` from
+the local wheelhouse without contacting any service. Code changes under
+`latextify\` are used on the next launch, and the bundled environment can run
+the offline test, lint, and type-check commands described in
+`README-OFFLINE-REPO.txt`.
+
+Both Windows downloads include `Verify-LaTeXtify.bat` and a file-level
+integrity manifest. Run it after transfer/extraction if antivirus, endpoint
+security, or an incomplete unzip may have removed a component. The GUI also
+has a **System check** panel that tests Pandoc, Tectonic, the TeX cache,
+writable storage, offline PDF compilation, and the available EMF/WMF path,
+then saves a content-free report suitable for IT.
+
+The downloads also include the synthetic combined Word+EMF acceptance sample.
+It is the same merged main-text + supplement scenario exercised by the release
+gate and can be used to check a work computer before opening an unpublished
+manuscript.
+
+These packages serve different purposes:
+
+| Release asset | Intended use | Python required |
+|---|---|---|
+| `LaTeXtify-Windows-Portable.zip` | Normal GUI use | No |
+| `LaTeXtify-Windows-Offline-Repo.zip` | Editable/debuggable/testable source | No |
+| `latextify-offline-windows-x64.zip` | Inspectable installed Python package | Yes |
+| GitHub/source ZIP | Connected development | Yes |
+
 ## Usage
 
 > Installed from source with `uv sync`? Prefix these with `uv run` (e.g.
@@ -334,6 +367,10 @@ latextify convert paper.docx --journal revtex4-2 --supplement si.docx --pdf
 # Material", or "Supporting Information" at the boundary.
 latextify convert merged.docx --journal revtex4-2 --inline-supplement --pdf
 
+# Switch the inline supplement to one column after the page break
+latextify convert merged.docx --journal revtex4-2 --inline-supplement \
+  --columns two --inline-supplement-columns one --pdf
+
 # Inline supplements cannot be combined with --figures-at-end: delayed floats
 # would cross the numbering boundary. LaTeXtify rejects that combination.
 # If the merged file contains separate main and supplementary reference lists,

latextify-0.3.4/examples/04-combined-emf/README.txt

@@ -0,0 +1,19 @@
+LaTeXtify combined Word + EMF acceptance sample
+================================================
+
+Combined-Manuscript-with-EMF.docx contains synthetic main text followed by a
+"Supplementary Information" heading and two real embedded Windows EMF figures.
+It contains no research data.
+
+Recommended GUI choices:
+
+  Combined main + supplement: Main two columns; supplement one column
+  Figure 1 width:              One column
+  Figure 2 width:              Two columns
+  Compile PDF:                 On
+
+The output should be one main.pdf with a page break before the supplement,
+S-numbering after the boundary, and both figures visible. Without LibreOffice
+or Inkscape, LaTeXtify should report that the EMFs were rasterized at 600 DPI.
+
+make_sample.py regenerates the document on Windows and is not needed to use it.

latextify-0.3.4/examples/04-combined-emf/make_sample.py

@@ -0,0 +1,114 @@
+"""Create the Windows acceptance sample: merged main/SI DOCX with real EMFs."""
+
+from __future__ import annotations
+
+import ctypes
+import zipfile
+from ctypes import wintypes
+from pathlib import Path
+
+from docx import Document
+from docx.shared import Inches
+from PIL import Image
+
+HERE = Path(__file__).resolve().parent
+OUTPUT = HERE / "Combined-Manuscript-with-EMF.docx"
+
+
+def _write_emf(path: Path, *, tall: bool) -> None:
+    gdi32 = ctypes.WinDLL("gdi32", use_last_error=True)
+    gdi32.CreateEnhMetaFileW.argtypes = (
+        wintypes.HDC,
+        wintypes.LPCWSTR,
+        ctypes.POINTER(wintypes.RECT),
+        wintypes.LPCWSTR,
+    )
+    gdi32.CreateEnhMetaFileW.restype = wintypes.HANDLE
+    gdi32.Rectangle.argtypes = (
+        wintypes.HDC,
+        ctypes.c_int,
+        ctypes.c_int,
+        ctypes.c_int,
+        ctypes.c_int,
+    )
+    gdi32.CloseEnhMetaFile.argtypes = (wintypes.HDC,)
+    gdi32.CloseEnhMetaFile.restype = wintypes.HANDLE
+    gdi32.DeleteEnhMetaFile.argtypes = (wintypes.HANDLE,)
+    frame = wintypes.RECT(0, 0, 1270 if tall else 2540, 2540 if tall else 1270)
+    hdc = gdi32.CreateEnhMetaFileW(None, str(path), ctypes.byref(frame), "LaTeXtify\0EMF sample\0")
+    if not hdc:
+        raise ctypes.WinError(ctypes.get_last_error())
+    gdi32.Rectangle(hdc, 100, 100, frame.right - 100, frame.bottom - 100)
+    metafile = gdi32.CloseEnhMetaFile(hdc)
+    if not metafile:
+        raise ctypes.WinError(ctypes.get_last_error())
+    gdi32.DeleteEnhMetaFile(metafile)
+
+
+def _replace_pngs(docx_path: Path, emfs: tuple[Path, ...]) -> None:
+    rebuilt = docx_path.with_suffix(".rebuilt.docx")
+    with (
+        zipfile.ZipFile(docx_path) as source,
+        zipfile.ZipFile(rebuilt, "w", zipfile.ZIP_DEFLATED) as destination,
+    ):
+        image_names = {f"word/media/image{index}.png" for index in range(1, len(emfs) + 1)}
+        for info in source.infolist():
+            if info.filename in image_names:
+                continue
+            data = source.read(info.filename)
+            if info.filename == "word/_rels/document.xml.rels":
+                data = data.replace(b".png", b".emf")
+            elif info.filename == "[Content_Types].xml":
+                data = data.replace(
+                    b"</Types>",
+                    b'<Default Extension="emf" ContentType="image/x-emf"/></Types>',
+                )
+            destination.writestr(info, data)
+        for index, emf in enumerate(emfs, start=1):
+            destination.writestr(f"word/media/image{index}.emf", emf.read_bytes())
+    rebuilt.replace(docx_path)
+
+
+def main() -> None:
+    if not hasattr(ctypes, "WinDLL"):
+        raise SystemExit("This sample must be generated on Windows.")
+    main_emf, supplement_emf = HERE / "main.emf", HERE / "supplement.emf"
+    main_png, supplement_png = HERE / "main.png", HERE / "supplement.png"
+    try:
+        _write_emf(main_emf, tall=True)
+        _write_emf(supplement_emf, tall=False)
+        Image.new("RGB", (200, 400), "white").save(main_png)
+        Image.new("RGB", (400, 200), "white").save(supplement_png)
+
+        doc = Document()
+        doc.core_properties.title = "LaTeXtify combined manuscript acceptance sample"
+        doc.core_properties.author = "Example Author"
+        doc.add_heading("A Combined Manuscript Acceptance Sample", level=0)
+        doc.add_paragraph("Example Author")
+        doc.add_heading("Abstract", level=1)
+        doc.add_paragraph(
+            "This synthetic document verifies offline conversion without containing research data."
+        )
+        doc.add_heading("Results", level=1)
+        doc.add_paragraph("The main text contains an embedded Windows Enhanced Metafile.")
+        doc.add_picture(str(main_png), width=Inches(2.0))
+        doc.add_paragraph("Figure 1. Main-text EMF intended for one column.")
+        doc.add_paragraph("A demonstration result is cited here [1].")
+        doc.add_heading("References", level=1)
+        doc.add_paragraph("[1] Example, A. A synthetic reference. Example Journal 1, 1–2 (2026).")
+        doc.add_heading("Supplementary Information", level=1)
+        doc.add_paragraph("This section must begin on a new page and use S-numbering.")
+        doc.add_picture(str(supplement_png), width=Inches(5.5))
+        doc.add_paragraph("Figure S1. Supplementary EMF intended to span two columns.")
+        doc.add_heading("Supplementary Methods", level=2)
+        doc.add_paragraph("No external data or network service is required for this sample.")
+        doc.save(OUTPUT)
+        _replace_pngs(OUTPUT, (main_emf, supplement_emf))
+        print(OUTPUT)
+    finally:
+        for temporary in (main_emf, supplement_emf, main_png, supplement_png):
+            temporary.unlink(missing_ok=True)
+
+
+if __name__ == "__main__":
+    main()

{latextify-0.3.2 → latextify-0.3.4}/examples/README.md

@@ -1,16 +1,17 @@
 # LaTeXtify usage examples
 
-Three self-contained, runnable examples covering the input shapes a real user
-hits, from the simplest to the full journal submission. Each folder has a
-`make_manuscript.py` that **generates** its Word document(s) (no binary files
-are committed — the same python-docx / hand-assembled-OOXML approach the test
-suite uses) and a `run.py` that generates + converts to a PDF in one step.
+Four self-contained examples cover the input shapes a real user hits, from the
+simplest to the full journal submission. Examples 01–03 generate their inputs
+on demand. Example 04 intentionally includes a ready-to-use synthetic Word
+file with real embedded Windows EMFs so an offline machine can be checked
+without first installing development tools.
 
 | # | Example | Scenario | Highlights |
 |---|---------|----------|------------|
 | 01 | [all-embedded](01-all-embedded/) | One `.docx` with everything inside | embedded figures · metadata guessing · typed references → **Crossref** reconstruction |
 | 02 | [word-plus-figures](02-word-plus-figures/) | `.docx` + separate figure files | `figures/` folder convention · `figures.yaml` manifest · override precedence |
 | 03 | [multipart-refmanager](03-multipart-refmanager/) | Main + supplement + reference manager | Zotero/Mendeley **field codes** · `--supplement` · shared/de-duplicated `references.bib` · `paper.yaml` metadata |
+| 04 | [combined-emf](04-combined-emf/) | One merged main+supplement `.docx` with embedded EMFs | page-break boundary · S-numbering · manual one-/two-column figures · offline acceptance sample |
 
 ## Quick start
 
@@ -45,6 +46,9 @@ warmed TeX cache.
   document as reference-manager field codes (a clean, offline bibliography);
   `--supplement` emits the SI into the same project with a shared, de-duplicated
   bibliography.
+- **"My main text and supplement are one Word file and the figures are EMFs."**
+  → [Example 04](04-combined-emf/). Use the committed sample directly in the
+  GUI; its README lists the expected layout choices and output.
 
 ## How references get in — at a glance
 
@@ -56,4 +60,4 @@ ingest a standalone `.bib`, `.ris`, or reference-manager library file.
 | Inserted by a Zotero/Mendeley/EndNote **Word plugin** (field codes) | metadata read straight from the field codes | No — DOIs and all metadata are embedded |
 | Word's **built-in** citation manager | read from the document's citation sources | No |
 | A **typed** reference list + `[1]`/`(Smith 2020)` markers | reconstructed via **Crossref**, low-confidence entries flagged `verify` | Yes (offline → raw verify-flagged entries) |
-| A separate exported **library file** (`.bib`/`.ris`/CSL-JSON) | **not supported** — insert citations with the Word plugin instead | — |
+| A separate exported **library file** (`.bib`/`.ris`/CSL-JSON/EndNote XML/`.nbib`) | upload it with the References role or pass `--references` | No for matched entries |