Markdown と付随する画像を HTML ドキュメントに変換し、独立して開くことができ、読書体験を自由に調整できます。
知識ノート、グラフィック チュートリアル、コースの配布資料、および長文の学習資料に適しています。 Markdown を使用してコンテンツを維持し、同じページ ルールのセットを使用して表示します。 AI にアウトラインに従って書かせ、絵を作成させ、固定プログラムを呼び出して読み上げ版を生成することもできます。
アカウントを登録したり、バックグラウンド サービスを実行したりする必要はありません。生成された HTML には、テキスト、スタイル、読み取りスクリプト、およびすべての画像がすでに含まれており、オフラインで開いたり、他の人に送信したり、Web ページとして公開したりできます。
オンライン エクスペリエンス · デモ ソース ファイル · AI の使用手順 · 完全な例 · コンテンツ コンポーネント · オンライン表示設定
「オンラインエクスペリエンス」をクリックして、カラーマッチング、フォントサイズ、空白、フォントを直接調整します。ウェアハウス内の HTML ファイルは、ソース コードをダウンロードまたは表示するために使用されます。ダウンロード後にオフラインで開くこともできます。
どのような読書体験が得られるのでしょうか?
| 関数 | 実体験 |
|---|---|
| 一元的な読み取り設定 | 通常は非表示にし、クリック後に調整します。変更はすぐに有効になります。 |
| 4色 | 白、紙色、ライトグリーン、ダークブラック。背景テクスチャは個別に選択可能 |
| 文字サイズ | 16 ~ 36 ピクセル、1 ピクセルずつ調整 |
| テキスト幅を継続的に調整する | 左側と右側に 0 ~ 40% の空白を残し、クリック可能な参照ドットを配置します。カタログが折りたたまれているときにウィンドウを埋めることができます |
| フォントと段落 | Helvetica、Song フォント、Kai フォント。行間と最初の行のインデントは個別に調整できます |
| ディレクトリと配置 | コンピューターの左側にある目次、携帯電話では折りたたまれた目次、読み進めるにつれて現在の章が更新されます |
| グラフィック、テキスト、技術的な内容 | 画像をクリックすると拡大します。広い表と部分的なコードのスクロール、既製のプロンプト ブロックと補足説明をサポートします。 |
| 単一ドキュメントの移植性 | 画像は完全に埋め込まれているため、アセットをまとめて読者に送信する必要はありません。 |
ホームページでは、文書名、著者、発行日、文字数のみが中央に保持されます。タイトルを 42 ピクセル、記事情報を 22 ピクセルの太字で固定。フォントは読みの選択に従います。ブラウザで許可されている場合、読書設定はローカルに保存されます。
コンテンツ制作プロセス
确认大纲 → AI 撰写正文并制作配图 → Markdown + assets + 文章配置
↓
固定程序生成与校验
↓
独立 HTML 阅读版
AIはコンテンツを担当し、プログラムはページフレームの再利用と読み取り機能を担当します。このテンプレートでは、カバー、プロンプト ブロック、またはすべてのコンポーネントをすべての投稿に表示する必要はありません。コンテンツの必要に応じて使用してください。
倉庫リンクをAIに渡せばそのまま利用できるのでしょうか?
倉庫リンクを入り口としてご利用いただけます。ファイルを安定して生成するには、AI がウェアハウス ファイルを取得し、Python を実行できる必要もあります。
| 使用するAI環境 | 推奨される方法 |
|---|---|
| ウェアハウス ファイルを取得して Python を実行できる | 以下のリポジトリ リンク、概要、要件を指定して、完全なプロジェクトをダウンロードまたはクローンして生成させます。 |
| アップロードされたファイルを読み取り、Python を実行できます | ウェアハウスの ZIP をダウンロードして AI にアップロードし、アウトラインを提供します |
| Web の閲覧またはテキスト チャットのみが可能 | テンプレートのルールは理解できます。 README を読むだけでは、完全なファイルが生成され検証されることは保証されません。 |
スキルやプラグインをインストールする必要はありません。 README は一般公開されています。给AI的模板使用要求.md これは完全な実装規約であり、プログラム ファイルが実際の生成ツールです。特定の AI 製品に適応する必要がある場合は、追加のアクセス レイヤーを作成でき、テンプレート自体は独立したままになります。
リポジトリ リンクをコピーし、次のリクエストを一緒に送信します。
私が提供したウェアハウスのリンクを読んで、まず README.md と「AI.md のテンプレート使用要件」をお読みください。完全なウェアハウス ファイルを取得し、確認したアウトラインに従ってテキストを記述し、必要な画像を作成し、Markdown、assets、document.json、HTML を別の記事フォルダーに納品します。ウェアハウス内の固定生成プログラムと検証プログラムを使用して、ページ形式と読み取り機能の一貫性を維持します。 HTML 画像は完全に埋め込まれる必要があります。署名と発行日には私が提供した情報を使用し、不明な日付は空白のままにしておきます。スクリーンショットに基づいてページを単に書き換えないでください。実際にプログラムを実行し、ビルドとチェック結果を説明します。
再度添付します:概要、文書名、署名、出力場所、発行日 (オプション)。画像の生成は、現在 AI で利用できるマッピング ツールに依存します。このプロジェクトには、自動書き込みサービスや画像生成サービスは含まれていません。
それぞれの新しいドキュメントが提供するもの
你的文档文件夹/
├─ document.json # 文章名称、作者、日期与文件路径
├─ 文章.md # 内容源文件,图片用 assets 相对路径
├─ 文章.html # 程序生成,文字、样式、脚本、图片全部内嵌
└─ assets/ # 原始配图,供 Markdown 阅读和以后修改
├─ 图1.png
└─ 图2.svg
マークダウンとアセットはメンテナンス可能な原稿です。 HTML は、単独で持ち運んだり、オフラインで読んだり、GitHub Pages に置いたりできる読書バージョンです。通常の参照 Web リンクは残ります。それらをクリックすると、対応する Web サイトにアクセスする必要があります。
ローカル使用: 2 段階生成
まずウェアハウスの ZIP をダウンロードして解凍するか、Git を使用してプロジェクトを取得します。
git clone
cd reading-template
次のコマンドはテンプレートのルート ディレクトリで実行されます。生成ツールには Python 3.10 以降が必要です。 requirements.txt 2つのパッケージのうち。これらの依存関係がインストールされた Python を使用してください。コマンド名が Python でない場合は、実際のインタープリターのコマンドまたはパスに置き換えます。
まず、ビルドの依存関係をインストールします (生成時のみ必要。HTML の読み取りにはインストールは必要ありません)。
python -m pip install -r requirements.txt
1. 新しいドキュメントを初期化します。 宛先フォルダーは、新しいフォルダーまたは空のフォルダーである必要があります。既存のドキュメントを直接作成できます document.json再度初期化する必要はありません。
python "源文件/init.py" "新文档" --title "你的文档名称" --author "你的署名"
必要に応じて出版日を追加します --date "YYYY-MM-DD" そして実際の日付を記入してください。決まっていない場合は省略します。署名は自分で指定することができ、プログラムのデフォルトの作成者は「Stone Meeting」です。初期化後、概要に従ってAIが完成 文章.md実際の写真を保存します assets/Markdown で参照してください。
2. 構成を使用して HTML を生成し、自動的に検証します。
python "源文件/build.py" --config "新文档/document.json"
見る "status": "passed" ビルドおよび組み込みチェックに合格したことを示します。テキストまたは画像を変更した後、2 番目の手順を繰り返します。このプログラムは AI を呼び出すものではなく、テキストの作成や画像の作成を置き換えるものでもありません。完成したコンテンツを固定ページに安定してロードする責任があります。
こちらも利用可能 生成文档.ps1 -Config '完整配置路径'; ネイティブ スクリプトの実行で制限が発生した場合は、システム設定を変更せずに上記の Python コマンドを使用してください。
記事構成
document.json UTF-8 では、パスは、それが配置されている記事フォルダーに対する相対パスです。サンプル プロジェクトをコピーして、記事情報のみを変更できます。
{
"schema_version": 1,
"template_id": "knowledge-reader-v5",
"source": "文章.md",
"output": "文章.html",
"metadata": {
"title": "你的文档名称",
"author": "石头开会",
"publication_date": null
},
"reading": {
"margin_percent": 10
}
}
title Markdown で一意である必要があります # 一级标题 一貫性のある;使用日 "YYYY-MM-DD" または null。margin_percent 左側と右側のそれぞれの最初の空白スペースです。デフォルトは 10 で、0 ~ 40 の整数が使用できます。変更が必要ない場合は、デフォルトのままにしてください。ここでは、CSS、タイトルのフォント サイズ、またはその他の文字体裁パラメータのセットは提供されません。
スタイルを安定させる方法
源文件/shell.html固定ページ構造、reader.css固定されたスタイル、reader.js読み取り機能を修正しました。template-lock.json上記 3 つのファイルのチェックサムを記録します。生成中に変更が見つかると停止し、新しいスタイルは自動的に受け入れられません。- プログラムは自動的に目次を生成し、画像を埋め込み、文字数をカウントし、出力スタイルとスクリプト、画像データ、目次アンカー、記事情報、フォント サイズ範囲をチェックします。
- 画像が見つからない場合、リモート画像が参照されている場合、SVG が依然として他のファイルに依存している場合、または設定がタイトルと矛盾している場合、エラーが報告されます。既存の HTML は検証に合格するまで置き換えられません。
- 元の原稿、画像、構成、テンプレート、依存バージョンが同じであれば、繰り返し生成される HTML コンテンツの一貫性が保たれます。リーダーによってブラウザーに保存された色、フォント、フォント サイズが引き続き優先されます。デバイスで利用可能なさまざまなフォントは通常のフォントに置き換えられます。
既存の HTML を再チェックする必要がある場合:
python "源文件/validate.py" --config "新文档/document.json"
テンプレートフォルダーの使い方
| ファイルまたはフォルダー | 使用 |
|---|---|
| README.md | ここから始めてください |
| AI.md のテンプレート使用要件 | 後続AIの運用契約完了 |
| 設計仕様書と使用説明書.md | 確認済みのページルール |
| コンテンツコンポーネント規約.md | タイトル、画像、引用、表、コード、プロンプトブロックの書き方 |
| テンプレートのプレビュー.html | 現在唯一のメインプレビュー入口 |
| サンプルプロジェクト/ | 完全なマークダウン、構成、写真、生成された結果 |
| ソースファイル/ | ビジュアル ファイルと生成、初期化、検証手順を修正しました。 |
| ドキュメント.スキーマ.json | 機械可読な構成フィールドの説明。ジェネレーター自体も検証します |
| テンプレートロック.json | ビジョンファイルのバージョンチェック値を修正 |
| テスト/ | ツールのメンテナンス時に使用し、日常の書き込みでは操作する必要はありません |
テンプレート自体を調整する必要があることが明らかな場合にのみ、修正されたビジュアル ファイルを変更し、バージョンを更新します。毎日の執筆では、記事プロジェクト内のマークダウン、画像、記事構成のみを変更します。
他のAIに移行・引き継ぐ際は、テンプレートフォルダーごとコピーするだけです。 HTML を参照するのに Python は必要ありません。また、このツールキットを持ち歩く必要もありません。
オンライン体験: https://gritjw.github.io/reading-template/
GitHub:https://github.com/GRITJW/reading-template