MCBBS Wiki欢迎您共同参与编辑!在参与编辑之前请先阅读Wiki方针

如果在编辑的过程中遇到了什么问题,可以去讨论板提问。

为了您能够无阻碍地参与编辑 未验证/绑定过邮箱的用户,请尽快绑定/验证

MCBBS Wiki GitHub群组已上线!

您可以在回声洞中发表吐槽!

服务器状态监控。点击进入

本站由MCBBS用户自行搭建,与MCBBS及东银河系漫游指南(北京)科技有限公司没有从属关系。点此了解 MCBBS Wiki 不是什么>>

帮助:Wiki编辑入门手册:修订间差异

来自MCBBS Wiki
跳到导航 跳到搜索
→‎另见:​ // Edit via Wikiplus
 
(未显示6个用户的20个中间版本)
第1行: 第1行:
{{帮助文档难度/简单}}
'''欢迎加入MCBBS Wiki!'''本条目将为您介绍如何使用维基文本编辑条目,以及MCBBS Wiki的编辑规范。
{{浮动帮助菜单}}
'''欢迎加入MCBBS Wiki!'''本条目将为您介绍如何编辑条目,以及MCBBS Wiki的编辑规范。


== 使用维基文本编辑器 ==
== 使用编辑器 ==
当您创建或编辑页面时,您将会看到维基文本编辑器,这个编辑器能帮助您解决大部分的常用维基语法。话虽如此我们依然需要学习维基语法,因为这个编辑器是用'''纯文本'''编辑的,这意味着只有您学会了维基语法才能看懂别人写的维基文本
当您创建或编辑页面时,您可以在页面的编辑按钮处看到“编辑”和“编辑源代码”两选项,前者是打开[[MCBBS_Wiki:可视化编辑器|可视化编辑器]]后者是打开维基文本编辑器。但请注意,部分页面不能使可视化编辑

我们建议初学者先使用可视化编辑器进行编辑,等到有一定的维基文本基础后再使用维基文本编辑器。

下文介绍了如何使用维基文本。


== 基础文本格式 ==
== 基础文本格式 ==
第16行: 第22行:
</pre>
</pre>
显示:
显示:
<div class="pre-like">

这里只有
这里只有
一个回车
一个回车


到这里有两个
到这里有两个
</div>

需要注意的是,刚才特意提到了“拆分段落”,意思是说两个回车可以实现真正意义上的创建新段落,并且与上一个段落保持一定的垂直距离。之所以刻意提到这一点,是因为我们还有另一种换行方式——使用换行标签。
需要注意的是,刚才特意提到了“拆分段落”,意思是说两个回车可以实现真正意义上的创建新段落,并且与上一个段落保持一定的垂直距离。之所以刻意提到这一点,是因为我们还有另一种换行方式——使用换行标签。
<pre>
<pre>
第31行: 第37行:


显示:
显示:
<div class="pre-like">

这里使用了<br>换行标签
这里使用了<br>换行标签


这里使用了<br>
这里使用了<br>
换行标签
换行标签
</div>

两种用法效果相同,同时也能看出换行标签和两个回车换段的区别。另外,如果您连续打了多个回车,最终都只会被解析为一次换段,需要多次换行只能使用br换行标签
两种用法效果相同,同时也能看出换行标签和两个回车换段的区别。


=== 粗体、斜体、下划线和删除线 ===
=== 粗体、斜体、下划线和删除线 ===
第50行: 第56行:
<u>有下划线的内容</u>
<u>有下划线的内容</u>


<s>有删除线的内容</s>
<del>有删除线的内容</del>
</pre>
</pre>
显示:
显示:
<div class="pre-like">

'''粗体显示的内容'''
'''粗体显示的内容'''


第60行: 第66行:
<u>有下划线的内容</u>
<u>有下划线的内容</u>


<s>有删除线的内容</s>
<del>有删除线的内容</del>
</div>

注意:'是英文的单引号,使用中文模式是无效的。
注意:'是英文的单引号,使用中文模式是无效的。


<pre><u></u><s></s></pre>后一个标签的斜杠/不能省略。
<pre><u></u><del></del></pre>后一个标签的斜杠/不能省略。


在MCBBS Wiki中,粗体常常用于介绍对象的条目中的开篇简介,例如:
在MCBBS Wiki中,粗体常常用于介绍对象的条目中的开篇简介,例如:
第89行: 第95行:


