![]() ![]() He then continues to be abrasive on the issue. To be clear, I do not think everyone in this issue is from some sort of "outside." But there's at least one person in that thread who started on it immediately after publicly trashing Rust. I don't see anywhere in its README.md that says you need to be a Rust user to use mdBook. > It has been "bombed" by people who use mdBook. There have been periods with effectively no maintenance. The original author wrote enough for his purposes, I tweaked stuff for my purposes, but it's never been anyone's specific focus. Part of why this has taken a while is that mdbook has not had particularly strong leadership over its existence, due to what I said. It's effectively in a holding pattern where nobody has responded to the maintainer's feedback about the PR, either by updating the original PR or opening a new one. This conversation was continued in the issue, and the PR author did not respond. As you can see from that PR, it is unclear what the procedure is to get said PR merged there's assertions that this is breaking, and assertions that it is not. > It has had a PR since day one, from the same person that opened the issue.Ībsolutely, and I'm appreciative of that. : this made it easier for me to add the themes, and includes more beyond the ones bundled with adoc: It even shows anchor links to the headings when you hover over them. AsciiDoctor has a good default theme as well as a number of other themes available, and by default will embed the CSS into the HTML so you just have one file to distribute. TEXTASTIC R MARKDOWN HOW TOIf you just turn MD into HTML you get ugly garbage and need to figure out how to put CSS into the HTML etc. ![]() But AsciiDoctor compiles it to everything from DocBook XML to HTML to Markdown to ePub to PDF.Īnother thing I like is that AsciiDoctor actually comes with a good default stylesheet. It is a syntactic sugar layer on the DocBook XML format which is apparently used to make actual books. Also it actually has first-class support for things like footnotes and admonitions etc. TEXTASTIC R MARKDOWN CODEThere's only one way to mark the language of a code block, only one way to make lists, only one way to make footnotes, etc. But it's more structured, much more fully featured, just two big implementations (AsciiDoc and AsciiDoctor) which are largely compatible. The syntax is similar enough to MD that just having the adoc cheatsheet bookmarked is enough to switch. I recently switched from Markdown to AsciiDoc. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |