[documentation] Theme developers guide overhaul

[Steven Peck]

We can either just work directly in the handbook which is what I figured
or I can open up http://scratch.blkmtn.org book module and set
permissions for anyone with a Drupal.org account to write to it.  

Heine?  It'll take 10 minutes to setup scratch and give you and others
rights.

On the bright side, though my workload has not decreased yet, the end is
in site.

-sp

> -----Original Message-----
> From: documentation-bounces at drupal.org 
> [mailto:documentation-bounces at drupal.org] On Behalf Of Dale McGladdery
> Sent: Thursday, May 25, 2006 9:21 PM
> To: A list for documentation writers
> Subject: Re: [documentation] Theme developers guide overhaul
> 
> What's the next step?  Is there going to be a web site set up for us
> to assemble everything?  (e.g., wiki or book module)
> 
> Some things that fit nicely into the outline:
>   - Specific mention of how CSS fits in
>   - Under variables, inclusion of how they change with 
> settings (eg $links)
>    (A reference table for this would be cool)
>  - Under coding samples, it would be cool to have an example 
> for all of
>    the major theme functions (if not all of them)
> 
> Some things that may or may not fit into the outline:
>  - Special consideration with respect to administration control panel?
>    (Showing my ignorance, there may not be any but I've 
> inferred there are)
>  - The node-[modulename].tpl.php convention/override
>   - How some of the Drupal dev tools can help
> 
> 
> On 5/24/06, Heine Deelstra <info at ustilago.org> wrote:
> > Here's a sketchy outline for the proposed theme docs.
> >
> > - Introduction
> >    - How Drupal generates output
> >    - Themes, engines & styles
> >    - Regions
> > - PHPTemplate
> >    - Introduction to PHPTemplate (explains the basics, 
> default overrides
> > etc)
> >    - page.tpl.php (explanation on the basic page)
> >      - available variables (list of available variables and 
> explanation)
> >    - node.tpl.php
> >      - idem
> >    - block.tpl.php
> >      - idem
> >    - comment.tpl.php
> >      - idem
> >    - boxes.tpl.php
> >    - Making extra variables available
> >    - Overriding theme functions (including clear 
> explanation of arguments &
> > argument passing etc)
> >    - Examples
> >      - Howto: do something specific
> >      - Snippets (?)
> >    - Updating your theme
> > - Other engines
> >    - XTemplate
> >    - PHPTal
> >      - idem (phptemplate)
> >    - Smarty (etc)
> >      - idem
> > - List of Forms & functions to override for drupal core, including
> > arguments / description
> > - Contributing a theme to Drupal.org
> >    - Adding your theme to Drupal.org
> >    - Screenshot guidelines
> >    - License
> >
> >
> >
> > --
> > Pending work: http://drupal.org/project/issues/documentation/
> > List archives: http://lists.drupal.org/pipermail/documentation/
> >
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
> 
>