summaryrefslogblamecommitdiff
path: root/README.md
blob: c43e30930d3e535f693763dabc26a854f441ecba (plain) (tree)
























                                                                                
                              




















                                                                              
# Getting Started

## Serving the site locally for development work

In the root directory of the repository:

```sh
$ cobalt serve
```

## Building the site for produciton

In the root directory of the repository:

```sh
$ cobalt build
```

## Updating pages and posts

There is a git-hook on the origin server that rebuilds and publishes the site
every time a push is made to the master branch. Site contributors need only make
changes to the text of the pages and posts, publish them with `cobalt`, commit
them, and then push them to master to see them go live.

Below is a step-by-step guide.

### Adding a new post or page

Enter the folder where you want new content to go. Tell `cobalt` to template a
new post for you. Don't forget to provide a name for the post! You can verify
the contents if you wish.

```sh
$ cd posts
$ cobalt new "A New Tutoring Business"
[info] Created new posts "posts/a-new-tutoring-business.md"
$ cat a-new-tutoring-business.md
---
title: A New Tutoring Business
categories:
  - blog
layout: post.liquid
is_draft: true
---
(Post text goes here)
```