Project:源代码编辑指南
说在前面
此指南面向还未上手源代码编辑的新手。
大部分情况下,源代码编辑比可视化编辑更好用;所以当你要经常编辑维基时,不妨花几分钟学习一下源代码编辑。
源代码编辑其实不难,当成TXT去写都可以;点开已有页面的源代码编辑,使用下方的“显示预览”查看效果,很容易就能搞明白什么是什么了。
文本编辑相关(基础)
这一章会介绍一些编辑文本常用到的东西。
这章的难度非常简单;只需要记,不需要逻辑。
段落标题
段落标题可以更好地编排文章结构。
源代码编辑中所输入的内容:
== 二级标题 == 您可以使用段落标题来更好地编排文章结构。 维基的软件会自动将文章中的标题生成一个目录。 === 三级标题 === 左右分别输入多一个的“等于号”(=)可以创建更多下一级标题。 ==== 四级标题 ==== 请不要跳跃标题等级,例如二级标题之下直接就是四级标题,而没有三级标题。 请在输入标题时最少使用2个等于号(=),而不是1个。 你可能已经注意到了,到此为止都没有提到“一级标题”—— 那是因为所谓的“一级标题”即为页面标题,比如本页最上面的“{{色|{{PAGENAME}}|2}}”。 ===== 五级标题 =====
最终显示在维基上的内容:
您可以使用段落标题来更好地编排文章结构。
维基的软件会自动将文章中的标题生成一个目录。
左右分别输入多一个的“等于号”(=)可以创建更多下一级标题。
请不要跳跃标题等级,例如二级标题之下直接就是四级标题,而没有三级标题。
请在输入标题时最少使用2个等于号(=),而不是1个。
你可能已经注意到了,到此为止没有提到“一级标题”——
那是因为所谓的“一级标题”即为页面标题,比如本页最上面的“太吾绘卷:源代码编辑指南”。
列表、换行
打算列出多个要点时,推荐使用列表。
列表
源代码编辑中所输入的内容:
*要点1 *要点2 **要点2中的要点1 **要点2中的要点2 *要点3
最终显示在维基上的内容:
- 要点1
- 要点2
- 要点2中的要点1
- 要点2中的要点2
- 要点3
若希望列表自动编号,将*
换成#
即可,且*
和#
可混合嵌套:
# 第一 # 第二 #* 第二的注释1 #* 第二的注释2 # 第三
最终显示在维基上的内容:
- 第一
- 第二
- 第二的注释1
- 第二的注释2
- 第三
两种列表前都可以加缩进符,每个缩进符可以将文字向右缩进两个汉字的位置,以下是一个比较极端的用例:
:*要点1 :**要点1的注释 :::#标题1
最终显示在维基上的内容:
- 要点1
- 要点1的注释
- 标题1
- 要点1
换行
源代码编辑中所输入的内容:
另起一行 会变成一个空格。 除非使用<br /> 用了之后就会换行了;不过用<br /> 换行会比空行换行有更小的行间距。 空出一行也会开始一个新段落。
最终显示在维基上的内容:
另起一行 会变成一个空格。
除非使用
用了之后就会换行了;不过用
换行会比空行换行有更小的行间距。
空出一行也会开始一个新段落。
链接
如果在编辑文章时中提到了其他文章中的内容,不如使用链接以方便读者转跳的对应的界面。
源代码编辑中所输入的内容:
适用例子:一些[[宝物]]可以提高装备者的[[主要属性]]。
最终显示在维基上的内容:
可以修改链接的显示文字和跳转章节:
[[商会#好感|商会好感]]
表示跳转到「商会」页面的「好感」章节,并将显示文字修改为「商会好感」。效果如下:
link
如果在编辑文章时中打算提起某个物品/功法/特性,不如使用link;因为相较于文字,其可以更好地显示对应的内容。
源代码编辑中所输入的内容:
*{{link|功法|纯阳无极功}}、{{link|物品|竹叶青茶}}、{{link|特性|混元奇窍}}都可以提高人物的内功发挥。 *对于功法,如果想强调正/逆练的话,可以在功法的名字后面加上“|正”或“|逆”;例:{{link功法|纯阳剑意|正}}和{{link功法|湘女泣苍梧|逆}}。 *对于同名的特性,如:{{link|特性|浑心无字}}和{{link|特性|浑心无字|2}},则在其名称后面加上“|2”,用数字区分。
最终显示在维基上的内容:
纯阳无极功、
竹叶青茶、混元奇窍
都可以提高人物的内功发挥。
- 对于同名的特性,如:浑心无字
和浑心无字
,则在其名称后面加上“|2”,用数字区分。
黑幕、tooltip
黑幕和tooltip都可以把部分内容“藏起来”,具体适用环境见下文。
黑幕
黑幕一般用于遮挡引人发笑的事实、梗、吐槽、笑话等;在不是很严肃的文章中,可以适量过多会导致审美疲劳并妨碍正常阅览添加一些有趣且合适比如说玩梗,在太吾绘卷wiki中玩太吾绘卷相关的梗则是最合适的的内容并打上黑幕,让读者体会你的幽默。
源代码编辑中所输入的内容:
武当派武功博大精深,最重内功修养,创派祖师真君道法高深,太极神功名满天下,堪称天下内家功法第一。{{黑幕|但是武当没有一品内功}}
最终显示在维基上的内容:
武当派武功博大精深,最重内功修养,创派祖师真君道法高深,太极神功名满天下,堪称天下内家功法第一。但是武当没有一品内功
tooltip
tooltip一般用于对部分相对次要的内容进行简短的注释;保持版面整洁以方便阅览。
(像这样打个括号来注释也不是不可以,但这样会在一定程度上干扰阅览,过多的括号还会影响版面整洁;不过也有括号优于tooltip的情况,所以具体用哪种方式请自己决定。)
源代码编辑中所输入的内容:
武当派乃正派名宗;立场以中庸为主,派中多中庸之士;不会向{{tooltip|名誉过低|名誉不高于名声败坏}}之人传授武学。
最终显示在维基上的内容:
武当派乃正派名宗;立场以中庸为主,派中多中庸之士;不会向名誉过低名誉不高于名声败坏之人传授武学。
字体样式
希望强调部分内容时,可以使用特殊字体。
- 粗体字
- 在字的两边都加上3个单引号,就像这样:
'''粗体字'''
;这时字就变成了粗体字。(注意是英文使用的引号)
- 在字的两边都加上3个单引号,就像这样:
- 斜体字
- 在字的两边都加上2个单引号,就像这样:
''斜体字''
;这时字就变成了斜体字。
- 在字的两边都加上2个单引号,就像这样:
- 粗斜体字
- 在字的两边都加上5个单引号,就像这样:
'''''粗斜体字'''''
;这时字就变成了粗斜体字。
- 在字的两边都加上5个单引号,就像这样:
删除线- 在字的两边分别分别加上
<s>
和</s>
,就像这样:<s>删除线</s>
;这时就会出现一条带删除线的内容。
- 在字的两边分别分别加上
- 下划线
- 在字的两边分别分别加上
<u>
和</u>
,就像这样:<u>下划线</u>
;这时就会出现一条带下划线的内容。
- 在字的两边分别分别加上
颜色
希望强调部分内容时,也可以使用颜色。
源代码编辑中所输入的内容:
这是{{色|红色|1}}。 这不是{{色|蓝色|7}}。 这是不是{{色|绿色|5}}?
最终显示在维基上的内容:
这是红色。
这不是蓝色。
这是不是绿色?
对于{{色|红色|1}}
,其中{{色}}
属于格式,|
用于把各部分分开,红色
属于内容,1
则是颜色代号。
常用颜色代号:(与品级的颜色相同)
1 2 3 4 5 6 7 8 9
补充
来自灰机主站的编辑指南:
模板
模板(template)为以{{模板名|参数1|参数2|a=参数a|b=参数b}}
形式调用的可复用内容,可以在对应的[[模板:模板名]]页面查看其文档及源代码。掌握相关知识后,也可修改或创建模板。
上文中提到的{{黑幕}}、{{tooltip}}、{{色}}均为常用的模板。
自定义查询
这个我其实也还没完全搞懂,希望了解的人可以帮忙改进。
模板:自定义查询使用自定义表达式来查询游戏数据。
源代码编辑中所输入的内容:
{{自定义查询|功法|筛选= 内息~=0 or 内息发挥~=0|类型= 内功|排序= (内息 + 内息发挥*5)*(发挥上限/100)/占格|显示=@::内功|数量=3}}
最终显示在维基上的内容:
内功 | (内息 + 内息发挥*5)*(发挥上限/100)/占格 | 内息 | 内息发挥 | 发挥上限 | 占格 |
---|---|---|---|---|---|
![]() | 205.83 | +175 | +30% | 190 | 3 |
![]() | 174.17 | +125 | +30% | 190 | 3 |
![]() | 144 | +100 | +16% | 160 | 2 |
虽然这看起来很长、很难,但是别着急,把它拆开,一步一步来:
{{自定义查询}}
是模板名,必要。|
用于把各部分分开,必要。功法
是第一项参数,用于设定需要查询的内容,必要。- 经常被调用的还有物品和特性。
筛选= 内息~=0 or 内息发挥~=0
是行动指示,必要。筛选=
是行动的名称。内息~=0 or 内息发挥~=0
是判定条件。or
是“或”,即满足or判定的其中一项即可。and
是“和”,即需要满足and判定的全部项。and
和or
混用时请加上括号。=
是正选,即满足条件后会被选中。~=
是反选,即满足条件后会被过滤掉。- 所以这里只有满足“内息不等于0”或者“内息发挥不等于0”其中一个条件后才会被选中。
类型= 内功
是另一项判定条件,选填,不填则使用默认值,即不做判定。排序= (内息 + 内息发挥*5)*(发挥上限/100)/占格
是排列顺序,选填,不填则使用默认值,即根据筛选的判定条件以排列。(内息 + 内息发挥*5)*(发挥上限/100)/占格
是排序的依据。
显示=@::内功
是标题,选填,不填则使用默认值,即空白。数量=3
是限定本次调用结果最终显示的数量,选填,不填则使用默认值,即20。
吐槽:写得头大,可能有遗漏;原本想要实现的有:
列出全部的“必填项”、“选填项”,列出筛选中的每一个“可用项”(比如:材质=“布帛#硬”;装备类型~=“衣着”)
顺带再问一下筛选心法的时候有没有办法 反选/手动过滤 一些描述上可以被选中但无关的功法?
(比如护体绝技篇的 “针对敌人的护体绝技” 中用 “心法=敌人.*护体功法” 就会选到五虎群羊棍;
虽然可以用 “心法=敌人.*护体功法.[^正]” 将其过滤,但这样不美观。)
如果没有的话那就……给我整一个.jpg
模块
模块(module)为以{{#invoke:模块名|函数名|参数1|参数2|a=参数a|b=参数b}}
形式调用的lua函数,可以在对应的[[模块:模块]]页面查看其源代码。掌握相关知识后,也可修改或创建模块。
表格、invoke(进阶)
这一章会介绍表格、筛选等进阶内容。
这章的难度有一定难度;在需要记的同时,也需要逻辑。
表格
其实我也不会表格,有没有好心人帮我填这个坑?
内容未完成!
FilterDiv
内容未完成!
其他
话说还有什么值得被添加进来的?一时半会想不到了