Here are some of the computer-related books I’ve been reading lately:

• JavaScript: The Good Parts, by Douglas Crockford
• The Passionate Programmer: Creating a Remarkable Career in Software Development, by Chad Fowler
• Convergence Culture: Where Old and New Media Collide, by Henry Jenkins

JavaScript is taking over the world, so we might as well make the best of it; Crockford’s book shows that there’s a lot to be happy about as long as you take a discriminating approach. Fowler’s book has lots of nice tidbits and insights on how to be an effective software developer, especially if you’re working for someone else. And Jenkins’ book is a fascinating study of how the role of media is changing in the age we live in, utilizing concepts such as “participatory culture” and “collective intelligence.” It’s obviously the most widely accessible of these books, with chapters about Survivor, American Idol, The Matrix, Star Wars, and Harry Potter. It’s a textbook for one of my first classes in the M.A. program, and I’m likely to blog about it some more in the future. ]]> http://evanlenz.net/blog/2010/12/20/what-im-doing-reading/feed/ 0 http://evanlenz.net/blog/2010/12/18/this-blog-is-going-to-get-a-lot-worse/ http://evanlenz.net/blog/2010/12/18/this-blog-is-going-to-get-a-lot-worse/#comments Sun, 19 Dec 2010 06:45:24 +0000 Evan http://evanlenz.net/blog/?p=195 …before it gets better. That’s because I am casting my perfectionist tendencies to the wind and will be trying out lots of different things. Quite reasonable questions pop up in my mind such as “Why would anyone want to read this?” and “Is this post actually going to be useful to anyone?” For the time being, I am going to put those questions on hold. My aim, dear reader, is to get myself in the habit of blogging and of having an abundance mindset about all the things that I could possibly write about (especially relating to technology). I am sorry if this comes off as navel-gazing or as airing my dirty technical laundry (such as all the things I know so shockingly little about), but I am just going to have to run that risk. For my own benefit. And for the benefit of readers—if not you who are reading right now, at least the ones reading later on once I’ve really got my act together (as if!). In the mean time, I’ll aim to fail early and fail often.

I’m self-employed and frankly lonely when it comes to geeking out, so I am going to start geeking out in public and see what happens. Maybe it will add an extra sense of accountability about safeguarding some of my still-unbacked-up data, or an extra level of motivation to learn more about the areas I feel deficient in. And maybe it will be intrinsically rewarding and fun. And maybe someday (I hope) I’ll start writing some things that will be interesting or useful to some readers—even if not regular readers, but someone who’s just Googling for the right solution to the problem they’re facing right now.

I’ve written before about my blogging confusion. But now I’ve got a little bit more focus and motivation, even if I haven’t quite articulated what it is, even to myself. For now, I can tell you it has something to do with this: celebrating technology.

Okay, that’s all. You’ve had your fair warning.

Here’s an outline, including some checkbox TODOs

Indent level 1 unchecked

Indent level 2

The end.

Update: Hmm. Apart from the hideous formatting-ridden HTML markup (should I really be so surprised?), the effective formatting isn’t faithful to the original anyway. (There are extra line breaks for one thing.) This will need some work if it’s going to work at all. I suspect that using this “Send to Blog” feature will be an occasional choice at best. It was quick and easy though…I might have to look into the possibility of a hooking into the process. I should also try upgrading to Office 2010 first; maybe things have improved in this area… And I really wish Microsoft would release OneNote for the Mac, but that’s another story…

After installing MarkLogic Server on my new EC2 instance, I wanted to poke around some. Here are the simple commands that came in handy:

rpm -i MarkLogic-4.2-1.i686.rpm

Installs MarkLogic from the RPM package

rpm -qa

Lists all the packages installed on this machine (“query all”)

rpm -qa | grep MarkLogic

Searches for “MarkLogic” among that list (revealing its title as “MarkLogic-4.2-1″)

rpm -qi MarkLogic-4.2-1

Shows info about this package (“query info”)

rpm -ql MarkLogic-4.2-1

Shows all the files created as a result of installing this package (“query list”)

Yep, very basic and nothing to write home about. But blogging about it might help me remember. Most Unix commands have a ton of options, many of which I’ll never need. But it’s good to be able to remember some of the most common ones and only visit the man page when I need to do something unusual.

I’m not yet blogging from within OneNote, so that will be one of the next things I’ll have to look into (and updating the website design).

Until then, I’ll keep posting some random things I’m learning—in a distinctly non-comprehensive way.

Well, this last time, I started to notice my blood pressure rising and decided to step back, cool off, and do some thinking. “I really don’t want to learn Joomla right now; I just want to get this page created.” I didn’t have much else that’s pressing today, so I decided to take this as an opportunity to cultivate patience. Patience is often thought of as “grinning and bearing it” or waiting reluctantly with clenched teeth. But I like this definition better: “Patience is the ability to dwell gladly in the present moment when we have some desire, or what would normally be a reason to desire, to depart from it.” (Robert C. Roberts in Strengths of a Christian, p. 53)

One of the sources of my resistance is that I prefer to learn things comprehensively—or at least comprehensively within some well-defined range. That’s why I tend to enjoy smaller programming languages (like XSLT 1.0) and domain-specific languages. Joomla is a full-featured Web content management system with lots of bells and whistles. I’m not planning to use it for anything other than the school website I inherited. I’m not very inspired to learn it.

So today I found myself whining, complaining, and wanting to distract myself. This feeling caught me by surprise, because lately I’ve been really loving technology. There are so many interesting programming languages to learn, so many powerful tools and frameworks to unleash one’s creativity on. In fact, technology has been really exciting for me lately, even though it seems like it’s been years since I felt this way. I think the key for me has been gratitude. Rather than trying to hoard knowledge or get overwhelmed by all the things I won’t ever possibly learn, I somehow was able to let go of all that and begin to receive everything as a gift from God. Programming languages are part of the wonderful world we live in. I don’t have to walk in the woods (although that’s nice too) to appreciate and get excited about this planet we live on.

Learning things comprehensively can be useful (and fun), but I’m finding it’s not a good general policy to live by. For one thing, most things are impossible to learn comprehensively. For another, I don’t really operate this way. There are lots of technologies I merely learn just enough to “get by”—without understanding some of the fundamentals that would be required if I had to work with these technologies everyday: Ethernet networking, email protocols, DOS batch files, etc. So I’m fooling myself even when I say that’s how I prefer to learn things. There are lots of things I’m not an expert in, and that’s okay.

Joomla can be the same way; the key is to just take some notes so I can refer back to them the next time I have a task to complete. This doesn’t have to be as painful as I’m making it. There is an underlying logic, and I can learn just enough to get by, capturing the knowledge in OneNote (what a great technology!), so I can refer back to it next time and save myself a lot of headaches.

Since then, I’ve toyed with the idea of creating an application for The Trillium School (which I’ve blogged about elsewhere) to help manage Judicial Committee (JC) meetings.

Since I had created a basic but flexible framework for browser-based XML editing (using HTML forms) in the RunDMC project, I thought it would be nice to reuse that for the JC app for Trillium School. Now, Trillium doesn’t have a big budget, and this would be a volunteer project, so cost is a big consideration. Luckily, the free Community License for MarkLogic Server seems to fit the bill, allowing the development of non-commercial/personal applications. So licensing doesn’t appear to be an issue. Hosting, on the other hand, can be costly. Taking into consideration MarkLogic’s system requirements, we were looking at $50–100 per month for hosting fees. At that point, I decided that maybe MarkLogic was overkill for what I wanted to do.

Even so, I still liked the idea and was hoping to figure out a way to do it (ideally without having to host a server on campus or in my home). Then, in the last couple of days, I learned about the Amazon Web Services free usage tier. And I came across Mike Brevoort’s immensely useful screencast about how to get MarkLogic Server running on one of the Amazon EC2 “micro-instance” servers. (Mike is the one who beat me at the DemoJam earlier this year but then amazingly and graciously offered me the iPad, which I then dutifully gave to my wife.) Although I had created an AWS account in the past, I had never used EC2, so I wasn’t sure what to expect, but Mike’s video made it really easy and I had MarkLogic up and running on CentOS within 20 minutes. Mind you, at 613MB of RAM, the micro-instance doesn’t actually meet MarkLogic’s official system requirements, so it’s unsupported. But for the small application I’m interested in creating (small data set with very few users accessing the site approximately once per day), it just might work. So far, the server seems to be running fine. The next step is to create the application.

