Skip to content

Two new link-render-style modes: short and number-and-title - #575

Open
fare wants to merge 10 commits into
racket:masterfrom
fare-patches:links
Open

fare wants to merge 10 commits into
racket:masterfrom
fare-patches:links

Conversation

@fare

@fare fare commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor
  • Add two new link-render-style modes for section references such as secref:
    'short renders §N.M; 'number-and-title renders §N.M “Title”.
    Each reference is hyperlinked as a unit.
    For unnumbered targets, 'short falls back to the plain title
    and 'number-and-title to the quoted title.
  • Implement both modes for local references in HTML and LaTeX/PDF output.
    In LaTeX, they bypass the section-reference macro family and
    use the existing hyperlink and character-escaping machinery,
    preserving the reference's style.
    External references retain the existing rendering behavior.
  • Documented both modes on link-element and link-render-style in scribble/core,
    including the per-backend fallback behavior for unnumbered sections.
  • Add HTML and LaTeX rendering tests for numbered and unnumbered sections,
    empty titles, targets without numbering metadata and
    preservation of LaTeX color properties.
  • Bumped scribble-lib's version to 1.69.
  • Small drive-by comment cleanup in autobib.rkt/bibtex.rkt left over from the previous PR (no functional change).

Coded by Claude Sonnet 5, reviewed by GPT 6 Sol, supervised by this meatbag.

@github-actions github-actions Bot 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.

Resyntax analyzed 6 files in this pull request and has added suggestions.

Comment thread scribble-lib/scribble/html-render.rkt Outdated

@github-actions github-actions Bot 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.

Resyntax analyzed 8 files in this pull request and has added suggestions.

Comment thread scribble-lib/scribble/html-render.rkt Outdated
@fare fare changed the title [WIP] Two new link-render-style modes: short and number-title [WIP] Two new link-render-style modes: short and number-and-title Sep 30, 2026

@github-actions github-actions Bot 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.

Resyntax analyzed 8 files in this pull request and has added suggestions.

Comment thread scribble-lib/scribble/html-render.rkt Outdated
and-let-to-cond: Using cond allows converting let to internal definitions, reducing nesting

@github-actions github-actions Bot 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.

Resyntax analyzed 8 files in this pull request and has added suggestions.

Comment thread scribble-lib/scribble/html-render.rkt
@fare fare changed the title [WIP] Two new link-render-style modes: short and number-and-title Two new link-render-style modes: short and number-and-title Sep 30, 2026

@github-actions github-actions Bot 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.

Resyntax analyzed 8 files in this pull request and has added suggestions.

Comment thread scribble-lib/scribble/html-render.rkt
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

@github-actions github-actions Bot 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.

Resyntax analyzed 8 files in this pull request and found no issues.

@github-actions github-actions Bot 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.

Resyntax analyzed 8 files in this pull request and found no issues.

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.

1 participant