# I2P website To run locally (for testing purposes): - Install proxychains, configure it for Tor - Pull in the dependencies: ``` $ proxychains ./setup_venv.sh ``` (you can also pull them non-anon by leaving out proxychains) - Compile translations (if you want to see them): ``` $ ./compile-messages.sh ``` - Start the webserver: ``` $ ./runserver.py ``` - Open the site at http://localhost:5000/ ## Running a mirror If you want to mirror the I2P website, thanks! Here is a checklist: - Do not edit any of the files in `i2p2www/` - In particular, do not change the `CANONICAL_DOMAIN` variable in `i2p2www/__init__.py`, it needs to point to the official site for SEO. - If you need to edit variables in `etc/update.vars`, copy the file to `etc/update.vars.custom` and edit appropriately. The only variable you may need to edit is `MTNURL` in `etc/update.vars` (if your Monotone client tunnel is listening on a different port). - If you want to enable caching, copy `i2p2www/settings.py.sample` to `i2p2www/settings.py` and edit appropriately. - Add `./site-updater.sh` to your crontab. This will keep the site updated, recompile the translations when necessary, and touch a file in `/tmp/` (look in `etc/update.vars` for the filename, your webserver should restart WSGI when the timestamp of this file changes). ## Updating translations 1. Pull new and updated translations from Transifex: ``` $ tx pull -a ``` 2. Correctly format the translations: ``` $ ./update-existing-po.sh ``` 3. Check in the updated translations: ``` $ mtn ci i2p2www/translations/ -m "Updated translations" ``` 4. Check in any new translations: ``` $ mtn add -R i2p2www/translations/ && mtn ci i2p2www/translations/ -m "New translations" ``` 5. Update the POT files with any changes to the website text: ``` $ ./extract-messages.sh ``` 6. Update the translations with any changes to the website text: ``` $ ./update-existing-po.sh ``` 7. Check in any changes to the website text: ``` $ mtn ci pots/ i2p2www/translations/ -m "Updated translation strings" ``` 8. Push website text changes to Transifex: ``` $ tx push -s ```