**************************
* UNIX ARCHIVES OF TYPO3 *
**************************

INTRODUCTION
============

As you have downloaded this package you seem to know already about Typo3.
If you don't, visit http://typo3.org/ where you can find many useful
information.

This short guide lists the important steps to install this package.


IMPORTANT NOTE
==============

Please be aware of the fact that the file transfer protocol (FTP) does not
support Symlinks. You cannot unpack these archives locally and copy them to
your server using FTP, even if the target server actually is a Unix server.

So if you don't have shell access, try to use a terminal emulator instead.
(PHPshell to give you an example - Google knows all of them!)

If this doesn't work you'll have to stick back to the ZIP version :-(


STEP BY STEP
============

1   - Get the sources. You always need at least two files: Source and one
      of the site packages
        1) Source: Download typo3_src-3.5.0 (tar.bz2 or tar.gz)
	2) Site packages: Download one of them (either testsite, dummy,
	   quickstart or freesite)

2   - Copy them to your webserver (into the same directory - unless you
      know what you're doing...)

3   - Unpack them - Don't forget to add the 'p' switch which tells us to
      preserve the archives file attributes!!!
        a) tar.gz:
           tar xzpvf <typo3_src-x.x.x.tar.gz> <package-x.x.x.tar.gz>
	b) tar.bz2:
           tar xjpvf <typo3_src-x.x.x.tar.bz2> <package-x.x.x.tar.bz2>

4   - Set permissions: chgrp -R <wwwserver> typo3_src-3.5.0/ <second-dir>/
      (<wwwserver> is the name of the user your webserver is running as)
      This makes typo3conf/ typo3temp/ etc. writable for the webserver.

5   - If you like, you can now rename the site directory (e.g. dummy-3.5.0)
      to something that sounds a bit better (e.g. "site" or "html")

6   - Check the symlink "typo3_src" in this directory which should point to
      the source directory

7   - In your browser, hit
      http://[your.site.name]/<this_directory_name>/typo3/install/index.php

8   - Follow the instructions in the 1-2-3 install tool

9   - Now you can access the backend through
      http://[your.site.name]/<this_directories_name>/typo3/
      with the username "admin" and password "password".


That's it :-)


WHAT SHOULD YOU DO IF YOU HAVE A PROBLEM?
=========================================

TYPO3 is a powerful and complex professional application. When you start
out there will be many things you dont understand, or that don't seem to
make sense. There is a widely used mailing list (more information on
www.typo3.com & typo3.org) where many experienced users and developers
lurk... they are always willing to help, provided you followed these steps
BEFORE you ask your question:

1 - Read all available documentation carefully

2 - Read all available documentation again

3 - Search the mailing list archive carefully

4 - If you still can't figure it out - ask the list...:
      - Email-List: http://lists.netfielders.de/
      - Newsgroup:  news://news.netfielders.de/ (preferred!)

    When posting to one of the lists, see the following guidelines...
      - Be polite
         Always include the version of used TYPO3 and server environment
         (phpinfo())... note that this is available within the TYPO3
         Install Tool
      - Be as specific and clear as possible - questions like "my Typo3
         installation does not work - what can I do???" will be ignored.
	 Although English may not be your first language, if those reading
	 your posting can't understand it, you won't get the help you need
      - If you are really having a tough time getting something working,
         stay cool and don't criticise or flame. Problems are normally
         caused by lack of research into the documentation, or
         misunderstanding, not because of bugs. Be logical about your
         troubleshooting, and you'll get there

5 - If you have identified a genuine new bug, report it to bugs@typo3.com
    ...do not post to the list about it

Please be aware that if you ask questions that are answered in the
available documentation, you may not get a reply, or any help from the
developers or any experienced users!

We are aware that there is still some work to be done on the documentation,
and the platform for user support... please forgive us for not having all
these gaps filled. If you feel that some information is missing, hard to
find or just plain wrong, or you have a suggestion on improving TYPO3 or
the "support services", please let us know so that we can do what is
necessary. You could also volunteer to help with the work!

(c) Nigel Jackson, Ingmar Schlecht
    Unix related additions made by Michael Stucki

-- Michael Stucki <mundaun@gmx.ch>  Tue,  24 Jul 2003 11:23:51 +0200
