第32章 HTML、Mermaid、PDF 及图像查看器
HTML、Mermaid、PDF 和图像查看器
Orca 内置了针对仓库中常见格式的查看器。
HTML
通过“在 Orca 浏览器中打开”或“侧边打开预览”功能，可以打开本地、SSH 或配对运行时的 .html 文件。Orca 会在沙箱化的浏览器标签页中本地渲染文档，并通过工作区的文件连接读取该文件及其相对资源。这样，远程设计文档就能保持清晰，而无需暴露桌面文件系统。
预览时会询问是否读取额外的文件夹，并仅授予你批准给该标签页的文件夹权限。外部 HTTP(S) 链接需要确认，并在正常的 Orca 浏览器标签页中打开；在文档预览中禁用了下载。如果页面请求来自已授权供应商的 web 字体（例如 Google Fonts 链接），Orca 会直接渲染这些字体，而不是回退到默认字体。使用“预览选项”可以从磁盘重新加载、打开源文件，或复制其完整路径或相对于工作区的路径。
预览中的文档标签也充当地址栏。编辑它并输入网址，可将该标签页转换为正常浏览器标签页；在浏览器标签页中输入工作区 HTML 路径，则可将其还原为预览模式。在没有中间页面历史记录的情况下，返回操作会在两种模式间切换。
在配对运行时中，HTML 文件必须位于工作树内。非常旧的配对服务器可能会渲染文档但缺失二进制资源；如果远程图像无法加载，请更新服务器。
Mermaid
Mermaid 图表在 Markdown 预览中内联渲染。独立的 .mmd 文件会在专用查看器中打开，支持平移和缩放。
支持滚动、缩放和文本选择。对于签入仓库的设计文档非常有用。通过触控板捏合、Ctrl+滚动，或 Cmd/Ctrl 配合 = / - / 0 进行页面缩放，且焦点保持在光标下方。Orca 会在标签页之间以及重启后记住你的 PDF 缩放设置。当你切换离开 PDF 标签页再返回时（包括在同一会话中关闭后重新打开），滚动位置会恢复（包括页码和页内偏移），让你能回到上次停下的位置。这些位置仅在会话期间有效，Orca 重启后会清空。
图像
支持 .png、.jpg、.svg、.webp、.gif。图像差异模式可并排比较同一文件的不同版本。
音频和视频
音频和视频文件可在 Orca 内部使用原生控件播放——包括 .mp3、.wav、.ogg、.m4a、.aac、.flac、.mp4、.mov、.webm、.mkv 和 .avi。桌面端以流式方式传输预览，因此大型片段无需加载整个文件即可开始播放；如果希望使用操作系统的播放器，本地文件提供“在默认应用中打开”选项。Orca 无法解码的文件会显示播放错误，而不是空白面板。
CSV / TSV
.csv 和 .tsv 文件会在可就地编辑的表格中打开。点击单元格即可编辑，选择和复制/粘贴范围，并使用行和列菜单添加或删除行和列；“列”菜单可用于重新排序。排序或筛选可用于检查数据——该视图不会改写文件的行顺序——并且整单元格 http(s) 链接可点击打开。文件仍然是唯一事实来源：编辑会保留其 BOM、记录结尾、引用和末尾换行。你设置的列宽会在视图切换和应用重启后保留。这对于测试数据、导出数据以及签入仓库的任何表格数据都非常有用。
查看器会自动检测分隔符（逗号、分号或制表符），分隔符选择器可让你强制使用“自动”、“逗号”、“分号”或“制表符”——这对分号分隔的导出非常有用。使用工具栏切换到纯文本视图。
1 MiB 或更大的文件将以只读的分页预览方式打开：Orca 会对文件进行索引，仅渲染屏幕上的行和列，因此大型导出保持响应状态而无需全部加载到内存中。表格编辑必须小于该大小限制——对于更大的文件，请切换到纯文本视图。
Jupyter Notebook
打开 .ipynb 文件即可查看渲染后的 Markdown、代码单元格和保存的输出。点击代码单元格可编辑；双击 Markdown 单元格或按 Enter 可编辑其源文本。编辑会保存到笔记本文件，同时保留 nbformat。
对于本地 Python 笔记本，使用 Shift+Enter 运行单元格并前进，或 Cmd/Ctrl+Enter 运行但停留在当前单元格。从第一次运行到关闭标签页，Orca 会为该笔记本保持一个 Jupyter 内核，因此变量在单元格之间持久化。图表、丰富输出、错误和执行次数都会与单元格一起显示。使用笔记本标题栏中的“运行全部”、“中断”、“重启”或“清除所有输出”功能。
标题栏中的内核选择器会推荐附近的 .venv 或 .conda 环境。你可以选择其他 Python 或浏览查找；Orca 会记住针对该笔记本的选择。Python 需要 ipykernel 和 jupyter_client。如果缺少 ipykernel，Orca 会提供安装选项。如果所选 Python 阻止软件包安装，选择“创建 .venv”以设置工作区环境。设置对话框会显示进度和错误。
在运行笔记本代码之前，请确认 Orca 的信任提示。在你信任笔记本之前，Orca 不会启动工作区 Python 解释器。SSH 工作树中的笔记本以及其他语言的笔记本仍然可以查看和编辑。参见“文件资源管理器”以在工作树中找到笔记本。
