Every article now has a "slug" associated with it. A slug is a simplified web-friendly version of the title of the article. You often see these used in the web address of individual stories on blogs. They're usually generated automatically, and usually editable if they're not to a web admin's liking.
So if an article's title was:
That's some scary #$%^ right there!
Then the slug would be:
The idea is that it takes out the characters that cause linking trouble, much like what Al was running into earlier today.
In our implementation, every slug will be prefixed with "wiki-". So using the above example, an article slug would become:
Prior to this change, we've been referring to articles like this:
[article23456]The above, embedded in a post or another article, would result in the article title showing up instead. This was really neat, until we started having articles with 20 of these links embedded. At that point, it started becoming difficult to edit the article because it was unclear what each link did.
We can now refer to articles like this:
[wiki-frequently-asked-questions]What's more, we can override the automatic-title-lookup for those occasions when we want to link to an article but don't want to use the full article name. Like so:
Caution: once a slug is in place, and we start linking using that slug, we have to be very careful not to change the slug, or all the links will break. A slug, once in place, should be considered relatively fixed, barring extreme circumstances.
Most of the wiki code so far (listings of articles, for instance) will use the wiki slug if present, and fall back to using articleXXXXX otherwise. We can still refer to a slug-ified article in the older style if we need to, but I don't think we will. For reference, the article ID is the same as the topic ID of the discussion for that article. So if a topic was topic45890, the corresponding article would be article45890.
Clear? This is a lot to digest, so don't hesitate to ask for clarification on anything I've left murky. Also, there's a good chance I've broken something while making all these changes, so be on the lookout for odd behavior or anything you think is clunky.
Last edited by jess on Sat Jun 07, 2008 4:20 pm; edited 1 time in total