Skip to content

Script shell pour sauvegarder vos pads publics préférés, des instances d'étherpad, automatiquement ! etherpad-backups is a shell script that backup your favorite public pads, from etherpad instances, automatically !

License

Notifications You must be signed in to change notification settings

pouek/etherpad-backups

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

76 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

etherpad-backups

Script Shell pour sauvegarder vos pads publics préférés, d'une ou plusieurs instances d'etherpad, automatiquement !

English read-me below.

Caractéristiques

Il peut être utilisé par n'importe qui, c'est-à-dire sans droits d'administration ou identifiants, pour archiver (régulièrement ou non) vos pads préférés. Le nom du fichier sauvegardé est fait du nom du pad suivi de la date. Cela vous permet de suivre l'évolution de vos pads. Pour préserver l'espace disque, il remplacera, quand ils sont les mêmes, le pad téléchargé par un lien vers le précédent. Plusieurs pads de plusieurs serveurs dans un seul lancement de script. Fichier config.txt (optionnel) pour stocker vos paramètres et les rendre facilement accessibles et modifiables. Exemples de serveurs etherpad, vous pouvez télécharger avec cet outil à partir de : https://framapad.org et ses sous-domaines annuel, mensuel, ... Plus d'instances listées sur chatons.org en cherchant par services et en sélectionnant text-processor

Installer

Cliquer ici pour télécharger zip. L'extraire, le lancer, profiter !

Utilisation

Modifier le script avec tous vos paramètres : filetype à télécharger : "odt" ou "pdf" Nom d'utilisateur, obligatoire si script a commencé par cron/anacron Dossier de téléchargement Les serveurs à télécharger, et pour chaque serveur... Les noms de Pads pour le télécharger depuis Lancer le script avec

chmod u+x etherpad-backups.sh

Mettre à jour manuellement les pads, donc ponctuellement. Note : le paramètre manuel peut être modifié au choix, c'est une option pour aider à suivre les effectuées.

./etherpad-backups.sh manuel

ou

/chemin/complet/vers/etherpad-backups.sh manuel

Ajouter les scripts à cron pour activer les sauvegardes automatiques définies dans le script ou le fichier config.txt .

Installer Anacrontab dans votre système, pour qu'il sauvegarde aussi le jour suivant où s'allumera le pc, s'il ne l'était pas le jour où cron était supposé faire la sauvegarde.

Exemple de fichier à placer à /etc/cron.weekly/pad ou /etc/cron.monthly/pad.

Code minimal :

#!/bin/bash
/bin/bash /home/path/to/etherpad-backups.sh automatique

Plus de détails

Le code est documenté, lis le ;)

À faire

  • ajouter la connexion au serveur avec utilisateur:motdepasse pour les pads privés ?

English read-me

Shell script to backup your favorite public pads, from etherpad instances, automagically !

Features

  • It can be used by anyone, i.e. without admin rights or any logins, to archive (regularly or not) your favorite pads.
  • The file's name is made of the pad's name followed by the date. This allows you to keep track of the evolution of your pads.
  • To preserve disk space, it will replace the downloaded pad by a link to the previous one, when they are the same.
  • Multiple pads from multiple servers in one script launch.
  • Optionnal config.txt file to store your parameters and make it easily accessible and editable.
  • Examples of etherpad servers, so you know where you can download with this tool from :

Install

Usage

  • Edit the script with all your settings :
    • Filetype to download : "odt" or "pdf"
    • Username, mandatory if script started by cron/anacron
    • Download folder path
    • Servers to download from, and for each server...
    • Pads names to download it from
  • Make the script executable with
    chmod u+x etherpad-backups.sh
    
  • To backup from different servers, create one more script for each one
  • Manually update your pads when you need with : Note : the manual parameter can be what you want, it is an option to help track which backups were made and when
./etherpad-backups.sh manual

or

/full/path/to/etherpad-backups.sh manual

Add the script(s) to your cron to enable automatic backups of your etherpads

Install Anacrontab to your system, so it also backup the next day you power on your pc, in case you didn't the day cron was supposed to do the backup.

Example file to be placed at /etc/cron.weekly/pad or /etc/cron.monthly/pad.

Minimal code :

#!/bin/bash
/bin/bash /home/path/to/etherpad-backups.sh automatic

More details

The code is documented, read it ;)

To-do

  • add connection to server with login:password for private pads ?

About

Script shell pour sauvegarder vos pads publics préférés, des instances d'étherpad, automatiquement ! etherpad-backups is a shell script that backup your favorite public pads, from etherpad instances, automatically !

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages