readme.txt

Perl 脚本程序 文本计数器 运行环境 linux

#########################################################
#CGI脚本名称:文本计数器		                        #
#文件名:t2gcount.pl                                     #
#版权所有: gambler                                      #
#E-mail:  [e-mail]                               #
#主页地址: Perl Union(Perl盟) http://www.sinoboy.com    #
#            Copy Right gambler   1998.12.              #
#########################################################
#本CGI脚本为免费软件，使用者可以任意修改、增删脚本内容。#
#如果您的网站正式起用这个脚本，请您通知我们，以便我们拥 #
#有样本网站，或者在您的网站做上我们的链接。             #
#要求不高，请您尊重我们的劳动成果和版权。 谢 谢！       #
#########################################################
##请您尊重我们的劳动和版权，不要删除以上的版权声明部分###
##您可以免费使用、转载，但不得出售做商业用途   	      ###	
#########################################################

	本程序无须SSI(Server Side Include)支持，可以直接在*.html
文件中使用。本程序包共有4个文件：
	t2gcount.pl--------即CGI主程序
	run.gif	   --------一个小图形文件，此文件您也可以随意制作，
			   但是必须要有，非常重要，下面将详细介绍
	count      --------访问次数存放在此文件中，另外还有使用此计数器
			   的页面的绝对路径
	readme.txt --------既您现在看到的文件

下面将分别介绍各个文件(只介绍UNIX环境下使用，NT恕不做解释)：
			*******************
			    t2gcount.pl
			*******************
	此文件必须放置在您的cgi-bin目录下，如果您不知道或者没有，可
以向系统管理员询问或申请，然后使用命令"chmod 755 t2gcount.pl"使它可
被任何人执行。

细节简介
--------
#!/usr/bin/perl
	文件第一行虽然为注释行，但是对PERL来说必须存在，这是PERL解释
	程序的所在位置，一般形如：
		#!/usr/bin/perl	或者 #!/usr/local/bin/perl
	您也可以使用"which perl"指令得到，当然您得有权限登录主机才行，
	否则询问系统管理员；

$count_dir="/home/path/username/public_html/counter";
	存放记数文件的目录的绝对路径，目前国内免费主页提供商如果提供
	CGI权限，一般都会告诉用户其绝对路径的

$img="http://www.your.com/images/run.gif";
	指向LOGO的URL，细节见下面对run.gif的介绍

$count_font="MTBWidgets";
	计数器数字的字体，最好选择多数浏览器可以接受的字体,上面默认字
	体在IE下观看类似液晶字体

$strong1="<strong>";
$strong2="</strong>";
	计数器数字是否使用粗体，如果不需要，取空值即可，如：$strong=" ";

$count_fore_color="0,255,0";
	计数器数字颜色，默认为绿色，您可以随意更改，这里为十进制

$count_back_color="0,0,0";
	计数器数字的背景色，同上，默认为黑色

$count_size="4";
	计数器数字大小，大小规则符合HTML语法

$border1="2";
$border2="0";
$border3="0";
	上面三个均为计数器边框宽度，建议取默认值，当然您也可以随意更改试试效果

$bordercolorlight="#00FF00";
	计数器浅色边框颜色，为十六进制，规则符合HTML语法

$bordercolordark="#0000FF";
	计数器深色边框颜色，同上
$total_size="7";
	计数器最大位数

也可以精心制作一个，但是一定要有此
	文件。它非常关键，计数器运行的是否成功，从这个小小的LOGO就可
	以看出来,运行如果没有显示此LOGO，表示计数器运行不正确。

			*******************
			      run.gif
			*******************
	此图形文件您可以放置在任何您想放置的目录内，只是请记下它的URL，因为
您也看到了，上面文件的变量定义需要。这个图形您也可以自己随意制作，比如您的网站LOGO
或者一个可爱的动画等，但是有一点您要清楚，这个图象在主页中的显示位置是在页面的最下
边，也就是仅在HTML代码中"</body></html>"之前，在其它任何语句之后，所以您还要斟酌一
下，做个什么样的图形。比如本人，为了省事，只随便做了一个非常非常小的和主页背景色一
致的图形。

			*******************
			      count
			*******************
	此文件包含两部分内容，第一部分是访问次数，比如565678；第二部分是使用此计数器
的页面的绝对路径，比如"/home/path/username/public_html/index.html"。就是说这个计数器
目前放在这个页面上，已经有565678个用户访问过此页面。如果您反应比较快，应该已经想到您
可以为自己的每个页面都安排一个计数器，当然，要多制作几个这样的文件。:)
注意，这两部分在一行，是以","分割的，您可以打开程序包中的例子看看。这个文件的属性要求
是766或者666

************************************************************************************
	OK，主要的已经说完，下面介绍一下在主页文件中是如何嵌入的。注意，也很重要哦，
否则您将无法使用此计数器。

首先，在您希望放置计数器的位置插入一对注释标签"<!--count-->	<!--count-->"，注意，
您主页内容的其它部分千万不要放在这对标签之间，否则等下一位用户访问时，将消失的无影无
踪。
其次，在该HTML文件的最后，也就是"</body></html>"之前，插入下面代码：
		<img src="http://www.your.com/cgi-bin/t2gcount.pl?count">
t2gcount.pl就是主CGI程序，count就是上面存放数据的文件,如果您想为每个页面都加一个计数
器，那您就多做几个这样的文件(当然文件名不能一样)，其中的第二部分别忘了换换，另外这几
个文件都要放在变量$count_dir="/home/path/username/public_html/counter"定义的目录下。
举例说明，您有1.html和2.html两个页面，那么分别是：
	<img src="http://www.your.com/cgi-bin/t2gcount.pl?1">
	<img src="http://www.your.com/cgi-bin/t2gcount.pl?2">
文件"1"的内容是：
	1232,/home/path/username/public_html/1.html

文件"2"的内容是：
	3452,/home/path/username/public_html/2.html
文件1和2都放在"/home/path/username/public_html/counter"目录下。

最后，也是非常重要的一点，别忘了把放置计数器的页面的属性改为766或者666，就是说可读写。

--------------
如果您还不太清楚，本程序包附有例子，你可以用文本编辑器打开count.html和count两个文件
看看是如何使用的。
--------------

_____________________________________________
 收集/整理: 混网工作室http://badman.my163.com