(作者:Ghtr123)
你好啊,无名的小鬼,欢迎来到代码教程!=)
在这里,你可以发现一些对你编写文档有帮助的代码。如果你运用的好,你可以通过它们使你的文章观感更好!=)
在极为常用的代码处,我们会用红色标题高亮;
在很不常用而仅仅只是略微介绍的代码处,我们会用蓝色标题说明;
在一些不十分常用的进阶代码处,我们会用紫色标题说明;
在正常的标题处,我们会用青色标题显示。
你可以在你的个人沙盒测试你学到的代码哦!=)
这就是本文的目录:
前言
你应知道的事
本站的载体为Fandom。Fandom Wiki一般使用的是Wikitext,一种简化后的HTML。 JavaScript脚本也能够在这里运行,但较为特殊,在此不多做介绍。
属性盒的认识
<div>/<span>/<font>
是Wikitext的基础属性盒。它们大体上作用一致,皆起着为盒内文本添加一定属性标签的作用,但个体上还有些许不同。
通过这两个示例,我们可以很容易发现<div>
与<span>
的区别:<div>
会给其中的内容自动换行,而<span>
不会。这是由于,div的主要作用对象为包括文本及其所在的整行背景在内的整体,而span的主要作用对象仅为文本。font标签的作用基本与span相同,也不会使文本间自动换行,故不再举例展示。
选择了合适的属性盒,接下来便需要向属性盒中填充属性标签。
属性标签有很多种,会分别在后面介绍;但你要知道的是,属性标签中的多个内容需要用“;
”(英文分号)隔开。
属性标签:class
属性标签class
主要用于显示在社区CSS或JS中导入的内容,例如下面的例子。
属性标签:title
属性标签title
可以设置鼠标悬停在文字上时显示的文字,效果可以见下。
属性标签:style
属性标签style
是在文章创作中经常被使用的一个属性标签,可以修改文字的颜色、位置、大小、鼠标悬停样式等。有关属性标签style
可用的内容,我们会在下方详细讲解。
color (文本颜色设定)
你可以通过color
来设定文本的颜色,具体方法见下:
代码示例 1-5
我们可以看到,通过color:颜色英文
就可以设定文本的颜色。实际上,除了输入颜色的英文,还可以通过十六进制颜色码(可使用十六进制的rgb或十进制的rgba)来设定自定义的颜色。下面就是两个例子。
附注
使用时要注意透明度正常情况下是1,用小数来表示透明。诶?试试用鼠标刮一下右边?特别浅的文字也可以用鼠标刮开!
代码示例 1-7
font-size (文本大小设定)
font-size
可以修改文字的大小,一般情况下没什么用,基本可以用<big>
代替。
还是大号文本还是小号文本
代码示例 1-8
cursor (鼠标样式设定)
cursor
可以修改当鼠标指针悬浮于文字上时,鼠标指针所显示的样式。
以下例子直接使用了Backrooms Wiki中使用的代码:
附注
部分鼠标指针在一些系统中可能显示为一种或显示为默认指针。若要使用,建议选取通用性更高的指针。
help pointer
progress wait
cell crosshair
text vertical-text
alias copy
move no-drop
not-allowed grab
grabbing all-scroll
col-resize row-resize
n-resize(可将n替换为e/s/w/ne/nw/se/sw/ew/ns/nesw/nwse,不再展示)
zoom-in zoom-out
代码示例 1-9
display (文本元素属性)
display
属性用于设定文本的显示方式,共有inline
、block
与none
三种可用样式。
inline
属性不会自动空出一行,而block
属性会;而none
属性不会显示,只可以在源代码中找到。
虽然<div style="display:inline">这段文本在div里面,但是不会自动空出</div>一行<br>
而<span style="display:none">这段文本不会显示</span>
虽然
而
代码示例 2-10
更多基本Wikitext
Wikitext中除了<div>/<span>/<font>
外,还有许多方便的标签。这一章会介绍一些较为常用的Wikitext代码。
添加标题
在Wikitext中,你可以通过在一行中放置多个等号来创建一个标题,或是通过<h1>
等属性盒创建一个标题;标题将会显示在目录中。
== 二级标题 ==
=== 三级标题 ===
==== 四级标题 ====
===== 五级标题 =====
====== 六级标题 =====
附注
由于标题会使文章目录被打乱,因此在此不作实际效果演示。
代码示例 2-1
文本加粗与斜体
Wikitext中加入了一种便捷的方法来给文本加粗与加斜体,可以见下面示例。
链接
链接包括站内链接与站外链接,而这两种链接Wikitext都支持通过方括号“[]
”链接。
站内链接
站内链接较为简单,只需要把需要链接到的页面的实际页面名放在两对中括号“[[]]
”中间就行。
实际页面名:如果这个页面的网址是“https://darkrooms.fandom.com/zh/wiki/代码教程”,那么它的实际页面名就是“代码教程”。文章最上面的页面名可以被修改,因此不一定是实际页面名。
如果你想要更详细一点,需要链接到页面中某个标题的部分,你可以在后面加一个井号“#
”并附上标题名称,这样链接就能详细到标题了。
如果你想要显示的文字与那个页面的实际页面名不同,你可以通过一个分隔符“|
”隔开页面名,并在右边写上你想要的显示的文字,具体可见下面的例子。
代码示例 2-3
站外链接
如果你要把链接链接在站外,你就需要先复制页面网址,再输入一个空格,最后输入显示的文字就行。
特殊的,如果你要链接到后室Wiki(Backrooms Wiki)的页面,本Wiki提供了专门的模板,可以通过类似站内链接的方法链接至后室Wiki的页面,具体可以见下面示例。
附注
你可以通过这个方法快捷链接至后室Wiki的页面:{{FromBackrooms|实际页面名|显示的文字}}
不过这里的实际页面名中间如果有空格,一定要替换成下划线!
代码示例 2-4
添加分类
类似于站内链接,如果你需要给一个页面添加分类,你可以通过在两对方括号中间插入一个分类名来给页面添加分类;其中的分类名应以“Category:
”开头,以表示一个分类。如果你需要链接至一个分类,你可以通过在整体页面名的最前面添加一个英文冒号“:”来链接至分类页面,例如[[:Category:红票]]
。
导入媒体
导入文件的方法与站内链接类似,如我需要在文章中插入一张莲花的图片,我可以像下面这么使用:
用同样的方法我也可以导入音频等,方法都是一致的。
图片大小与位置设置
我们如果直接插入一张图片:
这样就显得太大了,怎么缩小它呢?
我们可以通过一些参数来设定图片的大小与位置:[[File:Example.jpg|right|thumb|这是一张莲花的图片]]

