From b494bacded18d5cbf6e03a2a27b54fa4357a8dd7 Mon Sep 17 00:00:00 2001 From: Christopher James Hayward Date: Thu, 4 Feb 2021 16:56:33 -0500 Subject: [PATCH] Update example --- docs/daily/2021-02-04.org.gpg | Bin 940 -> 996 bytes docs/notes/literate-programming.org.gpg | Bin 1609 -> 1461 bytes website/content/notes/literate-programming.md | 17 +++-------------- 3 files changed, 3 insertions(+), 14 deletions(-) diff --git a/docs/daily/2021-02-04.org.gpg b/docs/daily/2021-02-04.org.gpg index 34be7246a506d370fa0021cee40bea0584af0c89..5fb0841a8e6763b790504df0d3a6e3e395094152 100644 GIT binary patch literal 996 zcmV0t^G>9JMNFPA5765CDs&TU`&a6}Mwey&RotL3FyQNI&LVU0PO`VedU( zEREK|efr@-u+VJxNWS}!HZ7G*Op#~x!AqysmvjqN@yn({#T#X^Jri>G784+rHLy8O zS%d!s;eu z#tmzwFx+p~_i&L=u#l!2`4j_xa&!xc-S|BXraOdg=I1mzr-|Y8epoi6y7r%#k0R0c z51}PtbjcgPmZL!jB)=QbwNS3Pt&JRKrqNL^r^!i^#to!y@yx4WZtI2^E@Kac~S+rtl7=Tj#e(YQ%Ysqc1 zE)NB(WM%je{&!*pI2ECX{+313W`bTCNeDfN19&Fv6X_2_KEns;ewG_)hio}}r($$b zDl!%5OxJ%sHlwOfGN?OrmQjJA!8nMsSgP^+>-HYxI>#_*x!Yc(4kXJK zMC?P=xgPMk=@)ms9G9Su$an7mmFrb}RvD`Zwfy6%>rFpetLU}qhsmWZUk)^+15LK) S?vq@us9JMNFPA5765CDMvu1hC<6SBvObTMbh*h1$ z-d@Mt6Rgq1cc~H5rVF3Z+Qmb9*6m~8Q555p9p!`g8z5x|sK&;&Rs&MnjHoBlj5t$A zA?gvUOsO?@&CGYO{X^G0YldFoerfH3WHYS0u|R^~9**aFUZuG=K8=5zGP>X!QpQp5 z;c1y*sRg(!{OaBAp3T6FlqOg4*OLAb5C4uyw+O=_W&dHhlQ8d<7>aukwM_}CoS-9M z4tj}ywm?-)$Jbs!3;ursCBnQnTH$+C%4eT>;hC%4fu>4Ty$`2YHJ%%H&;STq$zr73 zwPd{qU$3%8QFg@A9;3M?5r&wC1;F*_RYRDbB8hfb8+K+O@MV`!JiUeshb1?W0wcLaXVQ&=7zy~RgW+m7(t;~>4BIcdp3 z7ASzh!_;6i%>egjrKu|c-zpt#TOPff4#ITT&%l?{QU`c>u6ZZ|_h|oS7IqH_;rezX zY%Q>ZS0y8q#jbXQ*duiw8^~g`O)6q19y!S@M)AL7rhD`}`Y4lsJ1$NPogCZC>mHW$ zWJ=#Z-)YUZY6@^t!-Gg^%D!GdaA^YX4!#A+qMO{9v|jCGfCJreH$E zANLU%v1fU5H0{UfPg&By+5sju%QbU)wdR$@OPV`mvq!MfBFiLVzf};cEuDl~p{d;? zme{)>pFU+J^#BXxtu*3r#;fxRjAYW|TCo z@9GSY*&G-)MA}d;FjGI%gW2{DZKBEozSGjZZJj#4@>(`87p}P7EyK zdrfzI$>@{TMx|L(fxW9Bh=g?S^!36PZ!LM$R!^*1#*&4V$5_hPg}_)?ilh5xI2R82 zA3E$UV*r^V^Oft;dyLpwss9t8yarl;wV4Nh15OpTD$wR&t0RSP<@Ogd(6UE!+(`_N OwSPk-ZS>-eG3+MjSlRLb diff --git a/docs/notes/literate-programming.org.gpg b/docs/notes/literate-programming.org.gpg index 73e70709ff542eeb3a2dfccbe973094ff5125a08..5933876d83d1a2bb213e72d2c0519d01ca684a6a 100644 GIT binary patch literal 1461 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 H7us4zQ(X|1 diff --git a/website/content/notes/literate-programming.md b/website/content/notes/literate-programming.md index 008a043..0454a71 100644 --- a/website/content/notes/literate-programming.md +++ b/website/content/notes/literate-programming.md @@ -1,7 +1,7 @@ +++ title = "Literate Programming" author = ["Christopher James Hayward"] -lastmod = 2021-02-04T16:35:59-05:00 +lastmod = 2021-02-04T16:53:42-05:00 draft = false +++ @@ -16,24 +16,13 @@ Described in its introduction[^fn:1] as a > Programming paradigm in which a computer program is given an explanation of its logic in a natural language, such as English, interspersed with snippets of macros and traditional source code, from which compilable source code can be generated. -Knuth describes a **practitioner** in the introduction of his 1984 paper[^fn:1] as - -> An essayist concerned with exposition and excellence of style. Someone who carefully selects the name for each variable and describes their meaning. They will strive for a program that is comprehensible because concepts are introduced in a manner best for human understanding. - - -## Concept {#concept} - The overal concept is not to difficult to imagine: {{< figure src="/ox-hugo/literate-programming-concept.png" >}} -Illustrated above we see the process of **weaving** and **tangling** the literate source file, and how each of the produced components is handled respectively. +Knuth describes a **practitioner** in the introduction of his 1984 paper[^fn:1] as -| File | Description | -|------|------------------------------| -| org | Literate document / file | -| src | Machine readable source code | -| doc | Human readable documentation | +> An essayist concerned with exposition and excellence of style. Someone who carefully selects the name for each variable and describes their meaning. They will strive for a program that is comprehensible because concepts are introduced in a manner best for human understanding. ## Resources {#resources}