[注意]通用网站RSS输出生成器Ver 2.0A帮助手册

通用网站RSS输出生成器Ver 2.0A帮助手册
Build 20051026

一、系统简介：

　　所谓RSS，就是Really Simple Syndication（简易供稿）的缩写，是某一个网站用来和其它网站之间共享内容的一种简易方式，也叫聚合内容。网络用户可以在客户端借助于支持RSS的聚合工具软件（例如全中文的看天下RSS阅读器、周博通RSS阅读器、新浪点点通RSS阅读器等），在不打开网站内容页面的情况下阅读支持RSS输出的网站内容。可见，网站提供RSS输出，有利于让用户发现网站内容的更新。在高速高质高效成为主流呼声的互联网时代，RSS无疑推动了网上信息的传播，提出了另一种看世界的方式。用户利用RSS阅读器可以获取、阅读和管理XML格式的信息，那么什么是XML格式呢？XML和RSS又有什么关系呢？XML为eXtensible Markup Language（可延伸标示语言）的缩写。XML是网站内容如标题、链接、部分内文甚至全文通过RSS转换而来的一种可延伸标示语言的格式。以XML格式向其它网站供稿，使用者可以用一般的浏览器观看，也可以用特殊的阅读器软件来阅读。

　　然而，编写XML需要用到专用的软件或者手工编写，过程相当烦琐，而且非常容易出错，XML文件一旦出现错误，RSS阅读器就无法正确识别，且由于目前很多网站都使用了基于数据库的系统，能够简便的从数据库中读取现成的数据实现RSS输出才是最重要的。这是作者当初开发这一系统的目的之一，另外一个目的，就是提供给大家一个资源共享的途径，如果各个学校网站都实现了RSS输出，那么，实现校际资源共享就成了一件相当容易的事情，利用RSS技术实现校际资源共享的方法请参见作者所撰《利用RSS技术实现校际资源共享》一文。

　　系统要求：

　　服务器端：Windows 2000 Server/Advance Server（推荐）
　　　　　　　Windows 2003 Server
　　　　　　　Windows 2000 Pro + IIS
　　　　　　　Windows XP（Home、Pro）+ IIS
　　　　　　　Windows 98 + PWS
　　　　　　　IE版本推荐5.5以上

　　数据库：服务器需要装有SQL Server服务器或使用ACCESS数据库源。

　　客户端：推荐 IE 5.5以上，分辨率1024X768以上，800X600也可。

二、系统功能：

　　通用网站RSS输出生成器Ver 2.0A拥有以下主要功能和特点：

　　１、自定义网站信息。
　　２、自定义数据库信息，可以对多个已经存在的数据库进行操作。
　　３、2.0A目前可以连接ACCESS、SQL Server两种类型的数据库。
　　４、自定义数据库结构，以实现对任意数据库、任意字段、任意多数据的RSS降序输出和随机输出。
　　５、可以自定义输出条件。
　　６、自定义的数据库信息可以保存、修改、删除。
　　７、自定义的输出项目可以保存、修改、删除、生成（或更新）XML文件。
　　８、增强的查错程序，对于用户的输入错误有提示和一部分纠正功能。
　　９、根据自定义项目输出的XML文件为标准XML格式，可被所有RSS阅读器阅读。
　　１０、输出的XML文件为静态文件，非动态存取，降低占用系统资源。
　　１１、可以自定义存放XML文件的文件夹，可以自定义每一个项目生成的XML文件名。
　　１２、完全支持后台生成静态页面网站的需求，可自定义静态页面的字段以及URL构成形式 ，支持URL中包含有日期字段变形的网站的要求。
　　１３、可以自定义FSO组件的名称，满足了那些修改过FSO组件名称的网站的需求。
　　１４、所有RSS输出项目均可以随意调用，免去每次更新网站后需要手工输出的麻烦。
　　１５、使用样式表使输出的XML文件在浏览器中显示界面更友好。

三、系统安装：

　　本系统无需安装，直接将系统文件夹拷贝入WEB服务器的任意子文件夹即可使用。例如你的服务器的默认WEB文件夹在d:\wwwroot，URL为http://192.168.0.2/，则可以将系统文件夹拷贝入d:\wwwroot中，则只要在任意联网计算机上访问http://192.168.0.2/rrs/即可打开本系统进行使用。若要卸载本系统，直接删除本系统文件夹即可。

　　若要备份本系统，请直接备份本系统文件夹下data子文件夹中的rss.asa文件即可，其它文件无需备份。

四、系统登陆：

