cgit.git, branch main

md2html: auto-link bare repo paths in rendered markdown

2026-07-18T20:58:15Z

Detect path tokens in prose (must contain a "/") and inline

 spans
(matched verbatim, so bare Makefile/README link too) and turn them into
links to the tree/ (or about/ for *.md) view — but ONLY when the token
resolves to a path that actually exists in the repo, which we learn from
`git ls-tree -r -t` at the default branch.  code blocks, existing
 links (no nested anchors) and tag attributes are never touched;
tokens resolve relative to the rendered file dir or the repo root.



ui-tree: render folder README under the directory listing
2026-07-18T19:31:00Z
When browsing a tree, detect the best README (readme[.md/.markdown/.mkd/
.rst/.txt] or bare, case-insensitive, most-preferred extension wins) among
the directory entries and render it through the about-filter beneath the
file list, GitHub-style. The filter gets the readme path as argv[1] so the
md2html relative-link rewriting resolves against the readme dir.


build: fix empty version on tagless clones; mark version -sl0p
2026-07-18T19:31:00Z
gen-version.sh unconditionally overwrote the Makefile-provided version
with `git describe` output, which is empty on a plain clone of the fork
(no tags) — so cgit_version rendered blank in the footer and generator
meta. Only override when describe yields something. Also bump the base
version to v1.3.1-sl0p so the version string itself names the fork.


ui-shared: signal the sl0p fork in the footer + generator meta
2026-07-18T19:31:00Z
Append a "sl0p fork" link (to git.sl0p.foo/cgit.git) to the default
footer after the generated-by cgit/git attribution, and tag the
 as "cgit  (sl0p fork)". Keeps upstream
attribution intact.


md2html: do not loosen tight lists with multi-line items
2026-07-18T19:31:00Z
The list-interrupt preprocessor inserted a blank line before any bullet
that followed a non-item, non-4-space-indented line. When a list item
wrapped onto a 2-space-indented continuation line, the *next* item looked
like a paragraph->list transition, so a blank got injected between items
— turning a tight list into a loose one (every  wrapped in ), as
seen in docs/internals.md "Writing programs in C".

Track list state and only interrupt an actual paragraph: a bullet that
continues an already-open list (or its indented continuation lines) no
longer triggers a blank-line insert. The original paragraph->list
interrupt and the "1985." ordered-list guard are unchanged.


md2html: render linked .md via the about view, fix relative base
2026-07-18T19:31:00Z
Links to markdown files now point at //about/ (rendered
through the about-filter) instead of //tree/ (raw blob), so
clicking a README link to another .md shows rendered markdown.

Also resolve relative links against the rendered file's own directory:
about-formatting.sh now forwards the filename cgit passes ($1) to
md2html as argv[1], and md2html uses dirname(argv[1]) as the base. This
makes links *inside* a rendered subpage (docs/foo.md -> ./bar.md,
../README.md, images) resolve correctly. Non-markdown files and
directories still go to tree/; images to plain/; about/ links carry no
?h= since the about view renders against the configured readme ref.


md2html: rewrite relative README links to the tree/ blob URL
2026-07-18T19:31:00Z
The image-rewrite patch only fixed relative ; relative 
links (e.g. [docs/x.md](docs/x.md)) were still resolved by the browser
against the about/summary page URL, not the repo root, so they 404d.

Rewrite relative  to absolute cgit URLs the same way:
  in-repo path -> //tree/?h=
  ../sibling   -> resolved against the repo URL location (/)
Fragments are preserved; anchors, absolute, scheme and query-only URLs
are left untouched.


md2html: let bullet/1. lists interrupt paragraphs (GitHub-style)
2026-07-18T19:31:00Z
Python-Markdown, unlike CommonMark/GitHub, refuses to start a list that
immediately follows a paragraph line without an intervening blank line, so a
very common README shape renders as one run-on paragraph:

    Passing:
    - foo
    - bar

Add a preprocessor that inserts the blank line when a bullet (- * +) or a
1./1) ordered marker follows a paragraph line, restoring GitHub behavior.
Only '1' interrupts for ordered lists (matching CommonMark) so prose like
'... the year\n1985. was ...' is not turned into a list. Fenced/indented
code and lines already inside a list are left untouched.


md2html: rewrite relative image links to the plain/ blob URL
2026-07-15T14:13:14Z
A README's relative image paths (screenshots/foo.png) are repo blobs that
cgit only serves via its plain command, but a browser resolves a relative
 against the about-page URL, so the image 404s. Rewrite relative
 to an absolute //plain/?h= URL using the
CGIT_REPO_URL / CGIT_REPO_DEFBRANCH environment cgit gives the about-filter.
Absolute so it also works with ui-summary readme rendering.


ui-summary: optionally render the repo readme on the summary page
2026-07-11T20:19:08Z
Add enable-summary-readme (global + per-repo repo.enable-summary-readme,
default off). When enabled, the configured readme is rendered inline below the
repository info on the summary page, in addition to the standard about page.

Refactor the readme-rendering core out of cgit_print_repo_readme() into a
static print_readme() helper (no layout wrapper) so the about page and the
summary page share it.