Wiki formatting：修订间差异

2024年3月13日 (三) 09:49的版本

目的

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

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

请随意添加额外的问题、建议和Wiki模板 考虑到中文页面使用和维护用户比较少，建议在英文页面添加。🙂

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

Help:Formatting

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

语言

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

用户language（如有）
英文（如有）

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

关联报告

列表项

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.)。
通过 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] =。

已知问题

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

关联报告

解决方法

使用 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 是图片的已知问题。

已知问题

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

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

关联报告

¹Section links don't work

解决方法

移除无效链结。

图片

Help:Images

已知问题

在BoardGameArena.com中图片的尺寸无法通过格式修改
例如 [[File:Marrakech_example.jpg|300px]]) 因为 resized 这张图片不在引用库中。
图片链结在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

解决方法

上传 你的图片 时制作成你需要的尺寸。
创建一个带有 scale factor的{{gameIcon}}.
例如 {{YourIcon|scale=0.5}} 来将图片尺寸乘以 ½.
使用常规图片连结代替.
例如 [[File:Versions.png]]

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

建议

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;
}

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

解决方法

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

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*/
}

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

解决方法

通过 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

已知问题

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

关联报告

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

@@ 第6行： / 第6行： @@
 这个页面是一些非官方的技巧集合，关于如何让wiki页面在游戏中和游戏面板上显示得更好。</span>
-请随意添加额外的问题、建议和'''[[#Wiki模板|Wiki模板]]''' 🙂
+<s>请随意添加额外的问题、建议和'''[[#Wiki模板|Wiki模板]]'''</s> 考虑到中文页面使用和维护用户比较少，建议在英文页面添加。🙂
 ''译按：模板有一个Bug，会导致本业所有与模板相关的内容都会无法显示。目前已经[https://boardgamearena.com/bug?id=117297 上报错误]，这些无法显示的内容暂时会先放在本页面中，直到后面看看这个bug是否会被修复（这些内容一般是格式语法、css例子等，目前建议通过英文版查看）。''🙂

Wiki formatting：修订间差异

2024年3月13日 (三) 09:49的版本

目的

语言

关联报告

列表项

已知问题

关联报告

解决方法

标题

已知问题

关联报告

解决方法

链结

已知问题

关联报告

解决方法

图片

已知问题

解决方法

建议

表格

已知问题

解决方法

选项网格 Option grids

引用块

已知问题

解决方法

Wiki模板

已知问题

关联报告

导航菜单

搜索