Wiki formatting

目的

本页面的英文版是根据Wiki style guide 论坛帖子整合。中文版本则是完全按当前英文版进行翻译。

大多数wiki (doc.BoardGameArena.com) 的格式在BoardGameArena.com上不会被保留（有些是Bug），但是有一些解决方法。 这个页面是一些非官方的技巧集合，关于如何让wiki页面在游戏中和游戏面板上显示得更好。

请随意添加额外的问题、建议和Wiki模板 🙂

译按：模板有一个Bug，会导致本业所有与模板相关的内容都会无法显示。目前已经上报错误，这些无法显示的内容暂时会先放在本页面中，直到后面看看这个bug是否会被修复（这些内容一般是格式语法、css例子等，目前建议通过英文版查看）。🙂

Help:Formatting

注意：Wiki页面的更改在BoardGameArena.com是每日更新一次 。

语言

Wiki页面的内容显示顺位为：

1. 用户language（如有）
2. 英文（如有）

举例：一位简体中文用户在浏览Carddiceo的游戏简规时会显示英文规则（en.doc.boardgamearena.com/Gamehelpcardiceo），因为中文（zh-cn.doc.boardgamearena.com/Gamehelpcardiceo）页面尚未被创建。 用户可以在已有的规则页面看到“编辑（Edit）”按钮，而尚未创建的页面会是“创建本页面（Create Page）”按钮。

关联报告

• Link for editing is misleading
• 错误地将格式“Template”翻译导致模板无法正常显示

列表项

Help:Lists

已知问题

common.css rules

li {
    list-style: none; /*removes list markers*/
}

li, ul {
    margin: 0; /*removes margin before and after lists*/
    padding: 0; /*removes list indentation*/
}

blockquote, body, code, dd, div, dl, dt, fieldset, form, h1, h2, h3, h4, h5, h6, input, legend, li, ol, p, pre, td, textarea, th, ul {
    margin: 0; /*removes inline and block margins*/
    padding: 0; /*removes list indentation*/
}

