Skip to content
Snippets Groups Projects
README.md 1.03 KiB
Newer Older
James Vasile's avatar
James Vasile committed
# blog.opentechstrategies.com

James Vasile's avatar
James Vasile committed
This is OTS's blog backend.  It contains:
 * [Pelican](https://getpelican.com) config 
 * Jinja templates
 * Blog posts, pages, uploaded media
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
## Developing And Writing Posts
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
In a terminal, do this:
James Vasile's avatar
James Vasile committed

```
git clone https://code.librehq.com/ots/ots-blog.git
cd ots-blog
./bin/build
./bin/serve
James Vasile's avatar
James Vasile committed
```

Then you can view the site on [localhost:8000](http://localhost:8000).
James Vasile's avatar
James Vasile committed

New posts go in `sites/content/posts/`.  When a post is ready, add it
to the website:
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
```
git add PATH/TO/POST
git commit -m "Add new post"
git push
```
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
TODO: add instructions for actually taking a post live.  Theoretically, they
should be able to just rsync it somewhere, but maybe we should check out the
repo server-side and then do a `git pull` and `bin/build`.
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
## Dependencies
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
You will need [Pelican](https://getpelican.com) with the markdown plugin.  You
can install it with:
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
```
pip install -r requirements.txt
```
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
You might have to fiddle with a virtual environment, but that will be specific
to your system, so I leave that to you.