# Catholic Publisher AI Editing Instructions Give this complete file to an AI tool when you want it to update text in a Catholic Publisher `.cpub` publication. The supported method is the companion `cpub.exe` command-line program. Do not edit the ZIP/XML contents of a CPUB directly. ## Objective Use `cpub.exe` to locate one editable text target, export it as ordinary HTML, edit that HTML, and safely create an updated CPUB. The target may be an ordinary text box, either side of a bilingual text box, or a table cell, including a target inside a group. Unless the user explicitly requests an in-place update, write a new `.cpub` file and leave the source unchanged. ## Find `cpub.exe` The public installer normally places it here for the current Windows user: ```text %LOCALAPPDATA%\Programs\Catholic Publisher\cpub.exe ``` In PowerShell, resolve that path with: ```powershell $cpub = Join-Path $env:LOCALAPPDATA 'Programs\Catholic Publisher\cpub.exe' ``` For a portable or development build, `cpub.exe` is in the same folder as `CatholicPublisher.exe`. If neither location exists, ask the user where Catholic Publisher is installed; do not download or invent another executable. ## Required workflow 1. Ask for the source `.cpub` path and which content should change. 2. List the editable targets: ```powershell & $cpub list "C:\Publications\Bulletin YYYY-MM-DD.cpub" ``` 3. Select the target by its unique four-character `contentId`. A `customName` is convenient for people but may be blank or duplicated. If a name matches more than one target, stop and use the exact ID. 4. Export that target: ```powershell & $cpub export "C:\Publications\Bulletin YYYY-MM-DD.cpub" --id A7K2 -o "C:\Temp\article.html" ``` 5. Edit only the HTML body content. Preserve the two `` elements in the exported ``; they identify the target and detect a stale source file. 6. Create a separate updated publication by default: ```powershell & $cpub replace "C:\Publications\Bulletin YYYY-MM-DD.cpub" --html "C:\Temp\article.html" -o "C:\Publications\Bulletin updated.cpub" ``` 7. Require a successful exit code. Then open the resulting CPUB in Catholic Publisher and tell the user to inspect the changed text, wrapping, overflow, page order, and final PDF before publication. Use `--in-place` instead of `-o` only when the user explicitly asks to update the original file. Use `--overwrite` only when the user explicitly authorizes replacing an existing output file. ## `list` output `cpub list` returns JSON containing the publication path, its SHA-256, and a `targets` array. Each target contains: - `contentId`: unique, stable four-character identifier; prefer this selector. - `customName`: optional human-friendly name; it is not guaranteed unique. - `kind`: `textBox`, `bilingualEnglish`, `bilingualSpanish`, or `tableCell`. - `page`: one-based page number. - `objectId`: internal object GUID for diagnosis, not the normal selector. - `row` and `column`: zero-based coordinates for table cells; otherwise null. Images are intentionally not editable through this interface. ## HTML content format The HTML body can replace the target with any number of paragraphs. For example: ```html

Parish News

Our first paragraph has italic text and a manual
line break.

A new indented paragraph.

  1. First lettered item
  2. Second item
``` Supported elements: - `

`: one Enter paragraph. - `
`: a manual line break inside a paragraph. - ``, ``/``, ``/``, ``, ``, ``: character formatting. - `