Grant interface promise: Read-only visualization surface

Đang mở
#576 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
20/100
Loại issue
Tính năng
Độ rõ ràng
Cần làm rõ
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript
Lĩnh vực
frontend

Hướng nghiên cứu

Start by reading components/read-only-transcribe/index.js and interfaces/project/view-transcription.html to understand the existing single-project viewer. The issue leaves the surface, access model, data freshness, and collection scope undecided, so implementation needs planning before work can be scoped; first clarify those choices with maintainers. Done means delivering an agreed read-only visualization experience that supports the selected access and project scope.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement needs-triage

This was generated by AI during triage.

Grant promise: Read-only visualization surface (Workstream 2 — "better interfaces", feeds workstream 3 aggregation)

The NEH grant narrative promises read-only visualization of TPEN project content — public/curated viewing that goes beyond the current single-project transcription viewer, toward browsable, shareable, aggregate presentations of transcription and annotation work.

What exists today (verified on main, 2026-11)
  • One read-only viewer, single-project, static: components/read-only-transcribe/index.js (tag tpen-read-only-view-transcribe), hosted at interfaces/project/view-transcription.html (route /project/view-transcription, og:url points at app.t-pen.org/components/read-only-transcribe/?projectID=).
  • It is effectively unreachable: repo-wide, view-transcription appears only in that page itself and the route list in 404.html:212 — no interface links to it. Tracked and briefed for a fix in #458 (ready-for-agent: add the manage-home link).
  • Collections are a dead stub (api/TPEN.js:33 — collectionID parsed, never consumed; collection-level import listed as future work in components/manifest-import/IMPLEMENTATION.md:252), so there is nothing to visualize at collection/aggregate level.
  • Everything viewer-adjacent is authentication-gated (components/check-permissions, tpen-screen flow) — there is no unauthenticated read path.
What's missing
  • A visualization layer: presentation modes beyond "read the transcription" (e.g., per-page mosaic, contributor/progress view, annotation density) rendered from RERUM/TinyPEN data.
  • Public or link-shared access without login (ties directly to #472's questions).
  • Collection/cross-project scope — the aggregation story of workstream 3 begins here.
  • Share/embed affordances (permalink to canvas/line, iframe embedding, IIIF Presentation export wiring).
Not yet decided
  • Is the surface a TPEN-hosted page, an embeddable web component for external sites, or both?
  • Access tiers: fully public vs token-shared vs curated-list "exhibition" mode.
  • Data freshness: live RERUM reads vs periodically exported snapshots (affects services/rerum_server_nodejs).
  • Relationship to read-only exported projects (existing static export flow) — consolidate or deprecate.
Related
  • #458 (entry link for the existing viewer — ready-for-agent) and #472 (unauthenticated UX incl. "search TPEN Projects" / Manuscripts-Browser idea — needs-triage): the maintainer approved treating these as this promise's anticipators rather than duplicating them; scope them into this promise during January 2027 planning.
  • CenterForDigitalHumanities/TPEN-interfaces#581 ("Readonly Viewer") and CenterForDigitalHumanities/TPEN-interfaces#582 ("Browse Available Manifests") — historical anticipations misfiled in the TPEN3 docs repo; migration is a separate maintainer decision.
Ngôn ngữ chính
JavaScript
Star
2
Fork
3
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của CenterForDigitalHumanities/TPEN-interfaces

Tất cả issue của CenterForDigitalHumanities/TPEN-interfaces

Issue tương tự

Thêm issue về JavaScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.