Spherical forums

General Discussion => Site Comments => Topic started by: N E O on April 02, 2013, 01:23:37 pm

Title: Spherical Downloads Repository
Post by: N E O on April 02, 2013, 01:23:37 pm
Given the apparent volatility of Spherical hosting until this point, it would behoove us to have a consistent place to host the downloads formerly available on-site. We have a mirror on TenguDev thanks to DaVince, but we can't rely solely on one person to have conveniently downloaded and hoarded all there is to download.

So! I'd like to propose hosting the actual downloads themselves, along with their appropriately formatted documentation on a GitHub repo. sphere-projects (https://github.com/sphere-group/sphere-projects) has been created with this purpose in mind. Any Sphere developer here who has a GitHub account and would like to add projects to it let us know here. DaVince will curate it as he has done previously and anyone who needs the documentation format can get it from him for now.

@DaVince - I recommend putting up the documentation format on a thread so we all have something to refer to. The GitHub repo's README can also explain the documentation, so feel free to update it since I gave you push & pull permissions (and will give you admin privileges on that repo shortly). Also, please let me know who else was supposed to be able to write to it so I can add them to the repo admins once I confirm the existence of their GitHub accounts.
Title: Re: Downloads repository
Post by: N E O on April 02, 2013, 01:54:02 pm
Also! Along with using a GitHub repo for downloads hosting, I'm going to implement embedding GitHub Gists into posts here. If a mod exists and it's extensible, maybe we can even embed jsfiddle and CodePen samples and such later on. If a mod doesn't exist I'll have to make one and it'll take longer to add other pastebin embedding.
Title: Re: Downloads repository
Post by: Radnen on April 02, 2013, 07:30:40 pm
Eww, using GitHub as a file hosting service. Isn't there something else designed for that purpose, like say Google Drive? I think Google, being awesome, gives you 10 GB of space.
Title: Re: Downloads repository
Post by: alpha123 on April 02, 2013, 11:27:33 pm
Well, given that they're scripts, presumably they would be versioned. So I think GitHub is a fine choice. The downloader/editor/whatever-gets-the-scripts could even check and see if they're up-to-date.

Alternatively you could do that with Google Drive and zsync (http://zsync.moria.org.uk/) or something, but then you lose the ability to roll back to previous versions.
Title: Re: Downloads repository
Post by: Radnen on April 03, 2013, 01:03:03 am

Well, given that they're scripts, presumably they would be versioned.


Yeah, but we're talking about full games. I guess for a small community it's not so bad, but a public GitHub account is not private, and so it limits what people want stored on there. Furthermore, it would for the most part act as a database and for many things just to host them, as in projects not in active development like trial and error. This is something we are just going to have to do for ourselves. Really! RMN doesn't do this, so we don't have to either.
Title: Re: Downloads repository
Post by: Flying Jester on April 03, 2013, 01:53:40 am

Alternatively you could do that with Google Drive and zsync (http://zsync.moria.org.uk/) or something, but then you lose the ability to roll back to previous versions.


I'm not sure how much benefit the ability to rollback versions would be in this context.
Title: Re: Downloads repository
Post by: DaVince on April 03, 2013, 07:21:35 am
Sorry for all the lack of activity here - my life has gotten more busy!

But agreed: something akin to Google Drive would work better than GitHub. Not sure if Google Drive is the exact best solution to go with, though I have to say it definitely works for me when using it for school-related work.

I'll set some time apart tomorrow for writing up what kind of documentation should go with game/resource zips. I might do it on Google Docs for some collaborative thinking and editing, though. ;)
Title: Re: Downloads repository
Post by: N E O on April 03, 2013, 01:43:45 pm
Hang on a sec...y'all have given me an idea...

One of the things Dom has given me for the resurrected Spherical is a Google Apps account for spheredev.org. I just checked and it seems it also includes Google Drive usage! @DaVince - I'm going to PM you account details and you let me know who else should have them for downloads management via GDrive.
Title: Re: Downloads repository
Post by: alpha123 on April 03, 2013, 02:36:18 pm

I'm not sure how much benefit the ability to rollback versions would be in this context.

I was thinking along the lines of "this new script has a major API change and breaks my game, I want to go back to the old one". But if it's going to be games and not scripts it probably isn't worth being able to rollback.
Title: Re: Downloads repository
Post by: N E O on April 03, 2013, 07:14:16 pm
We'll use GitHub Gists for individual scripts once I set up a mod.
Title: Re: Downloads repository
Post by: Radnen on April 03, 2013, 08:54:40 pm

We'll use GitHub Gists for individual scripts once I set up a mod.


Alright, that won't be so bad.
Title: Re: Downloads repository
Post by: N E O on April 03, 2013, 08:57:14 pm


We'll use GitHub Gists for individual scripts once I set up a mod.


Alright, that won't be so bad.


Gist embedding now available! I may even attempt JSFiddle and CodePen embedding soon :)
Title: Re: Downloads repository
Post by: alpha123 on April 04, 2013, 12:18:21 pm

We'll use GitHub Gists for individual scripts once I set up a mod.

That seems like a good solution.

Also the Gist embedding is awesome. :)
Title: Re: Downloads repository
Post by: Flying Jester on April 04, 2013, 12:59:08 pm
How is Gist embedding done?
Title: Re: Downloads repository
Post by: alpha123 on April 04, 2013, 01:46:17 pm

