参与编撰 | 猫猫ATC

投稿前请看这里

本站是单纯的信息类平台，不包含互动功能，所以欢迎各位在文中宣传自己的B站号、直播间等可以方便读者联系到你的方式，但不接受无干货纯广告。
服务器容量有限，大文件请先上传到相应平台后再链接过来，如DCS涂装/任务等均有官方上传渠道，请确保你上传的文件可以被无门槛下载到，切勿上传百度网盘！（可以试试123pan.com，至少目前免费用户不限速）
初次投稿前请先联系蛋卷，别自己哼哧哼哧写完了发现其实写的并不合适，为避免不必要的风险，蛋卷保留什么内容可以出现在网站上的最终决定权

文件格式

本网站里的文章均使用 Markdown（.md）格式编写，你可以把他理解为一个高端一点的记事本文档，支持分段、插入图片和链接等功能，但不像Word那么功能繁多或HTML那么难学。

网站的原理是在上传时，把md里写的文章转化成好看的网页，并自动生成侧边栏等，作者只需要专注写好文章本身。你可以用这个在线编辑器感受一下Markdown大概是个啥玩意（右上角可以改成电脑版）。

但如果你想插入自己电脑上的图片/文件等，建议下载这个准备好的投稿模板，然后使用一个本地的编辑器。熟悉写码建议无脑微软 VS Code

如果不熟悉写码的话，推荐使用 Obsidian。这个软件在编辑md文件时可以看到大致的页面效果，按 Ctrl + E 还可进入阅读模式，看到最准确的效果。第一次打开会让你建一个仓库，之后把所有你写的文章文件夹都放在这里就好。记得一定要在左下角的设置里把 严格换行 打开（下面就知道为什么了）。建议到外观里下载一个Blue Topaz主题，跟我们的网页显示比较相近。

如果你想实时看到文章在网页上的效果，请联系蛋卷

下面是蛋卷针对本站给你们写的一些常用功能编写指南。

注意！！

为了保证你写的东西确实能显示出来，要格外留意：

接下来所有要用到的文件，名字里都不要有空格，且区分大小写（建议全部小写）
区分中英文符号，格式所需的各种冒号括号等都是英文符号，中文符号仅在文字段本身使用
该加空格的地方别忘了加，比如列表里
中文冒号 ： 看起来非常像英文冒号+空格 : ，但前者无法被系统识别

文件开头

本站系统使用的md文件中，最开头的一段定义了文章在网站上的一些属性，比如 F-14前座超人的开头是这样写的

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
---
author: 蛋卷  # 作者名
link: https://space.bilibili.com/257463461 # 点击作者名会打开的网页
title: F-14前座超人  # 文章标题
slug: f14-keybind   # 文章网址显示（字母/数字，无空格）
date: 2023-02-10  # 发布日期
description: 在前座使用后座功能（如两种干扰弹）  # 文章简介
tags:  # 标签，可以有多个，建议第一个写机型，后面写功能等
    - F-14
    - 键位
categories: # 分类，填一个，小写英文，目前可选的有下面这些，更多的可以找蛋卷加
    - dcs   # dcs、civil（民航）、hardware（硬件/外设）、other（其他不好分类的）
image: f14-read.jpg  # 封面图，跟index.md放在同一个文件夹内
toc: false  # 是否在网页右侧显示文章目录，文章太长可以使用
math: false # 是否要启用数学表达式显示
---

注意开头区域需要用上下方的两道横线包住

文件主体

章节标题

在文字前面加数个井号和一个空格，井号越多级别越低字越小，比如上面的 分段标题 四个字就是加了三个井号
如果在开头选择了打开目录，目录会依据2-4号标题自动生成

1
2
3
4
# 这是一号标题（太大了不建议使用）
## 这是二号标题
### 这是三号标题
#### 这是四号标题

段落和换行

两行字之间空一行代表新一段话，两段话之间会显示出间隔

如果只想主动换行但不想新开一段
请在上一行结尾加两个空格

如果不加空格只打个回车在网页上还是会显示成同一行字
Obsidian中打开严格换行才能看到这个效果

1
2
3
4
5
6
7
两行字之间空一行代表新一段话，两段话之间会有间隔

如果只想主动换行但不想新开一段  ←这里有两个空格
请在上一行结尾加两个空格

如果不加空格只打个回车 ←这里没有两个空格
在网页上还是会显示成同一行字

分隔线

三条段横线+上下各空一行可以插入一个水平分隔线

