@ziphi consider just making a simple page?
- Doesn't even have to be something fancy like #MkDocs-Material but just a simple site in #LibreOffice Writer/Web with your content on.
Or some cheap webhoster like #Netcup or @ubernauten / #Uberspace...
@ziphi consider just making a simple page?
Or some cheap webhoster like #Netcup or @ubernauten / #Uberspace...
Durch die Umstellung meines Blogs von #Wordpress auf #mkdocs kann ich das Paket bei Hetzner von Level 9 (10,90/Monat) auf Level 1 (2,09/Monat) wechseln Dort sind jetzt nur noch die Email-Postfächer der Familie und die Domains.
Dabei ist mir noch aufgefallen, dass ich beim #Nextcloud Hosting Storage Share für 1TB auf einem Alten Vertrag war (NX30). Habe den auf NX11 umgestellt, der kostet nur die Hälfte (5,11/Monat).
@jonathankoren I'm just the kind of person who expects shit to work on #LynxBrowser over @torproject and if it doesn't then it's ableist trash IMHO.
What is the de facto standard for creating static #documentation websites for #OpenSource libraries? So far I've found #Docusaurus and #MkDocs, which both are popular options. I like that MkDocs' sources are #Markdown files. What else should I consider? Any suggestions?
Web junior.guru je statická stránka, původně postavená nad Frozen-Flask. Pak jsem přešel na MkDocs, ale zbytky Flasku na webu stále straší. Zkusím se jich dnes zbavit. První na řadě je 404ka. Na nové už nebudou pracovní inzeráty. Ještě by to chtělo nějakou ilustraci, ale to potom.
You'd think generating Markdown docs from Python docstrings would be straightforward and common, but apparently not.
Couldn't get lazydocs to work, reading some other things now…
On the plus side, I can just toss the `.md` files in the right spot, commit them to Codeberg, and get hosted API docs.
If I can't get this to work I can use mkdocs to pull the docstrings, generate HTML and host it on my website.
@kobilacroix if you just want a cheap & simple website, that is still easy.
One option beyond "Overkill-#CMS||es" like #WordPress are "#OfflineCMS|es" like #MkDocs-Material that allow for simple #Markdown editing and clean #HTML whilst offering #search functionality.
Also there are more #Webhosters than ever before...
#discord IS LITERALLY THE PROBLEM!
It's worse than any #IRC, #Mumble or even the old #TeamSpeak & #Skype for that matter.
It combines the disadvantages of #Forum, #paywalled #documentation, #chat and #voicechat with 0 redeeming qualities (unlike #Zulip & Mumble & #XMPP+#OMEMO) it's just an #InformationBlackhole!
I'm shure fecking #dread has better moderation and I'd rather use #MicrosoftTeams + #Slack cuz those at least have proper #moderation tools.
Case in point: I'd rather #SelfHost all my comms infrastructure than to ever use something like Discord or any other #GDPR-violating SaaS that is just enshittification.
I'd rather recommend people to instead choose a tool that does everything but horrible to go with multiple smaller & good tools
Check @alternativeto and @european_alternatives for options.
Shoutout to @squidfunk for making Material for MkDocs which comes with a metric ton of #QualityOfLife improvements like being easily able to self-host all assets and thus comply with #privacy #laws whilst being as easy to setup as the regular #MkDocs.
I've written a guide to building a highly customisable, lightweight, secure, and performant static site using #MkDocs, #NGINX and #Docker: https://matthew-shaw.github.io/blog/2024/11/04/building-a-static-site-with-mkdocs-nginx-and-docker/