Background
1474 字
7 分钟
Expressive Code 示例

本文展示本站通过 Expressive Code 呈现代码块的效果。更多配置细节可参阅其官方文档。

代码块样式#

语法高亮#

语法高亮文档

常规语法高亮#

console.log('这段代码会显示语法高亮')

ANSI 转义序列#

Terminal window
ANSI 颜色:
- 普通:红 绿 黄 蓝 洋红 青
- 粗体:红 绿 黄 蓝 洋红 青
- 暗色:红 绿 黄 蓝 洋红 青
256 色(展示 160-177):
160 161 162 163 164 165
166 167 168 169 170 171
172 173 174 175 176 177
完整 RGB 颜色:
森林绿 - RGB(34, 139, 34)
文本格式:粗体 淡化 斜体 下划线

编辑器与终端边框#

编辑器与终端边框文档

代码编辑器边框#

示例文件.js
console.log('代码块标题示例')

src/content/index.html
<div>文件名注释示例</div>

终端边框#

Terminal window
echo "这个终端边框没有标题"

PowerShell 终端示例
Write-Output "这个终端边框带有标题!"

指定边框类型#

echo "这个代码块不显示边框"

PowerShell 配置文件.ps1
# 如果不指定类型,这里会显示为终端边框
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
New-Alias tail Watch-Tail

文本与行标记#

文本与行标记文档

标记指定行与行范围#

// Line 1 - targeted by line number
// Line 2
// Line 3
// Line 4 - targeted by line number
// Line 5
// Line 6
// Line 7 - targeted by range "7-8"
// Line 8 - targeted by range "7-8"

选择行标记类型(mark、ins、del)#

line-markers.js
function demo() {
console.log('this line is marked as deleted')
// This line and the next one are marked as inserted
console.log('this is the second inserted line')
return 'this line uses the neutral default marker type'
}

为行标记添加说明#

// 行标记说明示例.jsx
<button
role="button"
{...props}
value={value}
className={buttonClassName}
disabled={disabled}
active={active}
>
{children &&
!active &&
(typeof children === 'string' ? <span>{children}</span> : children)}
</button>

将较长说明单独显示#

// 行标记说明示例.jsx
<button
role="button"
{...props}
value={value}
className={buttonClassName}
disabled={disabled}
active={active}
>
{children &&
!active &&
(typeof children === 'string' ? <span>{children}</span> : children)}
</button>

使用 diff 风格语法#

这一行会标记为新增
这一行会标记为删除
这是一行普通内容

--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
+这是一个实际的 diff 文件
-所有内容保持不变
空格也不会被移除

组合语法高亮与 diff 标记#

function thisIsJavaScript() {
// 整个代码块会按 JavaScript 高亮,
// 同时也可以添加 diff 标记!
- console.log('即将删除的旧代码')
+ console.log('新增的代码')
}

标记行内文本#

function demo() {
// 可以标记行内任意文本
return '同一文本可以匹配多处';
}

正则表达式标记#

console.log('yes 和 yep 这两个单词会被标记。')

转义正斜杠#

Terminal window
echo "测试" > /home/test.txt

选择行内标记类型(mark、ins、del)#

function demo() {
console.log('此处演示新增与删除两种标记类型');
// return 语句使用默认标记类型
return true;
}

自动换行#

自动换行文档

为代码块设置自动换行#

// 启用自动换行的示例
function getLongString() {
return '这确实是一段篇幅相当长、字数颇为可观、整体内容也显得比较长、看起来并不短的文本;在当前所处容器的宽度还没有达到足够宽、尚未扩展到足以将整段文字全部容纳下来的程度之前,它极有可能没有办法在同一行之中完整无缺地、毫无遗漏地、一个字符都不少地显示出来。'
}

// 禁用自动换行的示例
function getLongString() {
return '这确实是一段篇幅相当长、字数颇为可观、整体内容也显得比较长、看起来并不短的文本;在当前所处容器的宽度还没有达到足够宽、尚未扩展到足以将整段文字全部容纳下来的程度之前,它极有可能没有办法在同一行之中完整无缺地、毫无遗漏地、一个字符都不少地显示出来。'
}

设置换行后的缩进#

// preserveIndent 示例(默认启用)
function getLongString() {
return '这确实是一段篇幅相当长、字数颇为可观、整体内容也显得比较长、看起来并不短的文本;在当前所处容器的宽度还没有达到足够宽、尚未扩展到足以将整段文字全部容纳下来的程度之前,它极有可能没有办法在同一行之中完整无缺地、毫无遗漏地、一个字符都不少地显示出来。'
}

// 禁用 preserveIndent 的示例
function getLongString() {
return '这确实是一段篇幅相当长、字数颇为可观、整体内容也显得比较长、看起来并不短的文本;在当前所处容器的宽度还没有达到足够宽、尚未扩展到足以将整段文字全部容纳下来的程度之前,它极有可能没有办法在同一行之中完整无缺地、毫无遗漏地、一个字符都不少地显示出来。'
}

可折叠代码段#

可折叠代码段文档

5 collapsed lines
// 这部分初始化样板代码会被折叠
import { someBoilerplateEngine } from '@example/some-boilerplate'
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
const engine = someBoilerplateEngine(evenMoreBoilerplate())
// 默认显示的代码部分
engine.doSomething(1, 2, 3, calcFn)
function calcFn() {
// 可以包含多个可折叠代码段
3 collapsed lines
const a = 1
const b = 2
const c = a + b
// 这部分保持可见
console.log(`计算结果:${a} + ${b} = ${c}`)
return c
}
4 collapsed lines
// 直到代码块末尾的内容都会再次折叠
engine.closeConnection()
engine.freeMemory()
engine.shutdown({ reason: 'End of example boilerplate code' })

行号#

行号插件文档

为代码块显示行号#

// 此代码块将显示行号
console.log('你好,我位于第 2 行!')
console.log('我位于第 3 行')

// 此代码块不显示行号
console.log('你好?')
console.log('请问你知道我位于哪一行吗?')

修改起始行号#

console.log('你好,我位于第 5 行!')
console.log('我位于第 6 行')
Expressive Code 示例
https://ancryel.github.io/fuwari-modified-demo/posts/expressive-code/
作者
Lorem ipsum
发布于
2024-04-10
许可协议
CC BY-NC-SA 4.0