cltk / cltk_frontend

Reading environment connecting to API from cltk/cltk_api repo
http://archive.cltk.org
21 stars 18 forks source link

CLTK Archive Community Frontend

Join the chat at https://gitter.im/cltk/cltk_frontend GitHub tag GitHub license

Notice

The CLTK Archive application is currently under active development and is not ready for production.

About

The goal of this application is to provide a modern reading environment for documents included in the CLTK corpora. Dev builds will be put up at http://archive.cltk.org for the early stages of development. Text data is ingested from the cltk_json directories in the text repositories included in the GitHub organization.

Development

The CLTK frontend reading environment is built with create-react-app and GraphQL.

To get started developing, install yarn, clone this repository, and then also clone the cltk_community_api.

Cloning the repo

git clone https://github.com/cltk/cltk_frontend.git
cd cltk_frontend

Install dependencies

yarn

Running the app

yarn start

Project Goals and Status

The goal of this application to to provide an immersive multimedia reading environment that includes the related materials necessary for study of classical texts. When someone reads Latin, for instance, their desk will often be filled with several books draped over each other (the source text, a dictionary, a commentary, a translation, a notebook, etc). This reading environment will simplify the reading experience by providing all of those materials in a browser or on a mobile device. Read more about it on the CLTK ideas page.

The application is currently still in the initial stages of development. The code currently available in this repository is largely to serve as a guide for the visual appearance of the application when it is functional.

A list of targeted related materials that this application will seek to provide in addition to the source text:

We know that including all of these is possible and useful based on a previous iteration of this project available at segetes.io, which offers the works of Vergil with accompanying related materials such as these.

Deploying

The CLTK Archive app is currently deployed via Kubernetes on a cluster on Google Cloud Platform. This will be configured with Travis in the future.