跳到主要内容

常用设置项

1. 引言​

欢迎使用 LoongTeX。为了满足不同科研场景下的写作习惯，我们提供了灵活的配置选项。本指南旨在帮助您理解各项设置的功能与适用场景，以平衡编辑体验、系统性能与学术规范性。

设计理念：LoongTeX 的设置遵循“开箱即用，按需定制”的原则。默认配置已针对大多数学术写作场景进行优化，建议仅在特定需求下调整。

2. 编辑器体验 (Editor Experience)​

此类设置主要影响代码编辑区域的交互与视觉反馈。

2.1 选项卡栏 (Tab Bar)​

  • 功能描述：控制编辑器顶部是否显示文件选项卡。
  • 适用场景：
    • 开启：推荐开启。适用于多文件项目（如主 .tex 文件与多个 \input 子文件），方便快速切换。
    • 关闭：适用于单文件笔记或极简模式，可节省垂直屏幕空间。
  • 默认状态：开启

2.2 拆分编辑器 (Split Editor)​

  • 功能描述：允许将编辑区域拆分为左右或上下两个视图，支持同时编辑不同文件或同一文件的不同部分。
  • 适用场景：
    • 开启：撰写长篇论文时，可左侧查看参考文献/定义，右侧撰写正文；或同时编辑两个相关章节。
    • 关闭：单屏专注写作。
  • 默认状态：关闭（可按需激活）

2.3 小地图 (Minimap)​

  • 功能描述：在编辑器右侧显示代码结构的缩略图，支持快速跳转。
  • 适用场景：
    • 开启：适用于超过 500 行的长文档，便于宏观把握章节结构。
    • 关闭：短文档或低分辨率屏幕下，关闭可减少视觉干扰并略微提升渲染性能。
  • 默认状态：开启

2.4 拼写检查 (Spell Check)​

  • 功能描述：对英文文本内容进行自然语言拼写纠错。
  • 适用场景：
    • 开启：撰写英文论文时强烈推荐，可避免基础拼写错误。
    • 关闭：编写代码片段、命令定义或非自然语言内容时，可避免误报。
  • 默认状态：开启

2.5 语法检查 (Syntax Check)​

  • 功能描述：针对 LaTeX 语法的静态分析（如括号匹配、命令拼写、环境闭合）。
  • 适用场景：
    • 开启：强烈建议常开。这是防止编译错误的第一道防线。
    • 关闭：仅在编辑器卡顿严重且确认为语法检查引擎导致时临时关闭。
  • 默认状态：开启

3. 预览与编译 (Preview & Compilation)​

此类设置涉及 LaTeX 编译引擎的行为及 PDF 预览的交互。

3.1 自动编译 (Auto Compile)​

  • 功能描述：文本编辑后自动触发后台编译任务。
  • 适用场景：
    • 开启：日常写作，可实时查看修改效果。
    • 关闭：大型项目（如百页以上书籍）或网络不稳定时。频繁自动编译可能占用服务器资源并导致队列拥堵。
  • 性能提示：关闭后需手动点击“编译”按钮。
  • 默认状态：关闭

3.2 编译日志 (Compile Logs)​

  • 功能描述：显示 LaTeX 编译器（如 XeLaTeX, PDFLaTeX）的标准输出与错误信息。
  • 适用场景：
    • 开启：编译失败时必须开启，用于定位错误行号与原因（如 Missing $, Undefined control sequence）。
    • 关闭：编译正常时可隐藏，保持界面整洁。
  • 默认状态：仅在编译错误时自动展开，或手动开启

3.3 PDF 滚动模式 (PDF Scroll Mode)​

  • 功能描述：控制 PDF 预览窗口的滚动行为。
  • 选项：
    • 连续滚动 (Continuous)：类似网页，适合快速浏览。
    • 分页滚动 (Paginated)：严格按页码翻页，适合校对版式。
  • 默认状态：连续滚动

3.4 PDF 自动跟随主题 (PDF Auto-follow Theme)​

  • 功能描述：PDF 预览器的背景色与文字颜色是否随 LoongTeX 全局主题（深色/浅色模式）自动切换。
  • 适用场景：
    • 开启：夜间写作时保护视力，保持界面色调一致。
    • 关闭：需要严格核对打印效果（通常为白底黑字）时。
  • 默认状态：开启

4. 智能辅助 (AI & Assistance)​

4.1 AI 自动续写 (AI Auto-completion)​

  • 功能描述：基于上下文，利用 LLM 模型提供 LaTeX 代码或学术文本的续写建议。
  • 适用场景：
    • 开启：灵感枯竭、需要生成模板代码（如表格、公式）或润色段落时。
    • 关闭：对数据隐私极度敏感，或希望完全手动控制内容时。
  • 注意事项：
    • AI 生成内容需人工复核，尤其是参考文献与数学公式。
    • 开启此项会增加网络请求，弱网环境下可能影响输入流畅度。
  • 默认状态：关闭（需用户主动确认开启）

5. 开发者建议与最佳实践​

作为 LoongTeX 的开发团队，基于 Django/FastAPI 后端架构与前端性能测试，我们提供以下配置组合建议：

场景推荐配置组合理由
日常论文撰写自动编译：开
语法检查：开
小地图：开
选项卡：开		平衡实时反馈与导航效率，最适合 90% 的用户。
大型书籍/ thesis自动编译：关
小地图：开
拆分编辑器：开		减少服务器编译压力，利用拆分窗口管理复杂结构。
调试编译错误编译日志：开
拼写检查：关
AI 续写：关		聚焦错误信息，排除其他干扰项，节省资源用于编译。
沉浸式写作选项卡：关
小地图：关
主题跟随：开		最大化编辑区域，减少视觉噪点。

性能与资源说明​

  1. 自动编译：在并发高峰期，若开启自动编译导致响应变慢，建议暂时关闭，改为手动触发。
  2. AI 功能：AI 续写依赖外部 API 网关，若遇到超时，请检查网络连接或暂时关闭该功能。
  3. 本地存储：您的设置项将保存在用户配置表（User Preferences）中，更换设备登录后可同步。

6. 故障排查​

如果修改设置后未生效，请尝试以下操作：

  1. 刷新页面：部分前端配置需要重新加载资源。
  2. 清除缓存：在浏览器设置中清除 LoongTeX 站点的本地缓存。
  3. 检查控制台：按 F12 打开开发者工具，查看 Console 是否有报错（如 403 Forbidden 或 500 Internal Server Error），如有，请截图联系技术支持。

LoongTeX —— 让科研更好地发生
FOR TRUTH AND BEAUTY

最后更新 2026-3-11 15:04:41