From b06b3a9cb3ae772202f522ae085446a040736c95 Mon Sep 17 00:00:00 2001 From: Terry Truong Date: Mon, 11 Jul 2022 19:39:40 +1000 Subject: Add deployment documentation --- README.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index ebda699..5221183 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,6 @@ stored using [Sqlite](https://www.sqlite.org). - **package.json**: Contains npm project information, such as package dependencies. - **package-lock.json**: Auto-generated by npm. Used for replicable installations. - **LICENCE.txt**: This project's license (MIT). -- **.gitignore**: Lists files to be ignored if using [Git](https://git-scm.com/downloads). ### Client & Server - **src**: Contains most of the client-side code. - **index.html**: Holds code for the main page, into which code from 'src' will be included. @@ -30,6 +29,10 @@ stored using [Sqlite](https://www.sqlite.org). - **tailwind.config.js**: For configuring Tailwind. - **postcss.config.js**: For configuring Tailwind. - **tsconfig.json**: For configuring Typescript. +### Other +- **.gitignore**: Lists files to be ignored if using [Git](https://git-scm.com/downloads). +- **DEPLOY.md**: Instructions for deployment on an Apache server on Ubuntu. +- **prebuild.sh**: Bash script for automating some steps of deployment. ## Setup Instructions @@ -46,8 +49,8 @@ in backend/data/README.md. ### Server Side 1. If you don't have Python 3 installed, see . The package manager Pip is included. -1. The database used by the server is generated using scripts in backend/data/. - See it's README.md for instructions. You'll likely need to install a few +1. The database used by the server is generated using scripts in `backend/data/`. + See it's README for instructions. You'll likely need to install a few packages using Pip. 1. To run the dev server, you'll need to install jsonpickle. This can be done using `python -m pip install jsonpickle`. If you want to keep the installed @@ -55,12 +58,16 @@ in backend/data/README.md. the 'venv' module. ### Running Tilo -1. In the backend/ directory, run `./server.py`, which starts a basic HTTP server that provides +1. In `backend/`, run `./server.py`, which starts a basic HTTP server that provides tree-of-life data on port 8000. -1. In this directory, or somewhere in src/, run `npm run dev`. This starts a dev server that +1. In this directory, or somewhere in `src/`, run `npm run dev`. This starts a dev server that provides Tilo's user interface on port 3000. 1. Open a web browser, and navigate to . +## Deploying the Website +This is significantly dependent on the server platform. `DEPLOY.md` contains +instructions for deployment on an Apache server on an Ubuntu system. + ## Licence -Tilo is licensed under the MIT licence, provided in LICENSE.txt +Tilo is licensed under the MIT licence, provided in `LICENSE.txt` -- cgit v1.2.3