GitHub Pages App¶
To publish your page, push your GitHub Pages repository via HTTP to this app:
git remote add page https://<app.example.com>/_git/page git push page master
git will prompt for Cloudron username and credentials. Any
Cloudron user with access to the app can push.
It can be convenient to store the HTTP username and password in the
machine app.example.com login fred password bluebonnet
bluebonnet above to your setup.
The GitHub pages app does not support custom Jekyll plugins. The app follows the list of plugins supported by GitHub pages. See GitHub pages plugins page for a list of supported plugins.
GitHub pages GEM¶
The app uses the pages gem to statically build the website. In the event that the gem update does not build the repo (because of version mismatch), the app will continue to serve the last successful build.
mkdocs has a command called
gh-deploy that can
automatically build docs and publish the site to a specific remote and branch.
git remote add page https://site.cloudron.xyz/_git/page # add the github-pages app remote mkdocs gh-deploy --remote-name page --remote-branch master --force