The modernization project
I am finally going to go 2.0 with dylanchords. The site hasn’t changed much in 16 years, and although there is probably something cute about that, it’s not very nice to work with flat, fixed html, to be honest.
The new dylanchords will run on drupal, and the page you’re on right now is actually the real thing, in the sense that the database structure is mostly in place, and so is the interface for entering tabs and most of what is needed for displaying the information. The only thing missing is – that information. I’ve included the Blood on the Tracks tabs, just to have something interesting to play around with.
The important thing for me, and the reason I want to do this in the first place, is (a) that the process of entering tabs will be simplified, and (b) that there will be benefits concerning the presentation of the tabs (such as: quickly get a list of songs in open tunings, better search facilities, songs in G major for the beginners, etc.).
I’m prepared to do most of the work myself, but the more the merrier and quicker and – hopefully – better. Hence this call for assistance.
The biggest change from the flat-file dylanchords is that I have decided to use “song_version” as the basic unit instead of “song”. This makes for a cleaner database, greater opportunities for queries, and easier expansion at a later stage, but also creates a lot more work, since every file has to be parsed and split up into the relevant database fields.
Luckily, I have been fairly consistent with class names etc. in the files, but unluckily, html isn’t the ideal language for this kind of job, since there is no indication where, say, a <h2> element ends (only where the tag ends).
Also luckily, there is a reasonably good conversion module in drupal, but unluckily too, it uses xlt, which is a beast.
Here’s the work I imagine will have to be done:
- Some automatized parsing of the files into drupal nodes, hopefully populating the correct fields.
- Filling the remaining fields, eiher with default values, or overlooked ones from the files
- Checking, manual corrections, etc.
#1 can be done through the conversion module, if I manage to get it to work properly, but I could use some assistance here. If anyone has a better alternative, e.g. to parse the song-files into a new set of song_version-files which can then be added to the database, that’s perfect too.
Once #1 is in place, #2 should be easy.
#3 will probably have to be done in any case, but will not require any special coding skills, so anyone can do it.
There are four main tables (content types in drupal terms):
- release/recording date
- cover, etc.
- Preamble - general discussion of the song
This is where the meat is:
- guitar setup (tuning, capo, chords, all as “node references”, roughly equivalent to foreign keys)
- the tab itself.
There is also a “node reference” to the Song it is a version of.
This is a many-to-many pivot table, containing foreign keys/node references to Album and Songversion, as well as disc/track number.
The tricky part is to get the theming right, and to get the proper fields brought into the right places.
There are a number of fixed elements, such as the help file, the essays, and the integration with the blog. This is mainly a matter of plain conversion or copy/paste.
The rest - navigation, album lists, etc., will be generated dynamcially from the existing material, once it is in place.
I’ve added the BOTT songs, just to try it out, and it seems to be working ok. There are still some rough edges here and there, but on the whole, I’m fairly happy with the results.
Here’s an overview of what I’m aiming for:
There are some different scenarios here:
1. Dylan comes out with a new album.
I will then add a new album page. On this page, there are fields for the general stuff (title, release info, cover image, etc), and links to add Songs. I’ve found an architecture which makes this quite simple, whether the songs are already in the database, or they are new ones – hopefully so simple that it can be done also by someone other than me, should I decide to go that way.
Track order: would be nice with a drag-and-drop arrangement here.
One problem here is that what is added to the album is neither a Song nor a Song_Version, but an album_song, which is a combination of album and songVERSION. It makes little sense to add the songversion before there is a song to add it to, so if the song does not exist in the database yet, it is added (in a required field) while entering the song_version.
2. Dylan plays a new live version of She’s Your Lover Now.
On each Song page, there is a link to add a new version. Each song_version (whether displayed individually or in the context of the Song page) has an “Add to album” link.
3. A new outtake from Street Legal surfaces.
4. Dylan plays a cover of ABBAs Dancing Queen.
5. I add a tab to the “Other artists” seciton
I haven’t quite decided what to do in these cases. Probably some kind of tick-box system, which will let outtakes be listed as outtakes under their “original” album and as ordinary tracks under Bootleg Series, and a set of “Misc.” categories corresponding to the current “Misc.” index page.
Good ideas here are welcome.
With the song_version based system, it is quite simple to generate any kind of lists, static (album pages) or dynamic (“songs in G played live between 1978 and 1994”). The only problem so far has been to get all the back-references right, such as a list of all the albums ANY version of a song appears on, but that’s mostly because of my incompetence. That will be worked out, but someone with great database skills and/or familiarity with drupal’s views system, will be greeted with open arms.
- list of outtakes
- link to add song to album
- list of versions
- link to add song version
- link to albums it’s on
TODO: list of albums ANY VERSION of the song is on
Song version page
- list of other versions of same song
- link to main song
- list of albums the VERSION is on
TODO: What to do with outtakes.
I have heard from a number of volunteers who are ready to go to work.
I think of you in different categories:
1. Hackers. People who can write perl scripts to parse anything and the kitchen sink and who dream in xml. Right now, the bottleneck is the bulk conversion in step #1, so help there is urgent. I’ve heard from a couple of you, and promised to get in touch after the summer vacations. Well, here we are…
2. Slaves. Unpaid labour whose only required qualifications are an unyielding loyalty to Dylan and yours truly, and unexhaustable energy, diligence, and meticulousness. Once the basic conversion is done, you will have a lot of cotton to pick.
3. Architects. People who have good ideas about workflow and presentation, both concerning what should be done and how. PHP skills and MySQL knowledge might come in handy here, and a working knowledge of drupal is a gate to dylanchords heaven (a working knowledge of Latin is a bonus, of course, but it won’t help here).
4. Guards. Spam, spam, spam, spam, spam – how to stop it and still enable a vibrant community? I’m not aiming for a new expectingrain forum or anything, but I think it would be a good idea to have a more dynamic channel for letting suggestions and corrections through, and for some sort of community interaction.
I think of myself as someone with one limb in each category, with a serious risk of loosing my grip of any of them, thus falling over.
In other words: I’m going to need you all.
I’ll provide you all with login credentials with permissions according to whichever category you feel comfortable with. If anyone wants any of
- a mysql dump of the database,
- a tarball of the site,
- a zip file of the current dylanchords files
either to set up a local development environment or just to see what’s going on, I’ll provide that too.
Contact me on email@example.com if you’re interested, and indicate (a) which category you see yourself in, and (b) if you want any of the material.