Docz (Powered by Gatsby) で静的サイト構築
🚀10 Trending projects on GitHub for web developers - 21st May 2021 - DEV Community 👩💻👨💻
で紹介されていたDoczというもの。
Docz
Doczは、あなたのコードのための美しいインタラクティブなドキュメントを簡単に書いて公開することができます。コードを紹介するMDXファイルを作成すると、Doczがそれをライブローディング可能な本番用サイトに変換します。
公式
- 特長
- Powered by Gatsby
- Zero config
- Easy to customize
- Based on MDX
- Fully pluggable
- TypeScript support
どうやらまた新たな静的サイトをジェネレートな何かか...と思ったが、既にVersion 2ではあり、過去記事発見。
ただ多少情報更新もありそうなので以下試した流れをメモる。
お試し
npx create-docz-app my-docz-app
で、以下になります。
Success! Created my-docz-app at C:\workspaces\nodejs\docz\my-docz-app
Inside that directory, you can run several commands:
npm run dev
Starts docz in dev mode.
npm run build
Builds the docz app for production.
We suggest that you begin by typing:
cd my-docz-app
npm run dev
npm run dev
で http://localhost:3000/
に立ち上がる。
Note that you don't need to follow any file architecture or convention. You can just create your .mdx files and put them anywhere in your project.
DeepL訳: なお、ファイル構成や規約に従う必要はありません。.mdxファイルを作成して、プロジェクトのどこにでも置くことができます。
本当?以下ファイルを適当においてみた。
---
name: Hello world
route: /doc/
---
# こんにちは
Hello, I'm a mdx file!
こんにちは。MDXふぁいるです。
無事できあがった。
netlify にデプロイ
MDX とは
Gatsbyと静的サイトについては
まとめ
ともかく簡単だったのでなにかに使えたらなあというメモでした。
他記事、動画
参考になればさいわいです。
Author And Source
この問題について(Docz (Powered by Gatsby) で静的サイト構築), 我々は、より多くの情報をここで見つけました https://qiita.com/e99h2121/items/9d4034603fa926d21cb9著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .