=================
 如何使用Blog插件
=================

:作者: limodou
:联系: limodou@gmail.com
:版本: $Id: blog.txt 42 2005-09-28 05:19:21Z limodou $
:主页: http://wiki.woodpecker.org.cn/moin/NewEdit
:BLOG: http://www.donews.net/limodou
:版权: GPL

.. contents::

安装
----

按照FAQ中的说明安装插件。抄录如下:
	
一个插件一般由两个文件组成，有的可有还要多一些。一个是xxx.pin，一个是xxx.py。

1. 先将下载的插件解压后放到plugins目录下
2. 启动NewEdit，打开[工具]->[插件管理...]然后你会看到插件的名称和描述。在需要使用的插件上双击，或点击下面的[选择切换]
   按钮进行选中，保证要使用的插件前面有勾。然后点击确定。
3. 重新启动NewEdit即可。
4. 不过，使用BlogEdit插件你还要安装meteor模块才可以。它可以从: http://wiki.woodpecker.org.cn/moin.cgi/Meteor 下载

使用
----

安装好Blog插件后，在工具条上会增加一个字母B样式的图标，同时在窗口菜单中会增加一个[打开Blog窗口]的菜单。点击后，会在窗屏
底下显示Blog工作区。

设置帐户
~~~~~~~~
点击Blog工作区中的[管理]按钮，或点击Blog编辑窗口中的[站点]->[站点管理]，会进入设置窗口。需要输入Blog站点名称，用户名，口令，
UTF-8编码是缺省选中的，XMLRPC服务的地址，对于啄木鸟社区的测试主机来说是：http://202.108.44.33/blog/<yourname>/pyblosxom.cgi/RPC，
然后是数据保存目录。输入完毕后，点击[增加]，会自动进行验证。成功后确证即可。如果不成功，或发生改变，包括主机分类信息发生改变，
都要点击[更新]进行重新验证，然后退出即可。

编辑新的Blog
~~~~~~~~~~~~

* 点击工具条上的字母B样式的图标即会打开一个空的Blog编辑窗口。
* 也可以在Blog工作区上点[新建]，这样会打开一个空的编辑窗口。
* 编辑的内容目前应该是HTML文档，以后会增加新的文本格式。

编辑旧的Blog
~~~~~~~~~~~~

* 如果已经存放到本地，则点击工作区中的[缓冲]，它会把本地保存的信息列出来。然后在想要修改的贴子上双击，会自动打开一个编辑窗口，
  其内容为贴子的内容，进行修改即可。

查看Blog信息
~~~~~~~~~~~~

可以在Blog编辑窗口中点击[信息]来查看当前Blog的信息，如：标题、分类、创建日期、PostID、帐号、XMLrpc地址

提交
~~~~

在Blog编辑窗口中点击发送即可发出新贴。如果在发送之前未设置Blog帐号请先进行设置。在发送前可以改变要发送的Blog站点，可以点击[站点]进行
切换。如果要改变分类，可以在分类下接列表中进行选择。如果是一个旧贴，则分类是不能进行选择的。

发贴完毕后，会自动将此贴从服务器取回，并更新到列表中。

下载贴子
~~~~~~~~

你可以点击[获取贴子]得到最后一个提交的贴子。也可以点[>]，输入想要得到贴子的个数。如果个数很大，会把所有贴子取回来。可能时间会很长。

查看本地保存
~~~~~~~~~~~

点击[缓冲]，就可以查看本地已经保存的贴子了。

删除
~~~~~

此功能会将选中的贴子从服务器删除（本地仍保留），因此建议不要轻易使用。

PyBlosxom的其它功能支持
-----------------------

首先要安装pyblosxom插件，方法同一般插件安装相同。pyblosxom插件是专门用于我为pyblosxom新开发的xmlrpc_newedit.py插件定制的，主要有
以下功能：

  1. 分类管理
     
     可以新增、修改。每一个分类包括描述和路径两个域。路径用于存放Blog，是缺省的pyblosxom的分类标识。它对应Blog起始根目录，
     本身是一个子目录。描述用于给于相应的说明信息。如果设置此信息，此信息将显示为发贴的分类信息。
    
  2. 编辑配置文件

     使用些功能，首先要在后台Blog系统中进行配置。具体见xmlrpc_newedit.py插件说明。然后，配置好的文件可以在远程被NewEdit进行编辑，编
     辑完成后会上传。

  3. 上传文件

     可以向指定目录中上传文件或图片。
    
  4. 获取文件列表

     可以得到上传文件的文件名和url信息，用于Blog的编辑工作。
    
使用
~~~~

安装好pyblosxom插件后，会在Blog工作区出现一个[PyBlosxom]的按钮，点击它，会出现一个下拉菜单，功能同上述介绍。