Go to file
Oskar Hahn 0cce7f967b Merge pull request #1661 from normanjaeckel/CKEditor
Added CKEditor to custom slide create and edit form.
2015-11-18 12:21:39 +01:00
docs Merge branch 'stable/1.6.x' into 'master'. 2015-01-02 22:11:56 +01:00
extras Removed bleach. 2015-10-26 20:58:22 +01:00
make Updated python requirements. 2015-07-02 14:51:08 +02:00
openslides Merge pull request #1661 from normanjaeckel/CKEditor 2015-11-18 12:21:39 +01:00
tests Merge pull request #1661 from normanjaeckel/CKEditor 2015-11-18 12:21:39 +01:00
.gitignore Added coverage and flake8 configuration to setup.cfg. Cleaned up these tools. 2015-02-25 19:39:57 +01:00
.travis.yml New Agenda Item 2015-10-29 15:44:43 +01:00
AUTHORS New OpenSlides logo. (Thanks to Rene!) 2015-04-17 20:34:54 +02:00
bower.json Added CKEditor to custom slide create and edit form. 2015-11-17 23:25:09 +01:00
CHANGELOG Added controls for projector elements 2015-10-08 19:21:25 +02:00
gulpfile.js Added CKEditor to custom slide create and edit form. 2015-11-17 23:25:09 +01:00
LICENSE Update metadata files and copyright notes. 2015-01-20 14:42:41 +01:00
manage.py Use python3 2014-08-24 21:21:11 +02:00
MANIFEST.in Melt INSTALL.txt, THANKS and README.txt to new README.rst. Change metadate for portable version. 2013-10-21 19:46:52 +02:00
package.json Added JSHint to Gulp. Split up JS-Code in users app. 2015-10-21 22:44:07 +02:00
README.rst Removed bleach. 2015-10-26 20:58:22 +01:00
requirements_production.txt New Agenda Item 2015-10-29 15:44:43 +01:00
requirements.txt Added a way to load angular apps dynamical 2015-07-01 20:10:40 +02:00
setup.cfg Remove old thinks not needed for the 2.0 release: 2015-06-16 17:07:39 +02:00
setup.py Updated setup.py and openslides module init, esp. version string. Removed git commit id grabbing during development. 2015-02-18 16:44:26 +01:00

============
 OpenSlides
============

I. What is OpenSlides?
======================

OpenSlides is a free web-based presentation and assembly system for
displaying and controlling of agenda, motions and elections of an assembly.
See http://openslides.org/ for more information.


II. Requirements
================

OpenSlides runs everywhere where Python is running (for example on
GNU/Linux, Mac or Windows (XP or newer)). On each client you need only an
actual webbrowser.


III. Installation
=================

Installation on GNU/Linux or Mac OS X
-------------------------------------

1. Check requirements

   Make sure that you have installed Python Programming Language 3 (>= 3.3)
   on your system. You will also need the Python development headers.

   For example for Ubuntu run::

       $ sudo apt-get install python3-dev

2. Setup a virtual environment with Virtual Python Environment builder
   (optional)

   You can setup a virtual environment to install OpenSlides as non-root
   user. Make sure that you have installed Virtual Python Environment
   builder on your system.

   For example for Ubuntu run::

       $ sudo apt-get install python-virtualenv

   Create your OpenSlides directory, change to it, setup and activate the
   virtual environment::

       $ mkdir OpenSlides
       $ cd OpenSlides
       $ virtualenv -p /usr/bin/python3 .virtualenv
       $ source .virtualenv/bin/activate

3. Install OpenSlides

   You can use the package from the `OpenSlides Website
   <http://openslides.org/download/>`_. Download latest OpenSlides release
   as compressed tar archive and run::

       $ pip install openslides-x.x.tar.gz

   OpenSlides will install all required python packages (see
   requirements_production.txt).


Installation on Windows
-----------------------

*Note: There is a portable version of OpenSlides for Windows which does not
required any install steps. If there is a reason that you can not use the
portable version you should observe the following install steps.*

1. Check requirements

   Make sure that you have installed Python Programming Language 3 (>= 3.3)
   and Setuptools on your system.

   a. Download and run the latest `Python 3.4 32-bit MSI installer
      <https://www.python.org/downloads/windows/>`_. Note
      that the 32-bit MSI installer is required even on a 64-bit Windows
      system. If you use the 64-bit MSI installer, step 3 of this
      instruction will fail unless you installed the package reportlab
      manually.

   b. Add python directories to PATH (via Control Panel > System >
      Advanced): ``";C:\\Python34;C:\\Python34\\Scripts"``. Note that the path
      can differ if you customized the install of Python in the first step.

   c. Download and run (via double click) the last `install script
      ez_setup.py for Setuptools
      <https://pypi.python.org/pypi/setuptools/#installation-instructions>`_.

2. Setup a virtual environment with Virtual Python Environment builder
   (optional)

   You can setup a virtual environment to install OpenSlides as non-root
   user. Make sure that you have installed Virtual Python Environment
   builder on your system.

   To install Virtual Python Environment builder, open command line (cmd)
   and run::

       > easy_install https://pypi.python.org/packages/source/v/virtualenv/virtualenv-12.0.5.tar.gz

   Create your OpenSlides directory, change to it, setup and activate the
   virtual environment::

       > md OpenSlides
       > cd OpenSlides
       > virtualenv .virtualenv
       > .virtualenv\Scripts\activate

3. Install OpenSlides

   You can use the package from the `OpenSlides Website
   <http://openslides.org/download/>`_. Download latest OpenSlides release
   as compressed tar archive and run::

       > easy_install openslides-x.x.tar.gz

   OpenSlides will install all required python packages (see
   requirements_production.txt).


IV. Start
=========

To start OpenSlides simply run on command line::

    openslides

If you run this command the first time, a new database and the admin account
(Username: `admin`) will be created. Please change the password (Password:
`admin`) after first login!

OpenSlides will start using the integrated Tornado webserver. It will also
try to open the webinterface in your default webbrowser. The server will
try to listen on the local ip address on port 80 or port 8000 if you do not
have admin permissions. That means that the server will be available to
everyone on your local network (at least for commonly used network
configurations).

If you use a virtual environment (see install instructions, step 2), do not
forget to activate the environment before restart after you have closed the
terminal.

For Unix and Mac OS X run::

    $ source .virtualenv/bin/activate

For Windows run::

    > .virtualenv\Scripts\activate

To get help on the command line options run::

    openslides --help


V. Development
==============

If you want to join us developing OpenSlides, have a look at `GitHub
<https://github.com/OpenSlides/OpenSlides/>`_ or write an email to our
`mailing list <http://openslides.org/contact/>`_.


Installation and start of the development version
-------------------------------------------------

1. Check requirements

   You need to have `Python 3 (>=3.3) <https://www.python.org/>`_, `Node.js
   (>=0.10) <https://nodejs.org/>`_ and `Git <http://git-scm.com/>`_
   installed. See also step 1 in the correspondent instruction in section
   III.

2. Get OpenSlides source code

   Clone current master version from `OpenSlides' GitHub repository
   <https://github.com/OpenSlides/OpenSlides/>`_::

       cd ...  # Go to a nice place in your filesystem.
       git clone https://github.com/OpenSlides/OpenSlides.git
       cd OpenSlides

3. Setup and activate a virtual environment with Virtual Python Environment
   builder (optional)

   Follow step 2 in the correspondent instruction in section III.

4. Install all required Python packages::

       $ pip install -r requirements.txt

5. Install all npm and bower packages

   For Unix and Mac OS X run::

       $ npm install
       $ node_modules/.bin/bower install

   For Windows run::

       > npm install
       > node_modules\.bin\bower install

6. Concat and copy all third party JavaScript and Cascading Style Sheets
   libraries

   For Unix and Mac OS X run::

       $ node_modules/.bin/gulp

   For Windows run::

       > node_modules\.bin\gulp

7. Start OpenSlides

   Use the command-line interface::

       python manage.py start

   This will create a new development directoy with settings.py and database.

   To get help on the command-line options run::

       python manage.py --help


Coding Style
------------

You can find some information on the coding style in the `OpenSlides wiki
<https://github.com/OpenSlides/OpenSlides/wiki/De%3ACode-Richtlinien-f%C3%BCr-Openslides>`_.


VI. Used software
=================

OpenSlides uses the following projects or parts of them:

* `backports.ssl_match_hostname <https://bitbucket.org/brandon/backports.ssl_match_hostname>`_,
  License: Python Software Foundation License

* `Beautiful Soup <http://www.crummy.com/software/BeautifulSoup/>`_,
  License: MIT

* `Bootstrap <http://getbootstrap.com/2.3.2/>`_, License: Apache
  License v2.0

* `Django <https://www.djangoproject.com>`_, License: BSD

* `Django CKEditor <https://github.com/riklaunim/django-ckeditor>`_, License: BSD

* `Django haystack <http://haystacksearch.org>`_, License: BSD

* `pdf.js <http://mozilla.github.io/pdf.js/>`_, License: Apache License v2.0

* `ReportLab <http://www.reportlab.com/software/opensource/rl-toolkit/>`_,
  License: BSD

* `roman <https://pypi.python.org/pypi/roman>`_, License: Python 2.1.1

* `setuptools <https://pypi.python.org/pypi/setuptools>`_,
  License: Python Software Foundation License

* `sockjs-tornado <https://github.com/mrjoes/sockjs-tornado>`_,
  License: MIT

* `Sphinx <http://sphinx-doc.org/>`_, License: BSD

* Sphinx extension `autoimage <https://gist.github.com/kroger/3856821/>`_,
  License: MIT

* `Sphinx Bootstrap Theme
  <http://ryan-roemer.github.io/sphinx-bootstrap-theme/>`_, License: MIT

* `Tornado <http://www.tornadoweb.org/en/stable/>`_, License: Apache
  License v2.0

* `Ubuntu TrueType Font <http://font.ubuntu.com>`_, License: Ubuntu Font
  Licence 1.0

* `Whoosh <https://bitbucket.org/mchaput/whoosh/wiki/Home/>`_, License: BSD

* Several JavaScript packages (see bower.json)


VII. License and authors
========================

OpenSlides is Free/Libre Open Source Software (FLOSS), and distributed under
the MIT License, see LICENSE file. The authors of OpenSlides are mentioned
in the AUTHORS file.