About
Current Version: v2.1
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.dark_mode
The switch for dark mode. 0.Off & 1.On & 2.Auto. PS: Need theme support.pygments_style_light
The pygments style for light mode.pygments_style_dark
The pygments style for dark mode.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 isadmin
. 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.**
~~This is a strikethrough.~~
* 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