npm install
# fetches api-platform/docs
bash tools/get-docs.sh
# fetches api-platform/core for reference and guides
bash tools/get-core-docs.sh
# builds the config/_default/menu.toml according to the outline.yaml from api-platform/docs
node tools/menu.mjs
# build our tailwind theme
cd themes/api-platform
npm install
npm run build
# run hugo to build public/
cd ../../
hugo
In themes/api-platform run npm run build -- --watch
Run hugo serve --watch
Hugo will share the URL to see the documentation with automatic rebuilding.
You can now perform and test changes:
- the directory
content/is a clone of https://github.com/api-platform/docs - the directory
themes/contain custom theming applied to the documents incontent/