Replace README.rst with README.md #13
54
README.md
Normal file
54
README.md
Normal file
|
@ -0,0 +1,54 @@
|
||||||
|
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
|
||||||
|
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
|
||||||
|
|
||||||
|
# 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.
|
||||||
|
|
51
README.rst
51
README.rst
|
@ -1,51 +0,0 @@
|
||||||
data.coop-website
|
|
||||||
=================
|
|
||||||
|
|
||||||
.. 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.
|
|
||||||
|
|
||||||
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
|
|
||||||
|
|
||||||
.. 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
|
|
||||||
|
|
||||||
# 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:
|
|
||||||
|
|
||||||
#. 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.
|
|
||||||
|
|
Loading…
Reference in a new issue