使用說明:使用VS Code協助編輯條目/預置代碼

萌娘百科,萬物皆可萌的百科全書!轉載請標註來源頁面的網頁連結,並聲明引自萌娘百科。內容不可商用。
貢獻者:
Commons-emblem-notice.svg
這個頁面「Help:使用VS Code協助編輯條目/預置代碼」是萌娘百科的幫助文檔
  • 本文用於介紹萌娘百科中一些特定功能的操作方法;
  • 本文僅是一篇論述,不屬於方針或指引。如果本指南與相關方針或指引發生衝突或存在不一致的情況,請以方針或指引的條文為準。

預置代碼是將較長的代碼用助記符簡化以便於編寫的工具。在支持智能感知的代碼編輯器內,輸入預定義的助記符後按下Tab ↹↵ Enter即可展開為長代碼,節省編輯的時間。

本幫助將會敘述Wikitext自帶的預置代碼,以及如何自己定義預置代碼。

Wikitext預置代碼

標題類

此處的預置代碼包含6個級別的標題

@pageTitle

= title =

@title

== title ==

@subT1

=== title ===

@subT2

==== title ====

@subT3

===== title =====

@subT4

====== title ======

表格類

此處的預置代碼可以生成表格。

@table

{| class="wikitable"
|+Title
!
!
!
!
|-
|
|
|
|
|-
|
|
|
|
|-
|
|
|
|
|}

生成帶表頭和默認樣式的4x4空白表格,具體用法可參照幫助:表格

管理類

@redirect

#REDIRECT [[Pagename]]

為本頁面創建重新導向,使用前請務必閱讀幫助:重新導向頁面

注釋類

此處的預置代碼會生成定義好的注釋。

@comments

<!--comments-->

生成帶有comments的注釋串,用來標記評論。由於萌百有評論系統,一般不使用這個代碼。

@todo

<!--TODO:Task-->

生成帶有TODO的注釋串,用來描述此處的任務方便後續用戶編輯。

VSCode標記類

此處的預置代碼在萌百上沒有任何作用,但在VSCode中將會作為標記以實現特殊功能。

@region

<!--#region chapter-->

<!--#endregion-->

被標記的代碼可以在VSCode中摺疊。

不兼容的功能

@codeBlock

<syntaxhighlight lang="c#" line="1" start="1">

</syntaxhighlight>

將會生成代碼塊,但格式與萌百不兼容。

如果需要在萌百使用代碼塊,可以使用<pre>標籤,如下:

<pre>
print("hello world");
</pre>

顯示效果為:

print("hello world");

關於如何讓代碼塊高亮,參見幫助:代碼高亮工具

@pageInfo

<%-- [PAGE_INFO]
Comment=##
PageTitle=##
PageID=##
RevisionID=##
ContentModel=##
ContentFormat=##
[END_PAGE_INFO] --%>

萌百會自動生成頁面信息,無需手動添加,即使添加了也會當作純文本處理。

添加自定義預置代碼

概述

從菜單欄依次打開「文件」->「首選項」->「用戶片段」,此時會提示選擇語言,選擇「Wikitext」,即可彈出「Wikitext.json」

該json會自帶一個預置代碼示例,格式如下

  1. {
  2. "Print to console": { //預置代碼的名稱,可以包含中文
  3. "prefix": "log", //助記符,不能包含中文
  4. "body": [ //語句體
  5. "console.log('$1');",
  6. "$2"
  7. ],
  8. "description": "Log output to console" //幫助信息,可以包含中文
  9. }
  10. }

助記符

當在編輯器輸入助記符時,會在智能感知中顯示此預置代碼,不區分大小寫,可以設置多個。 建議在助記符前面添加特殊符號(如@)以免影響到正常代碼的編寫。

語句體與參數

語句體是一個數組,每一個元素代表一行代碼。默認實例中共有兩行代碼。

