置顶公告:【置顶】关于临时开启评论区所有功能的公告(2022.10.22) | 【置顶】关于本站Widget恢复使用的公告
  • 你好~!欢迎来到萌娘百科镜像站!如需查看或编辑,请联系本站管理员注册账号。
  • 本镜像站和其他萌娘百科的镜像站无关,请注意分别。

帮助:使用VSCode协助编辑条目/预置代码

来自萌娘百科
跳到导航 跳到搜索
Commons-emblem-notice.svg
这个页面“Help:使用VSCode协助编辑条目/预置代码”是萌娘百科的帮助文档
  • 本文用于介绍萌娘百科中一些特定功能的操作方法;
  • 本文仅是一篇论述,不属于方针或指引。如果本指南与相关方针或指引发生冲突或存在不一致的情况,请以方针或指引的条文为准。

预置代码是将较长的代码用助记符简化以便于编写的工具。在支持智能感知的代码编辑器内,输入预定义的助记符后按下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会自带一个预置代码示例,格式如下

{
    "Print to console": {           //预置代码的名称,可以包含中文
        "prefix": "log",            //助记符,不能包含中文
        "body": [                   //语句体
            "console.log('$1');",
            "$2"
        ],
        "description": "Log output to console"    //帮助信息,可以包含中文
    }
}

助记符

当在编辑器输入助记符时,会在智能感知中显示此预置代码,不区分大小写,可以设置多个。 建议在助记符前面添加特殊符号(如@)以免影响到正常代码的编写。

语句体与参数

语句体是一个数组,每一个元素代表一行代码。默认实例中共有两行代码。

在语句体中,$[数字]代表参数,在补全后光标会自动停在参数处供填写。当连续按下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}}


代码
{
    {
    "图片": {
        "prefix": ["@image", "@img"],
        "body": [
            "{{image|图片=${1:萌百娘.png}|描述=${2:萌百娘}|文本高=${3:25}|宽=${4:424}|高=${5:600}|种类=${6|无,tall,wide,outer,div|}|link=${7:萌百娘}}}",
            "$0"
        ],
        "description": "插入图片"
    },

    "图片裁切": {
        "prefix": ["@imageClip", "@imgCp"],
        "body": [
            "{{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}}}",
            "$0"
        ],
        "description": "插入裁切后的图片"
    },
}

常用编辑模板

这些常用模板是在网页版编辑界面中是可以快速插入的,但如果用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>
代码
{
    "空模板":{
        "prefix": ["@template", "@tmp"],
        "body": [
            "{{$1|$2}}$0"
        ],
        "description": "用来插入有一个参数的模板"
    },

    "黑幕": {
        "prefix": ["@heimu", "@hm"],
        "body": [
            "{{黑幕|${1:输入被掩盖的内容}}}$0"
        ],
        "description": "将文本用黑条覆盖,使用鼠标移动可反白显示"
    },

    "胡话": {
        "prefix": ["@huhua","@jk"],
        "body": [
            "{{胡话|${1:输入被划掉的内容}}}$0"
        ],
        "description": "添加删除线并减淡字体"
    },


    "日语汉字": {
        "prefix": ["@lj"],
        "body": [
            "{{lj|${1:输入要转换的内容}}}$0"
        ],
        "description": "强制将汉字显示为日语字形"
    },

    "语言转换":{
        "prefix": ["@lang"],
        "body": [
            "{{lang|${1|zh,yue,en,ja,ko,ru|}|${2:输入要转换的内容}}}$0"
        ],
        "description": "标示语言类型,如果选项没有请手动修改"
    },

    "注音": {
        "prefix": ["@ruby"],
        "body": [
            "{{ruby|${1:输入文本}|${2:输入读音}|${3|zh,yue,en,ja,ko,ru|}|${4|zh,yue,en,ja,ko,ru|}}}$0"
        ],
        "description": "标注拼音,如果选项没有请手动修改"
    },

    "下划线":{
        "prefix": ["@underLine","@u"],
        "body": [
            "<u>${1:输入需要标注下划线的内容}</u>$0"
        ],
    },

    "删除线":{
        "prefix": ["@deleteLine","@del"],
        "body": [
            "<del>${1:输入需要标注删除线的内容}</del>$0"
        ],
    },

    "居中":{
        "prefix": ["@center"],
        "body": [
            "<center>",
            "${1:输入需要居中的内容}",
            "</center>$0"
        ],
    },

    "歌词":{
        "prefix": ["@poem"],
        "body": [
            "<poem>",
            "${0:输入歌词}",
            "</poem>"
        ],
        "description": "此处的内容只需要换行一次"
    },

    "红字":{
        "prefix": ["@red","@colorRed"],
        "body": [
            "{{color|red|${1:输入需要标红的内容}}}$0"
        ],
    },

    "名言":{
        "prefix": ["@cquote"],
        "body": [
            "{{Cquote|${1:输入引用的内容}|${2:输入作者}}}$0"
        ],
        "description": "以特殊的样式显示名言警句"
    },

    "折叠":{
        "prefix": ["@hide"],
        "body": [
            "{{Hide|${1:输入标题}|${2:输入被隐藏的内容}}}$0"
        ],
        "description": "将内容折叠起来"
    },

    "脚注":{
        "prefix": ["@ref"],
        "body": [
            "<ref>${1:在此处输入脚注内容}</ref>$0"
        ],
        "description": "在页面下方显示脚注"
    }
}