Différences entre les versions de « Site web »

De VoWiki
Aller à la navigation Aller à la recherche
 
(58 versions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
== Liste des besoins ==
← [[Accueil]] ← [[Nos Projets]]


* communiquer les news avec le public (blog, facebook, twitter)
 
== É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
* communiquer les news avec les membres (galette)
* communiquer les news avec les membres (galette)
* documentation pour le public et les membres (wiki)
** infos administratives
** infos techniques
** demande d'aide
* [[#Documentation publique (wiki)|documentation pour le public et les membres : tutoriels, retours d'expérience, etc. (wiki)]]
* documentation des projets centralisée et uniforme (wiki)
* documentation des projets centralisée et uniforme (wiki)
* référentiel pour le code source et la CAD (voir la documentation) (github)
* référentiel pour le code source et la CAD (et dans certain cas pour la documentation) (github)
* agenda partagé (est-ce vraiment utile ?)
* agenda partagé pour les membres et le public (est-ce vraiment utile ?)
* partage de fichiers (pydio)
* partage de fichiers entre membres (pydio)
* gérer les inscriptions aux formations (www.eventbrite.fr)
 


== TODO list ==
== 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, fichiers de CAD, 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*
* pinterest
* 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 à éviter:
* word/exel : ce ne sont pas des formats ouverts, préférer par exemple libreoffice ou openoffice
 
 
== TODO list et propositions ==


* revoir les menus du blog
* revoir les menus du blog
** Projets -> vers http://www.vorobotics.com/wiki/index.php?title=Nos_Projets
** ajouter "Projets" (vers http://www.vorobotics.com/wiki/index.php?title=Nos_Projets)
** Documentation -> vers http://www.vorobotics.com/wiki/index.php?title=Documentation
** ajouter "Documentation" (vers http://www.vorobotics.com/wiki/index.php?title=Documentation)
** Supprimer "Résumés des Séances" et "Nos réalisations"
** supprimer "Résumés des Séances" et "Nos réalisations"
** "Association VOROBOTICS" -> ?
** "Association VOROBOTICS" -> ?
** "Le Projet VoLab" -> "Le VoLab"
** "Le Projet VoLab" -> "Le VoLab"
* écrire et installer les scripts de conversion automatique ODT/Rst/Latex/... -> Wiki/PDF
* déplacer la documentation des projets VoR ... vers le wiki (centralisation de la documentation) ?
* [[#Documentation publique (wiki)|é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
* écrire et installer des scripts de sauvegarde automatique du blog et du wiki
* compléter et uniformiser le wiki
* compléter et uniformiser le wiki
* revoir la charte graphique et les thèmes du blog et du wiki
* revoir la charte graphique et les thèmes du blog et du wiki
* utiliser l'extension MediaWiki "VisualEditor" pour inciter les membres à contribuer au wiki
** https://www.mediawiki.org/wiki/Extension:VisualEditor
** https://www.mediawiki.org/wiki/VisualEditor
** https://en.wikipedia.org/wiki/VisualEditor
* faire des mises à jours plus régulières des services (principalement mediawiki, wordpress étant automatiquement mis à jours)
* ajouter sur la page d'accueil une page "Nos actions" (trouver un meilleur titre ?) pour présenter/lister nos actions publiques :
** salons auxquels nous avons participé (fête de la science, etc.)
** interventions auprès des établissements d'enseignement ("TAP", ...)
** nos partenariats avec des établissements publiques (Eragny, Visage du monde, ...)
** échanges avec d'autres associations (CIF, ...) / Fablabs
** ateliers de formation ouverts au public / aux écoles
** participation à la vie économique locale (?)
** etc.
** Cette page serait notamment utile pour valoriser le rôle de l'asso auprès des élus locaux.
== Documentation publique (wiki) ==
[[Fichier:Organisation_documenatation_wiki_odt_rst_latex.png|800px]]
=== 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).
<!--
=== Conversion Markdown vers PDF et HTML ===
...
=== Conversion LaTeX vers PDF et HTML ===
...
-->
=== 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
#...
Tous ces scripts sont disponibles sur le référentiel Git suivant : https://github.com/volab/vor-doctools
=== Écriture des liens dans le wiki ===
Écrire les liens comme suit dans le "wikicode":
<nowiki>* [http://volab.vorobotics.com/docs/nom_du_fichier.html Titre du document] (version [http://volab.vorobotics.com/docs/nom_du_fichier.pdf PDF])</nowiki>

Version actuelle datée du 15 novembre 2015 à 15:58

AccueilNos 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
  • communiquer les news avec les membres (galette)
    • infos administratives
    • infos techniques
    • demande d'aide
  • documentation pour le public et les membres : tutoriels, retours d'expérience, etc. (wiki)
  • documentation des projets centralisée et uniforme (wiki)
  • référentiel pour le code source et la CAD (et dans certain cas pour la documentation) (github)
  • agenda partagé pour les membres et le public (est-ce vraiment utile ?)
  • partage de fichiers entre membres (pydio)
  • gérer les inscriptions aux formations (www.eventbrite.fr)


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, fichiers de CAD, 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)
  • twitter
  • facebook
  • google+
  • diaspora*
  • pinterest
  • 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 à éviter:

  • word/exel : ce ne sont pas des formats ouverts, préférer par exemple libreoffice ou openoffice


TODO list et propositions


Documentation publique (wiki)

Organisation documenatation wiki odt rst latex.png

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
#...

Tous ces scripts sont disponibles sur le référentiel Git suivant : https://github.com/volab/vor-doctools

Écriture des liens dans le wiki

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

* [http://volab.vorobotics.com/docs/nom_du_fichier.html Titre du document] (version [http://volab.vorobotics.com/docs/nom_du_fichier.pdf PDF])