This is a documentation for Board Game Arena: play board games online !

Wiki formatting

来自Board Game Arena
DogEgg258（讨论 | 贡献）2024年7月15日 (一) 05:12的版本
跳到导航 跳到搜索

目的

本页面的英文版是根据Wiki style guide 论坛帖子整合。中文版本则是完全按当前英文版进行翻译，模板（Template）需要单独创建中文页面，因此具体内容可能和英文部分有微细出入或未完全同步。

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

不同语言的Wiki模板需要单独创建，英文Wiki上的Wiki模板在中文Wiki上需要单独创建页面，同理，你可以创建英文Wiki上没有的模板，但考虑到中文Wiki的维护人数等，建议在英文Wiki上创建后同步到中文Wiki上方便管理和修bug。

Help:Formatting

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

语言

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

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

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

关联报告

列表项

Help:Lists

已知问题

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

关联报告

解决方法

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

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

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

标题

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

已知问题

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

关联报告

解决方法

  • 使用 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}}}

    链结

    Help:Links

    已知问题

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

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

    关联报告

    解决方法

    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

    已知问题

    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. 边距 和 内边距在 BoardGameArena.com中被移除。
    2. 无左 边界.

    解决方法

    1. 通过 HTML + CSS替代。

    Wiki模板

    不同语言的Wiki模板需要单独创建，英文已有的模板若中文中没有，可以进行搬运。

    Help:Templates

    模板:InfoBox

    折叠文本，可以将一些网页内容折叠到框中，点击才能打开查看，避免在页面上显示过多的信息。

    例子
    内容文本，这里面同样可以使用其他格式。
    如果你希望在一行上显示多个InfoBox，你需要InfoBoxes和InfoBoxes3。
    模板:InfoBoxes

    页面仅用于定义模板，文档请参阅模板:InfoBox。

    模板:InfoBoxes3

    页面仅用于定义模板，文档请参阅模板:InfoBox。

    模板:GameIcon

    通用图标模板，已有图标参阅英文Wiki。

    运用例子

    取自“http:///index.php?title=Wiki_formatting&oldid=527”