Keep a description's headings, bullets and paragraphs, and draw them in the reader

The readers flattened a posting's HTML into one line with strip_html, so
sections and bullets ran together. _shared.html_text gives a line per
paragraph, '• ' before a list item and '## ' before a heading; every
reader's description goes through it, sections read per role get their
own headings, and the reader pane draws the lines as h3, ul and p.
Excerpts leave the marks out.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
WolfandClaude Opus 5.5 committed 2026-09-30 21:40:12 +02:00
1 parent 17e7615599
commit c497fe965d
44 files changed
+300 -147

No files matched your search

+5 -6
View File
@@ -15,15 +15,13 @@ reads and stops on one.
from __future__ import annotations
import html
import json
from collections.abc import Callable
from typing import Any
from desk.sources import strip_html
from ._contract import Ask, Fields, Place, Reads
from ._shared import Get, Page, Row, add_place, only, parse_dt, path_slug_ok
from ._shared import Get, HEADING, Page, Row, add_place, html_text, only, parse_dt, path_slug_ok
NAME = "workable"
LABEL = "Workable"
@@ -146,7 +144,8 @@ def detail(get: Get, slug: str, row: Row) -> dict[str, Any]:
raise ValueError("not a Workable role: no description")
parts = []
for key in _PARTS:
text = " ".join(html.unescape(strip_html(str(data.get(key) or ""))).split())
if text:
if text := html_text(data.get(key)):
if key != "description":
parts.append(HEADING + key.capitalize())
parts.append(text)
return {"description": " ".join(parts)}
return {"description": "\n".join(parts)}