wiki:使用指南

版本差异

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版		 前一修订版
wiki:使用指南 [2022/12/09 05:47] – OTZzzzwiki:使用指南 [2023/12/10 21:06] (当前版本) – [常用的工具栏功能] OTZzzz
行 1: 行 1:
-~~DISCUSSION~~ +======想写维基吗？请从第一行开始阅读======
-=====使用指南=====+
  
-关于维基的基础语法，请参阅[[wiki:维基语法]]。+欢迎来到<ff 'Georgia', serif>PVZ Wiki</ff>！
  
-如果你是管理员，请额外阅读[[wiki:op指南|OP指南]]。+开始编辑之前，请<wrap em>务必通读本文</wrap>，切勿在不理解维基语法的情况下强行编写词条，于己于人都无益。
  
-====维基功能====+=====1/5 命名空间=====
  
-未注册用户可以添加、编辑词条，但无法发布评论。+<wrap em>所有</wrap>页面都存放在不同的[[doku>zh:namespaces|命名空间]]（类似文件夹）下。
  
-已注册用户的IP地址不会被公开显示，且编辑词条时无需输入验证码。+> 例如，[[人物:3C妹妹|人物:3C妹妹]]👈<wrap lo>是英文冒号！</wrap>是存放于<badge>人物</badge>命名空间下的词条
  
-右上角【工具】--->【最近更改】可以查看最后更新的页面；【站点导航】可以查看词条一览。+可选择的命名空间：<badge>人物</badge> <badge>阵型</badge> <badge>事件</badge> <badge>攻略</badge> <badge>社群</badge> <badge>重定向</badge> <badge>消歧义</badge>
  
-====上传头像====+要更改命名空间，点击右侧工具栏<button type="info">页面重命名</button>修改前缀即可。亦可用此法修改词条名。
  
-点击右上角【工具】--->【媒体管理器】，在<wrap hi>根目录</wrap>下上传头像图片即可。文件名必须是：<wrap hi>user:XXX</wrap>，其中XXX为你的用户名。+搜索词条时，应**带着命名空间前缀搜索**，这样创建出来的词条自动带有命名空间。
  
-====文字排版====+=====2/5 基础语法=====
  
-<ff serif>PVZ Wiki</ff>内置许多富文本编辑功能。+进入编辑界面后，可以看到如下工具栏：
  
-大部分功能很直观，其中【纸盒工具】非常有用：+{{wiki:配图:20221210-124810.png}}
  
-{{:pasted:20221206-163416.png?400}}+====常用的工具栏功能==== 
 +<callout type="success" title="开盒即用" icon="true"> 
 +以下功能在工具栏里直接点击即可使用，无需记住语法 
 +</callout> 
 +  * **加粗**、//倾斜//、__下划线__、''P6-3I''（等宽字符）、<del>删除线</del>
  
-有分栏、标识框、<wrap hi>高亮</wrap>、厚黑（图标为“lo”，<wrap lo>效果是这样</wrap>）等常用功能。+  * 各级标题（六个等号为一级标题，五个为二级，依次类推）
  
