Nous étions 20 à Vedène pour le sprint de décembre 2018 !

Résumé Sous le soleil, nous nous sommes retrouvés entre contributeurs à YesWiki pour un "sprint" de trois jours. L'occasion pour développeurs, utilisateurs, curieux.se de contribuer à leur niveau au projet :-)
Billet
image hs8kqjalz0fplarge.jpg (29.8kB)

Ce qui a été fait !

Mémoire

Retrouvez la mémoire détaillée de ce sprint via ce pad ou cet export Télécharger le fichier markdown..

Nouvelles fonctionnalités

  • Création d'une extension webhook (merci Sebastien). Elle permet d'envoyer automatiquement des informations à une adresse lorsqu'une fiche Bazar est ajoutée/éditée/supprimée. Ce mode de fonctionnement en "push" a de nombreux avantages, dont celui d'être plus écolo que les flux RSS. Une première intégration à Mattermost (Framateam) a été réalisée, qui permet de recevoir sur un canal, les notifications. Documentation
  • Création d'une image Docker et de documentations pour facilement lancer un wiki en local sans avoir à installer un serveur Apache/Mysql sur sa machine Documentation
  • Création d'une extension checkaccesslink (merci Olivier), qui conditionne la visibilité d'un lien dans les menus et pages, à son droit d'accès Par ici sur github
  • Affichage cartographique multicouches : test et documentation d'une fonctionnalité jusqu'alors invisible. par ici
  • Nouvelle possibilité de format de liens: il n'est plus par nécessaire de passer par des ChatMots pour générer des liens vers les pages (les noms de page ne nécessitent plus de comprendre deux majuscules).

Correction et remontée de bugs

  • corrections de bugs dans différents les templates bazar
  • mise en place de quelques tickets de dév ou corrections à faire sur yeswiki
  • cf l'activité des issues sur github pour voir l'ensemble des corrections effectuées

Documentation


Site et outils de communication

  • Cartographie de l'ancien site par ici pour voir
  • Refonte du site yeswiki.net (vous êtes dessus !)
  • Création d'un espace "gare centrale" dédié aux contributeurs actifs par ici pour voir
  • Dépoussiérage du site : suppression de 300 pages sur yeswiki.net, suppression de 1OO users de yeswiki.net
  • Création d'une page pour mutualiser nos ressources pédagogique (pour le moment en vrac) par ici pour voir
  • Formulaire de contact mail pour trouver un prestataire/une demande d'accompagnement que nous pouvons ensuite réorienter (envoi à contact@yeswiki.net) par ici pour voir

Réflexions / gouvernance

Sur la gare centrale :
  • Règles de prise de décision
  • Règles de contribution au code
  • Ferme yeswiki et responsabilité de la communauté vis à vis des espaces créés par les gens
  • Amorçage d'un groupe sur "pédagogie et yeswiki"

Reste à documenter

  • Les thèmes : mise en formerègles de production de thèmes pour les codeurs par ici
  • Cartographie de la partie "documentation" yeswiki
  • L'option "widget" pour intégrer le code d'intégration autre que carto
  • Chasse aux choses dépréciées : dans la documentation signaler avec une bannière les choses dépréciées et supprimer ce qui ne fonctionne plus.
  • Les emoticon intégrables dans le texte à partir de cette bibliothèque par simple copier-coller http://getemoji.com/

Sortie de la version Yeswiki Cercopitheque 2019-06-28-1

Résumé Une nouvelle version de Yeswiki est sortie. Elle améliore la sécurité, et propose des petites améliorations
Billet Pour savoir précisément les nouveautés, rendez vous sur la page Notes de version.
Vous pouvez mettre a jour par l'interface de mise a jour inclue dans Yeswiki, en allant en tant qu'admin par le bouton roue crantée, puis "Gestion du site", puis "Mises à jour / extensions".

Bonne mise à jour!

Yeswiki versus Wordpress / que répondre ?

Résumé On pose souvent la question "pourquoi utiliser Yeswiki plutôt que Wordpress ?"
Voici quelques pistes de réponses pour sortir de la logique de "classement" des outils. (work in progress ;-)
Billet Parfaitement compréhensible, cette question interpelle néanmoins sur le rapport qu'on entretient avec un outil. Elle semble en effet présupposer qu'il faut trouver l'outil parfait qui fera le maximum de lui-même sans que l'humain ne doive (trop) s'y investir. C'est légitime mais cela ne peut cacher la réalité "aucun outil n'agit seul, les humains doivent maîtriser leurs outils sous peine de devenir eux même des outils ;-)"

Ces prérequis posés, regardons Yeswiki et Wordpress (sans chercher à les classer)

