====== Scénario ======
Besoin d'un outil pour partager des liens facilement et parcourir sa veille, fonctionnalités recherchées:
  * flux RSS ;
  * étiquettes (tag) ;
  * application mobile ;
  * communauté (pérennité) ;
  * facilité d'utilisation ;
  * déployable sur un mutualisé, en PHP donc.
====== Ressources ======
  * [[https://github.com/shaarli/Shaarli|Le projet]]
  * [[https://github.com/shaarli/Shaarli/releases|Binaires]]
  * [[https://shaarli.readthedocs.io/en/master/|Documentation]]
  * [[https://f-droid.org/packages/com.dimtion.shaarlier/|Client Android]]
  * [[https://github.com/dimtion/Shaarlier/releases|Binaires du projet client Android]]
  * [[https://addons.mozilla.org/fr/firefox/addon/web-extension-for-shaarli/?src=search|extension Firefox]]
====== Installation ======
Via FTP, nous téléversons l'archive décompressée <color #ff7f27>shaarli-vVERSION-full</color>.\\
Ouvrir la page correspondante au dossier envoyé, suivre les instructions.\\
Et c'est tout.
===== Mise à jour =====
  - Sauvegarder le répertoire <color #ff7f27>data</color>
  - renommer le dossier de l'actuel shaarli sur le serveur
  - [[https://github.com/shaarli/Shaarli/releases|Télécharger]] la nouvelle version et l'uploader sur le serveur
  - injecter le répertoire <color #ff7f27>data</color> sauvegardé dans le nouveau shaarli
  - renommer le nouveau dossier comme l'ancien
  - se connecter à son instance, vérifier que tout va bien:
    * si nécessaire synchroniser les Thumbnails
    * vérifier connecteurs API (addon navigateur, mobile, ...)
  - supprimer l'ancien dossier

====== Personnalisation ======
===== Apparence générale =====
La [[http://shaarli.readthedocs.io/en/master/Theming/#custom-css|documentation]] spécifie que nous pouvons changer l'apparence de Shaarli via CSS ou en créant un template.\\
Mes changements de styles:
<sxh css;title:data/user.css>
/* couleur turquoise > vert */
.pure-alert-success { background-color: #008000; }
.shaarli-menu { background: #008000; }
#search-linklist button { background-color: #008000; }
#search-linklist button { background-color: #008000; }
.subheader-form { background: #008000; }
.subheader-form input[type="submit"] { background: #008000; }
.subheader-form input[type="submit"]:hover { color: #008000; }
.linklist-filters .filter-on { background: #008000; }
.linklist-item-title .linklist-link { color: #008000; }
.linklist-item-description a { color: #008000; }
.page-form .window-title { color: #008000 }
.page-form input[type="submit"], .page-form a.button { background: #008000; }
.tools-item .pure-button:hover { background-color: #008000; }
#taglist .validate-rename-tag { color: #008000; }
.daily-entry-description a { color: #008000; }
.pure-button-shaarli { background-color: #008000; }
</sxh>
===== Template d'export =====
Pour modifier la mise en forme de l'export de la BDD:
<sxh html;title:tpl/default/export.bookmarks.html>
<!DOCTYPE NETSCAPE-Bookmark-file-1>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
<!-- This is an automatically generated file.
     It will be read and overwritten.
     Do Not Edit! -->{ignore}The RainTPL loop is formatted to avoid generating extra newlines{/ignore}
<TITLE>{$pagetitle}</TITLE>
<H1>Shaarli export of {$selection} bookmarks on {$date}</H1>
<DL><p>{loop="links"}
<DT><br />
<DT>{$value.taglist}
<DT><A HREF="{$value.url}" ADD_DATE="{$value.timestamp}" PRIVATE="{$value.private}">{$value.title}</A>{if="$value.description"}{$eol}<DD>{$value.description}{/if}{/loop}
</DL><p>
</sxh>
Ce qui donnera en rendu:
<sxh>
connaissance,man,GNU/Linux,debian 
inetdoc.net
    Des tas d'antisèches. 

debian,sécurité,systeme,man
40 Linux Server Hardening Security Tips [2017 edition] - nixCraft

société,monnaie,communs
SYLHA - Réseau monétique social et solidaire - Pièce Connectée
</sxh>