編輯的有用資訊
目錄 |
[編輯] 概述
這個 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
模板。實際內容是由其模板生成的。
這種用於子頁面的模板使用可能很棘手,而且太複雜,無法在此處解釋。如果您無法從當前的用例中弄清楚,請尋求幫助——請參閱上面的“更多幫助”部分。