ブログ投稿の追加
目標
ユーザーのコンテンツを既存の静的ブログに追加し、新しいブログシステムを強制しないこと。
このスキルは、まず現在のサイトがどのように投稿を表現しているかを理解し、次にそのスタイルで新しいコンテンツを追加する必要があります。これは、汎用的なMarkdownからHTMLへのコンバーターではありません。
契約
入力:
- 既存の静的サイトフォルダと、その現在の投稿/インデックス/テンプレートシステム。
- 1つ以上のソース投稿: Markdown、Obsidianノート、Word文書、古いHTML、貼り付けられたテキスト、画像、添付ファイル、またはコンテンツフォルダ。
- オプションのメタデータ (タイトル、日付、タグ、概要、スラッグ、カバー画像、インポート範囲など)。
出力:
- サイトの既存の記事スタイルに一致する新しい記事/詳細ページ。
- ブログインデックス、アーカイブ、タグ/カテゴリ、ホームページの最近の投稿、検索データ、RSS、またはサイトマップなど、既存のシステムがある場合、更新されたエントリポイント。
- ページ相対パスでコピー/再リンクされたローカル画像と添付ファイル。
- 該当する場合、更新された
EDITING.md投稿指示。
境界:
- サイトを再設計したり、既存のものが明確な場合に新しい投稿システムを作成したりしないでください。
- ソースがサポートしていないメタデータ、日付、著者、または主張をでっち上げないでください。
- リモートの数式/CDN依存関係を黙って追加しないでください。
- 公開しないでください。
publish-static-siteを使用してください。
成功のゲート:
- 新しい投稿が既存のスタイルでレンダリングされ、適切なインデックスからアクセスできること。
- 画像、数式、リンク、コード、表、リッチコンテンツが機能するか、未解決のアイテムが明示的に報告されること。
- パスが記事ページとインデックスページからページ相対であること。
- 影響を受けるページがブラウザ検証に合格し、
review-static-siteが合格するか、受け入れられた制限のみを報告すること。
ゲートが失敗した場合:
- このスキルで変換、メタデータ、パス、アセット、またはインデックスの配線を修正してください。
- インポートによって引き起こされた小さな視覚的な修正には
edit-site-partを使用してください。 - 修正後、再度
review-static-siteを使用してください。
使用するタイミング
ユーザーが次のことをしたい場合にこのスキルを使用します:
- 1つの新しい記事、ノート、エッセイ、またはブログ投稿を追加する。
- 複数のMarkdownファイルを静的サイトにインポートする。
- 古いブログから新しい生成サイトに投稿を移動する。
- 貼り付けられた記事テキストをサイトの記事ページに変換する。
- ブログインデックス、アーカイブ、タグ、ホームページの最近の投稿、または関連するエントリポイントを更新する。
- コンテンツを追加しながら、現在のサイトのビジュアル言語を維持する。
このスキルを使用して、テーマを選択したり、新しいサイトをゼロから構築したり、ウェブサイトのスタイルを再作成したり、プロフィール/アバウトコンテンツをパーソナライズしたり、小さな視覚的な微調整を行ったり、サイトを公開したり、プロジェクトをフレームワークに変換したりしないでください。
入力
利用可能なものは何でも使用します:
- 静的サイトフォルダ、通常は
site/、dist/、out/、またはpublic/。 - 1つ以上のMarkdownファイル、Word文書、貼り付けられた投稿、古いHTMLファイル、画像フォルダ、またはコンテンツフォルダ。
- 以前のスキルからの
EDITING.md、ページマップ、または引き継ぎメモ。 - 既存の記事テンプレートページまたは代表的な投稿。
- ユーザー提供のタイトル、日付、タグ、カテゴリ、概要、スラッグ、カバー画像、公開設定。
- すべての投稿、選択されたサブセット、または最初に代表的なバッチをインポートするかどうか。
ソースコンテンツが大きい場合は、最初に構造を検査し、盲目的にすべてをインポートしないでください。
1. 既存の投稿システムを理解する
新しい投稿を書く前に、サイトが現在どのように機能しているかを検査します。
以下を確認します:
posts/*.html、notes/*.html、articles/*.html、またはネストされたルートフォルダなどの投稿ファイル。blog.html、archive/index.html、notes/index.html、tags/index.html、またはcategory/index.htmlなどのインデックスページ。data/posts.json、data/notes.json、data/site.json、またはprofile.jsonなどのデータファイル。assets/script.jsまたは類似のファイル内のJavaScriptデータ配列。- 最近の投稿、注目の投稿、ノート、読書リスト、またはライティングハイライトのためのホームページセクション。
- テンプレートとして使用できる既存の記事/詳細ページ。
- テンプレートが
../assets/style.cssなどのページ相対リンクを使用するか、/assets/style.cssなどのサーバールートリンクを使用するかなど、既存のパス戦略。 - すでに存在する場合、RSS、Atom、サイトマップ、検索インデックス、またはタグ/カテゴリページ。
- 投稿を追加するための
EDITING.mdの指示。 assets/images/posts/、同じ場所にある投稿フォルダ、カバーフィールド、フィギュアクラス、ライトボックスマークアップ、キャプション、またはレスポンシブ画像ラッパーなど、既存の画像と添付ファイルの規則。- 数式レンダリング、コードハイライト、表、脚注、コールアウト、見出しアンカー、目次、リンクカード、埋め込み、図、引用/参照セクションなど、既存のリッチコンテンツの規則。
既存の構造に従ってください。サイトにすでに投稿システムがある場合、新しい投稿システムを発明しないでください。
2. 投稿メタデータを抽出する
各ソース投稿について、以下を抽出または導出します:
- タイトル。
- 日付。
- スラッグ。
- タグまたはカテゴリ。
- 概要または抜粋。
- カバー画像またはヒーロー画像(存在し使用可能な場合)。
- ソースパス。
- 読書時間(現在のサイトがすでに使用しているか、一貫して計算するのが簡単な場合のみ)。
フロントマターが存在する場合はそれを使用します。それ以外の場合は、最初の見出し、ファイル名、周囲のフォルダ、表示されている日付テキスト、または最初の段落から推測します。
特定の日付、タグ、著者、または主張をでっち上げないでください。フィールドが欠落していて推測できない場合は、明確なプレースホルダーを使用するか、サイトスタイルで許可されている場合はフィールドを省略します。
3. コンテンツをサイトのスタイルに変換する
既存の記事テンプレートと読書体験に一致するように新しい記事ページを作成します。
以下を保持します:
- ヘッダー、ナビゲーション、フッター、サイドバー、共有シェル。
- 記事のタイポグラフィ、間隔、メタデータレイアウト、タグ、バックリンク、関連リンク。
- ログエントリ、フィールドノート、カード、ターミナル/アーカイブフレーミング、またはミニマルエッセイなど、特別なテーマ言語。
- 既存のCSSクラス規則とデータ構造。
Markdownの場合:
- 見出し、段落、ブロッククォート、リスト、タスクリスト、表、コードブロック、リンク、脚注、コールアウト、画像をセマンティックHTMLに変換します。
- 利用可能な場合はコード言語ラベルを保持します。
- 画像参照をページ相対に保ち、必要な場合のみローカル画像をコピーします。
- 中国語、日本語、韓国語、アクセント付きラテン文字、その他の非ASCIIテキストを読み取り可能なUTF-8として保持します。
古いHTMLの場合:
- 記事本文とメタデータを抽出します。
- 古いサイトのクロム、アナリティクス、コメント、無関係なナビゲーション、ソースサイトのアイデンティティを削除します。
- コンテンツを新しいサイトの記事テンプレートに再ラップします。
3.5. 静的パスの互換性を維持する
投稿を追加するときは、生成された各ページの場所からパスを計算します。index.html からパスを盲目的にネストされた記事ページにコピーしないでください。
デフォルトのルール:
- 新しい記事ページは、共有CSS、JavaScript、フォント、画像、ナビゲーションにページ相対リンクを使用する必要があります。
- 投稿が
posts/my-post.htmlに生成される場合、共有アセットは通常../assets/style.css、../assets/script.js、および../assets/images/posts/my-post/figure.pngなどの投稿画像を必要とします。 - ルートページから投稿へのリンクは、通常
posts/my-post.htmlである必要があります。 - 投稿からルートページへのリンクは、構造に応じて、通常
../index.html、../blog.html、または../archive/index.htmlである必要があります。 - 既存のサイトが意図的にルート絶対パスを使用しており、ユーザーが直接の
file://オープンとサブパスホスティングが壊れる可能性があることを受け入れない限り、/assets/...、/posts/...、/data/...、/images/...などのルート絶対パスを導入しないでください。 - JavaScript生成リンク、検索結果、タグフィルター、関連投稿リンク、カバーパス、RSS/サイトマップエントリ、およびデータファイルを同じパス戦略で更新します。
- 既存のサイトに誤ってルート絶対リンクがすでにある場合は、それを報告し、問題を拡大するのではなく、影響を受けるパスを修正することを優先します。
ローカルファイルのフェッチ問題を回避します:
- 新しく追加された投稿が、記事本文のためにローカルのJSON/Markdownの
fetch()に依存しないようにします。 - インデックスがデータからレンダリングされる場合は、重要な投稿リンクをHTMLで表示するか、直接オープンプレビューで機能する相対的なJavaScriptデータオブジェクトを使用します。
4. リッチコンテンツフォーマットを処理する
リッチコンテンツを意図的に保持し、すべてをプレーンな段落にフラット化しないでください。
まず、現在のサイトがすでに以下をサポートしているかどうかを検査します:
- KaTeX、MathJax、カスタムCSS、または生のTeXブロックによる数式レンダリング。
- コードハイライト、言語ラベル、コピーボタン、またはターミナルスタイルのコードフレーム。
- 表、レスポンシブテーブルラッパー、脚注、コールアウト、アドモニション、引用、タスクリスト。
- 見出しアンカー、目次、バックリンク、関連ノート、またはセクションリンク。
- リンクカード、ブックマークリスト、URLインデックスページ、引用、参照リスト、または参考文献セクション。
- ビデオ、オーディオ、PDF、iframe、Mermaid図、Excalidraw/SVG図、またはダウンロード可能な添付ファイルなどの埋め込みメディア。
既存のパターンがある場合はそれに従います。パターンがない場合は、シンプルなセマンティックHTMLを使用し、追加のレンダラーが必要な機能を報告します。
数式とフォーミュラ:
$...$、$$...$$、\(...\)、\[...\]、またはWordの数式エクスポートからのインラインおよび表示数式を保持します。- 存在する場合は、サイトの既存の数式レンダラーを使用します。
- ソースに多くの数式が含まれており、レンダラーが存在しない場合は、プレーンな静的サイトにはローカルのKaTeX統合を優先します: KaTeX CSS/JS/フォントをローカルのベンダーフォルダの下に保存し、小さなローカルレンダリングスクリプトを追加し、CDNに依存しないでください。
- それ以外は依存関係のないサイトに、リモートのMathJax/KaTeX依存関係を黙って追加しないでください。
- フォールバックとして、数式マークされた要素内に元のTeXを保持し、それをブラウザでレンダリングします。数式のレンダリングが失敗した場合、読み取り可能なTeXフォールバックがページを壊す代わりに表示されたままになるようにします。
- KaTeXが必要とする明らかなソース構文を正規化します。例: softmax矢印、
\cdot、\times、誤って数式に混入した句読点、一般的なQ/K/V表現。 - 数式レンダラーが追加された場合、数式の多い投稿をコードのように見えるTeXボックスとして残さないでください。
- 数式をソースとブラウザのフォールバックの両方で読み取り可能に保ちます。
コードブロック:
- フェンス付きコード言語名を保持します。
- コードブロック内のHTMLをエスケープします。
- 長いコード行は、ページレイアウトを壊すのではなく、スクロール可能に保ちます。
- 既存のコードブロックスタイル、コピーボタン、シンタックスハイライトの規則を再利用します。
- 投稿からソースコードを実行しないでください。
表:
- Markdown、Word、またはHTMLの表をセマンティックテーブルに変換します。
- 幅の広い表は、サイトの既存のレスポンシブテーブルコンテナにラップするか、小さなローカルラッパーを追加します。
- ヘッダー行、配置の意図、利用可能な場合はキャプションを保持します。
リンク、URLインデックス、内部参照:
- 明確なリンクテキストで外部リンクを保持します。
- 相対リンクとMarkdown
.mdリンクを、ターゲットの投稿がインポートされたときに生成された静的HTMLパスに変換します。 - Obsidianのウィキリンク(例:
[[Note]]、[[Note#Heading]]、[[Note|Alias]])を、ターゲットを解決できる場合は通常のリンクに変換します。 - 未解決の内部リンクは、表示可能なプレースホルダーまたはプレーンテキストとして保持し、報告します。
- サイトがアンカーリンクまたは目次を使用する場合、安定した見出しIDを生成します。
- URLインデックス、ブックマーク、またはリンクラウンドアップの投稿の場合、リスト構造を保持します。存在する場合はサイトの既存のリンクカード/リストスタイルを使用します。ユーザーが要求しない限り、リモートメタデータをフェッチする必要があるプレビューカードを発明しないでください。
脚注、引用、参照:
- Markdownの脚注を、存在する場合はサイトの既存のスタイルを使用して脚注セクションに変換します。
- 引用ラベル、参考文献エントリ、参照リンクを保持します。
- ソーステキストが
[@paper2024]などの未解決の引用キーを使用する場合、それらを表示したままにし、参考文献ファイルが提供されない限り、引用メタデータが欠落していることを報告します。
コールアウト、アドモニション、ブロックタイプ:
- Obsidian/GitHubスタイルのコールアウト(例:
> [!NOTE]、> [!TIP]、> [!WARNING]、> [!IMPORTANT])を、サイトに最も近いコールアウト/カード/ブロッククォートパターンに変換します。 - 現在のサイトにチェックリストスタイルがある場合は、タスクリストをチェックリストとして保持します。それ以外の場合は、無効なチェックボックスマークアップまたはプレーンリストを使用します。
埋め込みと添付ファイル:
- PDF、スライド、データセット、ダウンロード、オーディオ、ビデオについては、サイトがすでにそのメディアタイプを埋め込んでいない限り、明確なリンクまたはダウンロードカードを優先します。
- ユーザーによって提供された場合のみ、ローカルの添付ファイルをコピーします。
- ユーザーが所有しているか、意図的に参照している場合のみ、リモートの埋め込みを保持します。
- Mermaidまたは図ブロックについては、存在する場合は既存のレンダラーを使用します。レンダラーが存在しない場合は、ソースブロックを保持して報告するか、実用的で適切な場合にのみ静的SVG/PNGに変換します。
5. 投稿画像とアセットを処理する
現在のサイトのアセット規則に従って画像を処理します。
まず、既存の投稿が画像をどのように保存しレンダリングしているかを検査します:
assets/images/posts/<slug>/などの共有アセットフォルダ。posts/<slug>/images/などの同じ場所にある投稿アセット。cover、heroImage、thumbnail、imagesなどのデータフィールド。- フィギュアマークアップ、キャプション、ライトボックスリンク、遅延読み込み、幅/高さ属性、レスポンシブCSSクラス。
既存のパターンを優先します。パターンがない場合は、次のようなシンプルな静的規則を使用します:
assets/images/posts/<post-slug>/
Markdownソースの場合:
- Markdownファイルのフォルダから相対画像リンクを解決します。
- 必要な場合、ローカル画像をサイトの投稿画像フォルダにコピーします。
- Markdown画像参照を新しい相対サイトパスに書き換えます。
- ネストされた記事ページの場合、画像パスに正しい
../の深さを含めます。 - Markdownの代替テキストが存在する場合は保持します。
- ソースが近くのイタリックテキスト、タイトル属性、またはObsidianスタイルの埋め込みを使用している場合、画像キャプションを変換します。
- 絶対ローカルディスクパスを指すリンクを残さないでください。
Obsidianノートの場合:
![[image.png]]や相対添付ファイルフォルダなどの一般的な埋め込みをサポートします。- ノートの近くにある可能性のある添付ファイルフォルダ(
attachments/、assets/、images/、または表示されている場合、 vaultの設定された添付ファイルフォルダ)を検索します。 - 埋め込みを通常のHTML画像またはフィギュアマークアップに書き換えます。
Word .docx ソースの場合:
- ドキュメントパッケージから埋め込み画像を抽出するか、利用可能なドキュメントツールを使用します。
- 可能であれば、周囲のテキストに対する画像の順序を保持します。
- 抽出された画像を、安定した名前で投稿画像フォルダの下に保存します。
...(翻訳が切り詰められました、翻訳を続けてください)