Re: Theme developers guide overhaul

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@xxxxxxxxxx
> > [mailto:documentation-bounces@xxxxxxxxxx] 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@xxxxxxxxxxxx> 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/

--
Pending work: http://drupal.org/project/issues/documentation/
List archives: http://lists.drupal.org/pipermail/documentation/