　　安装好本系统之后，可通过IE浏览器键入URL的方式的访问本系统（具体方法见上一节系统安装部分），访问成功后即出现登陆界面，默认的用户名为admin，默认密码为admin，登陆后您可以在页面顶端找到修改密码的连接，您可以根据需要修改密码，密码采用MD5加密，存储于数据库中，具有一定的安全性。

五、功能导航：

　　１、第一次使用：

　　访问本系统→登陆系统→修改密码（可跳过）→站点管理→站点信息修改→数据库管理→数据库添加→数据库管理（可跳过）→项目添加→项目管理→输出→输出成功。

　　２、之后使用：

　　访问本系统→登陆系统→修改密码（可跳过）→站点管理（可跳过）→站点信息修改（可跳过）→数据库管理（可跳过）→数据库添加（可跳过）→数据库管理（可跳过）→项目添加（可跳过）→项目管理（可跳过）→输出→输出成功。

六、站点管理：

　　在站点管理中可以对网站进行总体的设置，包括网站名称、网站URL、网站LOGO标题、网站LOGO地址、网站简介的设置 、FSO组件的名称（如果您没有修改过服务器FSO组件的名称，该项目请不要更改），这些都是基于RSS输出的XML文件所需要的内容，所以若想希望自己网站输出的XML文件可读性较强，请认真填写这一部分的内容。

　　该部分的内容一般只在第一次使用时填写一次，以后都不必再写，除非您确实需要进行修改。

七、数据库管理：

　　数据库管理模块包括数据库添加和数据库管理两大部分，以下分别介绍。

　　１、数据库添加：

　　如果您想使自己网站的某一个数据库进行RSS输出，则首先要在这里添加数据库的信息，根据用户选择数据库类型的不同，所需要填写的内容也有所不同，对于ACCESS数据库来说，需要填写数据库描述、数据库名、用户名（可选） 、密码（可选）和XML文件夹名（默认是RSS生成器所在位置的XML文件夹）；而对于SQL Server数据库来说，则需要填写数据库描述、服务器名和地址、用户名、密码和XML文件夹名（默认是RSS生成器所在位置的XML文件夹），如果要实现RSS输出，则这些基本信息就不能有差错，否则系统是不能实现RSS输出的。

　　数据库添加没有数量限制，即可以添加ACCESS数据库，也可以添加SQL Server数据库。

　　２、数据库管理：

　　一旦你成功添加了数据库信息，则可以在数据库管理中根据你的需要修改、删除这些信息。

　　注意：一旦选择删除某一个数据库信息，则已经建立的与该数据库信息相关的RSS输出项目均将被同时删除，但已经输出的XML文件不会被删除。

八、项目管理：

　　所谓项目，我们可以理解为任意RSS输出内容，一种形式的RSS输出就是一个项目，项目管理分为RSS项目添加和RSS项目管理两大部分。

　　１、RSS项目添加：

　　在这里，用户可以添加任意多个RSS输出项目，但要添加RSS输出项目，前提条件是您至少已经添加了一个数据库信息，对应一个数据库可以添加任意多个RSS输出项目，以输出各自不同的XML文件。

　　 在RSS项目添加中，需要用户输入项目描述（正确填写项目描述可以让你更清楚的了解该RSS输出项目的作用是什么）、选择目标数据库并填写目标数据库中的若干字段名，包括目标数据表名（即使用哪一个表）、标题字段名（即文章、图片、软件标题字段）、作者字段名（文章、图片等的作者字段）、添加日期字段名（数据库中记录的日期字段） 并定义是否对日期进行变形、ID序号字段（即数据库中用于排序、编号的字段，可以选择按该字段降序，也可以选择按该字段随机提取记录）、简介字段（对文章、图片、软件的简介字段，若数据库中没有简介字段，可用内容字段代替，本系统有引用内容字段自动生成简介的功能）、URL及其参数（分动态页面和静态页面两种填法，详细请见后文）、提取记录的数量、提取条件、自定义文件名，在项目添加页面，各项目都有简短的提示，稍有数据库常识的人都能很快添加RSS项目。

　　动态页面输出例：某网站要将电子书在线阅读的数据每次选100本言情小说进行RSS输出，图书显示页面URL的形式为http://www.bookhome.net/showbook.asp?id=12345，则在ASP文件URL及其参数部分应填写http://www.bookhome.net/showbook.asp?id=，在提取记录数量中填写100，在提取条件中填写where booktype='yanqing'（提取条件中的字符类型字段可以用半角单引号，也可以用半角双引号，但系统会自动将双引号转换为单引号）；而其它字段内容请用户根据数据库的字段名填写。

