谈谈这个博客程序 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