create a site structure

cebe commented 13 years ago

we need a structure for the github page

It should contain

a list of available extensions.
guides how to clone and work with repos
We could add the markup docs rendered and published automatically there.
For downloads we should link to http://www.yiiframework.com/extensions/ . @samdark: Is every extension listed on yiiframework.com?

cebe commented 12 years ago

take a look at http://thechangelog.com/post/11502590572/paige-site-generator-for-github-pages-powered-by-docco-a to check out if it helps us...

cebe commented 12 years ago

https://github.com/rthauby/Paige

samdark commented 12 years ago

No, not every extension is listed at yiiframework.com.

cebe commented 12 years ago

just seen that github has a download feature now: https://github.com/yiiext/with-related-behavior/downloads

cebe commented 12 years ago

I'm planning to auto-generate a website for yiiext.github.com using the github api: https://github.com/yiiext/github-api main page will show a short description of what yiiext is and then list all extensions with short description from github repo. Every extension will have a detail page with docs and download links. Any ideas/input/feedback @samdark?

samdark commented 12 years ago

Very good idea.

cebe commented 12 years ago

could you all please create tags in your extension repos for all relevant versions? If we have tags, we could auto generate a download list and build zips dependend on tags.

You can add a tag just like this: git tag v0.9.8 <commit hash> -a -m "version 0.9.8" the -a makes a tag annotated which means, that it will have a message and some information on when it was created etc, this is the recommended way to create tags for versions.

when you added tags, you can push them to github with git push --tags

thanks in advance! @cavemanlu @creocoder @DeusModus @Ekstazi

cebe commented 12 years ago

please read the comment above: @kirs @RusAlex @samdark @slavcopost @Stamm @teamtpg @timlar github is restricting the number of mentions in here...

samdark commented 12 years ago

Will do.

kirs commented 12 years ago

Yeah, http://thechangelog.com/post/11502590572/paige-site-generator-for-github-pages-powered-by-docco-a generator is very useful.

cebe commented 12 years ago

cool, but i'd like to do some more magic with github api ;-) I am currently working on a yii app that creates the site and will update it automatically every day. Currently ran into a huge mass of bad structured code, thats why I didn't push anything yet.

kirs commented 12 years ago

@cebe do you mean yii app that manages yiiext.github.com?

cebe commented 12 years ago

yep

samdark commented 12 years ago

Tagged most of extensions.

cebe commented 12 years ago

thx, first part of the site is online now. Extensions and readmes are available. Meta-Content like FAQ, Tutorials and contact has to be written and main page should have categories to be able to find one extension out of 50.

http://yiiext.github.com/

samdark commented 12 years ago

Wow! That's just great. Can we contribute to the script behing these pages?

cebe commented 12 years ago

Thanks, of course you can. It's the webapplication that is in yiiext core repo. Should run without special configuration only if it is not under a separate v-host you might have to adjust the .htaccess RewriteBase. Be aware of long loading time when you run it first, since the main page does about 300 Requests to gihub api that will be cached for further requests.

yiiext / yiiext.github.com

create a site structure #1