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

```
James Vasile's avatar
James Vasile committed
git clone PUT REPO GIT INFO HERE
James Vasile's avatar
James Vasile committed
cd PELICAN DIR
James Vasile's avatar
James Vasile committed
bin/serve
James Vasile's avatar
James Vasile committed
```

James Vasile's avatar
James Vasile committed
Then add a file to `sites/content/posts`.  The site will update and you can view
it on [localhost:8000](http://localhost:8000).
James Vasile's avatar
James Vasile committed

James Vasile's avatar
James Vasile committed
When you're satisfied with your post, 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.