Wordpress est un outil de publication (principalement dédié à faire des blogs mais peut servir aussi deCMS), il intègre donc une gestion de flux. C'est à dire que la répartition du travail est "prémachée" pour de la production et publication d'articles. Les tâches sont taylorisées (toi, tu écris, toi, tu relis, toi, tu décides de mettre en ligne, etc.). L'inconvénient étant le corollaire, il est difficile de faire autre chose que de publier des "articles" et on doit le faire en "marchant dans les clous". La rédaction de contenu y est facilitée. Wordpress est totalementwysiwyg avec un très bon gestionnaire de media/fichiers. Tout peut se faire sans écrire une ligne de code. Tout est fait pour que chacun puisse lancer un site (blog) en deux clics et sans connaître l'informatique. Les premiers pas sont très simples sur Wordpress. Cette simplification se fera "au détriment" de l'autonomisation de l'utilisateur qui devra investir beaucoup plus lourdement (en temps et en compréhension) s'il souhaite "adapter" son Wordpress à son usage.

Wordpress bénéficie d'une énorme communauté mais il est parfois compliqué de parler à un humain (tout se passe sur des forums). Il existe un tas de thèmes, de plugins et de look pour habiller son Wordpress.
Notons aussi que Wordpress présente plus de risques de faille de securité car plus exposé, et plus connu (25% des sites tournent sous wordpress) Wordpress implique donc des mises à jours des modules très régulières pour corriger les failles de sécurité - effort de maintenance plus important juste pour maintenir en état).

Yeswiki est un wiki ;-) mais il peut aussi être utilisé comme un CMS. Ici pas de rôles prédéfinis, l'édition des pages se fait en direct en mode participatif. La contribution est facilitée notamment parce que c'est tout ouvert ;-) sans pour autant empêcher le contrôle des accès si le besoin s'en fait sentir (par défaut un double clic et on entre en mode édition sans login, ni mot de passe).
Yeswiki demande un peu plus d'investissement lors des premiers pas dans l'outil car il faut parfois utiliser un peu de syntaxe wiki (qui fait un peu penser à du code) et Yeswiki n'est pas wysiwyg . Cette étape qui peut effrayer offre toutefois l'avantage de faire monter les utilisateurs en compétences numériques (utilisables dans d'autres outils web) et permet ensuite de réaliser plus facilement des adaptations du wiki à son propre contexte (notion d'autonomisation fort importante pour la communauté Yeswiki). Pour les développeurs, Yeswiki est plus facile d'accès.
Yeswiki propose un module (Bazar) de gestion de données très apprécié car il permet :
  • de facilement créer des formulaires dont on choisit entièrement le contenu
  • de rendre ces formulaires rapidement accessible à tous pour collecter de la donnée
  • de rendre visibles les données collectées sous de multiples formes (carte, agenda, liste, annuaire, trombinoscope, actualité....)
Yeswiki permet une gestion simple des menus en utilisant de simples listes à puces (menu/sous-menu).
Yeswiki permet de facilement interconnecter son wiki avec d'autres wikis et donc profiter des ressources présentes sur d'autres sites wikis et cela de manière quasi transparente.
Yeswiki, peu connu, est moins sujet aux attaques et failles de sécurité, ce qui n'empêche pas de devoir "jardiner" son site web pour gérer les éventuels rigolos qui parfois (rarement) viennent contribuer sans qu'on leur demande ;-).

La communauté Yeswiki est infiniment moins grande que celle de Wordpress :-) mais on peut rapidement parler à un humain qui s'exprime en français ;-). Cette communauté est fortement attachée aux valeurs de l'éducation populaire, à l'économie sociale et solidaire et à l'éducation à l'environnement. Les notions de convivialité (voir Illich) y sont fortement défendues.

Bon à savoir : il existe des passerelles entre ces deux outils permettant de tirer profit de leurs atouts respectifs (une carte collaborative sur yeswiki intégrée dans un wordpress par ex).

Ajouter un suivi statistique sur mon wiki

Concerne
  • Hors yeswiki
La réponse

Placer un suivi stat sur mon wiki

Pour se faire, 2 possibilités :
  • 1. Dolomon, pour un suivi "simple" et minimaliste
  • 2. Matomo, plus complet (et complex)

DOLOMON

Le service de Framasoft qui permet d'utiliser Dolomon - Framaclic - ferme le 12 janvier 2021.

Pour trouver une alternative

https://alt.framasoft.org/fr/framaclic/

Pensez à exporter vos données si vous voulez en garder une trace

https://docs.framasoft.org/fr/dolomon/deframasoftiser.html

Démarche à suivre

1) se créer un compte sur https://framaclic.org

2) ajouter un dolo

image Capture_decran_20190701_a_105640.png (88.7kB)
  • cliquer sur gif transparent
  • nommer votre dolo

