This README.txt file was generated on 2019-11-11 by Hannah Gunderman (hgunderm@andrew.cmu.edu)

-------------------
GENERAL INFORMATION
-------------------

1. Title of Dataset: Source code for Asterisk, https://asterisk-236319.appspot.com, an Artists Book created for Jim Daniels' Advanced Poetry Workshop (H&SS), April 2019 


2. Author Information

First Author Contact Information
    Name: Julia Hou
    Institution: Carnegie Mellon University, School of Computer Science
    Address: 5000 Forbes Avenue, Pittsburgh, PA 15213
    Email: jjhou@andrew.cmu.edu

---------------------
DATA & FILE OVERVIEW
---------------------

created-index.zip contains the source code for the Flask app that originally rendered this webpage.
-	Python version: 2.7
-	Flask version: 0.12

Asterisk.zip contains the rendered HTML, CSS, and JavaScript files created by the Flask app. 
You may view the final product via these files without needing to re-generate the application from Python/Flask. 
See additional notes below for suggestions on how to run the work on your local computer.

Additional Notes on File Relationships, Context, or Content 
(for example, if a user wants to reuse and/or cite your data, 
what information would you want them to know? Are there restrictions
on sharing?):   
           
Contextual information on project development: 
"I used three.js, which is a Javascript library. I made it into a Flask web app (which is in Python) in order to deploy it to Google App Engine. 
I should also mention--if you look at the source code, you'll see that the repository is a fork of someone else's project. 
I was initially inspired by this other project, and decided to use their code as a foundation for my project. I made a lot of modifications (the original project was meant to be a game of some sort, 
so I had to change a bunch of things to serve my purposes), but it was building on top of the other project. I was initially inspired by this other project (created-index); I saw a world made out of letters
and words and I thought it would make a really cool poetry project. I started out with the idea of being immersed in a world built of words and wrote the poem based on this idea. 
I wanted to play with the idea of control--the main character has a complicated relationship with language, and tries to overcome it, but it seems hopeless, and 
they ascribe this failure to some higher power (hence the mention of God in the last couple lines), but really it's the main character's own words holding them back.
I'm hoping to turn this into a virtual reality project to enhance the sense of immersion in this world, but that will require VR knowledge and a headset, so more of a semester-long project, probably.”


--------------------------
METHODOLOGICAL INFORMATION
--------------------------

#
# Software: If specialized software(s) generated your data or
# are necessary to interpret it, please provide for each (if
# applicable): software name, version, system requirements,
# and developer.
#

1. Software-specific information:

Name: GitHub (repository)
Source Repository URL: https://github.com/juliahou/created-index


Additional Notes:

To view this work on your local computer, unzip Asterisk.zip. You must start up a local webserver within that directory in order for your browser to run the necessary JavaScript code. 
For example, if you have Python 3+ installed on your machine, from the command line:
 
cd Asterisk/
python3 -m http.server 8000
 
Now navigate to http://localhost:8000 in your web browser to view the work.


3. Date of data collection (single date, range, approximate date): Project completed in April 2019