帮助:常用代码

本页面介绍常用的 Wiki 编写代码，更进阶的代码请参阅进阶代码帮助。
本 Wiki 采用 MediaWiki 系统，可以使用 HTML 代码、 Wiki 标记 实现各种功能。
本系列页面用于介绍 Wiki 标记 以及部分常用的 HTML 代码。
如果您拥有相关 HTML 或 Wiki 编辑经验，您可以跳过本系列帮助，并参照常用模板列表进行编辑。
更高级的功能说明可以参阅解析函数功能列表或在扩展帮助文档分类中检索。
如果您第一次接触 HTML 或 Wiki 的编辑，请继续阅读：

概述

您或许使用过记事本、Word 等文本编辑器，但是 MediaWiki 与它们有所不同，后者会从源代码（譬如，本页的源代码）中读取信息，并在服务器进行处理，最终呈现为阅读页面的样子。

• 譬如，要加粗文字，只要将文字放在三个单引号之间 → '''像这样'''。

所以 Wiki 的所有编辑均需要在源代码页面完成。本系列帮助页面即是帮助您了解如何进行源代码的编写。

• 当您操作不够熟练时，您还可以使用编辑框顶部的小工具进行编辑（不过并不推荐使用，不但编辑速度较慢而且无法移动到其它文本编辑器进行编辑）。

由于源代码内容为文本，您可以在喜欢的文本编辑器进行编辑，然后复制到对应页面的编辑区。
我们强烈推荐您在提交代码前先复制到本地并保存，以避免不必要的编辑内容丢失。

在编辑完成后，我们推荐您首先使用“显示预览”按钮查看您的编辑是否如您所期望的那样，以避免不必要的反复修改操作。
请尤其注意比如 <poem></poem> 这类需要配对使用的标签是否已配对好。大部分情况下代码充满屏幕都是因为这类 bug。

• 请不必死记本页面内容，需要的时候就来查吧~
  如果您对编辑技术不太自信，我们推荐您使用沙盒页面进行编辑练习。在这个页面您可以随意进行编辑。
  如果您不知道在其它某个页面中编辑会获得怎样的效果，也可以在沙盒页面进行编辑。
  沙盒（好的，通过这三遍重复，您已经记住这个页面了）

字体与段落

描述	使用方法	效果
保持文字排版格式	在 HTML 代码中，大段的半角空格 会被忽略为一个，换行 会被当做一个普通的空格。 回车两次（↑中间有一个空行）会产生一个新的段落，并不是换行，因而不推荐使用。<br />标签会使文本进入新的一行。 <poem>如果文字较多，可以使用这个标签将文字括起来， 效果是将所有的回车换成 br 标签。如果从别处复制了大段文字，推荐使用这个标签。</poem> <nowiki>标签会将其中的全部 Wiki 标记（比如'''这个'''）以及全部HTML标记（如<br />）保留原样。</nowiki> 在沙盒中尝试	在 HTML 代码中，大段的半角空格 会被忽略为一个，换行 会被当做一个普通的空格。 回车两次（↑中间有一个空行）会产生一个新的段落，并不是换行，因而不推荐使用。 标签会使文本进入新的一行。 如果文字较多，可以使用这个标签将文字括起来， 效果是将所有的回车换成 br 标签。如果从别处复制了大段文字，推荐使用这个标签。 标签会将其中的全部 Wiki 标记（比如'''这个'''）以及全部HTML标记（如<br />）保留原样。
	<br /> 是 HTML 标记，<poem>、<nowiki> 是 Wiki 标记，结束的位置分别用 </poem>、</nowiki> 表示。
