Logo Khaganat
Traductions de cette page?:

Ceci est une ancienne révision du document !


Pad

Pour écrire un texte à plusieurs mains, relire ensemble, voir les corrections quand elles sont faites, les “pad” sont très pratiques. Ce sont des éditeurs de texte, en ligne, collaboratif.

Nous hébergeons un de ces outil, basé sur Etherpad. Il se situe ici : https://khaganat.net/pad.

Vous pouvez aussi utiliser d'autres pads sur la toile, par exemple framapad, piratepad, sync.in, braindead.

Usage d'un pad

Un pad est utile dans la phase “brainstorming” avec une équipe, quand on note tout ce qui nous passe par la tête, ou pour finaliser un texte et corriger les virgules à plusieurs.

Un pad n'est pas utile si on est seul à écrire dessus. Dans ce cas, faites une ébauche d'article sur wiki, qui est aussi un éditeur de texte collaboratif, mais avec une collaboration “en différé”.

Un pad sert à des infos volatiles. En plus simple : c'est du temporaire, pas de l'archivage. Donc archivez ailleurs ! Les wikis sont parfaitement appropriés pour ça, d'autant plus qu'ils ont une fonction de recherche très performante.

Un pad n'est pas un forum ou un chat. Si une phrase ou une formulation demandent à être discutées, discutez-en dans le chat, c'est plus lisible, puis corrigez. Ou corrigez et ne discutez pas ; il y a un historique pour revenir en arrière en cas de souci.

Lorsque le texte est à exporter, ne faites surtout pas un copier-collé ! Cela ajoute des espaces partout. C'est un bug et c'est comme ça… Pour avoir le texte sans espaces en plus, sélectionnez en haut à droite l'option “exporter le texte”, puis choisissez le format (texte brut par exemple).

Le pad de Khaganat et ses fonctionnalités

Fonctionnalités propres à notre pad

Il est possible d'ajouter des fonctionnalités aux pads, via des plugins. Voici ceux qui sont installés chez nous, et les choses utiles à connaître à leur propos :

  • adminpads : permet de lister et de gérer tous les pads sur le serveur. Si vous avez un pad public que vous souhaitez voir complètement disparaître (y compris au niveau de l'historique), contactez un administrateur. Tant qu'il n'y a pas trop de pad, cela peut aussi permettre de retrouver celui qu'on avait oublié.
  • comments_page : pour ajouter des commentaires sur un bout du texte, en surlignant ce dernier. On peut aussi suggérer autre chose. À utiliser avec parcimonie.
  • font_size pour changer la taille de la police.
  • margin pour aligner le texte à gauche, à droite ou au centre.
  • reference : ouvre, dans une colonne à droite, un espace où appeler un second pad. On peut alors sélectionner des bouts de son texte pour les “citer” sur le premier pad, et mettre un lien rapide vers ce pad. Utile pour lier plusieurs pads entre eux. La fenêtre de “reference” s'ouvre à partir des paramètres.
  • themes : modifie le visuel des pads, afin de s'adapter entre autre à certains problèmes de vision (thème très contrasté). Si vous souhaitez un thème particulier, venez nous en parler, nous proposer des accords de couleurs, nous le mettront en place.
  • user_pad et user_pad_frontend : permet la gestion des comptes perso, donc des pads privés, ainsi que des groupes y ayant accès. Si vous souhaitez créer un pad que vous seul et les gens que vous choisirez pourrez lire, utilisez cette option.

Page d'accueil des pads, où vous pouvez choisir de vous identifier et ainsi d'avoir des pads privés.

Installer un pad

Le plus simple est de suivre le tutoriel de framapad, très bien fait.

Il manque juste de quoi le lancer automatiquement :

Créez le fichier suivant dans /etc/init.d/etherpad

etherpad
#!/bin/sh
 
### BEGIN INIT INFO
# Provides:          etherpad-lite
# Required-Start:    $local_fs $remote_fs $network $syslog
# Required-Stop:     $local_fs $remote_fs $network $syslog
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: starts etherpad lite
# Description:       starts etherpad lite using start-stop-daemon
### END INIT INFO
 
PATH="/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin"
LOGFILE="/home/etherpad/etherpad-lite/etherpad-lite.log"
EPLITE_DIR="/home/etherpad/etherpad-lite"
EPLITE_BIN="bin/runSafe.sh"
USER="etherpad"
GROUP="etherpad"
DESC="Etherpad Lite"
NAME="etherpad-lite"
 
set -e
 
. /lib/lsb/init-functions
 
start() {
  echo "Starting $DESC... "
 
    start-stop-daemon --start --chuid "$USER:$GROUP" --background --make-pidfile --pidfile /var/run/$NAME.pid --exec $EPLITE_DIR/$EPLITE_BIN -- $LOGFILE || true
  echo "done"
}
# Nous avons besoin de cette fonction pour assurer la totalité du processus lorsqu'il sera tué
killtree() {
    local _pid=$1
    local _sig=${2-TERM}
    for _child in $(ps -o pid --no-headers --ppid ${_pid}); do
        killtree ${_child} ${_sig}
    done
    kill -${_sig} ${_pid}
}
 
stop() {
  echo "Stopping $DESC... "
   while test -d /proc/$(cat /var/run/$NAME.pid); do
    killtree $(cat /var/run/$NAME.pid) 15
    sleep 0.5
  done
  rm /var/run/$NAME.pid
  echo "done"
}
status() {
status_of_proc -p /var/run/$NAME.pid "" "etherpad-lite" && exit 0 || exit $?
}
case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
status)
status
;;
*)
echo "Usage: $NAME {start|stop|restart|status}" >&2
exit 1
;;
esac
 
exit 0

Rendre ce fichier exécutable, l'ajouter au lancement automatique puis le lancer

chmod u+x /etc/init.d/etherpad
ln -s /etc/init.d/etherpad /usr/share/etherpad
update-rc.d etherpad defaults
service etherpad start

Attendre un peu… le temps que ça démarre… Et hop, ça devrait être bon !

CC Attribution-Share Alike 4.0 International Driven by DokuWiki
fr/pad.1455227700.txt.gz · Dernière modification : (modification externe)

Licences Mentions légales Accueil du site Contact Inclusion