Project Helix documentation site based on… Helix!
Check www.project-helix.io.
Clone current repo and simply run hlx up
.
If you want to see content from remote repository, run git submodule init
If you want to locally emulate the behaviors on the public host (especially when working with navigation links, multiple content repos with one code repo...), use:
hlx up --host www.project-helix.io
Ensure that you have the correct environment variables set in your .env
file:
$ ln -s secrets/helix.env .env
$ cat .env
HLX_WSK_NAMESPACE=helix-pages
HLX_WSK_AUTH=...
HLX_FASTLY_NAMESPACE=...
HLX_FASTLY_AUTH=...
If the secrets/helix.env
env file is missing, you need to decrypt it first. We're using BlackBox to encrypt sensitive information in the git repository, e.g. the secrets/helix.env
file containing API tokens, keys etc. If you are new to BlackBox follow the Installation instructions and refer to the BlackBox Commands.
Once you've added yourself as an admin via blackbox_addadmin <email address>
(and committed the changes), one of the existing admins will need to re-encrypt the files. Check the list of admins (blackbox_list_admins
) and contact one of them. Once the admin re-encrypted the files you will be able to run:
blackbox_decrypt_all_files
hlx deploy --default REPO_RAW_ROOT https://raw.githubusercontent.com --default REPO_API_ROOT https://api.github.com/
hlx publish