One time read messaging system. You can try it at viacry.pt.
Assuming you have node.js and grunt-cli and just cloned the project.
npm install
grunt run
# go to localhost:8001 and have fun developing
npm install
# configure config/server.js
grunt
# automate the following with supervisor/upstart/...
./bin/viacrypt-server
# go to yourserver.com if you either have configured port 80
# or proxied it to 8001 and enjoy your deployment
Dependencies are handled by npm and installed like this:
npm install
You will also need to install the grunt-cli globally if you don't already have it.
npm install -g grunt-cli
Currently we're using node-config to manage configurations.
Typically you should config/development.js (or .json, .yaml, .yml) to set your specific
preferences. It is also possible to create multiple configuration environments and also custom
configs to a machine hostname. You should read the node-config documentation
for more information on that regard.
An static directory is generated from the assets and templates dirs, and some dependencies
that need to be downloaded. Those tasks are automated with grunt.
To generate the static dir, simply run grunt on the project root:
grunt
That step is needed when using ./bin/viacrypt-server to update the files it will serve, or when
serving the files with your http server (nginx, varnish, apache, ...).
Should be as simple as
./bin/viacrypt-server
or
grunt run
for development, this one will recompile and reload on demand as sources change, more a less like
django's ./manage runserver.
Then checkout localhost:8001 (or whatever you have configured) to see the app.
Translations are being done with Jed in a gettext compatible way,
translation files should be located on locale/<LANG>/messages.po with their respective
locale/<LANG>/messages.json used by Jed, don't worry po2json can make that conversion, used on
a handy script: ./xgettext.sh.
To create a new translation one can use locale/messages.pot as a template.
There is a script to update the current translations, it is the recommended way right now.
./xgettext.sh
That script depends on a global modified version of handlebars-xgettext
(available here installable like npm install vialink/handlebars-xgettext)
and po2json also installed globally.
We are aware that it only works on POSIX systems contributions to improve this subsystem are very welcome.
Put the following typically on /etc/supervisor/conf.d/viacrypt.conf.
[program:viacrypt]
command=/path/to/viacrypt/bin/viacrypt-server
stdout_logfile=/path/to/viacrypt/logs/viacrypt.log
To start it:
supervisorctl start viacrypt
Supervisor has the advantage of automatic restart of the process on failures.
Put the following typically on /etc/init/viacrypt.conf.
description "ViaCRYPT node.js server"
start on startup
stop on shutdown
exec /path/to/viacrypt/bin/viacrypt-server >> /path/to/viacrypt/logs/viacrypt.log
To start it:
start viacrypt