Re: Documentation for begginers

2008-01-28 Thread Christoph Haas

Hi, Mike...

On Sun, Jan 27, 2008 at 08:46:20PM -0800, Mikeroz wrote:
 I've just started to have some fun with pylons and I've got a question
 - what's wrong with the documentation? I mean - it's cool because it's
 there but there's almost no tutorials and stuff... is someone working
 on it? Or maybe someone could give us (begginers) some links to
 them? :)

When I started playing with Pylons many moons ago I found myself in the
same situation. And documentation was even worse back then. It's nice
that the wiki contains documentation on many topics. But there's nothing
like a print it out and let it lie around at the toilet tutorial so
that's what I started working on. It was delayed because there were some
changes between 0.9.4 and 0.9.6 that I wanted to document properly and
during the same time Michael Bayer was bored and tossed the SQLAlchemy
API around making most of my documentation deprecated before I could
check it in. ;)

Currently I can only show a cheat sheet at
http://wiki.pylonshq.com/display/pylonsmisc/Pylons+Cheatsheet which is
not quite suitable for beginners but up-to-date. And quite some time ago
I contributed my
http://wiki.pylonshq.com/display/pylonscookbook/Concepts+of+Pylons
article which is technically less detailed but gives an overview of
Pylons.

So my current work is to create a profound article introducing newcomers
to the general concepts of MVC and Pylons while creating an actual
Pylons project (a bookmark manager) that deals with many areas like
i18n, session cookies, AJAX, deployments, database models, templates,
URL routing, form validation and best practices using paster shell and
the online debugger. The working title is Beginning Pylons and it's
currently maintained at
http://workaround.org/cgi-bin/hg-beginning-pylons but it's in no way
ready to be used. However I keep receiving feedback from people who want
me to finish that article so as soon as I can show something I'll ask
for feedback.

Some time this year Apress is to release a Pylons book, too. AFAIK it
will also be available as LGPL or something. So perhaps I'm creating
redundant work - I don't know. Perhaps that slows down my efforts a
little because I hate redundancy. Let's see what comes first. :)

Cheers
 Christoph
-- 
[EMAIL PROTECTED]  www.workaround.org   JID: [EMAIL PROTECTED]
gpg key: 79CC6586 fingerprint: 9B26F48E6F2B0A3F7E33E6B7095E77C579CC6586

--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
pylons-discuss group.
To post to this group, send email to pylons-discuss@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/pylons-discuss?hl=en
-~--~~~~--~~--~--~---



Re: Documentation for begginers

2008-01-28 Thread Mike Orr

On Jan 28, 2008 12:53 AM, Christoph Haas [EMAIL PROTECTED] wrote:

 Hi, Mike...

 On Sun, Jan 27, 2008 at 08:46:20PM -0800, Mikeroz wrote:
  I've just started to have some fun with pylons and I've got a question
  - what's wrong with the documentation? I mean - it's cool because it's
  there but there's almost no tutorials and stuff... is someone working
  on it? Or maybe someone could give us (begginers) some links to
  them? :)

 When I started playing with Pylons many moons ago I found myself in the
 same situation. And documentation was even worse back then. It's nice
 that the wiki contains documentation on many topics.

I wonder if Mikeroz saw the Pylons Cookbook, which contains a few tutorials.
http://wiki.pylonshq.com/display/pylonscookbook/Home

QuickWiki and Flickr are in the official docs.
http://wiki.pylonshq.com/display/pylonsdocs/

What exactly is missing?

One thing that's missing, I think, is how to build a bigger app.  What
choices are available for the optional features and add-on packages,
and how to choose whether to use them or not.

 So my current work is to create a profound article introducing newcomers
 to the general concepts of MVC and Pylons while creating an actual
 Pylons project (a bookmark manager) that deals with many areas like
 i18n, session cookies, AJAX, deployments, database models, templates,
 URL routing, form validation and best practices using paster shell and
 the online debugger. The working title is Beginning Pylons and it's
 currently maintained at
 http://workaround.org/cgi-bin/hg-beginning-pylons but it's in no way
 ready to be used. However I keep receiving feedback from people who want
 me to finish that article so as soon as I can show something I'll ask
 for feedback.

That sounds wonderful.  The official docs can't do an in-depth
discussion of MVC and
other background stuff, but something like this can.

 Some time this year Apress is to release a Pylons book, too. AFAIK it
 will also be available as LGPL or something. So perhaps I'm creating
 redundant work - I don't know. Perhaps that slows down my efforts a
 little because I hate redundancy. Let's see what comes first. :)

The text will be online.  But that's several months away.  Ben's also
planning an upgrade to
the official docs.  So you could coordinate with them to make sure
it's not redundant.  However,
your bookmark app and different perspective will  be worth reading in any case.

-- 
Mike Orr [EMAIL PROTECTED]

--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
pylons-discuss group.
To post to this group, send email to pylons-discuss@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/pylons-discuss?hl=en
-~--~~~~--~~--~--~---



Re: Documentation for begginers

2008-01-28 Thread Mikeroz

About QuickWiki tutorial:

in models, _init_.py file i've got:

class Page(object):
content = None

def __str__(self):
return self.title

def get_wiki_content(self):
content = publish_parts(self.content, writer_name=html)
[html_body]
titles = sets.Set(wikiwords.findall(content))
for title in titles:
title_url = h.url_for(controller='page', action='index',
  title=title)
content = content.replace(title, h.link_to(title,
title_url))
return content

mapper(Page, pages_table)

and when I go with paster setup-app development.ini it shows error
name Page is not definied. Where could I go wrong?

--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
pylons-discuss group.
To post to this group, send email to pylons-discuss@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/pylons-discuss?hl=en
-~--~~~~--~~--~--~---



Re: Documentation for begginers

2008-01-28 Thread Philip Jenvey


On Jan 28, 2008, at 4:46 PM, Mikeroz wrote:


 About QuickWiki tutorial:

 in models, _init_.py file i've got:

 class Page(object):
 content = None

 def __str__(self):
 return self.title

 def get_wiki_content(self):
 content = publish_parts(self.content, writer_name=html)
 [html_body]
 titles = sets.Set(wikiwords.findall(content))
 for title in titles:
 title_url = h.url_for(controller='page', action='index',
   title=title)
 content = content.replace(title, h.link_to(title,
 title_url))
 return content

 mapper(Page, pages_table)

 and when I go with paster setup-app development.ini it shows error
 name Page is not definied. Where could I go wrong?


Your mapper line seems to be indented incorrectly (it shouldn't be  
indented at all). Python most likely gave you its specific line  
number in the error message.

--
Philip Jenvey



--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
pylons-discuss group.
To post to this group, send email to pylons-discuss@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/pylons-discuss?hl=en
-~--~~~~--~~--~--~---



Documentation for begginers

2008-01-27 Thread Mikeroz

Hi everyone :)
I've just started to have some fun with pylons and I've got a question
- what's wrong with the documentation? I mean - it's cool because it's
there but there's almost no tutorials and stuff... is someone working
on it? Or maybe someone could give us (begginers) some links to
them? :)
Best wishes,
Mike *mikeroz* Rozycki

--~--~-~--~~~---~--~~
You received this message because you are subscribed to the Google Groups 
pylons-discuss group.
To post to this group, send email to pylons-discuss@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/pylons-discuss?hl=en
-~--~~~~--~~--~--~---