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:

9.8K
active users

#bookdown

0 posts0 participants0 posts today

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.)

I just updated the tutorial for the r.suitability.regions addon for . I took the opportunity to change it from the excellent to the even better format, which is what I use for my website as well. In my experience, Quarto format offers a more streamlined experience and more out-of-the-box options to tweak the page layout, placement of figures, etc.

You can find the tutorial on ecodiv.earth/TutorialsNotes/Su

Replied to Henrik Sørlie

@hsorlie I wrote tutorials and other content in both using the package and . They are very similar.

The newer Quarto took a lot of good stuff from Bookdown, but it also offers convenient extra's and i.m.h.o. a more streamlined experience. Dealing with figures and page layout is much easier, for example.

Converting from one to the other isn't that difficult, I actually just migrated one of my older tutorials from Bookdown to Quarto.

I'd like to include alttext for figures in an online bookdown book that I'm updating, written in Rmd. Can anyone help?
I thought I could do this with syntax like this: {r weightplot-1,echo=FALSE, include=TRUE,message=FALSE, warnings=FALSE, fig.cap="mycaption",alt="myalttext",out.width="75%"} but although that runs, I can't see the alttext in the resulting html.
#alttext #bookdown

@michelnivard@fediscience.org @ERDonnachie yeah this is a problem I ran into in my previous job. We generated user documentation using RMarkdown and the `bookdown` package because lots of the content was code-generated reference tables. But we still needed input from non-technical staff.

It ended up being less effort for us to export a Word doc version and have them track changes then manually copy them over when they were finalized but it felt unsustainable.