import from internal svn r 4007

.project

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>comt</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.python.pydev.PyDevBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.python.pydev.pythonNature</nature>
+	</natures>
+</projectDescription>

.pydevproject

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<?eclipse-pydev version="1.0"?>
+
+<pydev_project>
+<pydev_property name="org.python.pydev.PYTHON_PROJECT_VERSION">python 2.6</pydev_property>
+<pydev_property name="org.python.pydev.PYTHON_PROJECT_INTERPRETER">Default</pydev_property>
+</pydev_project>

LICENSE.txt

@@ -0,0 +1,19 @@
+co-ment: Web-based text annotation
+Copyright (C) 2006-2007 Sopinspace, Society for Public Information Spaces, www.sopinspace.com
+Developers: Renaud Bernard, Raphaël Badin
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License
+published by the Free Software Foundation either version 3 of the
+License, or (at your option) any later version, with an additional
+clause reserving the use of the trademark co-ment.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+You can reach us at dev<at>sopinspace#dot#com.

README.txt

@@ -0,0 +1,124 @@
+*******
+Comt
+*******
+
+Presentation
+============
+Comt is the open source version of co-ment, a Web-based text annotation platform.
+
+License
+=======
+GNU AFFERO GENERAL PUBLIC LICENSE
+http://www.gnu.org/licenses/agpl.html
+
+Dependencies
+============
+
+Environment
+-------------
+- Postgresql 8.3 / Mysql 5+ / sqlite
+- Python 2.5+
+- Openoffice 3.0+ & Pandoc
+
+
+Requirements
+------------
+- python (GPL compatible license)
+- python magic	(permissive BSD style license)
+- python setuptools (PSF or ZPL - GPL compatible)
+- python uno (GPL)
+- pandoc
+- headless openoffice
+(all other python dependencies will be downloaded by buildout)
+
+Installation (development install)
+============
+1. Install python2.5+ and all required python libraries
+	(ubuntu users : 'apt-get install python python-magic python-setuptools python-uno')
+2. Install pandoc
+	(ubuntu users : 'apt-get install pandoc')
+3. Install openoffice (headless mode) [used for document conversion]
+	(ubuntu users : 'apt-get install sun-java6-jre openoffice.org openoffice.org-headless xvfb)
+4. Install/configure database [skip this step if you plan to use a sqlite database]
+	4 a) Postgresql
+		- Install and configure database server [skip this step if use an external database server] 
+		(ubuntu users : 'apt-get install postgresql')		
+		- Install database client
+		(ubuntu users : 'apt-get install postgresql-client')		
+		- Install python database connector: psycopg2
+		(ubuntu users : 'apt-get install python-psycopg2')		
+	4 b) Mysql
+		-  Install and configure mysql server [skip this step if use an external database server]
+		(ubuntu users : 'apt-get install mysql-server')		
+		- Install database client
+		(ubuntu users : 'apt-get install mysql-client')
+		- Install python database connector: mysqldb
+		(ubuntu users : 'apt-get install python-mysqldb')						
+5. Create a database (we recommend UTF8 encoding) and a read/write access to it. [skip this step if you plan to use a sqlite database]
+   The database account accessing the database MUST have administrative privileges when running the 'syncdb command' (step 8)
+   (The reason for that is that Postgresql requires such privileges to create the C-based stored procedure that we use for full text indexing)
+7. Setup the project and get dependencies
+   - `python bootstrap.py`
+   - `./bin/buildout` 
+6. Configure Comt to your settings
+   - copy settings_local_sample.py to settings_local.py (this file will contain your personal settings)  
+   - edit settings_local.py to suit your settings (search for 'YOUR_SETTINGS' occurrences, those are mandatory settings)
+7. Create the database structure (and test your database connection)
+   - `./bin/django syncdb --settings=settings`
+8. Create basic right management system
+   - `./bin/django loaddata roles_generic --settings=settings`
+9. Launch development server
+   - `./bin/django manage.py runserver --settings=settings`
+10. Access your Comt instance by pointing your browser to http://127.0.0.1:8000/
+
+Installation (production environment)
+=============
+If you'd like to install Comt on a production environment, check out django installation guide at http://www.djangoproject.com/documentation/modpython/
+
+Openoffice
+==========
+Comt uses openoffice to convert documents from ODT, MS Word, etc. to html.
+On a development setup, you should make sure no openoffice process is left and launch
+`soffice -headless "-accept=socket,port=2002;urp;"` to start openoffice in background mode.
+
+Comt uses
+============
+
+Javascript libs used (and license) / shipped with the distribution
+------------------------------------------------------------------
+- Yahoo UI	http://developer.yahoo.com/yui/	BSD License
+- JQuery	http://jquery.com/	MIT
+- markItUp  http://markitup.jaysalvat.com/home/ MIT/GPL
+
+Python libraries used (and license) / NOT shipped with the distribution
+-----------------------------------------------------------------------
+- django			http://www.djangoproject.com/					BSD License
+- python magic		http://hupp.org/adam/hg/python-magic			permissive BSD style license
+- Beautiful soup	http://www.crummy.com/software/BeautifulSoup/	PSF license
+- python-chardet	http://chardet.feedparser.org/					LGPL 
+- python-feedparser	http://feedparser.org/ 							"Permissive" custom license
+- python-imaging	http://www.pythonware.com/products/pil/ 		http://www.pythonware.com/products/pil/license.htm
+- python-pytz
+- html5lib
+- python-simplejson
+- python-uno
+- python-utidylib
+- python-yaml
+
+Icons 
+-----
+- Icons derived from FatCow Icon Set http://www.fatcow.com/free-icons/index.bml (Creative Commons Attribution 3.0 License)
+
+FAQ
+====
+Q: I get 'import error' when starting the server (step #9)
+R: Make sure you installed all required python dependencies
+
+Community
+=========
+The Comt web site http://www.co-ment.org is the place to ask questions, report bugs, check out the source code or download the releases of Comt.
+
+Credits
+========
+We'd like to thank:
+- Kirill Miazine (http://km.krot.org/) for the norwegian translation

TRADEMARK_CLAUSE.txt

@@ -0,0 +1,45 @@
+================
+Trademark clause
+================
+
+Additionnal trademark clause
+============================
+
+Trademark
+---------
+co-ment(R) is a registered trademark of Philippe Aigrain.
+
+Additional trademark clause to the GNU Affero GPLv3 license for the COMT software
+---------------------------------------------------------------------------------
+As authorized by the [GNU AGPLv3](http://www.fsf.org/licensing/licenses/agpl.html "Affero GPLv3 license text") license, users of the COMT software can only make use of the co-ment trademark in compliance with the regulation of use (see below).
+
+Regulation of use for the co-ment(R) trademark
+==============================================
+
+Sopinspace
+----------
+Sopinspace is a SARL (limited liability company) with a capital of 15000 €, registered in France under the number RCS Paris B 451 436 604 with VAT number FR92 451 436 604. Sopinspace(R) is a registered trademark. Postal address: 4, passage de la Main d'Or, F-75011 Paris, France.
+
+Definitions
+-----------
+For the application of this regulation:
+
+1. *Country of operation* designate the country in which an activity (such as operating a Web service or distributing software) covered by the co-ment trademark classes is conducted.
+2. *Commercial purpose* designates any activity associated with a direct commercial transaction (for instance users or organisations paying to access a service or using a software) or an indirect commercial income (for instance advertising funded sites).
+3. *Commercial entity* designates any company (whatever its statute) as defined by the general rules of accounting and tax in the country of operation.
+4. *Non-for-profit activity* designates an activity conducted without a direct or indirect aim of profit. Any activity having a commercial purpose as defined above is excluded.
+5. *Non-for-profit organisation* any organisation recognized in the country of operation as having on of the common statutes for non-for-profit organizations.
+6. *General interest organisation* designates an organization whose main purpose is to serve the public.
+7. *Sopinspace co-ment sites* designates any website operated by Sopinspace whose domain name contains *co-ment* and any subdomain of these sites.
+
+Rules
+-----
+Use of the co-ment trademark by a commercial entity or for any commercial purpose is forbidden without written authorization of the tramemark holder.
+
+Non-for-profit organisations are welcome to make use of the co-ment trademark within source code, documentation or user interfaces for their non-for-profit activities when operating Web services or software based on the COMT platform or developing activities making use of Sopinspace's co-ment(R) Web services, provided that:
+
+* they add the customary (R) sign to mentions of the trademark, and,
+* they include at least one visible link to one of Sopinspace's co-ment sites when mentioning the trademark in documentation or user interfaces.
+
+General interest organisations may be granted the same authorization on written request to Philippe Aigrain, Sopinspace, 4 passage de la Main d'Or, F-75011 Paris France, depending of the tramemark holder's evaluation.
+

bootstrap.py

@@ -0,0 +1,84 @@
+##############################################################################
+#
+# Copyright (c) 2006 Zope Corporation and Contributors.
+# All Rights Reserved.
+#
+# This software is subject to the provisions of the Zope Public License,
+# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
+# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
+# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
+# FOR A PARTICULAR PURPOSE.
+#
+##############################################################################
+"""Bootstrap a buildout-based project
+
+Simply run this script in a directory containing a buildout.cfg.
+The script accepts buildout command-line options, so you can
+use the -c option to specify an alternate configuration file.
+
+$Id$
+"""
+
+import os, shutil, sys, tempfile, urllib2
+
+tmpeggs = tempfile.mkdtemp()
+
+is_jython = sys.platform.startswith('java')
+
+try:
+    import pkg_resources
+except ImportError:
+    ez = {}
+    exec urllib2.urlopen('http://peak.telecommunity.com/dist/ez_setup.py'
+                         ).read() in ez
+    ez['use_setuptools'](to_dir=tmpeggs, download_delay=0)
+
+    import pkg_resources
+
+if sys.platform == 'win32':
+    def quote(c):
+        if ' ' in c:
+            return '"%s"' % c # work around spawn lamosity on windows
+        else:
+            return c
+else:
+    def quote (c):
+        return c
+
+cmd = 'from setuptools.command.easy_install import main; main()'
+ws  = pkg_resources.working_set
+
+if len(sys.argv) > 2 and sys.argv[1] == '--version':
+    VERSION = '==%s' % sys.argv[2]
+    args = sys.argv[3:] + ['bootstrap']
+else:
+    VERSION = ''
+    args = sys.argv[1:] + ['bootstrap']
+
+if is_jython:
+    import subprocess
+
+    assert subprocess.Popen([sys.executable] + ['-c', quote(cmd), '-mqNxd',
+           quote(tmpeggs), 'zc.buildout' + VERSION],
+           env=dict(os.environ,
+               PYTHONPATH=
+               ws.find(pkg_resources.Requirement.parse('setuptools')).location
+               ),
+           ).wait() == 0
+
+else:
+    assert os.spawnle(
+        os.P_WAIT, sys.executable, quote (sys.executable),
+        '-c', quote (cmd), '-mqNxd', quote (tmpeggs), 'zc.buildout' + VERSION,
+        dict(os.environ,
+            PYTHONPATH=
+            ws.find(pkg_resources.Requirement.parse('setuptools')).location
+            ),
+        ) == 0
+
+ws.add_entry(tmpeggs)
+ws.require('zc.buildout' + VERSION)
+import zc.buildout.buildout
+zc.buildout.buildout.main(args)
+shutil.rmtree(tmpeggs)

buildout.cfg

@@ -0,0 +1,50 @@
+[buildout]
+parts = 
+	python
+	django
+	eggs-dependencies
+	django-extensions
+develop = .
+eggs = comt
+	${eggs-dependencies:eggs}
+
+[python]
+recipe = zc.recipe.egg
+interpreter = python
+eggs = ${buildout:eggs}
+
+[django]
+recipe = djangorecipe
+version = 1.1.1
+# trunk
+project = cm
+projectegg = cm
+wsgi = true # gen wsgi
+settings = settings
+#test = cm
+eggs = ${buildout:eggs}
+pythonpath = ${django-extensions:location}
+# is there a better way to reference comt/etc?
+
+[eggs-dependencies]
+recipe = zc.recipe.egg:eggs
+eggs = 
+	django-flash
+	django-tagging
+#	django-css	
+	chardet
+	feedparser
+	PIL
+	BeautifulSoup
+	html5lib
+	pytz
+	simplejson
+	pyyaml
+# psycopg2/mysql should be optional dependencies ... possible with buildout ???
+#	magic ???????? http://www.jsnp.net/code/magic.py ??? impossible to include this dependency
+#	utidylib ?????? http://download.berlios.de/utidylib/uTidylib-0.2.zip
+
+[django-extensions]
+recipe=zerokspot.recipe.git
+repository=git://github.com/django-extensions/django-extensions.git
+#rev=7c73978b55fcadbe2cd6f2abbefbedb5a85c2c8c