https://github.com/kryzar/knowledge-should-be-free

https://github.com/kryzar/knowledge-should-be-free

Last synced: 11 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/kryzar/knowledge-should-be-free
• Owner: kryzar
• License: gpl-3.0
• Created: 2024-11-23T17:35:29.000Z (about 1 month ago)
• Default Branch: master
• Last Pushed: 2024-12-01T01:50:29.000Z (25 days ago)
• Last Synced: 2024-12-08T19:25:50.074Z (17 days ago)
• Language: HTML
• Size: 8.92 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# README

## Pour les développeurs et développeuses

Le site est *statique*. En particulier, il n'est bâti qu'avec HTML et CSS, et

sans JS. Pour limiter la redondance de code, nous utilisons

[Hugo](https://gohugo.io/), un [*générateur de sites

statiques*](https://jamstack.org/generators/). Cela permet de définir un unique

*template* HTML pour les pages de cours, et d'écrire le contenu des pages web

en Markdown. C'est bien plus digeste.

Il y a donc une phase de compilation (*build*) pour pouvoir visualiser le site.

Après avoir installé Hugo, et cloné le dépôt, ouvrir un terminal, aller dans le

répertoire du dépôt, et exécuter :

```sh

hugo server

```

Parmi les lignes renvoyées par Hugo, et en cas de succès, les lignes importantes sont :

```

Web Server is available at http://localhost:1313/ (bind address 127.0.0.1) 

Press Ctrl+C to stop

```

Cela indique que pour visualiser le site, il faut ouvrir un navigateur, et se

rendre à l'adresse [http://localhost:1313/](http://localhost:1313/). Bien sûr,

cette adresse peut changer chez vous !

Sur Ubuntu ou Debian, la chaîne totale de commandes serait :

```sh

sudo apt install hugo

git clone https://github.com/kryzar/knowledge-should-be-free

cd knowledge-should-be-free

hugo server

```

Et pour compiler l'intégralité du site, remplacer `hugo server` par `hugo

build`. Un répertoire `public` est alors créé ; la page d'accueil est le

fichier `index.html`, il faut l'ouvrir dans un navigateur pour commencer la

navigation.