这是一张莲花的图片
效果就是这样(见右):
我们也可以让图片居左,例如下面:

这是一张居左的莲花的图片
这样就可以让图片居左了。另外,thumb是缩略图的意思。
占位符
占位符
占位符
图片可放大化设置(2023/01/08 更新)
你还可以使用如下的代码来进行 图片可放大化设置(把鼠标移动到图片上,图片会放大):
<div class="right-image">
[[File:图片.png]]
【这里写文字描述】
</div>
注意①:使用图片可放大化设置时,
[[File:图片.png]]
中请最好不要使用缩略图(这会让图片看起来很怪、很小,但你可以使用图片大小设置),也就是不要添加thumb标签。
注意②:使用图片可放大化设置时,不要在[[File:图片.png]]
中添加对图片的描述,这没有用,不会显示。你需要用文字描述替换上面格式里的文字,这样才有效果。
右边是一个例子,把鼠标移动到图片上,你会发现图片放大了:
这个例子的代码:
<div class="right-image">
[[File:Ghost Fun.14天空.jpg]]
'''Ghost Fun.14'''中被派对客控制的天空,显现出派对客的形状
</div>
注意③:虽然这种图片嵌入方法能让你的文高级感骤增,但是它只适用于一些比较大的图片,如果你的图片比较小,使用这种嵌入方法只会适得其反。
注意④:这种图片嵌入方法所添加的图片会自动放置于页面右侧,如果需要置于页面左侧,可以将class
中的“right-image
”改为“left-image
”;左下方就是这种效果的演示。
占位符
占位符
占位符
你可以在这个暗层中欣赏一下这种图片嵌入效果:Ghost Fun.14
占位符
占位符
占位符
占位符
占位符
引用模板
通俗地说,模板就是一个以 Template:
开头的界面,同时它可以被其它界面引用;你可以通过在两对花括号“{{}}
”中间输入模板名称来引用模板。通过插入模板,你可以减少在文中输入代码的量,同时节省文章编辑时的篇幅。你可以在下面的示例中看见模板的基本引用方法,同时如果你想要编写模板,你可以在这里看到相关方法。
文本折叠
在MediaWiki中其实本来已经内置了一个文本折叠的功能,但为了简化复杂的代码,本Wiki(与其它许多Wiki)制作了{{Collapse}}
模板,旨在简化文本的折叠。你可以在下面的示例中看到{{Collapse}}
模板的使用方式:
附注
其中的num为指示,一般使用只需要知道每次给num填写不同的内容就行,内容任意。
内容文本
代码示例 2-7
标签页
标签页允许在你编写文档时制作一个可以在多个内容间切换的标签,具体可以见下方示例。
表格
表格可以通过一对“{| |}
”来表示,其中第一行需要先声明class
(表格样式);表格样式有多种,其中较为常用的就是wikitable
样式。在声明表格样式后,可以通过“|+
”来添加一段表格总标题;表格总标题将会居中显示在整个表格的上方。在这之后,你可以通过“|-
”来进行表格内换行。添加总标题后,你可以使用“!
”开头,“!!
”作分割,给表格添加一段标题文字。在之后,你可以利用“|
”开头,“||
”作分割,添加普通表格文本。具体的表格制作方法也可以参见下面的例子。
{| class="wikitable"
|+ 表格总标题
|-
! 标题文本 !! 标题文本 !! 标题文本
|-
| 示例 || 示例 || 示例
|-
| 示例 || 示例 || 示例
|-
| 示例 || 示例 || 示例
|}
标题文本 | 标题文本 | 标题文本 |
---|---|---|
示例 | 示例 | 示例 |
示例 | 示例 | 示例 |
示例 | 示例 | 示例 |
代码示例 2-9
嵌入CSS
你可以通过在页面中直接嵌入CSS模板来嵌入CSS,格式为{{CSS|实际页面名}}
。更多有关页面CSS的内容可以参照CSS使用指导与CSS代码教程进行进一步学习。
目录栏
你可以用TOC加入目录,NOTOC删除目录。