Systers Portal for communities
Python HTML CSS
Latest commit 42a9d5e Oct 4, 2016 @ana-balica ana-balica committed on GitHub Merge pull request #184 from payal97/develop
Added sponsors to meetup location
Permalink
Failed to load latest commit information.
docs Remove notes about SECRET_KEY travis-ci from docs Mar 6, 2016
requirements removed django-countries Feb 7, 2016
systers_portal Added sponsors to meetup location Aug 19, 2016
.coveragerc change the settings for coverage Nov 9, 2014
.editorconfig
.gitignore ignore staticfiles after running collectstatic Apr 20, 2015
.travis.yml Remove secure env var from travis.yml Mar 6, 2016
Dockerfile portal very simplistic Dockerfile Feb 15, 2015
LICENSE Create LICENSE Nov 24, 2014
README.md Merge branch 'develop' of github.com:systers/portal into develop Apr 23, 2016
docker-compose.yml
setup.cfg change max line length to 100 chars Jun 12, 2015

README.md

Systers Portal Build Status Coverage Status

Systers Portal is for Systers communities to post and share information within and with other communities.

Website: http://portal.systers.org

Project page: http://systers.github.io/portal/

Setup for developers

  1. Make sure you have installed Python 3.4 (preferably latest minor release), pip and virtualenv.
  2. If working behind a proxy, make sure your environment variables are properly set up. If you still get an error due to proxy, use "-E" flag along with "sudo" to export all the environment variables.
  3. Make sure you have PostgreSQL installed. For a tutorial on installing Postgres, Django Girls' ebook, Tutorials Extension, is a reference. The info is also on Django Girls GitHub repository.
  4. Make sure you have python3-dev installed - sudo pip install python3-dev
  5. Clone the repo - git clone git@github.com:systers/portal.git and cd into the portal directory. If working behind a proxy, follow the instructions here.
  6. Create a virtual environment with Python 3 and install dependencies:

    $ virtualenv venv --python=/path/to/python3
    $ source venv/bin/activate
    $ pip install -r requirements/dev.txt
  7. Create systersdb database, where systersdb might be any suitable name.
  8. Fill in the database details in systers_portal/settings/dev.py.
  9. Run export SECRET_KEY=foobarbaz in your terminal, ideally the secret key should be 40 characters long, unique and unpredictable. Optionally to set the shell variable every time you activate the virtualenv, edit venv/bin/activate and add to the bottom the export statement.
  10. Run python systers_portal/manage.py migrate.
  11. Run python systers_portal/manage.py createsuperuser to create a superuser for the admin panel. Fill in the details asked.
  12. Run python systers_portal/manage.py runserver to start the development server. When in testing or production, feed the respective settings file from the command line, e.g. for testing python systers_portal/manage.py runserver --settings=systers_portal.settings.testing.
  13. Before commiting run flake8 systers_portal and fix PEP8 warnings.
  14. Run python systers_portal/manage.py test --settings=systers_portal.settings.testing to run all the tests.

Run Portal in a Docker container

If you wish to view a speak peek of the Systers Portal, you may use Docker to preview the Portal. Note: The following Docker configuration is not intended to be run in production at the moment. It may be configured to do so in the future.

  1. Install Docker. Follow the installation steps for your specific operating system:
    • Docker runs natively on a Linux-based system.
    • For Windows and Mac OS X, you should follow instructions for installing boot2docker which also installs VirtualBox.
  2. Install docker-compose. Note: fig has been deprecated. Docker-compose replaces fig.
  3. Create a new directory on your local system.
  4. Enter git clone git@github.com:systers/portal.git to clone the Systers Portal repository. After the clone is done, change directory (cd) to the portal directory.
  5. Run docker-compose build. This pulls the Docker images required to run the project and installs the necessary dependencies.
  6. This step will require the Django SECRET_KEY. Run docker run -e SECRET_KEY=foobarbaz portal_web.
  7. Run docker-compose run web python systers_portal/manage.py migrate.
  8. Optional: Run docker-compose run web python systers_portal/manage.py createsuperuser if you wish to create a superuser to access the admin panel.
  9. Run docker-compose up to start the webserver for the Django Systers Portal project.
  10. Systers Portal should be running on port 8000.
    • If you are on Linux, enter http://0.0.0.0:8000 in your browser.
    • If you are using boot2docker on Windows or Mac OS X, enter http://192.168.59.103:8000/ in your browser. If this IP address doesn't work, run boot2docker ip from the command line and replace the previous IP address in the HTTP request with the IP returned by boot2docker.

Documentation

Documentation for Systers Portal is generated using Sphinx and available online at http://systers-portal.readthedocs.org/

To build the documentation locally run:

$ cd docs/
$ make html

To view the documentation open the generated index.html file in browser - docs/_build/html/index.html.

For more information on semantics and builds, please refer to the Sphinx official documentation.

You can view the requirements document here.