MKdocs project documentation

[vjvanjungg]

@fbartels thanks for sharing the process, i’ll have to play around with it some more. appreciate the thoughts/insights.

[A Former User]

This is for a different Static Site Generator but I’ll just leave this here if you find it helpful: https://video.lahijiapps.dev/videos/watch/3540b0bb-553f-43bb-8087-fa8e26fd0d46

[vjvanjungg]

@atrilahiji i did it!! thanks man, enjoyed it. 2 questions: how did you go from vscode to gitlab, or how did you go from github to gitlab, for future continuous updates?

ps. heard your cat Meowww loudly at 17:23

[A Former User]

@vjvanjungg Glad it helped! I'm not sure I quite understand your questions. Are you asking how I switched windows or how the experience is using VSCode and GitLab instead of Github?

[vjvanjungg]

@atrilahiji ah sorry i wasn’t being clear. I meant to ask, are you using any sort of extensions to push changes from Vscode straight to GitLab? Or... are you pushing the changes to GitHub, and then from GitHub to GitLab?

[A Former User]

@vjvanjungg I just push directly to GitLab from VSCode or command line. As long as you clone the repo from GitLab you just git push and it goes right to GitLab.

[A Former User]

@vjvanjungg Also to be more specific, I just used "git clone <gitlab repo URL>" to pull down the repo. Then when I opened the project in VSCode I just used its built in git management features.

[vjvanjungg]

@atrilahiji gotcha, awesome awesome i’ll try it , (think) i can do it now

[vjvanjungg]

@atrilahiji thank you!

[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.