斜体和粗体

这是斜体，这是粗体，这是又斜又粗

1
 *这是斜体*，**这是粗体**，***这是又斜又粗***

列表

注意！不建议在列表中插入图片，这样会导致图片左侧跟列表子项对其，而非全宽度显示，在手机上观感不佳。
如果要制作图文并茂的文章，请在有图片的部分使用普通文字，或者用中文顿号 、做数字列表，这个不会被系统自动排版。

列表可以像这样
前面只有一个点
- 还可以有子项
- 多个子项
  - 甚至更深的子项
这种列表使用短横杠- + 空格编写

列表也可像这样
有数字排序
1. 数字也有子项
这种列表使用数字 + 点 + 空格编写

1、用中文顿号做数字列表
2、系统认不出来，不会被自动排版
3、这样下面插入的图片不会被挤到一边
4、注意这么做行尾要打两个空格

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
- 列表可以像这样
- 前面只有一个点
  - 还可以有子项（前面有两个空格）
  - 多个子项
    - 甚至更深的子项（前面有四个空格）
- 这种列表使用短横杠 + 空格编写

1. 列表也可像这样
2. 有数字排序
   1. 数字也有子项（数字需要有三个空格）
3. 这种列表使用数字 + 点 + 空格编写

1、用中文顿号做数字列表  
2、系统认不出来，不会被自动排版  
3、这样下面插入的图片不会被挤到一边  
4、注意这么做行尾要打两个空格

代码显示

虽然我们并不会真的教写码，但是代码的显示方式很适合用来表示文件路径和游戏内选项/键位等
用 Tab 键上方那个点把文字包起来就会显示成代码，建议前后加上空格
比如，DCS地图存放在 C:\Users\你的用户名\Saved Games\DCS\Missions

1
2
3
用 `Tab` 键上方那个点把文字包起来就会显示成代码，建议前后加上空格  
比如，DCS地图存放在 `C:\Users\你的用户名\Saved Games\DCS\Missions`
这个斜着的小点要用英文输入法才打得出来

如果要插入上面这样的多行代码块，在多行文字的上下各使用三个点将其包住，其中上方三点后面可以接代码语言名称以获得代码高亮
比如SRS的lua代码显示出来是

1
2
3
丶丶丶lua 
pcall(function() local dcsSr=require('lfs');dofile(dcsSr.writedir()..[[Mods\Services\DCS-SRS\Scripts\DCS-SimpleRadioStandalone.lua]]); end,nil);
丶丶丶 ←注意这个大点只是演示，实际用的是Tab上方的小点，要用英文输入法才打得出来

插入链接

最简单的做法是网址前后加上 < >，直接把网址显示出来：https://catatc.cn/post/dcs/f14-keybind
但你可能想要一个更好看的文字链接
本站网址可以不用加前面的域名，只写网址后面一段：F-14前座超人

1
2
3
<https://catatc.cn/post/f14-keybind>
[文字链接](https://catatc.cn/post/dcs/f14-keybind)
[F-14前座超人](/post/dcs/f14-keybind)

插入图片

注意插入图片前后要用双空格换行，否则小一点的图片会跟文字出现在同一行
把图片和 index.md 放在同一个文件夹内，可以只写图片的文件名不用写路径
图片比较多的时候，建议新建一个 img 文件夹，引用时使用 (img/文件名)
高血压表情包
还可以插入图片链接，比如这个下载按钮，你可以直接拿去用并换成你的链接

1
2
3
4
5
6
7
![高血压表情包](pressure.png)
![图片标题](图片路径/文件名)

[![点击下载](/button-dl.png)](/downloads/DCS_Big_Label.zip)
[![图片标题](图片路径/文件名)](链接路径或网址)

图片标题正常情况下并不看得到，除非文件路径炸了，图片显示不出来才会显示文字

插入B站视频

如果要插入 https://www.bilibili.com/video/BV1g84y1L7hT/

1
2
[[< bilibili BV1g84y1L7hT >]]
把方括号[[ ]] 换成大括号{{ }}

引用

如果想表明一段话是引用，在每一行前面加上 >

而第一根则是臭名昭著的耻辱线
– 蛋卷

1
2
3
> 而第一根则是臭名昭著的耻辱线
>
> -- 蛋卷

数学表达式

把要写显示的东西写在两行美元符号之间，如 $$ E=mc^2 $$

1
2
3
$$
E=mc^2
$$

具体格式详情请见 KeTeX格式说明