@@ -1,4 +1,50 @@ -INSTALLATION +Installation +------------ +Pootle works perfectly directly from the source files without installation. + +Extract Pootle's source code, then change directory to inside the +Pootle dir + + tar xvf Pootle-......tar.gz + cd Pootle-....... + +If you want to install Pootle into your system, run + + python setup.py install + +For installation under apache, see this page: + http://translate.sourceforge.net/wiki/pootle/apache +and check the notes below about manually preparing your database. + + +Running +------- +To run Pootle from sources, just run + + ./PootleServer + +After installation with setup.py, PootleServer should also be accessible from +the installation. + +If you are more familiar with Django projects, you can look into the manage.py +commands as well. + +Use --help to see the other options. The defaults will generally work. + +Now visit http://localhost:8000/ and begin translating. + +To stop the server, press Ctrl-C. + +It is not recommended to run Pootle as the root user. + +Pootle can run under Apache using mod_python or mod_wsgi, but this requires +modifications to Apache's config files. Check + http://translate.sourceforge.net/wiki/pootle/apache +for detailed instructions + + +Manual preparation +------------------ 1. ./manage.py syncdb @@ -11,14 +57,21 @@ INSTALLATION This step fills the database with initial data needed to run Pootle. -3. ./manage.py runserver +3. ./manage.py refresh_stats + Precalculate statisstics and indexes for existing translation projects. + This step is not strictly required, but without it Pootle will feel a bit + sluggish and slow when visiting accessing a page for the first time. + +4. ./manage.py runserver You can now visit your Pootle installation at http://localhost:8000. Note that the first time will take a few moments to load, since Pootle needs to pre-compute stats data for the translation files. -COMMON PROBLEMS + +Common problems +--------------- If you get an error such as sqlite3.OperationalError: unable to open database file, then DATABASE_NAME in pootle/settings.py is pointing at an invalid directory. The default directory name is 'dbs' - ensure that this exists. INSTALL @@ -3,9 +3,9 @@ Pootle: a web translation and translation management engine * How it works * References -* Requirement/Installation -* Running -* Bug reporting +* Requirement +* Installing and running +* Bug reporting/Feature requests * Notes * Assignments @@ -62,50 +62,9 @@ to speed up searching. Note that Xapian is incompatible with Apache, and Pootle will not enable Xapian indexing if running under mod_python or mod_wsgi. -Installation ------------- -Pootle works perfectly directly from the source files without installation. - -Extract Pootle's source code, then change directory to inside the -Pootle dir - - tar xvf Pootle-......tar.gz - cd Pootle-....... - -If you want to install Pootle into your system, run - - python setup.py install - -If you want to run Pootle under apache or want to initialise the database without running the server, run - - ./manage.py syncdb - ./manage.py initdb - - -Running -------- -To run Pootle from sources, just run - - ./PootleServer - -After installation, PootleServer should also be accessible from the -installation. - -If you are more familiar with Django projects, you can look into the manage.py -commands as well. - -Use --help to see the other options. The defaults will generally work. - -Now visit http://localhost:8000/ and begin translating. - -To stop the server, press Ctrl-C. - -It is not recommended to run Pootle as the root user. - -Pootle can run under Apache using mod_python or mod_wsgi, but this requires -modifications to Apache's config files. Check - http://translate.sourceforge.net/wiki/pootle/apache -for detailed instructions +Installing and running +---------------------- +Check the INSTALL file. Bug Reporting/Feature requests README 400b31310edb69447b77e4b098dfdfc8484ecaf8 friedelwolff friedelwolff@54714841-351b-0410-a198-e36a94b762f5 http://github.com/translateorgza/pootle/commit/2bd08c9e13e76c37113f22c3f3996abdbdd94447 2bd08c9e13e76c37113f22c3f3996abdbdd94447 2009-09-04T03:41:31-07:00 2009-09-04T03:41:31-07:00 Move detail on installing and running to INSTALL. git-svn-id: https://translate.svn.sourceforge.net/svnroot/translate/src/trunk/Pootle@12281 54714841-351b-0410-a198-e36a94b762f5 ff64061cdfce093cd01e1118289722c9b19da55a friedelwolff friedelwolff@54714841-351b-0410-a198-e36a94b762f5