编辑注释	<!-- 写在这里面的字不会被显示。 --> 在沙盒中尝试
文字样式	'''粗体'''、''斜体''、'''''粗斜体''''' {{color:red|这样可以设置颜色。}} {{center|这样可以使内容居中。<br />内容可以是文本或表格，其中也可以加上其它标签。}} 在沙盒中尝试	粗体、斜体、粗斜体 这样可以设置颜色。 这样可以使内容居中。 内容可以是文本或表格，其中也可以加上其它标签。
HTML 标签	某些 HTML 标签是 MediaWiki 可以使用的，例如 <code>、<div>、<span>（使用 style="" 添加 CSS）以及全套表格相关代码。更多内容参见 Wikipedia HTML 帮助。 如果您你对 HTML 熟悉，可以尝试使用。不过如果有效果相同的模板，我们推荐您使用对应的模板。如果对模板不清楚的话，可以参见页面下方。 以下是若干示例：
	前面介绍的设置颜色和居中其实是这样实现的：<span style="color: #F00">红色文字</span> <div style="text-align: center">居中文字</div> <s>删除线</s>，<u>下划线</u>，<code>源代码</code>，<blockquote>引用文本（会与上下都空出一部分，并在行首有一个缩进）</blockquote> <big>小槌「变大吧」</big> <big><big>小槌「变得更大吧」</big></big> by<small>少名针妙丸</small> 有时需要<sup>上标</sup>，有时需要<sub>下标</sub> 在沙盒中尝试	前面介绍的设置颜色和居中其实是这样实现的：红色文字 居中文字 删除线，下划线，源代码， 引用文本（会与上下都空出一部分，并在行首有一个缩进） 小槌「变大吧」 小槌「变得更大吧」 by少名针妙丸 有时需要上标，有时需要下标
