Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/portfolio.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,11 @@ We are especially interested in projects supporting researchers, focused on rese
**[iSpraak](project_ispraak/about.md)** - This project is to automate speech evaluation of language learners and to provide them with instantaneous corrective feedback.


## External Projects

**[TPEN Interfaces](project_tpeninterfaces/about.md)** - The TPEN Interfaces project provides a set of customizable web interfaces that leverage the TPEN Services API.


## Other Projects

- ML Code Generator
Expand Down
63 changes: 63 additions & 0 deletions docs/project_tpeninterfaces/about.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: TPEN Interfaces
custom_edit_url: https://github.com/oss-slu/TPEN-interfaces
---
<!-- A header image is optional; if used should be no greater than 200x600 -->
<!--![Header Alt Text](header.png) -->
![TPEN logo](tpen_logo.png)

## Overview

These vanilla default and internally useful interfaces for the TPEN ecosystem that exemplify how you might build your own interfaces for specific projects. The directories each contain a named interface that serves as an example for how an external developer might use the TPEN Services API to implement a custom interface that leverages the TPEN platform. Interfaces are typically a web application, a simple HTML document, that utilizes Web Components that might be reused by others.


### Information

- **Source Code:** [https://github.com/oss-slu/TPEN-interfaces](https://github.com/oss-slu/TPEN-interfaces) [<img src="/img/git-alt.svg" alt="git" width="25" height="25" />](https://github.com/oss-slu/dads)
- **Client** Dr Artia Larson
- **Current Tech Lead:** Sowmya Mutya [<img src="/img/github.svg" alt="github" width="25" height="25" />](https://github.com/MutyaSowmya123) [<img src="/img/linkedin.svg" alt="linkedin" width="25" height="25" />](https://www.linkedin.com/in/sowmya-mutya-7576211a0/)
- **Developers:**
- Patrick Cuba (SLU Research Computing Group) [<img src="/img/github.svg" alt="github" width="25" height="25" />](https://github.com/cubap)
- Bryan Haberberger (SLU Research Computing Group) [<img src="/img/github.svg" alt="github" width="25" height="25" />](https://github.com/thehabes)
- Victor Onoja (Web Developer) [<img src="/img/github.svg" alt="github" width="25" height="25" />](https://github.com/jsvoo)
- **Start Date:** Jan, 2023
- **Adoption Date:** Aug, 2024
- **Technologies Used:**
- Tech Stack- Web pages accessing TPEN API services
- Key Languages- HTML, CSS, JavaScript

- **Type:** Web application
- **License:** Primary Developers: Bryan Haberberger and Patrick Cuba © 2023 Research Computing Group at Saint Louis University

### User Guide

- **Public website** - Users can access the TPEN public website using the [link](https://t-pen.org/TPEN/). This version of TPEN (2.8) allows users to attach transcription data (either new or uploaded) to the actual lines of the original manuscript in a simple and flexible interface.
- **TPEN3 Interfaces** -
The directories here each contain an example of an interface that uses the TPEN authentication and interactions with the TPEN platform. For instance, the default location for transcription is TPEN Transcription Interface, which returns the file in /transcribe/index.html. If a project involves specialized transcription, such as music, the configuration can direct users to a custom location, like https://example.com/musicproject/interfaces/transcribe.html, with the project ID included in the query string. Examples of best practices include:

- `index.html`: The default interface to launch,
- Supporting files: `*.js`, `*.css`, `*.html`, etc.,
- Configuration files: `manifest.yml` or `manifest.json`

## Technical Information

### Technical Overview

The TPEN Interfaces project follows a layered architecture, consisting of front-end user interfaces built using HTML, CSS, and JavaScript that communicate with the TPEN Services API. This architecture allows developers to create custom interfaces by leveraging existing TPEN components and services. Below is a high-level overview of the architecture:

![Architecture](tpen_architechture.png)

### Development Priorities

- **Development priorities for TPEN interfaces:**
- Developing interface examples for external developers to use as templates.
- Customizable interfaces include:
- Classroom group management
- Musical transcription
- Project toolsets
- Alternative languages and alphabets
- **Current Priority:** The Classroom Group Interface, which is a suite of interfaces for creating and managing TPEN groups. This interface focuses on setting permissions for roles. Permissions determine access to various resources and dictate what visualizations might be needed within the interface.

## Get Involved

If you would like to contribute to this project, please visit our [GitHub page](https://github.com/oss-slu/TPEN-interfaces) to create your own issues or pull requests.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/project_tpeninterfaces/tpen_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.