README.md

# 项目名称：冷杉（fir）

## 开发与验证环境
Ubuntu 20.04

其他环境下能否正常运行，未测试过。

## 介绍
本项目是LuaLaTeX辅助工具集，目前包含封面生成工具。

## 使用方法
1. 克隆本项目文件后，建议在LaTeX默认宏包、类搜索目录中创建本宏包的软链接。此目录在Ubuntu下为：~/texmf/tex/latex/commonstuff/。通常情况下是不存在的，需要自己创建。
2. 在需要使用本宏包的LaTeX项目所在文件夹内，创建fir项目文件夹的软链接。
3. 安装方正免费字体：包括方正仿宋、方正书宋、方正黑体与方正楷体4种字体；安装站酷免费字体：包括站酷仓耳渔阳体、站酷庆科黄油体、站酷文艺体、站酷小薇LOGO体、站酷酷黑体、ZCOOL Addict Italic（英文字体）、站酷快乐体、站酷高端黑体，共8种字体。这些字体都是官方免费提供下载，并可直接商用。
4. 注意目前模板中调用的图片文件，默认为项目所在目录下images文件夹中的cover.png与logo.png两个文件。请在使用前把需要的图片名称修改掉。

## 封面生成工具使用示例
```tex
% ------------------ 封面 -------------------
\begin{titlepage}
  \CreateCover[
    'PGColor': 'MintCream',
    'TitleOne': '某某某某某某项目',
    'TitleTwo': '某某某书',
    'IntroOne': '\\\\简要介绍，简要介绍，简要介绍，简要介绍，简要介绍，简要介绍。',
    'OrgOne': '某某公司',
    'OrgTwo': 'XXXXXXX XXXXXXX',
    'IntroTwo': 'XXXX：XXXXXXX\\\\XXXX：XXXXXXXXXX\\\\XXXX：XXXXXXXXXX'
  ]{1}
\end{titlepage}
```