Install ngep howto

These instructions are written for debian/ubuntu but it should be easy to adapt
them for a distribution of your choice.

$ denotes regular user
# denotes root

Before entering these commands be sure to know what they do. Read man pages:

$ man <command>

    # apt-get install build-essential python2.4-dev python-imaging python-setuptools subversion

2. step: The "who wants to know more" step, feel free to skip it (Prepare working          directory)

    In this step you will prepare a working directory manually. Again, this is
    optional as you will download it from the subversion later.

    If you don't use debian/ubuntu do:
   

    # easy_install-2.4 ZopeSkel

   
    For debian/ubuntu users it is recommended to install every software via
    packages so you can easily delete it later. I prepared a package for
    you: http://...python-zopeskel_1.3.1-1_i386.deb
   

    # dpkg -i /path/to/python-zopeskel_1.3.1-1_i386.deb 

    # apt-get install python-pastescript

    $ paster create -t plone3_buildout ~/ngep

        (Tip: last argument here is a directory where your buildout will
            live. Set it to whatever you like)
   
    You'll need to answer some questions now. This will be used to generate
    buildout.cfg.
   

        zope2_install: <leave blank>

        plone_products_install: <leave blank>

        zope_user: <whatever you want, but remember it>

        zope_password: <as above>

        http_port: <as above>

        debug_mode: <on>

        verbose_security: <on>

       
    You can later change this in buildout.cfg
       
3. step: Checkout the current ngep buildout from subversion repository
   

    $ svn co https://svn.plone.si/eestec/buildout/trunk ~/ngep

        (Tip: last argument here is a directory where your buildout will
             live. Set it to whatever you like)
   
    Accept the certificate
    Username: eestec
    Password: eestec

    This will download everything you need to start working on ngep.   
    Explore buildout.cfg with you text editor. Adjust it (change port,
    username,...) if you want.
    // TODO: using zope from debian/ubuntu package, # apt-get install zope2.10
   
4. step: Bootstrap the buildout   

    $ cd ~/ngep; python2.4 bootstrap.py

5. step: Download and prepare all needed scripts

    $ bin/buildout -v 

    Go grab something to eat/drink as this will take some time.
        (Tip: do a $ ./bin/buildout -h to see all other options)
       
6. step: Run ngep instance

    $ bin/instance fg

        (Tip: do a $ bin/instance -h to see all other options)
    Wait for line: "Zope ready to handle requests"

7. step: Setup ngep website (no more console)
   
    Point your browser to: http://localhost:1986/manage
    Enter password when prompted
    Add a "plone site", enter id and title, select extension profiles
        // TODO: which profiles are needed
        and click "add plone site"
    Go to "site setup", change theme, install the following products:
        // TODO: which products are needed?

8. step: Adding news, events

    Go to /portal_vocabularies folder, add simple vocabulary with name
    "news_type". Then, inside add simple vocabulary term with value ...

    Repeat this with but now add simple vocabulary with name "event_type"
    and add simple vocabulary term with value...

    Now you can add news and events of types of "vocabulary terms" you
    just added. // TODO: write more about vocabularies