# summary FAQ of plog

FAQ (频繁地 被问到的 问题)

这篇文章包含了在使用和安装 plog 的过程中经常遇到的问题，以及我觉得可能会遇到的问题。

这个FAQ有多老了

很老了 --

plog 是什么

plog 是一个 blog 程序，用 python 编写，运行在 GAE(google app engine) 平台上。

这个名字很 lame

是的。

如何得到源代码

这里有如何用 svn(subversion) 获取 plog 最新代码的说明，如果您不会使用 svn，那么你可以看这里。

如何安装(部署)

如果是在本机运行，那么请先下载并安装 GAE 的 SDK。然后进入代码所在的上一级目录，运行：

dev_appserver.py plog_src

(我假设您把代码放在了一个叫 plog_src 的目录中)

如果是要放到网上运行，让别人也可以看到你的 blog，那么请先去注册 GAE 服务。

Note: 现在每个 google 帐户可以注册最多 3 个 app，名字不能和已有的 google 账户名重复，注册后暂时不能删除，所以选择名字请谨慎。。。

注册之后请修改 app.yaml 的第一行，把 joeseayam 改成你的 app 的名字。然后去上一级目录运行：

appcfg.py update plog_src

然后在浏览器中访问 http://您的app名字.appspot.com 就能看到了。

如何发表文章

只有该 app 的管理员才有权发表文章。管理员是申请该 app 的人，或者，有权限查看 app admin colsole 的人。可以在 GAE 的设置界面 invite 其他的 developer，这样就可以多人写 blog 了。

点 login，用管理员的 google 账号登陆，在网站的大标题下面可以看到若干链接，点 New Post 就可以发文了。

怎样设置参数，比如说每页的文章数

用管理员身份 login，点 Preference，可以设置一些参数，现有的参数具体说明如下：

• Plog title: 网站的大标题
• Plog subtitle: 网站的副标题
• Posts per page: 每页文章数
• Comments: 每页评论数(暂时没用)
• Recent posts: “最近文章” widget 中显示的条目数
• Recent comments: “最近评论” widget 中显示的条目数
• RSS posts: RSS feed 中包含的最近的文章数
• Default host: 默认主机名，blog 可能有多个域名，设置这个可以改变 feed、API URL 等的默认地址
• Site keywords: 网站的关键字 <meta name="keywords" content="这个地方的关键字" />
• Site description: 网站的描述 <meta name="description" content="这个地方的描述" />
• Theme: 网站外观主题
• Custom header: logo 下方自定义的内容(比如放一块横幅广告条)
• Custom sidebar: 废弃了
• Custom sidebar1: 第一个侧栏自定义的内容(比如放 widgets，竖直的广告栏)
• Custom sidebar2: 第二个
• Custom footer: 最下边自定义的内容(比如放 google analytics 脚本)
• Enable memcache: 是否使用 Memcache，推荐打开
• Comment notify email: 打开此项，如果有 Comment，会邮件通知文章作者。

怎样显示 widget

目前只有右侧栏可以显示 widgets，方法是在 Custom sidebar 中加上 django 模板变量：

{{ W.RecentPosts }}
{{ W.RecentComments }}
{{ W.Blogroll }}
{{ W.Tags }}

其中 W 必须大写，后面的不区分大小写，目前只有这 4 个 widget。

另外侧栏的每个自定义的项目应该用这样的 html 代码：

<li><h2>标题</h2>正文</li>

这样才能得到和 widgets 一样的外观

怎样用 blog 工具写文章

plog 实现了 API 发文的功能，目前通过我的测试的客户端有：

1. Windows Live Writer
2. Google Docs

设置要点：

• API 协议选择 MetaWeblog
• API url 是 http://***.appspot.com/blog/api/xml-rpc
• 用户名是管理员的 email 完整地址
• 密码用 Preference 页面最下面的按钮“Regenerate” 生成

如何更换主题

plog 默认带了 4 套主题，你可以任意选择使用。

如果你对任何一套主题都不满意，那么你可以采用下面的步骤来制作/修改自己的主题：

1. 在 themes 下面创建目录，目录名字就是你自己的主题的名字
2. 在 themes 下面放一个 style.css 文件
3. 修改 style.css 以使外观和布局适合您的需求
4. style.css 中可以用相对路径指定所需的图片文件，图片可以和 style.css 放在同一目录，也可以统一放在一个子目录中
5. 有时候，仅仅修改 css 文件不能满足需求，那么你可以重写模板文件。在 default 主题目录中，有个 templates 目录，包含了所有的模板文件。你可以在自己的主题目录中创建一个 templates 目录，仅仅把重写过的模板文件放进去就够了，没修改的模板文件会自动使用 default 中的。所以，default 主题不能删除。

制作主题时的一些建议：

• 可以先把 default/templates 里面的所有文件 copy 到自己的主题目录下，然后修改所需要的模板文件，最后再把没修改过的 template 文件删掉。
• 关掉 Memcache。
• 欢迎共享您制作的主题 :)

我想要 ● 功能 / ● 功能有缺陷 / ● 功能没必要 / 要是能 ● 就好了

到目前为止，plog 基本上都是根据我自己的需要做出来的。如果您有任何建议，或者发现任何 BUG，欢迎在这里提出来，或者 email 我，或者加我的 google talk (ｋｏｍｍｉｔ　ａｔ　ｇｍａｉｌ　●　ｃｏｍ)。感谢大家的关注，这是我继续做下去的动力。

可以共同开发么

呃。。。有很多原因让我不愿意这样做，包括：

• 我刚学 python，水平还很弱
• 没用过 Django，还是很弱
• 代码写的太烂了，没注释没文档
• 我随时都可能按照自己的想法重构
• 我真的很弱……

不过，你可以任意修改 plog 的代码以满足自己的需求，同时我也欢迎针对代码的任何批评和建议。

plog 很 cool

是的，谢谢