On 5/14/07, Tom Purl <[EMAIL PROTECTED]> wrote:
Sebastian Menge has graciously created a Mediawiki template that could
be used with the proposed Vim wiki. Here's a link to the template:
* http://scratchpad.wikia.com/wiki/Template:Tip
This is the "wrapper" for the actual tip content. Here's an example of
some plain-text content:
{{Tip
|id=1
|title=Tip #1 - the super star
|created=February 24, 2001 14:47
|complexity=basic
|author=scott at kintana.com
|version=5.7
|text=
When a discussion started about learning vim on the vim list Juergen
Salk mentioned the "*" key as something that he wished he had
know earlier. When I read the mail I had to go help on what the heck the
"*" did. I also wish I had known earlier...<br><br>Using the
"*" key while in normal mode searches for the word under the
cursor.<br><br>If that doesn't save you a lot of typing, I don't know
what will.
}}
When you combine this content with the template on the wiki, you get the
following:
* http://scratchpad.wikia.com/wiki/VimTip1
The big benefit of using a wiki template is that it separates the
content from the presentation, which can be very nice from the
perspective of a sysadmin or tip converter.
The disadvantage, in my eyes, of using wiki templates is that it adds
another barrier to entry for potential tip authors/editors. Not only
would they have to know how to do basic Mediawiki editing, but they
would also have to know how to use templates. Also, in my opinion, it
is more difficult to edit the content when it's "squished" into a
template.
So far, we know about the opinions of me and Sebastian. What does
everyone else think? Is the template thing a good idea for our wiki?
Thanks again!
Tom Purl
I think that a template is a good idea, but like someone else (was it
you Tom) said in another thread, let's make the metadata more subtle.
It really dominates the page and it's kindav an eyesore. I put up
another template and it is at
http://scratchpad.wikia.com/wiki/Template:Tip2 with a demo at
http://scratchpad.wikia.com/wiki/VimTip1_v2 . The only difference
being that I manually took the #1 off of the tip title from VimTip1
and I made the "Your signed comments here." not part of the template,
which was probably not really intended in the original anyway. What
do you guys think? The other idea that I had was to completely remove
the first header (==Tip: #{{{id}}} - {{{title}}}==) and have the tips
actually indexed something like that, so you would have that header by
default, and then a comments thing at the bottom.
-fREW
