# Spherical forums

## General Discussion => Site Comments => Topic started by: DaVince on March 11, 2013, 07:14:01 am

Title: Spherical Wiki
Post by: DaVince on March 11, 2013, 07:14:01 am
I figured it would be a good idea to make a new thread regarding discussion of the new wiki.

To start out, I salvaged and copied over the function reference page from the old wiki (thank you, WayBackMachine!):
http://wiki.spheredev.org/Functions

Also started porting over my tutorial, though the subpages which contain the bulk of the content hadn't been cached so I have to manually restyle everything (will finish this later):
http://wiki.spheredev.org/DaVince_scripting_tutorial
Title: Re: Wiki
Post by: Flying Jester on March 11, 2013, 08:30:17 am
I have about thirty old pages from the wiki, if it would help.
Title: Re: Wiki
Post by: DaVince on March 11, 2013, 11:55:02 am
As far as I'm concerned, go ahead and put them on there. :)

Which articles? (Not like it matters much, all of them are useful.) Are they in HTML or wikisource? Might need to do some conversion there.
Title: Re: Wiki
Post by: N E O on March 11, 2013, 10:53:54 pm
I want to amend a bit the editing procedure we'll use for Sphere's API on the wiki. I want functions to be tagged with the earliest possible version of Sphere in which they appeared and if they're deprecated in 1.6 and later. You can probably use extra categories for both, but let's be consistent throughout.

For pre-1.5, say its version is 1.1; 1.5 is 1.5, 1.6 is 1.6, and 1.7 (however alpha or beta it may still be) is 1.7. TurboSphere will be considered a version, and any functions marked as such will only consider the latest working version of TurboSphere until TS actually reaches at least Sphere 1.5 parity, then those after that will have TurboSphere version numbers.