How is Gist embedding done?

See http://forums.spheredev.org/index.php/topic,18.msg216.html#msg216
Basically it's just [gist]GIST_ID[/gist]
Title: Re: Downloads repository
Post by: DaVince on April 04, 2013, 03:52:47 pm

@DaVince - I recommend putting up the documentation format on a thread so we all have something to refer to.

Assuming you're talking about an additional metadata file for Sphere projects, I've started writing a spec. It's viewable (publicly) here:
https://docs.google.com/document/d/13q4tDmkflPWkVOWcP8zkqX5kbr8Wk_PXYMKOl5jUSFE/edit?usp=sharing

Please feel free to join in. Anyone with the right account details (Neo, Radnen) can help get this spec right, too.
Title: Re: Downloads repository
Post by: DaVince on April 04, 2013, 06:04:08 pm
Sphere releases are mirrored on the repository:
https://drive.google.com/folderview?id=0B-5bW82jK5Z5X2pkellDenZUeWM&usp=sharing
Title: Re: Downloads repository
Post by: N E O on April 05, 2013, 11:49:13 am
I'm sure I (or someone else here just in case) can come up with a simple way to list on the main site downloads that are shared from that GDrive. Worst comes to worst I'll probably just hardcode the given links and write a script to list them or something.
Title: Re: Downloads repository
Post by: DaVince on April 05, 2013, 09:44:50 pm

I'm sure I (or someone else here just in case) can come up with a simple way to list on the main site downloads that are shared from that GDrive. Worst comes to worst I'll probably just hardcode the given links and write a script to list them or something.

It's actually rather easy - we make one main folder we put everything else in, and share that folder.
Title: Re: Downloads repository
Post by: DaVince on April 09, 2013, 10:31:14 am
From now on, all games should have an info.txt included in their game directory (alongside game.sgm). Full specs on what the file looks like here (https://docs.google.com/document/d/13q4tDmkflPWkVOWcP8zkqX5kbr8Wk_PXYMKOl5jUSFE/edit?usp=sharing).

Anyone is free to comment on this and give suggestions.

When this info.txt becomes final
Title: Re: Downloads repository
Post by: DaVince on April 09, 2013, 06:37:45 pm
I've been setting things up, and the downloads repo is almost ready to be released publicly! Only thing I need to know from people is if the format of info.txt looks good, and if people would include such a file with their game.

Example info.txt:
Code: [Select]

The Best Game Of Your Life
Version 1.0
Pete Anderson, His brother
pete@anderson.com, his@brother.com
[Official site](www.thebestgame.com), [Forum](spheredev.org/abc)
Licensed: GPL 2.0

Description
===========
This is the best game you'll ever play.
I mean, you play as this weird thing, you know? And it just kind of does stuff. Ain't that awesome?

Controls
========

Keyboard
--------
Q = Jump

Joystick
--------
Button 1 = Jump
Button 6 = Float around a bit

Credits
=======
Pete Anderson - he made the game!
His brother - for input and stuff!
The Sphere community (spheredev.org) - you know who you are!
Title: Re: Spherical Downloads Repository
Post by: DaVince on April 12, 2013, 11:49:10 am
Above spec will be used for extra info files included in games from now on. We'll start making these info files for every games and upload them to the repository!