NOTE 002 / 2018年
ドキュメントの道具を、読み物に使う
ドキュメント向けの道具を、読み物のサイトに使うときの工夫です。
VuePress はドキュメントを作るための道具ですが、記事を並べるブログにも使えます。Markdown で書き、設定で一覧を作る。静的なファイルとして配信できるため、運用の負担が小さいのが利点です。
ブログとして使う場合は、記事の並び順、タグ、フィードの扱いを自分で決める必要があります。ドキュメントの構造に引っ張られすぎず、読み物としての流れを優先します。
押さえたい点
- 01記事の並び順を決める
- 02タグとフィードを用意する
- 03読み物としての流れを優先する
参考資料
外部サイトが開きます。内容は各サイトの管理下にあります。
- Vue.js ガイド 外部サイトvuejs.org
- Vue.js API 外部サイトvuejs.org
- Vue のリアクティブ基礎 外部サイトvuejs.org
- Vue コンポーネント基礎 外部サイトvuejs.org
- Vue Transition 外部サイトvuejs.org
- VuePress ドキュメント 外部サイトvuepress.vuejs.org
- markuplint 外部サイトmarkuplint.dev
- MDN Web Docs 外部サイトdeveloper.mozilla.org
- web.dev 外部サイトweb.dev
- W3C WAI 外部サイトw3.org
- GitHub Docs 外部サイトdocs.github.com
- Chrome for Developers 外部サイトdeveloper.chrome.com
- TypeScript ドキュメント 外部サイトtypescriptlang.org