Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP

Loading…

add trac installation step to README #46

Closed
wants to merge 1 commit into from

2 participants

@dlo
dlo commented

Should close #28

@timgraham
Owner

How do you serve the trac site locally? (i.e. runserver won't interact with it as far as I know). Not sure there's a use in including these instructions without that?

@dlo

It's been a while since I submitted this PR, and from my comment it seems this should've helped close issue #28.

Unfortunately I can't view the issues (looks like they've been closed), so it's tough for me to say. I'm pretty certain I wouldn't have included this step if it wasn't necessary. Any way we can revive that issue so we can see what the original issue was?

@timgraham
Owner

I tried restoring github issues, but it didn't restore the old issues. I'm going to close this PR for now, but will keep it in mind in case the need for this documentation arises in the future.

@timgraham timgraham closed this
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Commits on Feb 4, 2013
  1. @dlo
This page is out of date. Refresh to see the latest.
Showing with 20 additions and 10 deletions.
  1. +20 −10 README.txt
View
30 README.txt
@@ -1,6 +1,9 @@
To run locally, do the usual::
-1. Create a virtualenv
+1. Create a virtualenv::
+
+ virtualenv .
+
2. Install dependencies::
pip install -r deploy-requirements.txt
@@ -8,26 +11,33 @@ To run locally, do the usual::
If you only need to deploy, and don't need to test any changes,
you can use local-requirements.txt
-3. Set up databases, as per django_website/settings/www.py
+3. Set up your databases, as per django_website/settings/www.py
+
+4. Install Trac::
+
+ pip install trac==0.12
+ trac-admin $DIRECTORY_OF_CHOICE initenv
+
+ Enter in the appropriate info. If you're running PostgreSQL locally, a valid
+ connection string would be `postgres://code.djangoproject@localhost/code.djangoproject`.
-4. Create a 'secrets.json' file in the directoy above the checkout, containing
+5. Create a 'secrets.json' file in the directoy above the checkout, containing
something like::
{ "secret_key": "xyz",
"superfeedr_creds": ["any@email.com", "some_string"] }
-5. Set up DB::
+6. Sync and migrate your databases::
- ./manage.py syncdb
- ./manage.py migrate
+ ./manage.py syncdb --migrate
and::
./manage.py syncdb --docs
- if you want to run docs site.
+ if you would like to run the docs site.
-6. For docs::
+7. To install documentatin::
./manage.py loaddata doc_releases.json --docs
./manage.py update_docs --docs
@@ -35,9 +45,9 @@ To run locally, do the usual::
Finally::
- python manage.py runserver
+ ./manage.py runserver
This runs as ``www.djangoproject.com``. To run locally as
``docs.djangoproject.com``, use::
- python manage.py runserver --settings=django_website.settings.docs
+ ./manage.py runserver --settings=django_website.settings.docs
Something went wrong with that request. Please try again.