Proposal: New Ogre Wiki

Anything and everything that's related to OGRE or the wider graphics field that doesn't fit into the other forums.
Locked

New Wiki FTW?

Aye, we need a better tool
118
67%
Nay, I am perfectly happy with MediaWiki
28
16%
I don't care much either way
31
18%
 
Total votes: 177

User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

If it turns out to be too much of a hassle, either leave it as-is, or remove it.

This is a wiki, for Christ sakes, Betajaen! :)
Not a BLOCKED competition.
Use you designer skills on the new theme, not on the wiki markup.

I plan to turn off HTML completely when all pages have been ported.
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
betajaen
OGRE Moderator
OGRE Moderator
Posts: 3447
Joined: Mon Jul 18, 2005 4:15 pm
Location: Wales, UK
x 58
Contact:

Re: Proposal: New Ogre Wiki

Post by betajaen »

It's easier to the cubes via css, I assume the header tags can accept a css class attribute?

[Edit]

Oh, I noticed my hover/tool tip thing is missing in Tiki. I remember when Spacegaier and I tried to make MediaWiki support the abbr tag, we had a bit of a job sorting it out. I think we ended up using templates When I have time, I'll put it back in, but I'll be surprised if TikiWiki does not support it.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Yeah, I forgot to mention that.
Could probably use the JS (javascript) tag?
Or, we could cook up our own tag.
I am going to write a Wikipedia tag anyway. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
betajaen
OGRE Moderator
OGRE Moderator
Posts: 3447
Joined: Mon Jul 18, 2005 4:15 pm
Location: Wales, UK
x 58
Contact:

Re: Proposal: New Ogre Wiki

Post by betajaen »

Yeah, jquery and those popup things would be ideal - if <abbr> is filtered out of course.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

QuickGui is done. :)
(Look at http://test.ogitor.org/tiki/Addons+Toc if you're curious about the hierarchy).
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

betajaen wrote:Yeah, jquery and those popup things would be ideal - if <abbr> is filtered out of course.
I tried using the 'tips' css class used by the jQuery tooltips, but I ran out of look when I realised that DIV doesn't take a 'title' parameter. :wink:
It works with a plain html link:

Code: Select all

<a class="tips", title="Hello|World">Hover Over Me</a>
Maybe I can create a socalled Plugin Alias for the DIV tag, taking a title parameter. That would solve the problem.
Hopefully. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Omg - I can't believe this:

Code: Select all

{MOUSEOVER(label="Hello")}Hello over there. It's fine!{MOUSEOVER}
Simple as that. :)
Maybe a css class for styling, but it turned out to be provided for. :)

It's like Qt: you end up finding out that it does it already.. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
betajaen
OGRE Moderator
OGRE Moderator
Posts: 3447
Joined: Mon Jul 18, 2005 4:15 pm
Location: Wales, UK
x 58
Contact:

Re: Proposal: New Ogre Wiki

Post by betajaen »

Nice!

Although I would of preferred an abbr tag. :D
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Do you want a plugin alias? :)
What remains is give it some style of it's own, and fix the alignment issues.
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
Beauty
OGRE Community Helper
OGRE Community Helper
Posts: 767
Joined: Wed Oct 10, 2007 2:36 pm
Location: Germany
x 39
Contact:

Re: Proposal: New Ogre Wiki

Post by Beauty »

When you edit a page, you see following buttons above the edit field.
Preview ... Save minor edits ... Save ... Cancel edit
If would be nice if you can add them additionally to the bottom of the page (in edit modus).
Help to add information to the wiki. Also tiny edits will let it grow ... :idea:
Add your country to your profile ... it's interesting to know from where of the world you are.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Beauty, your wish is my command.
Done. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

All pages in the Cookbook structure has been converted! :D
Ported: 1036 Remaining: 359 (Total: 1395).
ported_pages.png
ported_pages.png (804 Bytes) Viewed 2033 times
I have a feeling that I am able to actually do it. :)
'Addons' is next on the list.
And it's not smaller. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Just a small thing: No. The long and boring tables of content will be replaced by beautiful and modular overview pages.
The main Snippets page will include the GUI Snippets page which will include the CEGUI Snippets page, and so on.
With descriptions, images, etc.
All entries will be automatically updated when a new page/article is added.
So it will be up to date at all times.
Only requires that each article/snippet/page has the description field filled out. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Working on the 'Developer' structure right now.

