The Gist

So I got to play with Mugshot. It doesn’t seem to do a whole lot yet, but I know there are a lot of smart people behind it. I like that it’s trying to really work with the stuff people actually do, rather than just provide another collection of forums where teenagers can write in some incomprehensible bastardization of English.

That said, I have two gripes. First up is a color gripe, which people are used to getting from me anyway. Observe:

I think even non-color-blind people can’t read that text, and I’m certain that I can’t.

And then there’s this:

For the record, the name of the song is Русская Любовь. (I hope that however many parsers and manglers are sitting between me and the Planet don’t screw up that text.)

[Edit] Any chance of some Epiphany love?

Tomorrow morning, I’m getting on a plane to visit Silke in Heidelberg for a week. I fully intend to stay as far away from computers as possible. I’ll meet some of her German friends, take a trip to Strasbourg France with her, and generally just lounge about and drink fine German beer. It’ll be very nice, I’m sure.

Silke has had two of her exams so far, and gotten a 1.0 on both of them. (For those of you who aren’t German, that’s a perfect score.) But even more exciting is the phone call she received earlier this week: She’s been accepted into the Ph.D. program at UIUC, which means she’ll be back here again in the late summer, and for at least four more years. Four years should be long enough for me to keep her here permanently.

I’m going to miss the 2.14 release, which is a shame. I don’t know why, but I always get really excited on our point-oh release dates. So, happy 2.14 to all my Gnomies, especially Don and Brent, who are seeing their first release as core maintainers on Wednesday. I’m looking forward to another six months of fun, love, and freedom.

A short conversation on #gnome-hackers about adding an easter egg to Yelp came to new levels of absurdity when Mike Hearn found the Easter Bunny from Hell. Apparently it’s the top hit on Google images for easter bunny, no doubt due to idiots like me giving it Google juice in their blogs.

My entire childhood has turned into a Kafka-esque nightmare from seeing that picture. It’s my own fault. I did ask for a blood-sucking robot demon chocolate bunny whore.

Jakub writes:

Let me offer the following paralell. I loved how the Mozilla folks avoided the Frankestein and solved the issue of specific needs with their extension system in Firefox. Firefox only ships with essential functionality, that pretty much everyone will find useful. And if there is a need for a specific functionality for a specific user base, somebody sits down and writes an extension for it. Such extensions are developed separately from the main app.

He goes on to mention the prospect of “extenion” themes like gnome-icon-theme-artists and gnome-icon-theme-hackers. The parallel, however, falls apart in that I can load up all the plugins I want in Firefox. Let’s postulate these extension themes:

• gnome-icon-theme-artists – Differentiate between different image types
• gnome-icon-theme-hackers – Differentiate between different source and object file formats
• gnome-icon-theme-audiophiles – Differentiate between different audio types
• gnome-icon-theme-network – Differentiate between different types of network servers

It’s a well established fact that I am not an artist. I once made a pretty decent scale drawing of a pixel. That’s about the best I can do. But I am a programmer, and an audiophile, and one of those weird people who uses Gnome on a wacky heterogeneous network. So I want to load up three of those.

But it isn’t a plugin system. It’s a set of independent extension themes. So we’ll have to have funky conglomerate extension themes, like gnome-icon-theme-audiophile-hacker-network. With just the four I listed, we get 2^4 = 16 extension themes. Yikes.

So Calum brings up two interesting points about DocBook output for the web: First, without any sidebars or maximum widths set, the line width is too wide for most normal-sighted users. Second, the lack of a navigation sidebar makes it difficult to keep track of where you are and jump quickly to other places in the document.

And Calum is absolutely right. The good news is that these two problems can be solved in one fell swoop. Long ago, I created a customization for Norm’s stylesheets to add a navigation sidebar and make the output fit the Gnome web site. We’ve used it primarily for the release notes. The implementation is kind of slow and fragile, but it does work.

Regular readers of gnome-doc-devel-list will know that Peter Williams has been trying to add these sorts of things, so that we can have kick-ass standalone HTML builds without hassle. He’s also developed a gnome-doc-process script, which makes it easy to process DocBook from the command line. We’ll get all that into CVS in the next release cycle.

The goal with adding such extensions is to do them without doing something stupid, like overriding the body-creating template, like I did in the customizations mentioned above. Fortunately, I have control over my stylesheets, and I can add hooks wherever we need them to make this happen.

Here’s our seven-step program for success:

1. Make all output prettier.
2. Provide the necessary goodness to make HTML suitable for our web site, and hopefully easily tailored to other web sites.
3. Get a simple script to do the transforms.
4. Use this as the base infastructure for library.gnome.org.
5. Get people to write documentation.
6. Put all of our documentation online.
7. Brag on our blogs about how we have the bestest documentation ever.

