Difference between revisions of "mediawiki-customization"

From Microformats Wiki
mediawiki-customization
Jump to navigation Jump to search
m (mediawiki-mark-up-issues)
m (fmt)
Line 24: Line 24:
 
** hyphenated phrases are easier to read (for humans, duh) than CamelCased phrases and underscored_phrases. CamelCasing is a programmer convention that should have NEVER made its way into the textual user-interface (which URLs are a part of).  Others have made this deliberate fix as well, i.e. CSS property/value names like "border-left" in contrast to DOM property names like "onClick". I know this was a deliberate decision by either Bert Bos or Håkon Wium Lie or perhaps both (citation needed). Underscored_phrases are present far less often in normal average English prose and thus slower to read.
 
** hyphenated phrases are easier to read (for humans, duh) than CamelCased phrases and underscored_phrases. CamelCasing is a programmer convention that should have NEVER made its way into the textual user-interface (which URLs are a part of).  Others have made this deliberate fix as well, i.e. CSS property/value names like "border-left" in contrast to DOM property names like "onClick". I know this was a deliberate decision by either Bert Bos or Håkon Wium Lie or perhaps both (citation needed). Underscored_phrases are present far less often in normal average English prose and thus slower to read.
 
** hyphenated phrases are better indexed (SEO) than CamelCased phrases and underscored_phrases.  Search engines typically break apart hyphenated phrases into their component words and index them separately and together, whereas the same cannot be said for CamelCased or underscored_phrases.
 
** hyphenated phrases are better indexed (SEO) than CamelCased phrases and underscored_phrases.  Search engines typically break apart hyphenated phrases into their component words and index them separately and together, whereas the same cannot be said for CamelCased or underscored_phrases.
* '''Talk pages are lame and "one more inbox to check".''' Talk pages are lame (e.g. the structure/threading is poor) and we don't need yet another discussion area (in addition to IRC, [[mailing-lists]])  Eliminating them from the default user interface was the simplest way to effectively eliminate their usage. Invisible talk pages = nearly no one uses them.  And one fewer link cluttering the default UI is always nice.
+
* '''Talk pages are lame and "one more inbox to check".''' Talk pages are lame (e.g. the structure/threading is poor) and we don't need yet another discussion area (in addition to IRC, [[mailing-lists]])  Eliminating them from the default user interface was the simplest way to effectively eliminate their usage. Invisible talk pages = nearly no one uses them.  And one fewer link cluttering the default UI is always nice.
  
 
== How to ==
 
== How to ==
Line 32: Line 32:
  
 
==Related pages==
 
==Related pages==
 +
*The microformats MediaWiki customizations enable [[how-to-play]] and better [[naming-conventions]].
 
*[[mediawiki-mark-up-issues]]
 
*[[mediawiki-mark-up-issues]]
 
== Related ==
 
 
The microformats MediaWiki customizations enable [[how-to-play]] and better [[naming-conventions]].
 

Revision as of 00:34, 27 August 2007

MediaWiki customization

by Tantek

The MediaWiki installation at microformats.org/wiki has been customized in a number of ways.

This page documents some of these customizations for informative purposes. This documentation is neither thorough nor comprehensive.

Customizations

  • enable lowercase page names
  • enable hyphenated phrases for page names (rather than the MediaWiki default of converting dashes and spaces to underscores).
  • hide MediaWiki "Talk" links
  • ... more that I'm sure I'm forgetting at the moment.

Goals and motivations

I'm responsible for pushing for nearly all of the specific MediaWiki customizations on the microformats wiki and thus I figured I should capture at least some of the reasoning in the hopes that perhaps others may find it useful. Tantek

  • lowercase URLs are better. MediaWiki has an annoying tendency of capitalizing article titles, which, though may be stylistically proper (in the English writing style meaning of stylistic) for proper nouns, is incorrect for common terms (which a lot of microformats pages are). Oh and the whole "The initial capital letter is due to technical restrictions." nonsense on Wikipedia is ridiculous. It's software. Just fix it. More:
    • all same case is easier to read (citation required)
    • all lowercase is easier to read than all uppercase (citation required)
    • all lowercase is easier to type (citation required)
  • hyphenated-phrases are better than CamelCasedPhrases and underscored_phrases
    • hyphenated phrases are easier to read (for humans, duh) than CamelCased phrases and underscored_phrases. CamelCasing is a programmer convention that should have NEVER made its way into the textual user-interface (which URLs are a part of). Others have made this deliberate fix as well, i.e. CSS property/value names like "border-left" in contrast to DOM property names like "onClick". I know this was a deliberate decision by either Bert Bos or Håkon Wium Lie or perhaps both (citation needed). Underscored_phrases are present far less often in normal average English prose and thus slower to read.
    • hyphenated phrases are better indexed (SEO) than CamelCased phrases and underscored_phrases. Search engines typically break apart hyphenated phrases into their component words and index them separately and together, whereas the same cannot be said for CamelCased or underscored_phrases.
  • Talk pages are lame and "one more inbox to check". Talk pages are lame (e.g. the structure/threading is poor) and we don't need yet another discussion area (in addition to IRC, Mailing Lists) Eliminating them from the default user interface was the simplest way to effectively eliminate their usage. Invisible talk pages = nearly no one uses them. And one fewer link cluttering the default UI is always nice.

How to

Documentation on how to modify a MediaWiki install to get these customizations.

To Do: To be filled in. ;)

Related pages