www-2/README.md

# Openbsd.fr.eu.org v2

[![Build Status](https://drone.tildegit.org/api/badges/obsd4a/www-2/status.svg)](https://drone.tildegit.org/obsd4a/www-2)

## Français

Site principal de openbsd.fr.eu.org

### Description

Ceci est le site principal de openbsd.fr.eu.org, un site francophone d'une communautée centrée sur OpenBSD. Il est entièrement conçu à l'aide du générateur de site kiln.

### Construction

#### Dépendances

 * Go
 * Python 3 & pip
 * [kiln](https://git.sr.ht/~adnano/kiln)
 * [gmitohtml](https://git.sr.ht/~adnano/gmnitohtml)
 * [mdtohtml](https://git.sr.ht/~adnano/mdtohtml)
 * [md2gemini](https://github.com/makeworld-the-better-one/md2gemini)
 * gmake (sur OpenBSD uniquement)

#### Installation

 * Fedora GNU/Linux :
```bash
$ sudo dnf install go scdoc
$ git clone https://git.sr.ht/~adnano/kiln
$ cd kiln && make && sudo make install
$ git clone https://git.sr.ht/~adnano/mdtohtml
$ cd mdtohtml && make && sudo make install
$ git clone https://git.sr.ht/~adnano/gmnitohtml
$ cd gmnitohtml && make && sudo make install
$ sudo pip3 install md2gemini
```
 * OpenBSD :
```bash
$ doas pkg_add go gmake scdoc
$ git clone https://git.sr.ht/~adnano/kiln
$ cd kiln && gmake && doas gmake install
$ git clone https://git.sr.ht/~adnano/mdtohtml
$ cd mdtohtml && gmake && doas gmake install
$ git clone https://git.sr.ht/~adnano/gmnitohtml
$ cd gmnitohtml && gmake && doas gmake install
$ pip3 install md2gemini
```

### Génération du site

Pour construire le site, utiliser la commande `kiln build` à la racine du dépôt.

### Publication du site

Ce dépôt Git utilise de la CI/CD : un script se déclenche automatiquement à chaque commit validé sur la branche principale et active le déploiement automatique du site sur le serveur. Aucune action utilisateur n'est donc requise pour activer le déploiement.

## English

Main website of openbsd.fr.eu.org

### Description

This is the main website of openbsd.fr.eu.org, a French website of a community about OpenBSD. It is entirely build with kiln, a static website generator.

### Construction

#### Dependencies

 * Go
 * Python 3 & pip
 * [kiln](https://git.sr.ht/~adnano/kiln)
 * [gmitohtml](https://git.sr.ht/~adnano/gmnitohtml)
 * [mdtohtml](https://git.sr.ht/~adnano/mdtohtml)
 * [md2gemini](https://github.com/makeworld-the-better-one/md2gemini)
 * gmake (on OpenBSD only)

#### Installation

 * Fedora GNU/Linux :
```bash
$ sudo dnf install go scdoc
$ git clone https://git.sr.ht/~adnano/kiln
$ cd kiln && make && sudo make install
$ git clone https://git.sr.ht/~adnano/mdtohtml
$ cd mdtohtml && make && sudo make install
$ git clone https://git.sr.ht/~adnano/gmnitohtml
$ cd gmnitohtml && make && sudo make install
$ sudo pip3 install md2gemini
```
 * OpenBSD :
```bash
$ doas pkg_add go gmake scdoc
$ git clone https://git.sr.ht/~adnano/kiln
$ cd kiln && gmake && doas gmake install
$ git clone https://git.sr.ht/~adnano/mdtohtml
$ cd mdtohtml && gmake && doas gmake install
$ git clone https://git.sr.ht/~adnano/gmnitohtml
$ cd gmnitohtml && gmake && doas gmake install
$ pip3 install md2gemini
```

### Site generation

To build the website, use the `kiln build` command at the repo's root.

### Site publication

This git repo uses CI/CD : a script starts automatically for every commit pushed on the main branch and deploys the site on the server. No action is needed for deploying the site.