2020-05-03 21:42:57 +00:00
|
|
|
data.coop-website
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
[](https://drone.data.coop/data.coop/website)
|
|
|
|
|
|
|
|
|
|
This is a [Hugo](https://gohugo.io/) project.
|
|
|
|
|
|
2021-05-04 18:57:45 +00:00
|
|
|
Running with Docker
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
In `docker-compose.yml`, we have specified a `serve` target which you can run locally like this:
|
|
|
|
|
|
|
|
|
|
``` {.sourceCode .bash}
|
|
|
|
|
docker-compose up serve
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Running without Docker
|
|
|
|
|
----------------------
|
2020-05-03 21:42:57 +00:00
|
|
|
|
|
|
|
|
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-05-04 18:57:45 +00:00
|
|
|
wget https://github.com/gohugoio/hugo/releases/download/v0.80.0/hugo_extended_X.Y.Z_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.
|
|
|
|
|
|