在語句體中,$[數字]代表參數,在補全後光標會自動停在參數處供填寫。當連續按下Tab ↹時會按數字依次遍歷,如果指定了$0,遍歷將會在$0處結束。參數常見用法如下:

  • $1:空參數。
  • ${1:name}:帶默認值的參數,遍歷時默認值會被選中以將其覆蓋為其他值,可以嵌套。
  • ${1|one,two,three|}:帶枚舉的參數,遍歷時會彈出列表以供選擇。

參數可以重複,重複的參數會被同時填寫。

有關於預置代碼的更多用法,可參見Snippets in Visual Studio Code

自定義預置代碼列表

Nuvola apps important blue.svg
如有需要添加的內容,請自行
自己動手,豐衣足食。勿問為什麼沒有oo?

各位用戶可以參考「Image模板」示例編寫和分享預置代碼,使萌百的編寫更方便。

Image模板

助記符 說明 展開後代碼 備註
@image

@img

image模板
{{image|圖片=萌百娘.png|描述=萌百娘|文本高=25|寬=424|高=600|種類=無|link=萌百娘}}
@imageClip

@imgCp

帶裁切的Image模板
{{image|圖片=萌百娘.png|描述=萌百娘|文本高=25|寬=424|高=600|種類=無|link=萌百娘|左=0|上=0|右=0|下=0}}


