谈谈这个博客程序 Pomash

2014-11-04

上次更新:2014.11.4

Catsup 转到 Pomash 也有些日子了,从刚开始的 bug 从生到现在也逐渐趋于稳定。由于是我自己写的,所以对一些问题比较了解,自己用着算是顺手,但偶尔也会有人在 GitHub 上提 Issue 或者联系我询问一些关于 Pomash 的使用事宜和问题,怪我太懒,GitHub 上只写了一个简单的使用说明,趁着空闲时间在这里写一个详细的指南。

如有错误和疑问,请指出,谢谢。

安装与配置

安装前请确保你的安装环境已经包括了以下东西:

  • Python 2.7.6+(对 Python 3 的兼容性我还没有做过测试)
  • pip

先从 GitHub 上把 Pomash 扒下来,你可以去下载源码压缩包或者直接使用命令:

git clone https://github.com/JmPotato/Pomash.git

然后就是依赖的安装:

cd Pomash
pip install -r requirements.txt

接下来就是settings.py的设置,这里是设置选项内容的对应表:

  • blog_name 博客名称
  • blog_author 博主
  • blog_url 博客地址
  • twitter_card 是否开启 TwitterCard 功能,
  • twitter_username 如果开启了 TwitterCard 功能,请填写上你的 Twitter 用户名,否则忽略即可
  • analytics Google Analytics 代码,没有则留空
  • enable_comment 是否开启评论
  • disqus_name 评论采用 Disqus,所以请填上你自己的评论代码
  • theme 博客主题,我个人用的是 Clean 这个主题,稍后会提到主题安装
  • post_per_page 每页显示的文章个数
  • cookie_secret 此项是 Cookie 加密密匙,请务必更改!!
  • login_username 后台登录用户名,默认是 admin(默认密码也为 admin)
  • DeBug 开发者选项,是否开启 debug
  • app_key Dropbox API Key,和 Secret 一同填写后,可以使用 Dropbox 备份功能
  • app_secret 同上

    注:如果你需要 Dropbox 备份功能的话也可以联系我,向我索要 Pomash 的 API Key 和 Secret,或者你也可以自行到 Dropbox 官网申请

确保完成以上配置后,创建数据库和运行 Pomash:

python init_db.py
python run.py --port=指定的端口

初次使用

在安装和配置完成后,你可以到/admin登录后台,帐号已在settings.py中填写,默认密码为 admin。在后台,你可以管理,发布、编辑文章和博客页面、进行 Dropbox 备份和更改登录密码。

发布一篇文章需要填写标题、标签和正文内容,每个标签间用英文半角逗号隔开,

新建一个自定义页面时,只需填写标题和页面内容。

注意:Pomash 的编辑器有自动保存功能,双击编辑框即可载入自动保存内容

主题安装

目前 Pomash 只有两个主题,默认主题和 Clean,默认主题做的有点渣(原谅我的渣审美),所以我个人推荐使用后者

安装主题很简单,首先需要进入 Pomash 的主题目录,将主题下载下来,并将文件夹名称改为主题名称:

cd Pomash/Pomash/theme
git clone https://github.com/JmPotato/Potheme-Clean
mv Potheme-Clean clean

然后在settings.py中将主题设为clean即可。

Enjoy~

Tagged in : Pomash Usage Guide