Deployment - GitHub Pages

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

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

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 https://random-string-hash.pages.github.io/queries/my-query .

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