Skip to content

Commit

Permalink
Added more instructions to the README.
Browse files Browse the repository at this point in the history
  • Loading branch information
bmispelon committed Apr 25, 2015
1 parent 5266fb8 commit 65b9601
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 15 deletions.
15 changes: 0 additions & 15 deletions README

This file was deleted.

34 changes: 34 additions & 0 deletions README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
Configuration for Django's Trac instance (code.djangoproject.com)
=================================================================

Local install
-------------

Getting a local Trac install running is a bit tricky. Here are a few tricks
that can help:

* Install the requirements in the same virtualenv as djangoproject.com.
* Follow the installation instructions in djangoproject/README.rst (especially
the database creation).
* Use ``psql -U code.djangoproject -d code.djangoproject -c "INSERT INTO permission (username, action) VALUES ('anonymous', 'TRAC_ADMIN')"``
to give all permissions to the anonymous user.
* Use the command ``tracd --port 9000 -s trac-env`` to serve Trac locally.
* If you've modified the ``trackhack.scss`` file, use
``sassc trac-env/htdocs/css/trachacks.scss trac-env/htdocs/css/trachacks.css -s compressed``
to compile it to CSS.

How to port the CSS from djangoproject.com
------------------------------------------

Assumes that `code.djangoproject.com` and `djangoproject.com` are stored in the
same directory (adjust paths if needed).

# Copy the generated CSS:
cp ../djangoproject.com/static/css/*.css trac-env/htdocs/css/
# Copy _utils.scss (needed by trackahacks.scss):
cp ../djangoproject.com/static/scss/_utils.scss trac-env/htdocs/css/
# Copy the javascript directory:
cp -rT ../djangoproject.com/static/js trac-env/htdocs/js
# Compile trackhacs.scss:
compass compile --sass-dir trac-env/htdocs/css/ --css-dir trac-env/htdocs/css/ -e development --sourcemap --force

0 comments on commit 65b9601

Please sign in to comment.