Skip to content

Latest commit

 

History

History
118 lines (81 loc) · 10.4 KB

File metadata and controls

118 lines (81 loc) · 10.4 KB

English 简体中文 日本語

NextWeb4 GitHub Pages

nextweb4.github.io で公開する、静的な個人出版サイト、検索可能な記事アーカイブ、自己測定ジャーナルです。

公開サイト 最終コミット リポジトリサイズ Stars HTML JavaScript

目的と読者

このリポジトリは、NextWeb4 個人サイトのデプロイ可能なソースです。フレームワーク、パッケージのインストール、アプリケーションサーバーを必要とせず、ホームページ、3 つのテーマ別モジュール、著者プロフィール、記事アーカイブ、ブラウザー内検索を提供します。

コンテンツは主に中国語の個人出版物です。about.html には中国語と英語のインターフェース切替があり、3 つの README はリポジトリ文書を英語、簡体字中国語、日本語で提供します。

監査済みコンテンツ一覧

2026-07-18 の再帰ツリー監査では、コミット済みファイルが 654 個ありました。

領域 監査ファイル数 内容
article/ 562 個別の静的記事ページ
module/ 3 投資・思想、内省、技術・ネットワークのカテゴリーページ
data/ 5 記事メタデータ、統合検索インデックス、3 つのカテゴリーインデックス
uploads/ 74 公開記事が参照する画像とサイトアイコン
リポジトリルート 10 エントリーページ、共通スタイル・スクリプト、README、保守規則

これらは監査対象コミットの件数であり、固定された製品上限ではありません。リポジトリが変化すると、最終コミットとリポジトリサイズの動的バッジは個別に更新されます。

閲覧機能

  • index.html は 3 つのコンテンツモジュール、記事探索、全体検索、公開プロジェクトへの入口を提供します。
  • module/ ページではカテゴリー別に閲覧でき、共通の記事検索も利用できます。
  • article/ はコミット済み HTML 文書のため、記事閲覧にデータベースやサーバー描画は不要です。
  • about.html は著者プロフィールを表示し、中国語・英語の選択を localStorage に保存します。
  • 監査したマークアップとスクリプトでは、検索候補がキーボードフォーカスと combobox/listbox セマンティクスに対応しています。
  • 日替わり Bing 壁紙は段階的な拡張です。要求、ストレージ、画像読み込みに失敗しても、単色のフォールバックでサイトを利用できます。

リポジトリ構成

パス 役割
index.html ホームページ、モジュールナビゲーション、全体検索、記事順位付け UI
about.html 著者プロフィールと中国語・英語のインターフェース辞書
article/ 監査ツリーにある 562 個のコミット済み記事ページ
module/ 3 つのカテゴリー入口ページ
data/articles.json 記事メタデータ一覧
data/search-index.json ブラウザー検索の統合データ
data/search-index/ カテゴリー別検索データ
uploads/ 公開ページで使うリポジトリ内画像
site.cssarticle.css サイト共通および記事用の表示スタイル
site.js 壁紙の要求、検証、キャッシュ、フォールバック
article-search.js カテゴリー・記事ページで共用する検索動作

ローカルプレビュー

依存関係のインストールは不要です。リポジトリルートで次を実行します。

python -m http.server 8000

http://localhost:8000/ を開きます。ページはコミット済み JSON を fetch() で読むため、検索の確認には file:// ではなく HTTP オリジンを使用してください。

ビルド、パッケージマネージャー、自動テスト、lint、format、CI のコマンドは見つかっていません。コミット済みの HTML、CSS、JavaScript、JSON、メディアが、そのままデプロイ成果物です。

検索アーキテクチャ

ホームページと記事検索は、クエリを正規化し、トークン展開数を制限し、ブラウザーの Web Crypto API でトークンをハッシュして、タイトル、モジュール、日付、コミット済み Bloom-filter データから順位を計算します。同一オリジンの検索インデックスを取得した後はローカルで結果を計算し、検索バックエンドはなく、クエリを検索サービスへ送りません。

記事を変更した場合は、article/module/data/articles.jsondata/search-index.json、該当する data/search-index/ のカテゴリーファイルを同期してください。この関係を自動的に強制するジェネレーターや検証コマンドはコミットされていません。

コンテンツと公開手順

  1. article/ の記事 HTML を追加または更新し、参照するメディアを uploads/ に置きます。
  2. 対応するカテゴリーページとメタデータ・検索インデックスを更新します。
  3. ローカル HTTP サーバーでプレビューし、直接リンク、検索、キーボード操作、狭い画面幅を確認します。
  4. パスの大文字小文字、非 ASCII タイトルの URL エンコード、欠落メディア、UTF-8 の完全性を確認します。
  5. デプロイ可能なファイルをコミットします。GitHub Pages の公開元はツリー外のリポジトリ設定で管理されるため、ブランチやデプロイの前提を変える前に設定を確認してください。

検証済みのソース対応表とリンク検査なしに、記事ページやインデックスを一括再生成しないでください。公開成果物は保存されていますが、安全に再構築できるソースジェネレーターはありません。

ネットワーク、ストレージ、プライバシー

通常の記事、スタイル、スクリプト、画像、検索データはリポジトリ内にあります。site.js は任意で https://bing.biturl.top/ に壁紙メタデータを要求し、資格情報とリファラーを送らず、6 秒でタイムアウトし、HTTPS の bing.com ホストから返された画像だけを受け入れます。制約のある接続では拡張を省略し、検証済みの日次 URL を localStorage にキャッシュし、失敗してもコンテンツを妨げません。

About の言語選択と壁紙キャッシュはブラウザーのローカル状態です。監査したルートページとスクリプトでは分析サービスへの依存関係は見つかりませんでした。README のステータスバッジは img.shields.io に画像を要求しますが、公開サイトの実行時動作は変えません。

検証チェックリスト

  • HTTP 経由でホームページ、3 つのカテゴリーページ、About ページ、代表的な記事を開く。
  • 空、中国語、英語、日付、該当なし、キーボード操作、素早く変化する検索クエリを試す。
  • 候補リンクが解決され、信頼できないクエリ文字列がエスケープまたは安全に代入されることを確認する。
  • About の言語切替、状態保持、フォーカス表示、モーション低減、モバイルレイアウトを確認する。
  • 壁紙 API、無効なホスト、ストレージ、画像読み込みの各失敗を再現し、コンテンツが読めることを確認する。
  • 変更した記事メタデータ、カテゴリーリンク、インデックス、アップロード画像をまとめて確認する。

状況、制限、貢献

2026-07-18 の監査時点で、リポジトリは公開、アクティブ、未アーカイブで、Pages が有効でした。主な保守リスクは、生成物のような記事ページとインデックスが、コミット済みジェネレーターや自動検証スイートなしでずれることです。メディアディレクトリは、クローンとページ転送の容量も増やします。

貢献では、UTF-8 パス、意味的でキーボード操作可能なマークアップ、安全なテキスト処理、非ブロッキングな壁紙境界、すべてのコンテンツ表現の同期を維持してください。変更は目的を絞り、フレームワークやビルドパイプラインを導入する前に、既存の GitHub Pages 公開、コンテンツ所有、ロールバック方法への影響を文書化してください。

ライセンス

ライセンスファイルは見つかりませんでした。公開文章とアップロードメディアには個別の来歴や権利がある可能性があり、公開されているだけでは再利用許可を意味しません。