本项目是 2014 年第一财经周刊专题「值得你阅读的100本书」的 Markdown 制书复刻。原始内容来自周刊网站，由 Conan Xin 整理为可编译的 Markdown 源码，并生成 PDF 小册子。
- 原始专题：第一财经周刊 · 值得你阅读的100本书
- 整理者：Conan Xin
- 源码仓库：https://github.com/conanxin/2014books
本项目已从原始的单一脚本构建升级为支持多种输出格式：
- PDF：通过
pandoc+xelatex生成排版精美的中文 PDF - 静态网页：通过 Python 标准库生成可离线浏览的杂志风格静态网页，支持搜索和筛选
- EPUB：通过
pandoc生成电子书，兼容主流阅读器
Web 输出已升级为杂志风格阅读体验，包含：
- 封面区（Hero Masthead）：杂志式标题、导语、状态 badge、阅读入口
- 编者序（Editor's Note）：项目背景说明、97 本事实、缺失 3 本需核对
- 精选章节（Featured Chapters）：4~6 篇代表章节的大卡片，快速进入精彩内容
- 章节目录（Chapters Archive）：45 章完整目录，含章节摘要，点击标题进入独立章节页
- 阅读路线（Reading Paths）：按主题分类的阅读路线，不必按顺序读完 45 章
- 书目检索（Book Archive）：正式 97 本书目，支持按书名/作者实时搜索
- 研究附录（Research Appendix）：待核实候选书目，明确隔离于正式书单
- 完整正文（Full Text）：按章节顺序呈现全部正文内容
设计特点：暖白纸张底色、衬线标题字体、充足留白、轻量卡片阴影、响应式布局。无外部 CDN，纯静态文件，可离线使用。
每章拥有独立 URL，支持：
- 独立章节页：
web/chapters/chapter-01.html~chapter-45.html - 阅读进度条：顶部固定进度条，随滚动实时更新
- 阅读模式：A-/A+ 字号调节、纸张/夜间模式切换，偏好保存到 localStorage
- 移动端目录：目录按钮打开侧滑 drawer，列出 45 章，点击跳转
- 上一章/下一章：章节页底部导航
- OG 分享信息：每章独立 og:title / og:description，支持社交媒体卡片分享
- 返回首页：章节页顶部始终有返回首页链接
首页的精选章节和章节目录链接已优先指向独立章节页，同时保留锚点 fallback。
仓库已配置 GitHub Actions 工作流，支持 push 到 master 时自动部署到 GitHub Pages。
- 启用方式：仓库 Settings → Pages → Source: GitHub Actions
- 手动触发：Actions 标签页 → Deploy to GitHub Pages → Run workflow
- 预期地址：https://conanxin.github.io/2014books/
详见 docs/GITHUB_PAGES_DEPLOYMENT.md。
sudo apt-get install pandoc texlive-xetex texlive-latex-recommended texlive-latex-extra
sudo apt-get install fonts-noto-cjk fonts-wqy-microhei fonts-wqy-zenhei# 生成 PDF
make pdf
# 生成静态网页
make web
# 生成 EPUB
make epub
# 生成 release package（zip）
make release
# 同时生成所有输出
make all
# 清理构建产物
make cleanbash ./mmd2bok2014books/
├── contents/ # Markdown 源文件（章节内容）
│ ├── 0-preface*.markdown
│ ├── 1-chapter*.markdown
│ └── 2-appendix*.markdown
├── data/ # 书目元数据增强（人工/半人工入口）
│ ├── book_metadata_overrides.json
│ ├── missing_book_candidates.json
│ └── reading_paths.json
├── template/ # LaTeX 模板文件
├── latex/ # LaTeX 构建工作目录
├── scripts/ # 现代构建脚本
│ ├── build_pdf.sh # PDF 构建入口
│ ├── build_epub.sh # EPUB 构建入口
│ ├── generate_web.py # 静态网页生成器
│ └── package_release.sh # Release package 打包
├── web/ # 生成的静态网页输出
│ ├── index.html
│ ├── .nojekyll
│ ├── assets/
│ │ ├── style.css
│ │ └── og-cover.svg
│ ├── data/books.json
│ └── chapters/ # 独立章节页（Phase F）
│ ├── chapter-01.html
│ └── ...
├── dist/ # 生成的 PDF/EPUB/Release 输出
│ ├── 2014books.pdf
│ ├── 2014books.epub
│ └── release/
├── .github/workflows/ # CI/CD 工作流
│ ├── build.yml
│ └── pages.yml
├── mmd2bok # 传统 PDF 构建脚本（已修复章节排序）
├── Makefile # 现代构建入口
└── README.md # 本文件
- 书单完整性：当前已从附录结构化整理 97 本 书目。项目标题中的"100本"为原始专题名称，实际可验证数量为 97 本，剩余 3 本需对照原始《第一财经周刊》专题进一步核对。缺失候选已单独记录在
data/missing_book_candidates.json，不会自动进入正式书单。 - PDF 字体依赖：需要系统中安装 WenQuanYi 或 Noto CJK 系列中文字体，否则 xelatex 编译可能失败。模板已添加字体回退链。
- 封面图片：模板支持
img/cover.pdf封面；若缺失则自动生成文字封面。 - 网页搜索：静态网页的搜索功能为前端 JavaScript 实现，无需后端服务，但仅支持当前页面已加载的内容。
- 章节排序：已修复原始脚本中
1-chapter10排在1-chapter2之前的排序问题。
data/book_metadata_overrides.json：人工/半人工增强元数据入口。用id匹配附录书目，非 null 字段覆盖或补充生成字段。data/missing_book_candidates.json：低置信度缺失候选池，不进入正式books.json。
- Phase G：增强书籍元数据（ISBN、出版社等）；优化封面设计；添加更多阅读路线。
原始 README 历史背景保留：本项目最初创建于 2014 年，用于尝试使用 Markdown 写书。最初使用 multimarkdown 工具链，后因安装问题改为 pandoc。2024 年进行现代化升级，增加了网页版本和 Makefile 构建入口。