Deployment - GitHub Pages

Deploying on GitHub pages is very simple since magidoc generates static files by default.

Magidoc configuration


First thing, you need to set up your magidoc configuration to work on your repository's deployed URL.


Static assets


Since GitHub tries to use Jekyll by default to render your website, we need to disable Jekyll. You can do this by creating an empty file named .nojekyll inside the assets folder.




If you are deploying this from a private repo in an organization, omit the siteRoot property altogether because it will be a URL along the lines of .

If it is a public repo in an organization then it becomes https://<organization> and your siteRoot should be just be /<repo> .