Cloudron makes it easy to run web apps like WordPress, Nextcloud, GitLab on your server. Find out more or install now.


  • Categories
  • Recent
  • Tags
  • Popular
  • Bookmarks
Skins
  • Light
  • Cerulean
  • Cosmo
  • Flatly
  • Journal
  • Litera
  • Lumen
  • Lux
  • Materia
  • Minty
  • Morph
  • Pulse
  • Sandstone
  • Simplex
  • Sketchy
  • Spacelab
  • United
  • Yeti
  • Zephyr
  • Dark
  • Cyborg
  • Darkly
  • Quartz
  • Slate
  • Solar
  • Superhero
  • Vapor

  • Default (No Skin)
  • No Skin
Collapse

Cloudron Forum

Apps | Demo | Docs | Install

MKdocs project documentation

Scheduled Pinned Locked Moved Solved App Wishlist
24 Posts 9 Posters 1.2k Views
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • fbartelsF Offline
    fbartelsF Offline
    fbartels App Dev
    replied to vjvanjungg on last edited by
    #11

    @vjvanjungg said in MKdocs project documentation:

    your writing pad for the blog posts is from the code editor vscode in markdown style?

    While markdown syntax highlighting is nice, you could do this with any editor. I usually draft my texts in codimd (also hosted on my Cloudron). This makes it easy to add thoughts from multiple devices and share the text with others for review. Vscode comes in last when adding the file to my git repo and to make sure that the included spell checker is happy as well as markdownlint.

    V 1 Reply Last reply
    1
  • V Offline
    V Offline
    vjvanjungg
    replied to fbartels on last edited by
    #12

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

    1 Reply Last reply
    0
  • ? Offline
    ? Offline
    A Former User
    wrote on last edited by
    #13

    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

    V 1 Reply Last reply
    3
  • V Offline
    V Offline
    vjvanjungg
    replied to A Former User on last edited by
    #14

    @atrilahiji 99833BF2-14EC-44DD-960C-9704ADA0F154.jpeg 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 😄

    ? 1 Reply Last reply
    1
  • ? Offline
    ? Offline
    A Former User
    replied to vjvanjungg on last edited by
    #15

    @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?

    V 1 Reply Last reply
    0
  • V Offline
    V Offline
    vjvanjungg
    replied to A Former User on last edited by
    #16

    @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?

    ? 2 Replies Last reply
    0
  • ? Offline
    ? Offline
    A Former User
    replied to vjvanjungg on last edited by
    #17

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

    1 Reply Last reply
    0
  • ? Offline
    ? Offline
    A Former User
    replied to vjvanjungg on last edited by
    #18

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

    V 2 Replies Last reply
    1
  • V Offline
    V Offline
    vjvanjungg
    replied to A Former User on last edited by
    #19

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

    1 Reply Last reply
    0
  • V Offline
    V Offline
    vjvanjungg
    replied to A Former User on last edited by
    #20

    @atrilahiji thank you!😇

    1 Reply Last reply
    0
  • N Offline
    N Offline
    ntnsndr
    wrote on last edited by
    #21

    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!

    girishG 1 Reply Last reply
    1
  • girishG Do not disturb
    girishG Do not disturb
    girish Staff
    replied to ntnsndr on last edited by
    #22

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

    N 1 Reply Last reply
    1
  • N Offline
    N Offline
    ntnsndr
    replied to girish on last edited by
    #23

    @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!

    girishG 1 Reply Last reply
    2
  • girishG Do not disturb
    girishG Do not disturb
    girish Staff
    replied to ntnsndr on last edited by
    #24

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

    1 Reply Last reply
    0

  • Login

  • Don't have an account? Register

  • Login or register to search.
  • First post
    Last post
0
  • Categories
  • Recent
  • Tags
  • Popular
  • Bookmarks
  • Login

  • Don't have an account? Register

  • Login or register to search.