literate.c.md

C literate example

This is an example of C programming, in the style promoted by Knuth called literate programming. The text is encoded using Markdown.

More about literate programming:

• https://en.wikipedia.org/wiki/Literate_programming
• https://es.wikipedia.org/wiki/Programaci%C3%B3n_literaria
• https://ca.wikipedia.org/wiki/Programaci%C3%B3_liter%C3%A0ria

The program

The simplest C program:

#include <stdio.h>

int main(int argc, char **argv)
{
    printf("That's all Folks!\n");
    return 0;
}

Fancy, doensn't it?

How to evaluate?

Simply run this command in the Shell:

$ ./run-md literate.c.md 
>>> Running: literate.c.md
That's all Folks!

How to publish?

Install MarkDown processors:

MANAGER=yum
which dnf >/dev/null 2>&1 && MANAGER=dnf
which apt-get >/dev/null 2>&1 && MANAGER=apt-get
sudo $MANAGER -y install pandoc texlive

and execute make build in this directory! HTML and PDF output formats are generated. Check with any HTML browser and PDF viewer:

elinks literate.c.html
evince literate.c.pdf