Recent searches

No recent searches

Search options

Only available when logged in.
toad.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
Mastodon server operated by David Troy, a tech pioneer and investigative journalist addressing threats to democracy. Thoughtful participation and discussion welcome.

Administered by:

Server stats:

218
active users

toad.social: AboutProfiles directoryPrivacy policy

Mastodon: AboutGet the appKeyboard shortcutsView source codev4.4.1

#mkdocs

2 posts2 participants0 posts today
Kevin Karhan :verified:Web hosting advice request
Kevin Karhan :verified:Web hosting advice request
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://sfba.social/@jonathankoren" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>jonathankoren</span></a></span> I'm just the kind of person who expects shit to work on <a href="https://infosec.space/tags/LynxBrowser" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>LynxBrowser</span></a> over <span class="h-card" translate="no"><a href="https://mastodon.social/@torproject" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>torproject</span></a></span> and if it doesn't then it's ableist trash IMHO.</p><ul><li>Consider <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a>-<a href="https://infosec.space/tags/Material" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Material</span></a> w/ <a href="https://infosec.space/tags/Privacy" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Privacy</span></a> Plugin if you like <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Markdown</span></a> and a sleek site that isn't a 24/7 job to avoid getting <a href="https://infosec.space/tags/hacked" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>hacked</span></a>, loaded with <a href="https://infosec.space/tags/malware" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>malware</span></a> like <a href="https://infosec.space/tags/Shitcoin" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Shitcoin</span></a>-<a href="https://infosec.space/tags/Cryptojacking" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Cryptojacking</span></a>-shite and merely update in time!</li></ul><p><a href="https://infosec.space/tags/Lynx" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Lynx</span></a> <a href="https://infosec.space/tags/Browser" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Browser</span></a> <a href="https://infosec.space/tags/Accessibility" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Accessibility</span></a> <a href="https://infosec.space/tags/sarcasm" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>sarcasm</span></a> <a href="https://infosec.space/tags/Tor" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Tor</span></a></p>
Dr.Kidpixo 🔢☄🔨💻 ⌨️ 🐍🐧<p>I used the nice <a href="https://mastodon.uno/tags/pdoc" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>pdoc</span></a> <a href="https://pdoc.dev/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="">pdoc.dev/</span><span class="invisible"></span></a> package to **really** easily generate my <a href="https://mastodon.uno/tags/python" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>python</span></a> package documentation.<br>I am hitting the walls of this simplicity and looking for alternatives.<br>I tried <a href="https://mastodon.uno/tags/sphinx" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>sphinx</span></a> a while ago and didn't really liked it.<br><a href="https://mastodon.uno/tags/mkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mkdocs</span></a> seems nice.<br>any ideas about one of those or advantages/experiences?</p>
Sven Jacobs :androidHead:<p>What is the de facto standard for creating static <a href="https://androiddev.social/tags/documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>documentation</span></a> websites for <a href="https://androiddev.social/tags/OpenSource" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OpenSource</span></a> libraries? So far I've found <a href="https://androiddev.social/tags/Docusaurus" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Docusaurus</span></a> and <a href="https://androiddev.social/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a>, which both are popular options. I like that MkDocs' sources are <a href="https://androiddev.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Markdown</span></a> files. What else should I consider? Any suggestions?</p><p><a href="https://androiddev.social/tags/AskFedi" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>AskFedi</span></a> <a href="https://androiddev.social/tags/docs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>docs</span></a></p>
Kevin Karhan :verified:re: substack, nazis
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://soc.megatokyo.moe/users/wyatt" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>wyatt</span></a></span> +1</p><p>I may just use <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a>-<a href="https://infosec.space/tags/Material" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Material</span></a> if I ever setup a <a href="https://infosec.space/tags/blog" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>blog</span></a>.</p><p><a href="https://infosec.space/tags/MkDocsMaterial" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocsMaterial</span></a> <a href="https://infosec.space/tags/CMS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>CMS</span></a> <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Markdown</span></a></p>
Taffer 🇨🇦 :godot:<p>You'd think generating Markdown docs from Python docstrings would be straightforward and common, but apparently not.</p><p>Couldn't get lazydocs to work, reading some other things now…</p><p>On the plus side, I can just toss the `.md` files in the right spot, commit them to Codeberg, and get hosted API docs.</p><p>If I can't get this to work I can use mkdocs to pull the docstrings, generate HTML and host it on my website. 🤷 </p><p><a href="https://mastodon.gamedev.place/tags/python" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>python</span></a> <a href="https://mastodon.gamedev.place/tags/markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>markdown</span></a> <a href="https://mastodon.gamedev.place/tags/lazydocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>lazydocs</span></a> <a href="https://mastodon.gamedev.place/tags/mkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mkdocs</span></a> <a href="https://mastodon.gamedev.place/tags/codeberg" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>codeberg</span></a></p>
Timothée Mazzucotelli :python:<p>Is there someone working at <a href="https://fosstodon.org/tags/Meta" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Meta</span></a> that could relay this? <a href="https://fosstodon.org/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a> is getting test PRs from trainees, apparently coming from a Meta course on Coursera. See <a href="https://github.com/mkdocs/mkdocs/pull/3965" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/mkdocs/mkdocs/pull/</span><span class="invisible">3965</span></a> and many other similar PRs in the tracker.</p>
lothar<p><span class="h-card" translate="no"><a href="https://social.wildeboer.net/@jwildeboer" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>jwildeboer</span></a></span> <br>That is not just a good tip, but actually a hard requirement in many style guides for technical documentation. <br>For HTML output, you can avoid having to remember it via something like this: <br><a href="https://squidfunk.github.io/mkdocs-material/reference/tooltips/?h=abbreviation#adding-abbreviations" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">squidfunk.github.io/mkdocs-mat</span><span class="invisible">erial/reference/tooltips/?h=abbreviation#adding-abbreviations</span></a></p><p><a href="https://social.tchncs.de/tags/mkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mkdocs</span></a></p>
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://jorts.horse/@kobilacroix" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>kobilacroix</span></a></span> if you just want a cheap &amp; simple website, that is still easy.</p><p>One option beyond <em>"Overkill-<a href="https://infosec.space/tags/CMS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>CMS</span></a>||es"</em> like <a href="https://infosec.space/tags/WordPress" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>WordPress</span></a> are <em>"<a href="https://infosec.space/tags/OfflineCMS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OfflineCMS</span></a>|es"</em> like <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a>-Material that allow for simple <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Markdown</span></a> editing and clean <a href="https://infosec.space/tags/HTML" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>HTML</span></a> whilst offering <a href="https://infosec.space/tags/search" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>search</span></a> functionality.</p><p>Also there are more <a href="https://infosec.space/tags/Webhosters" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Webhosters</span></a> than ever before...</p>
Miguel Afonso Caetano<p>"Most guides to docs like code, even the ones for non-devs, assume you have some developer knowledge: maybe you're already using version control, or you've encountered build pipelines before, or you're working alongside developers.</p><p>This guide is for the people who read that paragraph and wished it came with a glossary. This is docs like code for people who don't know what git is and have never installed VS Code.</p><p>This post explains terminology and concepts, to help you get a mental model of what's going on. If you prefer to dive in and pick up concepts as you go, skip straight to the tips in How to learn, and come back to the conceptual info as needed."</p><p><a href="https://deborahwrites.com/blog/docs-like-code-basic-intro/" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">deborahwrites.com/blog/docs-li</span><span class="invisible">ke-code-basic-intro/</span></a> </p><p><a href="https://tldr.nettime.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>TechnicalWriting</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>SoftwareDocumentation</span></a> <a href="https://tldr.nettime.org/tags/SoftwareDevelopment" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>SoftwareDevelopment</span></a> <a href="https://tldr.nettime.org/tags/Programming" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Programming</span></a> <a href="https://tldr.nettime.org/tags/DocsAsCode" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>DocsAsCode</span></a> <a href="https://tldr.nettime.org/tags/Git" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Git</span></a> <a href="https://tldr.nettime.org/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Markdown</span></a> <a href="https://tldr.nettime.org/tags/TechnicalCommunication" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>TechnicalCommunication</span></a> <a href="https://tldr.nettime.org/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a> <a href="https://tldr.nettime.org/tags/VSCode" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>VSCode</span></a></p>
Kevin Karhan :verified:<p><a href="https://infosec.space/tags/discord" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>discord</span></a> <a href="https://www.youtube.com/watch?v=2LhiCP8AQWs" rel="nofollow noopener" target="_blank"><em>IS LITERALLY THE PROBLEM!</em></a></p><ul><li><p>It's worse than any <a href="https://infosec.space/tags/IRC" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>IRC</span></a>, <a href="https://infosec.space/tags/Mumble" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Mumble</span></a> or even the old <a href="https://infosec.space/tags/TeamSpeak" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>TeamSpeak</span></a> &amp; <a href="https://infosec.space/tags/Skype" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Skype</span></a> for that matter.</p></li><li><p>It combines the disadvantages of <a href="https://infosec.space/tags/Forum" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Forum</span></a>, <a href="https://infosec.space/tags/paywalled" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>paywalled</span></a> <a href="https://infosec.space/tags/documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>documentation</span></a>, <a href="https://infosec.space/tags/chat" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>chat</span></a> and <a href="https://infosec.space/tags/voicechat" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>voicechat</span></a> with 0 redeeming qualities (unlike <a href="https://infosec.space/tags/Zulip" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Zulip</span></a> &amp; Mumble &amp; <a href="https://infosec.space/tags/XMPP" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>XMPP</span></a>+<a href="https://infosec.space/tags/OMEMO" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>OMEMO</span></a>) it's just an <a href="https://infosec.space/tags/InformationBlackhole" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>InformationBlackhole</span></a>!</p></li></ul><p>I'm shure fecking <a href="https://infosec.space/tags/dread" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>dread</span></a> has better moderation and I'd rather use <a href="https://infosec.space/tags/MicrosoftTeams" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MicrosoftTeams</span></a> + <a href="https://infosec.space/tags/Slack" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Slack</span></a> cuz those at least have proper <a href="https://infosec.space/tags/moderation" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>moderation</span></a> tools.</p><ul><li>And I'd rather subscribe to the <a href="https://infosec.space/tags/LKML" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>LKML</span></a> and see my inbox getting hosed than using any shitty <a href="https://infosec.space/tags/SaaS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>SaaS</span></a>!</li></ul><p>Case in point: I'd rather <a href="https://infosec.space/tags/SelfHost" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>SelfHost</span></a> all my comms infrastructure than to ever use something like Discord or any other <a href="https://infosec.space/tags/GDPR" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>GDPR</span></a>-violating SaaS that is just enshittification.</p><p>I'd rather recommend people to instead choose a tool that does <em>everything but horrible</em> to go with multiple <em>smaller &amp; good tools</em></p><ul><li>Public Chat? IRC!</li><li>Group Voicechat? Mumble.</li><li><a href="https://infosec.space/tags/Documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Documentation</span></a>? <a href="https://infosec.space/tags/mkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mkDocs</span></a>-material.</li><li>1:1 Chats? XMPP+OMEMO.</li><li>E2EE Group Chats? <a href="https://infosec.space/tags/deltaChat" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>deltaChat</span></a>.</li><li>E2EE Calls? <a href="https://infosec.space/tags/WebCall" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>WebCall</span></a>.</li><li>Filehosting? <a href="https://infosec.space/tags/IPFS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>IPFS</span></a>, <a href="https://infosec.space/tags/BitTorrent" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>BitTorrent</span></a>, oshi.at, etc. ...</li><li>…</li></ul><p>Check <span class="h-card" translate="no"><a href="https://mas.to/@alternativeto" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>alternativeto</span></a></span> and <span class="h-card" translate="no"><a href="https://mastodon.social/@european_alternatives" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>european_alternatives</span></a></span> for options.</p>
Kevin Karhan :verified:<p>Shoutout to <span class="h-card" translate="no"><a href="https://fosstodon.org/@squidfunk" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>squidfunk</span></a></span> for making <a href="https://squidfunk.github.io/mkdocs-material/" rel="nofollow noopener" target="_blank">Material for MkDocs</a> which comes with a metric ton of <a href="https://infosec.space/tags/QualityOfLife" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>QualityOfLife</span></a> improvements like <a href="https://squidfunk.github.io/mkdocs-material/plugins/privacy/" rel="nofollow noopener" target="_blank">being easily able to self-host all assets</a> and <a href="https://squidfunk.github.io/mkdocs-material/setup/ensuring-data-privacy/" rel="nofollow noopener" target="_blank">thus comply</a> with <a href="https://infosec.space/tags/privacy" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>privacy</span></a> <a href="https://infosec.space/tags/laws" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>laws</span></a> whilst being as <a href="https://squidfunk.github.io/mkdocs-material/setup/" rel="nofollow noopener" target="_blank">easy to setup</a> as the regular <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a>.</p><ul><li>I'll propably make more use of it in the future since the <a href="https://www.mkdocs.org" rel="nofollow noopener" target="_blank">original MkDocs</a> seems to <a href="https://github.com/mkdocs/mkdocs/issues/2171" rel="nofollow noopener" target="_blank">still use</a> <em>"<a href="https://infosec.space/tags/CDN" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>CDN</span></a>|s"</em> like <a href="https://infosec.space/tags/ClownFlare" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>ClownFlare</span></a> / <a href="https://infosec.space/tags/CloudFlare" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>CloudFlare</span></a> and <a href="https://infosec.space/tags/GoogleFonts" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>GoogleFonts</span></a>...</li></ul>
everton137Static multi language site on GitHub Pages
Joop Knoop<p><span class="h-card" translate="no"><a href="https://mathstodon.xyz/@ngons" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>ngons</span></a></span> Blog looks good. Unfortunately you didn’t describe the details of installing <a href="https://mastodon.social/tags/Jekyll" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Jekyll</span></a> in case of problems that I had. At the end I went for <a href="https://mastodon.social/tags/mkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mkdocs</span></a> which has a much easier workflow (I think, since I was not able to use <a href="https://mastodon.social/tags/jekyll" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>jekyll</span></a> ).</p>
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://techhub.social/@memesmadetorunonlinux" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>memesmadetorunonlinux</span></a></span> you know what's real <a href="https://infosec.space/tags/GigaChad" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>GigaChad</span></a> in terms of <a href="https://infosec.space/tags/Presentations" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Presentations</span></a>?</p><ul><li>When you write <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Markdown</span></a> that gets converted into HTML + <a href="https://infosec.space/tags/LaTeX" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>LaTeX</span></a> and then spit out to into indexed, searchable and chapter'd <a href="https://infosec.space/tags/PDF" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>PDF</span></a>|s.</li></ul><p>For everyone else there's <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a> (or rather <a href="https://infosec.space/tags/MkDocsMaterial" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocsMaterial</span></a>) for making beautiful <a href="https://infosec.space/tags/HTML" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>HTML</span></a> presentations...</p>
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://fediscience.org/@sbrl" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>sbrl</span></a></span> and I guess <a href="https://infosec.space/tags/LibreOffice" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>LibreOffice</span></a> Draw isn't an option?</p><p>Then consider using <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a> and make <a href="https://infosec.space/tags/Web" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>Web</span></a>-based slides...</p>
Feoh<p>Thinking about transitioning my <a href="https://oldbytes.space/tags/blogging" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>blogging</span></a> from <a href="https://oldbytes.space/tags/nikola" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>nikola</span></a> to <a href="https://oldbytes.space/tags/mkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>mkdocs</span></a> </p><p>Nikola is great but I've always felt like writing in Markdown is an also ran use case, as its native lingua franca is my long time nemesis <a href="https://oldbytes.space/tags/restructuredtext" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>restructuredtext</span></a> (Hate hate HATE! :) ).</p><p>mkdocs is built from the ground up to be super simple. Give it a pile of Markdown and it'll generate a site. There's a nice plugin for generating a blog:</p><p><a href="https://github.com/squidfunk/mkdocs-material/blob/master/docs/setup/setting-up-a-blog.md" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/squidfunk/mkdocs-ma</span><span class="invisible">terial/blob/master/docs/setup/setting-up-a-blog.md</span></a></p>
GeoJulien<p>🚀 I've just released the version 1.17.0 of the RSS plugin for MkDocs: <a href="https://github.com/Guts/mkdocs-rss-plugin/discussions/342" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/Guts/mkdocs-rss-plu</span><span class="invisible">gin/discussions/342</span></a></p><p>📰 It improves the integration with the blog plugin of the awesome Material for Mkdocs framework, developed by <span class="h-card" translate="no"><a href="https://fosstodon.org/@squidfunk" class="u-url mention" rel="nofollow noopener" target="_blank">@<span>squidfunk</span></a></span> and co.</p><p>📑 More details in documentation: <a href="https://guts.github.io/mkdocs-rss-plugin/integrations/#blog-plugin-from-material-theme" rel="nofollow noopener" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">guts.github.io/mkdocs-rss-plug</span><span class="invisible">in/integrations/#blog-plugin-from-material-theme</span></a></p><p><a href="https://mapstodon.space/tags/MkdocsRssPlugin" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkdocsRssPlugin</span></a> <a href="https://mapstodon.space/tags/MaterialForMkdocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MaterialForMkdocs</span></a> <a href="https://mapstodon.space/tags/RSS" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>RSS</span></a> <a href="https://mapstodon.space/tags/json_feed" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>json_feed</span></a> <a href="https://mapstodon.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#<span>MkDocs</span></a></p>
TrendingLive feeds
About