website/README.rst

52 lines
1.5 KiB
ReStructuredText
Raw Normal View History

2020-05-03 21:39:57 +00:00
data.coop-website
=================
2020-05-03 15:33:04 +00:00
.. image:: https://drone.data.coop/api/badges/data.coop/website/status.svg
:alt: Build Status
:target: https://drone.data.coop/data.coop/website
This is a `Hugo <https://gohugo.io/>`__ project.
2020-05-03 21:39:57 +00:00
Running locally
---------------
2020-05-03 15:33:04 +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
.. code-block:: bash
# Fetch .deb from Github
wget https://github.com/gohugoio/hugo/releases/download/v0.69.2/hugo_extended_0.69.2_Linux-64bit.deb -O hugo_extended.deb
# Install package
sudo dpkg -i hugo_extended.deb
# Clone repo
git clone https://git.data.coop/data.coop/website.git data.coop-website
2020-05-03 15:33:04 +00:00
# Go to website
cd data.coop-website
2020-05-03 15:33:04 +00:00
# Run development server
hugo server
2020-05-03 15:33:04 +00:00
2020-05-03 21:39:57 +00:00
Deploying the site
------------------
2020-05-03 15:33:04 +00:00
2020-05-03 21:39:57 +00:00
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.
2020-05-03 15:33:04 +00:00
2020-05-03 21:39:57 +00:00
Multilingual notes
------------------
Our website is made multi-lingual using the following 3 structures:
2020-05-03 21:39:57 +00:00
#. The folder ``i18n/`` contains translations of strings used in the theme.
#. Each content article and news text has a language version such ``content/<slug>.en.md``
#. The ``config.yaml`` contains settings specific to each language, such as navigation.