On Feb 16, 2008 5:29 AM, John Smith <[EMAIL PROTECTED]> wrote:
> * Step 1.3 - Models and Data
> ** Typo?
> "Put this in the "[app:man]" section."
> should be
> "Put this in the "[app:main]" section."

Typo.  Fixed.

> ** Unicode
> "Because databases cannot store Unicode directly, the
> "sqlalchemy.convert_unicode" option makes SQLAlchemy convert String
> columns to UTF-8 on write, and back to Unicode on read. Otherwise
> you'd get "str" strings containing whatever's in the database
> verbatim. (This is preferred over MySQL's "?use_unicode=1" option
> because it's database neutral.)"
>
> I think the word "Unicode" here means probably UTF-16, Python's
> internal encoding.
> The sentence "databases cannot store Unicode directly..." made me
> wornder,
> thinking "What? RDBMSs I know all support Unicode!"
> IMHO, this part could be clearer by explicitly distinguishing python's
> unicode from UTF-8.

It's different ways of saying the same thing.  I don't know which is
better.  RDBMS's could store Unicode as an array of integers, but
instead they store it as an encoded byte string.  I believe Python
uses UCS-16 or UCS-32, not UTF-16, but you're not supposed to know
that.  You're supposed to treat Unicode as an opaque type.

> ** Where to put engine_from_config
> "And append this to the load_environment function:"
> should be
> "And append this to *the end* of the load_environment function:"
> (After "# CONFIGURATION OPTIONS HERE" might be better)

Again, different ways of saying the same thing.  I changed it to "Put
this at the end of your load_environment function."


> ** Where's init_app?
> "Why is some code in init_app and other code isn't?"
> init_app is not mentioned until now. (I first thought this is a typo
> of init_model)
> "Why is some code in init_app in config/environment.py and other code
> isn't?"
> would be nice.

It does mean init_model.   init_app was an earlier name for that
function.  Fixed.

> ** What is websetup.py?
> I could not understand what websetup.py is for.
> Please add some explanation on this.

websetup.py is called by "paster setup-app".  I don't see how to put
an explanation in without making it too verbose, since "paster
setup-app" is not introduced until later.

> * Step 4.2 - Adding Content
> ** Path to site.html
> ~/MyBlog/myblog/templates/toolkit/index.html
> ~/MyBlog/myblog/templates/toolkit/add.html
> The path to the site.html written in above two file should be '/blog/
> site.html', not '/site.html'

Fixed.


-- 
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 [email protected]
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to