3) récupérer l'url de votre dolo

image Capture_decran_20190701_a_105658.png (19.8kB)

4) placer ce morceau de code dans la page footer du wiki à suivre.

""<img src="urldevotredolo" alt="cequevousvoulezcommetexte">""


MATOMO

Matomo est une alternative à Google analytics, qui vous permet de suivre la fréquentation de votre site

TUTO A VENIR

Cacher la phrase par défaut "Saisir une fiche"

Concerne
  • Bazar (formulaire)
La réponse Par défaut quand on appelle un formulaire en mode saisie, une phrase générique apparaît en haut du formulaire et indique
"saisir une fiche : "
image Capture_decran_20190617_a_162845.png (38.7kB)

Ce n'est pas toujours très beau. Il est possible de la cacher en plaçant sur ce petit bout de code dans la page qui accueille le formulaire en mode saisie :

""<style>
h3.titre_type_fiche {display:none;}
</style>""

Mettre un titre dans une autre couleur que celle par défaut

Concerne
  • Graphisme, mise en page
La réponse Vous pouvez utiliser le code suivant :
<span style="color:#446611;">texte coloré</span>


Mais il est à placer correctement, à savoir entre les ===== et pas autour des =====
======""<span style="color:#960018;">""Le réseau des Éco-jardins""</span>"" ======

Créer une page qui reste parfaitement vierge

Concerne
  • Graphisme, mise en page
La réponse Dans toute page, pour pouvoir l'enregistrer, on doit y mettre au moins un caractère qui ne soit pas un espace.
Une solution pour avoir une page vierge consiste à y mettre un espace insécable :
& n b s p ;
C'est utile pour certaines pages qui sont intégrées dans le site et apparaissent donc à l'écran mais sur lesquelles on ne veut voir aucun texte, par exemple une page de colonne ou de titre.

Afficher des cartes avec un fond perso

Concerne
  • Bazar (formulaire)
  • Carte
Complexité Il faut des accès spéciaux
La réponse Il faut ajouter les paramètres des sources de votre carte dans le répertoire de Leaflet
  • /yeswiki/tools/bazar/libs/vendor/leaflet/leaflet-providers.js

