website/README.md

55 lines
1.4 KiB
Markdown
Raw Permalink Normal View History

2020-05-03 21:42:57 +00:00
data.coop-website
=================
[![Build Status](https://drone.data.coop/api/badges/data.coop/website/status.svg)](https://drone.data.coop/data.coop/website)
This is a [Hugo](https://gohugo.io/) project.
Running locally
---------------
Go to [Hugo Github release](https://github.com/gohugoio/hugo/releases)
and fetch the latest package for **hugo\_extended** for your system.
We want to align with the latest version always. If it doesn't work,
file an issue!
Example recipe
``` {.sourceCode .bash}
# Fetch .deb from Github
2021-01-26 19:26:21 +00:00
wget https://github.com/gohugoio/hugo/releases/download/v0.80.0/hugo_extended_0.80.0_Linux-64bit.deb -O hugo_extended.deb
2020-05-03 21:42:57 +00:00
# Install package
sudo dpkg -i hugo_extended.deb
# Clone repo
git clone https://git.data.coop/data.coop/website.git data.coop-website
# Go to website
cd data.coop-website
# Run development server
hugo server
```
Deploying the site
------------------
Simply pushing to `master` in our main repo at
<https://git.data.coop/data.coop/website/> will trigger a
build-and-deploy of the website.
Multilingual notes
------------------
Our website is made multi-lingual using the following 3 structures:
1. The folder `i18n/` contains translations of strings used in the
theme.
2. Each content article and news text has a language version such
`content/<slug>.en.md`
3. The `config.yaml` contains settings specific to each language, such
as navigation.