预览窗格
在文件上按 A(或 Enter / 双击)会在文件列表右侧打开内置预览 —— 每个标 签页一个预览。该窗格会占据窗口宽度的一部分,因此显示媒体和 PDF 时依然宽敞。
它能预览什么
Section titled “它能预览什么”- 文本 / 代码 —— 可滚动。
- 图片 —— PNG、JPEG、GIF、WebP、BMP —— 按宽度适配。
- HEIC / AVIF / JXL —— 需要安装图片转换工具(macOS 自带
sips;Linux/Windows 上可用heif-convert、ImageMagick 或vips)。 - SVG。
- HTML 和 Markdown —— 以静态、无 JavaScript 的方式渲染(脚本永远不会 运行,因此预览不会执行任何主动行为)。
- PDF —— 分页显示。
对于 SVG、HTML 和 Markdown,你可以用标题栏的 </> 按钮(或手柄上的 X / F2)查看原始源代码,而不是渲染后的视图。Markdown 显示的是它原本的 .md 文本,而不是转换后的 HTML。
右进入预览面板。其他按钮的作用取决于文件类型:
- 文本 / 图片 / SVG / HTML / Markdown —— 上 / 下滚动;A 用系统默认应 用打开该文件。
- PDF —— 上 / 下翻页;Home / End 跳到第一页 / 最后一页;A 在外部 应用中打开。
层级:X 往下,B 往回
Section titled “层级:X 往下,B 往回”面板是一个小小的栈,两个按钮在其中朝相反方向移动。X 向文件的原始字节靠近一步;B(或 Escape)往回退一步,只有在最上层才会关闭。
| 文件 | X 往下 → |
|---|---|
| 文本 | 阅读 → 编辑 → 已关闭 |
| SVG、HTML、Markdown | 渲染 → 源代码 → 编辑 → 已关闭 |
| 图片、PDF | 已关闭 |
文本文件没有源代码视图,所以第一次按 X 就直接开始编辑。标记语言需要按两次:一次显示源代码,一次开始编辑。标题栏的 ✕ 无论你在哪一层都会直接关闭。
编辑文本文件
Section titled “编辑文本文件”文本预览可以就地编辑。面板标题栏中的铅笔按钮(或手柄上的 X)会把它变成可编辑字段;按 Esc 或再次按该按钮退出编辑。只有文本可以编辑:其他类型是渲染出来的视图,而不是缓冲区。这也是 X 从不与源代码切换冲突的原因——文本文件没有源代码视图。
Ctrl/Cmd+S 保存,即使焦点已回到文件列表也仍然有效。在手柄上,只要有内容需要保存,A 就执行保存;没有内容需要保存时,它照常在外部应用中打开文件。文件名旁边的圆点表示有未保存的更改,标题栏中它的旁边会出现保存按钮。
在 Steam Deck 上,X 会在字段上方唤出屏幕键盘,Steam 的 B 会关闭它并把你交还给面板导航。
文件按原样写回
Section titled “文件按原样写回”DeckCrate 会记住它是如何读取该文件的,并以同样的方式保存:
- 编码 — 以旧式 Latin-1(“ANSI”)读取的文件仍以 Latin-1 保存,不会被悄悄重新编码为 UTF-8。如果你输入了 Latin-1 无法容纳的字符(比如表情符号),文件会被转换为 UTF-8,并有提示告知你。
- 换行符 — CRLF 文件保持 CRLF,包括你刚刚输入的行。
- 身份 — 保存是就地写入的,所以符号链接仍然是符号链接,权限、所有者和扩展属性都能在编辑后保留。
标记语言通过源代码编辑
Section titled “标记语言通过源代码编辑”SVG、HTML 和 Markdown 同样可以编辑——但只能从源代码视图进入,铅笔按钮也出现在那里。渲染视图不是缓冲区:从排版后的页面没有回到文件的路径,所以你编辑的是标记本身。
上面所说的一切都同样适用,包括编码和换行符方面的保证。有两点是标记语言特有的:
- 保存
.md写入的是 Markdown,绝不会写入它被转换成的 HTML。 - 渲染视图会在保存时刷新,所以退出编辑器时你看到的是新内容,而不是打开时磁盘上的那个版本。
带着未保存的更改退回渲染视图,看到的是已保存的版本,同时圆点仍然显示——那是磁盘上的内容,而圆点表示还有更多。
未保存的更改
Section titled “未保存的更改”任何会丢弃已编辑缓冲区的操作都会先询问,并提供保存、放弃或取消(手柄上的 A、Y 和 B):
- 关闭面板,
- 预览另一个文件,
- 打开终端(它与预览共用同一位置),
- 把标签页数量减少到低于某个含未保存更改的标签页,
- 从命令菜单或工具栏退出。
每个标签页都保留自己的缓冲区,所以切换标签页绝不会让你丢失输入——圆点会一直显示,直到你保存或放弃。
首选项 → 预览 → 渲染预览默认开启。关闭它,SVG、HTML 和 Markdown 就会直接以源代码打开——此时按一次 X 即可开始编辑,</> 按钮消失,B 会关闭面板而不是显示渲染视图。对这些文件来说,渲染层级根本不存在。
文本、图片和 PDF 不受影响。该设置只作用于此后打开的预览;已经打开的面板会保持它打开时的层级。
当文件无法预览时
Section titled “当文件无法预览时”二进制文件、不受支持的格式和过大的文件无法预览。DeckCrate 会提议改用 系统默认应用打开它们。在该提示中,你还可以按 Y 来挑选特定的应用(参见 打开方式…)。
用默认应用打开
Section titled “用默认应用打开”你可以通过预览窗格的 A 按钮在默认应用中打开任意文件,对于无法预览的文件也可 以直接这样做。
对于单个高亮的文件,命令菜单中的**打开方式…**条目会显示一个可用手柄导航的已安装应用列表, 按字母顺序排列。A / Enter 确认,B / Esc 取消。在“无法预览”的提示中,它也 以 Y 的形式提供。在 macOS、Linux 和 Windows 上均可使用。