Wiki formatting

目的

本页面的英文版是根据Wiki style guide 论坛帖子整合。中文版本则是完全按当前英文版进行翻译。（由于内容众多，我将会优先将排版弄好再一个个翻译，工程完成后此括号删除。）

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

请随意添加额外的问题、建议和templates 🙂

Help:Formatting

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

语言

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

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

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

Bugs上报

• Link for editing is misleading

列表项

Help:Lists

已知问题

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

Bug上报

• Bullet points not visible

解决方法

1. Use static markers (•,-,1.).
2. Replace with HTML + CSS.

¹Dynamic markers generate HTML list structure.

²Without dynamic markers, <p>paragraphs</p> are generated which require line breaks before and after the "list" to prevent merging into surrounding paragraphs.

标题

Level 1 (h1) headings are the title of the page e.g. = Wiki formatting =, = Gamehelp[name] =, = Tips_[name] =.

已知问题

1. In-game h2 and h3 headings are visually indistinguishable.
2. In-game h3 headings overlap text from the previous section.
3. h5 headings and below are visually indistinguishable from body text.
4. Inconsistency between in-game and game panel headings.

Bug上报

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

解决方法

Since in-game h3 headings became indistinguishable from h2 headings:

• Change h3 to h4 headings.
• Use additional line breaks before h3 headings.

Wiki vs BoardGameArena.com heading formatting

	Wiki text	Wiki	BGA game panel	BGA in-game
h2	* List item == Example h2 heading == * List item	List item Example h2 heading List item	List item Example h2 heading List item	List item Example h2 heading List item
h3	* List item === Example h3 heading === * List item	List item Example h3 heading List item	List item Example h3 heading List item	List item Example h3 heading List item
h4	* List item ==== Example h4 heading ==== * List item	List item Example h4 heading List item	List item Example h4 heading List item	List item Example h4 heading List item
h5	* List item ===== Example h5 heading ===== * List item	List item Example h5 heading List item	List item Example h5 heading List item	List item Example h5 heading List item

链结

Help:Links

• The Main_Page (root) of this wiki redirects to Help.
• BoardGameArena.com/doc displays the Help index of games.
• Note: each heading has a unique id appended with a number as necessary.

  e.g. #Issues_3 links to Links Issues and #Issues_4 links to Images Issues.

已知问题

1. Links to section headings # do not work outside of the wiki (doc.BoardGameArena.com).
2. URL is resolved to /doc instead of the current page.
3. In-game links navigate the user away from the game.

