Tarbell¶
Tarbell makes it simple to put your work on the web, whether you’re a team of one or a dozen. With Tarbell, you can collaboratively build beautiful websites and publish them with ease.
Tarbell makes use of familiar, flexible tools to take the magic (and frustration) out of publishing to the web. Google spreadsheets handle content management, so changes to your stories are easy to make without touching a line of code. Step-by-step prompts help you set up and configure your project, so that publishing it is a breeze.
New here? Read the Tarbell tutorial or install and configure Tarbell to get started.
Need help? File a ticket tagged “support” in Github.
Tarbell is named after Ida Tarbell, a distinguished muckraking journalist whose 1904 The History of the Standard Oil Company is a masterpiece of investigative reporting. Read more about her on Wikipedia.
Requirements¶
Tarbell requires Python 2.7 and Git (v1.5.2+). Tarbell does not currently support Python 3.
Tarbell does not work on Windows machines.
Anatomy of a Tarbell project¶
Tarbell projects are made up of four pieces:
- The core Tarbell library, installed when you run pip install tarbell
- A Tarbell blueprint directory
- Your project template files
- A Google spreadsheet (optional)
Using Tarbell¶
- Installation
- Tutorial
- Upgrading
- Create and install projects
- Building projects
- Editing templates
- Understanding Tarbell Blueprints
- Template inheritance: Override files from Tarbell Blueprints by copying to your project directory
- Files prefixed with underscores (
_
) will not be generated or published - Configuring projects
- Creating JSON
- Using context variables
- Where can context variables be used?
- Anatomy of a project directory
- Adding custom routes
- Using Flask Extensions
- Using Google spreadsheets
- Publishing
- Developing Tarbell blueprints