标题	== 2级标题 == === 3级标题 === ==== 4级标题 ==== <poem> 请不要跳跃标题等级，例如 2 级标题之下直接就是 4 级标题，而没有经过 3 级标题。 1 级标题是当前页面的标题（如本页为 帮助:常用代码），所以请不要使用 1 级标题。 标题最多为 6 级。 使用 <fixed /> 可以使标题在页面滚动时跟随，详细用法参见 [[帮助:固定标题扩展]]。 当页面超过四个标题时会自动创建目录。 </poem> <!-- 使用 __NOTOC__ 可以使目录消失；使用 __TOC__ 可以使目录出现在该位置。 使用 {{TOClimit|limit=2}} 可以限制在目录中的标题最高为几级，且自带 __TOC__ 效果。 --> 在沙盒中尝试	2级标题 3级标题 4级标题 请不要跳跃标题等级，例如 2 级标题之下直接就是 4 级标题，而没有经过 3 级标题。  1 级标题是当前页面的标题（如本页为 帮助:常用代码），所以请不要使用 1 级标题。 标题最多为 6 级。 使用 可以使标题在页面滚动时跟随，详细用法参见 帮助:固定标题扩展。 当页面超过四个标题时会自动创建目录。
链接	<poem> [[东方风神录]] 双方括号可以链接 THBWiki 内页面； [[东方project|什么是东方]] 也可以加上 "|" 更改显示文字； [[帮助:常用代码#概述]] 也可以这样链接到某个标题，但请不要为此设置标题。 如果需要链接到指定位置，可以使用 [[模板:锚点]]：{{锚点|anchor|[[帮助:常用代码#anchor]]}} [https://zh.wikipedia.org] 单方括号以处理完整的 URL； [http://www16.big.or.jp/~zun/ 上海爱丽丝幻乐团] 这样可以更改显示文字。 https://cd.thwiki.cc 单独出现的地址也会被解析为网址。特别是图片 https://static.thbwiki.cc/logo.png 会直接被加载，所以若要写上外部图片链接（而不想真的加载图片），请用单方括号 [https://static.thbwiki.cc/logo.png] 或使用 nowiki 标签。 [[#anchor]] 如果是链接到当前页面的章节，也可以省略页面名。 [[/子页面]] 链接到当前页面的子页面也一样。 </poem> <!--———————————————— #重定向 [[目标页面]] 或 #REDIRECT [[目标页面]] 会使进入该页面后自动跳转到目标页面。 请首先建立目标页面，再设置重定向。 --> 在沙盒中尝试	东方风神录 双方括号可以链接 THBWiki 内页面； 什么是东方 也可以加上 "|" 更改显示文字； 帮助:常用代码#概述 也可以这样链接到某个标题，但请不要为此设置标题。 如果需要链接到指定位置，可以使用 模板:锚点：帮助:常用代码#anchor [1] 单方括号以处理完整的 URL； 上海爱丽丝幻乐团 这样可以更改显示文字。 https://cd.thwiki.cc 单独出现的地址也会被解析为网址。特别是图片 会直接被加载，所以若要写上外部图片链接（而不想真的加载图片），请用单方括号 [2] 或使用 nowiki 标签。 #anchor 如果是链接到当前页面的章节，也可以省略页面名。 /子页面 链接到当前页面的子页面也一样。
列表	*普通列表，显示为鳞弹。 **也可以这样递进。 **#或者在其中加上些数字顺序（#与*的用法相同）。 *或者这样跳回上一级。 *****但是请注意这样跨级会出现多个图标。 * 还可以换其他类型的图标。 *d *后紧接d可以换成圆盘图标，显示为针弹。 *c *后紧接c可以换成圆形图标，显示为点弹。 *s *后紧接s可以换成方形图标，显示为札弹。 *x *后紧接x可以换成十字图标，显示为手里剑弹。 *x*x 不论有没有跨级，全用其他类型的话均会出现多个图标。 *x （回到一级） **x 前面的*不后接字就可以正常递进了。 **c 如果最后一个用了其他类型的话，类型号（比如在这里是c）后必须空一格。 **c这样c会成为内容的一部分，列表只会包含**。 *c*最后是*的话可以没有空格。 *x:*d 全都可以和:混用。 没有星号代表列表结束。 *星号一定要是一行第一个字符*这就不行了。 在沙盒中尝试	普通列表，显示为鳞弹。 也可以这样递进。 或者在其中加上些数字顺序（#与*的用法相同）。 或者这样跳回上一级。 但是请注意这样跨级会出现多个图标。 还可以换其他类型的图标。 *后紧接d可以换成圆盘图标，显示为针弹。 *后紧接c可以换成圆形图标，显示为点弹。 *后紧接s可以换成方形图标，显示为札弹。 *后紧接x可以换成十字图标，显示为手里剑弹。 不论有没有跨级，全用其他类型的话均会出现多个图标。 （回到一级） 前面的*不后接字就可以正常递进了。 如果最后一个用了其他类型的话，类型号（比如在这里是c）后必须空一格。 c这样c会成为内容的一部分，列表只会包含**。 最后是*的话可以没有空格。 全都可以和:混用。 没有星号代表列表结束。 星号一定要是一行第一个字符*这就不行了。
缩进	;这样会使本行加粗 :这样就缩进了 在沙盒中尝试	这样会使本行加粗 这样就缩进了
注音	注音需要用到 ruby 模板。如果对模板不清楚的话，可以参见页面下方。
	<poem> 如汉语拼音注音：{{ruby-zh|洩|xiè}} {{ruby-zh|矢|shǐ}} {{ruby-zh|诹|zōu}} {{ruby-zh|访|fǎng}} {{ruby-zh|子|zǐ}} 也可以在汉字上标注汉字：{{ruby-zh|[[华胥三绝]]|你比两绝多一绝}} 注意如果对多个文字进行统一注音可能会产生排版问题： 错误情况：{{ruby-zh|河城荷取|hè}} 正确情况：河城{{ruby-zh|荷|hè}}取 对于日语，请使用ruby-ja模板：{{ruby-ja|博麗|はくれい}}　{{ruby-ja|霊夢|れいむ}} </poem> <!-- 推荐使用 ruby-zh 而非命名不标准的 ruby-cn（尽管两者都可以用）。 --> 在沙盒中尝试	如汉语拼音注音：洩 (xiè) 矢 (shǐ) 诹 (zōu) 访 (fǎng) 子 (zǐ) 也可以在汉字上标注汉字：华胥三绝 (你比两绝多一绝) 注意如果对多个文字进行统一注音可能会产生排版问题： 错误情况：河城荷取 (hè) 正确情况：河城荷 (hè) 取 对于日语，请使用ruby-ja模板：博麗 (はくれい) 　霊夢 (れいむ)
引用框	↓如果一行开头是空格 这行文字会被框进框里， 会自带<poem>的效果<br />也可以用这个延续。 <pre>使用它是相同的效果，只是里面不能使用'''Wiki标记'''。</pre> 在沙盒中尝试	↓如果一行开头是空格 这行文字会被框进框里， 会自带<poem>的效果 也可以用这个延续。 使用它是相同的效果，只是里面不能使用'''Wiki标记'''。
水平线	单独的一行、四个短横线。 ---- 虽然与标题效果类似，但请不要用这个“模拟”标题。 在沙盒中尝试	单独的一行、四个短横线。 虽然与标题效果类似，但请不要用这个“模拟”标题。

插入图片

描述	使用方法	效果
上传图片	点击侧边栏的【上传文件】可以上传。 在“摘要”中写入的内容会成为页面的一部分。应当填写图片的源地址以及添加 [[分类:角色名]]、[[分类:作品名]]、[[分类:作者名]] 等（如果有的话）。如果是社团 LOGO 或 Bannner 请添加 [[分类:社团LOGO]] 以及社团对应的分类；如果是展会等活动的 LOGO 或 Banner，请添加 [[分类:活动LOGO]] 或 [[分类:活动Banner]]，以及活动对应的分类。如果是展会的摊位图宣传图等，也请添加活动名分类。
插入图片	插入图片就是插入图片文件的地址。<br /> 不希望展示的话，是 [[媒体:茨木华扇（茨歌仙）.jpg]]<br /> 希望直接链接到对应页面的话，是 [[:文件:茨木华扇（茨歌仙）.jpg]]<br /> 希望展示图片的话，直接写 文件:目标文件名 就可以了。在图片上面写的文字会默认在图片上方。 [[文件:茨木华扇（茨歌仙）.jpg|frame|right|link=帮助:常用代码|茨木华扇]] （这里的文字在图片旁边）大多数情况下图片都是浮动的，这时就容易出现这个问题： === 错误显示在图片旁边的下一段标题 === 希望从某段文字起不环绕图片而是在图片下方出现的话，使用这个 {{-}} === 正确显示的下一段标题 === 这里的文字会显示在图片和前面所有东西下方。其他级别的标题如 == 标题 == 也应该这样写。 <!--———————————————— [[文件:文件名.后缀名|可以添加的参数1|参数2|参数3|...|图片标题]] 没有参数的情况下，默认为在原处放置、文字不会环绕图片。 none、center 会使其独占一行，center 还会使图片居中。 left、right 会使文字环绕图片，同时使图片居左/右。 frame、thumb 会使图片有外框并显示标题，thumb 还会使图片变为缩略图。 link= 会为图片添加超链接。 [[文件:Wiki.png|100px]] 会使图片宽度为 100px， [[文件:Wiki.png|x100px]] 会使图片高度为 100px。会根据原图宽高比成比例缩小。 [[文件:Wiki.png|100x100px]] 会使图片最长的一边等比缩放到 100px。 --> 在沙盒中尝试	插入图片就是插入图片文件的地址。 不希望展示的话，是 媒体:茨木华扇（茨歌仙）.jpg 希望直接链接到对应页面的话，是 文件:茨木华扇（茨歌仙）.jpg 希望展示图片的话，直接写 文件:目标文件名 就可以了。在图片上面写的文字会默认在图片上方。 茨木华扇 （这里的文字在图片旁边）大多数情况下图片都是浮动的，这时就容易出现这个问题： 错误显示在图片旁边的下一段标题 希望从某段文字起不环绕图片而是在图片下方出现的话，使用这个 正确显示的下一段标题 这里的文字会显示在图片和前面所有东西下方。其他级别的标题如 == 标题 == 也应该这样写。
	如果希望多个图片按一定方式排列，最常见的办法是使用表格。 更加详细的图片插入示例以及 <gallery> 的用法，请参见 MediaWiki 图片帮助。
画廊	需要并列显示两张或以上的图时，应使用画廊功能。<br /> 画廊 (gallery) 功能的使用方法十分简单，只需要拿上面插入单个图片用的代码，去掉头尾的 "[[" 和 "]]"，一行一张图放在 <gallery></gallery> 内即可。<br /> 最简单的例子： <gallery> 文件:东方红魔乡封面.png 东方地灵殿封面.png 东方辉针城封面.png|20px <!--无效--> 东方绀珠传封面.png|绀珠传封面 东方三月精S3封面.jpg|东方三月精S3|link=东方三月精S3 <!--点击图片时会打开[[东方三月精S3]]--> </gallery> 开头部分的 "文件:" 是可以省略的，要注意 gallery 是不能单独指定某张图的大小的，left/right 均无效，也无需写上 frame/thumb。<br /> 使用此功能可以简单美观地插入大量图片。 在沙盒中尝试	需要并列显示两张或以上的图时，应使用画廊功能。 画廊 (gallery) 功能的使用方法十分简单，只需要拿上面插入单个图片用的代码，去掉头尾的 "[[" 和 "]]"，一行一张图放在 <gallery></gallery> 内即可。 最简单的例子： 20px 绀珠传封面 东方三月精S3 开头部分的 "文件:" 是可以省略的，要注意 gallery 是不能单独指定某张图的大小的，left/right 均无效，也无需写上 frame/thumb。 使用此功能可以简单美观地插入大量图片。
	还可以通过加上各种属性（<gallery 属性名="内容">）来更改画廊的样子，可用的属性如下： caption="标题"，设定整个画廊的标题，会显示在画廊的最上方。 widths="宽度px"，设定所有图片的宽度，默认为 120px，注意是 widths 有 s。 heights="高度px"，设定所有图片的最大高度，注意是 heights 有 s。 perrow=每行数量，设定每行图片数的上限，设为 1 即是纵列，设为 0 则是不限（按窗口宽度调节）。 showfilename=1，写上此属性时便会在图片说明上加上文件名。 另外还有 mode 属性可用于更改画廊的样式（<gallery mode="样式名称">），可用的样式名称如下： traditional，传统样式，默认就是这个样式。 nolines ，无线样式，跟传统样式差不多，只是去掉了边框。 packed，紧凑样式，此样式会让所有图片拥有相同高度和不同的宽度，并会根据版面上可用的空间自动平铺所有图片（即是谷歌搜索图片时那种）。 packed-overlay，紧凑-重叠样式，大致和紧凑样式相同，但是会以半透明方框的形式显示图片说明文字。 packed-hover，紧凑-悬停样式，大致和紧凑-重叠样式相同，但半透明方框只会在悬停图片时才会出现。 packed、packed-overlay 和 packed-hover 格式默认不会置中，如需置中可以用 <center> 标签套住 <gallery> 标签，如：<center><gallery>...</gallery></center>。
	例子： <gallery mode="nolines" caption="nolines 无线样式"> 东方辉针城封面.png|辉针城封面 东方茨歌仙封面.jpg|茨歌仙封面 东方绀珠传封面.png|绀珠传封面 东方醉蝶华连载第一话杂志封面.jpg|醉蝶华封面 萃梦想载入界面.jpg|萃梦想载入界面 </gallery> <gallery mode="packed" caption="packed 紧凑样式"> 东方辉针城封面.png|辉针城封面 东方茨歌仙封面.jpg|茨歌仙封面 东方绀珠传封面.png|绀珠传封面 东方醉蝶华连载第一话杂志封面.jpg|醉蝶华封面 萃梦想载入界面.jpg|萃梦想载入界面 </gallery> <gallery mode="packed-overlay" caption="packed-overlay 紧凑-重叠样式"> 东方辉针城封面.png|辉针城封面 东方茨歌仙封面.jpg|茨歌仙封面 东方绀珠传封面.png|绀珠传封面 东方醉蝶华连载第一话杂志封面.jpg|醉蝶华封面 萃梦想载入界面.jpg|萃梦想载入界面 </gallery> <gallery mode="packed-hover" caption="packed-hover 紧凑-悬停样式"> 东方辉针城封面.png|辉针城封面 东方茨歌仙封面.jpg|茨歌仙封面 东方绀珠传封面.png|绀珠传封面 东方醉蝶华连载第一话杂志封面.jpg|醉蝶华封面 萃梦想载入界面.jpg|萃梦想载入界面 </gallery> 在沙盒中尝试	例子： nolines 无线样式 辉针城封面 茨歌仙封面 绀珠传封面 醉蝶华封面 萃梦想载入界面 packed 紧凑样式 辉针城封面 茨歌仙封面 绀珠传封面 醉蝶华封面 萃梦想载入界面 packed-overlay 紧凑-重叠样式 辉针城封面 茨歌仙封面 绀珠传封面 醉蝶华封面 萃梦想载入界面 packed-hover 紧凑-悬停样式 辉针城封面 茨歌仙封面 绀珠传封面 醉蝶华封面 萃梦想载入界面

更多常用功能

描述	使用方法	效果
创建新页面	直接点击红色的链接，或者在搜索框输入要创建的新页面的名字，或者直接在 thwiki.cc/ 后面输入，就会提示是否创建新页面了。 目前只有以上的方法创建。
模板	<poem> {{}} 表示一个模板。 {{黑幕|如果您不会使用某个模板，推荐您找一个编写完毕的模板并进行内容替换。}} "{{" 右边、第一个 "|" 左边的一段文字是模板的名称。 进入 模板:模板名称 页面（如 [[模板:Navbox]]）可以看到该模板的详细信息。 常用模板请参见 [[帮助:常用模板]]。</poem>	{{}} 表示一个模板。 如果您不会使用某个模板，推荐您找一个编写完毕的模板并进行内容替换。  "{{" 右边、第一个 "|" 左边的一段文字是模板的名称。 进入 模板:模板名称 页面（如 模板:Navbox）可以看到该模板的详细信息。 常用模板请参见 帮助:常用模板。
插入表格	这是表格的开始 {| class="wikitable" |+ 这样添加表格标题 | 一道竖线是一个单元格 || 同一行如果要继续书写，之后的都要两个竖线 | 另一行开头的话就只需要一个 |----- | 这样换行（-有几个都可以） || colspan=2 style="text-align: center" | 这样添加 HTML 属性和 CSS 信息 |- style="text-align: center" <!-- 这样可以加在下面一整行上 --> | style="background: black; color: white" | 行首添加 CSS 方法相同 ! 用叹号代替竖线会获得表头的效果 |} 这样结束表格。 在沙盒中尝试	这是表格的开始 这样添加表格标题 一道竖线是一个单元格 同一行如果要继续书写，之后的都要两个竖线 另一行开头的话就只需要一个 这样换行（-有几个都可以） 这样添加 HTML 属性和 CSS 信息 行首添加 CSS 方法相同 用叹号代替竖线会获得表头的效果 这样结束表格。
	表格中可以嵌套表格，但可能会造成一些 bug。 常用的 CSS 参数还有 width: 50%（宽度为整个页面 50%）、height: 200px（高度限定为 200 像素）等。 可以用 class="sortable" 进行排序，参考 Wikipedia 可排序表格。 也可以使用 HTML 标记 <table>、<tr>、<td>、<th> 创建表格，一般是在模板内使用。 在 {| 后面加属性相当于在 <table> 内加，在 |- 后面加相当于在 <tr> 内加。
添加分类	<poem>[[分类:帮助文档]] 这样就会给页面添加一个分类。 在页面的最下方，注明了本页面所属的分类。 点进去，就可以看到同名分类下的所有页面和文件。 注：沙盒会屏蔽分类，在沙盒里添加分类是无效的。</poem>	这样就会给页面添加一个分类。 在页面的最下方，注明了本页面所属的分类。 点进去，就可以看到同名分类下的所有页面和文件。 注：沙盒会屏蔽分类，在沙盒里添加分类是无效的。
注释	<poem> 用<ref>注释文本需要鼠标放到上面才会显示</ref>进行注释。 相同内容的注释<ref name="说明">可以在任意一处（一般是最前面的）ref 里写下 name=""， 其余的 ref 都直接加上 name="" /</ref>，可以这样<ref name="说明" /> 注释内容还会在 <references /> 处出现。如果页面没有写这个，会默认加在页尾。 </poem> 在沙盒中尝试	用进行注释。 相同内容的注释，可以这样 注释内容还会在 处出现。如果页面没有写这个，会默认加在页尾。
签名没啥用	~~~ 这样显示编辑者的名字。<br /> ~~~~ 这样显示编辑者的名字和编辑时间。<br /> ~~~~~ 这样只显示编辑时间。 在沙盒中尝试	Cio〈识文解意的爱书人〉（留言） 这样显示编辑者的名字。 Cio〈识文解意的爱书人〉（留言） 2016年1月9日 (六) 11:03 (CST) 这样显示编辑者的名字和编辑时间。 2022年2月2日 (三) 16:57 (CST) 这样只显示编辑时间.