So I’m pretty stoked about playing with this. If you’re interested in trying this out yourself, just follow the steps in Mike’s screencast: Installing MarkLogic on an EC2 Micro Instance – Free for 1 year!

This is just one example of a .NET function you can access as an extension function in XSLT 2.0, so a more general-purpose treatment of .NET extension functions might be more useful. (I defer to “Writing extension functions for .NET” for that.) But if you’re like me, you spend most of your coding time within the safe, comfy confines of pure XSLT. And you do very little .NET development. So to ensure your continued comfort, here’s how you can generate a GUID in Saxon.NET (relevant parts highlighted):

<xsl:stylesheet version="2.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  xmlns:guid="clitype:System.Guid?partialname=mscorlib"
  exclude-result-prefixes="guid">

  <xsl:output indent="yes"/>

  <xsl:template match="/">
    <guids>
      <guid>
        <xsl:value-of select="guid:NewGuid()"/>
      </guid>
      <guid>
        <xsl:value-of select="guid:NewGuid()"/>
      </guid>
      <guid>
        <xsl:value-of select="guid:NewGuid()"/>
      </guid>
    </guids>
  </xsl:template>

</xsl:stylesheet>

Here’s an example result from applying this stylesheet (to any input document):

<guids>
   <guid>6dbd3a72-ad74-429d-97ca-3056e8940813</guid>
   <guid>cea97da4-9de5-4fb5-a35e-ba04a0dee906</guid>
   <guid>41c89105-6cf7-4fd6-b17a-ed04235a4804</guid>
</guids>

All you do is call the .NET platform’s System.Guid.NewGuid() method as an extension function. The function’s namespace URI identifies for Saxon what assembly and object class you’re interested in (System.Guid in this case).

Thanks to M. David Peterson: I found this usage buried in a code example in his lucidly-titled blog post: if ((OOP + FP + AOP) == XSLT 2.0) then ‘Composable Language’ else ‘Try Again’.

• I’m attending SXSW Interactive very soon. PianoNinja was accepted as a semi-finalist in the ScreenBurn Game Design Competition! If my presentation is selected as a finalist, I’ll get to present a live 5-minute pitch for the judges.
• I’m working on a reference implementation for Inline XBRL. I had responded to their RFP for XSLT style sheet for extracting XBRL 2.1 from HTML documents with embedded Inline XBRL, and they chose my proposal. They’ve been very pleasant to work with, and the work is coming right along.
• I’m also working on a really cool SVG and XSL-FO project, generating SVG-based flow-chart diagrams.
• I’ve started Twittering. This may give me more excuses not to blog. So follow me! Disclaimer: we’ll see how long it lasts.

That’s all for now. See you again in 6 months.

We had a little setback involving lost code. Ironically, this happened when I was trying to set up version control to guard against this very thing. I’ve posted a message to the user’s list for the IDE that failed to give me a warning before deleting all this naive user’s code, in hopes that similar mistakes by other users can be prevented. Hindsight is 20/20. I should’ve backed it up before trying to…back it up. It would also have been good to have Time Machine set up already, but I hadn’t done that either.

Thankfully, I did still have an older version of the code from before I switched over to the development environment that I’m now using, so I don’t have to start totally all over. And you can be sure that I have already secured that code into version control on a server machine so that I can continue from now on from a solid base.

How bad is it? Well, we were on Video #7. Let’s just say we’ve now reverted back to Video #3. In other words, all the code I wrote in the last two weeks is gone.

Maybe this is a blessing in disguise. Sure, I learned a lesson and I won’t make this mistake again. But the blessing might be that my continued dependency on MIDI files as the game’s underlying format is now that much less alluring. The MIDI crutch has been snatched out from under me. I don’t need to wrest myself from the MIDI code so I can move onto a better way. The code has wrested itself from me…

I was going to add bar lines tonight. Oh well, those can wait.

Before you know it, the ninja will be feeling better than ever.