|
|
 |
|
“在线杂志”HTML处理脚本
[程序语言] PERL
[运行平台] UNIX
[源码来源] http://kompashka.hypermart.net/download/
[下载源程序] 立即下载
[目录]
I. 介绍
II. 文件和安装
III. 用法和特点
IV. 配制和数据
V. 调用脚本
__________________________________________________________________
I. 介绍
----------------------------------------------------
“在线杂志” 是个强大的内容管理工具。你是否正在设计或维护一个拥有许多页面的e-zine，或是有许多章节的在线书籍，或者是图象库。只需要放置或删除服务器目录中的有关文本文件就可以很容易地添加/移去入口。"在线杂志" 不接受任何网站访问者的输入，它是个网管工具。
如果需要的话，一个脚本可以处理不止一本 "杂志"。 所以通过该脚本，你可以建造一系列网站。每本杂志是单独配置的，但同一杂志的所有页面外观相似。你可以为每种杂志设计各自的HTML文件风格。
注意: 唯一需要配置的是脚本的第一行，应使之指向服务器上perl解释器所处位置。
脚本可以提供：
a) 提纲页面 - 入口按字母顺序排列，要么是顺序，要么是逆序。入口的的号码链接到相应的页面。
b) 每个入口的页面, 以及
c) 在每个入口页面底部的导航条。
II. 文件和安装
----------------------------------------------------
文件清单
/
|- journal.cgi - 脚本自身
|- defaultconfig.pl - 一般配置脚本(缺省)
|- cgi-lib.pl - Perl例程库(作者Steven E. Brenner)
|- back.jpg - 样本输出的背景图象
|- cover.jpg - 样本输出的杂志封面
|- uphand.gif - 样本输出的"Go to Top" 链接的图象
|- index.html - "哑元" 索引
|- readme.txt - 本文件
/journal/ - (子目录)
|- jheader.html - 本杂志的所有页面的抬头
|- jfooter.html - 本杂志的所有页面的脚注
|- jconfig.pl - 单独的可执行配置脚本
|- 001.txt - 样本入口文件
快速开始：
1. 正确设置脚本的第一行，以指向服务器上perl解释器所在位置。
2. 在服务器上创建脚本目录，将其属性设置为755。
3. 上传journal.cgi, defaultconfig.pl 和cgi-lib.pl到该目录。务必用ASCII模式。 设置上传的文件属性为755 (-rwxr-xr-x)。用二进制模式上传back.jpg, cover.jpg 和uphand.gif到同一目录中。
4. 在脚本所在目录中创建名为 "journal"的目录，并设置其属性为755。
5. 把jheader.html, jfooter.html, jconfig.pl 和001.txt上传到 "journal" 目录中。务必用ASCII模式。. 设置jconfig.pl为755 (-rwxr-xr-x).
6. 在浏览器中打入脚本的URL。应正常工作！
在另外目录名中重复步骤4 - 5。 (如"magazine"目录).
要进行测试，用如下参数调用脚本：
http://www.yourdomain.com/cgi-bin/journal.cgi?folder=magazine
现在你可以进一步配置进行处理。
注意: 除了脚本第一行的Perl的路径外，脚本中的其它不必进行修改。
所有需要改变的变量都在配置文件中列出。
III. 用法和特点
----------------------------------------------------
每种杂志须置于自己的目录中，而该目录需置于脚本目录中。
每种杂志的目录须包含三个特殊文件：
(1) 配置文件 - 可执行的PL文件，用于初始化变量，进行相应杂志的风格配置。
(2) 抬头文件 - 普通的HTML文件，定义输出格式。脚本将首先显示该HTML文件，然后显示杂志入口或提纲，
你可以从该文件控制杂志的输出。
(3) 脚注文件 - 普通的HTML文件，用于关闭所有在抬头文件中打开的标记，以及结束输出。
注意: 如果你打算使用缺省名以外的其它文件名，可改变"defaultconfig.pl" 文件中相应的变量。
在杂志目录中等其它文件放置入口 - 页面, 章节,等等。它们都应为.TXT文件。 你通过命名这些文件来定义入口的顺序。如果你计划有99个入口，可以把文件命名为 "01.txt", "02.txt", ... , "11.txt", ...。
每个.TXT 文件的第一行被认为是每个入口的标题。
在杂志的提纲中(内容), 每个入口构成如下：
- 首先, 入口的数字(无扩展名的文件名), 接着是个符号(如 "#")或词语(如"章")，这些都是在配置文件中定义的。其组合链接到相应得入口页面。
- 然后， 是入口的标题 (.TXT文件的第一行。).
每种杂志的外观可以单独配置。- 通过自己的抬头，脚注文件，以及通过改变单独配置文件的变量。你可以控制整个输出，包括导航链接的文本等。
IV. 配制和数据
----------------------------------------------------
1. 你可以改变如下内容：
- 脚本文件名。 脚本文件名显示在浏览器的"位置"或"地址"域, 你可以加以改变。
- 缺省的入口目录名。
- 抬头, 脚注和单独配置文件名：同上都可改变。
注意:不要对defaultconfig.pl 和cgi-lib.pl改名。
2. 你现在可以在jconfig.pl中裁剪杂志的个别设置(参见文件中对每个变量的详细解释)
3. 创建 be-e-e-autiful 抬头和脚注。
注意: 这些文件中的相对链接或图象的基目录为脚本所处的目录。而不是杂志子目录。
4. 创建入口 (.TXT 文件).
注意:
- 入口的顺序按文件名的字母序排列。
- 每个文件的第一行作为标题。
- 在入口中你可以使用HTML标记。
- 再次提醒: 相对链接的基目录为脚本所处的目录。而不是杂志子目录。
V. 调用脚本
----------------------------------------------------
脚本接受两种参数，两者都是可选的。
1. 缺省调用:
http://www.yourdomain.com/cgi-bin/journal.cgi
- 用缺省行为打开缺省杂志。
2. 指示杂志名称:
http://www.yourdomain.com/cgi-bin/journal.cgi?folder=magazine
- 用缺省行为打开指定杂志。
3. 指示入口:
http://www.yourdomain.com/cgi-bin/journal.cgi?next=outline
- 显示缺省杂志的提纲
http://www.yourdomain.com/cgi-bin/journal.cgi?folder=magazine&next=1
- 显示指定杂志的第一个入口
http://www.yourdomain.com/cgi-bin/journal.cgi?next=8
- 显示缺省杂志的指定入口
http://www.yourdomain.com/cgi-bin/journal.cgi?folder=magazine&next=last
- 显示指定杂志的最后入口
（作者： 2000年01月24日 17:08）
|
|
