Skip to content

Document TeX Live installation and fix CTAN links - #2

Merged
edel67 merged 1 commit into
mainfrom
codex/ctan-installation-docs
Oct 9, 2026
Merged

edel67 merged 1 commit into
mainfrom
codex/ctan-installation-docs

Conversation

@edel67

@edel67 edel67 commented Oct 9, 2026

Copy link
Copy Markdown
Owner

Summary

Document TeX Live installation and make README links work independently of CTAN's relative-path and heading-anchor handling.

  • Lead with tlmgr install terminaltrees, with guidance for OS-managed installations and a manual fallback.
  • Use absolute URLs for the comparison image, manual, example source, manifest, and license.
  • Replace the unsupported section jump with a plain section reference.

The package code, tree geometry, and image-generation workflow are unchanged.

Verification

  • Installed v1.0.0 into an isolated TeX Live user tree and compiled natural-size and fitted examples. The recorder confirmed use of the installed package.
  • Passed python3 terminaltrees-tests/check.py --preview, including all ten expected rejection cases.
  • Built the manual and distribution archive. Visually checked the five-page manual and revised installation page.
  • Verified the comparison image and keyboard activation of its zoom link in a local README preview.

The install test reused existing dependencies. TeX Live reported a missing repository signing key; the installed package matched the released source byte-for-byte. MiKTeX and Overleaf execution were not tested. CTAN's rendered README needs a separate check after submission.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The documentation changes are consistent, accurate, and limited in scope.

0 open findings

What changed in this PR

Documents package installation and makes README resources usable from CTAN-rendered contexts.

Changes:

  • Adds TeX Live, OS-managed, and manual installation guidance.
  • Replaces relative resource links and an unsupported anchor link.
File Description
terminaltrees-doc.tex Expands installation instructions.
README.md Updates installation guidance and external links.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@edel67

edel67 commented Oct 9, 2026

Copy link
Copy Markdown
Owner Author

Thanks for the review. No findings need changes. The check passed on e3e51d9. CTAN rendering will be verified after the documentation update is submitted.

@edel67
edel67 marked this pull request as ready for review October 9, 2026 19:49
@edel67
edel67 merged commit a644ebc into main Oct 9, 2026
2 checks passed
@edel67
edel67 deleted the codex/ctan-installation-docs branch October 9, 2026 19:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants