Mr. Kin's Blog

计算机知识分享/软件应用讲解

博文离线下载 - PDF 及 LaTeX 源码

1   背景

本站一些重要的博文（例如软件手册或者系列文章汇总）会有对应的 PDF 及 LaTeX 源码，可以下载用以离线查看，一般都是在博文开头处有相关说明。PDF 文件发布在OpenDocs的latex2pdf页面，LaTeX 源码文件存放在 Github 的 OpenDocs 仓库。

2   获取 PDF 电子文档

PDF 电子文档主要发布在OpenDocs的latex2pdf页面，百度云和蓝奏云提供分流下载。PDF 和项目文件夹同名，直接下载即可。

3   获取 LaTeX 源码文件

LaTeX 源码文件可用以编译生成 PDF 文件，若不熟悉 LaTeX 语法的话，不推荐使用此方法。

LaTeX 源码文件存放在 Github 的 OpenDocs 仓库，在下载LaTeX源码文件之前，建议先了解一下仓库的存储结构。

3.1   OpenDocs 仓库存储结构

OpenDocs 仓库只提供文章源码（LaTeX）。

注：为缩减仓库大小，本仓库自 2021/6/28 起，不再提供电子格式文件（PDF）。PDF 文件将改由百度云网盘同步分享。

单个文档项目本身由一个含有 PDF 电子文档及其 LaTeX 源码的文件夹组成，均有其父分类。文件夹的名称就是该项目的名称，主文件名一般与文档项目名一致，即 PDF 电子文档和 LaTeX 源码主文件的文件名与文件夹名称相同。

例如名为 ToggleLanguage 文件夹所对应的项目名称就是 ToggleLanguage，位于名为 Manuals 的父文件夹下。其 PDF 电子文档和 LaTeX 源码的主文件名均为 ToggleLanuage。目录结构如下：

1
2
3
4
5
6
7
8
9
10
11
12
.
└── OpenDocs
    └── Manuals
        └── ToggleLanguage
            ├── resources
            │   ├── images
            │   │   ├── Installation.png
            │   │   ├── UI.png
            │   │   └── ...
            │   └── reference.bib
            ├── ToggleLanguage.pdf
            └── ToggleLanguage.tex

3.2   下载单个文件（推荐）

优点：可以找到所需单个文件夹或者单个文件进行下载，无需下载或克隆整个仓库。

下面以火狐浏览器为例，说明具体的下载步骤：

  1. 打开火狐浏览器。
  2. 安装浏览器插件 GitZip。
  3. 访问 OpenDocs 页面。
  4. 在所需的文件或者文件夹对应的空白处双击鼠标左键。
  5. 之后左侧会自动出现 √ 符号，如图 1 所示。
  6. 点击右下角的箭头图标，GitZip 会拉取文件。
  7. GitZip 插件成功拉取文件后，记得保存文件到本地，如图 2 所示。
图 1: 下载步骤
图 2: 保存文件

3.3   下载整个仓库

浏览器下载仓库的 ZIP 压缩包不会包含 .git 文件夹（即不包含 git 历史），Git 克隆方式则会完整克隆仓库。

3.3.1   通过浏览器下载仓库（推荐）

  1. 打开浏览器。
  2. 访问 OpenDocs 页面。
  3. 点击「Code」图标上，如图 3 所示。
  4. 点击「Download ZIP」，下载整个仓库的 ZIP 压缩包。
  5. 保存压缩包到本地即可。
图 3: 浏览器下载和 Git 克隆仓库

3.3.2   用过 Git 克隆完整仓库（确保系统已经安装了 Git 程序）

  1. 打开浏览器。
  2. 访问 OpenDocs 页面。
  3. 点击「Code」图标上，如图 3 所示。
  4. 复制克隆操作所需的 HTTPS 链接：https://github.com/Mister-Kin/OpenDocs.git
  5. 运行 Git Bash，切换当前目录到所需保存的路径，输入 git clone https://github.com/Mister-Kin/OpenDocs.git。
  6. 在保存路径上会生成一个 OpenDocs 文件夹。

R.I.P