I've always thought the Installing an SDK for Linux with four pages, one for each distribution, with only a couple of lines in each page, was a bit wasteful.
So, I removed the pages. :wink:
(I added an 'Alias' for each of the four removed pages so that any incoming links will be redirected).

And embedded the contents into the table - (click the '+' signs):
http://test.ogitor.org/tiki/Installing+ ... K+on+Linux
Neat? :)

Looking forward to do something radical about the Building from Source page..
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

The new Building From Source page:
http://test.ogitor.org/tiki/Building+From+Source

Look at the much cleaner Building From Source - Windows page. :)

So, I did it! :D
I've been meaning to do something about that page for ages.. R'ly. :P
Only 2 weeks before it's deprecated, but.. :lol:

<edit> Not finished cleaning it up, but I am happy with the way it's turning out. </edit>
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Now the good old (but horrible!) Setting Up An Application page has gotten a badly needed make-over:
http://test.ogitor.org/tiki/Setting+Up+An+Application

If you don't remember how horrible it really is, this is the 'original' :
http://www.ogre3d.org/wiki/index.php/Se ... pplication :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
Beauty
OGRE Community Helper
OGRE Community Helper
Posts: 767
Joined: Wed Oct 10, 2007 2:36 pm
Location: Germany
x 39
Contact:

Re: Proposal: New Ogre Wiki

Post by Beauty »

jacmoe, you are so unbelievable industriously ... much respect!

There came something in my mind:
It would be a pitty when all forum links to wiki pages are dead after the wiki change.
How we can solve this problem?

* Great would be redirections to the related page of the new wiki. But this should not be so easy, especially for changes page titles or merged/spitted pages.

* Keep the old wiki (freezed) and add notes/links to all pages, so that the people can look to the new wiki (maybe the realted page).

* When clicking an old link, show a short information page:
The wiki content was converted to a new wiki (January 2010).
Click here to go to the originally linked page of old wiki.

Or search for newer information in the current wiki:
* page with same title (if still exists)
* current wiki front page (with search function)
If someone has suggestions to improve this text, just write it.

What do other people think about this problem?
I don't like that all the helpful links get dead.
Help to add information to the wiki. Also tiny edits will let it grow ... :idea:
Add your country to your profile ... it's interesting to know from where of the world you are.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Beauty wrote:jacmoe, you are so unbelievable industriously ... much respect!
Thanks a lot, Beauty! :D
Beauty wrote:There came something in my mind:
It would be a pitty when all forum links to wiki pages are dead after the wiki change.
How we can solve this problem?
The beauty of the new wiki (no pun intended :P) is that the old links just works (or they ought to - haven't tested this, obviously).
The only links which will break is the anchored links to specific sections.
Doesn't matter much - they will end up on the Building From Source page, just not in the right section.

I haven't renamed many pages, and those I *did* rename was with an alias of the old page name.

For example:
http://test.ogitor.org/tiki/Codeblocks%20and%20MinGW
http://www.ogre3d.org/wiki/index.php/Co ... nd%20MinGW

Technically, Tiki replaces spaces with '+' and MediaWiki replaces them with '_', but they are the same.

The neatest thing is that we can nest pages in structures and move them around all we want - the names remains the same. :)
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
syd
Gnome
Posts: 362
Joined: Thu May 01, 2008 1:55 am
Location: Paris, France

Re: Proposal: New Ogre Wiki

Post by syd »

I admire your involvement, but besides it's pretty, I don't understand what kind of useful feature was needed there, is there any?
but still nice work :wink:
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

With all due respect: are you blind? :)

Take this page, for instance:
http://test.ogitor.org/tiki/MinGW+Toolbox+Install+Guide

