Note: This guide is for Windows users. If you are working on a Mac, Start with our docs.
I’ll present a recommended setup for getting started with BowTie development on the Windows platform. There are a number of other methods, including the GitHub Windows client, but these may require additional work or more intensive configuration.
Some existing software solutions that BowTie integrates with do not officially support Windows, but we’ve found that there’s not much hindrance to development once you’ve configured your environment. Please reach out to firstname.lastname@example.org if you have any issues, or submit a Pull Request to submit any corrections.
- Download the official Git build for Windows from the GitHub Downloads Page.
- Run the executable file that you just downloaded to begin the Git installation process.
- Install with the default options (esp. Use Git from Git Bash only).
Configuring SSH Keys
- Click the Start Button, find the
Git BashApplication, and run it.
- In the resulting terminal window, run
- Save the file the default location (%HOMEDIR%/.ssh/id_rsa).
- Now run
$ cat %HOMEDIR%/.ssh/id_rsa.pub | clip, where
%HOMEDIR%should be your user’s home directory.
- Navigate to the BowTie New Account Key page and paste the clipboard contents into the “Key” field.
- Give your Key a Title that describes the machine you’re working from, and submit with the “Save” button.
Cloning the Repository
- Visit your BowTie Project Dashboard, and copy the value from the “SSH clone URL” field at the top of the page.
- Launch the
Git BashApplication and navigate to the directory where you want your Projects to live.
$ git clone %GITCLONEURL%, where
%GITCLONEURL%is the value from the “SSH clone URL” field from step 1.
- If your configuration is correct, you should see Git pull down your Project contents into a directory named after your Project.
- Download Ruby (2.1.5 works, as of the date of this writing) from RubyInstaller.
- Run the Installer - make sure you “Add Ruby executables to your PATH”
- Download the DevKit release for the same version of Ruby you downloaded above.
- Extract the DevKit release into
- Run the Command Prompt with Ruby from your start menu
$ ruby dk.rb init
$ ruby dk.rb install
$ gem updateand confirm overwrites
The BowTie Client
gem install bowtie-ioand accept any Security Prompts.
- In your Project’s clone directory, edit the
_config.ymlfile and add the line
highlighter: false. Without it you’ll get blank pages served. If you figure out how to get pygments working on Windows, please let us know.
$ bowtie serveand open https://localhost:4000/ in your web browser.
If you are new to BowTie, check out our other Getting Started guides.
Getting Started with BowTie:
- Build a Landing Page in 5 minutes
- Using the BowTie Collection Editor
- Initial Configuration
- Setting Up Custom Domains
- Customizing and Styling BowTie frontend content
- Build a website with a pay wall
- Blogging with BowTie
- Launch a simple donation site
- Using BowTie’s User Profile system
- Build a Daily Deal Site with Jekyll Collections
- Using Jekyll Data to extend your site
- Adding BowTie users to MailChimp with Zapier
To keep up to date, follow us on twitter at @bowtie_io
Questions? Please comment! Thanks for your support and feedback.