[Tutoriel] Customiser FramaKiosk (suite)

[pyg]

Editer les pages internes de FramaKiosk
---------------------------------------------------------------
Rappels :
Ce tutoriel fait suite à celui de detruc : http://forum.framasoft.org/viewtopic.php?t=14448

FramaKiosk est le nom de l'application se lançant à la suite d'un double clic sur start.exe et qui affiche, au sein d'une fenêtre style "CD-ROM", les applications accessibles sur la clef ainsi que leurs pages de présentation (et d'autres pages de contenus).

Le Kiosk est en fait un simple profil Firefox modifié afin de ne faire apparaître le contenu (HTML et Javascript) dans une interface minimaliste : pas d'actions superflues au clic droit, pas de barre d'outils, etc.

Kiosk nécéssite un navigateur gecko pour fonctionner (dans le cas de la FramaKey 1.5, il s'agit de portableFirefox, situé dans le répertoire /Apps/portableFirefox).

Kiosk est lancé par start.exe/ini, qui execute /Framakey/FramaKiosk/FramaKiosk.exe, qui se base alors sur /Framakey/FramaKiosk/FramaKiosk.ini pour executer /Apps/portablefirefox/portablefirefox.exe avec le profil /Framakey/FramaKiosk/FramaKioskprofile et la page par défaut /Framakey/FramaKiosk/FramaKioskPages/index.html (faut suivre, hein ?
)

Le contenu affiché par FramaKiosk se trouve donc dans le dossier /Framakey/FramaKiosk/FramaKioskPages.

Celui ci se divise en 2 parties :
1- la page d'accueil (en fait une simple page HTML)
2- les pages internes de contenu (en fait une version modifiée de TiddlyWiki)

Pour la procédure de modification de la page d'accueil, vous pouvez vous référer à ces tutoriels : ici et là (parfois HS)

Pour la procédure de modification des pages internes, suivez les intructions suivantes (attention des notions de HTML sont recquises).

Modification des pages internes de FramaKiosk.
_________________________________________
Tout le contenu de ces pages est en fait rassemblé dans un seul fichier :
/Framakey/FramaKiosk/FramaKioskPages/infos.html

1-Activer les actions des facilités de modifications
Pour cela, éditez le fichier
/Framakey/FramaKiosk/FramaKioskPages/infos.html (par exemple avec
SciTe ) et changez la ligne 41 :

Code: Tout sélectionner

<script src="js/infos.js" type="text/javascript" />

qui devient

Code: Tout sélectionner

<script src="js/infos_modif.js" type="text/javascript" />

Sauvegardez le fichier.

2- ouverture dans Firefox
Ouvrez alors ce fichier dans Firefox (ou portableFirefox), mais si vous faites des modifications directement avec FramaKiosk, celles ci ne seront pas sauvegardées.
Si vous cliquez sur un lien dans le menu (par exemple Thunderbird), puis placez la ouris sur le texte décrivant le logiciel, vous voyez apparaitre un nouveau bouton "Editer" en haut à droite !

3- Modification du contenu
3.1- Edition du contenu existant
Il vous suffit tout simplement de cliquer sur le bouton "Editer" d'une fiche pour en modifier le contenu. Pour les règles de formatage, nous
vous renvoyons versle site de TiddlyWiki (attention cependant, certaines balises wiki peuvent ne pas fonctionner dans FramaKiosk, du
fait d'un décalage de version). Cliquez simplement sur "Done" une fois vos modifications terminées.

3.2- Edition/modification de tags - Edition du menu Rubriques
Vous pouvez, sous le cadre du texte, ajouter des tags à celui-ci (inutile pour les logiciels).
Séparez les tags par des espaces. Attention, un bug d'encodage UTF-8 dans TiddlyWiki peut poser problème si vous utilisez des tags
accentués. Donc, évitez les accents dans vos tags !
Les tags apparîtront directement dans le menu de gauche (classés de façon décroissante par le nombre d'articles par tag)

3.3- Suppression d'un article.
Une fois l'article affiché, cliquez simplement sur le bouton "Delete"
Il est toutefois recommandé de faire ensuite une recherche sur le nom de la page supprimée afin de vérifier si des pages n'y faisaient pas
référence.

3.4- Création d'un article.
Avant tout, il est conseillé de cliquer sur "Fermer" de façon à clore les articles précédemment ouvert et qui pourraient poser un bug à
l'affichage.

Ensuite, 2 solutions :
a- à partir d'un article existant, vous créez un mot Wiki (exemple : MotWiki) ou un lien libre (exemple : [[lien libre]]), puis apres avoir
sauvegardé ("Done"), vous cliquez sur le lien en italique, qui vous mènera à la nouvelle page à éditer

b- ajoutez, dans l'url firefox : ?xxx#NomDeLaPage
où xxx représente une chaine de caractère unique (afin de feinter le cache de firefox) et NomDeLaPage, le nom de la page/article à créer.
Par exemple :
file:///E:/projets/fk_1.5.0.2/Framakey/FramaKiosk/FramaKioskPages/infos.html?124#ToTo
me permet de créer une nouvelle page "ToTo"
NB: si vous voulez créez une page sans mot wiki, vous devrez alors utiliser une URL de la forme
file:///E:/projets/fk_1.5.0.2/Framakey/FramaKiosk/FramaKioskPages/infos.html?1245#[[ma superbe page]]

NB2: si la page ne semble pas se rafraichir, pensez à bien utiliser les caractères suivant le "?" et précédant le "#" afin d'éviter la mise en cache (mettez un nombre au hasard, par exemple)

Que vous ayez suivi la solution a) ou b) vous pouvez alors éditer la page et éventuellement lui adjoindre un ou plusieurs tags.

3.5- Edition du menu Logiciels
Accédez à l'article "MainMenu", en entrant directement son URL
file:///E:/projets/fk_1.5.0.2/Framakey/FramaKiosk/FramaKioskPages/infos.html?1824#MainMenu
(notez que, là encore, on utilise un identifiant au hasard pour éviter la mise en cache).
Faites vos modifications, sauvegardez.

4- lancer des executables
Framakiosk accepte un Mime Type nommé ".lch", qui permet le lancement d'executables sans message d'alerte.
Allez dans /Framakey/FramaKiosk/FramaKioskPages/lch et créez un nouveau fichier, par exemple audacity.lch
Editez ce fichier avec notepad ou SciTe et indiquez (par exemple) :
[Launch]
ExecuteFile=${cwd}\..\..\..\Apps\PortableAudacity\PortableAudacity.exe
Sauvegardez et ajoutez à votre article "Audacity" un lien libre du
type [[Audacity|lch/audacity.lch]].
Lorsque l'utilisateur cliquera sur le lien dans FramaKiosk, cela executera le logiciel (NB: j'ai dit dans FramaKiosk, pas dans Firefox
!). Pour des utilisations plus avancées des .lch, vous pouvez vous réferrer à ceux déjà existants.