　　静态页面输出例一：某网站支持后台生成静态页面，现要将静态生成的电子书在线阅读的数据每次选100本言情小说进行RSS输出，静态页面的URL形式为http://www.bookhome.net/book/wuxia/2005-1-1/192837.htm，其中http://www.bookhome.net/book/是固定不变的，后面的静态文件名由sample1、sample2、sample3字段组成，sample3字段未包含.HTM的扩展名，则URL及其参数部分应填写http://www.bookhome.net/book/，选择静态页面，并在自定义字段中填入sample1|sample2|sample3（中间用“|”分割），在自定义样式中填入*/*/*（留空也可，因为系统默认留空即为*/*/*这样的样式），在扩展名中输入htm即可，同理，若网站的静态文件名由sample1、sample2两个字段构成，而组成的URL形式是2005-1-1_192837.htm的形式，则在自定义样式中填入*_*即可，依此类推，您可以使用*通配符组合出任意的静态文件名；在提取记录数量中填写100，在提取条件中填写where booktype='yanqing'（提取条件中的字符类型字段可以用半角单引号，也可以用半角双引号，但系统会自动将双引号转换为单引号）；而其它字段内容请用户根据数据库的字段名填写。 为保证输出的XML文件能被公网访问，所有的关于URL部分都应该填写公网地址，而不是内网地址，例如在URL中设置类似 包含有http://192.168.0.1/这样的内网地址就是错误的，生成的XML文件将只能在内网正确使用，公网将只能看到列表而不能对内容进行访问。

　　静态页面输出例二：某网站后台支持生成静态页面，静态页面的URL形式为http://www.bookhome.net/article/class27/news/200506/1656.html，其中，27是classid字段的值，200506由日期字段updatetime变形而来，1656是文章ID字段ArticleID，则您需要做如下设置：按要求填写对应字段名，选中日期字段后面的静态文件URL引用变形选项，在输入框中输入yyyymm，在URL头及参数中填入http://www.bookhome.net/article/，选择静态文件选项，在自定义字段中输入ClassID|updatetime|ArticleID，在自定义样式中输入class*/news/*/*，扩展名填写html即可。

　　在RSS项目添加中，提取条件的填写需要使用者书写正确的SQL语句中where语句的语法，即填写where id>1000这样的形式，如果您对SQL语法不熟悉，请保持提取条件为空。

　　２、RSS项目管理：

　　在这里，用户可以对自己添加的RSS项目进行修改、删除，以及实行最终的RSS输出。本系统已经包含了可能出现的错误处理，例如SQL Server数据库服务器不正确、ACCESS数据库文件不存在、数据库密码不正确、数据库无法打开、数据库字段设置不正确等都做了提示，如果您在数据库管理以及项目管理中添加的数据真实有效，那么，就一定可以利用RSS项目管理进行RSS输出。

　　通用网站RSS输出生成器Ver 2.0A生成的所有XML文件都自动保存在本系统所在文件夹的名为XML的子文件夹中，以项目的ID编号为主文件名，以便于您使用。

　　提示：删除一个项目不会影响到数据库信息和其它项目，但如果在数据库管理中删除一个数据库信息，那系统将同时删除与该数据库相关的所有项目信息。

　　３、RSS输出调用：

　　问：如何在我更新主页后不需要手动输出，就可以实现RSS的输出？

　　答：你可以在你的网站代码中需要输出RSS项目的地方加入iframe代码调用已经在本系统中定义过且测试通过的RSS项目即可。

　　实例：
　　首先获取RSS输出项目的编号，在RSS项目管理中，每一个项目都有一个ID号，假设您要输出的项目编号为4，则该项目的RSS输出URL为http://你的网站URL/rss/admin_build.asp?id=4，则该RSS项目输出的调用代码为：，将这行代码嵌入你的网站代码中，即可实时调用本系统更新RSS输出。

　　你也可以尝试用编程来控制不同的类别更新时输出不同的RSS项目，具体的做法在此就不再赘述了。

九、版权说明：

　　本系统核心代码部分完全由上海市闸北区第一中心小学蔡喆炯独立自主开发，作者拥有绝对的知识产权，您在未经许可的情况下，可以使用、散发、推广本系统，但不可以任何理由对本系统进行反编译、修改，更不可以将本系统用于商业用途，违者将承担相应的民事责任。如果您使用了本系统，我们将视作您同意我们对于本系统版权的观点。

