================================================================================
PHENARIUM — WEBMASTER QUICKSTART GUIDE (v3.0.0)
(English first — Français à la suite)
================================================================================

1. INSTALLATION (WHERE TO PUT THE KEY)
--------------------------------------------------------------------------------
1. Upload the entire contents of the archive to your web server root (or any
   subfolder).
2. Requirements: PHP 8.0+ (no database required, no build tools, no external
   dependencies).
3. Open your site in a browser (https://yourdomain.com/). You are looking at
   the root matrix: AIR.


2. FOLDER STRUCTURE (HOW ROOMS WORK)
--------------------------------------------------------------------------------
All your content lives inside /SOL/AIR/.

  /SOL/AIR/          -> Root space (?air=AIR or /)
  /SOL/AIR/1/        -> Room 1 (?air=1)
  /SOL/AIR/22/3/6/   -> Nested room (?air=22/3/6)

Strict Naming Rule:
- Folder names inside /SOL/AIR/ must be pure integers only (0-9), such as:
  1, 42, 86, 974.
- Never use letters, spaces, or symbols in folder names.
- Each folder only loads the .php files placed directly inside it. Empty
  folders stay completely dormant.


3. CREATING A BOARD (PLACING CONTENT IN 3D SPACE)
--------------------------------------------------------------------------------
A board is a .php file placed inside a folder (e.g. /SOL/AIR/welcome.php),
optionally paired with a .css file of the exact same name (/SOL/AIR/welcome.css).

Every board MUST start with a single <main> tag carrying a data-ancre attribute:

  <main data-ancre="@AIR; right: 0; top: 0; z: 0;">
      <h1>Hello World</h1>
      <p>This board sits at the center of AIR.</p>
  </main>

Coordinate Grammar (data-ancre):
Each address requires 4 semicolon-separated fields:

  @MATRIX; HORIZONTAL; VERTICAL; DEPTH;

  - @MATRIX    : @AIR or @AIR/x/y/z (must match the folder path).
  - Horizontal : left: 250;  OR  right: 250;
  - Vertical   : top: 100;   OR  bottom: 100;
  - Depth      : z: 0; (required — positive = closer, negative = deeper).

Multiple Positions in the Same Room (++):
You can display the exact same board at multiple coordinates inside the same
folder using ++ :

  <main data-ancre="@AIR/4/3; left: 200; top: 100; z: 0; ++ @AIR/4/3; right: 200; bottom: 100; z: -300;">
      <h1>Twin Board</h1>
  </main>

Hiding Details Until Clicked (.cache):
Add class="cache" to any element inside <main> to keep it hidden in 3D view and
reveal it only when the visitor clicks the board to open it full-screen:

  <main data-ancre="@AIR; right: 150; top: 50; z: 0;">
      <h1>Title visible in 3D</h1>
      <div class="cache">
          <p>Full article revealed when clicked.</p>
      </div>
  </main>

Styling Your Board (yourfile.css):
Create a .css file with the exact same name as your .php file. Write standard
CSS targeting main, h1, p, etc. Styles are automatically isolated to that
board only.


4. TELEPORTATION PORTALS (data-saut)
--------------------------------------------------------------------------------
To turn any board into a one-click teleportation portal to another room and
exact camera position, add data-saut:

  <main data-ancre="@AIR/1; right: 120; top: 60; z: 0;"
        data-saut="@AIR/22/3/6; top: 400; right: 900; z: 1200;">
      <h1>Jump to Room 22/3/6</h1>
  </main>

- data-saut MUST be unique: Never use ++ inside data-saut. One portal jumps to
  one exact destination.
- Clicking a board WITHOUT data-saut opens it in full-screen reading mode.
- Clicking a board WITH data-saut teleports the visitor immediately to the
  target folder and coordinates.


5. NAVIGATING THE COCKPIT (CONTROLS)
--------------------------------------------------------------------------------
- Arrow Keys / Screen Edge Arrows         : Move Left, Right, Up, Down (X / Y).
- Space / PageUp / Wheel / Z-Up Arrow     : Move forward into depth (-Z).
- Shift + Space / PageDown / Wheel        : Move backward (+Z).
- Esc or Red Return Button                : Exit full-screen back to 3D space.
- "0, 0, 1500" Button                     : Reset camera to starting viewpoint.
- "0, 0, 1" Button                        : Jump right in front of origin (0,0,0).
- "EMBRAYAGE : OFF / ON" Button           : Toggle step snapping vs. smooth flight.


================================================================================
PHENARIUM — GUIDE DU WEBMESTRE (v3.0.0)
================================================================================

1. INSTALLATION (OÙ METTRE LA CLÉ)
--------------------------------------------------------------------------------
1. Déposez l'intégralité de l'archive à la racine de votre serveur web (ou dans
   un sous-dossier).
2. Prérequis : PHP 8.0+ (aucune base de données requise, aucun outil de
   compilation, aucune dépendance).
3. Ouvrez votre site dans un navigateur (https://votredomaine.com/). Vous êtes
   face à la matrice racine : AIR.


2. STRUCTURE DES DOSSIERS (COMMENT FONCTIONNENT LES CHAMBRES)
--------------------------------------------------------------------------------
Tout votre contenu se place dans /SOL/AIR/.

  /SOL/AIR/          -> Espace racine (?air=AIR ou /)
  /SOL/AIR/1/        -> Chambre 1 (?air=1)
  /SOL/AIR/22/3/6/   -> Chambre imbriquée (?air=22/3/6)

Règle stricte de nommage :
- Les noms des sous-dossiers dans /SOL/AIR/ doivent être uniquement des nombres
  entiers (0-9), par exemple : 1, 42, 86, 974.
- N'utilisez jamais de lettres, d'espaces ou de symboles dans les noms de
  dossiers.
- Chaque dossier affiche uniquement les fichiers .php déposés directement à
  l'intérieur. Les dossiers vides restent totalement en dormance.


3. CRÉER UNE PLANCHE (PLACER DU CONTENU DANS L'ESPACE 3D)
--------------------------------------------------------------------------------
Une planche est un fichier .php déposé dans un dossier (ex. /SOL/AIR/bienvenue.php),
accompagné si besoin d'un fichier .css portant exactement le même nom
(/SOL/AIR/bienvenue.css).

Toute planche DOIT commencer par une balise unique <main> portant l'attribut
data-ancre :

  <main data-ancre="@AIR; right: 0; top: 0; z: 0;">
      <h1>Bienvenue</h1>
      <p>Cette planche est posée au centre de AIR.</p>
  </main>

Grammaire des coordonnées (data-ancre) :
Chaque adresse exige 4 champs séparés par des points-virgules :

  @MATRICE; HORIZONTAL; VERTICAL; PROFONDEUR;

  - @MATRICE   : @AIR ou @AIR/x/y/z (doit correspondre au chemin du dossier).
  - Horizontal : left: 250;  OU  right: 250;
  - Vertical   : top: 100;   OU  bottom: 100;
  - Profondeur : z: 0; (obligatoire — positif = plus proche, négatif = profond).

Positions multiples dans une même chambre (++) :
Vous pouvez afficher exactement la même planche à plusieurs endroits d'un même
dossier grâce à ++ :

  <main data-ancre="@AIR/4/3; left: 200; top: 100; z: 0; ++ @AIR/4/3; right: 200; bottom: 100; z: -300;">
      <h1>Planche jumelle</h1>
  </main>

Masquer du contenu jusqu'au clic (.cache) :
Ajoutez class="cache" à n'importe quel élément à l'intérieur de <main> pour le
garder invisible dans la vue 3D et ne le révéler que lorsque le visiteur clique
sur la planche pour l'ouvrir en plein écran :

  <main data-ancre="@AIR; right: 150; top: 50; z: 0;">
      <h1>Titre visible en 3D</h1>
      <div class="cache">
          <p>Article complet révélé au clic.</p>
      </div>
  </main>

Styliser votre planche (votrefichier.css) :
Créez un fichier .css portant exactement le même nom que votre .php. Écrivez du
CSS standard ciblant main, h1, p, etc. Les styles sont automatiquement isolés à
cette seule planche.


4. PORTAILS DE TÉLÉPORTATION (data-saut)
--------------------------------------------------------------------------------
Pour transformer une planche en portail de téléportation instantanée vers une
autre chambre et des coordonnées exactes, ajoutez data-saut :

  <main data-ancre="@AIR/1; right: 120; top: 60; z: 0;"
        data-saut="@AIR/22/3/6; top: 400; right: 900; z: 1200;">
      <h1>Sauter vers la chambre 22/3/6</h1>
  </main>

- data-saut est OBLIGATOIREMENT unique : N'utilisez jamais ++ dans data-saut.
  Un portail saute vers une seule destination précise.
- Cliquer sur une planche SANS data-saut l'ouvre en mode lecture plein écran.
- Cliquer sur une planche AVEC data-saut téléporte immédiatement le visiteur
  vers le dossier et les coordonnées cibles.


5. PILOTER LE COCKPIT (COMMANDES)
--------------------------------------------------------------------------------
- Flèches clavier / Flèches aux bords de l'écran : Déplacement Gauche, Droite,
                                                   Haut, Bas (X / Y).
- Espace / PageUp / Molette / Flèches Z en bas   : Avancer dans la profondeur (-Z).
- Shift + Espace / PageDown / Molette            : Reculer vers la surface (+Z).
- Échap ou Bouton Rouge Retour                   : Quitter le plein écran vers 3D.
- Bouton "0, 0, 1500"                            : Revenir au point de départ.
- Bouton "0, 0, 1"                               : Se placer devant l'origine (0,0,0).
- Bouton "EMBRAYAGE : OFF / ON"                  : Basculer paliers précis / vol fluide.
================================================================================