This repository contains the code needed to build thejonx.com and generates thejonx.github.io. When a pull request is merged into the master branch, Travis CI pulls the repository, builds the new site, and pushes a staged version to live/ in the stage-live branch upon successfully building the changes. The live directory is then synchronized with our production web server.
Because Jekyll generates The Jonx's website, we strongly recommend setting up a Ruby development environment. This will make it easier for you to generate pages and see the results of your work. However, if you do not wish to do this, you can manually add markdown files to the _posts/ or _pages/ directories. Files in the _posts directory will result in new blog posts being added to The Jonx's Project Blog. Files in the _pages/ directory populate the pages on The Jonx's web site.
To begin, you'll need a github account and git installed on your computer. Once that's out of the way, install Ruby and configure git as described on GoRails. Finally, run bundle install to install all gems needed to build the site. If you're an advanced user, you might want to get started with an isolated, pre-made Jekyll environment like a Docker container or a Vagrant image.
To add a new page, make and create a new branch with git checkout -b <mynewstuff> and run rake page:create. You can add new blog posts with rake post:create. Once you've added content to your new page or post, rake site:watch will build the site and host it at http://localhost:4000. It even automatically updates your changes!
When your new site is ready, use git add to stage the new files, git commit -m 'Add new page with a super awesome commit message' to add a message to the commit log, and git push origin <mynewstuff> to push the changes to the internet. Your change will be merged in as soon as someone reviews it and be posted to the internet soon!
If you have any trouble setting up a development environment or suspect a bug, please open an issue.