Catsup: a lightweight static blog generator
Project description
#catsup
##License
Licensed under the MIT License.
##Install
Simple way using pip
```bash
pip install catsup
```
Or another hard way to install
```bash
git clone git://github.com/whtsky/catsup.git
cd catsup
python setup.py install
```
##Settings
The default settings file is at `~/.catsuprc`, you can specific it by passing `--settings=/path/to/settings` when executing `python -m catsup.app <server/deploy/webhook>`
##Run
```bash
python -m catsup.app server --port=8888
```
Then go to http://localhost:8888 to take a look at your own catsup:)
##How to write
catsup uses Markdown to write posts.
Filename should like 2000-01-01-catsup.md(year-month-day-title.md)
Example:
#Title
- tags: tag1, tag2, tag3
----
Content
```python
print "hi,I'm coding."
```
### Post properties
catsup supports some post properties. Write them before "---" and start with "- ".
Example:
- category: A Category
- date: 2012-12-24
- tags: tag1, tag2
- comment: no
The `category` property defines the category of the post, but it's not used yet.
The `date` property can overwrite the date from the file name.
The `tags` property defines the tags of the post.
The `comment` property defines whether the post can be commented or not.
### Post excerpt
You can use `<!--more-->` to define an excerpt of a post. Any content before that will be used as excerpt of the post. And you can choose to display excerpt rather than full content on your homepage.
##Deploy a static blog
run`python -m catsup.app deploy`
And you can find your static blog in deploy/ .
##License
Licensed under the MIT License.
##Install
Simple way using pip
```bash
pip install catsup
```
Or another hard way to install
```bash
git clone git://github.com/whtsky/catsup.git
cd catsup
python setup.py install
```
##Settings
The default settings file is at `~/.catsuprc`, you can specific it by passing `--settings=/path/to/settings` when executing `python -m catsup.app <server/deploy/webhook>`
##Run
```bash
python -m catsup.app server --port=8888
```
Then go to http://localhost:8888 to take a look at your own catsup:)
##How to write
catsup uses Markdown to write posts.
Filename should like 2000-01-01-catsup.md(year-month-day-title.md)
Example:
#Title
- tags: tag1, tag2, tag3
----
Content
```python
print "hi,I'm coding."
```
### Post properties
catsup supports some post properties. Write them before "---" and start with "- ".
Example:
- category: A Category
- date: 2012-12-24
- tags: tag1, tag2
- comment: no
The `category` property defines the category of the post, but it's not used yet.
The `date` property can overwrite the date from the file name.
The `tags` property defines the tags of the post.
The `comment` property defines whether the post can be commented or not.
### Post excerpt
You can use `<!--more-->` to define an excerpt of a post. Any content before that will be used as excerpt of the post. And you can choose to display excerpt rather than full content on your homepage.
##Deploy a static blog
run`python -m catsup.app deploy`
And you can find your static blog in deploy/ .
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
catsup-0.0.4.tar.gz
(39.8 kB
view details)
Built Distribution
catsup-0.0.4-py2.7.egg
(56.4 kB
view details)
File details
Details for the file catsup-0.0.4.tar.gz.
File metadata
- Download URL: catsup-0.0.4.tar.gz
- Upload date:
- Size: 39.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 097e2a92467be285e41003c9a2be75abba667489477d2a7b04cd1935ade51d5b |
|
| MD5 | e6b6c33c7f4e02d934e6f6396a94294a |
|
| BLAKE2b-256 | 2519d51d3c8ee8420a700d4bef122616c8f3a30942b8156c9b004a16199b05e4 |
File details
Details for the file catsup-0.0.4-py2.7.egg.
File metadata
- Download URL: catsup-0.0.4-py2.7.egg
- Upload date:
- Size: 56.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b8d0026bb4f67cd3ade397e810f8f4bb792c038a4ff8a00fe708f8a738449033 |
|
| MD5 | 8a5460a02cedafcec9a909ac9106d71f |
|
| BLAKE2b-256 | 1b3796da53e346db9ffd0b09e3a5ca0d822225137835458545dc36c2047ce5e3 |
