JSX記事公開PoC:Reactで作る視覚記事をブログ配下に置く¶
対象 / ポイント
Reactで作った視覚記事を、既存のブログURL、タグ、検索を壊さず公開したい人向けです。 Markdownを入口にし、本文の体験だけをJSX成果物へ分ける構成を確認します。
テキスト版の要点
このPoCは、JSX/Reactで作る視覚記事をSmartScopeブログ配下へ置くための公開ワークフロー確認です。
- 読者向けURLは従来通り
docs/blog/<slug>.mdが作る。 - JSXの実装は
apps/blog/<slug>/に置く。 - CIではMkDocs生成後にJSX成果物を
site/apps/blog/<slug>/へ追加する。
直接全画面で確認する場合は JSX成果物を開く を使用してください。
まとめ¶
JSX記事は、Markdown記事を置き換えるのではなく、まずMarkdownを公開上の入口として使います。本文の表現だけをJSXへ移すことで、既存のブログ一覧、タグ、検索、GitHub Pages公開フローを保ったままReactベースの記事を追加できます。
関連記事¶
- MkDocs環境でHTML直接公開ガイド — Markdown以外の静的ファイルを同居させる基本