shakedown.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
A community for live music fans with roots in the jam scene. Shakedown Social is run by a team of volunteers (led by @clifff and @sethadam1) and funded by donations.

Administered by:

Server stats:

244
active users

#mkdocs

1 post1 participant0 posts today
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://possum.city/@tauon" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>tauon</span></a></span> <span class="h-card" translate="no"><a href="https://peoplemaking.games/@PinoBatch" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>PinoBatch</span></a></span> <span class="h-card" translate="no"><a href="https://soc.megatokyo.moe/users/wyatt" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>wyatt</span></a></span> </p><p>If one wants to <a href="https://infosec.space/tags/loginwall" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>loginwall</span></a> and <a href="https://infosec.space/tags/paywall" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>paywall</span></a> it I'd say <a href="https://infosec.space/tags/Patreon" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Patreon</span></a>?</p><p>Otherwise I'd go with <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocs</span></a>-Material. <br><a href="https://infosec.space/@kkarhan/114627943252130371" translate="no" rel="nofollow noopener noreferrer" target="_blank"><span class="invisible">https://</span><span class="ellipsis">infosec.space/@kkarhan/1146279</span><span class="invisible">43252130371</span></a></p>
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 noreferrer" 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 noreferrer" target="_blank">#<span>MkDocs</span></a>-<a href="https://infosec.space/tags/Material" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Material</span></a> if I ever setup a <a href="https://infosec.space/tags/blog" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>blog</span></a>.</p><p><a href="https://infosec.space/tags/MkDocsMaterial" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocsMaterial</span></a> <a href="https://infosec.space/tags/CMS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CMS</span></a> <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Markdown</span></a></p>
lothar<p><span class="h-card" translate="no"><a href="https://social.wildeboer.net/@jwildeboer" class="u-url mention" rel="nofollow noopener noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" target="_blank">#<span>CMS</span></a>||es"</em> like <a href="https://infosec.space/tags/WordPress" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WordPress</span></a> are <em>"<a href="https://infosec.space/tags/OfflineCMS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OfflineCMS</span></a>|es"</em> like <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocs</span></a>-Material that allow for simple <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Markdown</span></a> editing and clean <a href="https://infosec.space/tags/HTML" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>HTML</span></a> whilst offering <a href="https://infosec.space/tags/search" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>Webhosters</span></a> than ever before...</p>
Kevin Karhan :verified:<p><a href="https://infosec.space/tags/discord" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>discord</span></a> <a href="https://www.youtube.com/watch?v=2LhiCP8AQWs" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>IRC</span></a>, <a href="https://infosec.space/tags/Mumble" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Mumble</span></a> or even the old <a href="https://infosec.space/tags/TeamSpeak" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TeamSpeak</span></a> &amp; <a href="https://infosec.space/tags/Skype" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>Forum</span></a>, <a href="https://infosec.space/tags/paywalled" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>paywalled</span></a> <a href="https://infosec.space/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a>, <a href="https://infosec.space/tags/chat" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>chat</span></a> and <a href="https://infosec.space/tags/voicechat" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>voicechat</span></a> with 0 redeeming qualities (unlike <a href="https://infosec.space/tags/Zulip" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Zulip</span></a> &amp; Mumble &amp; <a href="https://infosec.space/tags/XMPP" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>XMPP</span></a>+<a href="https://infosec.space/tags/OMEMO" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>OMEMO</span></a>) it's just an <a href="https://infosec.space/tags/InformationBlackhole" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" 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 noreferrer" target="_blank">#<span>MicrosoftTeams</span></a> + <a href="https://infosec.space/tags/Slack" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" target="_blank">#<span>Documentation</span></a>? <a href="https://infosec.space/tags/mkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>deltaChat</span></a>.</li><li>E2EE Calls? <a href="https://infosec.space/tags/WebCall" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WebCall</span></a>.</li><li>Filehosting? <a href="https://infosec.space/tags/IPFS" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>IPFS</span></a>, <a href="https://infosec.space/tags/BitTorrent" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" target="_blank">@<span>squidfunk</span></a></span> for making <a href="https://squidfunk.github.io/mkdocs-material/" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>QualityOfLife</span></a> improvements like <a href="https://squidfunk.github.io/mkdocs-material/plugins/privacy/" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">thus comply</a> with <a href="https://infosec.space/tags/privacy" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>privacy</span></a> <a href="https://infosec.space/tags/laws" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>laws</span></a> whilst being as <a href="https://squidfunk.github.io/mkdocs-material/setup/" rel="nofollow noopener noreferrer" target="_blank">easy to setup</a> as the regular <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">original MkDocs</a> seems to <a href="https://github.com/mkdocs/mkdocs/issues/2171" rel="nofollow noopener noreferrer" target="_blank">still use</a> <em>"<a href="https://infosec.space/tags/CDN" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CDN</span></a>|s"</em> like <a href="https://infosec.space/tags/ClownFlare" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>ClownFlare</span></a> / <a href="https://infosec.space/tags/CloudFlare" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CloudFlare</span></a> and <a href="https://infosec.space/tags/GoogleFonts" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GoogleFonts</span></a>...</li></ul>
Joop Knoop<p><span class="h-card" translate="no"><a href="https://mathstodon.xyz/@ngons" class="u-url mention" rel="nofollow noopener noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" 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 noreferrer" target="_blank">#<span>GigaChad</span></a> in terms of <a href="https://infosec.space/tags/Presentations" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>Markdown</span></a> that gets converted into HTML + <a href="https://infosec.space/tags/LaTeX" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" 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 noreferrer" target="_blank">#<span>MkDocs</span></a> (or rather <a href="https://infosec.space/tags/MkDocsMaterial" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocsMaterial</span></a>) for making beautiful <a href="https://infosec.space/tags/HTML" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">@<span>sbrl</span></a></span> and I guess <a href="https://infosec.space/tags/LibreOffice" class="mention hashtag" rel="nofollow noopener noreferrer" 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 noreferrer" target="_blank">#<span>MkDocs</span></a> and make <a href="https://infosec.space/tags/Web" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Web</span></a>-based slides...</p>
Matt Shaw<p>I've written a guide to building a highly customisable, lightweight, secure, and performant static site using <a href="https://mastodon.me.uk/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocs</span></a>, <a href="https://mastodon.me.uk/tags/NGINX" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>NGINX</span></a> and <a href="https://mastodon.me.uk/tags/Docker" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Docker</span></a>: <a href="https://matthew-shaw.github.io/blog/2024/11/04/building-a-static-site-with-mkdocs-nginx-and-docker/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">matthew-shaw.github.io/blog/20</span><span class="invisible">24/11/04/building-a-static-site-with-mkdocs-nginx-and-docker/</span></a></p>
Kevin Karhan :verified:<p><span class="h-card" translate="no"><a href="https://missiletest.site/users/Ariri" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>Ariri</span></a></span> unless you want custom-engineer your own <a href="https://infosec.space/tags/Markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Markdown</span></a> -&gt; <a href="https://infosec.space/tags/LaTeX" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>LaTeX</span></a> -&gt; <a href="https://infosec.space/tags/Ghostscript" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Ghostscript</span></a> pipeline like <span class="h-card" translate="no"><a href="https://oxytodon.com/@fuchsiii" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>fuchsiii</span></a></span> did, consider <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocs</span></a> as an <a href="https://www.mkdocs.org" rel="nofollow noopener noreferrer" target="_blank">easy solution to turn Markdown files</a> into sleek <a href="https://infosec.space/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> with <a href="https://www.mkdocs.org/getting-started/" rel="nofollow noopener noreferrer" target="_blank">minimal configuration needed</a>.</p><ul><li>I've set it up multiple times and by just <a href="https://www.mkdocs.org/user-guide/configuration/#docs_dir" rel="nofollow noopener noreferrer" target="_blank">changing the</a> <code>docs_dir</code> to like <code>source</code> and the <code>site_dir</code> <a href="https://www.mkdocs.org/user-guide/configuration/#site_dir" rel="nofollow noopener noreferrer" target="_blank">to</a> <code>docs</code> you can use <a href="https://infosec.space/tags/GithubPages" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GithubPages</span></a> for <a href="https://infosec.space/tags/hosting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>hosting</span></a> said <a href="https://infosec.space/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a>...</li></ul><p>That should provide you with an easy way to present stuff in an intuitive way...</p><ul><li>Also proper <a href="https://infosec.space/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> is nice and <a href="https://en.wikipedia.org/wiki/Markdown" rel="nofollow noopener noreferrer" target="_blank">Markdown</a> is <a href="https://www.markdownguide.org/cheat-sheet/" rel="nofollow noopener noreferrer" target="_blank">very easy to write and edit</a> with <a href="https://vscodium.com" rel="nofollow noopener noreferrer" target="_blank">Editors like</a> <a href="https://infosec.space/tags/Codium" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Codium</span></a> a direct &amp; instant preview.</li></ul><p>I myself can't he assed writing <a href="https://infosec.space/tags/HTML5" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>HTML5</span></a> / <a href="https://infosec.space/tags/CSS3" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>CSS3</span></a> / <a href="https://infosec.space/tags/JS6" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>JS6</span></a> or wahtever <a href="https://infosec.space/tags/cursed" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>cursed</span></a> <a href="https://infosec.space/tags/WebApp" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>WebApp</span></a> <a href="https://infosec.space/tags/TechStack" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>TechStack</span></a> is trendy tthese days so I use <a href="https://infosec.space/tags/MkDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MkDocs</span></a> all the time...</p>