Muquit计数器使用说明中文翻译

这是一个用来记录网页大致访问次数的 CGI 程序。它可以生成访问次数的GIF图像并将其作为内联图像返回给浏览器。该程序也可以选择运行时不显示数字图像，这样不显示数字也能保存访问的结果。对某个页面的访问可以不增加点击次数。程序也可以显示任何一个时区的时间和日期。还有对某一指定日期（过去或将来的）进行倒计时的功能。几乎所有的功能都是运行时的可选项。该程序开始只是为了摆弄CGI程序而编写的，但由于极大的兴趣、对功能的需求以及大家的反馈信息，现在它已经成为整个World Wide Web上最可配置的计数器了而且它是免费的。该程序在几乎所有已知 Unix 平台、 Windows NT、 OS/2、VMS 和 Amiga 上都可以运行。

该计数器程序有许多选项，你可以按你喜欢的方式使用。在下面的参数列中你可以使用下面表中的选项，选项间用 | 或 &隔开，你可以使用两者中的一种或同时使用这两种，但我倾向于 &因为有的浏览器不喜欢 |，下面是一个例子：

格式 A		本人(指Muquit——译者注，以下同）设计， D, H, M, S 段由 Andrew Taylor 添加。 (digits/A/strip.gif)
格式 B		从 HTML-access counter 中借用来。 (digits/B/strip.gif)
格式 C		由 benjamin@pop3.oro.net 设计 (digits/C/strip.gif)
格式 D		本人设计 (digits/D/strip.gif)
格式 E		本人设计 (digits/E/strip.gif)
格式 cd		本人在 SGI 上用 Linux 上的 GIMP 制作，countdown（倒计时）选项需要 D,H,M and S。 (digits/cd/strip.gif)
格式 cdr		Mike Casper 提供 (digits/cdr/strip.gif)
格式 cdd		Sebastian Hartman 提供 (digits/cdd/strip.gif)
格式bang		Bangla 数字，是本人用 GIMP 做的。 (digits/bang/strip.gif)

参数	名称	描述	默认值
cache = B expires = X	这两个参数可以改变浏览器的的cache行为	cache的布尔值告诉浏览器是否使用 cache 中的图像. 整数值 expires 确定 cache数据报废的秒数。如果 cache=F, 浏览器就会直到在 expires 参数规定的秒数外，cache中的图像就报废了。如果 cache=F 且expires=0, 浏览器就不将图像放在cache中，这样你返回到原来的主页时，计数器就会刷新. 使用这个特点会加重系统的负担。当 cache=F时， expires中的参数值才是又意义的 , 如果 cache=T, expires 参数就被忽略了，计数器不会产生任何 HTTP Expires header。这是默认行为。 cache 项的有效布尔值是 Y,N,F,T 1或 0. expires项的有效参数范围在0 到 604800 (7 天)之间. 注意这些参数只对支持HTTP 标准中的HTTP Expires header 浏览器有效 . 在默认情况下，大多数浏览器能够按计数器所要求的值cache保存计数器图像. 也就是说，如果有人访问了你的页面，他那么他返回时计数器或时钟是不会刷新的。	cache = T expires = 0
reload = B	如果配置文件支持，在reload的时候计数器加1。 (Added on: Dec-05-1998)	如果管理者在配置文件中支持计数器刷新，用户就可以自行确定在网页reload时计数器是否加1. 将配置文件关键字count_reload中的选项设为 yes, 1 或 true 就可以支持这个功能。注意如果管理者决定忽略reload ,用户的请求就会被忽略。 reload的合法布尔值是 Y, N, T, F, 1 和 0. （译者注：为了保证计数的真实性，本实验室的计数器不支持刷新）	reload=T 如果配置文件支持，计数器就会在刷新时加数。
cdt= year;month; day;hr;min; sec (Added on: Dec-13-1998)	显示到目标日期的倒计时时间	参数 cdt 确定倒计时的目标日期.该参数的合法值是用分号隔开的六个整数值. 第一个整数表示年份，例如：2000，月份从1（一月）开始。第一天是1。如果想要现实到2000年的倒计时，参数设定应该为 cdt=2000;1;1;0;0;0。如果你没有用参数 timezone来设定时区，倒计时将按 web server的时间进行. 例如如果想要现示GMT的倒计时, 可以将时区设定为 timezone=GMT+0000.	无
sdhms = B	在倒计时时是否显示日期、小时、分、秒	该参数影响倒计时的显示方式。布尔参数sdhms的合法值是Y, N, T, F, 1 和 0。该参数的默认值为真也就是说倒计时显示天、小时、分和秒。如果你指只想显示倒计时的天数，只要将这个值设为F就可以了。	sdhms=T
sfd = B	在倒计时的时间下面显示当前日期。	参数sfd在倒计时时间的下面显示当前。当前日期就是程序被执行的日期。时间是24小时格式，如果使用参数 timezone。时区参数将在时间的最后显示。这对于确证程序执行的日期以保证图像不是从cache中取来的很有用处。用 cache=F&expires=0 可以保证浏览器布不使用cache中的图像。布尔参数 sfd的合法值是 Y, N, T, F, 1 和0。	sfd=F
display = X	确定要显示的内容	X的合法值是： counter, clock, date, countdown, image 或 version. 如果值是 countdown 而且如果倒计时时间没有用参数 cdt设定倒计时默认为到2000年。参见: cdt。注意: 如果设定 display=image 而且用 df 参数设定了数据文件名且incr 为真, 那么计数器的值将只在记树文件中增加，如果有任人不想把计数值放在页面,他们可以用一幅图像代替。可以使用另一个页面的 incr=F 来管理计数器。	display = counter
timezone = X	用指定的时区显示日期和时间。	参数timezone= 只有当 display=clock, display=date 和 display=countdown 时才有意义。用该参数可以显示另一个时区的时间和日期或在倒计时时指定参考日期为给定时区的。时区必须用一个表示到GMT偏移的四位正数或负数指定，例如: timezone=GMT-0500 或 timezone=GMT+0000 或timezone=GMT+0530。显示时间的程序是通用的，因此，unix机将不考虑夏时制的实行。例如，如果在夏时制时期，纽约的时取将不是timezone=GMT-0400 而是timezone=GMT-0500 。如果时钟显示你的本地时间错误，就需要用timezone参数指定正确的时间。	无
tformat = X	指示时间格式是12小时制还是24小时制	用该参数可以以12或24小时的格式显示时间。X的有效值是12或24。	tformat = 12
dformat = X	确定日期格式	该参数有效仅当 display=date时。该字符串参数的有效值是MMDDYY (Month-Day-Year)的任意组合，例如 dformat=ddmmyy, dformat=YYMMDD。如果你想显示年份的全部数字而不是只有两位数字，可以使用YYYY 代替YY,例如 dformat=MMDDYYYY。如果想要显示年分的全部数字可以使用参数fy.	dformat = MMDDYY
fy=B	显示年份的全部数字而不仅仅是两位数字。	该布尔参数表示是否显示年份的全部数字，因为一般都是显示两位数字。另外该程序从2000年起将显示年份的所有数字。该布尔参数的合法值是 Y,N,T,F,1 和 0。参见: dformat。	fy=F
istrip = B	是使用条形数字还是使用单个的数字图像	布尔值istrip确定是否使用条形数字图像。如果将istrip设为F, 该程序回在 digits/style目录下找单个的数字图像。布尔参数istrip的合法值为Y, N, T, F, 1 和0。	istrip=T
ft=X	边框厚度	你可以用一个厚度为X像素的装饰性边框将计数器包起来。厚度超过5看起来就会呈现3D效果。	ft=4
frgb = R;G;B或 frgb = RRGGBB (十六进制)	边框颜色	用RGB格式(red/green/blue)格式指定计数器边框的颜色。每种颜色分量 R, G, B用一个0到255之间的数值指定. 如果你使用了 ft= 参数而没有使用frgb=参数,将使用默认的颜色。如果设置了frgb= 但没有设置ft=, 则默认边框厚度为5。所有例子的厚度都为5 。颜色也可以用十六进制数或名称确定。不要像Netscape那样在十六进制数前面加#。例如如果你想用十六进制数表示白色可以这样写frgb=ffffff。也可以使用颜色的名称 (例如frgb=blue) 如果计数器的配置文件允许这么做(参见配置文件). 要使用颜色名字可以访问可以访问 color name mapping database 。	frgb = 100; 139; 216 或 frgb = 648bd8
tr=B	是否透明	用布尔量B可以为计数器图像指定一种透明颜色。于是tr=Y的意思是有一种透明颜色。用来表示数字的GIF图像是否是透明无关紧要；你要明确指出你所要的透明颜色是哪一个。如果你使用了trgb=,那么你就要用tr=Y。如果你使用了tr=Y而没有使用trgb=,则默认的透明颜色将为黑色。B的合法值为 Y, N, T, F, 1,和 0。	tr=F不指定透明颜色
trgb = R;G;B 或 trgb = RRGGBB (十六进制)	透明颜色	用RGB (red/green/blue) 格式指定要确定为透明的颜色。每个颜色分量用 R, G, B 用0到255之间的一个整数值确定. 如果你使用了tr=而没有使用trgb= 参数, 就使用默认的颜色。颜色也可以用十六进制数或名称指定，要像Netscape那样在十六进制数前面加#。例如如果你想用十六进制数表示白色可以这样写trgb=ffffff。也可以使用颜色的名称 (例如tfrgb=blue)。如果计数器的配置文件允许这么做(参见cfg 文件). 要使用颜色名字可以访问可以访问 color name mapping database 。如果使用了 trgb= 那么就可以不用写tr=Y。	trgb = 0;0;0 或 trgb = 000000
md = X	最大位数	确定显示数字的最大位数。可以是5到80之间的任意值。当位数没有达到最大值时在前面自动添零；如果比最大位数长则超出部分自动截去。	不使用padding参数 md=6
pad = B	左边用零填充	和md= 一起设置左边添零。该参数同样也影响时钟小时的添零。布尔参量B的合法值为 Y, N, T, F, 1, 或 0.	不指定md = pad=N 指定md = pad=Y
dd = A	数字目录	指定某一风格的数字的目录。我提供四种风格的数字。它们分别放在目录 A,B,C, D中。如果要使用其他形式的数字请访问 digit mania 的页面。	dd=A 我的绿二极管数字
image = gif_file	显示该GIF文件	用这个参数你可以显示指定的GIF图像。文件的位置可以用dd= 参数指定。注意GIF文件名中不允许包含图像信息。计数器的所有属性对该图像适用。该参数用来将计数器图像和该GIF图像合成显示。默认的对齐方式是在顶部中央，默认的偏移量距GIF图像顶部2个像素。如果你想要在将时钟、倒计时和图像复合在一起，可以使用 display 参数。	无
comma=B	每三个数字之间加一个逗号。	该布尔制确定是否在右边开始每三个数字之间显示逗号。如果将该参数设为真，左边的零填充将被取消。	comma=F
srgb = R;G;B或 srgb = RRGGBB (十六进制) prgb = R;G;B或 prgb = RRGGBB (十六进制)	将图像中的一种颜色转换为目标颜色。	图像中的任何一种颜色都可以转换为另一种不同的颜色。srgb表示源颜色，也就是要被转换的颜色。 prgb代表笔的颜色，也就是目标颜色。 srgb 和 prgb 的值可以用分号格开的分量(例如, srgb=255;0;0)表示也可以用十六进制数(例如 srgb=ff0000)或颜色名称(例如 srgb=red)表示。如果配置文件允许使用颜色名称你就可以使用颜色名称。 (参见配置文件).	指定chcolor = T srgb = 00ff00 (0;255;0 绿色) prgb = 00ffff (0;255;255 洋红)
chcolor=B	改变图像中的一种颜色。	该参数通常用来将默认的绿色该为洋红色。如果你设置chcolor=T,而且你想将绿色该为洋红色那么你就无须设置srgb和prgb参数。显示1x1的 GIF。布尔参数的合法值为Y, N, T, F, 1, 和 0 。	chcolor=F
st=X	起始数值	该参数用来设置计数器的初始值为 X。只有当设置了数据文件可以自动生成时这个参数才有效。允许数据文件自动生成是不好的，但是这样可以使维护变得容易一点。数据文件的自动生成是在配置文件中设置的并且可以在运行时改变。注意该参数对已经存在的数据文件是没有意义的。如果你想要改变已经存在的计数器的值，必须用手工修改的办法，最小的起始值为1。	st=1 记数从1开始
sh=B	显示数字	该参数根据布尔量sh=B打开或关闭数字的显示。当sh=T时，将显示并增加记数值。这是默认行为。如果sh=F就不显示数字，但计数器将仍然记数，只不过只显示一个 1x1 的透明GIF而已。布尔参量B的合法值为 Y, N, T, F, 1,和 0	sh = Y
df = data_file	存放记数值的数据文件	确定存放记数值的文件的名称。文件必须按上述 "Authorizations"部分所述进行分配。可以使用 df=random 来显示随机数。该参数的一个特殊用途是df=RANDOM。它用主机的日期时间的分数部分作为生成元迭代。和其他WWW计数器不一样，该计数器是区分大小写的，但random这个词除外，像Random,rANDOM等都可以。	如果没有指定数据文件df = random
incr= B	是否增加	有可能不增加记数值就可以显示当前的记数值。可以用在不需要增量的场合下比如取得记数用于报告或其他目的。布尔值B的合法值是Y, N, T, F, 1, 和 0。	incr=T 计数器增加
lit = X	显示文字	可以显示一个预先确定的字符串。字符串X的合法值为数字、 a,p,: 和 -。	无
negate = B	颜色取反	可以将计数器数字的颜色反色。注意边框的颜色不在反色之列。布尔参数B的合法值为 Y, N, T, F, 1, 和 0。	negate=F 不取反
degree s= X 或 angle=X	旋转X度	可以将计数器图像旋转X度。X的可取值为 90, 180, 270 和 360。注意 360 是无意义的因为计数器又转了回去。注意: 微软 MS Explorer浏览器将 &degrees 解释为度数的符号(这是 IE的一个漏洞),所以安全起见应使用 angle。	当rotate = Y且没有degrees = X时默认 degrees = 270 顺时针旋转270度
rotate = B	旋转打开/关闭	布尔值B可以打开或关闭旋转。如果你使用degrees= 设置, 就不需要rotate 。布尔参量B的合法值为 Y, N, T, F, 1, 和 0。	rotate = F 不旋转
xy=x;y	在基图像的x,y处合成计数器图像。	当用 image参数指定基图像时，可以用xy来指出计数器图像在基图像上的合成位置x,y。 x 向右为正，y向下为正。基图像左上角的坐标为 0,0。参见: align。	xy=1;1
align = X	将计数器/时钟/倒计时图像按指定的对齐方式与基图像合成在一起。	该选项可以将计数器图像合成在基图像上(由 image 指定给定的宽和高)。这样在调用计数器时就可以在<img src= tag 中指定计数器图像的宽和高。含义是如果计数器是一个大表中的第一项，浏览器就无须等待下载图像的其余部分来计算图像的宽和高。该参数的合法值为 topleft, topcenter, topright, midleft, midright, midcenter, bottomleft, bottomcenter 以及 bottomright。参数 offset 可以用来指定从基图像的边缘算起的偏移量。注意: xy 参数有更高的优先级。因此如果xy和align被同时设定，xy将占先。参见: xy。	align = bottomcenter
offset = N	将计数器图像和基图像合成时从基图像边缘以像素为单位计算的偏移量。	参数offset和参数align一起使用，将计数器图像和基图像合成时用它们确定以像素为单位的计数器图像相对于基图像边缘的偏移量。如果 align=topleft, 偏移就从基图像的上边和左边开始计算。如果align=topcenter, 偏移量就从基图像的上边开始计算。如果 align=topright, 偏移量就从基图像的顶部和右边开始计算。如果 align=midleft, 偏移量从基图像的左边开始计算。如果 align=midcenter, 偏移量就被忽略。如果 align=midright, 偏移量就从基图像的右边开始。如果 align=bottomleft, 偏移量从基图像左边和底部开始计算。如果 align=bottomcenter, 偏移量从基图像的底部边界开始计算。如果 align=bottomright, 偏移量从基图像的右边和底部开始计算。参数N是一个正整数。参见: xy。	offset=2

本计数器作者为Mr.Muhammad A Muquit(穆汗穆德·阿·穆科特先生），在此我向他表示诚挚的感谢。征得Muquit先生本人同意，我将他的使用文档的一部分翻译为中文，供大家参考。原文件地址为
http://www.fccc.edu/users/muqiut/Count.html
email 原件如下：
------------------------------------------------------------------------------
Youbing Zhao wrote:
>
> Hi,Mr Muhammad A Muquit:
> Would you mind if I translate the usage of your counter into Chinese(only the usage table)?
sure, it'd be great! But wait till I make a new release (probably today), there
are some new things.
thanks.
--
Muhammad A Muquit, ma_muquit@fccc.edu, http://www.fccc.edu/users/muquit/
------------------------------------------------------------------------------

align	- 计数器图像的对齐
cache	- 和 expires 一起使用用于确定浏览器的Cache的行为
chcolor	- 改变计数器图像的一种颜色
cdt	- 倒计时目标日期
comma	- 在计数器每三个数字间加一逗号
dd	- 数字目录
degrees or angle	- 图像旋转角度
df	- 计数器数据文件
dformat	- 日期格式
display	- 用于选择功能是计数(counter),时钟(clock),日期(date), 倒计时(countdown) 或图像(image)
frgb	- 外框的颜色
ft	- 外框的厚度
fy	- 年份用全部数字表示
image	- 显示GIF图像
incr	- 是否增加计数器的值
istrip	- 是否使用条形数字
lit	- 显示文字字符串
md	- 显示的最大位数
negate	- 显示计数器图像的负像.
offset	- 合成时计数器图像在底层图像上的偏移量
pad	- 左边是否以零填充
reload	- 计数器在reload时加不加数
rotate	- 旋转计数器图像
sdhms	- 在倒计时时是否显示天、小时、分、秒.
sfd	- 在倒计时时是否显示目标日期
sh	- 是否隐藏计数器
srgb, prgb	- 将源颜色变为笔(目标)颜色
st	- 开始计数的起始数目.
timezone	- 时区信息
tformat	- 时间格式是 12小时还是 24小时.
tr	- 是否生成透明图像
trgb	- 指定透明的颜色
xy	- 在底层图像的x,y处合成计数器图像.