This documentation covers building a landing page like ecobytes.net or setting up a knowledge repository like docs.ecobytes.net with a static site generator. We chose Hugo which is configured via YAML-files.
Two git repositories within your home git community are being used: one for the theme and the other for content and menu configuration.
git@gitlab.domain.tld:gitname/project/website-theme.gitgit@gitlab.domain.tld:gitname/project/website.githttp://gohugo.io/getting-started/quick-start/
cd themes
git clone git@github.com:gitname/themename.git myforkedtheme
cd myforkedtheme
For the sake of completeness the repo on GitHub is kept. So that we can push into two repos at once we add them to the new remote “both”.
git remote add both git@github.com:gitname/themename.git
git remote set-url --add --push both git@github.com:gitname/themename.git
git remote set-url --add --push both git@gitlab.domain.tld:gitname/project/website-theme.git
Push to both repos simultaneously is done via:
git push both
git@lab.allmende.io:ecobytes/association/website.gitgit@lab.allmende.io:ecobytes/commons/documentation.gitgit clone git@lab.allmende.io:ecobytes/association/website.git
# or git@lab.allmende.io:ecobytes/commons/documentation.git
cd website/
git submodule update --init --recursive --remote
Verify with by running
hugo serve
and opening http://localhost:1313 in your browser.
In your tmux session …
tmux
# one pane for
hugo serve
# and another for
vim ...
# with live reload
Sometimes one wishes to deploy a site in development to a staging environment. Assuming you know and use Dokku, the repositories are prepared to work with it. You can push your site to it with:
hugo
cd public
git remote add stage dokku@apps.allmende.io:ecobytes-website
# or dokku@apps.allmende.io:ecobytes-documentation
git push -u stage deploy:master
cd ..
Assuming you wish to deploy master to a production instance, simply issue
./deploy.sh
master
stage