From 091d6d508eb06beafd5eafe1a5b62ecabce99a8e Mon Sep 17 00:00:00 2001
From: David Beniamine <david.beniamine@tetras-libre.fr>
Date: Wed, 25 Oct 2017 16:42:19 +0200
Subject: [PATCH] Wip : doc onthe page

---
 src/www/discs.php  | 68 ++++++++++++++++++++++++++++------------------
 src/www/footer.php |  4 +--
 src/www/index.php  | 11 ++++++++
 src/www/log.php    |  3 +-
 4 files changed, 56 insertions(+), 30 deletions(-)

diff --git a/src/www/discs.php b/src/www/discs.php
index 9ad7338..83fef49 100644
--- a/src/www/discs.php
+++ b/src/www/discs.php
@@ -24,33 +24,18 @@
     $format = 'd-m-Y H:i:s';
     //var_dump($conf);
 ?>
-<h2> Disques </h2>
-<h3> Disques Connectés </h3>
-<div id='connected'>
-<div class="scroll">
-<table>
-<tr><th>Device</th><th>Identifiant unique</th><th>Actions</th></tr>
-
-<?php
-    //One line by connected entry
-    //add save button + text field that triggers tetras-back \-\-save uuid=name
-    foreach ($conf['CONNECTED'] as $uuid => $dev) :
-?>
-<tr><td><?php echo $dev ?></td><td><?php echo $uuid ?></td>
-<td>
-<form action="actions.php" method="post">
-<input type="hidden" name="uuid" value="<?php echo $uuid ?>">
-<input type="hidden" name="action" value="save">
-<input type="text"   name="name" placeholder="Entrez un nom">
-<input type="submit" value="Enregistrer">
-</form>
-</td>
-</tr>
-<?php endforeach ?>
-</table>
-</div>
-</div>
-<h3> Disques Connus </h3>
+<h2 id="disques"> Disques </h2>
+<h3 id="disques-connus"> Disques Connus </h3>
+<p>
+Voici la liste des disques connus avec l'état de la dernière sauvegarde
+effectuée dessus. À chaque fois qu'un de ces disques est connecté au serveur,
+une sauvegarde se déclenche automatiquement.  </p>
+<p>
+Pour qu'un disque apparaisse ici, il faut le connecter au serveur et l'enregistrer depuis la liste des disques <a href="#disques-connectes">connectés</a>.
+</p>
+<p>
+Si vous cliquez sur le bouton "Oublier", le disque oublié ne sera plus utilisé pour la sauvegarde mais aucun fichier ne sera supprimé.
+</p>
 <div id='known'>
 <div class="scroll">
 <table>
@@ -114,3 +99,32 @@ foreach ($conf['KNOWN'] as $uuid => $value) :
 </table>
 </div>
 </div>
+<h3 id="disques-connectes"> Disques Connectés </h3>
+<p>
+Dans cette section apparaissent tous les disques actuellement connectés à votre serveur.
+Afin d'effectuer des sauvegardes sur un disque, il faut l'enregistrer (cette action n'est nécessaire qu'une fois) en lui donnant un nom (par exemple DisqueA). Le disque apparaitra alors dans la <a href="#disques-connus">liste des disques connus</a>.
+</p>
+<div id='connected'>
+<div class="scroll">
+<table>
+<tr><th>Device</th><th>Identifiant unique</th><th>Actions</th></tr>
+
+<?php
+    //One line by connected entry
+    //add save button + text field that triggers tetras-back \-\-save uuid=name
+    foreach ($conf['CONNECTED'] as $uuid => $dev) :
+?>
+<tr><td><?php echo $dev ?></td><td><?php echo $uuid ?></td>
+<td>
+<form action="actions.php" method="post">
+<input type="hidden" name="uuid" value="<?php echo $uuid ?>">
+<input type="hidden" name="action" value="save">
+<input type="text"   name="name" placeholder="Entrez un nom">
+<input type="submit" value="Enregistrer">
+</form>
+</td>
+</tr>
+<?php endforeach ?>
+</table>
+</div>
+</div>
diff --git a/src/www/footer.php b/src/www/footer.php
index 44931d1..489949b 100644
--- a/src/www/footer.php
+++ b/src/www/footer.php
@@ -1,9 +1,9 @@
 <div id="foot">
 <p>
-<a href="https://gitlab.tetras-libre.fr/tetras-libre/Tetras-back">Tetras-back</a> est un logiciel modulaire et configurable de sauvegarde sur disque dur externe conçus pour les solutions NoCloud de <a href="https://tetras-libre.fr">Tetras Libre</a> et <a href="https://demo-tic.org">Demo-TIC</a>.
+<a href="https://www.tetras-libre.fr/nos-projets#tetras-back">Tetras-back</a> est un logiciel modulaire et configurable de sauvegarde sur disque dur externe conçus pour les solutions NoCloud de <a href="https://tetras-libre.fr">Tetras Libre</a> et <a href="https://demo-tic.org">Demo-TIC</a>.
 </p>
 <p>
-<a href="https://gitlab.tetras-libre.fr/tetras-libre/Tetras-back">Tetras-back</a> a été développé par David Beniamine avec l'aide de Felix Coudurier et Sebastien Curt pour Tetras Libre et est distribué sous la licence libre <a href="https://www.gnu.org/licenses/gpl-3.0.txt">GPL V3.0</a>.
+Tetras-back a été développé par David Beniamine avec l'aide de Felix Coudurier et Sebastien Curt pour Tetras Libre et est distribué sous la licence libre <a href="https://www.gnu.org/licenses/gpl-3.0.txt">GPL V3.0</a>, vous trouverez les sources <a href="https://gitlab.tetras-libre.fr/tetras-libre/Tetras-back">ici</a>.
 </p>
 <p>
 Copyright 2017 <a href="https://tetras-libre.fr">Tetras Libre</a>.
diff --git a/src/www/index.php b/src/www/index.php
index 30ce91f..e9d9ac6 100644
--- a/src/www/index.php
+++ b/src/www/index.php
@@ -11,6 +11,17 @@
 <div id="box">
 <div id="content">
 <?php include("header.php") ?>
+<p> Bienvenue sur la page de gestion des disques de Tetras-Back</p>
+<p> Sur cette page vous pouvez :
+<ul>
+<li> Voir les disques connectés à votre serveur</li>
+<li> Enregistrer des disques pour effectuer des sauvegardes dessus</li>
+<li> Voir l'état de la denière sauvegarde sur chaque disque connu </li>
+<li> Déclencher manuellement des sauvegardes </li>
+<li> Dé-enregistrer un disque de sauvegarde </li>
+<li> Voir l'historique (log) du système de sauvegarde </li>
+</ul>
+</p>
 <div id="discs">
     <?php require './discs.php'; ?>
 </div>
diff --git a/src/www/log.php b/src/www/log.php
index 3f310ab..e95d466 100644
--- a/src/www/log.php
+++ b/src/www/log.php
@@ -21,7 +21,8 @@
     $output = file('/var/log/tetras-back/main.log');
     $lines = array_reverse($output);
 ?>
-<h2> Logs </h2>
+<h2 id="logs"> Logs </h2>
+Voici l'historique (log) de la sauvegarde, cela vous permet de suivre l'avancé de la sauvegarde ou en cas d'erreur de comprendre la nature du problème.
 <div class="scroll">
 <div id="log">
 <pre><code>
-- 
GitLab