Difference between revisions of "Make a Tarbell"

Revision as of 19:40, 5 October 2015

Before you do anything

1. Open Terminal from your applications folder.
2. Type workon tarbell1.0.4 and press enter. You will now see (tarbell1.0.4) before your username.

Create a new Tarbell project

The command is tarbell newproject YOURSLUG, where YOURSLUG is a brief name for your project that does not contain spaces or punctuation. This slug will be used in your site's URL, but in very little else. Type that command and press enter.

The project creation process will walk you through everything else:

• Where would you like to create this project?
  • Hit enter to create the project in the default location within your user folder.
• What is the project's full title?
  • Spaces and punctuation are fine here.
• Pick a template
  • Hit 4 and then enter to select the Big Read Builder template.
• Would you like to create a Google spreadsheet?
  • Why yes, yes you would. Hit y and enter.
  • Enter the Google accounts INCLUDING YOURS that should have access to the spreadsheet and press enter. You can always share the spreadsheet after the fact, as well, using the blue Share button in the upper right corner of the Google spreadsheet app.
• Install requirements now with pip install -r requirements.txt?
  • Hit y and enter.
• Would you like to create a Github repo for this project?
  • Don't bother. Just hit n and enter.

Before you head over to the Google spreadsheet, type tarbell switch YOURSLUG and press enter. This turns on the local server that allows you to view changes as you make them. (Alternately, you can enter cd /Users/YOURFIRSTINITIALANDLASTNAME/tarbell/YOURSLUG and tarbell serve. This does the same thing as tarbell switch YOURSLUG but also sets the project folder as the active directory in Terminal.)