Templating & Documentation


#1

Hi everybody,
I am new to Typo and just started using it. I chose Typo because I’m
sick of
hacking PHP applications which look good on the outside but stink on the
inside.

So, my first question is about documentation. Where do I start? I want
to
know about how to write templates for Typo and I want to add Plugins and
maybe even hack core files. Is there something like an API
documentation?

I already got some nice results by creating a template and comparing it
to
the ones coming with Typo. However, I want to do more:

  • I want to be able to place (specific) plugins (like the “Pages”
    plugin)
    outside of the sidebar partial. So, it would be nice to have another
    custom
    partial to place plugins in (for example a horizontal aligned area).

  • I need to know where to find information about what method calls are
    useful for template creation. Is there a place where I can read about
    that?

Thanks!

Tobias


#2

Le 20 déc. 08 à 12:34, Tobias Weisserth a écrit :

about that?

Thanks!

Tobias

Hi Tobias,

Sorry for not replying sooner, I had to translate my Typo theming
quickguide in english before this.

Typo plugins are basic rails plugins for now. Except for sidebars, we
don’t really have any plugins API like Wordpress has. However, you can
just write rails plugins and call the methods in your template.

I know Typo lacks documentation, and this is a point we need to
improve on.

Hope this helps,
Frédéric


Frédéric de Villamil
removed_email_address@domain.invalid tel: +33 (0)6 62 19 1337
http://t37.net Typo : http://typosphere.org


#3

Hi Frederic,
Wow. :slight_smile: It must be Christmas already! Thank you for replying that
detailed.

I already had a github account, but yesterday I started getting involved
a
little bit more by forking Typo, so I can follow the current source tree
and
have the chance to send patches back upstream.

The work on my first template is progressing fine in general (it already
works satisfying in 5.1.3), thanks to Scribbish being a good model to
look
at when starting something new. Right now, I’m dealing with a couple of
details I haven’t understood yet. For example, when linking
the style-sheet in the layout.html.erb:

<%= stylesheet_link_tag ‘/stylesheets/theme/application.css’, :media =>
‘all’ %>

The ‘theme’ string does not appear on the live site in the path. Is this
some kind of placeholder mechanism? How exactly does it work?

I also want to create some href tags programmatically like

<%= link_to this_blog.blog_name, this_blog.base_url %>

but pointing to the admin page instead.

I haven’t yet understood how the view dispatching works in Typo with
templates, but my next step would be to look at the code and work my way
through the code, so I can understand what’s available and what I might
need
to add myself.

I noticed your activity at github yesterday and I have to say that I’ve
got
a very good feeling about Typo. I think there’s a lot of potential in
it. I
hope I can add to it.

thanks and a happy holiday season,

Tobias

On Sun, Dec 21, 2008 at 11:11 AM, de Villamil Frédéric <