显示效果:
显示效果:
<div class="pre-like">

{{Color|green|这是绿色}}
{{Color|green|这是绿色}}


第95行: 第101行:


{{Background color|#FFF|背景是白色的}}
{{Background color|#FFF|背景是白色的}}
</div>

'''注意:这不一定是所有Wiki通用的语法!可能有大部分的Wiki约定俗成地使用这种语法,但您需要知道这种语法是由每个Wiki自定义的。'''
'''注意:这不一定是所有Wiki通用的语法!可能有大部分的Wiki约定俗成地使用这种语法,但您需要知道这种语法是由每个Wiki自定义的。'''


第106行: 第112行:
===== 五级标题 =====
===== 五级标题 =====
</pre>
</pre>
显示效果:
<div class="pre-like">
<span style="font-size:1.5em;margin-top:1em;border-bottom:1px solid #CFB78E;display:block;width:100%">二级标题</span>
<span style="font-size:1.2em;margin-top:1em;font-weight: bold;display:block;width:100%">三级标题</span>
<span style="font-size:1em;margin-top:1em;font-weight: bold;display:block;width:100%">四级标题</span>
<span style="font-size:1em;margin-top:1em;font-weight: bold;display:block;width:100%">五级标题</span>
</div>
正确使用标题,页面可以自动生成目录,让页面更有条理。

您可以通过[[MCBBS Wiki:社区公用沙盒|社区公用沙盒]]来测试您的代码。代码中的空格并不强求,这只是为了更好看。

此外,还有一级标题(<code><nowiki>= 一级标题 =</nowiki></code>),但因为MediaWiki的页面设计原因(一级标题指代页面总标题),请不要使用一级标题。


== 内链与外链 ==
为了本页面的排版效果,此处不再演示。您可以通过[[MCBBS Wiki:社区公用沙盒|社区公用沙盒]]来测试您的代码。代码中的空格并不强求,这只是为了更好看。
这部分请见[[帮助:Wiki编辑进阶手册]]的链接部分。


== 模板的使用 ==
== 模板的使用 ==
第171行: 第190行:


== 结语 ==
== 结语 ==
以上就是本入门教程的全部内容了。再次感谢您愿意参与MCBBS Wiki的编辑,期待您的表现!
以上就是本入门教程的全部内容了。再次感谢您愿意参与MCBBS Wiki的编辑,期待您的表现!高级教程请见[[帮助:Wiki编辑进阶手册|这里]]。


== 另见 ==
== 另见 ==
* [[帮助:索引]]
* [[帮助:索引]]
* [[帮助:Wiki编辑进阶手册]]
* [[帮助:插入媒体]]
* [[MCBBS Wiki:索引]]
* [[MCBBS Wiki:索引]]
* [[帮助:条目规范模板]]


[[分类:Wiki编辑手册]]
[[分类:编辑帮助]]

2023年2月9日 (四) 13:18的最新版本

这篇帮助文档的难度为:简单
这篇帮助文档非常友好,适合新手阅读如果这样的帮助文档还是无法理解那我们也没办法了呢...

欢迎加入MCBBS Wiki!本条目将为您介绍如何编辑条目,以及MCBBS Wiki的编辑规范。

使用编辑器

当您创建或编辑页面时,您可以在页面的编辑按钮处看到“编辑”和“编辑源代码”两个选项,前者是打开可视化编辑器,后者是打开维基文本编辑器。但是请注意,部分页面不能使用可视化编辑器。

我们建议初学者先使用可视化编辑器进行编辑,等到有一定的维基文本基础后再使用维基文本编辑器。

下文介绍了如何使用维基文本。

基础文本格式

维基文本依赖于HTML语言,如果您学习过HTML语言,那么再学习维基语法会轻松很多。

换行

这一点需要特别强调,这和我们平常的语言习惯不同,维基语法需要用两个回车来拆分段落(也就是一个空行),因为wiki不识别单独的回车,例如:

这里只有
一个回车

到这里有两个

显示:

这里只有 一个回车

到这里有两个

需要注意的是,刚才特意提到了“拆分段落”,意思是说两个回车可以实现真正意义上的创建新段落,并且与上一个段落保持一定的垂直距离。之所以刻意提到这一点,是因为我们还有另一种换行方式——使用换行标签。

这里使用了<br>换行标签

这里使用了<br>
换行标签

显示:

这里使用了
换行标签

这里使用了
换行标签

两种用法效果相同,同时也能看出换行标签和两个回车换段的区别。

粗体、斜体、下划线和删除线

四种基本的文本样式。

语法:

'''粗体显示的内容'''

''斜体显示的内容''

<u>有下划线的内容</u>

<del>有删除线的内容</del>

显示:

粗体显示的内容

斜体显示的内容

有下划线的内容

有删除线的内容

注意:'是英文的单引号,使用中文模式是无效的。

<u></u><del></del>

后一个标签的斜杠/不能省略。

在MCBBS Wiki中,粗体常常用于介绍对象的条目中的开篇简介,例如:

混乱是MCBBS现任管理员中的一员。

也经常用于需要强调的内容。

前景色和背景色

维基语法中并没有用于定义颜色的语法,但是MCBBS Wiki中有相关的模板可以使用。

{{Color|green|这是绿色}}

{{Color|rgb(255,0,0)|这是红色}}

{{Background color|#FFF|背景是白色的}}

这两种模板的语法均为:

{{模板名|颜色代码|文本内容}}

颜色代码可以是HTML颜色名、16进制颜色码、RGB函数和RGBA函数。

显示效果:

这是绿色

这是红色

背景是白色的

注意:这不一定是所有Wiki通用的语法!可能有大部分的Wiki约定俗成地使用这种语法,但您需要知道这种语法是由每个Wiki自定义的。

标题(章节)

您应该早就注意到了本文的章节划分。维基语法可以使用多种级别的标题,其格式为:

== 二级标题 ==
=== 三级标题 ===
==== 四级标题 ====
===== 五级标题 =====

显示效果:

二级标题 三级标题 四级标题 五级标题

正确使用标题,页面可以自动生成目录,让页面更有条理。

您可以通过社区公用沙盒来测试您的代码。代码中的空格并不强求,这只是为了更好看。

此外,还有一级标题(= 一级标题 =),但因为MediaWiki的页面设计原因(一级标题指代页面总标题),请不要使用一级标题。

内链与外链

这部分请见帮助:Wiki编辑进阶手册的链接部分。

模板的使用

模板顾名思义就是可以反复套用的一种格式。当模板被创建后,就可以在全站任何地方使用它的格式。之前我们用到的Color就是一种模板。

模板的基本语法有以下几种—— 无参数:

{{模板名}}

单个参数:

{{模板名|参数}}

多个参数:

{{模板名|参数1|参数2|参数3|...|参数N}}

如果需要了解模板的使用方法,可以访问 模板:模板名 页面,例如:模板:Color,模板页面一般会有使用帮助。

事实上,模板的使用并不一定需要使用“模板”(Template)前缀的页面,不过一般用不上这种特殊使用方法,此处不对新人作详细解释。

条目分类

一个规范的内容条目必须要有分类,而分类代码必须放置在页面底部,以便于编辑者修改。

分类的语法为:

[[分类:分类名]]

使用效果请见页面底部。

把分类写成Category也是可以的。

代码注释

注释可以帮助编辑者更好地了解代码,注释里的内容不会被阅读模式所看见,只有在编辑模式下才能看见。注释也可以用于删去暂时用不上的代码或暂时不想展示的内容。

注释的语法和HTML一样:

<!--注释的内容-->


您可以通过点击本章节的编辑按钮查看这里注释的内容。

创建条目

学完了以上内容后,您已经可以创建一个规范的条目了。在创建条目之前,请多多阅读其他规范的条目和相关指引。

在MCBBS Wiki,您有两种方式创建新条目:

  1. 在搜索框中搜索您需要创建的条目名称,如果没有搜索到您想要的条目,则点击创建。
  2. 直接在地址栏输入访问页面,如果页面不存在,则点击创建。

其他Wiki常识

  • 蓝色的链接意味着页面存在,红色的链接意味着页面不存在。一定要避免太多的红色链接。
  • “讨论”标签页可以访问有关于该页面的编辑者讨论。如果页面不存在,则会创建讨论页面。
  • “查看历史”标签页可以查看该页面的历史版本、编辑者的编辑注释,还可以对比两个不同的版本。
  • “移动”操作顾名思义可以移动页面,如果原页面与新页面存在一定的关联,可以保留重定向,使访问原页面的用户可以跳转到新页面,也可以不保留重定向。

结语

以上就是本入门教程的全部内容了。再次感谢您愿意参与MCBBS Wiki的编辑,期待您的表现!高级教程请见这里

另见