A Lightweight Blog System
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Pomash Redirect to 404 for articles that do not exist Dec 13, 2018
.gitattributes Ignore the HTML and CSS codes Dec 9, 2018
.gitignore Update .gitignore Jul 29, 2014
LICENSE Initial commit Jan 31, 2014
README.md Update README.md Dec 12, 2018
init_db.py bug fixing Jul 6, 2014
requirements.txt Python 3.7.1 env's requirements Dec 9, 2018
run.py fix code css May 16, 2014
settings.py Bump into version 2.0 Dec 9, 2018

README.md

About

Current Version: 2.0

Pomash is a lightweight blog system. Powered by Tornado Web Framework.

Build up

Note: The Python environment has been updated to 3.7.1. So I am not sure whether Pomash works properly under the 2.x version of Python.

How to get Pomash:

git clone https://github.com/JmPotato/Pomash.git
cd Pomash
pip install -r requirements.txt

You should edit the settings.py to set up before running run.py. Here is a explanation for settings.py:

  • blog_name Your blog's name.
  • blog_author Your name.
  • blog_url Your blog's URL.
  • theme The theme you're using.
  • post_per_page The number of articles you want to display on the home page.
  • twitter_card Enable/Disable the twitter card function.
  • twitter_username Your twitter username.
  • analytics Google Analytics code. If you don't know what it is, just leave it empty.
  • comment_system Pomash currently supports Disqus or Valine as the comment system. 0 means turn off the comment. 1 means using Disqus. 2 means using Valine.
  • disqus_name If you choose Disqus as your comment system, please fill this with your own code.
  • valine_app_id/key If you choose Valine as your comment system, please fill this with your own LeanCloud app id/key. You can look this as a reference.
  • dropbox_app_token If you want to use the backup function, get a Dropbox app token here first.
  • cookie_secret The string used to encrypt your cookie. PLEASE CHANGE THIS TO YOUR OWN STRING.
  • login_username The admin username. Initial password of admin is admin. Please change it as soon as possible.
  • DeBug Developer setting. Normal user could just ignore it.

After customizing settings.py and initialize the database, you could put Pomash online.

python init_db.py
python run.py --port=8080

Usage

Pomash uses Markdown to write posts and pages. LaTeX is also supported.

Note: To avoid conflict between LaTeX and Markdown, Pomash removed the emphasis syntax *word* and _word_ which you should use <em>word</em> as an alternative.

#Hello World

```python
print('Hello, World!')
```

Hello, World!

Inline LaTeX: $\int_a^b f(x)\mathrm{d}x$

New line LaTeX: $$\sum_{i=0}^{n}i^2$$

<em>This is a emphasis.</em>

**This is a double emphasis.**

* Hello
* World

Theme

Pomash's theme is called Potheme. Here is a Potheme list:

Other Reference

A Chinese guide for setting up.(Maybe a little outdated)

License

Please read the MIT-LICENSE