Documentation
How to get a notebook rendered on the website
See here for instructions on how to get a notebook in the notebook
directory rendered on the website.
Build documentation locally
1. To build and test documentation locally, first install Node.js. For example,
nvm install --lts
Then, install yarn
and other required packages:
npm install --global yarn
pip install pydoc-markdown pyyaml termcolor
2. You also need to install quarto. Please click on the Pre-release
tab from this website to download the latest version of quarto
and install it. Ensure that the quarto
version is 1.5.23
or higher.
3. Finally, run the following commands to build:
cd website
yarn install --frozen-lockfile --ignore-engines
pydoc-markdown
python process_notebooks.py render
yarn start
The last command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Build with Docker
To build and test documentation within a docker container. Use the Dockerfile in the dev
folder as described above to build your image:
docker build -f .devcontainer/dev/Dockerfile -t autogen_dev_img https://github.com/microsoft/autogen.git#main
Then start the container like so, this will log you in and ensure that Docker port 3000 is mapped to port 8081 on your local machine
docker run -it -p 8081:3000 -v `pwd`/autogen-newcode:newstuff/ autogen_dev_img bash
Once at the CLI in Docker run the following commands:
cd website
yarn install --frozen-lockfile --ignore-engines
pydoc-markdown
python process_notebooks.py render
yarn start --host 0.0.0.0 --port 3000
Once done you should be able to access the documentation at http://127.0.0.1:8081/autogen