A markdown to teach text converter ORCA shell command for the GS based on md4c.
Go to file
Jeremy Rand effa777037 Improve the pure text output of the converter. It now handles numbered and unnumbered lists. It adds a horizontal line for HR. Spacing is better between blocks. It no longer inserts a leading blank line at the top of the document.
I have extended the execution rule to put the resulting text file onto a disk image and launch an emulator so I can see the text file on the target machine.  This should make iteration easier.

Even though I am asking to print carriage returns in the output, I am getting line feeds.  Now sure what is doing the translation.  It could be the ORCA standard library (not likely) or Golden Gate (maybe).  I should next change to direct use of GS/OS for the writes and avoid the ORCA library anyway.
2021-04-21 00:00:01 -04:00
md2teach Improve the pure text output of the converter. It now handles numbered and unnumbered lists. It adds a horizontal line for HR. Spacing is better between blocks. It no longer inserts a leading blank line at the top of the document. 2021-04-21 00:00:01 -04:00
md2teach.xcodeproj Improve the pure text output of the converter. It now handles numbered and unnumbered lists. It adds a horizontal line for HR. Spacing is better between blocks. It no longer inserts a leading blank line at the top of the document. 2021-04-21 00:00:01 -04:00
LICENSE Add a readme and license file. 2021-04-13 23:53:20 -04:00
README.md Review all uses of int and unsigned and promote them to int32_t or uint32_t as required. 2021-04-16 00:26:25 -04:00

md2teach

This repository is work-in-progress to try to use md4c to create a markdown to Teach text converter ORCA shell program for the Apple //GS. You should not try to use this tool because it doesn't work yet.

The goal really is to use this shell command from GoldenGate as part of my Apple2GSBuildPipeline in order to write documentation for GS projects in a more modern file format. Also, markdown is trivial to commit to git repositories but the presence of the resource fork in Teach files make them problematic.

The files md4c.c and md4c.h are (hopefully) slightly modified versions of the files from the md4c project. It is shocking how portable that code was and it worked almost immediately. I am marking up some of my changes with the comment tag GS_SPECIFIC. In general, many unsigned types were converted to uint32_t and int types converted to int32_t.