Loading...

What tool/framework makes nice command line tutorials?

Post date: 2020-10-23 11:32:40
Views: 11
I need to author some step by step tutorials for using command line tools together. I've seen some slick frameworks that make it easy for users to copy the exact command needed to run it in the terminal and see what the output should look like but am striking out on finding such a tool.

Katacoda looks close but is overkill - I don't need containers for users to be working in, just HTML they can read to get information from, an easy way to cut shell commands verbatim, and images of what they should see if things worked correctly.

Basically I need something like this:

block of normal text explaining what the user is about to do]
block of monospaced text that's the command to run] easy button to copy the command]
image of what the results should look like]
block of normal text explaining what's significant about the results]

Repeat until the sequence of commands is complete.

Or:

block of normal text explaining a challenge for the user to solve on their own]
a hint that the user must click to see]
a second hint the user must click to see]
the solution in monospaced text (hidden until the user clicks on it)] easy button to copy the command]
image of what they should see (similarly hidden until the solution is clicked)]
block of normal text explaining the challenge (similarly hidden until the solution is clicked)]

It looks like Jeckyl might do this with some coaxing? Is there an out-of-the-box framework that does this? I'm fine writing markdown but would prefer to avoid XML.
Number of Comments
Please click Here to read the full story.
 
Other Top and Latest Questions:
Databand raises $14.5M led by Accel for its data pipeline observability tools
Ankorstore raises $29.9 million for its wholesale marketplace
Infogrid raises $15.5M from Northzone to retrofit buildings with ‘smart’ IoT
Revolut launches early salary feature in the UK and web app
Voi, the European ‘micromobility’ rental company, raises $160M additional equity and debt funding
Isn't it possible to favorite a custom page?
Can I use Amazon or eBay shower faucet cartridge to fix my shower leak?
Ramble on
Should I stay in a country because of jobs or should I move?
Seeking personal recommendations for male therapist in Seattle area