Skip to content

Home

Jump to bottom
Keldos edited this page Mar 22, 2023 · 5 revisions

Typora LaTeX Theme 帮助文档

本项目是一个 markdown 主题，目标是轻松地让您将用 markdown 撰写的报告与论文用看起来像 LaTeX 风格的样式导出。需要说明的是，预设的风格基本采用了浙江大学要求的格式（字体较小，页边距较小），但您可以自行在 CSS 中修改适合自己学校的格式。

以下内容仅仅是一些精简的描述。如果您想了解更多细节，请您点击相关的超链接。

安装

参见：安装教程

  1. 安装本主题前，请确保您已经安装 Typora. 如果您不清楚 Typora 是什么，这里有一段介绍。如果您对 markdown 的语法还不了解，您可以从这里获得帮助。

  2. 前往本项目的 release 页面，然后下载适合您操作系统的最新版本压缩包。比如，如果您在使用 Windows 操作系统，您就应该下载 latex-theme-windows.zip.

  3. 解压缩这个文件，并进入解压缩后的文件夹。在这个文件夹中，用 Typora 打开 README.md，并按照其中的描述完成剩余步骤。简单而言，需要进行如下几步：

    1. 进行手动或自动主题安装
    2. 若遇到字体问题，则下载所需的字体

个性化设置

参见：个性化设置

在完成安装后，您可以选择按照学校的要求或自己的喜好，对主题个性化设置。在 CSS 文件中，您可以根据代码中的注释提示修改变量取值，轻松地更换正文、标题等不同元素的字体、字号、行距、页边距等。您也可以考虑使用我们提供的封面模板，或者手动取消额外行距。

更新主题

很抱歉，目前我们没有为主题提供热更新机制。如果您已经对主题文件进行过个性化设置，在更新主题时，您可能需要：

  1. 备份原本的 CSS 文件（例如，将 latex.css 重命名为 latex-old.css）；
  2. 安装新的主题文件；
  3. 参照您原先所做的个性化设置重新设置一遍新的主题文件。

不过，您可能已经注意到，我们已经将主要的个性化设置的变量放置在

@charset "UTF-8";
:root {
  /* == 字体设置 == */
  /* 基准字体 */
  /* 超链接颜色 */
  ……（其他设置）
  ……（其他设置）
  --link-color-dark: #8bb1f9;
}

主题文件的最前面。因此，对大部分普通用户来说，您只需要关注最前面（约前70行）代码中您做过的改动即可。

反馈与贡献

参见：贡献指南

如果您在使用过程中遇到任何问题，或想为本项目做出任何贡献，请优先考虑：

  • 前往 GitHub Discussions 发起讨论
  • 前往 GitHub Issues 报告故障
  • 前往 GitHub Issues 请求新功能
  • 如果您希望在本地修改这个项目的代码，推荐您在 fork 后使用 git clone ${target} --depth 1 进行克隆。这是因为，本仓库的历史中有大量二进制文件，而这些二进制文件对当前开发并无作用，可以舍弃。设置较浅的克隆深度可帮助您更快地获取到此项目的最新代码。在完成您的修改后，请向我们的 develop 分支提出拉取请求。

如果以上方法都行不通，您也可以考虑：

Clone this wiki locally