-====快捷文本====+  * 插入[[:home|内链]]、[[https://forum.pvz1.com|外链]]，格式为<nowiki>[[链接|显示文本]]</nowiki> 
 +     * <wrap em>不要</wrap>只粘贴网址！
  
-点击工具栏中的这个图标{{:wiki:pasted:20221208-125822.png?50}}可以插入预先设定好的快捷文本。+  * 无序列表、有序列表、分隔线、表情:-o、emoji😈
  
-快捷文本包含【优秀条目】、【人物仍活跃】、【条目争议】、【事实待核查】等等。+  * 文字<fc #ff0000>颜色</fc>、<fs large>大</fs><fs small>小</fs>
  
-使用例：+  * 图片（上传或粘贴均可）[{{:wiki:logo.png|1437大帝}}] 
 +<code> 
 +有配字：[{{:wiki:logo.png|1437大帝}}] 
 +无配字：{{:wiki:logo.png}} 
 +</code> 
 +   * 使用空格改变图片的对齐方式[{{  :wiki:logo.png|右对齐的1437大帝}}] 
 +<code> 
 +[{{  :wiki:logo.png|右对齐的1437大帝}}] 
 +左边空两格，就是靠右对齐 
 +</code> 
 +   * 编辑栏右下角可以调整编辑栏长度，并设置是否自动换行 
 +[{{:wiki:配图:编辑栏工具.png?direct&150|分别为：加长、缩短、切换换行方式}}] 
 +====常用的非工具栏功能==== 
 +  * 换行需要<wrap em>两个</wrap>回车，单个回车会被无视 
 +    * ''%%\\ %%''<wrap lo>注意有一个空格</wrap>可以强制回车，<wrap em>切勿滥用！</wrap>一般只用在表格里
  
 +  * 在双层英文括号<nowiki>(())</nowiki>里插入脚注((就像这样))
 +
 +  * 开头缩进两个空格的段落为引用段
 +
 +  在引用段内部，**维基语法无效**
 +====其它常用功能====
 +
 +[{{  :wiki:配图:wrap工具.40.51.png?nolink&400|工具栏内的“纸盒”工具}}]
 +
 +  * 使用<button type="info">纸盒工具</button>设置<wrap em>警告</wrap>、<wrap hi>高亮</wrap>、<wrap lo>黑幕</wrap>等样式：
 +
 +<WRAP clear/>
 +[{{  :wiki:配图:20221210-125221.png?nolink&400|工具栏内的“快捷文本”工具}}]
 +
 +  * 使用<button type="info">快捷文本</button>可在**页顶**插入提示：
 +
 +
 +<WRAP clear/>
 +效果如下：
  
-~~SNIPPET_O1670536043~~snippet:优秀条目~~ 
-{{tag>[优秀条目]}} 
 <WRAP center round tip 70%> <WRAP center round tip 70%>
 经OP鉴定，本词条内容清晰，排版优美，是值得参考的优秀范例。 经OP鉴定，本词条内容清晰，排版优美，是值得参考的优秀范例。
 </WRAP> </WRAP>
-~~SNIPPET_C~~snippet:优秀条目~~ 
  
 +<callout type="warning" title="自建提示" icon="true">
 +对于页顶提示，请优先使用快捷文本里预设的提示，不要自建提示。
  
 +如果想在正文部分里插入提示，请使用Bootstrap组件（见[[wiki:使用指南#bootstrap组件|下文]]）里的<button type="info">引起注意</button>，也就是本提示框的效果。
 +</callout>
 +=====3/5 表格=====
  
-====插入图片====+使用简单的语法便可创建表格。
  
-图片可以上传后插入，也可以直接粘贴。+^        ^ 第1列     ^ 第2列      ^ 第3列     ^ 
 +^ 第1行   | (1,1)    | (1,2)     | (1,3)    | 
 +^ 第2行   | 跨行合并  |  跨列合并   || 
 +^ 第3行   | :::      | (3,2)     | (3,3)    |
  
-> 请尽可能使用jpg格式，优化页面加载速度。+对应源码： 
 +<code> 
 +^        ^ 第1列     ^ 第2列      ^ 第3列     ^ 
 +^ 第1行   | (1,1)    | (1,2)     | (1,3)    | 
 +^ 第2行   | 跨行合并  |  跨列合并   || 
 +^ 第3行   | :::      | (3,2)     | (3,3)    | 
 +</code>
  
-维基语法允许缩放图片，就像这样： +用三个英文冒号（'':::''）跨行合并，用双竖线（''||''）跨列合并。
-  {{:build:3c8p.jpg?200|}} +
-   +
-{{:build:3c8p.jpg?200|}}+
  
-'':build:3c8p.jpg''为图片位置，''200''为缩放后宽度((单位：px))。+表格的每一行都由''^''或''|''打头，各单元格之间也由它们隔开。它们的唯一区别是''^''后的单元格会**加粗**。
  
-但<wrap lo>由于一些诡异的原因</wrap>缩放后清晰度不佳，因此更加推荐上传已经缩放后的图片，以原比例显示。+空格数量决定了单元格的对齐方式。只需在文本的反方向加至少两个空格：若要左对齐，在右边添加至少两个空格；反之，在左边添加；在两边均添加至少两个空格则为居对齐。
  
-----+^           有对齐的表格                   ^^^ 
 +|        右对齐|     居中     |左对齐        | 
 +|左对齐        |        右对齐|     居中     | 
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
  
-如果你想为图片配小字说明，只需在外面加一层方括号，如下： +<code> 
-  [{{:build:3c8p.jpg?200|我是说明}}]+^           有对齐的表格                   ^^^ 
 +|        右对齐|     居中     |左对齐        | 
 +|左对齐        |        右对齐|     居中     | 
 +| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | 
 +</code>
  
-[{{:build:3c8p.jpg?200|我是说明}}]+<callout type="info" title="指定表格列宽" icon="true"> 
 +默认情况下，表格会自动调整列宽。
  
-====命名空间====+若要指定某些列的宽度，在表格第一行前加入以下语法：
  
-<wrap em>所有</wrap>页面都存放在不同的[[doku>zh:namespaces|命名空间]]（类似文件夹）下。+''%%|<100% 列宽1 列宽2 列宽3 ...>|%%''
  
-> 例如，[[人物:3C妹妹|人物:3C妹妹]]👈<wrap lo>是英文冒号！</wrap>是存放于【人物】命名空间下的词条+''100%''代表表格占页面宽度100%。列宽单位通常取''em''，1''em''大致等于1个汉字宽度。无需指定宽度的列可用''-''略去。末尾的''-''可省略。
  
-命名空间一览：+例如：''%%|<100% - 4em>|%%''的含义为指定**第二列**为''4em''宽，其余列视情况自动调整。 
 +</callout>
  
-^ 命名空间  ^ 包含                        ^ 备注                                                                                ^ +<callout type="info" title="可排序表格" icon="true"> 
-| 人物      | 单一人物词条                |                                                                                     | +要将表格中部分或全部列设为**可排序**，只需将''<sortable 3phase>''和''</sortable>''标签套在表格外。
-| 阵型      | 阵型（含手控、开局等）词条  |                                                                                     | +
-| 事件      | 历史事件词条                |                                                                                     | +
-| 攻略      | 教学向、攻略向词条          |                                                                                     | +
-| 社群      | 社区、群聊、多人物词条      |                                                                                     | +
-| 重定向    | 重定向词条                  |                                                                                     | +
-| 消歧义    | 消歧义词条                  |                                                                                     | +
-| wiki      | 使用文档                    | 仅OP可修改((如果某页面引发争议，被反复恶意修改，请将其移至wiki空间予以只读保护。))  | +
-| talk      | 留言板                      | 仅OP可修改                                                                          | +
-| snippet      | 供用户使用的快捷文本                      | <del>仅OP可修改 </del>                                                                         |+
  
-> 要更改命名空间：点击右侧工具栏--->【页面重命名】，修改前缀即可+使用例：
  
-搜索词条时，应**带着命名空间前缀搜索**，这样创建出来的词条自动带有命名空间。+''%%<sortable 3phase sumrow=2 1=numeric 2=alpha 3=nosort> 
 +... 
 +</sortable>%%'' 
 + 
 +其中，''sumrow=2''代表最后2行不参与排序，''1=numeric 2=alpha 3=nosort''分别指定了第1列、第2列、第3列的排序方式（按数字排序、按字母排序、不允许排序）。 
 + 
 +</callout> 
 +=====4/5 Wrap标签===== 
 + 
 +将Wrap标签（''%%<WRAP>%%''((块级元素，默认另起一行))或''%%<wrap>%%''((内联元素，和其它内容显示在同一行))）套在某段内容外，可以设置其排版格式。 
 + 
 +==== 基本语法 ==== 
 + 
 +<code> 
 +<WRAP 属性1 属性2 属性3 ...> 任何你需要排版的内容 </WRAP> 
 +</code> 
 +<code> 
 +<wrap 属性1 属性2 属性3 ...> 任何你需要排版的内容 </wrap> 
 +</code> 
 + 
 +==== 常用功能 ==== 
 + 
 + 
 +<accordion> 
 +<panel title="限制宽度"> 
 + 
 +直接指定宽度（如''200px''或''70%''），可与其它属性一起使用（见下）。 
 + 
 +</panel> 
 +<panel title="分栏排版"> 
 +<WRAP col2 colmedium> 
 +我是第一个分栏~~ 
 + 
 +我是第二个分栏~~ 
 +</WRAP> 
 +<code> 
 +<WRAP col2 colmedium> 
 +我是第一个分栏~~ 
 + 
 +我是第二个分栏~~ 
 +</WRAP> 
 +</code> 
 + 
 +让内容分栏显示很容易！只需添加''colX''（X为理想列数，一般取2~4）与''colmedium''这两个属性即可。 
 + 
 +''colmedium''的作用是优化移动设备的显示效果（屏幕过窄时，合并为同一栏）。 
 + 
 +如果内容确定（基本不会增加/减少），也可以用以下格式： 
 +<code> 
 +<WRAP group> 
 +<WRAP half column> 
 +我是第一个分栏~~ 
 +</WRAP> 
 + 
 +<WRAP half column> 
 +我是第二个分栏~~ 
 +</WRAP> 
 +</WRAP> 
 +</code> 
 + 
 +half即50%，还有third((3分之1))、twothirds((3分之2))、quarter((25%))可选。每个''%%<WRAP group>%%''的总和必须是100%<wrap lo>发挥数学功底的时候到了</wrap> 
 + 
 +优点是能精确控制每一列的内容<wrap lo>缺点是格式繁琐且不适合经常改动的内容</wrap> 
 + 
 +可以嵌套多个''%%<WRAP group>%%''以达成复杂的排版效果，如[[:home|本站首页]]。 
 +</panel> 
 + 
 +<panel title="对齐方式"> 
 +<WRAP left box 70%> 
 +一个普通的居左方框←_← 
 +</WRAP> 
 +<WRAP clear/> 
 + 
 +<code> 
 +<WRAP left box 70%> 
 +一个普通的居左方框←_← 
 +</WRAP> 
 +</code> 
 + 
 +其中''left''为居左浮动。类似地，''right''为居右浮动。注意：浮动元素会与后续内容并列排布，如下： 
 + 
 +<WRAP left box 70%> 
 +一个普通的居左方框←_← 
 +</WRAP> 
 + 
 +下一段文字仍显示在同一行 
 + 
 +<WRAP clear/> 
 + 
 +若想另起一行，请使用''%%<WRAP clear/>%%''清除浮动。 
 + 
 +和''left''、''right''不同，''center''没有浮动效果，只是居中。 
 + 
 +此外，可以用''leftalign''、''rightalign''、''centeralign''或''justify''（两端对齐）控制内部文字的对齐方式。 
 + 
 +</panel> 
 +<panel title="更多标签"> 
 +这些是由<ff 'Georgia', serif>PVZ Wiki</ff>自定义的标签，用于在特定情况下达成需要的排版效果。如果你希望添加更多自定义样式，请在[[https://forum.pvz1.com/wiki/|讨论版]]留言。 
 +  * ''%%<wrap smallimg>%%''：让内部图片（无配字）在移动屏幕上显示为50%宽 
 +  * ''%%<WRAP centerimgbox>%%''：让内部一张或多张图片（有配字）居中显示 
 +     * 慎用。一般仅用于多张图片。单张图片的话，请先考虑居左/居右的环绕显示（配合''%%<WRAP clear/>%%''） 
 + 
 + 
 +</panel> 
 + 
 +</accordion>
  
-====重定向====+=====5/5 Bootstrap组件=====
  
-要将词条A重定向至词条B，只需将词条A的内容编辑为：+Boostrap组件在工具栏里显示为“B”：
  
-  ~~REDIRECT>:XXX~~ +[{{:wiki:配图:截屏2022-12-10_20.40.40.png?nolink&400|编辑工具栏里的Bootstrap组件}}]
-  ~~DISCUSSION:off~~+
  
-其中XXX为词条B的标题。+==== 常用功能 ====
  
-> 为整理方便，请将重定向词条((上面的词条A))放入【重定向】命名空间下。+<accordion> 
 +<panel title="手风琴"> 
 +就是你现在看到的这个可折叠文本框组。 
 +</panel> 
 +<panel title="按钮、徽章与小标签"> 
 +主要用于排版。<button type="info">按钮</button><badge>徽章</badge><label type="warning">小标签</label> 
 +</panel>
  
-====模板====+<panel title="折叠文本"> 
 +<btn type="primary" collapse="foo">【RE无神】屋顶C2的可能性？</btn> 
 +  
 +<collapse id="foo" collapsed="true"><well> 
 +前排说明：此阵其实不可无尽，冰瓜是拦不住红眼的。视频只有1F，而且开了巨人不丢小鬼。众所周知，神节奏C2成就了NE无神的出世，两仪无炮的传奇。然而，NE无神能运作C2，因为没有冰车；两仪无炮能运作C2，因为核弹丢在水里。如果有了冰车，C2还能打出来吗？答案是：可以！</well></collapse> 
 +</panel>
  
-为了简化创建词条的过程，每个命名空间都有对应的模板。+<panel title="引起注意"> 
 +<callout type="warning" title="引用源" icon="true"> 
 +在这里插入链接…… 
 +</callout> 
 +</panel>
  
-名为''template''的词条就是模板，可以像其它词条一样正常编辑。+<panel title="提示"> 
 +<popover trigger="hover" title="我是标题" content="我是内容"> 
 +<btn type="success">悬停时显示</btn> 
 +</popover> 
 +<popover title="我是标题" content="我是内容"> 
 +<btn type="danger">再次点击按钮时关闭</btn> 
 +</popover> 
 +<popover placement="bottom" content="我是内容" trigger="focus"> 
 +<btn>向下看齐</btn> 
 +</popover> 
 +</panel> 
 +<panel title="图片轮播"> 
 +<carousel interval="1000"> 
 +<slide>{{:wiki:logo.png?nolink|}}</slide> 
 +<slide>{{:wiki:logo.png?nolink|}}</slide> 
 +<slide>{{:wiki:logo.png?nolink|}}</slide> 
 +</carousel> 
 +</panel> 
 +<panel title="标签页"> 
 +可用在信息框中。 
 +<tabs> 
 +  * [[#tab-foo|QQ头像]] 
 +  * [[#tab-bar|贴吧头像]] 
 +  
 +<pane id="tab-foo"> 
 +{{read-only:logo:sunflower.png?nolink}} 
 +</pane> 
 +  
 +<pane id="tab-bar"> 
 +{{read-only:logo:peashoot.png?nolink}} 
 +</pane> 
 +  
 +</tabs> 
 +</panel> 
 +<panel title="信息框"> 
 +创建新页面时，会自带一个信息框。 
 +''%%<thumbnail>%%''标签为信息框专用，请根据模板提供的格式填入信息，不要随意修改。 
 +</panel> 
 +</accordion>
  
-编辑模板前，请阅读[[doku>zh:namespace_templates|模板文档]]。 +> 这里仅说明了最常用的功能。所有Bootstrap组件都有详细说明与使用范例，可以点进工具自行查看。 
-====恶意编辑====+=====下一步……=====
  
-维基的宗旨就在于开放，但这就意味着所有维基都不得不面对极少数人的恶意行为。+恭喜！你已经掌握了编辑Wiki所需的语法知识。
  
-页面内容需要我们共同维护。所有页面的所有修改历史都会保存——如果你是普通用户，不必担心自己辛辛苦苦写的被删除。看到恶意编辑行为，使用右侧工具栏的【历史版本】功能进行回退即可。+正式开始之前，还请阅读<ff 'Georgia', serif>PVZ Wiki</ff>的[[wiki:编辑规范|编辑规范]]。这将会事半功倍，省去很多麻烦和不愉快。
  
-此外，OP（管理员）也会对恶意编辑者的IP地址处以<wrap em>永久封禁处罚</wrap>。+=====了解更多=====
  
-====与OP交流！====+本小节列出了一些对于编辑词条不必要，但还是有必要知道一下的<ff 'Georgia',serif>PVZ Wiki</ff>小贴士。
  
-如果你想向OP提出建议或反馈问题，请[[talk:给op留言|给OP留言]]。+   * 上传头像：在<badge>user</badge>命名空间下上传以自己用户名为文件名的图片 
 +     * 如用户名为username，则在<badge>user</badge>命名空间下上传''username.jpg/png'' 
 +   * 点击右侧工具栏<button type="info">订阅本页更改</button>，可以订阅当前页面或当前命名空间的更改（以邮件形式发送） 
 +   * 提交编辑时，可勾选“细微修改”，以示此次改动内容不多，例如错别字更正、格式改动、文本顺序调整等
  • 最后更改: 17月前
  • 由 OTZzzz 修改