文档
工具栏
每种视图一条工具栏,全都可以自定义:右键点它 (或“显示 → 自定义工具栏…”),把项目拖走、重新排列、加入初始 隐藏的项目。每个视图跨启动记住自己的排布。
自定义的原理
PullMark 没有“一条”工具栏——它给每种视图各配一条,就像 Mail 的 撰写窗口和主窗口各有各的工具栏。你自定义的是眼前这一条:打开一个 拉取请求文件,自定义的就是 PR 文件工具栏;打开本地文档,自定义的 就是本地文件工具栏。面板只提供在你打开它的地方真实存在的项目。
面板里的一切都任你处置——移除、重排、放入可调间距把项目群推开。下方标注隐藏的项目初始待在面板里 而不在栏上。唯一放不进去的位置是侧边栏切换键旁边、属于侧边栏自己的 那一段:它归系统所有,扔过去的项目会落到主区域的最前端。把面板底部 的默认项目组拖回去,即可恢复任何一条工具栏。
每个视图都有
| 项目 | 默认 | 作用 |
|---|---|---|
| 后退/前进 | 显示 | 在浏览过的文档之间后退和前进——按住任一箭头可查看它的历史。 |
| Review(审查) | 显示 | 会变形的审查控件,仅在 PR 视图上——待提交评论数、结论、提交。 窗口收窄时它坚持得最久:其他项目折进溢出菜单后,审查状态依然 可见。 |
| 打开文件或文件夹 | 显示 | 打开本地 Markdown 或一个文件夹“位置”。 |
| 打开拉取请求 | 显示 | 按 URL 打开 GitHub 拉取请求。 |
| 外观 | 显示 | 浅色 · 深色 · 跟随系统,应用全局。 |
本地文件
| 项目 | 默认 | 作用 |
|---|---|---|
| 共享 | 显示 | 该文件的标准共享面板。 |
| 编辑 | 显示 | 编辑模式——点击任意区块原地编辑。 |
| 比较 | 显示 | 与某个提交或分支比较(需要 git 仓库)。一枚小点表示文件有 未提交的改动。 |
| Blame | 显示 | 每个区块最后由谁改动;不在仓库中时禁用。 |
| 大纲 | 显示 | 标题侧边栏。 |
| 重新载入 | 显示 | 从磁盘重读文件。 |
| 源码 | 隐藏 | 渲染页面背后的原始 Markdown。 |
| 放大 · 实际大小 · 缩小 | 隐藏 | 相互独立的项目——只加你用得着的那几个。 |
| 栏宽 | 隐藏 | Standard · Wide · Full Width。 |
| 添加页边批注 | 隐藏 | 仅当页边批注 开启时出现在面板里。 |
GitHub 文档
直接从仓库读取的文档——经由链接、⌘K 或浏览中的仓库“位置” 打开。
| 项目 | 默认 | 作用 |
|---|---|---|
| 比较 | 显示 | 同一文档在另一分支上的版本,以渲染差异呈现。 |
| Blame | 显示 | 来自 GitHub API 的逐区块 blame。 |
| 大纲 | 显示 | 标题侧边栏。 |
| 共享 | 隐藏 | 文档的 github.com 页面——人真正想要的那个链接,绝不是 裸 URL。 |
| 重新载入 | 隐藏 | 把分支重新解析到当前最新提交并重新抓取。对钉在特定提交上 打开的文档保持禁用——并写明原因——因为那不可能再变。 |
| 源码 | 隐藏 | 原始 Markdown。 |
| 缩放项目 · 栏宽 | 隐藏 | 与本地文件相同。 |
拉取请求文件
| 项目 | 默认 | 作用 |
|---|---|---|
| PR 导航 | 显示 | 回到总览、上一个/下一个 Markdown 文件,以及 n/m 跳转菜单—— 一个整体,一次拖动。 |
| “显示” | 显示 | 渲染差异 · 源码差异 · 结果,居中。 |
| 大纲 | 显示 | 标题侧边栏。 |
| 布局 | 显示 | 内联或并排——在“渲染差异”视图中可用(新文件始终以内联方式 渲染)。 |
| Blame | 显示 | 在“结果”视图中可用——那里才有一份完成的文档可以注解。 |
| 评论文件 | 显示 | 针对文件整体、而非某一行的评论。 |
| 缩放项目 · 栏宽 | 隐藏 | 与本地文件相同。 |
PR 总览,以及从 PR 浏览的仓库文档
总览保持精简:共享(拉取请求的 GitHub 页面)加上 每个视图都有的项目。从 PR 内容浏览到的仓库文档带 Blame 和大纲,缩放项目和 栏宽收在它的面板里。