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 `catsup <server/deploy/webhook>`
For simple usage, just copy and rename config.py to ~/.catsuprc and modify it as you like.
##Run
```bash
catsup 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`catsup 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 `catsup <server/deploy/webhook>`
For simple usage, just copy and rename config.py to ~/.catsuprc and modify it as you like.
##Run
```bash
catsup 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`catsup 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.5.tar.gz
(39.8 kB
view details)
Built Distribution
catsup-0.0.5-py2.7.egg
(56.6 kB
view details)
File details
Details for the file catsup-0.0.5.tar.gz.
File metadata
- Download URL: catsup-0.0.5.tar.gz
- Upload date:
- Size: 39.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0620b7ef618bd792b12a20879b60f0018ae79b93bbdb181bfde0a39924418f29 |
|
| MD5 | c5059971b945a6751d1c29d6c6230244 |
|
| BLAKE2b-256 | fc64e4186dfc7c1bf255b59cb6e91d7a6b7c0a16fd284751c5dc397b68e1fc10 |
File details
Details for the file catsup-0.0.5-py2.7.egg.
File metadata
- Download URL: catsup-0.0.5-py2.7.egg
- Upload date:
- Size: 56.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 484f88958312452519c3b24d61addcd3150dd8737476983e7e85de664a025506 |
|
| MD5 | e2356cab71cb4bcc1ac2c96df178fd0d |
|
| BLAKE2b-256 | 7fba2e00ce04def6502bf210cd38681b7d976fc66f4be6da8cc78aae80e51841 |
