-
Notifications
You must be signed in to change notification settings - Fork 81
Using Slate in Vagrant
Provided in the slate repo is a Vagrantfile you can use to run slate using vagrant. Vagrant is used to create a virtual machine (VM) that runs under VirtualBox or other related software and provides you a reproducible and portable development environment, without having to figure things out on your host. This is especially useful for Windows where getting things right, like nokogiri which potentially requires native compilation, can be tricky.
- Vagrant, see this page for installation downloads
- VirtualBox, see this page for installation downloads
- Fork this repository on Github.
- Clone your forked repository (not our original one) to your hard drive with
git clone https://github.com/YOURUSERNAME/slate.git
cd slate
Creating the Vagrant VM is as easy as doing:
vagrant up
And you can view your docs at http://localhost:4567.
If you wish to build the docs to HTML, run
vagrant ssh -c "cd /vagrant; bundle exec middleman build"
Once you're done with your work and you wish to shutdown the VM that vagrant creates, you will need to run:
vagrant halt
The next step is to learn how to edit source/index.md
to change the content of your docs. Once you're done, you might want to think about deploying your docs.