代码折叠与复制

为了避免冗长的样板代码或超长配置文件占据过多版面，Shirone 提供了代码折叠行指令与一键复制功能。

代码折叠（collapse）#

在元数据中使用 collapse={起始行-结束行} 指定默认折叠的代码范围：

1
```typescript collapse={4-8} title="长配置文件示例"
2
import { defineUserConfig } from 'astro/config';
3

4
export default defineUserConfig({
5
  // 折叠部分开始
6
  site: 'https://shirone.mysqil.com',
7
  base: '/',
8
  trailingSlash: 'always',
9
  output: 'static',
10
  // 折叠部分结束
11
  integrations: [],
12
});
13
```

渲染效果：

1
import { defineUserConfig } from 'astro/config';
2

3
export default defineUserConfig({
5 collapsed lines
4
  // 折叠部分开始
5
  site: 'https://shirone.mysqil.com',
6
  base: '/',
7
  trailingSlash: 'always',
8
  output: 'static',
9
  // 折叠部分结束
10
  integrations: [],
11
});

被折叠的行在初次加载时显示为「展开 N 行」的交互按钮，读者点击后平滑展开完整内容。

多个折叠区间#

collapse 支持同时传入多段范围，把不重要的区块分别收起：

1
```yaml collapse={1-3,9-11} title="config/site.yaml"
2
# 折叠区间一：顶部注释
3
# 只写想改的键，其余保持主题默认值
4
# 升级主题后新默认值会自动生效
5

6
site: https://www.example.com/
7
title: 我的博客
8
subtitle: 一个神奇的博客
9
lang: zh_CN
10

11
# 折叠区间二：页脚
12
# 这里放备案信息与统计代码
13
# 可以保持折叠状态
14
```

渲染效果：


3 collapsed lines
1
# 折叠区间一：顶部注释
2
# 只写想改的键，其余保持主题默认值
3
# 升级主题后新默认值会自动生效
4

5
site: https://www.example.com/
6
title: 我的博客
7
subtitle: 一个神奇的博客
8
lang: zh_CN
3 collapsed lines
9

10
# 折叠区间二：页脚
11
# 这里放备案信息与统计代码
12
# 可以保持折叠状态

一键复制代码#

所有渲染的代码块在右上角均内置了优雅的一键复制按钮：

点击后自动将代码原始内容写入系统剪贴板。
复制成功后呈现微动效提示。
保证复制出的文本是纯净代码，绝不包含行号或标记字符。

即使在折叠状态下，复制按钮给出的仍然是完整的原始代码，而不是屏幕上可见的部分。

折叠与其它特性的组合#

需求	写法
折叠中间区块	`collapse={4-8}`
折叠多段	`collapse={1-3,9-11}`
折叠 + 行号	`collapse={4-8} showLineNumbers`
折叠 + 文件名	`collapse={4-8} title="config/site.yaml"`

二甲基

代码折叠（collapse）#

多个折叠区间#

一键复制代码#

折叠与其它特性的组合#

Markdown 语法

继续阅读

换条路线

评论

二甲基

代码折叠（collapse）#

多个折叠区间#

一键复制代码#

折叠与其它特性的组合#

分享文章

沿着主题读

换条路线

评论