# Bonjour BERKIOS

Source : https://docs.berkios.online/galerie/bonjour-berkios/ · Section : Galerie · Documentation officielle BERKIOS (https://docs.berkios.online)


Votre tout premier programme BERKIOS Core : trois lignes, une commande, un résultat.

Télécharger l'exemple : https://github.com/berkiosbuinu-server/examples/releases/latest/download/01-bonjour-berkios.zip

**Type :** BERKIOS Core · **Niveau :** débutant · **Fichier :** `bonjour.bks`

## Ce que vous allez apprendre

- Écrire et lancer un programme Core.
- Comprendre la structure minimale : un module et une fonction `principale`.
- Afficher du texte et des nombres.

## Avant de commencer

L'outil `berkios` doit être installé : voir [Depuis les sources, Code et Core](https://docs.berkios.online/commencer/installer/). Vérifiez avec `berkios --lg`.

## Étape 1 : récupérer l'exemple

Téléchargez l'exemple avec le bouton ci-dessus et décompressez-le. Vous obtenez le fichier `bonjour.bks`. Vous pouvez aussi le recopier à la main : c'est l'objet de l'étape suivante.

## Étape 2 : le code

```text
module "Bonjour"

fonction principale() -> Entier
  afficher "Bonjour BERKIOS !"
  retourner 0
```

## Étape 3 : le lancer

Ouvrez un terminal dans le dossier du fichier :

```bash
berkios core bonjour.bks
```

Résultat :

```text
BERKIOS Core : Bonjour — 1 fonction(s), 0 type(s) : vérification réussie.
Bonjour BERKIOS !
```

La première ligne confirme que le compilateur a **vérifié** le programme. La seconde est le résultat de votre code.

## Le code expliqué, ligne par ligne

| Ligne | Rôle |
|---|---|
| `module "Bonjour"` | Donne un nom au module. Chaque fichier `.bks` commence ainsi. |
| `fonction principale() -> Entier` | Déclare la fonction de départ. Le programme commence toujours ici. `-> Entier` indique qu'elle renvoie un nombre entier. |
| `afficher "Bonjour BERKIOS !"` | Écrit un texte à l'écran. Les deux espaces au début de la ligne indiquent qu'elle appartient à la fonction. |
| `retourner 0` | Termine la fonction. `0` signifie que tout s'est bien passé. |

> **L'indentation compte.** Il n'y a pas d'accolades : ce qui est décalé de deux espaces appartient au bloc au-dessus.

## À vous de jouer

Modifiez le fichier, relancez `berkios core bonjour.bks` et observez :

```text
module "Bonjour"

fonction principale() -> Entier
  soit prenom = "Amina"
  afficher "Bonjour BERKIOS !"
  afficher prenom
  afficher 2 + 3
  retourner 0
```

Résultat attendu : `Bonjour BERKIOS !`, puis `Amina`, puis `5`. Vous venez de créer une **variable** avec `soit` et de faire un calcul.

## Pour aller plus loin

- Exemple suivant : [Remise et total à payer](https://docs.berkios.online/galerie/remise-et-total/)
- Leçon complète : [Core, vos premiers pas](https://docs.berkios.online/core/premiers-pas/)