You are not logged in.

Dear visitor, welcome to krpano.com Forum. If this is your first visit here, please read the Help. It explains in detail how this page works. To use all features of this page, you should consider registering. Please use the registration form, to register here or read more information about the registration process. If you are already registered, please login here.

1

Wednesday, July 21st 2010, 11:38am

Wiki Documentation of krpano - proposal

Klaus, I have an idea.

What about to install mediawiki and put the documentation on it.
And then allow some users (that you can trust them) to edit the wiki?

I know, you have not so many time to create help documentation and I understand it as programmer. ;-)
Because we all have fun to programm but not to write the boring help.

But If you let us to create help in this way, I think, it can give us good result.

If you want I can help you to start, install and write basic docs, because some time ago I have been playing arund the mediawiki and found it very good for documentation.

What do you and others think?

Regards
Greg

mindlessboss

Professional

Posts: 1,081

Location: Russia, Kaliningrad

  • Send private message

2

Wednesday, July 21st 2010, 6:29pm

That is interesting idea! *thumbsup*
VRAP - desktop VR content player based on krpano.
Common tasks in one place in one click! Discussion thread
DOWNLOAD for MAC
DOWNLOAD for WIN

Shanti

Intermediate

Posts: 301

Location: Puerto Vallarta

Occupation: Web Developer

  • Send private message

3

Thursday, July 22nd 2010, 1:09am

I agree, great idea :D

users will be able to create/add help topics :)

andrew22222

Intermediate

Posts: 341

Location: Australia

  • Send private message

4

Thursday, July 22nd 2010, 5:54am

I'm up for it .

Sometimes I find new things out while doing different projects or manage to decipher some technical jargon that many of us don't understand and would be more than happy to add things to the wiki.

Klaus, your Flash and iPhone viewer has a big following so the wiki will soon grow. After several months and you can create your own 'Official' documentation if you wish simply with a lot of copy and pasting rather than typing.

Good idea Greg. You are the wise one *thumbsup*

Andrew

image360

Intermediate

Posts: 204

Location: Austin, TX and Chicago, IL

Occupation: Photographer

  • Send private message

5

Thursday, July 22nd 2010, 7:29am

One for all and all for one.

Klaus, seems like a very good idea, no downside that I can see.

Growth requires change and a open hand.

Regards,

Robert

6

Thursday, July 22nd 2010, 1:52pm

Hi,

yes, good idea!
but I had to admit I have not much experiences with Wiki systems...

I have installed a Wiki here now: (that was the easy part ;-))

http://krpano.com/docu/wiki/

that's a fresh MediaWiki, I have just changed the skin a bit to integrate it to the krpano page,

what's next? *smile*

best regards,
Klaus

VN2009

Professional

Posts: 1,336

Location: Duluth MN

  • Send private message

7

Thursday, July 22nd 2010, 6:46pm

i created an account but dont know what to do next either!

8

Thursday, July 22nd 2010, 7:25pm

Next to do is to create the help pages, I mean to write all tags description and so on.
I have made one page for example:
http://krpano.com/docu/wiki/index.php/Krpano

Here is basic help, how to format wiki text at all:
http://www.mediawiki.org/wiki/Help:Formatting

It is easy, for example to do bold text you put it inside three apostrophe: '''bold'''
and so on.

But I think, at first, the Klaus should tell as and give example how the pages should be formated.
Another thing is to think about main categiories to create.

How to start a new page that not exists?
The easier way is to type the word into search field of wiki. For example type: scene.
Then it will be shown that the page doesn't exists and you can create it.
So click "create this page" and you can write the description of the scene's tag...

I think we can write the raw texts for now, and later to format it.

Regards
Greg

EDIT:
Klaus, you as administrato can edit left side of wiki, the part of menu.
Look here: http://www.mediawiki.org/wiki/Manual:Interface/Sidebar

9

Friday, July 23rd 2010, 11:29am

Hi,

thanks!

I have installed it also locally, I will play with it,
it will need some time to find out how to use it of course
and I'm not sure about the structure yet,

it is possible to 'collapse' elements there?
that could make things cleaner...

best regards,
Klaus

10

Friday, July 23rd 2010, 1:33pm

There are many extensions, for example
category tree

And there is more about to extensions of mediawiki.

Regards
Greg

Graydon

Professional

Posts: 614

Location: Texas

Occupation: Industrial gas turbine services.

  • Send private message

11

Sunday, July 25th 2010, 6:48am

Not sure of the best approach... but a starting point would be to mirror the existing documentation structure onto the wiki.

I think it's one of those things that will be great in a couple weeks / months... but the initial launch is a bit cumbersome.

But, I tried to do a little bit to help..

http://krpano.com/docu/wiki/index.php/Xml_reference

---------------------------

Some more thoughts...

