lzwjava.github.io
これは https://github.com/lzwjava/lzwjava.github.io の GitHub プロジェクトからの README.md です。
lzwjava.github.io
私の個人ブログへようこそ!ここでは、さまざまなトピックについての私の考え、経験、知識を共有します。
主要な改善点
このブログは、標準的な Jekyll ブログ(jekyll-theme-cayman を使用)に比べていくつかの向上点を含んでいます:
- AI駆動型の翻訳: 高度な言語モデルを活用して、正確で文脈に適した翻訳を行い、コンテンツのアクセス性を世界中の読者に拡大します。
- XeLaTeX PDF 生成: 高品質で印刷可能な PDF をオフラインで読むためと共有するために、XeLaTeX を統合します。
- Google Cloud テキスト読み上げ: Google Cloud のテキスト読み上げサービスを利用して、ポストのオーディオバージョンを生成し、視覚障害者や音声コンテンツを好む人々のアクセス性を向上させます。
- 強化された CSS スタイリング: 視覚的に魅力的でユーザーフレンドリーな体験を提供するための精製されたカスタム CSS デザインを特徴としています。
- MathJax サポート: 数学的に複雑な式や方程式をレンダリングするために MathJax を実装し、技術的なコンテンツのアクセス性を高めます。
- ナイトモード: 眼の疲れを軽減し、低光条件での読みやすさを向上させるナイトモードオプションが含まれています。
- 柔軟な投稿選択: カテゴリーやタグでフィルターするなど、さまざまな投稿選択オプションを提供して、ナビゲーションを強化します。
- 定期的な更新: ブログのライブラリと依存関係が最新の状態で、最適なパフォーマンスとセキュリティを確保します。
awesome-cv
統合: ブログから直接プロフェッショナルな履歴書を生成するためにawesome-cv
を使用します。- RSS フィード サポート:
feed.xml
を通じて RSS フィードを提供し、ユーザーがブログに購読できるようにします。 - 二言語コンテンツ: 中国語と英語の両方のコンテンツをサポートして、多様な読者層に対応します。
- GitHub ワークフロー自動化: GitHub Actions を実装してビルド、テスト、デプロイを自動化し、スムーズな開発プロセスを確保します。
- 自動翻訳ワークフロー: GitHub Actions を使用して、新しいまたは更新された投稿を複数の言語に自動的に翻訳します。
- EPUB サポート: EPUB 形式に変換して電子書籍リーダーで利用可能にします。
使い始める
ローカルの Jekyll 環境を設定するには、以下の手順に従ってください:
gem install jekyll bundler
jekyll new myblog
cd myblog
bundle install
bundle exec jekyll serve
bundle exec jekyll serve --draft
bundle add webrick
jekyll serve
Markdown スタイリング
構文ハイライトをカスタマイズするには、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
オーディオと PDF パイプライン
オーディオファイルと PDF ファイルを生成するには、以下のコマンドを使用してください:
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/draft.py <name>
コンテンツガイド
-en
: 英語の投稿を示します。-zh
: 中国語の投稿を示します。
_posts
と pages
ディレクトリは、両方の -en
と -zh
接尾辞をサポートします。
notes
ディレクトリは、主に個人学習のための英語コンテンツを含み、翻訳が必要ありません。