Several things meets the eye:
  1. Clear structure
    Development » Building Ogre » Installing An SDK » Installing the Ogre SDK on Windows » Codeblocks and MinGW » MinGW Toolbox Install Guide
    You can see *exactly* where you are in the structure.
    You are not lost.
  2. Page tracker
    This page needs work
    With a link to the issue in the Wiki Page bug tracker.
    Makes it easy to manage pages with issues.
What doesn't meet the eye is the fact that *no page is outside a structure*
You can see that here:
http://test.ogitor.org/tiki/TOC+Development

Result: No page is lost.

Take for instance the
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

/* continuing after Real Life incidence */

take for instance a random snippet:
http://test.ogitor.org/tiki/Custom+Shadow+Mapping

You can see that it's in the Cookbook - Snippets - Shaders.

Every snippet, article, addon, source code file, and whatnot - everything is in a clear structure. So it's impossible to miss exactly where you're at. :)
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

Another valuable feature is code highlighting. :)

I've used c++, lua, python, bash, winbatch, xml, vbnet, C# ...
It does make it a lot easier to grok what's written.

Look at http://test.ogitor.org/tiki/Building+Fr ... x#Building for 'bash'.
http://test.ogitor.org/tiki/File+dialog ... log.layout for 'xml'.

It does make it easier to understand the material, doesn't it? :)

Add to that a better search engine.

And let's not forget Freetags:
http://test.ogitor.org/tiki/tiki-browse_freetags.php

It's ridiculously easy to add tags to a page, and I am pretty excited about seeing how the tagcloud will change when people start tagging. :)

You can search by multiple tags, so it should be even easier to find things. :wink:

And, lastly:
A much improved styling engine. :)
Take a look at the Wiki Styles here:
http://test.ogitor.org/tiki/Wiki+Styles

It's just CSS, and can be used with the DIV, BOX, IMG tags for looks.
No HTML at all.
In fact, I'm going to turn that off for the whole wiki.
The styling is just much more powerful, flexible and reusable. :)

And lastly, lastly:
The trackers.
http://test.ogitor.org/tiki/trackers
For instance, this:
http://test.ogitor.org/tiki/tracker4
is used here:
http://test.ogitor.org/tiki/Mogre+Add-ons
Everything after the image is generated from the tracker using a template. :)
(Just look at the source).

And to top it all off:
The Task List - http://test.ogitor.org/tiki/Public+Tasks
You can have your own, private tasks - and you can choose to share them.

And every user have their own list of notes, personal bookmarks, etc.

No, it wasn't a stupid question - and you're not blind. :)

Thanks for asking. :wink:
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

If any of you is actually *reading* all I just wrote - thanks a lot for doing that! :P
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
User avatar
syd
Gnome
Posts: 362
Joined: Thu May 01, 2008 1:55 am
Location: Paris, France

Re: Proposal: New Ogre Wiki

Post by syd »

ok, I admit I didn't take close look to the whole thing, but I have to say you sold it very well =)
it is beautifully well made :)
you forgot to mention the pretty image viewer :wink:
User avatar
jacmoe
OGRE Retired Moderator
OGRE Retired Moderator
Posts: 20570
Joined: Thu Jan 22, 2004 10:13 am
Location: Denmark
x 179
Contact:

Re: Proposal: New Ogre Wiki

Post by jacmoe »

syd wrote:ok, I admit I didn't take close look to the whole thing, but I have to say you sold it very well =)
it is beautifully well made :)
Thanks a lot, Syd. :)
I've putting a lot of work into it, but I believe it to be worth the effort.
syd wrote:you forgot to mention the pretty image viewer :wink:
:wink:
Forgot a lot of extras, actually.
Especially one thing, which might save us from losing valuable things:
You can attach files to a wiki page.
This means that we don't have to host un-wiki'able files elsewhere. :)
I've noticed several wiki pages which has been rendered useless, because a link to the source, additional files, etc. has gone dead. :(
Not any more: just attach the files to the page, and forget about you moving to a new host, your MediaFire file timing out, or other disasters.
/* Less noise. More signal. */
Ogitor Scenebuilder - powered by Ogre, presented by Qt, fueled by Passion.
OgreAddons - the Ogre code suppository.
Locked