There are sources for documentation pages: https://parallels.github.io/vagrant-parallels/docs/

This is a Middleman project, which builds a static site from these source files.

If you find a typo or you feel like you can improve the HTML, CSS, or JavaScript, we welcome contributions. Feel free to open issues or pull requests like any normal GitHub project, and we'll merge it in.

Running the site locally is simple. Clone this repo, switch to website/docs/ and run the following commands:

$ bundle
$ bundle exec middleman server

Your local copy of the site should be available by this URL: http:https://localhost:4567

This example describes the deployment process of our official documentation site, https://parallels.github.io/vagrant-parallels/docs/. You will need write permissions for the GitHub repo which you want to deploy to.

Make sure your current working directory is website/docs/. Then clone "gh-pages" branch from the target repo to ./build directory.

$ git clone -b gh-pages https://github.com/Parallels/vagrant-parallels ./build

If you want to deploy to your fork, put the URL of your fork repo instead:

$ git clone -b gh-pages https://github.com/<YOUR_USER>/vagrant-parallels ./build

Then run this command to build static pages with Middleman and deploy them to the repo you've cloned before:

$ bundle
$ bundle exec middleman deploy --build-before

The site should be available on GitHub: https://parallels.github.io/vagrant-parallels/docs/ (or https://<YOUR_USER>.github.io/vagrant-parallels/docs/)

• Middleman Deploy: https://github.com/middleman-contrib/middleman-deploy
• GitHub Pages: https://pages.github.com/