The bragging part is important. Fortunately, it’s easy, and we’re all really good at it. I mean, we are awesome braggers. Nobody brags as well as we do. We rule.

Why doesn’t Fedora Core 4 ship with FLAC support enabled in XMMS? I get the whole MP3 thing; I’m cool with that. All my ripped CDs are in Ogg Vorbis, because that’s the sort of left-wing tree-hugging pinko Free Software zealot I am. But FLAC, the Free Lossless Audio Codec, it’s pretty free.

FLAC is the only example I can think of where the shiny new free format completely decimated the entrenched non-free format. It clubbed SHN to within inches of its life and left it lying in a ditch. And it’s stood strong against Apple’s best efforts to strangle lossless audio with Digital Restrictions Management using ALE.

FLAC is a winner. Let’s treat it as such.

Planet readers should now skip on to Christian’s excellent post on GPL and DRM. This paragraph isn’t for you. Hi Silke. I love you.

If you watch mailing lists and IRC carefully, and you keep your eye out for the word “DocBook”, you’ll see a trend emerge. People like to complain that the HTML you get from DocBook looks ugly. But it doesn’t have to be that way.

These days, you have basically two options for converting DocBook to HTML: Either you use Norm’s pan-galactice all-singing-all-dancing XSLT, or you use mine. Mine don’t provide as many options, and they still lack support for some of the more complex book-oriented stuff, but they’re mighty fast.

People said DocBook was slow, so I set out to prove them wrong. Now they say it’s ugly. So, hey, a challenge. Understand that any amount of prettification necessarily involves dictating style. Try writing HTML without any CSS or other fancy styling stuff. It looks ugly. So the goal here is to continue to make the generated XHTML generic, but to make the default CSS styling nicer. And there’s my long-standing goal of making Yelp do less customization to gnome-doc-utils than it currently does.

So, mockups:
BeanStalk Manual
Working with Beans
Purchasing Beans (includes an admonition)
Bean Storage and Care (includes a program listing)

These are rough sketches, and there are a few problems still. The XHTML behind them is clean, and easy to create from DocBook source. Everything is in the CSS. More to come later.

I was just in a car accident today on my way to lunch. There were four people in my car (including me), and one in the other car. Nobody is hurt, and the damage to the cars looks relatively small. My car shouldn’t need anything more than some bumper work and an alignment (which it was due for anyway).

Rather than try to explain what happened, I present Exhibit A: a nice diagram by my good friend Ryan, who was in the front passenger seat of my car when the accident occurred.

I don’t think I ever announced this publicly, so I’m doing it now: A few weeks back, I appointed Don Scorgie and Brent Smith as full co-maintainers for Yelp. And here’s what happens when you add more hackers to the mix:

• Chris Lahey’s patch to add Beagle-based search landed on HEAD. If you have Beagle, Yelp will give you love.
• Don put some extra love into Chris’s original printing implementation, then committed it. So Yelp prints now.
• Brent Smith has done a lot of work on the man page stuff. So, you know, if you’re into that sort of thing, maybe you should buy him a CD or something.
• Don did some work on info pages. So, you know, if you’re into that sort of thing, maybe you should buy him a CD or something.
• Brent and Don have both done performance enhancements, including an awesome patch from Don for the DocBook transformations. (/me smacks himself.)

That’s right. Yelp 2.14 will search and print. And I had almost nothing to do with any of this. Free Software, I salute you!

If you haven’t read Project Mallard yet, read it now. Go ahead, I’ll wait.

Matthew Thomas pointed me to DITA, an all-singing topic-oriented format from IBM. There’s a lot of complexity there, but it’s worth looking at. Some resources:

• Norman Walsh on DITA for DocBook
• Wikepedia addresses DITA
• IBM developerWorks: Introduction to DITA
• And a PDF: DITA Language Specification

Also interesting is that Microsoft is heading in a similar direction for Longhorn. What’s really interesting is that their content model looks an awful lot like DocBook. Some quick reads:

• On MSDN: Introducing Windows “Longhorn” Help
• On HyperWrite: Help.Longhorn – What is it?

A lot of people are having pretty much the same idea. I suspect the success of sites like Wikipedia have had a profound impact on how we all think about such things.

What I need now is to assemble a team of people to sit down and flesh things out. I need people who are out there writing the tools, and who have a strong idea of what sorts of things are going to trip us up in the implementation phase. I need people who are out there writing the content, and who have a strong idea of what sort of content structure is actually needed. And I need people who have ties to the Greater XML Community, and who can smack me down when I reinvent too many wheels.