十、如何升级

　　本系统尚有许多功能等待开发（具体开发计划详见第十一部分），如何升级请留意上海市闸北区第一中心小学的网站，具体地址请参见第十二部分。我们也希望您能通过第十二部分的联系方式向我们反馈您使用的情况，提供宝贵的建议和意见，促进本系统的功能进一步完善。

十一、升级说明

预计将在以后版本中实现的功能：
　　1、自定义样式表功能。
　　2、试图解决不支持2005版之前的动易系统静态页面输出RSS的问题。
　　3、项目管理复选成批处理功能。
　　4、自动选择数据库字段功能。
　　5、改进提取条件使之更人性化。

2005年10月26日：
　　V2.0A（SQL Server、Access通用版本）Build 20051026
　　　修正了当数据库作者字段包含有HTML标记时输出的XML文件不能被浏览器正确显示的问题。
　　　输出的XML文件增加样式表支持，使生成的XML文件在浏览器中阅读界面更友好。
　　　增加了对静态文件URL中包含有日期字段的变形形式的网站的支持。
　　　修改了静态文件自定义样式的输入框大小以及字段大小，以适应复杂样式的输入。
　　　同时发布Build 20050627到Build 20051026的数据库升级程序。

2005年6月27日：
　　V2.0A（SQL Server、Access通用版本）Build 20050627
　　　增加了自定义FSO组件名称的功能，满足那些修改了FSO组件名称后无法使用本系统的用户的需求。
　　　修正了数据库密码长度过短无法输入长密码的问题。
　　　增加了所有输出项目可被自由调用实现自动更新RSS输出的功能。
　　　同时发布Build 20050523到Build 20050627的数据库升级程序。

2005年5月23日：
　　V2.0A（SQL Server、Access通用版本）Build 20050523
　　　增加了支持后台生成静态页面网站的RSS输出功能，使本系统的通用性进一步扩大。
　　　修正了SQL Server登陆用户只能读取默认数据库的错误，可以读取该用户有读取权限的任意数据库。
　　　同时发布Build 20050511到Build 20050523的数据库升级程序。

2005年5月11日：
　　V2.0A（SQL Server、Access通用版本）Build 20050511
       增加了用户自定义存放XML文件的文件夹位置的功能（相对路径）。
       增加了用户自定义XML文件名的功能，这两项新功能可以让用其它方法已经实现RSS输出的网站不需要通知用户修改RSS访问地址。
       同时发布Build 20050426到Build 20050511的数据库升级程序。

2005年4月26日：
　　V2.0A（SQL Server、Access通用版本）Build 20050426
       增加了可根据ID排序字段降序提取记录或随机提取记录的功能。
       同时发布Build 20050411到Build 20050426的数据库升级程序。

2005年4月14日：
　　V2.0A（SQL Server、Access通用版本）Build 20050414
　　整合了SQL Server和Access版本的功能。
　　增加了后台管理、修改、删除、输出的功能，不再需要修改源代码才能输出XML文件，适用于任何使用SQL Server和ACCESS库的网站。
　　自定义网站信息。
　　自定义数据库信息，可以对多个已经存在的数据库进行操作。
　　可以连接ACCESS、SQL Server两种类型的数据库。
　　自定义数据库结构，以实现对任意数据库、任意字段、任意多数据的RSS输出。
　　可以自定义输出条件。
　　自定义的数据库信息可以保存、修改、删除。
　　自定义的输出项目可以保存、修改、删除、生成（或更新）XML文件。
　　增强的查错程序，对于用户的输入错误有提示和一部分纠正功能。
　　根据自定义项目输出的XML文件为标准XML格式，可被所有RSS阅读器阅读。
　　输出的XML文件为静态文件，非动态存取，降低占用系统资源。
　

2005年3月：
　　V1.1S（SQL Server版本）、V1.1A（Access版本）
　　实现了通过命令行动态调用数据库生成静态XML文件。
　　修正了1.0版中日期显示问题，在1.0中动态生成的文件，在RSS阅读器中日期显示不正确。
　　修正了1.0版中XML格式不规范的问题。
　　该版本从未公开发布过。

2005年2月：
　　V1.0S（SQL Server版本）、V1.0A（Access版本）
　　实现了通过命令行动态调用数据库生成动态XML文件。
　　该版本从未公开发布过。

十二、联系方式

　　如果您使用了本系统，请通过以下任何方式之一告诉作者，作者将在本系统中加入您使用本系统的网站链接，该链接会实时出现在所有使用本系统的网站的后台管理页面上。