literate.cpp.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 <iostream>
 
int main () {
    std::cout << "That's all Folks!" << std::endl;
}

Fancy, doensn't it?

How to evaluate?

Simply run this command in the Shell:

$ ./run-md literate.cpp.md 
>>> Running: literate.cpp.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.cpp.html
evince literate.cpp.pdf