帮助:使用VSCode协助编辑条目：修订间差异

来自Limbo Wiki
小无编辑摘要
小无编辑摘要
第7行： 第7行：
== 安装VS Code ==
== 安装VS Code ==
=== 下载 ===
=== 下载 ===
访问<ref>官网下载速度较慢。</ref>，官网会自动检测正在使用的操作系统，只需要点击左侧的下载按钮即可。 如果对系统的检测有误或者需要为其他操作系统安装，可以从下载按钮右侧的下拉列表选择，或者点击右上角的Download查看更多支持的版本。
访问VS Code官方网站（没链接是因为广告过滤器那什么的判定机制）<ref>官网下载速度较慢。</ref>，官网会自动检测正在使用的操作系统，只需要点击左侧的下载按钮即可。 如果对系统的检测有误或者需要为其他操作系统安装，可以从下载按钮右侧的下拉列表选择，或者点击右上角的Download查看更多支持的版本。
 
=== 安装 ===
* Windows：运行安装包后按需选择安装。
* macOS：解压后直接运行。
 
=== 汉化 ===
VS Code默认语言为英语，第一次启动时会在右下角自动提示安装汉化包。
 
如果没有相关提示，可点击左侧'''扩展'''（Extensions）图标，或者按下<code>Ctrl</code>+</code>⇧ Shift</code>+</code>X</code>，搜索“Chinese”，选择“'''Chinese （Simplified） (简体中文) Language Pack for Visual Studio Code'''”并点击“'''安装'''（Install）”。安装完成后会提示重启，重启后即可显示为中文界面。
 
== 安装与配置Wikitext扩展 ==
=== 创建工作区 ===
#创建一个新的文件夹用于保存您的Wikitext文件；
#启动VS Code，点击“文件”→“打开文件夹”并打开刚创建的文件夹；
#如果弹出是否信任此文件夹中的文件的作者?，必须要选择“是，我信任此作者”，否则将无法使用扩展功能。
#点击“文件”→“将工作区另存为”将工作区保存下来；
#下次启动时用VS Code打开工作区文件，或者点击“文件”→“Open Workspace from File…”即可进入工作区。
 
=== 安装扩展 ===
#打开左侧扩展面板，搜索“Wikitext”并安装；
#安装完成后在扩展面板的“已安装”一栏下找到“Wikitext”，点击右下角的小齿轮，先选择“禁用”，然后选择“启用（工作区）”。这一步的目的是将扩展限制在工作区内，以避免编辑其他类型文件时产生潜在的冲突和性能问题；
#在工作区内新建扩展名为“.wikitext”的文件，并输入一段Wikitext进行测试。如果代码能够正常高亮，则表示扩展可用，安装没有问题。
=== 配置扩展并接入林百API ===
如果需要使用到扩展的预览功能，则需要接入林泊百科的API。
 
林百的API地址：<code><nowiki>https://wiki.pigeon-games.com/api.php</nowiki></code>
 
; 以下为Wikitext扩展的配置方法：
# 点击VS Code左下角的齿轮，选择“设置”，打开设置界面；
# 在左侧的目录中找到“扩展”→“Wikitext”或直接在搜索框中输入<code>@ext:rowewilsonfrederiskholme.wikitext</code>；
# 按照下表进行设置：
{| class="wikitable"
!名称
!值
!解释
|-
|Api Path
|/api.php
|林泊百科API地址。
|-
|Article Path
|/index.php?title=$1
|林泊百科页面地址。
|-
|Enable JavaScript
|按需开启
|启用预览时对JS的支持。
|-
|Get CSS
|开启
|启用预览时对CSS的支持。用作页面的样式设计。
|-
|Preview CSS Style
|默认即可
|设置预览时的默认样式表。
|-
|Host
|wiki.pigeon-games.com
|主站地址。
|-
|Password
|[密码]
|用户密码。
|-
|User Name
|[用户名]
|用户名。
|}
设置完成后，可输入一段wikitext，然后点击右上角的预览按钮，或按<code>Ctrl</code>+<code>Shift</code>+<code>V</code>预览，如果配置正确，将会在右边看到条目的显示效果。
 
 
 
 
 
 
== 注释 ==

