作者laechan (小太保)
看板mud_sanc
标题[指令] xhelp
时间Thu Oct 30 11:18:36 2008
指令写好後会开放测试。
这个指令的全名是树状式说明文件建构程式,要使用这项指令时,
通常会建议...
1)先拟好要建构的树状式说明文件的「初步大纲」
2)双开。一边操作 xhelp,一边 cd 到目录去看要链结的档名
(wiz 可双开)
这个指令可以让你一层一层地建构出你希望呈现的说明文件树状架
构,它包含以下几种操作指令...
*add xxx 增加一个说明项.
*del n 删掉第 n 个说明项.
move m to n 将第 m 个说明项移动到第 n 项之後.
*change n to xxx 将第 n 个说明项的内容更动为 xxx.
*link n to 文件档名 为第 n 个说明项设定文件连结.
*makesub n 为第 n 个说明项增设子说明串.
*cansub n 将敝 n 个说明项的子说明串全部删除.
*enter n 进入第 n 个说明项的编辑功能表.
*back 回到上一层.
*quit 离开操作.
(打 * 的部份代表我已写好的, move 可写可不写)
link n to 文件档名 的用意是,例如你建构了一个技能说明的
文件,其中一条支线是...
技能说明→剑士公会技能说明→Lv1~Lv5技能说明→基本剑法(sword)
你希望在最末端的基本剑法(sword)那边,使用者选了这个选项後,
就不再往下串,而是 show 出一个「基本剑法(sword)」的技能说明
文件时,就可以使用 link 功能...
link n to /doc/sk/sword
系统就会判断「基本剑法(sword)」是最末端的东西并有文件的连结
设定,而直接 show 出该文件的内容。
makesub 则是为一个说明串增设一个子说明串,例如底下某一支线..
技能说明→剑士公会技能说明
你希望「剑士公会技能说明」後面可以再串东西时,用 makesub 就
可以达到这个目的。
enter/back 则是进出一个子说明串用的,enter 也用以在最末层时
用来 show 出有 link 的文件(若无任何 link 就无法 enter)。
目前 xhelp 的完成度大概在 70% 左右,我还剩几个东西没写...
1)move m to n
2)import/export
3)preview
4)管理者特殊功能表
5)说明文件实体物件
写好後,不只 wiz 可用,玩家也可以使用,因为玩家可以帮忙建构
某一说明文件的「大纲」,连结部份交给 wiz 就可以了。
「甚至若玩家知道某一文件就是怎麽连结时」也可以自行连结测试,
我会在 link 内加设必要的限制判断(例如 .c 档不能读、只能连结
/doc 或 /open 下的东西等等、甚至玩家无法事先预读等等)。
我相信大家一直以来都会觉得圣殿的说明文件并没有写的很齐,而有
心想要写齐时又受限於编辑树状式说明文件需要耗费不少时间─重点
是树状式说明文件的修改非常麻烦。
以後有 xhelp 大家就可以一起帮忙建构圣殿的说明文件了。而且我
一直以来的想法就是,如果我要请各位(wiz & ppl)帮忙,那我必须
给各位至少用起来方便的工具,这样大家才会 happy doing it,而
且花费的精力与时间都可以相对减少。
最後,这个东西应该没有其它 mud 写过,有也是像 mudweb 那样的
结构罢了(圣殿的 mudweb 所建构的说明文件还可以直接放到网路让
IE 浏览,但缺点就是要手动去改树状结构),我希望这个可以成为
我在圣殿的代表作。
Laechan@Sanc
--
※ 发信站: 批踢踢实业坊(ptt.cc)
※ 编辑: laechan 来自: 218.170.229.178 (10/30 11:27)