Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tomtom828/kean-wwii
Helping Kean University digitize & share their WWII archives!
https://github.com/tomtom828/kean-wwii
aws-s3 digital-humanities express google-maps handlebars mysql node-js
Last synced: 9 days ago
JSON representation
Helping Kean University digitize & share their WWII archives!
- Host: GitHub
- URL: https://github.com/tomtom828/kean-wwii
- Owner: tomtom828
- Created: 2017-01-06T00:43:41.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-26T17:15:08.000Z (almost 2 years ago)
- Last Synced: 2024-04-19T18:36:07.857Z (7 months ago)
- Topics: aws-s3, digital-humanities, express, google-maps, handlebars, mysql, node-js
- Language: Handlebars
- Homepage: http://www.worldwariiscrapbook.com
- Size: 159 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Kean WWII Digital Library
A Freelance Web Development project to help the Kean University history department with their WWII archives.
Please view the website at [www.worldwariiscrapbook.com](http://www.worldwariiscrapbook.com).The archives are a collection of letters from WWII soldiers written to a Kean librarian during the war.
This project was a continuation of the code developed by a [Kean Student](https://github.com/joseph-galindo/digital-library-kean), where PHP was replaced with NodeJS, the UI was re-done, and more pages and functionality were added.
## Functionality
On the backend, the app uses the `Express` server for `NodeJS` as well as `MySQL` to interact with a database of archive names, author information, and location coordinates.
On the frontend, the app uses `Handlebars` for templating and `Bootstrap` as a styling framework. The app also uses `jQuery` and `AJAX` for a more responsive user experience.
The scanned copies of the archives, soldier photographs, and text transcripts of the archives are hosted on `Amazon S3`.
The application also uses the `Google Maps API` to plot each soldier's movement during WWII.
## Cloning down the repo
If you wish to clone the website down and run it on localhost...
1. Ensure that you have MySQL and NodeJS set up on your laptop.
2. Once you are set up, `cd` into this repo and run `npm install`.
3. Then seed the database using MySQL Workbench.
- The schema is found in `models/db.sql`.
- Also double check that the localhost connection is correct in `models/dbInfo.json`.
4. Run the server with `node server.js`.
5. Navigate to `localhost:8080` in your browser.## Future Kean Developers!
Feel free to fork this repo.
Then refer to the documentation stored in the [email protected] account.
The account's Google Drive will contain a document with instructions on how to add yourself as a collaborator.## Screenshot
![WWII Scrapbook Landing Page](/screenshots/homepage.png)