Skip to content

JmPotato/Pomash

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 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.**

~~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

About

🍠 A Lightweight Blog System

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published