This is the hugo-based website repository for the BEL.bio project. We are using the Syna Hugo theme.
Prerequisites: Go, Hugo, aws (Amazon AWS cli and S3 write credentials)
To start your website run the following commands:
Development:
$ git clone [email protected]:belbio/belws.git
$ hugo server -D
Production:
$ hugo # This command would generate the static website in the public/ directory
aws s3 sync "public" "s3://bel.bio" --acl "public-read"
We're using the standard directory structure using content pages.
├─ content/
| └ _global/ # All global fragments are located in this directory
| └ _index/ # Landing page is in this directory and it's url is changed to **/**.
| └ about/ # About page
├ layouts/ # You can add extra layout files here. A sample custom fragment is available as a sample.
├ static/ # Your static files are in this directory.
├ themes/ # Hugo uses this directory as a default to look for themes. Syna theme is a git submodule available in this directory.
├ .gitignore
├ .gitmodules
├ config.toml # Hugo config file containing general settings and menu configs.
For storing images in the static directory, note that Syna fragments look for
images in their own fragment directory, page directory and static/images
directory. Read our image fallthrough documentation for more info.
Further details read our full documentation.
Website:
- Hugo static site generator
- Syna Hugo theme
- Home page hero background image created by Gerd Altmann from Pixabay