[documentation] Theme developers guide overhaul

[Kieran Lal]

I think it would be a good idea to set up a skypecast to discuss this  
one evening.

I assume late at night PDT will synch with Germany.

Kieran

On May 25, 2006, at 9:49 PM, Steven Peck wrote:

> 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/
>>
>>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>