MKdocs project documentation

[ntnsndr]

Has anyone tried to push an MKDocs site from GitLab to a Cloudron app, either Surfer or the GitHub Pages app? I would love guidance on how to do that. It'd be great to manage the site on GitLab but have it push to Cloudron.

Thanks!

[girish]

@ntnsndr Yes, our docs.cloudron.io is a surfer instance. We deploy to that from a repo based on mkdocs. I don't have a guide for you, but https://git.cloudron.io/cloudron/docs is the repo and it has the gitlab-ci file. It simply deploys to docs.cloudron.io on each push.

Happy to answer any questions until we have better guide/docs for this.

[ntnsndr]

@girish Thanks so much for this! Just what I needed. I'm working on creating an example repo that I can use for future. I think I fully de-cloudron-ed it... Am I right to leave in .gitlab-ci.yml this part?

default:
image: cloudron/docs-ci@sha256:4a63ad48a6fbbd168828769b0d796b511d09d173ab5dd64368338997164aa4ab

Here's the repo: https://gitlab.com/medlabboulder/docs

Let me know if there's anything else I should do. But for now it deploys!

[girish]

@ntnsndr You are free to user our image (cloudron/docs-ci) but it was built from https://git.cloudron.io/cloudron/docs/-/blob/master/Dockerfile . You can of course build your own and push it as your user in docker hub. It's definitely better to do that in the unlikely case we change something in docker hub and it will end up affecting you.