pandoc-plot
mdBook
pandoc-plot | mdBook | |
---|---|---|
2 | 101 | |
210 | 16,754 | |
- | 2.0% | |
7.2 | 8.6 | |
26 days ago | 9 days ago | |
Haskell | Rust | |
GNU General Public License v2.0 or later | Mozilla Public License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
pandoc-plot
-
Pandoc [a universal document converter] 3.0
That's great news. I've been waiting for years for a dedicated 'Figure' element. The workaround was pretty brittle. It'll make pandoc-plot [0] easier to maintain as well.
[0]: https://github.com/LaurentRDC/pandoc-plot
-
Learn Haskell by building a blog generator – a project-oriented Haskell book
That's the perfect learning project because there's something tangible at the end.
Whenever the question of "How do I learn Haskell" comes up, I always suggest to come up with a project that would be useful on its own, regardless of the technology used to create it, and use Haskell to do it. In my case it was a pandoc filter to embed plots in documents (https://github.com/LaurentRDC/pandoc-plot), which was ultimately useful to create my PhD dissertation.
There's only so much you can learn about Haskell by working through toy examples.
mdBook
- Everything Curl
- Doks – Build a Docs Site
-
Ask HN: How do you organize software documentation at work?
I'm responsible for a number of Java products. I try to provide high-quality Javadoc for all public library interfaces, library user's guides where appropriate, and development guides for applications. The latter two take the form of MDBook documents (https://rust-lang.github.io/mdBook/), with the document source living in the GitHub repo so that it's tied to the particular software release in a natural way.
-
Outline: Self hostable, realtime, Markdown compatible knowledge base
My org has used mdBook: https://rust-lang.github.io/mdBook/ (That link is itself a rendered mdBook, so that'll give you an idea of the feature set.)
(While it's definitely a Rust "thing", if you just have a set of .md files, all you need is a "SUMMARY.md" (which contains the ToC) and a small config file; i.e., you don't have to have any Rust code to use it, and it works fine without. We document a large, mostly non-Rust codebase with it.)
-
Ask HN: Best tools for self-authoring books in 2023?
If you want the lowest friction, open source, easily extensible Markdown to Web, Kindle, PDF, etc. tool, highly recommend mdBook: https://github.com/rust-lang/mdBook it’s written in Rust, but you don’t have to know any Rust to use it. And then wing is all CSS; for which there are many good (free) themes.
- Early performance results from the prototype CHERI ARM Morello microarchitecture
- FLaNK Stack for 4th of July
- MdBook – A command line tool to create books with Markdown
- MdBook Create book from Markdown files. Like Gitbook but implemented in Rust
What are some alternatives?
pandoc-markdown-ghci-filter - A Pandoc filter that identifies Haskell code in Markdown, executes the code in GHCI and embeds the results in the returned Markdown.
gitbook - The open source frontend for GitBook doc sites
pandoc-pyplot
MkDocs - Project documentation with Markdown.
tintin - 📚 A softer alternative to Haddock
Wiki.js - Wiki.js | A modern and powerful wiki app built on Node.js
pandoc-emphasize-code - A Pandoc filter for emphasizing code in fenced blocks
bookdown - Authoring Books and Technical Documents with R Markdown
pantcl - Document conversion with Tcl based filters using pandoc or Tcl only. Example filter for ABC music, GraphViz, PlantUML, R, Python etc are provided.
obsidian-releases - Community plugins list, theme list, and releases of Obsidian.
pandoc-csv2table - A Pandoc filter that renders CSV as Pandoc Markdown Tables.
Docusaurus - Easy to maintain open source documentation websites.