Kasianov Nikolai Alekseevich
3 months ago
2 changed files with 84 additions and 23 deletions
@ -1,30 +1,80 @@ |
|||||||
# Dela dead simple web TODO list |
![Dela](static/images/android-chrome-192x192.png "Dela logo") |
||||||
|
|
||||||
## About |
# Dela - dead simple web TODO list |
||||||
|
|
||||||
|
## About |
||||||
Dela is a web TODO list application which can be hosted on your server and accessed via browser. Current capabilities include: |
Dela is a web TODO list application which can be hosted on your server and accessed via browser. Current capabilities include: |
||||||
|
|
||||||
- Password protected account system |
- Password protected account system |
||||||
- TODO creation |
- TODO creation |
||||||
- TODO completion |
- TODO completion |
||||||
|
- TODO deletion |
||||||
|
- TODO drag-and-drop on categories |
||||||
|
- Due date selection on TODO creation |
||||||
|
|
||||||
## Build |
## Build |
||||||
|
Dela is written in Go, so you need to have a Go compiler. |
||||||
|
|
||||||
|
For ease of compilation it is also recommended to have `make`. |
||||||
|
|
||||||
|
To automatically compile Dela and have a ready-to-go solution, run: |
||||||
|
|
||||||
``` |
``` |
||||||
make |
make |
||||||
``` |
``` |
||||||
|
|
||||||
or manually compile with `go build` inside the `src` directory, move the binary and put it alongside `pages`, `scripts` and `static` (although the path to the contents can be specified via configuration file). |
a portable `/bin` directory should appear where binary and base contents are located. |
||||||
|
|
||||||
|
|
||||||
|
### Manual build |
||||||
|
Or you can manually compile with `go build` inside the `src` directory. Move the binary and put it alongside `pages`, `scripts` and `static` (or specify the path to the contents directory via configuration file which is created automatically upon first launch). |
||||||
|
|
||||||
|
|
||||||
|
### Portable build |
||||||
|
To get a portable archive run: |
||||||
|
|
||||||
``` |
``` |
||||||
make portable |
make portable |
||||||
``` |
``` |
||||||
|
|
||||||
will create a `dela.zip` archive with all the content directories and the binary which are to be freely transported to other machines (of the same OS and architecture, obviously) |
which will create `dela.zip` archive with all the content directories and the binary which can be freely transported to other machines (of the same OS and architecture) |
||||||
|
|
||||||
|
### Cross compilation |
||||||
|
For cross-platform compilation there is: |
||||||
|
|
||||||
|
``` |
||||||
|
make cross |
||||||
|
``` |
||||||
|
|
||||||
|
which cross compiles the project for linux, freebsd, windows and darwin systems. Portable solutions will be put in `/bin` directory in the corresponding subdirectories. |
||||||
|
|
||||||
## Use |
## Use |
||||||
|
|
||||||
After the first run a configuration file will be put alongside the executable, upon the second launch server will start and the service will be accessible on the specified port. |
### Configuration file |
||||||
|
After the first run a configuration file will be put alongside the executable, upon the second launch the server will start and the service will be accessible on the specified port. |
||||||
|
|
||||||
|
Currently configuration file contains these filelds: |
||||||
|
```json |
||||||
|
{ |
||||||
|
"port": 8080, |
||||||
|
"cert_file_path": "", |
||||||
|
"key_file_path": "", |
||||||
|
"base_content_dir": ".", |
||||||
|
"production_db_name": "dela.db" |
||||||
|
} |
||||||
|
``` |
||||||
|
|
||||||
|
| Field | Description | |
||||||
|
| --- | ----------- | |
||||||
|
| port | port on which the service will run | |
||||||
|
| cert_file_path | path to the SSL certificate file | |
||||||
|
| key_file_path | path to the SSL certificate key file | |
||||||
|
| base_content_dir | path to the directory with `pages`, `scripts` and `static` subdirectories | |
||||||
|
| production_db_name | SQLite3 database file path | |
||||||
|
|
||||||
|
|
||||||
|
### SSL certificates |
||||||
|
If you intend to use SSL certificates - there are corresponding fields in the configuration file. |
||||||
|
|
||||||
## License |
## License |
||||||
Dela is licensed under AGPL |
Dela is licensed under AGPL |
Loading…
Reference in new issue