alsenet-labs / merklizer.xyz

merklizer.xyz website

merklizer.xyz

Web interface integrating https://github.com/alsenet-labs/merklizer

See it in action on https://merklizer.xyz

Copyright

Copyright (c) 2018-2024 ALSENET SA

Authors

• Alexandre Poltorak [email protected]
• Luc Deschenaux [email protected]

Licence

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Build

You can build the static webpages in a docker container with

env NODE_VERSION=v10 make  # NB: the remote repository will be used for the build and you need to fetch the tags

Then you can bind or copy the dist directory somewhere, on linux it is located at

/var/lib/docker/volumes/merklizer.xyz/_data/dist

And you can update them with eg:

git rm docs/js/*
sudo rsync -a /var/lib/docker/volumes/merklizer.xyz/_data/dist/ docs/
sudo chown $USER.$USER docs -R

On the other hand you can build the static webpages on your host from the local repository, at your risks and perils:

make unsafe-build

Then you can start the local build with:

gulp

Clean

When you are finished, you can remove the docker container with eg

docker rm merklizer.xyz

or the associated docker volume with

docker volume rm merklizer.xyz

Check the docker documentation for more.

Work in the container (git, gulp...)

Restart the container with eg

docker start merklizer.xyz

Run a shell in the container with eg

docker exec -it merklizer.xyz /bin/bash -l

or eg

docker exec -it merklizer.xyz /bin/bash -l -e 'screen -s /bin/bash'

Update gh-pages

eg after rebuilding the container, with:

docker start merklizer.xyz -ai << EOF
cd /home/nodejs/src/merklizer.xyz
git config user.name "$(git config user.name)"
git config user.email "$(git config user.email)"
git add docs
git commit docs -m "update gh-pages"
git push origin master
EOF

Run and test web application with eg

docker start merklizer.xyz -ai << EOF
cd /home/nodejs/src/merklizer.xyz
gulp
EOF

merklizer.xyz's Issues

404 on GitHub Page

Looks like something is wrong with GitHub page since yesterday evening, some files are not found, before it was the index.js and the background images, now it's only the index.js.

Looks like a common issue... https://stackoverflow.com/questions/11577147/how-to-fix-page-404-on-github-page

nan npm package binary does not build with nodejs >10

nan appears to be still incompatible with nodejs v12. Using nodejs v10 (--lts at the time the nodejs-docker/Dockerfile was written) solves the problem