First - if you (Klaus) decide to commit to a wiki, then eventually you can remove the documentation that is on the site here . That can be a good thing as it would enable others to update the documentation while you churn out updates. Based upon my experience with this community, I'd say that it would be in good hands. However, my very brief experience with playing with my own wiki is that it is very easy for someone to create an account and fill the thing with links to porn and pill sites. There might be automated tools that can combat this... but it will also place some burden on you and active contributors to monitor and clean up those items. I'm not suggesting that you don't move forward... just throwing out a word of caution as you do.

Second - Basic Structure...
The popularity of krpano will draw many types of users... at various stages of knowledge about krpano, and panorama photography in general. I think the wiki structure could be setup to reflect those various user levels... and the workflows they would follow for publishing panos using krpano.

The problem is that I can't come up with an optimal structure right now... so maybe the above is just something to keep in consideration as the wiki articles are developed.

Here lies the challenge with all things... how to structure things. At least the wiki structure enables a fair amount of flexibility to adjust as things develop.

This post has been edited 1 times, last edit by "Graydon" (Jul 25th 2010, 7:24am)


12

Tuesday, September 7th 2010, 5:20pm

Please sticky this thread, Klaus, and let's work on this seriously! If I arrived to the conclusion that a wiki was necessary after only a week (and found this thread when checking if anyone had previously thought the same), then it's probably because we really need one :P

EDIT: I'm actually experienced with mediawiki and fired up to help with this, so why don't you give me administrator access? ;) FTP access to localsettings.php would help, too! I don't think you have anything to lose; Feel free to back up first, of course.

13

Tuesday, September 7th 2010, 5:45pm

I'll also need access to the template files if you want me to add a collapsible box.

VN2009

Professional

Posts: 1,336

Location: Duluth MN

  • Send private message

14

Tuesday, September 7th 2010, 6:28pm

would be nice to get this started!

15

Tuesday, September 7th 2010, 8:29pm

But not much can be done before someone active has access enough to add extensions, add styles, change special pages, etc.

16

Wednesday, September 8th 2010, 5:39am

I don't know if this is possible, but i propose this structure for categories/sub-categories. It is similar to what we already have in the documentation section and mixes a bit of the forum categories; Bold text are categories and those that follow with an hyphen are sub-categories.
xml
- all tags

actions
- all possible actions

tools
- kprotect
- kmakemultires
- ....

html/javascript
- local usage
- javascript interface

actionscript/flash/flex

plugins
- soundinterface
- radar
- videoplayer
- .....

iphone/ipad

------------------------------------------------------------------
One more thing: Whenever anyone contributes something to the documentation, please mention the version information. Be it player, tools, plugins or whatever. Something like "version 1.0.8.11 OS: Windows".

17

Wednesday, September 8th 2010, 6:32am

Looks good to me. I don't usually use categories, but I guess they can only help. I already began adding stuff. There were also other pages people started months ago but they're very incomplete, so I'll merge them later. I'd like to wait for enough access to add styles for templates before getting started on actual pages for the actions and xml tags, but everyone please go and help yourselves to material from the old documentation and start copying it to the wiki (we'll also need klaus to set up image uploads here); Also finish the quick descriptions in the action list ^^ If anyone wants to change the stuff I added to the front page, that's just placeholder links to help people find stuff, I'm no good with front pages.

floz

Trainee

Posts: 109

Location: Uppsala, Sweden

  • Send private message

18

Wednesday, September 8th 2010, 8:34am

Guys, this is a great idea. Why didn't I (or anyone else) come up with this earlier?!

While I've had some decent experience with MediaWiki 4 years ago, I'm not the most up-to-date anymore. But what I'd suggest is that Klaus find a couple of guys with decent MediaWiki (backend as well as administration) knowledge to get things polished an ready for primetime. This includes:
  • Coming up with a rough structure of the whole documentation
  • Designing the landing page (and working on the theme some more, if desired)
  • Creating templates (for the xml entries, for instance), so same things look the same
  • Adding useful extensions for our context
  • Some amount of user / community management
  • Just generally tidying up things, here and there

19

Wednesday, September 8th 2010, 9:06am

I would add one more category terminology . This will explain the general terms used in virtual tour photography. Things like explanations for cylinder, spherical, cubical images; panoramas; virtual tours; stitching; fov etc.

20

Wednesday, September 8th 2010, 9:57am

Please sticky this thread, Klaus, and let's work on this seriously! If I arrived to the conclusion that a wiki was necessary after only a week (and found this thread when checking if anyone had previously thought the same), then it's probably because we really need one :P

okay, it's sticked now ;-)

Quoted

EDIT: I'm actually experienced with mediawiki and fired up to help with this, so why don't you give me administrator access? ;) FTP access to localsettings.php would help, too! I don't think you have anything to lose; Feel free to back up first, of course.

yes, you will get a mail soon,

best regards,
Klaus