e.g. [[#Section_heading_link]] ⇨ https://BoardGameArena.com/doc#Section_heading_link ¹.

Bug上报

• ¹Section links don't work

解决方法

1. Remove links that do not function as expected.

图片

Help:Images

已知问题

1. Resized images do not display on BoardGameArena.com.

   e.g. [[File:Marrakech_example.jpg|300px]]) because the resized image does not exist in the referenced directory.

2. Image links do not work on BoardGameArena.com.

   e.g. [[File:Versions.png|link=https://en.doc.boardgamearena.com/images/b/b5/Factum_Rules_Summary_EN_v1.jpg]] because the link resolves to https://boardgamearena.com/dochttps://en.doc.boardgamearena.com/images/b/b5/Factum_Rules_Summary_EN_v1.jpg

解决方法

1. Upload YourImage with the size it will appear.
2. Create a {{gameIcon}} with a scale factor.

   e.g. {{YourIcon|scale=0.5}} to reduce the image dimensions by ½.

3. Replace image links with regular links.

   e.g. [[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

已知问题

1. width: 98%; stretches tables across the screen on BoardGameArena.com.
2. Borders do not display on BoardGameArena.com.

解决方法

1. style="width:auto;" fits column width to the contents.
2. border="2" creates table cell borders.
3. Replace with HTML + CSS grid.

Wiki vs BoardGameArena.com table formatting

	Wiki text	Wiki	BGA
Raw wikitable	{|class="wikitable" |+Caption !0-90 |⭐ |- !91-110 |⭐⭐ |- !111-125 |⭐⭐⭐ |}	Caption 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐	Caption 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐
width:auto; border="2"	{|class="wikitable" style="width:auto;" border="2" |+Caption !0-90 |⭐ |- !91-110 |⭐⭐ |- !111-125 |⭐⭐⭐ |}	Caption 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐	Caption 0-90 ⭐ 91-110 ⭐⭐ 111-125 ⭐⭐⭐

Option grids

Option grids can help visualise multiple interdependent options. Where inflexible wiki text tables fall short, HTML + CSS grid is responsive to screen size e.g. 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

Blockquote

已知问题

1. Margins and padding are removed on BoardGameArena.com.
2. No left border.

解决方法

1. Replace with HTML + CSS.

Wiki模板

Help:Templates

信息框

Customisable container(s) responsive to screen size.

---

自定义图标

模板:InfoBox See Examples

预设图标

Cylinder tokens

Wiki text	Result
{{redCylinder|1}}	模板:RedCylinder
{{orangeCylinder|2}}	模板:OrangeCylinder
{{yellowCylinder|3}}	模板:YellowCylinder
{{greenCylinder|4}}	模板:GreenCylinder
{{blueCylinder|5}}	模板:BlueCylinder
{{purpleCylinder|6}}	模板:PurpleCylinder
{{whiteCylinder|7}}	模板:WhiteCylinder
{{greyCylinder|8}}	模板:GreyCylinder
{{blackCylinder|9}}	模板:BlackCylinder
{{creamCylinder|10}}	模板:CreamCylinder

Meeples

Wiki text	Result
{{meeple|red|1}}	模板:Meeple
{{meeple|orange|2}}	模板:Meeple
{{meeple|yellow|3}}	模板:Meeple
{{meeple|green|4}}	模板:Meeple
{{meeple|blue|5}}	模板:Meeple
{{meeple|purple|6}}	模板:Meeple
{{meeple|white|7}}	模板:Meeple
{{meeple|grey|8}}	模板:Meeple
{{meeple|black|9}}	模板:Meeple

Dice

Wiki text	Result
{{whiteDie|1}}	模板:WhiteDie
{{yellowDie|2}}	模板:YellowDie
{{orangeDie|3}}	模板:OrangeDie
{{blackDie|4}}	模板:BlackDie

---

预设卡牌

Template:Card

Wiki text	Result
{{card|A}}	模板:Card
{{club|K}}	模板:Club
{{spade|Q}}	模板:Spade
{{heart|J}}	模板:Heart
{{diamond|10}}	模板:Diamond
{{cardBack}}	模板:CardBack
{{club|color=green}}	模板:Club

Template:Cardholder

Wiki text	Result
{{cardholder|Alice|cards={{diamond|A}}{{club|A}}{{heart|A}}{{spade|A}} }}	模板:Cardholder

---

Wiki text	Result
{{Beginner}} {{Beginner|0}}	模板:Beginner 模板:Beginner
{{Apprentice}} {{Apprentice|1}}	模板:Apprentice 模板:Apprentice
{{Average}} {{Average|100}}	模板:Average 模板:Average
{{Good}} {{Good|200}}	模板:Good 模板:Good
{{Strong}} {{Strong|300}}	模板:Strong 模板:Strong
{{Expert}} {{Expert|500}}	模板:Expert 模板:Expert
{{Master}} {{Master|700}}	模板:Master 模板:Master

Wiki text	Result
{{player|2}}	模板:Player
{{hand|4}}	模板:Hand

---

预设棋盘

Template:Chessboard

{{Chessboard}} 模板:Chessboard

Template:Goboard9

{{Goboard9}} 模板:Goboard9

Template:Quoridorboard

{{Quoridorboard}} 模板:Quoridorboard