mkdocs gh-deploy

Deploy your documentation to GitHub Pages

Options

NameDescription
-h, --helphelp for gh-deploy
-q, --quietSilence warnings
-v, --verboseEnable verbose output
-f, --config-file <arg>Provide a specific MkDocs config
-s, --strictEnable strict mode. This will cause MkDocs to abort the build on any warnings
-t, --theme <theme>The theme to use when building your documentation
--use-directory-urlsUse directory URLs when building pages (the default)
--no-directory-urlsDon't use directory URLs when building pages
-c, --cleanRemove old files from the site directory before building (the default)
--dirtyOnly rebuild pages that have been modified since last build
-m, --message <message>A commit message to use when committing to the GitHub Pages remote branch. Commit {sha} and MkDocs {version} are available as expansions
-b, -remote-branch <branch name>The remote branch to commit to for GitHub Pages. This overrides the value specified in config
-r, --remote-name <remote name>The remote name to commit to for GitHub Pages. This overrides the value specified in config
--force
  • Dangerous 💥
--no-history
  • Dangerous 💥
--ignore-versionIgnore check that build is not being deployed with an older version of MkDocs
--shellUse the shell when invoking Git