Skip to content

Commit 048fda8

Browse files
committed
improve localized server instruction
1 parent 29aaf87 commit 048fda8

File tree

1 file changed

+26
-3
lines changed

1 file changed

+26
-3
lines changed

README.md

Lines changed: 26 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,32 @@ Then open <http://localhost:9292> in a web browser, and verify that you can navi
3333
To serve sites from "sites/en", use `rake run` or a vanilla deploy.
3434

3535
To server sites from another locale (say, "es" or Spanish)...
36-
* Locally, use the SITE_LOCALE environment variable: `SITE_LOCALE=es rake run`
37-
* On a server, make the server respond to a locale subdomain: `http://es.railsbridge.org`
38-
* Or to temporarily test, use a `locale` or `l` parameter: `http://docs.railsbridge.org/?l=es` (note that in this mode, links are not rewritten, so if they fail you will have to manually add the parameter again)
36+
37+
### Run Localized Site Locally
38+
39+
$ SITE_LOCALE=es rake run
40+
41+
The server listens on `0.0.0.0:9292`.
42+
43+
Now you have to setup subdomain for the site. If you have Pow, run:
44+
45+
$ echo 9292 > ~/.pow/railsbridge # works for any subdomain
46+
47+
If you don't have Pow, add the following line to `/etc/hosts`:
48+
49+
127.0.0.1 es.railsbridge.dev # works for single subdomain
50+
51+
Now you can access `http://es.railsbridge.dev:9292` for debugging.
52+
53+
### Running on a Server
54+
55+
Just make sure the server responds to a locale subdomain: `http://es.railsbridge.org`
56+
57+
### Temporary Testing
58+
59+
Use a `locale` or `l` parameter: `http://docs.railsbridge.org/?l=es`.
60+
61+
Note that in this mode, links are not rewritten, so if they fail you will have to manually add the parameter again.
3962

4063
## Contributing
4164

0 commit comments

Comments
 (0)