5- Finitions
certaines modifications ne peuvent être faites qu'en éditant le fichier infos.html (pensez à l'ouvrir de nouveau dans SciTe ou autre,
afin d'éviter de perdre vos modifications en éditant un fichier préalablement ouvert dans SciTe, mais que vous auriez modifié dans
Firefox).

5.1- Entêtes
Modifiez le tableau d'en tête à votre convenance :

Code: Tout sélectionner

       <table cellpadding="2" width="100%">
       <tbody><tr>
       <td style="text-align: right;" width="80px"><img src="img/delta_g.png" alt="" width="80px" height="72px" /></td>
       <td style="text-align: center;" width="205px"><img src="img/entete.png" alt="" width="205px" height="72px" /></td>
       <td style="text-align: left;"  width="80px"><img src="img/usb_01.png" alt="" width="80px" height="75px" /></td>
       </tr></tbody>
       </table>

NB: il n'est pas conseillé d'utiliser de liens vers des articles dans les entêtes (toujours pour des problemes de cache).

5.2- modification du CSS
Le CSS se trouve dans
file:///E:/projets/fk_1.5.0.2/Framakey/FramaKiosk/FramaKioskPages/css/infos.css
A vous de l'adapter selon vos souhaits.

5.3- Suppression des dates de modifications
Par défaut, à chaque creation/modif d'article, le wiki lui attribue une date et une version de modification. Ainsi, dans infos.html, vous
trouverez des lignes telles que :
<div id="storeToTo" modified="200602170051" modifier="VersionBeta" tags="">Texte de la page ToTo</div>
Pour éviter l'affichage de ces données en rollover d'un lien, il vous suffit de les supprimer :
<div id="storeToTo" modified="" modifier="" tags="">Texte de la page ToTo</div>

5.4- Suppression des backups
Par défaut, le wiki crée systematiquement un fichier de backup à chaque modification.
Pour les voir ou les supprimer, rendez vous dans
file:///E:/projets/fk_1.5.0.2/Framakey/FramaKiosk/FramaKioskPages/backup
Etant donné le poid de ces pages, il est vivement conseillé de les supprimer une fois satisfait du résultat final.

5.5- désactivation des facilités de modifications
Une fois votre travail terminé, pensez bien à annuler l'étape 1 en éditant infos.html et en éditant sa ligne 41 pour remettre "infos.js" au lieu de "infos_modif.js" !

[detruc]

Salut pyg ! Parfais ce tuto. Juste un mot ==> le lien qui ramène vers le tuto << Normand >> ne fonctionne pas chez moi . Je crois qu'il est mort ? Sinon j'ai répondu à ta question concernant les licences ici.

[gregzz]

Bonjour,

Je ne parviens pas à faire une seconde page semblable à celle de Contenus, c'est-à-dire avec plusieurs onglets dedans. J'ai effectué une copie de la page, puis je l'ai renommé. Alors, j'obtiens la nouvelle page avec l'onglet mais je pense avoir un souci concernant le css car il m'affiche les autres pages en forme de puce. Plus précisement, il m'affiche bien la page puis dès que je vais sur l'onglet contenu et que je reviens sur l'onglet que je viens de créer, les pages s'affiche comme des puces et il n'y a plus aucun css actif.

Quelqu'un a-til la solution à ce problème?

[Invité]

Bonjour

Je bloque sur
Modification des pages internes de FramaKiosk.
Tout le contenu de ces pages est en fait rassemblé dans un seul fichier :
/Framakey/FramaKiosk/FramaKioskPages/infos.html


Je suis sous framakey 1.11.0.0 et je ne trouve aps ce fichier...

Je trouve bien complliqué d'ajouter des applis au framakiosque, qui est pourtat si beau!
Agnes