[Checkins] SVN: grok/trunk/doc/ Setting up a bit of automation for the grok website.

Darryl Cousins darryl at darrylcousins.net.nz
Thu Mar 29 07:34:35 EDT 2007


Log message for revision 73905:
  Setting up a bit of automation for the grok website.
  
  I've added a python script (grok2html.py) that will generate the html using
  docutils and zpt from rest text files. To that end I have also added template.pt
  which I built from the html of the current site design.
  
  This script needs to be run from the /path/to/grok/doc directory like this::
  
      python grok2html tutorial tutorial.txt > /path/to/grok-www/tutorial.html
  
  If everyone agrees I would like to change about_grok.txt to about.txt so I can
  drop the first argument which is an id identifier (required for the menu) and
  deduce the id from the file name.
  
  I have also created an index.txt to generate the index.html page - I don't see
  and didn't ask if we already had the index page in rest source.
  
  I also edited the tutorial and about texts to tidy up layout a little.
  
  

Changed:
  U   grok/trunk/doc/about_grok.txt
  U   grok/trunk/doc/tutorial.txt

-=-
Modified: grok/trunk/doc/about_grok.txt
===================================================================
--- grok/trunk/doc/about_grok.txt	2007-03-29 11:34:12 UTC (rev 73904)
+++ grok/trunk/doc/about_grok.txt	2007-03-29 11:34:34 UTC (rev 73905)
@@ -1,13 +1,14 @@
+======================================
 Grok: now even cavemen can use Zope 3
 ======================================
 
-Grok: Experience, Expertise, Extensibility
-------------------------------------------
-
 Grok is a web application framework for Python developers. It is aimed
 at both beginners and very experienced web developers. Grok has an
 emphasis on agile development. Grok is easy *and* powerful.
 
+Grok: Experience, Expertise, Extensibility
+------------------------------------------
+
 You will likely have heard about many different web frameworks for
 Python as well as other languages. Why you should you consider Grok?
 

Modified: grok/trunk/doc/tutorial.txt
===================================================================
--- grok/trunk/doc/tutorial.txt	2007-03-29 11:34:12 UTC (rev 73904)
+++ grok/trunk/doc/tutorial.txt	2007-03-29 11:34:34 UTC (rev 73905)
@@ -4,6 +4,9 @@
 
 .. contents::
 
+Welcome to the Grok tutorial!
+=============================
+
 .. sidebar:: Getting started with Zope Page Templates
 
   You can find introductions and more information about Zope Page
@@ -19,11 +22,10 @@
   Zope 3 (and Grok) however; try reading ``context`` or ``view``
   instead.
 
-Welcome to the Grok tutorial! Grok is a powerful and flexible web
-application framework for Python developers. In this tutorial we will
-show you the various things you can do with Grok, and how Grok can
-help you build your web application. We'll start out simple, and will
-slowly go to more complex usage patterns.  
+Grok is a powerful and flexible web application framework for Python developers.
+In this tutorial we will show you the various things you can do with Grok, and
+how Grok can help you build your web application. We'll start out simple, and
+will slowly go to more complex usage patterns.  
 
 All you're expected to know is the Python programming language and an
 understanding of basic web programming (HTML, forms, URLs). It also



More information about the Checkins mailing list