Commit 27ab040e authored by Jasper St. Pierre's avatar Jasper St. Pierre

Update README and move *.example to etc/

parent 784b74a0
...@@ -16,6 +16,8 @@ must go through code review and testing. ...@@ -16,6 +16,8 @@ must go through code review and testing.
Getting Started Getting Started
--------------- ---------------
You can get started developing the website with::
$ git clone git://github.com/magcius/sweettooth.git $ git clone git://github.com/magcius/sweettooth.git
$ cd sweettooth $ cd sweettooth
$ virtualenv_ --no-site-packages ./venv $ virtualenv_ --no-site-packages ./venv
...@@ -32,6 +34,45 @@ at /review/. ...@@ -32,6 +34,45 @@ at /review/.
.. _virtualenv: http://www.virtualenv.org/ .. _virtualenv: http://www.virtualenv.org/
.. _pip: http://www.pip-installer.org/ .. _pip: http://www.pip-installer.org/
Testing with the Shell
======================
If you have GNOME Shell, and you want to test the installation system, you're
going to have to hack your system. For security reasons, the browser plugin and
GNOME Shell both ping the URL https://extensions.gnome.org directly. The
easiest way to get around this is to make a development environment with the
proper things that it needs. Since the Django development server doesn't
natively support SSL connections, we need to install Apache. Follow the
instructions above to get a proper SweetTooth checkout, and then::
# Install Apache
$ sudo yum install httpd mod_wsgi mod_ssl
# Generate a self-signed cert
$ openssl req -new -x509 -nodes -out extensions.gnome.org.crt -keyfile extensions.gnome.org.key
# ... answer questions or just use blanks
# Install it on your system.
$ sudo cp extensions.gnome.org.crt /etc/pki/tls/certs/
$ sudo cp --preserve=mode extensions.gnome.org.key /etc/pki/tls/private/
# The shell will look for a special file called 'extensions.gnome.org.crt',
# for development purposes. Otherwise it will use your system's CA bundle.
$ mkdir -p ~/.local/share/gnome-shell
$ cp extensions.gnome.org.crt ~/.local/share/gnome-shell/
# Configure Apache.
$ cp etc/sweettooth.wsgi.example ./sweettooth.wsgi
$ $EDITOR ./sweettooth.wsgi
$ cp etc/sweettooth.httpd.conf.example ./sweettooth.httpd.conf
$ $EDITOR ./sweettooth.httpd.conf
$ sudo cp sweettooth.httpd.conf /etc/httpd/conf.d/sweettooth.conf
# Edit /etc/hosts
$ sudo tee -a /etc/hosts <<< 'extensions.gnome.org 127.0.0.1'
Requirements Requirements
------------ ------------
......
<VirtualHost 127.0.0.1:443>
ServerName extensions.gnome.org
WSGIScriptAlias / /home/jstpierre/Source/sweettooth/sweettooth.wsgi
SSLEngine on
SSLCertificateFile /etc/pki/tls/certs/extensions.gnome.org.crt
SSLCertificateKeyFile /etc/pki/tls/private/extensions.gnome.org.key
</VirtualHost>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment