enro / datactivist-website

datactivist website

Instructions pour pouvoir contribuer du contenu au site.

Mise en place pour nouveau contributeur

0. Installer le framework hugo sur la machine.

Pour Ubuntu :

sudo apt-get install hugo

Pour macOS avec Homebrew :

brew install hugo

Pour Windows avec Chocolatey :

choco install hugo -confirm

En cas de soucis ou pour d'autres options, reportez-vous au site de Hugo.

1. Sur GitHub, faire un fork de https://github.com/datactivist/datactivist-website

2. Dans un terminal, cloner le fork et ajouter un lien vers le repo datactivist"upstream":

cd /path/to/wherever
git clone https://github.com/<your_login>/datactivist-website
cd datactivist-website
git remote add upstream https://github.com/datactivist/datactivist-website

Puis pour tenir son fork à jour : https://help.github.com/en/articles/syncing-a-fork

Modifier le contenu

1. Dans un terminal:

cd /path/to/wherever
cd datactivist-website/hugo/

hugo server

2. Modifier les fichiers markdown dans les dossiers /content/francais/homepage, /content/francais/a-propos etc.

3. Appuyer sur Ctrl+C pour tuer le serveur

4. Supprimer le dossier public et le submodule git correspondant:

cd ..
rm -rf .git/modules/hugo/public/ .gitmodules hugo/public
# edit .git/config (ex: emacs .git/config)
# delete [submodule "hugo/public"] and its daughters
git rm -r --cached hugo/public

5 - Ajouter le submodule git:

git submodule add -b master [email protected]:datactivist/datactivist.github.io.git hugo/public

6 - Générer le site statique à partir du contenu:

cd hugo
hugo

7 - Déployer la nouvelle version du site en poussant le contenu du dossier public/ sur datactivist.github.io (via le submodule git):

# go to public folder
cd public
# add changes to git and commit
git add .
git commit -m "MESSAGE DE COMMIT"
# push changes
git push origin master

8 - Committer et pousser les modifs du contenu sur son fork:

# commit modifs in the folder hugo/ only
cd ..
git add .
git commit -m "MESSAGE DE COMMIT"
# commit modifs in the root folder for datactivist-website
cd ..
git add .
git commit -m "AUTRE MESSAGE DE COMMIT"
# push all modifs
git push