标记 (子弹点*、序号#)、 边距和内边距在 BoardGameArena.com中不会被显示。

关联报告

• 未显示子弹点标记

解决方法

1. 使用静态标记 (•,-,1.)。
2. 通过 HTML + CSS 替代。

common.css rules

ul.bulletlist li {
    list-style: disc none inside
}

.wikicontent p {
    margin-bottom: 8px;
    margin-top: 8px
}

Bullet lists

Wiki vs BoardGameArena.com list formatting

	Wiki text	Wiki	BGA
Dynamic marker¹ *	* A * B * C	A B C	A B C
Dynamic¹ + static marker	*- A *- B *- C	- A - B - C	- A - B - C
static marker + line breaks²	- A - B - C	- A - B - C	- A - B - C
HTML + CSS	<ul class="bulletlist" style=" margin:1em 0; padding-inline-start:40px; "> <li>A</li> <li>B</li> <li>C</li> </ul>	A B C	A B C

• <ul>unordered list</ul>
• <li>列表内容</li>

Numbered lists

Wiki vs BoardGameArena.com list formatting

	Wiki text	Wiki	BGA
Dynamic marker¹ #	# A # B # C	A B C	A B C
Dynamic¹ + static marker	# 1. A # 2. B # 3. C	1. A 2. B 3. C	1. A 2. B 3. C
static marker + line breaks²	1. A 2. B 3. C	1. A 2. B 3. C	1. A 2. B 3. C
HTML + CSS	<ol style=" margin:1em 0; padding-inline-start:40px; "> <li style="list-style-type:decimal;">A</li> <li style="list-style-type:decimal;">B</li> <li style="list-style-type:decimal;">C</li> </ol>	A B C	A B C

• <ol>ordered list</ol>
• <li>列表内容</li>

Definition lists

Wiki vs BoardGameArena.com list formatting

	Wiki text	Wiki	BGA
Dynamic marker¹ ; :	;A : A 内容 ;B : B 内容 ;C : C 内容	A A 内容 B B 内容 C C 内容	A A 内容 B B 内容 C C 内容
Dynamic¹ + static marker	;'''A ''': A 内容 ;'''B ''': B 内容 ;'''C ''': C 内容	A A 内容 B B 内容 C C 内容	A A 内容 B B 内容 C C 内容
static marker + line breaks²	'''A ''': A 内容 '''B ''': B 内容 '''C ''': C 内容	A : A 内容 B : B 内容 C : C 内容	A : A 内容 B : B 内容 C : C 内容
HTML + CSS	<dl> <dt><b>A </b></dt> <dd style="margin-inline-start:1.6em;">A 内容</dd> <dt><b>B </b></dt> <dd style="margin-inline-start:1.6em;">B 内容</dd> <dt><b>C </b></dt> <dd style="margin-inline-start:1.6em;">C 内容</dd> </dl>	A A 内容 B B 内容 C C 内容	A A 内容 B B 内容 C C 内容

• <dl>description list</dl>
• <dt>description term</dt>
• <dd>description details</dd>

¹动态标记会生成HTML列表结构.

²不使用动态标记时，<p>paragraphs</p> 会被生成，它需要在前后均有换行符，否则可能会和其他段落合并。

标题

1级标题 (h1) 是页面标题，例如 = Wiki formatting =、 = Gamehelp[name] =、 = Tips_[name] =。

已知问题

1. 游戏中 h2 和 h3 标题在视觉上无法被区分。
2. 游戏中 h3 标题会和前面的文字重叠。
3. h5 标题显示位置不对，且和内文无法区分。
4. 游戏中的标题和游戏面板上不一致。

关联报告

• h2/h3 headings not nested
• Section headings overlapping text

解决方法

• 使用 h4 标题代替 h3。
• 使用 h5/h6 标题时手动粗体。
• 非要使用 h3 标题时手动换行。

Wiki vs BoardGameArena.com heading formatting

	Wiki text	Wiki	BGA game panel	BGA in-game
h2	* 列表内容 == h2 标题示例 == * 列表内容	列表内容 h2 标题示例 列表内容	列表内容 h2 标题示例 列表内容	列表内容 h2 标题示例 列表内容
h3	* 列表内容 === h3 标题示例 === * 列表内容	列表内容 h3 标题示例 列表内容	列表内容 h3 标题示例 列表内容	列表内容 h3 标题示例 列表内容
h4	* 列表内容 ==== h4 标题示例 ==== * 列表内容	列表内容 h4 标题示例 列表内容	列表内容 h4 标题示例 列表内容	列表内容 h4 标题示例 列表内容
h5	* 列表内容 ===== h5 标题示例 ===== * 列表内容	列表内容 h5 标题示例 列表内容	列表内容 h5 标题示例 列表内容	列表内容 h5 标题示例 列表内容

{{{标题1}}}

{{{内容1}}}

{{{标题2}}}

{{{内容2}}}

{{{标题1}}}

{{{内容1}}}

{{{标题2}}}

{{{内容2}}}

链结

Help:Links

• 本Wiki的Main_Page首页 (根) 定向至Help帮助。
• BoardGameArena.com/doc是所有游戏Help帮助的目录。
• 注：每个标题均有一个独立序号用于定向。

  例如#已知问题_3 是链结中的已知问题而 #已知问题_4 是图片的已知问题。

已知问题

1. 定向到标题的链结 # 在Wiki以外的地方无法使用 (doc.BoardGameArena.com).
2. URL会被定向到 /doc 而非当前页面。
3. 游戏中的链结会将玩家带到其他地方。

例如 [[#Section_heading_link]] ⇨ https://BoardGameArena.com/doc#Section_heading_link ¹

关联报告

• ¹Section links don't work

解决方法

1. 移除无效链结。

图片

Help:Images

已知问题

1. 在BoardGameArena.com中图片的尺寸无法通过格式修改

   例如 [[File:Marrakech_example.jpg|300px]]) 因为 resized 这张图片不在引用库中。

2. 图片链结在BoardGameArena.com中无法使用

   例如 [[File:Versions.png|link=https://en.doc.boardgamearena.com/images/b/b5/Factum_Rules_Summary_EN_v1.jpg]] 因为它的连结定向到了 https://boardgamearena.com/dochttps://en.doc.boardgamearena.com/images/b/b5/Factum_Rules_Summary_EN_v1.jpg

解决方法

1. 上传 你的图片 时制作成你需要的尺寸。
2. 创建一个带有 scale factor的{{gameIcon}}.

   例如 {{YourIcon|scale=0.5}} 来将图片尺寸乘以 ½.

3. 使用常规图片连结代替.

   例如 [[File:Versions.png]]

   [https://en.doc.boardgamearena.com/images/b/b5/Factum_Rules_Summary_EN_v1.jpg LinkText]

建议

1. Optionally include rollover text [[File:Marrakech_example.jpg|Example move]]

表格

Help:Tables

已知问题

common.css rules

.wikicontent table {
    border-collapse: collapse;
    margin-left: 5px;
    margin-top: 5px;
    width: 98%;
}
table {
    border-collapse: collapse;
    border-spacing: 0;
}
caption, th {
    text-align: left;
}
address, caption, cite, code, dfn, em, strong, th, var {
    font-style: normal;
    font-weight: 400;
}
.wikicontent table td, .wikicontent table th {
    padding: 5px;
    text-align: center;
}
blockquote, body, code, dd, div, dl, dt, fieldset, form, h1, h2, h3, h4, h5, h6, input, legend, li, ol, p, pre, td, textarea, th, ul {
    margin: 0;
    padding: 0;
}
.wikicontent table td, .wikicontent table th {
    padding: 5px;
    text-align: center;
}

1. width: 98%; 在 BoardGameArena.com中的时候表格会超出页面范围。
2. 在BoardGameArena.com中的时候表格边界不会显示。

解决方法

1. 使用style="width:auto;" 来适配。
2. 使用border="2" 制作页面边界。
3. 通过 HTML + CSS grid 替代。

Wiki和 BoardGameArena.com 表格格式

	Wiki text	Wiki	BGA
原始Wiki表格	{|class="wikitable" |+描述 !0-90 |⭐ |- !91-110 |⭐⭐ |- !111-125 |⭐⭐⭐ |}	描述 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐	描述 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐
使用width:auto; border="2"	{|class="wikitable" style="width:auto;" border="2" |+描述 !0-90 |⭐ |- !91-110 |⭐⭐ |- !111-125 |⭐⭐⭐ |}	描述 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐	描述 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐

选项网格 Option grids

选项网格（Option grids）是一种可视化工具，传统的Wiki文本表格无法灵活适配特殊的情况可以通过HTML + CSS grid 来调整布局，例如 Gamehelppente:

Training mode only

Default

Other

# of players

2

3

4

Free-for-all

Team

All options win

Align exactly 5 stones in a row

Align exactly 4 stones in a row

Overline win

May align more than 5 stones in a row

May align more than 4 stones in a row

Capture win

Make 5 captures

Make 4 captures

Capture three

May capture two or three stones (Keryo Pente)

Self-capture

No effect: a stone may be placed in a capture position

Self-capture: results in self-capture! (Poof Pente)

Forbidden: a stone may not be placed in a capture position

Overtime capture

Break the line: may capture to break a winning line (Boat Pente)

Capture the line: may capture an entire winning line

Mixed capture

Enabled: May capture stones of mixed colour

Disabled: Captures of one colour only

{{{标题1}}}

{{{内容1}}}

{{{标题2}}}

{{{内容2}}}

引用块

已知问题

common.css rules

blockquote, body, code, dd, div, dl, dt, fieldset, form, h1, h2, h3, h4, h5, h6, input, legend, li, ol, p, pre, td, textarea, th, ul {
    margin: 0; /*removes inline and block margins*/
    padding: 0; /*removes list indentation*/
}

1. 边距 和 内边距在 BoardGameArena.com中被移除。
2. 无左 边界.

解决方法

1. 通过 HTML + CSS替代。

HTML + CSS <blockquote> formatting

Wiki text	Wiki	BGA
<blockquote style=" margin:1em 0; margin-inline:40px; padding:8px 32px; border-left:4px solid #eaecf0; "> This is a <blockquote> </blockquote>	This is a <blockquote>	This is a <blockquote>

Wiki模板

Help:Templates

已知问题

1. 所有格式文字中带有Template字眼的格式均因为被错误地翻译成中文而无法生效。
2. 无解决方法，本栏目未有任何生效内容。

关联报告

• 错误地将格式“Template”翻译导致模板无法正常显示