Grant interface promise: Chart, ledger and tabular transcription interface

未关闭
#574 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
20/100
Issue 类型
功能
描述清晰度
需要澄清
活跃度
活跃
技术栈
javascript
领域
design, frontend

调研方向

Read components/transcription-block/index.js and components/simple-transcription/ARCHITECTURE.md to understand the current line based interfaces, then inspect interfaces/manage-columns/index.js and the referenced Annotorious line parser. The issue leaves the grid model, persistence contract, drawing mode, and host interface undecided, so implementation needs design decisions and coordination with TPEN-services; no completion criteria or test is specified.

由索引模型根据 Issue 内容生成。

描述

enhancement needs-triage

This was generated by AI during triage.

Grant promise: Chart, ledger and tabular transcription interface (Workstream 2 — "More and better interfaces")

The NEH grant narrative promises interfaces for tables, ledgers and charters — documents whose structure is cells and rows-with-columns, not a sequence of text lines. Today every transcription surface in TPEN-interfaces is line-oriented.

What exists today (verified on main, 2026-11)
  • The atomic editing unit is one line = one single-line text input: components/transcription-block/index.js:647 (<input type="text" class="transcription-input"> with Prev/Next stepper); the same line model drives components/simple-transcription/ (see components/simple-transcription/ARCHITECTURE.md:56 — "Active project graph (layers/pages/columns)").
  • The closest structural analogue is column management — grouping lines into vertical columns of a manuscript page: interfaces/manage-columns/index.js:9–10 ("create, merge, and extend columns for organizing line annotations"). Columns organize lines; they are not a grid, and there is no notion of a cell.
  • No table/grid/spreadsheet component exists anywhere in components/ or interfaces/ (full-backlog triage scan, 2026-07).
What's missing
  • A cell-addressed editing surface: rows × columns with stable cell identity, keyboard tab-order, per-cell transcription content.
  • Region model for grids: drawing/editing a table structure on the canvas (header row, column separators) so cells map to image regions — likely built on the Annotorious rectangle/polygon tooling (components/annotorious-annotator/line-parser.js:762–763) but with grid semantics instead of line semantics.
  • Persistence mapping: how a grid serializes through RERUM/Web Annotation (one Annotation per cell? one per row with a structured body?) — a TPEN-services/RERUM contract question (phase issues TPEN-services#509–#511, #512).
  • Ledger/chart-specific behaviors: running totals, date columns, struck-through rows — evaluate whether these are data or just display.
Not yet decided
  • Grid vs keyed-record model: should a ledger row be one annotation with fields (closer to transcription search in workstream 3) or a matrix of cell annotations?
  • Reuse of the line-parser zone tools vs a dedicated table-shape drawing mode.
  • Which existing interface hosts it: new tool inside interfaces/transcription/ family vs standalone /project/table surface.
Related
  • No TPEN-interfaces backlog issue anticipates tabular editing; nearest relatives are #287 (interface-tool taxonomy) and #160 (tool design musings).
  • CenterForDigitalHumanities/TPEN-interfaces#579 ("Organize Grouping Structures within a Canvas") is a partial historical anticipation, 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. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

CenterForDigitalHumanities/TPEN-interfaces 的其他 Issue

查看 CenterForDigitalHumanities/TPEN-interfaces 的全部 Issue

相似的 Issue

更多 JavaScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。