Please note that the Github Pages demo is not going to work as expected, as it requires a webserver for handshakes between the Operating System and the frontend of this web application.
V A 二ｌｌA (Vanilla Project or Va2) is a webserver-based (Apache2) Desktop Environment application.
It is made to be flexible and cross-platform, however currently focused on Linux machines only.
Being under development it does not have a lot of features; however, there is a lot of native features and
applications that have already been scheduled for development.
The only requirement for this application is Apache webserver, which can be:
- Downloaded for Windows
- Compiled from source
- Or installed as a package, for example:
(Arch Linux)
sudo pacman -Syy apache
(Ubuntu Linux)
sudo apt install apache2
(Termux, Android)
pkg install apache2
Create a new folder called va2.reineimi in the ./htdocs (Windows) or ./http (Arch Linux) directory of your Apache version, then put the contents of this application inside of that folder;
Change your host username and paths in the following files:
(the paths in the examples below are genuine for Arch Linux and doesn't have to be changed on those OS distributions)
httpd.conf
Define _ROOT "/etc/httpd"
Define _DOCS "/srv/http"
Define _LOGS "/srv/http/logs"
...
# Server user for Linux
<IfModule unixd_module>
User _USERNAME_
...
</IfModule>
response.lua
USER = '_USERNAME_'
PATH = '/srv/http/va2.reineimi/'
...
WIN_HTTPD_PATH = 'C:\\Apache24\\bin'server.conf
{
"server_path": "/srv/http/va2.reineimi/",
"server_user": "_USERNAME_",
"downloads": "/home/_USERNAME_/Downloads/"
}
Then put httpd.conf in, presumably, one of these locations (where the old httpd.conf can be found):
C:/Apache24/conf/ (Windows);
/etc/httpd/ (Arch Linux).
To embed any library module, for example va2.js and va2.css, you only need to put the following in your <head> tag:
<script src='https://reineimi.github.io/va2/lib/va2.js' async></script>
<link rel='stylesheet' href='https://reineimi.github.io/va2/lib/va2.css'>It's also recommended to include the following meta tag:
<meta id='va2meta' data-ver='CURRENT_VER'>And replace CURRENT_VER with the Va2 version you can see in your console once va2.js loaded.
This meta tag allows you to track significant releases and whether it's recommended to update your local files immediately or not.