2014年值得你阅读的100本书

项目简介

本项目是 2014 年第一财经周刊专题「值得你阅读的100本书」的 Markdown 制书复刻。原始内容来自周刊网站，由 Conan Xin 整理为可编译的 Markdown 源码，并生成 PDF 小册子。

项目来源

• 原始专题：第一财经周刊 · 值得你阅读的100本书
• 整理者：Conan Xin
• 源码仓库：https://github.com/conanxin/2014books

现在可以生成 PDF、Web 和 EPUB

本项目已从原始的单一脚本构建升级为支持多种输出格式：

• 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，纯静态文件，可离线使用。

独立章节页（Phase F）

每章拥有独立 URL，支持：

• 独立章节页：web/chapters/chapter-01.html ~ chapter-45.html
• 阅读进度条：顶部固定进度条，随滚动实时更新
• 阅读模式：A-/A+ 字号调节、纸张/夜间模式切换，偏好保存到 localStorage
• 移动端目录：目录按钮打开侧滑 drawer，列出 45 章，点击跳转
• 上一章/下一章：章节页底部导航
• OG 分享信息：每章独立 og:title / og:description，支持社交媒体卡片分享
• 返回首页：章节页顶部始终有返回首页链接

首页的精选章节和章节目录链接已优先指向独立章节页，同时保留锚点 fallback。

GitHub Pages 自动部署

仓库已配置 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。

本地构建方法

依赖安装（Ubuntu/Debian）

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 clean

传统入口（兼容旧用法）

bash ./mmd2bok

项目结构

2014books/
├── 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          # 本文件

已知限制

1. 书单完整性：当前已从附录结构化整理 97 本 书目。项目标题中的"100本"为原始专题名称，实际可验证数量为 97 本，剩余 3 本需对照原始《第一财经周刊》专题进一步核对。缺失候选已单独记录在 data/missing_book_candidates.json，不会自动进入正式书单。
2. PDF 字体依赖：需要系统中安装 WenQuanYi 或 Noto CJK 系列中文字体，否则 xelatex 编译可能失败。模板已添加字体回退链。
3. 封面图片：模板支持 img/cover.pdf 封面；若缺失则自动生成文字封面。
4. 网页搜索：静态网页的搜索功能为前端 JavaScript 实现，无需后端服务，但仅支持当前页面已加载的内容。
5. 章节排序：已修复原始脚本中 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 构建入口。