blog-source

Thoughts, essays, and code from my journey to pursue freedom and truth.

Statistics

File Type	Count
Python files (scripts, excluding ml)	323
Python files (scripts/ml)	191
Python test files (tests)	23
C files (c)	1
Rust files (rust)	3
C++ files (cpp)	2
Markdown files (original)	515
Notes files (notes)	1992

Key Improvements

This blog incorporates several enhancements compared to a standard Jekyll blog using the jekyll-theme-cayman:

• AI-Powered Translation: Leverages advanced language models for accurate and contextually relevant translations, expanding content accessibility to a global audience.
• XeLaTeX PDF Generation: Integrates XeLaTeX to produce high-quality, print-ready PDFs for offline reading and sharing.
• Google Cloud Text-to-Speech: Utilizes Google Cloud's Text-to-Speech service to generate audio versions of posts, improving accessibility for visually impaired users and those who prefer audio content.
• Enhanced CSS Styling: Features a refined and custom CSS design for a visually appealing and user-friendly experience.
• MathJax Support: Implements MathJax for rendering complex mathematical expressions and equations, making technical content more accessible.
• Night Mode: Includes a night mode option to reduce eye strain and improve readability in low-light conditions.
• Flexible Post Selection: Offers various post selection options, such as filtering by category or tag, to enhance navigation.
• Regular Updates: Ensures the blog's library and dependencies are up-to-date for optimal performance and security.
• awesome-cv Integration: Uses awesome-cv to generate professional CVs directly from the blog.
• RSS Feed Support: Provides RSS feeds via feed.xml, allowing users to subscribe to the blog.
• Bilingual Content: Supports both Chinese and English content to cater to a diverse audience.
• GitHub Workflow Automation: Implements GitHub Actions for automated building, testing, and deployment, ensuring a streamlined development process.
• Automatic Translation Workflow: Automatically translates new or updated posts into multiple languages using GitHub Actions.
• EPUB Support: Converts Markdown to EPUB for ebook readers.

Getting Started

To set up a local Jekyll environment, follow these steps:

gem install jekyll bundler

jekyll new myblog

cd myblog

bundle install

bundle exec jekyll serve

bundle exec jekyll serve --incremental

bundle exec jekyll serve --draft

bundle exec jekyll serve

bundle add webrick

jekyll serve

Markdown Styling

To customize syntax highlighting, use rougify:

rougify help style

rougify style github > _sass/syntax.css

rougify style gruvbox.dark > _sass/syntax.css

rougify style base16.monokai.dark > _sass/syntax.css

Audio and PDF Pipelines

To generate audio and PDF files, use the following commands:

conda activate google-cloud-env

python scripts/audio_pipeline.py --task posts --n 10

python scripts/audio_pipeline.py --task pages

python scripts/audio_pipeline.py --task notes

python scripts/audio_pipeline.py --task notes --n 100

python scripts/pdf_pipeline.py --task pages

python scripts/pdf_pipeline.py --task posts --n 10

python scripts/pdf_pipeline.py --task notes

python scripts/generate_notes_link.py

python scripts/auto-ss-config/upload_configs.py

python scripts/epub_book.py notes

python scripts/epub_book.py _posts/en

python scripts/epub_book.py _posts/ja

python scripts/update_lang.py --file original/2025-02-02-archlinux-en.md --lang ja  --model gemini

Scripts

To create a new draft post, use:

python scripts/draft.py <name>

Content Guide

• -en: Denotes English posts.
• -zh: Denotes Chinese posts.

The _posts and pages directories support both -en and -zh suffixes.

The notes directory primarily contains English content for personal learning purposes and does not require translations.

Reference

Syntax Highlighting with Jekyll