2022年8月5日 (五) 10:39的版本

妈呀，广告哥竟然是我自己——

Visual Studio Code（以下简称VS Code）是由微软发行的开源代码编辑器，拥有丰富的扩展功能。
搭配使用由Rowe Wilson Frederisk Holme开发的Wikitext扩展并接入林百的API可以方便地实现代码着色、补全与实时预览功能，提高页面的编辑效率。

安装VS Code

下载

访问VS Code官方网站（没链接是因为广告过滤器那什么的判定机制）[1]，官网会自动检测正在使用的操作系统，只需要点击左侧的下载按钮即可。 如果对系统的检测有误或者需要为其他操作系统安装，可以从下载按钮右侧的下拉列表选择，或者点击右上角的Download查看更多支持的版本。

安装

  • Windows：运行安装包后按需选择安装。
  • macOS：解压后直接运行。

汉化

VS Code默认语言为英语，第一次启动时会在右下角自动提示安装汉化包。

如果没有相关提示，可点击左侧扩展（Extensions）图标，或者按下Ctrl+⇧ Shift+X，搜索“Chinese”，选择“Chinese （Simplified） (简体中文) Language Pack for Visual Studio Code”并点击“安装（Install）”。安装完成后会提示重启，重启后即可显示为中文界面。

安装与配置Wikitext扩展

创建工作区

  1. 创建一个新的文件夹用于保存您的Wikitext文件；
  2. 启动VS Code，点击“文件”→“打开文件夹”并打开刚创建的文件夹；
  3. 如果弹出是否信任此文件夹中的文件的作者?，必须要选择“是，我信任此作者”，否则将无法使用扩展功能。
  4. 点击“文件”→“将工作区另存为”将工作区保存下来；
  5. 下次启动时用VS Code打开工作区文件，或者点击“文件”→“Open Workspace from File…”即可进入工作区。

安装扩展

  1. 打开左侧扩展面板，搜索“Wikitext”并安装；
  2. 安装完成后在扩展面板的“已安装”一栏下找到“Wikitext”，点击右下角的小齿轮，先选择“禁用”，然后选择“启用（工作区）”。这一步的目的是将扩展限制在工作区内，以避免编辑其他类型文件时产生潜在的冲突和性能问题；
  3. 在工作区内新建扩展名为“.wikitext”的文件，并输入一段Wikitext进行测试。如果代码能够正常高亮，则表示扩展可用，安装没有问题。

配置扩展并接入林百API

如果需要使用到扩展的预览功能，则需要接入林泊百科的API。

林百的API地址：https://wiki.pigeon-games.com/api.php

以下为Wikitext扩展的配置方法：
  1. 点击VS Code左下角的齿轮，选择“设置”，打开设置界面；
  2. 在左侧的目录中找到“扩展”→“Wikitext”或直接在搜索框中输入@ext:rowewilsonfrederiskholme.wikitext；
  3. 按照下表进行设置：
名称 值 解释
Api Path /api.php 林泊百科API地址。
Article Path /index.php?title=$1 林泊百科页面地址。
Enable JavaScript 按需开启 启用预览时对JS的支持。
Get CSS 开启 启用预览时对CSS的支持。用作页面的样式设计。
Preview CSS Style 默认即可 设置预览时的默认样式表。
Host wiki.pigeon-games.com 主站地址。
Password [密码] 用户密码。
User Name [用户名] 用户名。

设置完成后，可输入一段wikitext，然后点击右上角的预览按钮，或按Ctrl+Shift+V预览，如果配置正确，将会在右边看到条目的显示效果。




注释

  1. ↑ 官网下载速度较慢。
取自“https://wiki.pigeon-games.com/index.php?title=帮助:使用VSCode协助编辑条目&oldid=31544”