fosstodon.org is one of the many independent Mastodon servers you can use to participate in the fediverse.
Fosstodon is an invite only Mastodon instance that is open to those who are interested in technology; particularly free & open source software. If you wish to join, contact us for an invite.

Administered by:

Server stats:

10K
active users

#mdbook

0 posts0 participants0 posts today
Jor ☝️😐<p><a href="https://eldritch.cafe/tags/rust" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>rust</span></a> <a href="https://eldritch.cafe/tags/mdBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdBook</span></a><br>Does anyone know if there is a relatively simple way to make a renderer for <em>mdBook</em> that could access and modify the generated HTML output of the default HTML renderer before it is written to the HTML files? Or do I need to fork the existing HTML renderer? Because it does not exactly look like a simple task… 😕</p>
Muntashir Akon<p>The website is built using <a href="https://infosec.exchange/tags/MDBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>MDBook</span></a>: <a href="https://rust-lang.github.io/mdBook" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook</span><span class="invisible"></span></a></p>
Patch Notification Robot 🔔<p>Mathieu David released <a href="https://mastodon.social/tags/mdBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdBook</span></a> version 0.4.47. <a href="https://rust-lang.github.io/mdBook/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook/</span><span class="invisible"></span></a></p>
Patch Notification Robot 🔔<p>Mathieu David released <a href="https://mastodon.social/tags/mdBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdBook</span></a> version 0.4.46. <a href="https://rust-lang.github.io/mdBook/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook/</span><span class="invisible"></span></a></p>
Jean-Marc Autexier<p>Creating a website on GitHub pages with mdBook<br> <a href="https://youtube.com/watch?v=x3vF9YiWBMQ" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">youtube.com/watch?v=x3vF9YiWBM</span><span class="invisible">Q</span></a><br><a href="https://social.saarland/tags/github" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>github</span></a> <a href="https://social.saarland/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a> <a href="https://social.saarland/tags/website" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>website</span></a></p>
Patch Notification Robot 🔔<p>Mathieu David released <a href="https://mastodon.social/tags/mdBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdBook</span></a> version 0.4.45. <a href="https://rust-lang.github.io/mdBook/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook/</span><span class="invisible"></span></a></p>
Kris Hardy ☀️⛱️<p>Does anyone have a tool they prefer for <a href="https://mastodon.nz/tags/writing" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>writing</span></a> printable <a href="https://mastodon.nz/tags/books" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>books</span></a>, committing it in <a href="https://mastodon.nz/tags/git" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>git</span></a>, and rendering it as static html site (or maybe just good navigation in <a href="https://mastodon.nz/tags/codeberg" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>codeberg</span></a> itself), and also rendering a nice <a href="https://mastodon.nz/tags/pdf" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>pdf</span></a> with table of contents, footers, indices, etc.? Something like <a href="https://mastodon.nz/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a>, <a href="https://mastodon.nz/tags/bookdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>bookdown</span></a>, <a href="https://mastodon.nz/tags/pandoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>pandoc</span></a>, or the like? I'm flexible with the exact syntax of the docs. I'm using mdbook with mdbook-pdf at the moment. I haven't tried mdbook-latex yet. (Using something like jinja would be nice.)</p>
Patch Notification Robot 🔔<p>Mathieu David released <a href="https://mastodon.social/tags/mdBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdBook</span></a> version 0.4.44. <a href="https://rust-lang.github.io/mdBook/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook/</span><span class="invisible"></span></a></p>
Johannes Kastl<p>Finally had some time to play around with <a href="https://digitalcourage.social/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a>. And I must say, I am impressed.</p><p>Very easy to use, very intuitive. And the documentation is really excellent (and written as a mdbook...).</p><p><a href="https://github.com/rust-lang/mdBook" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">github.com/rust-lang/mdBook</span><span class="invisible"></span></a><br><a href="https://rust-lang.github.io/mdBook/index.html" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">rust-lang.github.io/mdBook/ind</span><span class="invisible">ex.html</span></a></p><p>mdbook makes it really easy to put together some markdown files and create a good looking, browsable documentation.</p><p><a href="https://digitalcourage.social/tags/rust" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>rust</span></a> <a href="https://digitalcourage.social/tags/markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>markdown</span></a> <a href="https://digitalcourage.social/tags/documentation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>documentation</span></a> <a href="https://digitalcourage.social/tags/hellyeah" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>hellyeah</span></a></p>
dorotaC<p>After trying to use <a href="https://fosstodon.org/tags/mdbook" class="mention hashtag" rel="tag">#<span>mdbook</span></a> for in-project <a href="https://fosstodon.org/tags/documentation" class="mention hashtag" rel="tag">#<span>documentation</span></a>, I decided that I&#39;m using it wrong.</p><p>I want the docs to be readable both from git browsers and generated HTML. mdbook does that by converting &quot;.md&quot; to &quot;.html&quot; in links.</p><p>But then, I have a couple of .md files that should be linked but don&#39;t need to be in the index, like &quot;COPYING.md&quot;. I don&#39;t think mdbook can do that.</p><p>I have to modify selected links (to source documentation), and it&#39;s a miss here too.</p><p>mdbook is really for books.</p><p><a href="https://fosstodon.org/tags/rust" class="mention hashtag" rel="tag">#<span>rust</span></a></p>
Martin Geisler<p>I was asked on Reddit how `mdbook-i18n-helpers` work. In short, the project gives you two `mdbook` plugins: one for extracting text from the original Markdown files and one for injecting the translations back into the original Markdown.</p><p>See <a href="https://www.reddit.com/r/rust/comments/12by6u7/comment/llzsmpc/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://www.</span><span class="ellipsis">reddit.com/r/rust/comments/12b</span><span class="invisible">y6u7/comment/llzsmpc/</span></a> for much more detail :-)</p><p><a href="https://ohai.social/tags/i18n" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>i18n</span></a> <a href="https://ohai.social/tags/markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>markdown</span></a> <a href="https://ohai.social/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a></p>
Chad Baker<p>Does anyone know if <a href="https://github.com/lzanini/mdbook-katex" target="_blank" rel="nofollow noopener noreferrer" translate="no"><span class="invisible">https://</span><span class="ellipsis">github.com/lzanini/mdbook-kate</span><span class="invisible">x</span></a> can be used to render equations in Rust doc strings? Like, I get that I can used it in book.toml in an mdbook, but can I use it in a rust crate somehow?</p><p><a href="https://fosstodon.org/tags/rustlang" class="mention hashtag" rel="tag">#<span>rustlang</span></a> <a href="https://fosstodon.org/tags/mdbook" class="mention hashtag" rel="tag">#<span>mdbook</span></a> <a href="https://fosstodon.org/tags/math" class="mention hashtag" rel="tag">#<span>math</span></a> <a href="https://fosstodon.org/tags/documentation" class="mention hashtag" rel="tag">#<span>documentation</span></a></p>
Martin Geisler<p>Thanks to <span class="h-card" translate="no"><a href="https://mastodon.social/@kdarkhan" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>kdarkhan</span></a></span>, we have a new release of mdbook-i18n-helpers: <a href="https://github.com/google/mdbook-i18n-helpers/releases/tag/mdbook-i18n-helpers-0.3.3" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/google/mdbook-i18n-</span><span class="invisible">helpers/releases/tag/mdbook-i18n-helpers-0.3.3</span></a></p><p>This release fixes bugs in the handling of inline HTML in your <a href="https://ohai.social/tags/Markdown" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Markdown</span></a> and it adds support for <a href="https://ohai.social/tags/Gettext" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Gettext</span></a> translation comments.</p><p><a href="https://ohai.social/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a> <a href="https://ohai.social/tags/i18n" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>i18n</span></a> <a href="https://ohai.social/tags/translation" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>translation</span></a></p>
Patch Notification Robot 🔔<p>Mathieu David released <a href="https://botsin.space/tags/mdBook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdBook</span></a> version 0.4.38. <a href="https://rust-lang.github.io/mdBook/" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook/</span><span class="invisible"></span></a></p>
Martin Geisler<p>I have gotten more translations from the wonderful <a href="https://ohai.social/tags/rust" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>rust</span></a> community! This time a <a href="https://ohai.social/tags/turkish" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>turkish</span></a> translation of the first day of Rust Fundamentals. If you know someone who are interested in reviewing translations of Rust training material, please send them my way:</p><p><a href="https://github.com/google/comprehensive-rust/pull/1971" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/google/comprehensiv</span><span class="invisible">e-rust/pull/1971</span></a></p><p><a href="https://ohai.social/tags/localization" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>localization</span></a> <a href="https://ohai.social/tags/rustlang" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>rustlang</span></a> <a href="https://ohai.social/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a> <a href="https://ohai.social/tags/education" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>education</span></a> <a href="https://ohai.social/tags/training" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>training</span></a></p>
Martin Geisler<p>Thanks to amazing work by Max Heller, you can now download all five <a href="https://ohai.social/tags/Rust" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Rust</span></a> courses in Comprehensive Rust as a 375-page PDF! They're generated using <a href="https://ohai.social/tags/pandoc" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>pandoc</span></a> from the <a href="https://ohai.social/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a> sources. You'll find them for every translation too:</p><p>- English: <a href="https://google.github.io/comprehensive-rust/comprehensive-rust.pdf" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">google.github.io/comprehensive</span><span class="invisible">-rust/comprehensive-rust.pdf</span></a><br>- Korean: <a href="https://google.github.io/comprehensive-rust/ko/comprehensive-rust.pdf" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">google.github.io/comprehensive</span><span class="invisible">-rust/ko/comprehensive-rust.pdf</span></a><br>- Spanish: <a href="https://google.github.io/comprehensive-rust/es/comprehensive-rust.pdf" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">google.github.io/comprehensive</span><span class="invisible">-rust/es/comprehensive-rust.pdf</span></a></p><p>etc. See <a href="https://github.com/google/comprehensive-rust/pull/1572" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="ellipsis">github.com/google/comprehensiv</span><span class="invisible">e-rust/pull/1572</span></a> for the tooling Max wrote.</p>
Jarkko Sakkinen<p>With <a class="hashtag" href="https://social.kernel.org/tag/mdbook" rel="nofollow noopener noreferrer" target="_blank">#mdbook</a>, any ideas how to:</p><ol><li>Disable theme picker.</li><li>Enforce light theme especially never pick vomit looking navy on any possible machine…</li></ol><p><a class="hashtag" href="https://social.kernel.org/tag/rustlang" rel="nofollow noopener noreferrer" target="_blank">#rustlang</a></p>
[Nima@NimaOS ~]# :t_blink:<p>New Video!<br>Make a Book for Free with mdBook, A static site generator written in Rust :)</p><p><a href="https://youtu.be/O0S0w-xiq-4" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">youtu.be/O0S0w-xiq-4</span><span class="invisible"></span></a></p><p><a href="https://mstdn.social/tags/Programming" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Programming</span></a> <br><a href="https://mstdn.social/tags/GitHub" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>GitHub</span></a> <br><a href="https://mstdn.social/tags/Rust" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>Rust</span></a> <br><a href="https://mstdn.social/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a></p>
Sam Howell<p>Thanks to <a href="https://fosstodon.org/tags/mdbook" class="mention hashtag" rel="tag">#<span>mdbook</span></a>, I&#39;m well on my way to finally completing my private <a href="https://fosstodon.org/tags/wiki" class="mention hashtag" rel="tag">#<span>wiki</span></a> / <a href="https://fosstodon.org/tags/docs" class="mention hashtag" rel="tag">#<span>docs</span></a> for all things <a href="https://fosstodon.org/tags/tech" class="mention hashtag" rel="tag">#<span>tech</span></a>: home network, desktop, mobile, code snippets and so on, guides I&#39;m sure I&#39;ll be glad I can easily reference again someday. </p><p>I started my wiki some time ago, but only recently got the momentum back to make real progress with it. It&#39;s a good feeling. <a href="https://fosstodon.org/tags/documentation" class="mention hashtag" rel="tag">#<span>documentation</span></a>.<br /><a href="https://rust-lang.github.io/mdBook/" target="_blank" rel="nofollow noopener noreferrer" translate="no"><span class="invisible">https://</span><span class="">rust-lang.github.io/mdBook/</span><span class="invisible"></span></a></p>
ppom<p><a href="https://mamot.fr/tags/reaction" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>reaction</span></a>'s wiki now features a very shiny ✨ website based on <a href="https://mamot.fr/tags/mdbook" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#<span>mdbook</span></a> and available here: <a href="https://reaction.ppom.me" rel="nofollow noopener noreferrer" translate="no" target="_blank"><span class="invisible">https://</span><span class="">reaction.ppom.me</span><span class="invisible"></span></a><br>More pleasant to read, easier to contribute!<br>Thanks <span class="h-card" translate="no"><a href="https://framapiaf.org/@framasky" class="u-url mention" rel="nofollow noopener noreferrer" target="_blank">@<span>framasky</span></a></span> for the PR that made everything 😊</p>