Summary Files Commits Branches @commit @diff @stats
diff options
context:
space:
mode:
Commita6ff5db126f29f2b26161f6df40261e84c58cf3a (patch)
Author
 Syndamia <kamen.d.mladenov@protonmail.com>
2021-04-03 17:13:55 +0300
Committer
 Syndamia <kamen.d.mladenov@protonmail.com>
2021-04-03 17:13:55 +0300
Filesa652a79f52b837484baddfc4b62383090a0baca6
devrix-job-board-a6ff5db126f29f2b26161f6df40261e84c58cf3a.tar
devrix-job-board-a6ff5db126f29f2b26161f6df40261e84c58cf3a.tar.gz
devrix-job-board-a6ff5db126f29f2b26161f6df40261e84c58cf3a.zip
Parent5ee8a430efd2a0ac4e455bf9c696e82f3b5ff67e (diff)
Added setup and a bit of project information to README
2 files changed, 30 insertions, 2 deletions
-rw-r--r--README.md31
-rw-r--r--configs/devrix-job-board.conf1
diff --git a/README.md b/README.md
index 641416b..cdb43fd 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,31 @@
# devrix-job-board
-The repository for my solution of DevriX's exam for their internship program
+
+The repository for my solution of DevriX's exam for their internship program.
+
+It's an oversimplified job offer website, (roughly) following the MVC design pattern and using the LAMP stack (with MySQL).
+
+## Contents
+- [Getting started](#Getting%20started)
+- [Tools](#Tools)
+
+## Getting started
+
+1. As previously mentioned, the project uses the LAMP stack. Links on setting it up: [Ubuntu 20.04](https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-ubuntu-20-04), [Debian 8](https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mysql-php-lamp-stack-on-debian-8) or [CentOS 8](https://www.digitalocean.com/community/tutorials/how-to-install-linux-apache-mariadb-php-lamp-stack-on-centos-8).
+
+2. Currently this repo provides an Apache configuration file (`configs/devrix-job-board.conf`) with the localhost domain `djb.local`.
+ - To use that domain, you'll also need to open your `/etc/hosts` file and add on a new line line `127.0.0.1 djb.local`, but **be wary**, it will break any other localhost domains you've setup.
+ - If you wanna use it in a server-hosted environment, update the values of `ServerName` and `ServerAlias` with your desired domain and subdomain.
+
+3. Finally, we'll need to move the source code to the `/var/www/devrix-job-board/` folder.
+ - This (and creating the folder if it doesn't exist) can be done automatically, just run with sudo the `move-to-www.sh`:
+ ```
+ sudo ./tools/move-to-www.sh
+ ```
+
+## Tools
+
+This repo contains some tools that could be useful during setup and development of the app. They're all located in the `tools` folder.
+
+1. `move-to-www.sh` - moves the source code (located in `src`) to the `/var/www/devrix-job-board/` folder
+2. `watch-move-to-www.sh` - does the same thing as `move-to-www.sh`, but does it automatically every time you update a file inside the `src` folder. Especially useful while developing the application.
+ - Dependencies: [`inotify-tools`](https://pkgs.org/download/inotify-tools)
diff --git a/configs/devrix-job-board.conf b/configs/devrix-job-board.conf
index 49356f2..88021bc 100644
--- a/configs/devrix-job-board.conf
+++ b/configs/devrix-job-board.conf
@@ -12,4 +12,3 @@
RewriteRule ^(.+)$ index.php [QSA,L]
</Directory>
</VirtualHost>
-