itp-xstory / website

Experiments with Storytelling.

xStory website

1. What is XStory?
2. Getting started
   • Setting up the enviorment
   • Setting up the website
3. Contributing
   • Adding a project
   • Deploying the website
   • Build commands

What is XStory?

ITP xStory is an organization dedicated to support, to promote and to publish innovative creative projects and tools in the field of digital storytelling and digital art, by ITP studets and alumni. The organization vision is to reach as many digital creators as possible, to inspire them with cutting edge ideas and creation tools, and to build a community of explorers around these ideas. The organization is sponsored and supported by NYU ITP.

Getting started

Setting up the enviorment:

• Install node by downloading the right OS installer from here
• On macOS, install Homebrew from here
• Once you have brew installed, install yarn by running

brew install yarn

Finally install gatsby globally by running

yarn global add gatsby

Setting up the website:

• Clone the repository to your computer

git clone https://github.com/ITP-Xstory/website.git

• Enter the repository folder and install dependencies

cd website && yarn install

• Finally run the development server by running

yarn run develop

Contributing

Adding a project:

The projects are automaticly created from markdown files stores in src/pages/projects. The project markdown format is:

---
path: '/awesomeproject'
date: '2018-05-23T12:34:00+00:00'
title: "Awesome Project"
tags: ['Awesome', "ML", "Experiment", "Immersive"]
thumbnail: 'https://cdn.awesomene.ss/awesomeproject.gif'
excerpt: "The tagline to be shown under the project in the front page"
---
The project description for the generated project page

To add a new project simply create a new projectname.md file in the src/pages/projects/ folder in the mentioned format, the rest is history.

Deploying the website:

The master branch of the repository uses TravisCI to test and deploy the website to the gh-pages branch (which is linked to the domain) on every commit to master. Please DO NOT commit directly to master, but commit to a branch and Pull Request to master once you have finished updating the website, we trust you 🤝.

Build commands:

• yarn run develop - runs a development server on localhost:8000
• yarn run format - runs prettier to format the code
• yarn run build - builds a static version of the website to public/ which doesn't get commited
• yarn run deploy - builds and deploys the static website the gh-pages branch. It should not be called by used, because TravisCI calls it on every commit to master

website's Issues

Add loader for the 3D scan so you know it's coming

Be nice to people...

Improve page tagging for better SEO indexing

I feel like here it's done really well, perhaps we can port some of the ideas.

Add WebGL banner with 3D scan of ITP

[Dependency] bootstrap

a security alert from GitHub
https://github.com/ITP-xStory/website/network/alerts

add favicon

I'm obsessed with favicons.

Image link is broken

Resolve critical security alerts

Add documentation

• How to install
• How to deploy to gh-pages
• How to add projects

Submission form 📝

• Personally I would split the names, portfolios and emails to three separate input boxes
• Is it possible to have a plus button for them? like you get one by default and then you add more if you need more?