Site web

← Accueil ← Nos Projets

Étude des besoins

• communiquer les news avec le public (blog, facebook, twitter, RSS, Google+, Diaspora*, ...)
  • réalisations
  • articles et tutoriels
  • évènements
  • invitation aux séances de formations, etc.
• communiquer les news avec les membres (galette)
  • infos administratives
  • infos techniques
  • demande d'aide
• documentation pour le public et les membres (wiki)
• documentation des projets centralisée et uniforme (wiki)
• référentiel pour le code source et la CAD (voir la documentation) (github)
• agenda partagé public (est-ce vraiment utile ?)
• partage de fichiers entre membres (pydio)

Problèmes avec la configuration actuelle

• le wiki est utilisé comme CMS à sens unique
• le menu du blog est à refaire
• manque de dynamisme sur le wiki et le blog
• le forum est très peu utilisé
• ...

Outils, usages potentiels, forces et faiblesses

• blog
  • communication figée et chronologique
• cms
• wiki
  • documentation
  • sa liberté d'usage fait que ça peut vite devenir le chaos si on y prête pas attention...
• serveur de fichier interne
  • parfait pour échanger des binaires (exe, solidworks, fichiers STL/gcode/..., multimédia, open/libreoffice, word, ...)
• serveur FTP (vs Pydio) ?
• forum
• www.eventbrite.fr
  • pour gérer les inscriptions aux formations
• IRC
• calendrier comme google calendar (import/export ical)
  • http://webcalendar.sourceforge.net/
  • https://www.projet-plume.org/fiche/webcalendar
• twitter
• facebook
• google+
• diaspora
• google drive
  • préférer les framapad (etherpad) ou owncloud
• git / svn
  • pour le partage de code source et de documentation texte (latex, ReStructuredText, Markdown, Docbook, HTML, Troff, ...), a usage interne et/ou vers le publique
• https://framadate.org/ alternative à doodle
• owncloud
• blog statiques (fichiers Markdown + Git)

Les outils/formats à bannir:

• word/exel : ce ne sont pas des formats ouverts, utiliser libreoffice/openoffice

TODO list

• revoir les menus du blog
  • Ajouter "Projets" (vers http://www.vorobotics.com/wiki/index.php?title=Nos_Projets)
  • Ajouter "Documentation" (vers http://www.vorobotics.com/wiki/index.php?title=Documentation)
  • Supprimer "Résumés des Séances" et "Nos réalisations"
  • "Association VOROBOTICS" -> ?
  • "Le Projet VoLab" -> "Le VoLab"
• déplacer la documentation des projets VoR ... vers le wiki (centralisation de la documentation) ?
• écrire et installer les scripts de conversion automatique ODT/Rst/Latex/... -> Wiki/PDF
• écrire et installer des scripts de sauvegarde automatique du blog et du wiki
• compléter et uniformiser le wiki
• revoir la charte graphique et les thèmes du blog et du wiki
• mettre plus en avant les service web open source tels que https://degooglisons-internet.org/liste (http://framasoft.net/#topPgCloud)

Documentation publique (wiki)

Conversion ODT (openoffice/libreoffice) vers PDF et HTML

Conversion ODT vers PDF:

libreoffice --headless --convert-to pdf test.odt

Conversion ODT vers HTML (à améliorer : CSS personnalisé, etc.):

libreoffice --headless --convert-to html test.odt

Conversion ReStructuredText vers PDF et HTML

Cf. https://github.com/jdhp-misc/rst_jdhp_theme (en cours d'écriture).

Sphinx et readthedocs.org

...

Synchronisation des fichiers HTML et PDF générés depuis un serveur de fichier vers un serveur web

sync_files.sh:

#!/bin/sh

SRC_DIR=./          # Écrire ici le chemin vers le répertoire contenant les fichiers PDF et HTML à transférer sur le serveur web
DST_DIR=./          # Écrire ici le chemin vers le répertoire de données du serveur web

### CHECK COMMANDS ###

# command -v will return >0 when the $i is not found
command -v rsync >/dev/null && continue || { echo "rsync: command not found."; exit 1; }

### CHECK ARGS ###

if [ ! -d "$SRC_DIR" ] ; then echo "$SRC_DIR: directory not found." ; exit 1 ; fi
if [ ! -d "$DST_DIR" ] ; then echo "$DST_DIR: directory not found." ; exit 1 ; fi

### SYNC ###

echo "Synchronizing ${SRC_DIR} to ${DST_DIR}"
rsync -r -L -v -e ssh --delete ${SRC_DIR} ${DST_DIR}

Options utilisées pour rsync:

• -e ssh : utilise SSH
• -r : mode "récursif"
• -L : déréférence les liens
• -v : mode "verbeux"
• --delete : supprime de $DST les fichiers qui ont été supprimés de $SRC depuis la dernière synchronisation

Synchronisation des fichiers HTML et PDF générés depuis un référentiel Git vers un serveur web

...

Automatisation avec Cron

Éditer la liste des taches cron avec la commande suivante:

crontab -e

Par exemple, pour synchroniser les fichiers toutes les heures:

0 * * * * /absolute/path/to/convert_and_sync.sh

ou pour synchroniser les fichiers tous les jours à 4h du matin:

0 4 * * * /absolute/path/to/convert_and_sync.sh

avec convert_and_sync.sh:

#!/bin/sh

convert_files.sh && sync_files.sh

et convert_files.sh:

#!/bin/sh

SRC_DIR=./          # Écrire ici le chemin vers le répertoire contenant les fichiers source (ODT, ...)
DST_DIR=./          # Écrire ici le chemin vers le répertoire contenant les fichiers PDF et HTML générés

### CHECK COMMANDS ###

# command -v will return >0 when the $i is not found
command -v libreoffice >/dev/null && continue || { echo "sync_a_file: command not found."; exit 1; }

### CHECK ARGS ###

if [ ! -d "$SRC_DIR" ] ; then echo "$SRC_DIR: directory not found." ; exit 1 ; fi
if [ ! -d "$DST_DIR" ] ; then echo "$DST_DIR: directory not found." ; exit 1 ; fi

### CONVERT FILES ###

# ODT FILES
find ${SRC_DIR} -type f -iname "*.odt" -execdir libreoffice --headless --convert-to html --outdir ${DST_DIR} {} \;
find ${SRC_DIR} -type f -iname "*.odt" -execdir libreoffice --headless --convert-to pdf --outdir ${DST_DIR} {} \;

# RST FILES
#...

Écriture des liens dans le wiki

Écrire les liens comme suit dans le "wikicode":

* [http://www.tld/path/fichier.html Titre du document] (version [http://tld/path/fichier.pdf PDF])