Expressive Code 代码高亮示例

NOTE
This is a translated version.

这里，我们将探索使用 Expressive Code 的代码块外观。提供的示例基于官方文档，你可以参考官方文档获取更多详细信息。

Expressive Code#

语法高亮#

常规语法高亮#

1
console.log('这段代码被语法高亮了！')

渲染 ANSI 转义序列#

1
ANSI 颜色:
2
- 常规: 红色 绿色 黄色 蓝色 品红色 青色
3
- 粗体: 红色 绿色 黄色 蓝色 品红色 青色
4
- 调暗: 红色 绿色 黄色 蓝色 品红色 青色
5

6
256 色（显示颜色 160-177）:
7
160 161 162 163 164 165
8
166 167 168 169 170 171
9
172 173 174 175 176 177
10

11
完整 RGB 颜色:
12
森林绿 - RGB(34, 139, 34)
13

14
文本格式: 粗体 调暗 斜体 下划线

编辑器与终端框架#

编辑器与终端框架

代码编辑器框架#

1
console.log('标题属性示例')

1
<div>文件名注释示例</div>

终端框架#

1
echo "这个终端框架没有标题"

1
Write-Output "这个有标题！"

覆盖框架类型#

1
echo "看，没有框架！"

1
# 如果不覆盖，这将是一个终端框架
2
function Watch-Tail { Get-Content -Tail 20 -Wait $args }
3
New-Alias tail Watch-Tail

文本与行标记#

文本与行标记

标记整行与行范围#

1
// 第1行 - 被行号标记
2
// 第2行
3
// 第3行
4
// 第4行 - 被行号标记
5
// 第5行
6
// 第6行
7
// 第7行 - 被范围"7-8"标记
8
// 第8行 - 被范围"7-8"标记

选择行标记类型（mark, ins, del）#

1
function demo() {
2
  console.log('这一行被标记为已删除')
3
  // 这一行和下一行被标记为已插入
4
  console.log('这是第二个已插入行')
5

6
  return '这一行使用中性默认标记类型'
7
}

为行标记添加标签#

1
// 带标签行标记.jsx
2
<button
3
  role="button"
4
  {...props}
5
  value={value}
6
  className={buttonClassName}
7
  disabled={disabled}
8
  active={active}
9
>
10
  {children &&
11
   !active &&
12
    (typeof children === 'string' ? <span>{children}</span> : children)}
13
</button>

在独立行上添加长标签#

1
// 带标签的行标记.jsx
2
<button
3
  role="button"
4
  {...props}
5

6
  value={value}
7
  className={buttonClassName}
8

9
  disabled={disabled}
10
  active={active}
11
>
12

13
  {children &&
14
    !active &&
15
    (typeof children === 'string' ? <span>{children}</span> : children)}
16
</button>

使用差异类语法#

1
这一行将被标记为插入
2
这一行将被标记为删除
3
这是常规行

1
--- a/README.md
2
+++ b/README.md
3
@@ -1,3 +1,4 @@
4
+这是一个实际的差异文件
5
-所有内容将保持不变
6
 空白字符也不会被删除

结合语法高亮与差异类语法#

1
function thisIsJavaScript() {
2
  // 整个代码块将被高亮为 JavaScript，
3
  // 我们仍然可以添加差异标记！
4
  console.log('要删除的旧代码')
5
  console.log('全新的代码！')
6
}

标记行内的单个文本#

1
function demo() {
2
  // 标记行内的任何给定文本
3
  return '支持给定文本的多个匹配';
4
}

正则表达式#

1
console.log('单词 yes 和 yep 将被标记。')

转义正斜杠#

1
echo "Test" > /home/test.txt

选择内联标记类型（mark, ins, del）#

1
function demo() {
2
  console.log('这些是插入和删除标记类型');
3
  // return 语句使用默认标记类型
4
  return true;
5
}

文本换行#

文本换行

按块配置文本换行#

1
// 带换行的示例
2
function getLongString() {
3
  return '这是一个很长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// 带wrap=false的示例
2
function getLongString() {
3
  return '这是一个很长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

配置换行行的缩进#

1
// 带preserveIndent的示例（默认启用）
2
function getLongString() {
3
  return '这是一个很长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

1
// 带preserveIndent=false的示例
2
function getLongString() {
3
  return '这是一个很长的字符串，除非容器极宽，否则很可能无法适应可用空间'
4
}

可折叠部分#

可折叠部分


5 collapsed lines
1
// 所有这些样板设置代码将被折叠
2
import { someBoilerplateEngine } from '@example/some-boilerplate'
3
import { evenMoreBoilerplate } from '@example/even-more-boilerplate'
4

5
const engine = someBoilerplateEngine(evenMoreBoilerplate())
6

7
// 这部分代码默认可见
8
engine.doSomething(1, 2, 3, calcFn)
9

10
function calcFn() {
11
  // 你可以有多个折叠部分
3 collapsed lines
12
  const a = 1
13
  const b = 2
14
  const c = a + b
15

16
  // 这将保持可见
17
  console.log(`计算结果: ${a} + ${b} = ${c}`)
18
  return c
19
}
20

4 collapsed lines
21
// 从这里到代码块结尾的所有代码将再次折叠
22
engine.closeConnection()
23
engine.freeMemory()
24
engine.shutdown({ reason: '示例样板代码结束' })

行号#

按块显示行号#

1
// 此代码块将显示行号
2
console.log('来自第2行的问候！')
3
console.log('我在第3行')

// 此代码块禁用行号
console.log('你好？')
console.log('抱歉，你知道我在哪一行吗？')

更改起始行号#

5
console.log('来自第5行的问候！')
6
console.log('我在第6行')