/StarbowWebSite

The app behind starbowmod.com

Primary LanguagePythonMIT LicenseMIT

StarbowWebSite

The app behind starbow.com

Installation

Python 2 required. For Windows installation, it is recommended that you use the 32 bit Python build.

Copy starbowmodweb/example.config.py to starbowmodweb/config.py and follow configuration instructions inside:

cp starbowmodweb/example.config.py starbowmodweb/config.py

Run::

pip install -r requirements.txt
mysql -u root -p -e "create database starbow_website;"
python manage.py syncdb
python manage.py runserver

If you are not going to install the forum locally, you still need to create a database for it and load forum.sql into it:

mysql -u root -p -e "create database starbow_forum;"
mysql -u root -p starbow_forum < forum_schema.sql

Make sure to set MYBB_BRIDGE_PATH = False.

SASS

Our CSS code is compiled using SASS, Syntactically Awesome Style Sheets. To compile the SASS code into CSS, you must first install the SASS compiler.

First, install ruby if you do not have it installed.

To install sass, just run:

gem install sass

The best way to work with SASS is to have it watch the *.scss files for changes and compile new CSS as the SCSS code is changed. To begin doing so, navigate to the scss directory (starbowmodweb/site/static/site/css/scss), and run the following:

sass --watch app.scss:../app.css --style compressed

This will automatically compile app.css any time you change any *.scss file in that directory.

Deploying

Before deploying you need to copy all static files to the static directory using:

python manage.py collectstatic

Using Apache2

Alias /forum/ /path/to/forum/root/
Alias /wiki/ /path/to/wiki/root/
Alias /media/ /path/to/media/directory/
Alias /static/ /path/to/static/directory/

<Directory /path/to/media/directory/>
Order deny,allow
Require all granted
</Directory>

<Directory /path/to/static/directory/>
Order deny,allow
Require all granted
</Directory>

WSGIScriptAlias / /path/to/StarbowWebSite/starbowmodweb/apache/wsgi.py
WSGIPythonPath /path/to/StarbowWebSite/

<Directory /path/to/StarbowWebSite/starbowmodweb/apache>
<Files wsgi.py>
Order deny,allow
Require all granted
</Files>
</Directory>