[documentation] Theme developers guide overhaul

[Dale McGladdery]

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/
>