# 项目工具栏与布局

从顶部栏为项目命名、编译、导出和安排布局。

项目工具栏位于工作区上方。打开一个练习文档，用本指南认出每个操作。编辑器内部的格式按钮分别在 [LaTeX](/docs/writing/latex/)、[Typst](/docs/writing/typst/) 和 [Markdown](/docs/writing/markdown/) 的文档中介绍。

## 主页

![叶子标志用于返回项目库，项目名称就在它旁边。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=0,0,773,49)

选择左侧的**主页**可返回项目库。想继续工作时，从项目的书本图标或列表条目重新打开它。

## 项目名称

点击当前的项目名称即可编辑。输入一个有描述性的名称，然后按 Enter 或选择**保存名称**。按 Esc 或取消可保留原来的名称。项目名称用于在项目库中识别这项工作；重命名主源文件则是文件树里另外的操作。

## 源码视图

![三个视图按钮位于项目工具栏中间：源码、分屏，然后是 PDF。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=871,0,225,49)

选择**源码视图**，把主工作区交给文档编辑器。适合撰写长段落、编辑导言区，或查看完整的格式工具栏。

## 分屏视图

选择**分屏视图**，让源码和预览并排显示。拖动分隔线可以调整两个窗格各占多少空间。调整表格、公式或图片时很有用。

## PDF 视图

选择 **PDF 视图**，在主工作区中阅读编译输出。如果项目还没有预览，请先编译。用这种布局做完整的通读。

## 重新编译

![重新编译及其选项箭头后面是导出和版本管理控件。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=1265,0,337,49)

选择**重新编译**来构建当前项目。结果会显示在预览中，失败信息则出现在日志里。引擎决定源码如何变成 PDF。参见[选择文档引擎](/docs/engines/)和[编译](/docs/compiling/)。

使用内置 Tectonic 引擎编译时，如果遇到它无法完成的事，按钮左侧会出现**选择引擎**。它会打开[Tectonic 不够用时](/docs/latex-engines/#when-tectonic-isnt-enough)中介绍的引擎对话框。

## 编译选项

打开重新编译旁边的箭头，查看当前项目的编译选项。菜单只列出对该项目的引擎有实际作用的选项。

在 LaTeX 项目中，选择模板要求的编译器。想要内置的开箱即用方案，就用 Tectonic；需要传统 TeX 发行版时，就用 latexmk 编译器。提交之前，请让项目保持使用你测试过的编译器。

在 Typst 项目中，菜单里有**自动编译**（让 Typst 持续运行，并在你输入时刷新 PDF），还有 **Typst 版本（本项目）**、**字体（本项目）**、**构建（本项目）** 和**变体（本项目）**。安装其他 Typst 版本在**设置 → 引擎 → Typst** 中进行，Typst 能找到的字体列在[文档设置](/docs/document-settings/)里。[编译](/docs/compiling/)解释了每个选项。

## 导出

打开**导出**下载源码或编译结果。**导出源码 (.zip)** 会打包可编辑的项目文件；PDF 操作则保存可阅读的文档。转换类条目取决于引擎和文档类型。Word、HTML、文本、演示文稿和书籍的导出，请参考[导出格式](/docs/export/)。

## 复刻项目

选择**复刻项目**，基于当前项目创建另一个项目。输入一个说明用途的新名称，例如“论文，更短的摘要”。用这个副本尝试另一种方向，同时让原项目继续留在项目库中。

## 版本管理

打开**版本管理**，查看已保存的版本和恢复选项。[已保存的检查点](/docs/checkpoints/)记录成功的构建；[Git 历史](/docs/git-history/)记录由你控制的提交。请选择与想要恢复的内容相符的历史类型。

## 布局

![右侧依次是：布局、终端、浏览器、AI 助手、外观和设置。](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-editor-dark-window-v2.png#view=1588,0,330,49)

打开**布局**，从七种排列方式或禅模式中选择一种。布局决定显示哪些编辑器、预览和助手窗格，不会改变稿件。每种布局的图标会显示它打开三个窗格中的哪几个。

### 编辑器 + 预览 + AI

同时显示源码、编译后的页面和助手。适合集中修改后立即编译。在较小的显示器上，请拓宽你正在使用的窗格，或选择双窗格布局。

### 编辑器 + 预览

让源码和 PDF 并排显示。适合日常写作和版面调整。

### 编辑器 + AI

给源码和助手更多空间。适合讨论某一节、审阅建议的修改，或在重新打开 PDF 之前处理编译器错误。

### 预览 + AI

让渲染后的页面与助手并排显示。适合讨论尴尬的图片位置，或请支持页面图像的模型做一次视觉版面检查。

### 仅编辑器

把整个工作区用于编辑源码。这样可以同时显示更多工具栏控件，长行也更容易阅读。

### 仅预览

在更少干扰的情况下阅读成品文档。审阅时可以使用 PDF 搜索、文档大纲、页面导航和阅读视图。

### 仅 AI

把工作区交给助手。适合做规划或进行较长的研究对话，之后再重新打开源码检查产出的工作成果。

### 禅模式

隐藏工具栏、侧边栏、助手和终端，只留下编辑器。再按一次同一个快捷键，或按两次 Esc，就能把它们调回来。[禅模式](/docs/editor/#zen-mode)介绍了快捷键、角落里的编译按钮和相关选项。

## 终端

选择**显示终端**或按 Ctrl+`，显示项目的 shell。隐藏面板与关闭终端会话是两回事。标签页、命令和输出参见[终端](/docs/terminal/)。

你可以在**设置 → 键盘快捷键**中更改它的按键，按钮的提示会显示当前的按键。

## AI 助手

选择**显示 AI 助手**，打开或隐藏助手窗格。助手的模型、批准、附件、提示词和对话控件，在[聊天、计划与工具](/docs/ai-chat/)中介绍。

## 外观

用**外观**在写作时切换界面主题。字体、颜色、PDF 默认值和终端样式，请打开[外观设置](/docs/settings/appearance/)。

## 设置

选择齿轮图标，或按 ⌘,（Windows 和 Linux 上为 Ctrl+,），打开设置。[设置目录](/docs/settings/)把每个部分链接到它的控件和设置步骤。

## 编辑器工具栏上的文档工具

在项目工具栏下方，每个打开的文件都有自己的编辑器工具栏，对应 LaTeX、Typst 或 Markdown。文档工具位于它的右端：

- **LaTeX 宏包**或 **Typst 包**会搜索 CTAN 或 Typst Universe，并把包添加到文档中。参见[宏包与包](/docs/packages/)。
- **文档分析**会列出文档中的图、表、公式、标签、引用和待办事项。参见[文档分析](/docs/document-insights/)。
- **文档设置**可以更改纸张大小、页边距、字体、语言、行距和编号。参见[文档设置](/docs/document-settings/)。

**撤销**和**重做**位于该工具栏的起始位置附近，没有可撤销或重做的内容时呈灰色。其余部分在[编辑器指南](/docs/editor/#the-editor-toolbar)中介绍。

要全屏展示编译好的幻灯片，请使用预览工具栏上的**放映**。参见[放映幻灯片](/docs/present-slides/)。

## 在窄窗口中找到控件

工具栏会根据可用宽度自适应。编辑器工具栏无论在什么宽度下，都会把放不下的按钮移入**更多格式选项**（`…`），所以不会有按钮消失。预览控件有自己的溢出菜单。如果某个控件好像不见了，请打开溢出菜单或拓宽窗格；更改文档的视图永远不会移除它的功能。