Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Search - "mkdocs"
-
During the last days I got criticized by a fellow student, why I love 'error prone software'... He means git, mkdocs, latex etc. - I love them!
Does anyone of you really prefer svn over git?6 -
Recently I've been tasked with setting up of a small /mid-size infrastructure and I've been documenting things like infrastructure design, network configuration all the way to playbooks and cluster configuration.
Since I just started with this, until now I have been doing this in a Google doc / some spread around markdown files. I would like to have a better way of having this documentation hosted internally..
I have been playing around with local installations of rtd, gitbook and mkdocs. So far, I've liked the simplicity and customizability of mkdocs.
Any other options before I commit myself to mkdocs?2 -
Markdown admonitions are unofficial extra's to the spec to render basic info/warning/note alert boxes. There were already 2 syntaxes for these:
Supported in python-markdown, Mkdocs, marked js extension: 3 exclamation marks followed by a type, and indenting its contents by 4 spaces:
!!! note
Supported by Docusaurus & extended by Nuxt.js as "MDC" or "markdown components": 3 or more colons followed by a type, and with an end delimiter:
:::note
:::
So why the fuck did Github have to go for this retarded syntax mixing blockquotes with half the syntax of an image link instead of following in the footsteps of others?
> [!NOTE]
> -
haha i get to know so much new things everytime i try web development.
Interestingly, i don't know even the basics of any framework or websites, yet i am a "JAMstack" developer (coz i use mkdocs to maintain a website and am pretty comfortable with static site generators)
how cool is that? XD