维基语法逐步教程

评分: 0+x

友情提示:注意到您从未发表过作品,因此请在阅读此指南前认真阅读如何撰写一篇SCP文档

序言:本页面面向谁?

本页面面向需要在创作过程中需要使用维基语法,但苦于没有相关知识的作者。

本页面致力于作为一个“一站式指导”或者“说明书”,保证代码新人只要阅读这一个页面,便可以应付维基语法的大多数使用情况。以这一目标作为指导,本页面主要专注于一步步教学“如何使用维基代码”,可能不会对某些概念进行深入的阐释。但在这些需要了解的概念出现时,本页面尽量会给出有关的链接可供读者访问。同时,本文会在各板块尽可能全面地附上可能会用到的常用资源。

本页面的特色内容是逐步教程,拥有逐步教程的章节会在开头用红字标出。同时,本页面可能过长,在此,笔者不推荐读者从头通读到尾并记忆所有内容,而是利用目录(也就是本页面右侧的“目录”按钮)跳转至你需要帮助的部分。

祝你阅读本说明书愉快。

初窥门径:基础维基语法

本章会带你学会最基础和(一般来说)最实用的维基语法,它们多半已经在维基语法中列出。但该页面并没有给出更详细的使用方式,所以如果你对它们仍然感到陌生,请往下看。

行内格式

行内格式指的是文本段落内部字体的格式。看到上一句话的“行内格式”四个字了吗?那就是行内格式中最经典的一种,加粗(也就是让文字变得更粗)。

让我们看看最常用的几种行内格式:

你所打的文字 你将看见的文字
//斜体// 斜体
**粗体** 粗体
//**粗斜体**// 粗斜体
__底线__ 底线
--删除线-- 删除线
普通^^上标^^ 普通上标
普通,,下标,, 普通下标
[!-- 不可见内容 --]
[[span style="color:red"]]自定义//span//元素[[/span]] 自定义span元素
##blue|预设## 或 ##44FF88|自定义色码## 颜色 预设自定义色码 颜色
[[span class="ruby"]]拼音或其他文字标示[[span class="rt"]]Pīnyīn huò qítā wénzì biāoshì[[/span]][[/span]] 拼音或其他文字标示Pīnyīn huò qítā wénzì biāoshì
[[span class="keycap"]]Ctrl[[/span]] + [[span class="keycap"]]C[[/span]] Ctrl + C

看看这段话:千早爱音拥有丰川祥子的逃兵、若叶睦的传话、三角初华三角初音的吉他主唱、八幡海铃买爆祐天寺若麦的蹭子,只要你一声令下,我们就推举你为真正的AnonMujica圣爱音!

**//千早爱音//**拥有**丰川祥子**的逃兵、__若叶睦__的传话、[[span class="ruby"]]三角初华[[span class="rt"]]三角初音[[/span]][[/span]]的吉他主唱、^^八幡海铃^^的,,买爆,,、##purple|祐天寺若麦##的蹭子,//只要你一声令下//,我们就推举你为真正的--AnonMujica--圣爱音!

版式


什么是版式?

首先,让我们从页面的整体外观开始吧。

版式就像页面的个性化皮肤,当你发现某些页面和主页的显示风格不一样,这就意味着那个页面用了一个版式.话是这么说,不过在严格意义上,主页也使用了Sigma-9版式,即默认版式。

版式大部分情况下可以有效改善页面观感,因此,版式的适当运用有助文章受到更多好评。但需要指出的是,一篇好文章并不总是需要一个独特的版式。

使用版式

首先,要选择一个适合文章的版式。这里给出了所有含版式tag的页面,但本页面更推荐你在theme-rec-hub更直观地寻找你喜欢的版式。

大部分版式都会提供方便引用的[[include]]模块。以本文使用的平行 版式为例,它的引用代码是:

[[include :scp-wiki-cn:theme:parallel]]

为什么这个代码可以引用一个版式呢?

首先,[[include]]是组件引用代码的核心,它声明了组件引用的存在。其次,注意到:scp-wiki-cn:,这代表组件引用自的url.XXXX.com/后面的部分即为url。。其中,theme:代表这是一个版式,而component:代表这是一个组件.组件部分将在后文提及。

最后是以xxxx=xxx为模板的自定义内容,等号前面是可自定义的项目,后面是自定义的参数。如果你把这一行删掉,那么这个项目就会显示其默认的样子。如果将引用代码改为:

[[include :scp-wiki-cn:theme:parallel bedrock=*]]

那么代表选项bedrock将被启用,平行版式将以基岩形态出击,页面版头.即版式的头部,顶栏及以上部分。将变为蓝色。

有些版式是基于其他版式的改进型(如SCP 办公室主题版式,在黑色标记笔版式上修改而来),因此,这些版式会出现两个[[include]],第一个代表主版式,第二个代表修改后的版式,两者缺一不可。

简单CSS应用:修改元素、强制缩进与:root自定义


除非特别注明,本页内容采用以下授权方式: Creative Commons Attribution 3.0 License