search

yiisoft / yii2

Yii 2: The Fast, Secure and Professional PHP Framework
http://www.yiiframework.com
BSD 3-Clause "New" or "Revised" License
14.23k stars 6.91k forks source link

Add an example page with all the Yii2 (Bootstrap) widgets being used as in real life #8164

Open patlecat opened 9 years ago

patlecat commented 9 years ago

Every time I try to use a Bootstrap widget from within Yii2 I struggle to get it working and even more to customize it. The docs for the widgets are not written for the user but for the Yii-Devs.

An example page may help with this though, just to show all of them in 1 page with realistic settings/options and how to check and use them from within Yii2 directly. Add to that a little bit of inline code documentation and voilà :dancers:

samdark commented 9 years ago

That's already planned. Not only for Bootstrap... https://github.com/yiisoft/yii2/blob/master/docs/guide/README.md#widgets

patlecat commented 9 years ago

Excellent. I wish I could help but I'm still struggling with Yii2 too much. And for when is this planned?

samdark commented 9 years ago

For new website which is in progress.

Not sure when exactly it will be released. Depends very much on how much work there's in non-OpenSource projects we're all earn for a living with.

Sammaye commented 9 years ago

In the mean time you can just read the PHP source directly, it is well documented and plugins by Yii core are standardised very well so one pattern that applies to one will apply to all.

patlecat commented 9 years ago

@Sammaye No user should be forced to read the source code of any framework or library, that is sort of defeating its purpose ;)

Sammaye commented 9 years ago

Much of the doc is made from the source :\ your reading the source by reading the doc

On 25 April 2015 at 09:21, patlecat notifications@github.com wrote:

@Sammaye https://github.com/Sammaye No user should be forced to read the source code of any framework or library, that is sort of defeating its purpose ;)

— Reply to this email directly or view it on GitHub https://github.com/yiisoft/yii2/issues/8164#issuecomment-96157292.

Sammaye commented 9 years ago

To expand, I am not sure if Yii2 uses this but I believe they use something similar to: http://www.phpdoc.org/ in order to make some doc which parses phpdoc and makes documentation from it, or they did. I am unsure if hand write it all now

On 25 April 2015 at 10:30, Sam Millman sam.millman@gmail.com wrote:

Much of the doc is made from the source :\ your reading the source by reading the doc

On 25 April 2015 at 09:21, patlecat notifications@github.com wrote:

@Sammaye https://github.com/Sammaye No user should be forced to read the source code of any framework or library, that is sort of defeating its purpose ;)

— Reply to this email directly or view it on GitHub https://github.com/yiisoft/yii2/issues/8164#issuecomment-96157292.

patlecat commented 9 years ago

@Sammaye "Much of the doc is made from the source :\ your reading the source by reading the doc" nonsense dude, what you see in the source code is called "code documentation" which is then extracted to HTML! Not the source code itself!

Sammaye commented 9 years ago

The source is anything that in the php file, a phpdoc block is still code it is merely assigned as code comments by the interpreter

On 26 April 2015 at 11:13, patlecat notifications@github.com wrote:

@Sammaye https://github.com/Sammaye "Much of the doc is made from the source :\ your reading the source by reading the doc" nonsense dude, what you see in the source code is called "code documentation" which is then extracted to HTML! Not the source code itself!

— Reply to this email directly or view it on GitHub https://github.com/yiisoft/yii2/issues/8164#issuecomment-96360081.

ScottHuangZL commented 9 years ago

Please try Kartik-v widgets. He create a set of improved bootstrap widgets for Yii2. Thanks. http://http://demos.krajee.com/