Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

openProject( resource, interface )

Open
#19 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
html
Domain
frontend

Research direction

Start by locating the openProject(resource, interface) entry point in the TPEN3 codebase and inspect how interfaces are selected. Define the behavior for TPEN Project, Manifest, Canvas, Image, and Annotation resources, including the default transcription interface; done means the method returns the TPEN Project object to the selected interface.

Written by the indexing model from the issue text.

Description

methods

Initialize or continue a project and open in the mentioned interface.

@params

resource ( String | Object )

Object or resolvable path to object on which the interface is based. One of:

  • TPEN Project—config object with references to sc:Manifest and project settings.
  • Manifest—sc:Manifest object to render in the interface. If no reference to an existing project is found, initialize a new one.
  • Canvas—sc:Canvas object to render in the interface. Conceal any Manifest-level interactions in the interface.
  • Image—any image-type acceptable to the interface specified. Create a sc:Canvas to initialize the interface and reference in saved annotations.
  • Annotation—any specific oa:Annotation may be rendered in a viewing interface for read only access or individual manipulation.

In the future, it may be possible to pass in arrays of individual objects, though this may be relegated to some middleware.

interface ( String )

Optional keyword or URI for interface within which to open the referenced resource. Default is "transcription" within TPEN, but may also send out the response to an alternative interface. The only available interface planned within TPEN for now is transcription, but RERUM may provide for canvas annotation, text markup, simple manifest generation, etc.

@returns
Response sends the TPEN Project object to the interface.

Dominant language
HTML
Stars
5
Forks
0
PR merge metrics
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from CenterForDigitalHumanities/TPEN3

All issues in CenterForDigitalHumanities/TPEN3

Similar issues

More Web Dev issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.