This is going to be a somewhat terse post given the ambitiousness of the project I'm going to lay out. I'm just interested in getting it out there to get some useful feedback.
Last year I wrote a simple literate programming system in perl, which accepted files in an extended docbook format, and had tangle and weave utilities to create source code (tangle) and well formatted xhtml articles (weave). It was actually a pretty successful project, as it was target language agnostic. The system didn't care whether the language to tangle was c, lisp, forth, or haskell, as long as the programmer knew the order required by the language.
At about the same time I conducted a podcast interview with Donald Knuth which inspired me to take the project very seriously.
Since then I've done nothing with the perl version of the project, and have shifted my income generating attention to php.
So here's a gonzo version of an SRS for the PHP version of my utility.
The utility presents a web interface which accepts one or more files in an extended docbook format (with added tags appropriate to literate programming), either imported or entered via a web based docbook editor. The main interface gives three basic options, edit (create a source file in the extended docbook format), tangle (create a compilable or interpretable file of source code), or weave (create an awesome human readable article explaining how the code works, with the complete source code imbedded ... see any of Donald Knuth's writings on literate programming to see how this works).
What I need from you PHP geeks is advice about the most efficient way to build a really good online Docbook editor. I can probably figure out the backend tangle and weave routines quickly (it'll look a whole lot like the perl code I've already written.
Friday, March 4, 2011
PHP literate programming project
Sunday, February 27, 2011
Matcha and my own tea ritual
I've never had a background in chemistry, so armed with a copy of Chemistry: Concepts and Problems: A Self-Teaching Guide (Wiley Self-Teaching Guides) and Wikipedia, I began a process of trying to learn as much about food and nutrition as a layperson with limited time can digest.
As a consequence of this, I've developed by own little morning tea ritual, involving matcha, the finely ground powdered green tea used in the Japanese tea ritual.
The potential health benefits of green tea are well known. It contains numerous phytochemicals, vitamins, and minerals, but of particular interest is a polyphenol known as Epigallocatechin gallate (EGCG). EGCG has received interest as a potential preventative for cancer and some autoimmune diseases.
But like any other chemical substance there are circumstances under which EGCG can be harmful. The wikipedia article on EGCG mentions some of those circumstances. They include pregnancy (high intake of polyphenols during pregnancy can increase the risk of neonatal leukemia), and when using the anti-cancer drug Velcade (EGCG can reduce the bioavailability of the drug).
Since I'm neither pregnant, nor on anti-cancer medication, I've devised my own tea ritual in the morning, which diverges substantially from the Japanese method of preparing the tea, but which works for me.
I sift a teaspoon of matcha powder into a mug, then pour about 1/8 cup fresh squeezed lemon juice onto the powder, and rapidly stir it with a fork (since I've yet to acquire one of the little wooden wisks). This forms a rather thick sludge.
I pour a cup of hot (not boiling) water from a tea kettle into the mug. The resulting beverage is both sour and somewhat bitter, but I've grown to love the concoction. I often exacerbate the bitterness by eating a tablespoon of cocoa nibs along with the tea. I wouldn't advise adding the cocoa nibs unless your taste buds really thrive on bitterness, but it works for me. The Japanese ritual includes eating small sweets to mellow out the strong bite of the matcha.
Whether any of my dietary eccentricities will actually have an appreciable impact on my longevity is unknowable. But I have fun with it, learn a bit about a couple of branches of science, and on balance my diet is much better than the average diet in our American Fast Food Nation.
Monday, February 7, 2011
Professor Irwin Corey
OK, I realize that the modern definition of the word "technology" in the popular lexicon is narrowed to the point of only including digital technology which sprang from the recent resurgence of the Internet.
But I'm on a mission from God, in the Blues Brothers sense of the phrase. My mission is to get proper recognition for Professor Irwin Corey before that 96 year old gentleman dies.
To learn a bit about him go here: http://en.wikipedia.org/wiki/Irwin_Corey
To see him in action in his prime just watch this video
Saturday, January 15, 2011
Trend Micro CEO advocates "security through obscurity"
Here's a link to some commentary by Ricky at Digitizor regarding Steve Chang's statement that closed source software is inherently more secure than free or open source software. FUD just never seems to die, but I'd hope that Mr. Chang, the CEO of a security firm, would think this sort of issue through a bit more thoroughly.
Monday, September 20, 2010
Isambard Kingdom Brunel
Unless you're a student of the history of technology and engineering, you probably haven't heard of Isambard Kingdom Brunel. Brunel is well known in the rapidly diminishing engineering circles in the UK. He also has contemporary following among fans of the science fiction genre known as "steampunk", because of the cutting edge nature of his activities within his century.
Brunel was perhaps the greatest civil engineer of the 19th century. He planned many bridges and dockyards which are still in use, supervised the building of the first major British railway, and most importantly in my opinion, designed the first propeller driven ship.
Since Brunel's time the UK reputation for engineering has been degraded to the point of Lucas jokes, and the United States has become the world's capital of consuming everything, producing a great deal less.
Here's the link to the wikipedia article on Brunel. As the UK attempts to redesign itself as the place where physical things are designed and built, and the United States seeks to establish itself as a place built on something besides financial vaporware, it might be good to reflect on Brunel's accomplishments.
Thursday, August 19, 2010
A cultural interlude -- Lydia the tattooed Lady
I'm taking a break from writing about Oracle America v Google, or Minix 3 today, and doing something a bit more whimsical. I've always lived my life surrounded by music, and have written here about the Free Music movement.
In addition to enabling free music the internet has made available an amazing array of resources for those of us who love music and film in all its forms. When I was a teen if I wanted to see, say, a Marx Brotherss film my one option was waiting for it to come on television. A decade later (in the 1970s) a few small "art" theaters had opened, which might occasionally show a Marx Brothers movie. A decade after that (in the 1980s) videotape had entered the mass market, and if I wanted to buy a Marx Brothers film I could do so.
Now that the web is ubiquitous and nearly every artist committed to record, tape, or film has at least some presence on the web if I want to see one particular notable Marx Brothers clip I can probably find it.
So on that happy note I present one of the best musical numbers ever to come out of an otherwise terrible movie (At the Circus). The lyrics to Lydia the Tatooed Lady were penned by Yip Harburg, one of the great songwriters of the 20th Century (who also wrote Brother Can You Spare a Dime, Paper Moon, and all the songs in the movie the Wizard of Oz.
After a string of wonderful but chaotic movies at Paramount, and the two wonderful Irving Thalberg Marx Brothers movies at MGM, A Night at the Opera and A Day at the Races, their movies went into sharp decline in quality. This clip is a gem in an otherwise awful movie.