feat(docs): add nexus page BBCode generator

[codepuncher]

Summary

Adds a Python script that generates Nexus Mods BBCode from the user-facing section of README.md, so requirements, installation, and compatibility only need to be maintained in one place.

• scripts/generate-nexus-page.py: reads README nexus block, converts Markdown→BBCode, injects into template, prints to stdout

Usage:

python scripts/generate-nexus-page.py
# pipe to clipboard:
python scripts/generate-nexus-page.py | xclip -selection clipboard

Testing

Ran the script and verified output matches expected BBCode structure.

Breaking Changes

Related

[Copilot]

Pull request overview

Adds a small documentation toolchain to keep Nexus Mods page BBCode in sync with the user-facing README content, reducing duplication between README.md and docs/nexus-page.md.

Changes:

• Added a Python script to extract a marked README block, convert limited Markdown to BBCode, and inject it into a Nexus page template.
• Added a <!-- nexus:start/end --> block in README.md containing Requirements/Installation/Compatibility intended for Nexus.
• Added <!-- generated:start/end --> markers inside the BBCode fence in docs/nexus-page.md to define the injection region.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
scripts/generate-nexus-page.py	New generator script: README block extraction, Markdown→BBCode conversion, and template injection to stdout.
README.md	Adds the Nexus-specific user-facing block (requirements/install/compatibility) bounded by markers.
docs/nexus-page.md	Adds generated block markers inside the BBCode template to support automated injection.

Comments suppressed due to low confidence (1)

scripts/generate-nexus-page.py:139

• Same issue as above: if the end marker is before the start marker, the error only references the start marker constant. Please include both markers (or indices) to make the failure actionable when the template is malformed.

    if start >= end:
        sys.exit(f"error: end marker appears before start marker: {GEN_START!r}")

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

scripts/generate-nexus-page.py:146

• inject_generated() finds GEN_END with bbcode_content.find(GEN_END) from the beginning of the BBCode block. If <!-- generated:end --> appears earlier than the intended region (or if multiple regions exist), this can select the wrong end marker and break injection. Find GEN_END starting after GEN_START (e.g., bbcode_content.find(GEN_END, start + len(GEN_START))) and consider checking for multiple occurrences to avoid ambiguous templates.

def inject_generated(bbcode_content: str, generated: str) -> str:
    start = bbcode_content.find(GEN_START)
    end = bbcode_content.find(GEN_END)
    if start == -1:
        sys.exit(f"error: marker not found: {GEN_START!r}")
    if end == -1:
        sys.exit(f"error: marker not found: {GEN_END!r}")
    if start >= end:
        sys.exit(f"error: end marker {GEN_END!r} appears before start marker {GEN_START!r}")
    return (
        bbcode_content[:start]
        + GEN_START + "\n"
        + generated + "\n"
        + bbcode_content[end:]
    )

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.