展開代碼
  1. {
  2. {
  3. "圖片": {
  4. "prefix": ["@image", "@img"],
  5. "body": [
  6. "{{image|圖片=${1:萌百娘.png}|描述=${2:萌百娘}|文本高=${3:25}|寬=${4:424}|高=${5:600}|種類=${6|無,tall,wide,outer,div|}|link=${7:萌百娘}}}",
  7. "$0"
  8. ],
  9. "description": "插入圖片"
  10. },
  11. "圖片裁切": {
  12. "prefix": ["@imageClip", "@imgCp"],
  13. "body": [
  14. "{{image|圖片=${1:萌百娘.png}|描述=${2:萌百娘}|文本高=${3:25}|寬=${4:424}|高=${5:600}|種類=${6|無,tall,wide,outer,div|}|link=${7:萌百娘}|左=${8:0}|上=${9:0}|右=${10:0}|下=${11:0}}}",
  15. "$0"
  16. ],
  17. "description": "插入裁切後的圖片"
  18. },
  19. }

常用編輯模板

這些常用模板是在網頁版編輯界面中是可以快速插入的,但如果用VSCode的話只能手敲,這裡編寫了一些預置代碼以供使用。

  • 功能列表:
助記符 說明 展開後代碼 備註
@template

@tmp

空模板
{{|}}
用來生成只有一個參數的模板格式
@heimu

@hm

黑幕
{{黑幕|輸入被掩蓋的內容}}
@huhua

@jk

胡話
{{胡話|輸入被劃掉的內容}}
@lj 日語漢字
{{lj|輸入要轉換的內容}}
@lang 語言轉換
{{lang|zh|輸入要轉換的內容}}
內置了常見語言參數,如果沒有請手動指定
@ruby 注音
{{ruby|輸入文本|輸入讀音|zh|zh}}
內置了常見語言參數,如果沒有請手動指定
@underLine

@u

下劃線
<u>輸入需要標註下劃線的內容</u>
@deleteLine

@del

刪除線
<del>輸入需要標註刪除線的內容</del>
@center 居中
<center>
輸入需要居中的內容
</center>
@poem 歌詞
<poem>
輸入歌詞
</poem>
@red

@colorRed

紅字
{{color|red|輸入需要標紅的內容}}
@cquote 名言
{{Cquote|輸入引用的內容|輸入作者}}
@hide 摺疊
{{Hide|輸入標題|輸入被隱藏的內容}}
@ref 腳註
<ref>在此處輸入腳註內容</ref>
展開代碼
  1. {
  2. "空模板":{
  3. "prefix": ["@template", "@tmp"],
  4. "body": [
  5. "{{$1|$2}}$0"
  6. ],
  7. "description": "用來插入有一個參數的模板"
  8. },
  9. "黑幕": {
  10. "prefix": ["@heimu", "@hm"],
  11. "body": [
  12. "{{黑幕|${1:輸入被掩蓋的內容}}}$0"
  13. ],
  14. "description": "將文本用黑條覆蓋,使用滑鼠移動可反白顯示"
  15. },
  16. "胡話": {
  17. "prefix": ["@huhua","@jk"],
  18. "body": [
  19. "{{胡話|${1:輸入被劃掉的內容}}}$0"
  20. ],
  21. "description": "添加刪除線並減淡字體"
  22. },
  23. "日語漢字": {
  24. "prefix": ["@lj"],
  25. "body": [
  26. "{{lj|${1:輸入要轉換的內容}}}$0"
  27. ],
  28. "description": "強制將漢字顯示為日語字形"
  29. },
  30. "語言轉換":{
  31. "prefix": ["@lang"],
  32. "body": [
  33. "{{lang|${1|zh,yue,en,ja,ko,ru|}|${2:輸入要轉換的內容}}}$0"
  34. ],
  35. "description": "標示語言類型,如果選項沒有請手動修改"
  36. },
  37. "注音": {
  38. "prefix": ["@ruby"],
  39. "body": [
  40. "{{ruby|${1:輸入文本}|${2:輸入讀音}|${3|zh,yue,en,ja,ko,ru|}|${4|zh,yue,en,ja,ko,ru|}}}$0"
  41. ],
  42. "description": "標註拼音,如果選項沒有請手動修改"
  43. },
  44. "下劃線":{
  45. "prefix": ["@underLine","@u"],
  46. "body": [
  47. "<u>${1:輸入需要標註下劃線的內容}</u>$0"
  48. ],
  49. },
  50. "刪除線":{
  51. "prefix": ["@deleteLine","@del"],
  52. "body": [
  53. "<del>${1:輸入需要標註刪除線的內容}</del>$0"
  54. ],
  55. },
  56. "居中":{
  57. "prefix": ["@center"],
  58. "body": [
  59. "<center>",
  60. "${1:輸入需要居中的內容}",
  61. "</center>$0"
  62. ],
  63. },
  64. "歌詞":{
  65. "prefix": ["@poem"],
  66. "body": [
  67. "<poem>",
  68. "${0:輸入歌詞}",
  69. "</poem>"
  70. ],
  71. "description": "此處的內容只需要換行一次"
  72. },
  73. "紅字":{
  74. "prefix": ["@red","@colorRed"],
  75. "body": [
  76. "{{color|red|${1:輸入需要標紅的內容}}}$0"
  77. ],
  78. },
  79. "名言":{
  80. "prefix": ["@cquote"],
  81. "body": [
  82. "{{Cquote|${1:輸入引用的內容}|${2:輸入作者}}}$0"
  83. ],
  84. "description": "以特殊的樣式顯示名言警句"
  85. },
  86. "摺疊":{
  87. "prefix": ["@hide"],
  88. "body": [
  89. "{{Hide|${1:輸入標題}|${2:輸入被隱藏的內容}}}$0"
  90. ],
  91. "description": "將內容摺疊起來"
  92. },
  93. "腳註":{
  94. "prefix": ["@ref"],
  95. "body": [
  96. "<ref>${1:在此處輸入腳註內容}</ref>$0"
  97. ],
  98. "description": "在頁面下方顯示腳註"
  99. }
  100. }
此頁面最後編輯於 2023年12月20日 (週三) 23:57。
搜尋萌娘百科 (按"/"快速搜尋)
有新的未讀公告

阅读更多:Help:使用VS_Code協助編輯條目/預置代碼(http://mzh.moegirl.tw/Help%3A%E4%BD%BF%E7%94%A8VS_Code%E5%8D%94%E5%8A%A9%E7%B7%A8%E8%BC%AF%E6%A2%9D%E7%9B%AE%2F%E9%A0%90%E7%BD%AE%E4%BB%A3%E7%A2%BC )
本文引自萌娘百科(http://mzh.moegirl.tw ),文字内容默认使用《知识共享 署名-非商业性使用-相同方式共享 3.0 中国大陆》协议。