Skip to content

Commit 466729d

Browse files
committed
Added discussion on setting up a local test web server
1 parent d2e18ff commit 466729d

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

README.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,15 +27,27 @@ conda env create -f ../ci/environment.yml
2727
conda activate pythia
2828
```
2929

30-
You can then build the site:
30+
You can then build the site with:
3131

3232
```
3333
make html
3434
```
35-
and view the built site in your web browser with:
35+
36+
After building the site it may be possible to preview the portal in your web browser by simply opening the `index.html` file:
3637

3738
```
3839
open _build/html/index.html
3940
```
4041

42+
However, many of the links will not work. For all of the links found in the portal to work properly, you'll need to set up a local testing server. This can be done with Python's http.server by running the following command from within the `content` directory:
43+
44+
```
45+
python -m http.server --directory _build/html/
46+
```
47+
48+
and then pointing your browser at the URL: `localhost:8000`
49+
50+
More information on setting up a local test server is available from [here](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/set_up_a_local_testing_server)
51+
52+
4153
You can find more details in the [Contributor's Guide](https://projectpythia.org/pages/contributing.html).

0 commit comments

Comments
 (0)