[web2py] Re: looking for volunteers to help proof-read book 5th ed.
Massimo, Do you plan to add a section to briefly highlight the major revisions when the new edition of web2py book comes online? Thanks, Wen On Sunday, January 20, 2013 6:52:02 PM UTC-5, Massimo Di Pierro wrote: > > I am looking for help proofreading the final version of the book. It is > almost done up to a final touch. > > The attached file contains the changes between the 4th edition and 5th > edition (only the new text). It would be great is some native english > speaker could be me proof-read the changes. If you can help please edit the > text in place with a text editor, without adding line breaks or extra > spaces so I can diff the corrections. > > The first two people who volunteer to help and can proof-read the attached > file by Saturday, will receive a free copy of the printed book as soon as > it is done. > > Massimo > > > -- --- You received this message because you are subscribed to the Google Groups "web2py-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to web2py+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/groups/opt_out.
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
A few minor typos -
Line 17178 under WingIDE, Rad2Py, and Eclipse - change 'execued' to
'executed'
from:
+it does not change the logic as this is never execued but it forces the
IDE to parse it and understand where the objects in the global namespace
come from (the ``gluon`` module) thus making autocompletion work.
to:
+it does not change the logic as this is never executed but it forces the
IDE to parse it and understand where the objects in the global namespace
come from (the ``gluon`` module) thus making autocompletion work.
Line 17200 under Publishing a folder - change 'fiels' to 'files'
from:
+which you can render in a view with ``{{=fiels}}``.
to:
+which you can render in a view with ``{{=files}}``.
I'm not sure whether text under Google Wallet is being updated in the new
edition but the current 4.9 edition has a few missing or incorrect words
(proposed text shown below in CAPS) -
"If you want a tighter integration, you have to use the Level 2
notification API. In that case you can pass more information to Google and
Google will call your API to notify about purchases. This allows you to
keep accounting information within your application but it requires you TO
expose web services that can talk to Google Wallet.
This is a considerable -> CONSIDERABLY more difficult problem but such AN
API has already been implemented and it is available as A plugin from ."
and under Stripe.com:
"Stripe also allows you TO verify a transaction at a later time:"
Dane
--
---
You received this message because you are subscribed to the Google Groups
"web2py-users" group.
To unsubscribe from this group, send email to
web2py+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
> Thanks for the wonderful web2py. Here are some spelling errors that I
>> found in
>
> the diff download.
>
>
>> +As soon as you type something in the search box and release a key, the
>> client calls the server and sends the content of the 'keyword' field, and,
>> when the sever responds, the response is embedded in the page itself as the
>> innerHTML of the 'target' tag. {when the server responds
>
>
>>
>> +yet this representation in internationalized and you can use the admin
>> stranslation page to change the format to an alternate one. For example:
>
>
>> looks like stranslation shoud be translation}}}
>
>
>>
>> +Mind that by default English is not translated because web2py assumes
>> the applications is already written in English. If you want
>> internationalization to work for English you need to create the translation
>> file (using admin) and you need declare that the application current
>> language is something other than english, for example:
>
>
>> assumes the applications are already written}}
>
>
>>
>> +Then choose a slug (in the publishing business, a slug is a short name
>> given to an article that is in production) and you will be redirected to an
>> empty page where you can edit the content using MARKMIN wiki syntax. A new
>> menu item called "[wiki]" will allow you create, search, and edit pages.
>> Wiki pages have RULS like:
>
> + RULS should be URLS?}
>
>
>>
>> Try create more pages such as "index", "aboutus", and "contactus".
>
> +Try edit them.
>
>
>> {{{ Try to createTry to edit them. }}}
>
>
>>
>> +- ``render`` which defaults to ``'markmin'`` but can be set equal to
>> ``'html'``. It termines the syntax of the wiki. We will discuss the markmin
>> wiki markup later. If you change it to HTML you may want to use a wysiwyg
>> javascript editor such as TinyMCE of NicEdit.
>
> {{{ It determines the syntax}}}
>
>
>> +- ``manage_permissions``. This is set to ``False`` by default and only
>> recognizes permissions for "wiki-editor" and "wiki-author". If you change
>> it to ``True`` the create/edit page will give the option to specify by
>> names the groups whose members have permission to read and edit the page.
>> In this case is a group "everybody" to give read permission to everybody.
>
>
>> {{ please eix this last sentence, "In this case is a group" which does
>> not make sense.}}}
>
>
>>
>> +- ``restrict_search``. This default to ``False`` and any logged-in user
>> can search all wiki pages (but not necessary read or edit them). If set to
>> ``True``, authors can search only their own pages, editors can search
>> everything, other users cannot search anything.
>
>
>> {{{ This defaults}}}
>
>
>>
>> +This call the join function passed as extra with parameters
>> ``a,b,c=1,2,3`` and will be rendered as ``1-2-3``.
>
>
>> {{{This calls the join }}
>
>
>> +Mind that the menu is appended to ``response.menu``. It does not replace
>> it. The ``[wiki]`` menu tem with service functions is added automatically.
>
> +
>
>
>> menu item with service }
>
>
>> +Also, by setting resolve to ``False`` in the method call, the wiki
>> tables will be now accesible trough the app's default db interface at
>> ``/appadmin`` for managing wiki records.
>
>
>> {{{accessible through the app's }}}
>
>
>> i+This allows the visitor interact with the component via Ajax without
>> reloading the host page that embeds the widget. Basically the action is
>> called via Ajax, inherits the stile of the host page, and capture all forms
>> submissions and flash messages so that they are handled within the current
>> page. On top of this the ``SQLFORM.grid`` widget uses digitally signed URLs
>> to restrict access. More information about components can be found in
>> chapter 13.
>
>
>> {{inherits the style of the host }}}
>
>
>> +This simply tells web2py that we want to incude the "manage_things"
>> action defined in the "default" controller as an Ajax "component".
>
>
>> we want to include the }}}
>
>
>> +Notice that the admin application includes "plugin_jqmodile" which
>> packages jQuery Mobile. When admin is accessed from a mobile device;
>
>
>> {{{ includes "plugin_jqmodule" }}}
>
>
>> +- ``response._caller``: this is a function that wraps all action calls.
>> It defaults to the identity function, but it can be modifed in order to
>> catch special types of exception to do extra logging;
>
> + ``
>
>
>> it can be modified in
>
>
>
I will read some more this evening.
--
Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.
*Experiences with janrain* I wanted to get janrain work and I have spent some hours to start this service. Maybe the following lines could help: (1) From the book: You can register with Janrain.com, register a domain (the name of your app) and set of URLs you will be using, and they will provide you with an API key. (2) There is a short description how to use janrain in the file db.py: ## if you need to use OpenID, Facebook, MySpace, Twitter, Linkedin, etc. ## register with janrain.com, write your domain:api_key in private/janrain.key #from gluon.contrib.login_methods.rpx_account import use_janrain #use_janrain(auth, filename='private/janrain.key') Both „domain:api_key“ and „private/janrain.key“ are wrong. (3) The correct example is in the book: Integration with OpenID, Facebook, etc. You can use the web2py Role Base Access Control and authenticate with other services like OpenID, Facebook, LinkedIn, Google, Dropbox, MySpace, Flickr, etc. The easiest way is to use Janrain Engage (formerly RPX) (Janrain.com) Now edit the model of your web2py application and place the following lines somewhere after the definition of the auth object : from gluon.contrib.login_methods.rpx_account import RPXAccount auth.settings.actions_disabled=['register','change_password','request_reset_password'] auth.settings.login_form = RPXAccount(request, api_key='...', domain='...', url = "http://localhost:8000/%s/default/user/login"; % request.application) The first line imports the new login method, the second line disables local registration, and the third line asks web2py to use the RPX login method. You must insert your own api_key provided by Janrain.com, the domain you choose upon registration and the external url of your login page. * *(4) Maybe the last lines should be changed to: auth.settings.login_form = RPXAccount(request, api_key='...', domain='...', url = "http://your-external-address/%s/default/user/login"; % request.application) The first line imports the new login method, the second line disables local registration, and the third line asks web2py to use the RPX login method. Login at janrain.com and go to Deployment > Application Settings. On the right side there is the „Application Info“: The api_key is called „API Key (Secret)“. The domain is the „Application Domain“ *without leading *„https://“ and *without the trailing *„.rpxnow.com/“ For example: if you have registered a website like „secure.mywebsite.org“ Janrain has turned it to the Application Domain „ https://secure-mywebsite.rpxnow.com“. Please insert only „secure-mywebsite“ as domain. The url is the external url of your login page. (5) Proceed to Deplayment > Application settings > Domain Whitelist Enter „your-external-address“ and press „Save“ Without this registration you will get an error message like „The token URL or xdReceiver has not been whitelisted“ (6) Proceed to Deployment > Sign-in for Web and change the „Layout“ or select the „Providers“ Done – enjoy! Regards, Martin *For the 5th edition of the book?* 13858 -url = "http://localhost:8000/%s/default/user/login"; % request.application) 13858 -url = "http://your-external-address/%s/default/user/login"; % request.application) 13861 -The first line imports the new login method, the second line disables local registration, and the third line asks web2py to use the RPX login method. You must insert your own ``api_key`` provided by Janrain.com, the domain you choose upon registration and the external ``url`` of your login page. 13861 +The first line imports the new login method, the second line disables local registration, and the third line asks web2py to use the RPX login method. 13862 + 13863 +- 13864 +Login at janrain.com and go to Deployment > Application Settings. On the right side there is the "Application Info": The ``api_key`` is called "API Key (Secret)". The ``domain`` is the "Application Domain" *without leading *``https://`` and *without the trailing *``.rpxnow.com/`` 13865 + 13866 +For example: if you have registered a website like `` secure.mywebsite.org`` Janrain has turned it to the Application Domain `` https://secure-mywebsite.rpxnow.com``. Please insert only ``secure-mywebsite`` as ``domain``. The ``url`` is the external url of your login page. 13867 + 13868 +Proceed to Deplayment > Application settings > Domain Whitelist. Enter your-external-address and press "Save". Without this registration you will get an error message like "The token URL or xdReceiver has not been whitelisted" 13869 + 13870 +Proceed to Deployment > Sign-in for Web and change the ``Layout`` or select the ``Providers`` 13871 +- --
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
Some minor corrections - Line 1724 - change 'browser' to 'browse' and add 'one' from: +Line 38 creates a ``grid`` object that allows to browser, add and update the comments linked to a page. to: +Line 38 creates a ``grid`` object that allows one to browse, add and update the comments linked to a page. Line 12921 - add 'to' from: +Attention: grid and smartgrid were experimental prior web2py version 2.0 . to: +Attention: grid and smartgrid were experimental prior to web2py version 2.0 . Line 12924 - change 'browser' to 'browse' from: +These are two high level gadgets that create complex CRUD controls. They provide pagination, the ability to browser, search, sort, create, update and delete records from a single gadgets. to: +These are two high level gadgets that create complex CRUD controls. They provide pagination, the ability to browse, search, sort, create, update and delete records from a single gadgets. Dane On Sunday, 20 January 2013 23:52:02 UTC, Massimo Di Pierro wrote: > > I am looking for help proofreading the final version of the book. It is > almost done up to a final touch. > > The attached file contains the changes between the 4th edition and 5th > edition (only the new text). It would be great is some native english > speaker could be me proof-read the changes. If you can help please edit the > text in place with a text editor, without adding line breaks or extra > spaces so I can diff the corrections. > > The first two people who volunteer to help and can proof-read the attached > file by Saturday, will receive a free copy of the printed book as soon as > it is done. > > Massimo > > > --
Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.
On Saturday, January 26, 2013 12:25:41 PM UTC-5, rochacbruno wrote: > > I think both are bad! specially by the fact that the largest web2py > audience is not native English speaker, this kind of sentence should be > more explicit. > > "web2py takes care of main security issues, so developers have little..." > +1 Bruno. --
Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.
Thank you this helps. On Saturday, 26 January 2013 12:40:18 UTC-6, mweissen wrote: > > Some hours ago I have tried to use the PGP Encryption (Chapter 8.1.2) > I have found that the line "from gpgme import pgp" should be replaced > with something like "mail.settings.gpg_home = '/home/www-data/.gnupg/'". > > Maybe the following lines could help (sorry, English is not my mother > tongue): > > -It is possible to send PGP encrypted emails using the following settings: > +It is possible to send PGP encrypted emails. Install the python-pyme > package. > +Use GPG to create the key-files for the sender (take the email-address > +from mail.settings.sender) and put the files pubring.gpg and > +secring.gpg in a directory (e.g. /home/www-data/.gnupg). > +Use the following settings: > +`` > -from gpgme import pgp > +mail.settings.gpg_home = '/home/www-data/.gnupg/' > > +mail.settings.cipher_type = 'gpg' > +mail.settings.sign = True > +mail.settings.sign_passphrase = 'your passphrase' > +mail.settings.encrypt = True > +``:code > > Regards, Martin > --
Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.
Some hours ago I have tried to use the PGP Encryption (Chapter 8.1.2) I have found that the line "from gpgme import pgp" should be replaced with something like "mail.settings.gpg_home = '/home/www-data/.gnupg/'". Maybe the following lines could help (sorry, English is not my mother tongue): -It is possible to send PGP encrypted emails using the following settings: +It is possible to send PGP encrypted emails. Install the python-pyme package. +Use GPG to create the key-files for the sender (take the email-address +from mail.settings.sender) and put the files pubring.gpg and +secring.gpg in a directory (e.g. /home/www-data/.gnupg). +Use the following settings: +`` -from gpgme import pgp +mail.settings.gpg_home = '/home/www-data/.gnupg/' +mail.settings.cipher_type = 'gpg' +mail.settings.sign = True +mail.settings.sign_passphrase = 'your passphrase' +mail.settings.encrypt = True +``:code Regards, Martin --
Re: [web2py] Re: looking for volunteers to help proof-read book 5th ed.
I think both are bad! specially by the fact that the largest web2py audience is not native English speaker, this kind of sentence should be more explicit. "web2py takes care of main security issues, so developers have little..." --
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
> from: > +web2py leaves little choice to application developers in matters related to security. > to: > +web2py leaves little exposure for applications in matters related to security. Hi Rufus. IMHO I think the two sentences have different meanings. The second, in my opinion, implies in some way that there might be known security exposures that were not adressed by the software, while the first emphasizes the fact that web2py prevents a user to implement insecure features. --
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
On Sunday, January 20, 2013 6:52:02 PM UTC-5, Massimo Di Pierro wrote: > > I am looking for help proofreading the final version of the book. It is > almost done up to a final touch. > > Would have loved to help, but didn't see this until late last night (due to laptop software migrations...) Just a couple minor suggestions in the part I had time to read, mostly just a matter of personal taste and how the sentences "scanned" for me, as a native english speaker. from: If you benefit from it, we hope you will feel a little more like contributing back to society in whatever form you choose. to: If you benefit from it, we hope you will feel encouraged to ''pay it forward'' by contributing back to society in whatever form you choose. from: +web2py leaves little choice to application developers in matters related to security. to: +web2py leaves little exposure for applications in matters related to security. from: +Experimentally we support more databases. to: +We support additional databases (experimentally), and additional ones are constantly being developed. from: +Once one or more database tables are defined, web2py also generates a fully functional web-based database to: +Once one or more database tables are defined, web2py automatically generates a fully functional web-based database from: +web2py provides a ticketing system. If an error occurs, a ticket is issued to the user, to: +web2py provides a ticketing system for error events. If an error occurs, a ticket is issued to the user, from: +Another feature of web2py is that we, its developers, commit to maintain backward compatibility in future versions. to: +Another important feature of web2py is that we, its developers, commit to maintain backward compatibility in future versions. Mostly quite minor, but there it is. Keep up the excellent work, and I'm ready to buy the next copy as soon as it's available! Rufus --
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
I won't get it done before Saturday, but here's one: replace the first "http://code.google.com/p/instant-press/"; with "https://github.com/rochacbruno/Movuca"; On Tuesday, January 22, 2013 1:29:25 AM UTC+13, dhmorgan wrote: > > Signed, I hope! > > I just downloaded diff and am looking forward to the task. > --
[web2py] Re: looking for volunteers to help proof-read book 5th ed.
> > The attached file contains the changes between the 4th edition and 5th > edition (only the new text). The imap adapter has two new features that could be updated in the email section (faster queries by field and override mailbox name mapping). --
