QUANTAXIS QABook - LaTeX文档系统
版本: 2.1.0-alpha2 更新日期: 2025-10-25 作者: @yutiansut @quantaxis
📚 简介
QABook是QUANTAXIS的完整LaTeX技术文档，涵盖量化交易的理论基础、实践应用和系统架构。使用XeLaTeX编译器生成高质量PDF文档，支持中文排版和数学公式。
文档内容
QABook包含以下主要章节：
前言 - QUANTAXIS发展历程和设计思想
环境准备 - 开发环境配置
数据 - 数据获取和管理
分析 - 数据分析方法
交易 - 交易系统实现
可视化 - 数据可视化技术
基础知识 - 数学和统计学基础
凸优化
矩阵理论
随机矩阵理论
协方差矩阵
参数估计
常见分布
现代资产管理理论 - 投资组合理论
组合管理优化 - 优化策略和注意事项
主动组合管理 - 主动投资管理方法
风险补偿与期权定价 - 衍生品定价理论
过拟合问题 - 机器学习中的过拟合处理
🚀 快速开始
方法1: 使用编译脚本 (推荐)
# 进入qabook目录
cd qabook/
# 编译PDF
bash build.sh
# 清理临时文件
bash build.sh clean
# 监控模式（文件变更自动重新编译）
bash build.sh watch方法2: 手动编译
cd qabook/
# 编译三次以生成完整的目录和交叉引用
xelatex quantaxis.tex
xelatex quantaxis.tex
xelatex quantaxis.tex📦 环境准备
LaTeX发行版安装
QABook需要完整的TeX Live发行版，包含中文字体和各种宏包。
Linux (Ubuntu/Debian)
# 安装完整的TeX Live
sudo apt-get update
sudo apt-get install texlive-full
# 或者安装基础版本 + 中文支持
sudo apt-get install texlive-base texlive-latex-extra \
texlive-xetex texlive-lang-chinese texlive-fonts-recommendedmacOS
# 使用Homebrew安装MacTeX
brew install --cask mactex
# 或下载完整安装包
# https://www.tug.org/mactex/Windows
下载TeX Live ISO: https://www.tug.org/texlive/acquire-iso.html
或使用MiKTeX: https://miktex.org/download
安装时选择"完整安装"以包含所有宏包
验证安装
# 检查XeLaTeX版本
xelatex --version
# 应该输出类似：
# XeTeX 3.141592653-2.6-0.999995 (TeX Live 2024)📁 文件结构
qabook/
├── quantaxis.tex # 主LaTeX文档
├── qalogo.png # QUANTAXIS Logo
├── build.sh # 编译脚本
├── README.md # 本文档
└── quantaxis.pdf # 生成的PDF（编译后）✍️ 编辑文档
LaTeX编辑器推荐
跨平台编辑器:
VS Code + LaTeX Workshop插件 (推荐)
TeXstudio - 功能完整的LaTeX IDE
Overleaf - 在线LaTeX编辑器
VS Code配置:
{
"latex-workshop.latex.recipes": [
{
"name": "XeLaTeX",
"tools": ["xelatex", "xelatex", "xelatex"]
}
],
"latex-workshop.latex.tools": [
{
"name": "xelatex",
"command": "xelatex",
"args": [
"-synctex=1",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%"
]
}
]
}文档结构
导言区 (Preamble)
\documentclass{scrartcl} % 文档类
\usepackage[UTF8]{ctex} % 中文支持
\usepackage{amsmath, amssymb} % 数学公式
\usepackage{graphicx} % 图片支持
\usepackage{pythonhighlight} % Python代码高亮
\usepackage{hyperref} % 超链接章节组织
\section{章节标题}
\subsection{小节标题}
\subsubsection{子小节标题}数学公式
% 行内公式
$E = mc^2$
% 行间公式
\begin{equation}
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
\end{equation}
% 矩阵
\begin{bmatrix}
a & b \\
c & d
\end{bmatrix}Python代码
\begin{python}
import QUANTAXIS as QA
account = QA.QA_Account()
account.receive_simpledeal(...)
\end{python}图片插入
\begin{figure}[h]
\centering
\includegraphics[width=0.8\textwidth]{image.png}
\caption{图片标题}
\label{fig:label}
\end{figure}🔧 常见问题
Q1: 编译失败 "! LaTeX Error: File 'xxx.sty' not found"
原因: 缺少LaTeX宏包
解决:
# Linux
sudo apt-get install texlive-latex-extra
# macOS
sudo tlmgr install <package-name>
# Windows (MiKTeX)
# 使用MiKTeX Package Manager安装缺失的包Q2: 中文显示为方框或乱码
原因: 缺少中文字体或ctex配置问题
解决:
# Linux - 安装中文字体支持
sudo apt-get install texlive-lang-chinese
sudo apt-get install fonts-wqy-microhei fonts-wqy-zenhei
# 或在文档中指定字体
\setCJKmainfont{WenQuanYi Micro Hei}Q3: 编译速度很慢
原因: 文档较大，多次编译耗时
优化:
使用
build.sh脚本，自动处理多次编译开发时注释掉部分章节加快编译
使用
latexmk自动化工具
Q4: 如何只编译部分章节？
方法1: 注释掉不需要的章节
% \section{不需要的章节}
% ...方法2: 使用\include和\includeonly
% 导言区
\includeonly{chapter1,chapter3}
% 正文
\include{chapter1}
\include{chapter2} % 不会被编译
\include{chapter3}Q5: PDF中的超链接不工作
检查: hyperref包的配置
\usepackage[colorlinks, linkcolor=black,
anchorcolor=black, citecolor=black]{hyperref}📊 文档规范
命名规范
章节标签:
\label{sec:section-name}图片标签:
\label{fig:figure-name}公式标签:
\label{eq:equation-name}表格标签:
\label{tab:table-name}
引用规范
如\ref{sec:intro}所示...
参见图\ref{fig:architecture}...
根据公式\ref{eq:variance}...代码规范
Python代码使用
pythonhighlight环境添加注释说明代码功能
保持代码简洁，避免过长的代码块
数学公式规范
重要公式使用
equation环境并编号简单公式可使用
$...$行内公式矩阵、向量使用粗体表示
🌐 GitHub Actions自动编译
项目已配置GitHub Actions自动编译PDF：
触发条件
推送到
master分支qabook/目录有更新手动触发
工作流程
✅ 安装TeX Live
✅ 编译
quantaxis.tex✅ 上传PDF到Release
✅ 自动标记版本
下载编译好的PDF
访问项目的Releases页面下载最新编译的PDF。
🛠️ 高级技巧
使用latexmk自动化编译
# 安装latexmk
sudo apt-get install latexmk
# 创建.latexmkrc配置文件
cat > .latexmkrc << 'EOF'
$pdf_mode = 5; # XeLaTeX模式
$xelatex = 'xelatex -interaction=nonstopmode -synctex=1 %O %S';
$out_dir = 'build';
EOF
# 编译
latexmk quantaxis.tex
# 持续监控模式
latexmk -pvc quantaxis.texPDF优化
# 压缩PDF大小
gs -sDEVICE=pdfwrite -dCompatibilityLevel=1.4 \
-dPDFSETTINGS=/ebook -dNOPAUSE -dQUIET -dBATCH \
-sOutputFile=quantaxis_compressed.pdf quantaxis.pdf转换为Word格式
# 使用pandoc转换
sudo apt-get install pandoc
pandoc quantaxis.tex -o quantaxis.docx📚 LaTeX参考资源
官方文档
中文资源
在线工具
Overleaf - 在线LaTeX编辑器
Detexify - 手写识别LaTeX符号
Tables Generator - 表格生成器
常用宏包文档
🤝 贡献指南
欢迎改进QABook文档！
贡献步骤
Fork本仓库
创建分支:
git checkout -b docs/improve-qabook编辑
quantaxis.tex本地编译测试:
bash build.sh提交PR
注意事项
保持现有的文档结构和风格
添加必要的数学推导和公式
提供代码示例和实际应用场景
确保编译无错误和警告
📝 版本历史
v2.1.0 (2025-10-25)
✅ 优化LaTeX文档配置
✅ 添加自动编译脚本
✅ 创建完整使用指南
✅ 配置GitHub Actions自动发布
✅ 整合到文档系统
v2.0.0
初始LaTeX文档
包含量化交易理论基础
数学和统计学基础知识
维护者: @yutiansut @quantaxis 最后更新: 2025-10-25
Last updated
Was this helpful?