Any wiki experts who have wiki accounts (I haven't done wiki+forum integration yet, and haven't yet decided if we'll have it this go around) feel free to make some templates, and remember we have ParserFunctions installed. For later articles, we'll eventually have MathML using MathJax and the same syntax highlighter Wikipedia uses.

I'm also taking suggestions for possible wiki extensions that may be useful!
Title: Re: Spherical Wiki
Post by: N E O on March 12, 2013, 03:02:39 pm
Stickied as the official wiki thread.
Title: Re: Wiki
Post by: DaVince on March 13, 2013, 05:44:15 am

I want to amend a bit the editing procedure we'll use for Sphere's API on the wiki. I want functions to be tagged with the earliest possible version of Sphere in which they appeared and if they're deprecated in 1.6 and later. You can probably use extra categories for both, but let's be consistent throughout.

For pre-1.5, say its version is 1.1; 1.5 is 1.5, 1.6 is 1.6, and 1.7 (however alpha or beta it may still be) is 1.7. TurboSphere will be considered a version, and any functions marked as such will only consider the latest working version of TurboSphere until TS actually reaches at least Sphere 1.5 parity, then those after that will have TurboSphere version numbers.

Good idea. What's going to be the standard way to do this? I'm thinking a bar at the top of the article reserved for indicating what version it was introduced in, and if it should still be used. Something like:

Code: [Select]
[ Introduced in 1.0 | Removed in 1.6 onward; do not use! ]
Title: Re: Spherical Wiki
Post by: N E O on March 13, 2013, 03:06:50 pm
For the deprecation warning, definitely a template where you can pass as a variable the version number in which it was first deprecated and it will autogenerate the necessary category (should probably read "Deprecated in vX.Y" or something similarly simple) and autogenerate the warning box wherever it's placed (which means we should probably require its placement at the very top of the article in question, along with other similar warning boxes).

For the version, a template with your "Introduced in vX.Y" generated category should suffice and we can always edit it later as needed (with necessary redirections for category renames as well).
Title: Re: Spherical Wiki
Post by: Flying Jester on March 14, 2013, 01:31:14 pm
About the wiki, would it be kosher for me to post some TurboSphere pages there? I have a couple articles written but only included in the TurboSphere internal docs w/ the source, too (moving from Sphere to TurboSphere, Differences, Writing Plugins, etc.) as well.

As far as I'm concerned, go ahead and put them on there. :)

Which articles? (Not like it matters much, all of them are useful.) Are they in HTML or wikisource? Might need to do some conversion there.

They are HTML. Definitely going to need to do a little conversion work, but that's no big deal. Most of them are about surfaces and the map engine, although there is a little of everything. I do have three (I think) tutorials as well.

For pre-1.5, say its version is 1.1; 1.5 is 1.5, 1.6 is 1.6, and 1.7 (however alpha or beta it may still be) is 1.7. TurboSphere will be considered a version, and any functions marked as such will only consider the latest working version of TurboSphere until TS actually reaches at least Sphere 1.5 parity, then those after that will have TurboSphere version numbers.

This sounds good to me, I think. You're saying that functions will be marked both for Sphere and TurboSphere, but only marked with a version for Sphere, and not have a 'version  introduced' tag for TurboSphere, right?

Also, once TS 1.0 (which should be on par with 1.5, or so I'm planning) is released I'll be moving to the X.Y version numbers for TS, too.
Title: Re: Spherical Wiki
Post by: DaVince on March 14, 2013, 02:57:54 pm
My opinion: wait until 1.0 (or maybe 0.2!) and create the articles on your user page instead (Flying Jester/article name).
Title: Re: Spherical Wiki
Post by: N E O on March 14, 2013, 05:51:54 pm

About the wiki, would it be kosher for me to post some TurboSphere pages there?

Do what DaVince suggested first and keep them localized to your user page until it's finalized; after that, I'm all for a TurboSphere wiki namespace (eg, TS-specific articles will be prefixed TurboSphere: with TS: being an alias to the namespace).

...

This sounds good to me, I think. You're saying that functions will be marked both for Sphere and TurboSphere, but only marked with a version for Sphere, and not have a 'version  introduced' tag for TurboSphere, right?

Also, once TS 1.0 (which should be on par with 1.5, or so I'm planning) is released I'll be moving to the X.Y version numbers for TS, too.

I'm saying if something is introduced in TurboSphere, whether it gets backported to vanilla Sphere or not, it should have a category/tag like "Introduced in TS vX.Y" or something but only once TS is on par w/1.5 (let's assume TS 1.0 will be this parity version). Anything TS introduced before 1.0 would say "Introduced in TS v1.0" because we wouldn't count TS introductions before that.

On a related note, I'd recommend that once TS 1.0 is out and 1.5 parity is obtained, the next goal should be 1.6 parity and then a version jump for TS to 1.6 to start matching the appropriate Sphere version from then on.
Title: Re: Spherical Wiki
Post by: N E O on March 16, 2013, 04:51:24 pm
Wiki procedure update: when writing articles now, please put Sphere API in the namespace API and custom scripts in the namespace Script.

For example, my bezier curve script article is now located at http://wiki.spheredev.org/Script:Bézier_curves (http://wiki.spheredev.org/Script:B%C3%A9zier_curves) but there's a redirect from a namespace-less article because I wanted to.

So, for example, a Sphere function or object article would be called API:CreateColor instead of simply CreateColor; making the namespace-less version redirect is optional, but depending on wiki expansion the namespace-less article may become a disambiguation page instead of a full-on redirect.
Title: Re: Spherical Wiki
Post by: DaVince on March 16, 2013, 05:35:35 pm
Should Functions go into API:Functions with Functions just redirecting to that, then?
Title: Re: Spherical Wiki
Post by: Flying Jester on March 18, 2013, 12:00:13 am
I'll begin adding in the function pages I salvaged from ye olde wiki. Should function pages have a TOC? Some of the ones I saved do and some don't.

On the topic of the wiki, some anti-spam control may already be in order...check the recent changes to see what I mean.
Title: Re: Spherical Wiki
Post by: N E O on March 18, 2013, 08:40:49 pm

Should Functions go into API:Functions with Functions just redirecting to that, then?

Yes.

I'll begin adding in the function pages I salvaged from ye olde wiki. Should function pages have a TOC? Some of the ones I saved do and some don't.

On the topic of the wiki, some anti-spam control may already be in order...check the recent changes to see what I mean.

re TOC - normally I'd recommend a TOC, but most function pages are so light on content that it doesn't really need them. Explicitly __NOTOC__ them from now on, thanks.

re spam - I'm actually going to do that right now. Thanks for the heads up!
Title: Re: Spherical Wiki
Post by: N E O on March 19, 2013, 02:54:59 pm
Ok, so the Check User extension to ban IPs works, but doesn't let be enter a range of IPs. Also, I choose to manually delete users once the IP's been banned. I may need to have someone become a wiki moderator ("bureaucrat" is the wiki term for it) to check wiki sign-ups for spam and to ban IPs in case I'm unable to do it at a given time.

Except for a couple, I have most of the anti-spam extensions Wikipedia does installed onto the wiki. There's one that allows plugins, but I haven't gone searching for them yet.
Title: Re: Spherical Wiki
Post by: N E O on March 22, 2013, 10:43:09 am
I'm thinking of disabling normal wiki account creation and instead offloading it to OpenID integration via an extension. Are there any here with any particular objections to OpenID as the wiki account mechanism?
Title: Re: Spherical Wiki
Post by: DaVince on March 22, 2013, 02:44:22 pm
How does that work, exactly? On some sites I've seen that you have to pass some sort of OpenID URL, in some other cases it was something with logging in...
Title: Re: Spherical Wiki
Post by: N E O on March 23, 2013, 05:12:24 pm
The extension handles all the URL passing and such, I gather. MediaWiki's spam prevention doc (http://mediawiki.org/wiki/Manual:Combating_spam) recommends it, so there's probably something to it.

Given that there have been a few dozen spam registrations over the past couple of days, I'm temporarily disabling wiki registration until I can get this sorted out.
Title: Re: Spherical Wiki
Post by: N E O on March 23, 2013, 06:34:46 pm
Ok, installed OpenID on the wiki. Apparently, it's been a while since I've seen OpenID in action, as I've completely forgotten until now that it also lets you choose to tie a Google account to it!

So this interface allows either manually passing an OpenID URL or choosing to tie another OpenID-enabled account (like a Google account) instead. Once you tie the account, THEN you can choose what you want your wiki username to be. For now I've disabled choosing an existing wiki username to tie with the OID acct, so @DaVince & @Flying Jester if you currently have trouble logging into the wiki let me know and I'll figure something out (will probably re-enable tying to an existing username for a small period of time in that case).
Title: Re: Spherical Wiki
Post by: Flying Jester on March 23, 2013, 08:24:42 pm
It looks like I can no longer use the wiki name 'Flying Jester', because I already registered that before. And I can't seem to log in with just my username and account I made for the wiki before.
Title: Re: Spherical Wiki
Post by: N E O on March 23, 2013, 10:25:48 pm
@Jester - sent PM re accts.

New wiki topic - the following is a list of articles (and subsequently the links they contain) I'd consider higher priority than some other non-API articles:

Template:functemp (critical as of 2013/03-27; created 3-28 but lacking category template)
Template:objecttemp (critical as of 2013/03-27)

Sphere:Latest (archived at http://web.archive.org/web/20121031101209/http://spheredev.org/wiki/Sphere:Latest (http://web.archive.org/web/20121031101209/http://spheredev.org/wiki/Sphere:Latest))
Script:Persist.js (archived at http://web.archive.org/web/20100621061805/http://www.spheredev.org/wiki/Persist.js (http://web.archive.org/web/20100621061805/http://www.spheredev.org/wiki/Persist.js)) DONE!
Script:json.js (archived at http://web.archive.org/web/20100621060813/http://www.spheredev.org/wiki/Json.js (http://web.archive.org/web/20100621060813/http://www.spheredev.org/wiki/Json.js)) DONE!
Main Page (archived at http://web.archive.org/web/20121011104106/http://spheredev.org/wiki/Main_Page (http://web.archive.org/web/20121011104106/http://spheredev.org/wiki/Main_Page); the content isn't necessarily essential, but for me the layout kinda is; eh, maybe the content too)
Higher-order programming in JS (archived at http://web.archive.org/web/20120828191718/http://www.spheredev.org/wiki/Higher-order_programming_in_JavaScript (http://web.archive.org/web/20120828191718/http://www.spheredev.org/wiki/Higher-order_programming_in_JavaScript))
Battle System Tutorial by Flik (archived at http://web.archive.org/web/20120811000937/http://spheredev.org/wiki/Battle_System_Tutorial_by_Flik (http://web.archive.org/web/20120811000937/http://spheredev.org/wiki/Battle_System_Tutorial_by_Flik))

list of tutorials archived at http://web.archive.org/web/20120901210809/http://www.spheredev.org/wiki/Category:Tutorials (http://web.archive.org/web/20120901210809/http://www.spheredev.org/wiki/Category:Tutorials)

Also, I've created a template called "section" for marking out a colored box with what amounts to aside or warning text.

Alsoalso, for future reference and convenience for me, a possible todo list:

https://meta.wikimedia.org/wiki/Music_markup (https://meta.wikimedia.org/wiki/Music_markup)
http://www.mediawiki.org/wiki/Manual:Math (http://www.mediawiki.org/wiki/Manual:Math)
http://www.mediawiki.org/wiki/Extension:Math (http://www.mediawiki.org/wiki/Extension:Math) (specifically, http://www.mediawiki.org/wiki/Extension:Math#MathJax (http://www.mediawiki.org/wiki/Extension:Math#MathJax))
possibly http://www.mediawiki.org/wiki/Manual:Enable_TeX (http://www.mediawiki.org/wiki/Manual:Enable_TeX)

2013/03-27 - waiting on response from original author re adding http://www.extentofthejam.com/pseudo/ (http://www.extentofthejam.com/pseudo/) to the wiki...
2013/03-28 - added MgOpen Modata & League Gothic webfont styling to wiki headings
2013/04-06 - added gist extension to wiki; can now embed a gist by <gist>GIST_ID</gist>
2013/04-20 - added CodeEditor extension to wiki; JS & CSS editors (eg, your personal CSS and JS) are now syntax highlighted
2013/05-31 - finished restoring kamatsu's Understanding musical theory (http://wiki.spheredev.org/Understanding_musical_theory) article, but need missing linked files
2013/06-03 - restored persist.js (http://wiki.spheredev.org/Script:persist.js) and json.js (http://wiki.spheredev.org/Script:json.js) articles, persist demo now hosted on Spherical's GDrive.
Title: Re: Spherical Wiki
Post by: N E O on April 06, 2013, 04:44:27 pm
Request: can someone with more consistent internet and a bit more time get all the SVGs from https://commons.wikimedia.org/wiki/Category:Musical_score_components_(2) (https://commons.wikimedia.org/wiki/Category:Musical_score_components_(2)) (885 in total it seems) and upload them to the wiki under their same name? I want the music score template I copied to actually work if we can't get some sort of musictex happening, thanks.
Title: Re: Spherical Wiki
Post by: N E O on May 20, 2013, 03:04:12 pm
NOTICE: I'd like to institute a new wiki article convention. For articles regarding Sphere API, if the function or variable in question belongs to a Sphere object (eg, Sound.play() ) the article's title should be API:Object/member (with member being in its proper case, eg API:Sound/play). Anyone who knows wikitext will realize this makes the article a sub-page of the Object article, eg Sound/play is a sub-page of the Sound article.

Sound (http://wiki.spheredev.org/API:Sound)

Sound.play (http://wiki.spheredev.org/API:Sound/play)

Also! I added a new template, Usage, that should be used for marking up a Sphere function's example usage. Visit Sound.play for an example, and if you need multiple usages in an article let me know and I'll show you how to mark it up.

Title: Re: Spherical Wiki
Post by: Radnen on May 20, 2013, 05:54:47 pm
I made a sound.isPlaying page: http://wiki.spheredev.org/API:Sound/isPlaying

The usage displays a bit weird, since it has no parameters.

Also, the new API: convention means we have to switch over sll others to use it right? The Functions page doesn't use this convention so someone would have to go through and edit all of the links.  :o
Title: Re: Spherical Wiki
Post by: N E O on May 21, 2013, 01:43:25 pm
I'll fix the template, that's mainly me forgetting to fix the default for the params argument. (edit - fixed)

Re the API: convention, yes that does mean someone or someones plural would have to go through the Functions page and edit links. Block by block is probably the best way to handle it and I'll make a small dent in it right now in a few of the Objects to reduce some of that work.

edit: finished editing the links for the Objects in the Functions page. Also fixed/redirected existing functions that weren't taken care of previously.
Title: Re: Spherical Wiki
Post by: N E O on May 22, 2013, 01:15:29 pm
Added a navbox template; see http://wiki.spheredev.org/Template:Mario_franchise (http://wiki.spheredev.org/Template:Mario_franchise) for a sample navbox and http://wiki.spheredev.org/MediaWiki:Sandbox (http://wiki.spheredev.org/MediaWiki:Sandbox) for transclusion.

The navbox template is mainly for an alternate organization of Functions that subdivides them to be handled more independently of each other. When you write a function page, you'd put the navbox of that function's section at the footer, eg Image.blit would have the Image navbox at the bottom. I feel it's going to become very useful in the future.

edit - also split out the Objects on the Functions page into separate pages transcluded into it; I highly recommend following suit with the other sections on that page as well.
Title: Re: Spherical Wiki
Post by: N E O on May 31, 2013, 06:31:51 pm
Restored tung's Git for the lazy (http://wiki.spheredev.org/Git_for_the_lazy) article since apparently it has importance beyond Sphere usage and Wayback Machine failed when attempting to archive it on May 12th.
Title: Re: Spherical Wiki
Post by: N E O on June 01, 2013, 10:11:23 pm
New documentation conventions!

I finished converting all the links on the Functions page to now point to the API namespace properly. I've also started filling in a few pages myself. A particular change to note is how I've set up the system scripts to be linked.

Visit the system scripts article (http://wiki.spheredev.org/System_scripts) and you'll notice that not only does it now redirect to "Script:System" but also all the system scripts are linked as subpages; "menu.js" becomes "Script:System/menu.js" and so on. Visit the Wayback Machine version of the article (http://web.archive.org/web/20120828115617/http://www.spheredev.org/wiki/System_scripts) to get links to the original script articles for restoration and cleanup.

I've also updated the wiki's syntax highlighter to once again highlight Sphere functions and link them to wiki articles. I'm updating the list as I go but for now I don't give special treatment to methods of Sphere objects, so only unattached functions like "GetVersion" get linked. If I figure out a way without basically writing my own JS parser to differentiate methods so that a "clone" method links appropriately to Image.clone or Font.clone then I'll add those, but until then they're left being highlighted as non-linked object members according to the existing highlight rules.
Title: Re: Spherical Wiki
Post by: N E O on June 03, 2013, 07:41:29 pm
There are almost 400 API articles that need to be restored/written. Can someone besides myself start tackling that please?
Title: Re: Spherical Wiki
Post by: Radnen on June 03, 2013, 07:49:28 pm
I'll try to pitch in a few every once in a while, but I'm super busy. Spherical is tertiary on my priority list. ;)

But also the wiki is kinda slow loading, so it takes a while to edit a new page.
Title: Re: Spherical Wiki
Post by: N E O on June 07, 2013, 09:02:31 pm
Some articles restored; Radnen's second battle system tutorial (http://wiki.spheredev.org/Battle_System_Tutorial_by_Radnen) is one of them.

@Radnen - That tutorial had a lot of potential, I'd love to see it filled some more!
Title: Re: Spherical Wiki
Post by: Radnen on June 07, 2013, 09:19:35 pm
Thank you for doing that! I'll see about implementing a version of that tutorial.
Title: Re: Spherical Wiki
Post by: N E O on June 08, 2013, 05:17:53 pm
NOTICE: I've put into place a mechanism by which an article can link to alternate language versions of an article. Visit this MediaWiki page (http://www.mediawiki.org/wiki/Template:Languages) to see how to create an article in a language other than English and what to transclude so that the article links to all of its available languages.

Visit the Sphere page (http://wiki.spheredev.org/Sphere) and its newly created Spanish translation (http://wiki.spheredev.org/Sphere/es) (which I hope doesn't suck too bad! ;)  ) to see it in action live.

I hope this is useful in the future, as I know we have a more than a few users who speak and/or write a language that's not English and this officially give us the opportunity to properly store articles on the wiki in alternate languages :)
Title: Re: Spherical Wiki
Post by: N E O on July 02, 2013, 01:38:38 pm
Added the ability to add citations to an article like Wikipedia; visit https://www.mediawiki.org/wiki/Extension:Cite/Cite.php#Usage (https://www.mediawiki.org/wiki/Extension:Cite/Cite.php#Usage) and https://www.mediawiki.org/wiki/Extension:Cite/Special:Cite.php#Example (https://www.mediawiki.org/wiki/Extension:Cite/Special:Cite.php#Example) for usage.
Title: Re: Spherical Wiki
Post by: N E O on August 26, 2013, 05:07:14 pm
MAJOR UPDATE: Added the Math extension and it uses MathJax (JavaScript) for rendering. Visit http://en.wikipedia.org/wiki/Help:Math (http://en.wikipedia.org/wiki/Help:Math) (particularly the Formatting using TeX (http://en.wikipedia.org/wiki/Help:Math#Formatting_using_TeX) section) for instructions on what TeX/LaTeX the [itex] element supports.
Title: Re: Spherical Wiki
Post by: Mooch on December 05, 2014, 12:11:37 am
Is the Wiki down? It connects, but just shows a blank page when I try going to it.
Title: Re: Spherical Wiki
Post by: Flying Jester on December 05, 2014, 12:33:05 am
Yes.

It's a 500: Internal Error. DaVince and I both alerted Neo, who is working on the issue.

I'm sure Neo can tell you more.
Title: Re: Spherical Wiki
Post by: Mooch on December 07, 2014, 02:30:15 am
Alright, thanks.

I just wanted to look up one of the beginners guides to get my head back in the game.
Title: Re: Spherical Wiki
Post by: DaVince on June 19, 2017, 09:16:28 am
Both registration and logging in seem to be pretty broken on the wiki right now, as a result of the server upgrade a while ago. I'm going to look into it.
Title: Re: Spherical Wiki
Post by: DaVince on June 20, 2017, 07:09:56 am
Edit: I stated the wiki is under maintenance mode, but I disabled this again for the time being. Updating the wiki is a task that will take some time.

In the meantime, if you need to have a new account, please let me know.