Introduction
Documentation
Téléchargement
Développement

Documentation utilisateur

Au lancement de l'application, une brève documentation indique les touches de raccourcis permettant d'atteindre les éléments importants pour charger un livre ainsi que pour naviguer dans le livre.

Raccourcis clavier

Les variations de vitesse préservent la hauteur (pitch) du son (étirement temporel).

Accueil et Lecture

Les photos d'écran ci-dessous (cliquez sur les images pour les agrandir) présentent le cadre d'accueil ainsi que le cadre du lecteur. L'accueil donne une brève description de DaisyDuck et surtout, donne la liste des raccourcis clavier. Le lecteur se résume en la liste des chapitres (sur la gauche) du livre chargé, quelques informations sur le livre (dont l'extrait), et les boutons pour naviguer dans le livre en bas à droite du cadre.

GUI Accueil

Cadre Accueil
GUI Lecteur

Cadre Lecteur

Livres en ligne

Pour accéder à la liste de livres en ligne, cliquez sur le bouton "Livres en ligne" depuis l'écran principal, ou pressez CTRL+L.

L'accès à une liste dépend du lien dans le champ "URI". Si la liste n'est pas directement disponible, une fenêtre "Entrées" contenant une liste de paramètres s'affiche (cette liste de paramètres peut être différente selon la configuration du logiciel). L'exemple ci-dessous (photo d'écran), montre cette fenêtre en attente d'un numéro d'utilisateur et d'un mot de passe. Bien entendu, si aucun lien n'est spécifié dans le champ "URI", la fenêtre "Entrées" n'est pas affichée.

GUI Livres en ligne

Accès aux livres en ligne

Documentation pour les utilisateurs avancés

La documentation avancée s'adresse uniquement au personnes qui désirent modifier manuellement le fichier de configuration ou de créer une liste de livres pour la lecture en ligne.

Fichier de configuration

Le fichier de configuration contient les paramètres généraux de DaisyDuck ainsi que les enregistrements automatiques des livres partiellement lus. En principe il n'est pas nécessaire de faire les modifications directement dans le fichier de configuration. Les paramètres généraux sont accessibles depuis le menu "Paramétrages".

Si vous désirez faire des modifications manuellement dans le fichier, celui-ci est localisé (selon le système d'exploitation), dans $HOME/.config/daisyduck/ sous GNU/Linux, et $APPDATA/daisyduck/ sous Windows.

La configuration se présente en tant que simple fichier XML : 

 <!DOCTYPE daisyduckcfg>
 <daisyduckcfg>
  <custom>
   <title>DaisyDuck Titre Accueil</title>
   <text>DaisyDuck Texte Accueil</text>
  </custom>
  <onlinebook>
   <uri>http://daisy.geexbox.org/daisyduck.php</uri>
   <uriparam>
    <param value="" name="username" label="Utilisateur" />
    <param value="" name="password" label="Mot de passe" />
   </uriparam>
  </onlinebook>
  <bookmark>
   <hash>c44b29a8406d8eba88c01d7da3eab1b4426f826b</hash>
   <position node="1" smil="8" />
  </bookmark>
  <bookmark>
   <hash>e7545d24635dd658bf08aa40ae7946fe2c1c64cc</hash>
   <position node="3" smil="25" />
  </bookmark>
  <bookmark>
   <hash>c0d38c60852b868dd7135a6523ae562e3c49a2df</hash>
   <position node="1" smil="3" />
  </bookmark>
 </daisyduckcfg>

Le contenu ci-dessus est un exemple factice. La balise <custom> doit être unique. Elle contient un titre et un texte personnalisé qui s'affiche sur le cadre d'accueil. La balise <onlinebook> doit également être unique. La balise <uri> permet de donner l'adresse sur la liste des livres en ligne. Les balises <param> dans <uriparam> sont des arguments arbitraires, utilisés pour créer la fenêtre "Entrées". Chacun d'eux est envoyé via la méthode POST (HTTP), au lien indiqué dans la balise <uri>. Notez bien que ces paramètres sont tous configurable depuis l'interface graphique de DaisyDuck.

Les balises <bookmark> concernent les lectures interrompues. En principe, il n'y a jamais besoin d'y apporter de modifications.

Fichier de liste de livres en ligne

Dans le fichier de configuration présenté précédemment, la liste pointe sur un fichier PHP. Bien entendu, ceci est complètement arbitraire. Il est tout à fait possible de pointer directement sur une page sans avoir le moindre paramètre dans la balise <uriparam>.

L'exemple suivant présente une telle liste avec deux livres. 

 <daisyduck version="1.0">
   <audiobook>
     <number>1</number>
     <title>Il était une fois Linux</title>
     <creator>Linus Torvalds, David Diamond</creator>
     <category>Autobiographie</category>
     <summary>
       « II y a aujourd'hui dix ans, un étudiant finlandais nommé Linus Torvalds s'enfermait plusieurs mois dans sa chambre, rideaux tirés, pour un long tête-à-tête avec son ordinateur. Le résultat : un nouveau système d'exploitation. Qu'allait-il en faire ? Le garder pour son usage personnel ? Le vendre à une société de logiciels ? Rien de tout cela. Linus décide de rendre le fruit de son travail librement accessible sur Internet en invitant toute personne intéressée à l'améliorer. L'UNIX libre de Linus, baptisé Linux, était né et avec lui, une nouvelle manière de concevoir les logiciels qui allait bouleverser l'univers de l'informatique. »
     </summary>
     <uri>http://daisy.geexbox.org/torvalds/ncc.html</uri>
   </audiobook>
   <audiobook>
     <number>2</number>
     <title>Richard Stallman et la révolution du logiciel libre</title>
     <creator>Richard Matthew Stallman, Sam Williams, Christophe Masutti</creator>
     <category>Biographie autorisée</category>
     <summary>
       « Chaque génération a son philosophe, écrivain ou artiste qui saisit et incarne l'imaginaire du moment. Il arrive que ces philosophes soient reconnus de leur vivant, mais le plus souvent il faut attendre que la patine du temps fasse son effet. Que cette reconnaissance soit immédiate ou différée, une époque est marquée par ces hommes qui expriment leurs idéaux, dans les murmures d'un poème ou dans le grondement d'un mouvement politique. Notre génération a un philosophe. Ce n'est ni un artiste ni un écrivain. C'est un informaticien. »
     </summary>
     <uri>http://daisy.geexbox.org/stallman/ncc.html</uri>
   </audiobook>
   <uriparam>
     <param name="Policy" value="foobar"/>
     <param name="Signature" value="foobar"/>
     <param name="Key-Pair-Id" value="fooid"/>
   </uriparam>
 </daisyduck>

Exemple interactif : http://daisy.schroetersa.ch/sample.php

Il n'y a pas de limite sur la quantité de livres. La balise <uriparam> doit exister une seule fois. Elle contient les arguments à utiliser en GET (HTTP) avec l'adresse des fichiers NCC (balise <uri>) et tous les fichiers formant le livre Daisy. Cette liste de paramètres est également arbitraire.