codebraid
runbook
Our great sponsors
| codebraid | runbook | |
|---|---|---|
| 4 | 3 | |
| 362 | 32 | |
| - | - | |
| 5.2 | 0.0 | |
| 6 months ago | almost 2 years ago | |
| Python | TypeScript | |
| BSD 3-clause "New" or "Revised" License | MIT License |
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.
codebraid
-
Literate DevOps
If you want Markdown instead of Org Mode, Codebraid is great.
https://github.com/gpoore/codebraid
-
[D] 7 years since Norm Matloff's blog post "STATISTICS: LOSING GROUND TO CS, LOSING IMAGE AMONG STUDENTS". How has the statistics vs CS situation evolved?
Fortunately, literate programming is a thing, so there are still tools for that. If you want PDF/HTML output facilities, it looks like CodeBraid is the way to go. It uses the Pandoc framework, so you can do all kinds of neat things with it.
-
R Markdown: The Definitive Guide
For the Python in markdown case, you might be interested in one of my projects that allows executable Python code (including optional Jupyter kernel support) in Pandoc markdown: https://github.com/gpoore/codebraid. Pandoc does all the document parsing (there is no regex preprocessor for extracting code), so converting markdown to markdown often works particularly well.
-
How I use Pandoc to create programming eBooks
A tool that really helped me was codebraid, it allows me to keep the code and output of said code in sync really easily.
runbook
-
Literate DevOps
Also check out https://github.com/khalidx/runbook (shameless plug). Executable markdown documents that you can run. Great for DevOps and sharing commands with the team.
- Pryrite: Interactively execute shell code blocks in a Markdown file
-
Show HN: JWEB (a modern implementation of the CWEB Literate Programming system)
Interesting, going to check this out today.
I built something in a similar spirit to your comment and this larger thread, albeit a bit simplistic. Lets you document and write your bash scripts in a markdown file, then you can run the blocks. It figures out what arguments you expect in a block and turns them into CLI flags. https://github.com/khalidx/runbook
Not sure how useful it is but I use it to maintain a collection of documented bash scripts.
What are some alternatives?
mdBook - Create book from markdown files. Like Gitbook but implemented in Rust
nbterm - Jupyter Notebooks in the terminal.
rmarkdown - Dynamic Documents for R
pryrite - Pryrite, interactively execute shell code blocks in a markdown file
jupytext - Jupyter Notebooks as Markdown Documents, Julia, Python or R scripts
Pluto.jl - 🎈 Simple reactive notebooks for Julia
Neptune.jl - Simple (Pluto-based) non-reactive notebooks for Julia
gedit-plugin-markdown_preview - A gedit plugin previewing markdown (.md) documents
bert - TensorFlow code and pre-trained models for BERT
pantcl - Document conversion with Tcl based filters using pandoc or Tcl only. Example filter for ABC music, GraphViz, PlantUML, R, Python etc are provided.
ISLR - Introduction to Statistical Learning