[Checkins] SVN: zdgbook/trunk/ Convert Introduction from stx to rst
Baiju M
baiju.m.mail at gmail.com
Tue Feb 17 04:16:37 EST 2009
Log message for revision 96627:
Convert Introduction from stx to rst
Changed:
D zdgbook/trunk/Introduction.stx
A zdgbook/trunk/source/Introduction.rst
U zdgbook/trunk/source/index.rst
-=-
Deleted: zdgbook/trunk/Introduction.stx
===================================================================
--- zdgbook/trunk/Introduction.stx 2009-02-17 09:12:20 UTC (rev 96626)
+++ zdgbook/trunk/Introduction.stx 2009-02-17 09:16:37 UTC (rev 96627)
@@ -1,244 +0,0 @@
-Introduction
-
- Zope is an open source web application framework. It has three
- distinct audiences:
-
- % chrism - Dec. 10, 2001 11:02 am - Note that folks are encouraged to make
- comments using the comment system. Thanks!
-
- *Site Managers* -- individuals who use of Zope's "out of the box" features
- to build websites. This audience is interested in making use
- of Zope's existing array of features to create content
- management solutions. They will likely make heavy use of
- "through the web" scripting using DTML, Page Templates, and
- Python Scripts as well as (of course) HTML and XML. They are
- generally less concerned about code reuse than the speed with
- which they can create a custom application or website.
-
- *Developers* -- individuals who wish to extend Zope to create
- highly customized solutions. This audience is likely interested
- in creating highly reusable custom code that makes Zope do something
- new and interesting.
-
- *Administrators* -- individuals responsible for keeping a Zope
- site running and performing installations and upgrades.
-
- % Anonymous User - Sep. 10, 2002 8:09 pm:
- I really like the idea of a downloadable PDF. However the header on every
- page is "Introduction" (same in the Zope Book). This doesn't give you much
- clue which chapter you are on and can be confusing.
- I know that HTMLDOC supports putting the chapter name in the header. Can
- you do this instead?
-
- % Anonymous User - Jan. 10, 2003 4:05 am:
- This system is amazing. I like Python a lot!
-
- % Anonymous User - Feb. 24, 2003 7:02 pm:
- About the "Comment" images.
- They have a thin black border around them (which is probably not what you
- want) but not in Mozilla or the other popular browser.
- If you change 'border="off"' to 'border="0"' in the HTML then the border
- disappears.
- The border, though deprecated, is supposed to be an integer.
- I know that this is a very picky point but it is not a really good
- introduction to Zope.
-
- % Anonymous User - Apr. 9, 2003 9:51 am:
- Is it possible to mention somewhere in the menu of this page that this
- beautifull functionnality that allow the user to include comments directly
- on this page to maintain and enrich the contents is achieved with a Zope
- product called "BackTalk" (with a link to the corresponding page). Perhaps
- it is written somewhere but I've not been able to find it.
-
- % Anonymous User - Apr. 9, 2003 2:19 pm:
- See http://backtalk.sourceforge.net for the latest version...
-
- % Anonymous User - May 4, 2003 5:37 pm:
- I like commentable sites and even tried to design one once. But the comments
- here are too distracting, too large and generally annoying.
- They should either be restricted to areas that are fuzzy and uncertain or
- they should be really small and unnoticable.
-
- % Anonymous User - Sep. 23, 2003 8:04 am:
- To add a comment please go to the top of any page and ascertain by clicking
- on the COM button whether is is ON or OFF. Make sure it is OFF (Figure that
- one out!).
- Go to the first available comment and then scroll to the far right. You will
- find a small button in the lower right corner which, when clicked, adds a
- "Comment" window at the bottom of the page.
- Add your comment.
-
- % Anonymous User - Nov. 8, 2003 2:39 pm:
- Lots of the comments are impossible to read on a small (laptop) screen, they
- extend beyond the browser border and there are no scroll bar below.
- (of course you can copy/paste it, but that's not really a solution ;))
- This i is actually a general problem with the zope site. The text width is
- fixed, it doesnt wrap around.
-
- % Anonymous User - Mar. 24, 2004 10:03 am:
- ... and folks should be encouraged to read them and take note and clear them down because otherwise they clog
- the place up. There are more comments here than original text.
-
- This guide is intended to document Zope for the second audience,
- developers, as defined above. If you fit more into the "user"
- audience defined above, you'll probably want to start by reading
- "The Zope Book":http://www.zope.org/Members/michel/ZB/ . If
- you fit more into the "administrator" audience defined above,
- you'll likely be interested in "The Zope Administrator's
- Guide":http://www.zope.org/DocProjects/AdminGuide, although it
- is currently unfinished.
-
- % Anonymous User - Oct. 23, 2003 10:19 pm:
- Then why don't you come up with the examples and contribute them?
-
- % Anonymous User - Oct. 26, 2003 2:54 am:
- Is there a cross reference system for all this literature somewhere? A system
- in which I look up say "tal:content" and find links to appropriate places in
- The Zope Book, How-tos, ZDG, etc.?
- Tom Snell
-
- % Anonymous User - Nov. 29, 2003 6:40 pm:
- Great. So in order to create a web page with this, we now need YET another programming language on a system,
- and need to learn YET ANOTHER scripting language.
- Why isn't Python used in more places than - say - Perl, PHP, Java, C, or C++? In short, Python Blows Monkey
- Chunks. I don't want to use a lisp-like language with some Perl and C functionality thrown every now and then
- in what they perceive as "objects".
- Python, Perl, and other scripting languages should be thrown back into the dark abysmal holes from which
- their prototyped shells came from. Who in their right mind is going to use a Python-based web -APPLICATION-
- server on their box? And pay for it?
- The only reason people are using this is because no one is paying for it. And if they DID have to pay for it,
- they wouldn't buy it. Web application developers are mainly looking for ways to get to market quickly, and
- looking for a larger ROI. Now, we're forced to learn another language, another convoluted, mish-mashed way of
- putting something together, and hoping and praying to God that our code works, and works every time. EVERY
- time.
- Products like these are only free if your time has no value. This goes for ANY Open Source software in
- general. There's no throat to choke when something breaks. You hope and pray that someone will fix the
- problem - or at least post a work-around - when you encounter one. I wish all of you luck in your pursuits
- with Zope.
-
- % Anonymous User - Dec. 18, 2003 1:05 pm:
- I'm not 100% sharing your point of view, but you've got a point : using Zope means learning 2 news languages
- for Zope-newbie : python and dtml.
- Why not using something more common - more user friendly? Python looks like COBOL.
-
- % Anonymous User - Dec. 18, 2003 8:52 pm:
- Sigh. Python looks as much like COBOL as you look like you know what you're talking about.
-
- % Anonymous User - Mar. 5, 2004 1:40 pm:
- Useless comments just clog up space. I like reading these comments, but only if they are useful. Criticizing
- Zope, Python, and Open-Source in general is not useful. If you don't like it, don't read it.
-
- % Anonymous User - Mar. 5, 2004 1:59 pm:
- Folks, the only proper response to a troll is *THWACK*!
-
- % Anonymous User - June 29, 2005 11:59 pm:
- "Comment" feature is too much flexibillty... to allow user to comment and clog up the webspace.. and distract
- users from the actual text.. Even this comment .. oops
-
- Throughout this guide, it is assumed that you know how to program
- in the "Python":http://www.python.org/ programming language. Most
- of the examples in this guide will be in Python. There are a number
- of great resources and books for learning Python; the best online
- resource is the "Python.org web site":http://www.python.org/ and
- many books can be found on the shelves of your local bookstore.
-
- % Anonymous User - Dec. 16, 2003 12:37 pm:
- Test Comment
-
- % Anonymous User - Apr. 12, 2004 1:19 am:
- This comment thing is rather distracting and leaves things open for abuse.
-
- % Anonymous User - May 26, 2004 7:33 am:
- I agree completely. The comments don't belong here. At least they should be appended to the very bottom of
- the page like they do in MySQL user guide.
-
- % Anonymous User - July 17, 2004 11:44 am:
- There's a button at the top and bottom of each page to turn comments on and off.
- Those of you who don't like the comments might consider clicking on it.
-
- % Anonymous User - July 17, 2004 11:49 am:
- There's a button at the top and bottom of each page to turn comments on and off.
- Those of you who don't like the comments might consider clicking on it.
-
- % Anonymous User - July 17, 2004 11:53 am:
- There's a button at the top and bottom of each page to turn comments on and off.
- Those of you who don't like the comments might consider clicking on it.
-
- % Anonymous User - Aug. 19, 2004 12:20 am:
- Python is gaining popularity.
-
- % Anonymous User - Nov. 18, 2004 5:19 am:
- testing
-
- % iacaqa - Nov. 18, 2004 2:19 pm:
- <a href='http://www.hongjuda.com' target='_blank' title='å京ç½ç«å»ºè®¾'>å京ç½ç«å»ºè®¾</a>
- <a href="http://www.hongjuda.com" title="å京ç½ç«å»ºè®¾">å京ç½ç«å»ºè®¾</a>
- <a href="http://www.hongjuda.com" target="_blank">å京ç½ç«å»ºè®¾</a>
- <a href="http://www.hongjuda.com">å京ç½ç«å»ºè®¾</a>
-
- % Anonymous User - Aug. 21, 2005 2:51 am:
- http://www.paper-translation.com
-
- % Anonymous User - Aug. 21, 2005 2:56 am:
- http://www.paper-translation.com
-
- % Anonymous User - Aug. 21, 2005 2:59 am:
- http://www.paper-translation.com
-
- This book describes Zope's services to the developer from a
- hands on, example-oriented standpoint. This book is not a complete
- reference to the Zope API, but rather a practical guide to applying
- Zope's services to develop and deploy your own web applications.
- This book covers the following topics:
-
- *Components and Interfaces* -- Zope is moving toward a
- component-centric development model. This chapter describes the
- new component model in Zope and how Zope components are described
- through interfaces.
-
- *Object Publishing* -- Developing applications for Zope involves
- more than just creating a component, that component must be
- *publishable* on the web. This chapter describes publication, and
- how your components need to be designed to be published.
-
- *Zope Products* -- New Zope components are distributed and installed
- in packages called "Products". This chapter explains Products in
- detail.
-
- *Persistent Components* -- Zope provides a built-in, transparent
- Python object database called ZODB. This chapter describes how to
- create persistent components, and how they work in conjunction
- with the ZODB.
-
- *Acquisition* -- Zope relies heavily on a dynamic technique called
- acquisition. This chapter explores acquisition thoroughly.
-
- *Security* -- When your component is used by many different people
- through the web, security becomes a big concern. This chapter
- describes Zope's security API and how you can use it to make
- security assertions about your object.
-
- *Debugging and Testing* -- Zope has built in debugging and testing
- support. This chapter describes these facilities and how you can
- debug and test your components.
-
- % Anonymous User - Apr. 28, 2002 11:22 pm:
- Are ZClasses to be deprecated as a development tool?
- It seems to be no longer included as a development option.
-
- % mcdonc - May 30, 2002 11:06 am:
- ZClasses are documented in the Zope Book.
-
- % Anonymous User - Dec. 18, 2003 1:06 pm:
- Do we have to BUY a book in order to have help on a FREE application?
-
- % Anonymous User - Dec. 18, 2003 8:51 pm:
- #1, even if you did that shouldn't surprise or offend you, but #2, no it's available online at http://www.zope.org/Documentation/Books/ZopeBook
- (or if you just look in the left hand list of links, it's the one under Documentation that says "The Zope
- Book"). Gotta love indignance.
-
- % Anonymous User - Dec. 15, 2004 12:40 pm:
- asdf
-
- % Anonymous User - Sep. 22, 2005 3:57 am:
- uyiuuub jnb kmdfs dfs dfkmgg gsdfpoew efr ef ss s a adasdasd
Copied: zdgbook/trunk/source/Introduction.rst (from rev 96617, zdgbook/trunk/Introduction.stx)
===================================================================
--- zdgbook/trunk/source/Introduction.rst (rev 0)
+++ zdgbook/trunk/source/Introduction.rst 2009-02-17 09:16:37 UTC (rev 96627)
@@ -0,0 +1,85 @@
+############
+Introduction
+############
+
+Zope is an open source web application framework. It has three
+distinct audiences:
+
+
+*Site Managers*
+ individuals who use of Zope's "out of the box" features to build
+ websites. This audience is interested in making use of Zope's
+ existing array of features to create content management solutions.
+ They will likely make heavy use of "through the web" scripting
+ using DTML, Page Templates, and Python Scripts as well as (of
+ course) HTML and XML. They are generally less concerned about code
+ reuse than the speed with which they can create a custom
+ application or website.
+
+*Developers*
+ individuals who wish to extend Zope to create highly customized
+ solutions. This audience is likely interested in creating highly
+ reusable custom code that makes Zope do something new and
+ interesting.
+
+*Administrators*
+ individuals responsible for keeping a Zope site running and
+ performing installations and upgrades.
+
+ This guide is intended to document Zope for the second audience,
+ developers, as defined above. If you fit more into the "user"
+ audience defined above, you'll probably want to start by reading
+ `The Zope Book <http://www.zope.org/Members/michel/ZB/>`_ . If you
+ fit more into the "administrator" audience defined above, you'll
+ likely be interested in `The Zope Administrator's Guide
+ <http://www.zope.org/DocProjects/AdminGuide>`_, although it is
+ currently unfinished.
+
+
+Throughout this guide, it is assumed that you know how to program in
+the `Python <http://www.python.org/>`_ programming language. Most of
+the examples in this guide will be in Python. There are a number of
+great resources and books for learning Python; the best online
+resource is the `python.org web site <http://www.python.org/>`_ and
+many books can be found on the shelves of your local bookstore.
+
+This book describes Zope's services to the developer from a hands on,
+example-oriented standpoint. This book is not a complete reference
+to the Zope API, but rather a practical guide to applying Zope's
+services to develop and deploy your own web applications. This book
+covers the following topics:
+
+*Components and Interfaces*
+ Zope is moving toward a component-centric development model. This
+ chapter describes the new component model in Zope and how Zope
+ components are described through interfaces.
+
+*Object Publishing*
+ Developing applications for Zope involves more than just creating a
+ component, that component must be *publishable* on the web. This
+ chapter describes publication, and how your components need to be
+ designed to be published.
+
+*Zope Products*
+ New Zope components are distributed and installed in packages
+ called "Products". This chapter explains Products in detail.
+
+*Persistent Components*
+ Zope provides a built-in, transparent Python object database called
+ ZODB. This chapter describes how to create persistent components,
+ and how they work in conjunction with the ZODB.
+
+*Acquisition*
+ Zope relies heavily on a dynamic technique called acquisition. This
+ chapter explores acquisition thoroughly.
+
+*Security*
+ When your component is used by many different people through the
+ web, security becomes a big concern. This chapter describes Zope's
+ security API and how you can use it to make security assertions
+ about your object.
+
+*Debugging and Testing*
+ Zope has built in debugging and testing support. This chapter
+ describes these facilities and how you can debug and test your
+ components.
Property changes on: zdgbook/trunk/source/Introduction.rst
___________________________________________________________________
Added: svn:mergeinfo
+
Modified: zdgbook/trunk/source/index.rst
===================================================================
--- zdgbook/trunk/source/index.rst 2009-02-17 09:12:20 UTC (rev 96626)
+++ zdgbook/trunk/source/index.rst 2009-02-17 09:16:37 UTC (rev 96627)
@@ -11,6 +11,7 @@
:maxdepth: 2
Outline.rst
+ Introduction.rst
AppendixA.rst
AppendixB.rst
More information about the Checkins
mailing list