A library to generate a tutorial website using Docusaurus.
npm install @uniwebcms/tutorial-builderGenerator of markdown files for a Docusaurus tutorial website,
``lua`
tutorial-builder
└── src
├── browser
│ └── ... -- Browser-specific components
└── node
└── ... -- Node.js specific utilities
In package.json, we set the main field to point to bundle.js under dist. This is the primary entry point to get components.
`json`
{
"main": "dist/bundle.js",
}
Node.js introduced a feature called conditional exports that allows defining different entry points based on the environment. This can be helpful if your library has distinct Node and browser entry points.
`json`
{
"exports": {
".": "./dist/bundle.js",
"./config": "./dist/node/index.js"
},
}
With this format, the node script to generate the config object can be imported as:
`javascript`
const getConfig = require('@uniwebcms/tutorial-builder/config');
The built is saved to the /dist folder, which is not committed. The project must be built before it is published to npm.
First, install the dependencies
`bash`
npm i
`bash`
npm run build
npm publish
> The first time the package is published, call npm login to log in and npm publish -access public` to make the package is public accessible.
When the library is used in a project that bundles its code with Webpack, Webpack will look for fields like module or browser in package.json to determine the correct entry point.
If you're providing already bundled code for the browser, ensure that you exclude Node.js-specific code from that bundle and vice-versa.
Docusaurus relies on React, so we list React (and any other such dependencies) as a peer dependency. This ensures that the consuming application uses a single version of React.