This repository houses the source code for the Simple app website.

We use Middleman to build the static pages which are hosted on GitHub Pages.

To run the site on your own machine, simply clone the repo, install the packages necessary, and start up a Middleman server.

$ git clone [email protected]:resolvetosavelives/simple.org.git
$ cd simple.org
$ bundle install
$ middleman server

After merging your commits to master and pulling the latest, run rake publish.

Error: src refspec gh-pages does not match any

1. Run git pull origin master
2. Run git fetch
3. Run rm -rf build to delete your build/ directory
4. Run rake publish

Error: Could not find middleman-blog-4.0.3 in any of the sources

1. Make sure you have the proper ruby version installed. Note: If you're using rvm, run rvm use 2.5.1 to use Ruby version 2.5.1.
2. Run rm -rf build to delete your build/ directory
3. Run rake publish

To add a new contributor to simple.org/about, do the following:

1. Add a contributor item to data/contributors.yml
2. Open locales/en.yml for a list of available roles and countries. Note: Please make sure the string you set in contributors.yml exactly matches the key in the en.yml file. Otherwise the role/country will display an error.
3. Make sure the contributor is properly displayed in your local
4. Merge and deploy (if you have deployment issues, check "Deployment" section below)

To add a new blog article, do the following:

1. Create a new branch: Pull the lastest from master and create a new branch.
2. Create a new file: Add a new file in source/blog/ using the following extension and naming convention: year-month-day-my-new-article.html.erb.
3. Paste front-matter: Open an old article in source/blog/ and copy and paste the front-matter content to your new article.
4. Update front-matter: Update the front-matter variables with your content. Note: Make sure to wrap all variable content within " ".
5. Set an author: If the article's author is a contributor listed in data/contributors/yml, make sure to add their exact name in the author variable. If the author isn't a contributor, follow the "Add a new contributor to Simple.org" instructions above before proceeding.
6. Add article images: Add your article images in /images/blog/my-new-article/.
7. Image placeholders: Re-export your images with a width of 50px and a Figma layer blur of 1. Image placeholders are used to lazy-load images and reduce initial page load times.
8. Create your content: Use an existing article for reference to properly format and structure your article's content. There are no wrapping divs around the content—it's just a bunch of sections and image divs!
9. Merge to master: Check your article in your local on small and large devices. Once it's ready merge into master.
10. Publish your article: Follow the instructions in the "Deployment" section above to publish your new article.

If you have any questions Slack Claudio or send him an email at [email protected]