From d9d258b31fb0b589dff83865821f7feddac66495 Mon Sep 17 00:00:00 2001 From: Christopher James Hayward Date: Thu, 4 Feb 2021 16:38:36 -0500 Subject: [PATCH] Update notes with actual diagram --- docs/images/literate-programming-concept.png | Bin 0 -> 2924 bytes docs/notes/literate-programming.org.gpg | Bin 1586 -> 1609 bytes website/content/notes/literate-programming.md | 15 ++++----------- .../ox-hugo/literate-programming-concept.png | Bin 0 -> 2924 bytes 4 files changed, 4 insertions(+), 11 deletions(-) create mode 100644 docs/images/literate-programming-concept.png create mode 100644 website/static/ox-hugo/literate-programming-concept.png diff --git a/docs/images/literate-programming-concept.png b/docs/images/literate-programming-concept.png new file mode 100644 index 0000000000000000000000000000000000000000..1286c1f9709e31bfbedb33e012200a9ae911fe57 GIT binary patch literal 2924 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 literal 0 HcmV?d00001 diff --git a/docs/notes/literate-programming.org.gpg b/docs/notes/literate-programming.org.gpg index 657626043be2689c7116a8245015a03cfbf98656..73e70709ff542eeb3a2dfccbe973094ff5125a08 100644 GIT binary patch literal 1609 zcmV-P2DbTy0t^G>9JMNFPA5765Bv_2(p0N!%OPQ}2Ps~}T^W|xqv}E_WqCGE%&@XM z!LCP>0`;mh$$3bmk%hA4c#O>{W=C!b{p0~G5wSC4%AFkZG5-%`0)cQ)AUzDeQ#KfK ziG{RZa_(of zQL}`OV9u_bTESX{6&P5T3|bX*YLqT3by1MTr9Q#sR#ae*m64T5V^-4Snp=cw8W@jI zxhK#oJT`9g>)t9O`L{j3hg;RHpAZ1EO(Ria_=7qxaA@c$J)tE}QYpoO@B2?9d(P!; z4pr)TNTw_w21lu19a2Y6E^!PD-TgV5kC9f>-8#E3cAE>@WPv|V?$6a3O9FU&rB94X@M=@go$x@Vj}A|aH=n1}^k4IaWLXKK>w0SG~Q2=PSWn*B-A@ph$T64hn#k;RJ-;3`z7Ce(ml#YIin{=nrzP7DxEJ_vj7iy^a9!3#mpuEa;Q~jJ1Vi8koeka zURP5c+RUI{0Z~@`OW9Ccv2h2Cf{VTg}!|YSlEns3c#mF1AIN*#4%x>I3*@uvaEjLB&YS$0^&-*`oGXwUD zlL9naE1hf;?MU%Z(kNWieob=FV2n=o)kwF(vI!B%h5Lr2kpY$OqSilMAetUBm&2-H zJ4DMXb>Pqag2n6GGO6cJ_=Q5VcoG?EVM_=6>f^g)E+d6=#hrh9s1ue2JdMFkW429z zc2W+*Yy%X+Jo!6!HCHqTugF@PU*Br+e)0Gd3D$Pf@ijo_Ruz(}pou1;4LY5G-g?n9;_iCd-xfSDA9C@LS8(8*!i_2|aFj&G*2Jy}Hp zPAHsb-)USJxf4t$ZoU9(1<4Iq!q;>{LU1?Kn;|AP7*;vvv$?`ffAf3Je#$trdd?~% ze^ZxKf}{SlLZ_J8bLF)NFePWyqtL>YmodDLeaC0YCTt$_ZyC`R))UA0!IwvCui>!V zA~Wb78+IemoZ{b^P(;^e=_@v{x`g;2C%DUOY{{qp$@cm~g&oCe6qwlplp)I?r>N%# zxPrm%4bUZ=|F7abHpK>OQM^Nt-!A!-c^D@g7!ndC*ed94mpP;_8T{^Pb>9sHZ^jCo3z4OW9r{SYi8+){SGjBmA?ke zSD%z^a}qZmyRsrzLcr)5HQT^0ur1St0i^~MH#gqYE*=^gyPbMLR0v4);OAxHzL%uY zH!=bK!8t)tSzGJp2qW5(tmnQO|NJA~tS80-X^l;{WJOaR0tMXa(Byp2=Ea7dS<0=u H7us4zQ(X|1 literal 1586 zcmV-22F>|}0t^G>9JMNFPA5765B@k2!gU4m`UB3TU}JD(!^FzVaOI7kJ4G=a-w!Z# zgW!#BGUEbv`Qzi8rfJQj$4CO9tOMLuNXOSSE+Cry0hufwXJ=~?FVVe-uO$pJGh`_s z%D=HkRVb}|%~@hR_XdNQwx<%hV7?A8k9-y`36$4$HyZJE_cj<+)C_S883G+YQO_R^ zA}7WAmReK@0XZ%R2i+#s>Qm{bG-)I%21Z#(s4 zGdch%SbN6or6+lSf^CO}J_n~vqk_tO{~JC`1*#n!KemwWA-w&})?0!&H6KfR!jEM@ zIn|E}VNGg>|0TrntrKo8L+Le1-)_(fz^klb=Ls~RDi^_6rDsWWvJuCb?HjR#_7i{c zq~ei*=$WcIf)Iy&UD}Y(v55i*Y~MS&abD6J`4`-v3^@3x>l*EgZQJ`jPkRWYLfc{F zb*6jXoj>+2$uzG3(EBqlMOTA3K@hz_SaUl5;(H$e?b_=sXI&X94q@L{J1v$rvs9^h z{L+^zcDi9xPjagUJ3%E^VXQewF5s7$p9d%KcCrm>ewj2JHQ5_7=vL$WB7_$kur0pqg)v-y5mSLD(2zqTSRew9-gJPlFJ?FXWd##l{4apOI?USJ(?cUr9MIeLtEA4?nn6 zfV*NB4NijqY6goH2T?)vu98uvS>SV^z#=GV2xj4~c(@Aerx55|GY8DXGHn7I1vMO+ zT&cd%rE>?e6FQ#mB=)FMy@MxSi;ewn;yBSjJ}<=*ETxj0H^r!YDDAZVWYpz)_IZsyse8Dx->Gqt8zj?$w-y;R2|%dzTthUo~T` zVHh5JfFs4xw=?FExU(p}mpwI?8V7~VBabG(k7o1_Vn{lkHpED^3HX~yz1U9%Ca;2k7qc^}n^xNRzChwu|= zWXQNrK~ycpUd%5k5RDw4Ij-f2_|I|hYi{zLcy_{-p8fUv-EnA3T68lAK$$_M_I=Qs z#l>KPrLVh1G1b0su<6(L*QjE|1^H7mH(5!{u(}QFC7N?bY%6rlVL{OAx@poQf+a5C zUo$B!z^+4T`$b#@2y5Z+l6(CJAS$Tl>p%F+kNOwRl9Z@Oe+`2bR$j#ut)~1fl3Qgs z1-VCQ%YM*xfaGgxsFHkIb9f?mM^zgYVZE#NBAx2=(6bqeEMWh{gJbS+x<&S5maoKt zNN$cG&7hIVZnYKTsolROLstJ`v!3J|2+*9Ha^vFvttM)m-|CuY=c^#tFE0wa3a=XR zYEI7~T;3B0Wb!ZTxGC@X>}7R7+PsY_ytkmNS;ygJ9t;*`-~TiC@(D%5SSFWbff&Gr z>N6%>dorD!(;nwN97KO@tX}SWlRuKWE41hH;gFNa@n0Ur#Dj4dK!czq!V5{>3KD&` zqmo!NL;torVA-y^L)BM09RPUk<8EoUe8#C?{maoL?P>Q^cy~Xy0r(lSUACGb7p3JX zeBOBjREop{B!TS%NZ@#ERe%&zL>y#0?5!~nf`ypzqi<7m0d@!$8ys)00KN1k8Zn4r zv4&+7iXIy9LGntfA}%OfVN?q|kmsyKHT=C654m>PmMHR?n|;NndOH)^80Rh)NLIGk zvb8(7L!qy50-?J_+cDG)r*Dix>&6f(Vk4-*uGxVK4Qn_?3E1v$hgZ1my1hfX0dp~z kAjKL-rEl1Fw+m1$L6bK?n9{(R_kQQXnF(pyv(MvEuajE^0{{R3 diff --git a/website/content/notes/literate-programming.md b/website/content/notes/literate-programming.md index ab11aa0..008a043 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-01T16:14:03-05:00 +lastmod = 2021-02-04T16:35:59-05:00 draft = false +++ @@ -23,16 +23,9 @@ Knuth describes a **practitioner** in the introduction of his 1984 paper[^fn:1] ## Concept {#concept} -```text - _____ - | | -> Send to Boss - _____ | doc | -> Copy to Team -| | -> Weave -> |_____| -> Copy to Support -| org | _____ -|_____| -> Tangle -> | | -> Test on CI - | src | -> Copy to CDN - |_____| -> Send to Customer -``` +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. diff --git a/website/static/ox-hugo/literate-programming-concept.png b/website/static/ox-hugo/literate-programming-concept.png new file mode 100644 index 0000000000000000000000000000000000000000..1286c1f9709e31bfbedb33e012200a9ae911fe57 GIT binary patch literal 2924 zcmZ`*XH*l)5=I21NN>`miS$lDgh&ZVkRrm9DoB%(013SbSE`}j&?3DmAiWqOB1jPw z2vvd5q(~8|QbT>gd)_*$3Df;&I;B?CKqI(ysuIy>ET2)gO&>x;M}D~o{Jd;0o$z-1i0 zJecLwcu7WQZe|v~|B;hjAxQ#rKuKEnJMS??Z(Sua>KI8+{7oV0Yz&&Bm2Y<#we9Lu z;abdaQi1zN3Y`Z4%BX#gXF~)U_$!qT6kHkR6v?`30ms_uiH&aB&j(p|8&l(o-)wbO z*cISjAFks4Jyg*cvQ}~n)^VWBL{rK}-DjkT;%)p(UALTDCOQ53U|g|ccR8@mCN3~~ zN(W`C8A~|R?9oy;Wgc^{)yvJ@k5F^+PCNQB@g|8v^Pr2cJkL0n0d`gj=;Ek1-Lb>H zvz?ZRzou}`ewV$r(EO*>FV6I8b^v+ul4o6njrXF{;!GE!^uu^4wbM9uo8E=e(x_eA z07OPcvk%qPG7Gfb$PO_uBk=WrZ8cqsi&Ac~GXH%<&2n$lj6SX^O9^?gy^|bsHh4Zd z;go%*b5UuMnn=j?Fs!)UYFhO#T@zg>A3IFXdboP>v1lb@L^Ft)jW;14ak9ay7NW5- z?K3E+xQS5BpEejE=8m6k5(jd9Hn(h(o#k8;W0h}Q54IQa9O4y5MlRn#@hJ5`rVG^c z7O3#@ECAOeG)~JWq3i9^w@9%n&T3fDN98eVmxM0mAMLGKS<_3g8o<$`zakN-`!-Q% zoTt+1Q#!T>=6gFcvJ7G70qJcN3sxD zYxB2q{61vxpkS2et-s=cW47NZa5OIS3f9}2dJD%x`yO=F?g79HI%_7;yLmWMx}4}f zM2>VVbAa8X+>^YsMah0Z#v8a++6x_2rzP%s4}qKqdH9O{DwVZ-KR}Z}{>%hPfY=Dw ztngswJ*KcrD=W#oYTnEJna}UdeSCg3C@AQ2Mq1i*TX?=13=X%ca{yUcO|A|XW2CJQ z)(MJ}Ik$}R?y9*A@R~u4jb$YzVKA65==!&B-x{9cx#bTm4$dWhwcQfur>jD0bp25@c!DrDjuPQ)RmQ$xwyDWjdFvDzn7}4 zo3X!|sGpx-HAvg$F}5QG*F9Xn%5VQ^wg^%&6{>TONeSB2 z)TC&6`#ko|*}Yub8cfLsOB-^Ls%ms{@{Z@UYSybch48&qld;JQv3m_Y$pUt@PoBfj zOy(GA5Q;I{)zX)7f5Ms#nd?PeR#Rh~B8rM-6p*oN4ef}c$zwvHPzIDD!66~gEb;ot zPu--bEMaBdVDL5k!gw?Y{SOd33ML?(%KKw4+AoSHBwnb>a~DrNEN*RO)f{$q3{K|X z-`i^mJDaSA-_n|wCR^jBU=g@8tRT3Zt6W~lPco?9-6(Opm7SFp_eu^rK0dzNyG)6< zt{gIcRbQX-Hbz3Rf*DR@6CZ_ZhQHGfg@F13sicti)ebm7HY-!mQ3GsQ+2@sA%E+3DgP7Zq0CEcRGq>4=)rnwB{Af+#v6vYIt7dfA* z#Tg5saj!W3`wVEb1pQ!1e%zP<1h46isMrXl;q=#~)68}b@D(_R+jOiuwyny zOZ7>419F%OnGUvHRlt5m@_0{u7 zZ)gnch_OlA;A-E!%XF%E^X8^_+xO%dDoyn3Z0EHvOMRFfSi6`Cz|hd}eufmGB}h>` zrK=kf0oE)!dtd0&T-7dim&IQ)?Pxdr8GSS#!_0*qxg}N)*ui>(o%;fDk30O$uw8 z#(`Vo-)57CE{2&!)5~`UIV#T&w^|d15y<#nu7A8PhWhY>yk=VpL5@91AaT49Jss3k zBT)dTDX*)oO`gHTZ!KlW!sBRo_8IKd%Ci_HyYB^viN>K_zws_7sHL{>iSv_3hvw>*sc z!>yjE1#K~#pQ~Zm`=HHfH5=E%jj8dmv4g#zq`qMVr-h zKiAjSN!{&3@IGxmq~iYcaotu~==WjEbgb+4tO-g;LWXWRT?oE~Oaksmw6os<0651V zpL6gVE{>C1mcD-Nuv1HFhi%`DiLnVFgFY(5fq(+oLS z-`wv&>>jJa6*WCR*E$NgVE|GbcTKmqJl9Cd`Y?V4nK@s8KEaqQ+ z^U*$j`ef<`m23wwV>QxBgpM70^bU(vk(8vnk4CYI(b@r16Fx_kN#nDHOhKg9~!HT;hIp1 zX^)rVt^!ExI0_@5G3gcW>xqWJMXK3Dm8=}u7JKv-tmJ)*hSx5yXNEMn`8-c2AT~NN y+DcX$mwM9N;Ns3W0iOReKGA16{_ljf67DY>J{+_hR7#qA$)F%3-D>S85&s6t7pemQ literal 0 HcmV?d00001