Grant interface promise: Read-only visualization surface

オープン
#576 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
20/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
活発
技術スタック
javascript
領域
frontend

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

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.
主要言語
JavaScript
スター
2
フォーク
3
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

CenterForDigitalHumanities/TPEN-interfaces のほかの issue

CenterForDigitalHumanities/TPEN-interfaces の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。