A partir de la ligne 78 :
L.TileLayer.Provider.providers = {


  • On trouve la liste des providers et vous pouvez y ajouter le lien vers votre propre tileset.

  • MaCarte: {
    			url: 'http://[URL de vos tiles]/{z}/{x}/{y}.png',
    			options: {
    				maxZoom: 5,
    				minZoom: 2,
    				attribution: 'Mon propre fond de carte!'
    			}
    		},
    
Ensuite lors de la création d'une carte, vous pouvez choisir votre fond, en écrivant un truc du type :
{{bazarliste id="" template="map.tpl.html" provider="MaCarte" lat="" lon="" zoom="1"  width="" height="" query="" zoommolette="true" }}


Pour créer votre propre tileset, vous pouvez utiliser ImageMagick

Faire passer le texte à la ligne directement après une image

Concerne
  • Graphisme, mise en page
  • Images
La réponse Quand on insère une image dans un texte, le texte vient habiller l'image.
C'est souvent bien mais parfois on aimerait que le texte passe à la ligne juste après l'image.
Pour renvoyer le texte sous l'image insérée, placer ce bout de code juste après l'image :
""<div class="clearfix"> </div>""

Ce problème est résolu avec la dernière version de Doryphore (qui pose la question lors de l'insertion d'une photo dans la page wiki)

Rendre une image non cliquable

Concerne
  • Graphisme, mise en page
  • Images
La réponse Pour rendre une image non cliquable, ajouter la propriété nofullimagelink dans l'action "attach" qui insère l'image :
{{attach file="image.jpg" desc="tralala" size="small" nofullimagelink="1"}}

Modifier le style de police de la barre de menu

Concerne
  • Graphisme, mise en page
La réponse L'idéal est de modifier la police en utilisant le fichier CSS du wiki. Mais si vous n'avez pas accès à ce fichier css, vous pouvez toujours ajouter et adapter ce bout de code dans la page footer de votre wiki :
""<style>
.navbar {
  font-family: 'Dosis regular', cursive;
}
</style>""

Vous pouvez aussi jouer sur la taille de la police
font-size: 1.2em;

la couleur
color: navy;

ou
color : rgb(255,0,0);

Rediriger l'utilisateur vers une page spécifique à la validation d'un formulaire

Concerne
  • Bazar (formulaire)
La réponse Pour rediriger l'utilisateur vers une page spécifique quand il a validé un formulaire, il faut ajouter le paramètre redirecturl="URLcomplete" dans
{{bazar voirmenu="0" vue="saisir" id=" " redirecturl="https://yeswiki.net/?BazarAfficherFormulaireSaisie"}}


Attention : ne pas utiliser l'adresse courte wiki dans redirecturl mais bien une URL complète (http://...).

Dans un accordéon, comment faire pour cacher le titre d'une fiche bazar qui fait un peu doublon

Concerne
  • Bazar (formulaire)
  • Graphisme, mise en page
La réponse il suffit dans la page concernée et rajouter

""<style>
h1.BAZ_fiche_titre {
    display:none
}
</style>""
DaansUnAccordeonCommentFairePourCacherL_capture-decran-de-2019-07-05-22-59-37.png

Cacher les facettes (tri par case à cocher) en affichage sur smartphone

Concerne
  • Bazar (formulaire)
  • Graphisme, mise en page
La réponse L'affichage facette actuel ne se prête pas bien à l'utilisation sur smartphone. Les cases à cocher pour le tri prennent souvent trop de place ;-(. Par défaut elles se placent au-dessus ou au-dessous des fiches.

Dans l'attente d'un affichage smartphone compatible, il est possible de cacher les champs de tri d'une page avec facette lorsqu'elle est affichée sur un petit écran en plaçant sur la page concernée ce bout de code :
Ce code est à adapter si votre colonne de facette est différent de 3.

""<style>
@media screen and (max-width: 720px) {
  .facette-container .col-xs-9 {
     width:100%;
  }
  .facette-container .col-xs-3 {
     display:none;
  }
}
</style>""

comment faire pour que les pdf s'ouvrent directement dans le browser (et pas se téléchargent)

Concerne
  • Hors yeswiki
La réponse Certains pdf s'ouvrent directement dans le browser, certains se téléchargent directement...
Pour forcer l'ouverture dans le browser, la fonction {{attach}} pose parfois problème.

Pour contourner ce "problème"
  • créer un formulaire bazar avec un champ fichier (vous permettant de déposer le pdf)
  • récupérer sur cette fiche le lien vers le pdf (clic droit, enregistrer le l'adresse du lien)
  • utiliser cette adresse dans votre wiki

Autre piste

voir la doc réalisée par Laurent Bouquet : http://www.le-projet.cc/bio/?PagePdf

rétablir un bon format de table quand on a un nouveau wiki sur une vieille table

Concerne
  • Codes utiles /raw...
  • Phpmyadmin
La réponse on passe par phpmyadmin et on applique cette requête sql (en changeant le prefixe)

ALTER TABLE <prefixe>_nature
  DROP IF EXISTS bn_ce_id_menu,
  DROP IF EXISTS bn_commentaire,
  DROP IF EXISTS bn_appropriation,
  DROP IF EXISTS bn_image_titre,
  DROP IF EXISTS bn_image_logo,
  DROP IF EXISTS bn_couleur_calendrier,
  DROP IF EXISTS bn_picto_calendrier,
  DROP IF EXISTS bn_type_fiche,
  DROP IF EXISTS bn_label_class,
  MODIFY COLUMN bn_ce_i18n VARCHAR(5) NOT NULL DEFAULT '';

C'est quoi ce bazar ?


Bazar est une extension importante de Yeswiki qui lui ajoute des fonctionnalités de création et de gestion de bases de données.

Elle vous permet :

Par défaut, quand on installe un nouveau wiki, une page "gestion des bases de données" est créée. Elle est accessible via la roue crantée en haut à droite du menu.

Pour pouvoir créer et modifier, il faut être connecté en tant qu'administrateur.
La consultation et la recherche sont ouvertes à tous (par défaut mais paramétrable si besoin)
Pour installer bazar sur votre wiki, il suffit d'insérer sur n'importe quelle page
{{bazar}}


Ci-dessous, un exemple de gestionnaire bazar

image bazar.png (57.9kB)

"Rechercher" vous permet de rechercher parmi les fiches déjà présentes dans vos bases de données.
Vous pouvez aussi trier vos fiches pour n'afficher que celles appartenant à une base de données choisie via la liste déroulante de droite

"Saisir" vous permet de saisir des données dans une de vos base de données. Il suffit de cliquer sur l'icône + correspondant à la ligne de la base de donnée que vous souhaitez compléter

"Formulaire" vous permet de gérer vos bases de données (modification ou création)

"Liste" vous permet de créer les listes (et leurs contenus) que vous utiliserez ensuite dans vos formulaires de saisie de données.

"Importer" vous permet d'importer des données en nombre (en provenance d'un tableur par exemple) directement dans une de vos bases de données selon la procédure suivante

"Exporter" vous permet d'exporter les données d'une de vos bases de données pour un usage externe (dans un tableur par exemple) selon la procédure suivante