Skip to content

Add magazine reading system for 2014books - #5

Merged
conanxin merged 3 commits into
masterfrom
phase/2014books-reading-system-f
Jun 7, 2026
Merged

conanxin merged 3 commits into
masterfrom
phase/2014books-reading-system-f

Conversation

@conanxin

@conanxin conanxin commented Jun 7, 2026

Copy link
Copy Markdown
Owner

Summary

This PR upgrades the 2014books website from a single-page magazine-style archive into a more complete digital reading system.

What changed

  • Added 45 standalone chapter pages under web/chapters/
  • Added chapter-level reading progress bars
  • Added reading controls: A-, A+, paper mode, and night mode
  • Added mobile chapter drawer navigation
  • Added previous / next chapter navigation
  • Added data/reading_paths.json with initial reading routes
  • Added reading route cards to the homepage
  • Added OG / social sharing metadata and web/assets/og-cover.svg
  • Improved the book archive with clearer confidence and source indicators
  • Updated generate_web.py to generate both homepage and standalone chapter pages
  • Updated README and added Phase F design/report documentation
  • Updated .gitignore to exclude generated release packages

Validation

  • python3 -m py_compile scripts/generate_web.py PASS
  • python3 scripts/generate_web.py PASS
  • make web PASS
  • make epub PASS
  • make pdf PASS
  • Release artifacts were intentionally removed from Git tracking after cleanup

Notes

This PR does not change the verified book count. The official structured book list remains at 97 verified entries. Low-confidence missing-book candidates remain isolated outside the official books.json.

@conanxin
conanxin merged commit ce4e3e7 into master Jun 7, 2026
2 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0893052241

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/generate_web.py
prev_link = f'<a href="chapter-{prev_ch["chapter_num"]:02d}.html">← 上一章</a>' if prev_ch else '<span></span>'
next_link = f'<a href="chapter-{next_ch["chapter_num"]:02d}.html">下一章 →</a>' if next_ch else '<span></span>'

og_image = "https://conanxin.github.io/2014books/assets/og-cover.svg"

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Use a raster image for social cards

When these pages are shared on X/Twitter, the card image is pulled from og:image because no twitter:image is set, but the X Cards markup docs list JPG/PNG/WEBP/GIF as supported and explicitly say SVG is not supported. Since this new sharing feature points every chapter card at an SVG, the large-image preview can render without an image on that platform; generate/reference a PNG or JPG version for the OG/Twitter image instead.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant