Software Freedom Conservancy website
====================================


Contributing
------------

The canonical location for this repository is [on Conservancy’s
Kallithea instance](https://k.sfconservancy.org/website).  Copies of
this repository elsewhere, such as Github, are for backup purposes
only..


# License

The software included herein, such as the Python source files, are generally
licensed [AGPLv3](AGPLv3)-or-later.  The Javascript is a hodgepodge of
licensing, but all of it is compatible with [AGPLv3](AGPLv3)-or-later.  See
the notices at the top of each Javascript file for licensing details.

The content and text (such as the HTML files) is currently
[CC-BY-SA-3.0](CC-By-SA-3.0).


# Server configuration

Conservancy's webserver runs on a standard Debian installation. For
configuration requirements, see `deploy/ansible/install.yml`.


# Django setup

0. Make sure the Python module 'djangopw', with the global variable
   'djangoadmin_password' is somewhere importable in the default
   PYTHON_PATH.


# Local development

Python dependencies are tied to the versions available in Debian.

    python3 -m pip install -r requirements.txt
    cd www
    python manage.py runserver


# Deploying

Changes pushed to the https://k.sfconservancy.org/website repository are
automatically deployed to the production website by the `conservancy-www-update`
SystemD timer. See `systemd/conservancy-www-update.timer` for details.