Jump to content


Photo
- - - - -

Framework child theme documentation


  • Please log in to reply
10 replies to this topic

#1 JohnMagic

JohnMagic

    Advanced Member

  • Members
  • 87 posts

Posted 13 January 2012 - 10:50 PM

The framework it self seems nice, even though I have not tested it live yet with plugins and the wiki is nice in explaining how stuff work out-of-the-box. The framework needs child themes though and as I understand there i absolutely no documentation for the only child theme iBlog5. As far as I have experienced theres no wiki documentation, no readme documentation, no changelog documentation, and no inline documentation in css etc. Theres also changes from iBlog4 that makes it neccessary to redo customizations done on iBlog4 to have the same look and functionlity in iBlog5. For a framework to be successful it needs good child theme, and documentation is an important part of theme quality. I strongly suggest that the Pageline developers document the child themes.

#2 mackenzie

mackenzie

    Advocate

  • Members
  • 333 posts
  • Country: Country Flag

Posted 14 January 2012 - 01:31 AM

The developers have just informed me that the documentation for child themes is, in fact, being developed and should be published in the next few weeks. If you have a specific question though, please feel free to let us know and we'll be happy to help.

#3 JohnMagic

JohnMagic

    Advanced Member

  • Members
  • 87 posts

Posted 14 January 2012 - 08:54 PM

What will the documentation include ?

#4 catrina

catrina

    Advocate

  • Members
  • 12345 posts
  • LocationCalifornia
  • Country: Country Flag

Posted 14 January 2012 - 09:25 PM

I'm not certain what exactly the documentation will include.

#5 JohnMagic

JohnMagic

    Advanced Member

  • Members
  • 87 posts

Posted 14 January 2012 - 11:04 PM

Is there anything the documentation is known to include, and would you/the devs like to have community input on what do document and how to document ?

#6 Simon_P

Simon_P

    Messer

  • Administrators
  • 8388607 posts
  • LocationDevon
  • Framework Version:2.0
  • Country: Country Flag

Posted 14 January 2012 - 11:51 PM

What sort of documentation do you need? How to install a child theme? Here are the docs on how to use the blank base theme to customize your parent theme: http://www.pagelines..._the_Base_Theme Problem here is you have already installed a child theme, and wordpress will only allow one child to be the active theme, grandchild themes are not supported and never will be. So we invented the customize plugin, which emulates a child theme. http://www.pagelines...ustomize_Plugin

#7 JohnMagic

JohnMagic

    Advanced Member

  • Members
  • 87 posts

Posted 15 January 2012 - 03:01 AM

It would be useful if you documented div and css structure and naming schemes. Theres a dusin or more css files in framework + child theme.

#8 catrina

catrina

    Advocate

  • Members
  • 12345 posts
  • LocationCalifornia
  • Country: Country Flag

Posted 15 January 2012 - 04:54 PM

By DIV and CSS structure are you referring to a list of the CSS selectors?

#9 JohnMagic

JohnMagic

    Advanced Member

  • Members
  • 87 posts

Posted 15 January 2012 - 05:55 PM

Div structure may be done as a graphic with comments, I have seen it done with on other frameworks. Css need to be more than a list, it should document how the css for the most important elements work.

#10 catrina

catrina

    Advocate

  • Members
  • 12345 posts
  • LocationCalifornia
  • Country: Country Flag

Posted 15 January 2012 - 05:59 PM

I have seen it done with other frameworks, as well. Thanks for the suggestion.

#11 Simon_P

Simon_P

    Messer

  • Administrators
  • 8388607 posts
  • LocationDevon
  • Framework Version:2.0
  • Country: Country Flag

Posted 15 January 2012 - 08:20 PM

Did you check out this? http://www.pagelines...electors#Item_1 Few other useful links http://www.pagelines...izations#Item_1