版本差异

到此差别页面的链接

--- wiki:使用指南 [2022/12/08 13:00] – OTZzzz
+++ wiki:使用指南 [2024/10/24 08:30] (当前版本) – [常用的非工具栏功能] OTZzzz
@@ 行 1: / 行 1: @@
-~~DISCUSSION~~
+======想写维基吗？请从第一行开始阅读======
-=====使用指南=====
-欢迎来到<ff serif>PVZ Wiki</ff>。
+欢迎来到<ff 'Georgia', serif>PVZ Wiki</ff>！
-关于维基的基础语法，请参阅[[wiki:维基语法]]。
+开始编辑之前，请<wrap em>务必通读本文</wrap>，切勿在不理解维基语法的情况下强行编写词条，于己于人都无益。
-如果你是管理员，请额外阅读[[wiki:op指南|OP指南]]。
+=====1/5 命名空间=====
-====维基功能====
+<wrap em>所有</wrap>页面都存放在不同的[[doku>zh:namespaces|命名空间]]（类似文件夹）下。
-未注册用户可以添加、编辑词条，但无法发布评论。
+> 例如，[[人物:3C妹妹|人物:3C妹妹]]👈<wrap lo>是英文冒号！</wrap>是存放于<badge>人物</badge>命名空间下的词条
-已注册用户的IP地址不会被公开显示，且编辑词条时无需输入验证码。
+可选择的命名空间：<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}}
-大部分功能很直观，其中【纸盒工具】非常有用：
+====常用的工具栏功能====
+<callout type="success" title="开盒即用" icon="true">
+以下功能在工具栏里直接点击即可使用，无需记住语法
+</callout>
+  * **加粗**、//倾斜//、__下划线__、''P6-3I''（等宽字符）、<del>删除线</del>
-{{:pasted:20221206-163416.png?400}}
+  * 各级标题（六个等号为一级标题，五个为二级，依次类推）
-有分栏、标识框、<wrap hi>高亮</wrap>、厚黑（图标为“lo”，<wrap lo>效果是这样</wrap>）等常用功能。
+  * 插入[[:home|内链]]、[[https://forum.pvz1.com|外链]]，格式为<nowiki>[[链接|显示文本]]</nowiki>
+     * <wrap em>不要</wrap>只粘贴网址！
-====快捷文本====
+  * 无序列表、有序列表、分隔线、表情:-o、emoji😈
-点击工具栏中的这个图标{{:wiki:pasted:20221208-125822.png?50}}可以插入预先设定好的快捷文本。
+  * 文字<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>里插入脚注((就像这样))
+  * 开头缩进两个空格的段落为引用段
+  在引用段内部，**维基语法无效**
+  * 用''<code>''插入代码块：<code>我是代码</code>
+  * 书写LaTeX：$a^2+b^2=c^2$
+====其它常用功能====
+[{{  :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_O1670475642~~snippet:优秀条目~~
-{{tag>[优秀条目]}}
 <WRAP center round tip 70%>
 经OP鉴定，本词条内容清晰，排版优美，是值得参考的优秀范例。
 </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 ...>|%%''
+''100%''代表表格占页面宽度100%。列宽单位通常取''em''，1''em''大致等于1个汉字宽度。无需指定宽度的列可用''-''略去。末尾的''-''可省略。
+例如：''%%|<100% - 4em>|%%''的含义为指定**第二列**为''4em''宽，其余列视情况自动调整。
+</callout>
+<callout type="info" title="可排序表格" icon="true">
+要将表格中部分或全部列设为**可排序**，只需将''<sortable 3phase>''和''</sortable>''标签套在表格外。
+使用例：
+''%%<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/>%%''）
-^ 命名空间  ^ 包含                        ^ 备注                                                                                ^
-| 人物      | 单一人物词条                |                                                                                     |
-| 阵型      | 阵型（含手控、开局等）词条  |                                                                                     |
-| 事件      | 历史事件词条                |                                                                                     |
-| 攻略      | 教学向、攻略向词条          |                                                                                     |
-| 社群      | 社区、群聊、多人物词条      |                                                                                     |
-| 重定向    | 重定向词条                  |                                                                                     |
-| 消歧义    | 消歧义词条                  |                                                                                     |
-| wiki      | 使用文档                    | 仅OP可修改((如果某页面引发争议，被反复恶意修改，请将其移至wiki空间予以只读保护。))  |
-| talk      | 留言板                      | 仅OP可修改                                                                          |
-| snippet      | 供用户使用的快捷文本                      | <del>仅OP可修改 </del>                                                                         |
-> 如何使用命名空间：点击右侧工具栏--->【页面重命名】，在前面加上“XXX:”前缀((XXX为对应命名空间))
+</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>，可以订阅当前页面或当前命名空间的更改（以邮件形式发送）
+   * 提交编辑时，可勾选“细微修改”，以示此次改动内容不多，例如错别字更正、格式改动、文本顺序调整等