path: root/
diff options
authorYorhel <>2019-07-25 14:30:04 +0200
committerYorhel <>2019-07-25 14:36:21 +0200
commitf296495a912ce759df11c43e78b4552788bdbff2 (patch)
tree0c10802de65fb7c8475722e12234bff5eb980628 /
parent0f3cfeb85caec6424bcbea47142eefbf8011636b (diff)
Merge the v3 branch into separate namespace + fix Docker stuff (again)
I was getting tired of having to keep two branches up-to-date with the latest developments, so decided to throw v3 into the same branch - just different files (...which will get mostly rewritten again soon). The two versions aren't very different in terms of dependencies, build system and support code, so they can now properly share files. Added a section to the README to avoid confusion. This merge also makes it easier to quickly switch between the different versions, which is handy for development. It's even possible to run both at the same time, but my scripts use the same port so that needs a workaround. And it's amazing how often I break the Docker scripts.
Diffstat (limited to '')
1 files changed, 30 insertions, 4 deletions
diff --git a/ b/
index 8fe62550..a074de17 100644
--- a/
+++ b/
@@ -17,9 +17,8 @@ Run (will run on the foreground):
If you need another terminal into the container while it's running:
- docker exec -ti vndb su -l devuser # development shell (files are at /var/www)
- docker exec -ti vndb psql -U devuser vndb # postgres superuser shell
- docker exec -ti vndb psql -U vndb # postgres vndb shell
+ docker exec -ti vndb su -l devuser # development shell (files are at /var/www)
+ docker exec -ti vndb psql -U vndb # postgres shell
To start Multi, the optional application server:
@@ -60,6 +59,7 @@ Global requirements:
- Linux, or an OS that resembles Linux. Chances are VNDB won't run on Windows.
- PostgreSQL 10 (older versions may work)
- perl 5.24 recommended, 5.10+ may also work
+- Elm 0.19
**Perl modules** (core modules are not listed):
@@ -75,6 +75,7 @@ General:
util/ (the web backend):
- Algorithm::Diff::XS
+- SQL::Interp
- Text::MultiMarkdown
- HTTP::Server::Simple
@@ -89,8 +90,10 @@ util/ (application server, optional):
## Setup
-- Make sure all the required dependencies (see above) are installed
+- Make sure all the required dependencies (see above) are installed. Hint: See
+ the Docker file for Ubuntu commands. For non-root setup: Use cpanm & local::lib.
- Create a suitable data/, using data/ as base.
+ (For v3, you may also want a based on
- Run the build system:
@@ -129,6 +132,29 @@ util/ (application server, optional):
make multi-restart
+# Version 2 & 3
+The VNDB website is being rewritten. The current active site is version 2, but
+this repository also contains the code for the new (in progress) version 3. The
+code is easy to identify, the following files are only used by version 3:
+- `lib/VN3/`
+- `css3/`
+- `elm3/`
+- `util/{vndb3,elmgen}.pl`
+- `data/config3{,_example}.pl`
+To run version 3 instead of 2:
+ # When not using Docker
+ util/ 3
+ # Or when using Docker, start the container as follows:
+ docker run -ti --name vndb -p 3000:3000 -v "`pwd`":/var/www --rm vndb /var/www/util/ 3
## License
GNU AGPL, see COPYING file for details.