Mathieu David released #mdBook version 0.4.51. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.4.50. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.4.49. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.4.48. https://rust-lang.github.io/mdBook/

#rust #mdBook
Does anyone know if there is a relatively simple way to make a renderer for mdBook 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… 😕

The website is built using #MDBook: https://rust-lang.github.io/mdBook

Mathieu David released #mdBook version 0.4.47. https://rust-lang.github.io/mdBook/

Mathieu David released #mdBook version 0.4.46. https://rust-lang.github.io/mdBook/

Creating a website on GitHub pages with mdBook
https://youtube.com/watch?v=x3vF9YiWBMQ
#github #mdbook #website

Mathieu David released #mdBook version 0.4.45. https://rust-lang.github.io/mdBook/

Does anyone have a tool they prefer for #writing printable #books, committing it in #git, and rendering it as static html site (or maybe just good navigation in #codeberg itself), and also rendering a nice #pdf with table of contents, footers, indices, etc.? Something like #mdbook, #bookdown, #pandoc, 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.)

Mathieu David released #mdBook version 0.4.44. https://rust-lang.github.io/mdBook/

Finally had some time to play around with #mdbook. And I must say, I am impressed.

Very easy to use, very intuitive. And the documentation is really excellent (and written as a mdbook...).

https://github.com/rust-lang/mdBook
https://rust-lang.github.io/mdBook/index.html

mdbook makes it really easy to put together some markdown files and create a good looking, browsable documentation.

#rust #markdown #documentation #hellyeah

After trying to use #mdbook for in-project #documentation, I decided that I'm using it wrong.

I want the docs to be readable both from git browsers and generated HTML. mdbook does that by converting ".md" to ".html" in links.

But then, I have a couple of .md files that should be linked but don't need to be in the index, like "COPYING.md". I don't think mdbook can do that.

I have to modify selected links (to source documentation), and it's a miss here too.

mdbook is really for books.

#rust

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.

See https://www.reddit.com/r/rust/comments/12by6u7/comment/llzsmpc/ for much more detail :-)

#i18n #markdown #mdbook

Does anyone know if https://github.com/lzanini/mdbook-katex 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?

#rustlang #mdbook #math #documentation

Thanks to @kdarkhan, we have a new release of mdbook-i18n-helpers: https://github.com/google/mdbook-i18n-helpers/releases/tag/mdbook-i18n-helpers-0.3.3

This release fixes bugs in the handling of inline HTML in your #Markdown and it adds support for #Gettext translation comments.

#mdbook #i18n #translation

Mathieu David released #mdBook version 0.4.38. https://rust-lang.github.io/mdBook/

I have gotten more translations from the wonderful #rust community! This time a #turkish 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:

https://github.com/google/comprehensive-rust/pull/1971

#localization #rustlang #mdbook #education #training

been playing around with #tailscale a lot more since I've been using my ipad for more terminal work. can't work out why I can't reverse proxy `mdbook serve` (used `tailscale serve 3000`), so in the end I used file serve mode. A little gotcha: need to use $(pwd) otherwise tailscale complains: `tailscale scale $(pwd)` (assuming you're in the book directory of your #mdbook dir. there's a ticket open for this problem looks like some kind of os current working directory issue: https://github.com/tailscale/tailscale/issues/10213