跳转到内容

预览窗格

在文件上按 A(或 Enter / 双击)会在文件列表右侧打开内置预览 —— 每个标 签页一个预览。该窗格会占据窗口宽度的一部分,因此显示媒体和 PDF 时依然宽敞。

  • 文本 / 代码 —— 可滚动。
  • 图片 —— PNG、JPEG、GIF、WebP、BMP —— 按宽度适配。
  • HEIC / AVIF / JXL —— 需要安装图片转换工具(macOS 自带 sips;Linux/Windows 上可用 heif-convert、ImageMagick 或 vips)。
  • SVG
  • HTMLMarkdown —— 以静态、无 JavaScript 的方式渲染(脚本永远不会 运行,因此预览不会执行任何主动行为)。
  • PDF —— 分页显示。

对于 SVG、HTML 和 Markdown,你可以用标题栏的 </> 按钮(或手柄上的 X / F2)查看原始源代码,而不是渲染后的视图。Markdown 显示的是它原本的 .md 文本,而不是转换后的 HTML。

进入预览面板。其他按钮的作用取决于文件类型:

  • 文本 / 图片 / SVG / HTML / Markdown —— 上 / 下滚动;A 用系统默认应 用打开该文件。
  • PDF —— 上 / 下翻页;Home / End 跳到第一页 / 最后一页;A 在外部 应用中打开。

面板是一个小小的栈,两个按钮在其中朝相反方向移动。X 向文件的原始字节靠近一步;B(或 Escape)往回退一步,只有在最上层才会关闭。

文件X 往下 →
文本阅读 → 编辑 → 已关闭
SVG、HTML、Markdown渲染 → 源代码 → 编辑 → 已关闭
图片、PDF已关闭

文本文件没有源代码视图,所以第一次按 X 就直接开始编辑。标记语言需要按两次:一次显示源代码,一次开始编辑。标题栏的 无论你在哪一层都会直接关闭。

文本预览可以就地编辑。面板标题栏中的铅笔按钮(或手柄上的 X)会把它变成可编辑字段;按 Esc 或再次按该按钮退出编辑。只有文本可以编辑:其他类型是渲染出来的视图,而不是缓冲区。这也是 X 从不与源代码切换冲突的原因——文本文件没有源代码视图。

Ctrl/Cmd+S 保存,即使焦点已回到文件列表也仍然有效。在手柄上,只要有内容需要保存,A 就执行保存;没有内容需要保存时,它照常在外部应用中打开文件。文件名旁边的圆点表示有未保存的更改,标题栏中它的旁边会出现保存按钮。

Steam Deck 上,X 会在字段上方唤出屏幕键盘,Steam 的 B 会关闭它并把你交还给面板导航。

DeckCrate 会记住它是如何读取该文件的,并以同样的方式保存:

  • 编码 — 以旧式 Latin-1(“ANSI”)读取的文件仍以 Latin-1 保存,不会被悄悄重新编码为 UTF-8。如果你输入了 Latin-1 无法容纳的字符(比如表情符号),文件会被转换为 UTF-8,并有提示告知你。
  • 换行符 — CRLF 文件保持 CRLF,包括你刚刚输入的行。
  • 身份 — 保存是就地写入的,所以符号链接仍然是符号链接,权限、所有者和扩展属性都能在编辑后保留。

SVG、HTML 和 Markdown 同样可以编辑——但只能从源代码视图进入,铅笔按钮也出现在那里。渲染视图不是缓冲区:从排版后的页面没有回到文件的路径,所以你编辑的是标记本身。

上面所说的一切都同样适用,包括编码和换行符方面的保证。有两点是标记语言特有的:

  • 保存 .md 写入的是 Markdown,绝不会写入它被转换成的 HTML。
  • 渲染视图会在保存时刷新,所以退出编辑器时你看到的是新内容,而不是打开时磁盘上的那个版本。

带着未保存的更改退回渲染视图,看到的是已保存的版本,同时圆点仍然显示——那是磁盘上的内容,而圆点表示还有更多。

任何会丢弃已编辑缓冲区的操作都会先询问,并提供保存放弃取消(手柄上的 AYB):

  • 关闭面板,
  • 预览另一个文件,
  • 打开终端(它与预览共用同一位置),
  • 把标签页数量减少到低于某个含未保存更改的标签页,
  • 从命令菜单或工具栏退出。

每个标签页都保留自己的缓冲区,所以切换标签页绝不会让你丢失输入——圆点会一直显示,直到你保存或放弃。

首选项 → 预览 → 渲染预览默认开启。关闭它,SVG、HTML 和 Markdown 就会直接以源代码打开——此时按一次 X 即可开始编辑,</> 按钮消失,B 会关闭面板而不是显示渲染视图。对这些文件来说,渲染层级根本不存在。

文本、图片和 PDF 不受影响。该设置只作用于此后打开的预览;已经打开的面板会保持它打开时的层级。

二进制文件、不受支持的格式和过大的文件无法预览。DeckCrate 会提议改用 系统默认应用打开它们。在该提示中,你还可以按 Y 来挑选特定的应用(参见 打开方式…)。

你可以通过预览窗格的 A 按钮在默认应用中打开任意文件,对于无法预览的文件也可 以直接这样做。

对于单个高亮的文件,命令菜单中的**打开方式…**条目会显示一个可用手柄导航的已安装应用列表, 按字母顺序排列。A / Enter 确认,B / Esc 取消。在“无法预览”的提示中,它也 以 Y 的形式提供。在 macOS、Linux 和 Windows 上均可使用。