编辑的有用信息
目录 |
[编辑] 概述
这个 Wiki 中的大部分内容都包含在 Wiki 模板中,有些模板很简单,有些则...不那么简单。它们负责大部分格式设置,并帮助将重复的内容集中到一处,因此当需要修改某些内容时,无需多次进行相同的修改。
您可以使用维基百科备忘单中找到的文本格式标记语法(另请参阅:Help:Editing),但也有通常更受欢迎的模板可用,如Help:Templates页面所列。
通常,您可以通过选择一个现有页面并切换到编辑
模式来查看模板和标记是如何使用的,从而了解它们的使用方式。
[编辑] 更多帮助
如果您需要额外的帮助,您可以执行以下操作之一:
- 在Cppreference talk:FAQ讨论页面添加文本提问
- 在 Slack 上加入cpplang,然后加入 cppreference 频道并在那里提问。
[编辑] 文本格式
请参阅格式化的模板帮助。
最常见的等宽字体(teletype
)模板,例如,是 {{tlc|tt| {{tt|文本}}。
[编辑] 链接
对于外部链接,请使用维基百科的语法。
对于内部链接,请参阅链接的模板帮助。
一个常用的自动链接模板是lc,用于已知的标识符。例如,{{lc|std::vector}}
将创建一个指向该页面的链接,并以teletype
字体显示,如下所示:std::vector。
[编辑] 代码
请参阅语法高亮的模板帮助。
{{c|1=代码}}
通常用于行内代码,如果代码不包含“=”,则可以省略“1=”。例如,{{c|true}}
和{{c|false}}
常用于返回值true和false。
[编辑] 陷阱与怪癖
- 在 wiki 模板大括号部分内,wiki 引擎有时会被“
=
”符号搞混;使用{{=}}
来解决此问题。 - 模板
{{!
=}}
不显示“!
=
”,而是显示“|=
”,同样{{!
}}
显示“|
”。请改用!{{
=}}
。
[编辑] 重复内容
有些类/类型拥有一组共同的子页面,因为它们具有相同(或几乎相同)的 API。例如,std::condition_variable和std::condition_variable_any的 API 几乎相同,大多数函数的描述和解释也相同。
为了避免重复相同的文本,并避免在多个地方进行修改,它们为子页面使用了自定义模板。例如,如果您访问condition_variable::notify_one()页面,您会看到一个完整的信息页面,但如果您点击编辑,您只会看到一个include
模板。实际内容是由其模板生成的。
这种用于子页面的模板使用可能很棘手,而且太复杂,无法在此处解释。如果您无法从当前的用例中弄清楚,请寻求帮助——请参阅上面的“更多帮助”部分。