M3.1. Comprendre les principes de Publication

Description
Sortir une publication à partir de son wiki...
Qui n'a pas rêvé de générer le plus facilement possible un joli PDF agrégeant les pages ou fiches d'un wiki, ou encore plus facilement, d'imprimer le contenu d'une page ?
C'est ce que nous allons découvrir au sein de ce module avec l'aide du "tools" publication mais aussi d'extension à rajouter dans son navigateur.
Date d'ouverture 07.05.2022
Ce module est accessible depuis 2 ans (7 mai 2022)
Index

M3.1-a Présentation de Publication

Publication, où comment imprimer un bouquin depuis votre wiki

Ou plutôt pour ne pas vous vendre du rêve, comment générer un pdf à partir de votre wiki.

Préambule

l'extension Publication a été développée principalement par Oncle Tom, alias, Thomas Parisot. Elle correspond au besoin, souvent énoncé par les usagers de YesWiki, de pouvoir générer facilement, à partir des contenus de leur wiki
  • des livres / livrets
  • des fanzines
  • des newsletters

Publication permet de gérer 4 étapes qui vous faciliteront la tâche :
  1. Sélectionner les éléments constitutifs de la publication.
  2. Organiser les éléments constitutifs au sein de la publication.
  3. Générer et enregistrer la publication.
  4. Produire le PDF

Action {{section ...}} : l'action {{section ...}} doit être fermée par une action {{end elem="section"}}.
A noter que pour cette quatrième étape, chromium devra être installé sur votre serveur (on vous aidera à le tester). Ceci dit, pas de panique si ce n'est pas le cas, des solutions alternatives existent.

Les étapes en quelques écrans

L'interface pour choisir les articles

image choisirarticle.png (46.9kB)
L'interface pour choisir les éléments à imprimer

La prévisualisation de l'article

image screenshotpreview.png (46.9kB)
Prévisualisation de l'impression à venir

L'accès aux ebook générés

image screenshotpageindex.png (0.1MB)
Accès aux pdf générés avec prévisualisation et de téléchargement

La possibilité à générer des fanzines

image singlepage.svg (8.0kB)
Une restitution possible sous forme de fanzine
Index

M3.1-b Petite récréation, jouer un peu avec publication

Et puisque l'expérience est plus efficace qu'un long discours...


Avant de partir dans la mise en oeuvre de votre propre projet, je vous propose de tester un peu publication dans différents contextes.
Créez vos pdf, n'hésitez pas à jouer avec les différents paramètres.

Pour cela, voici quelques wiki avec lesquels tester publication :

Index

M3.1-c Installation de publication

Installer publication

Publication s'installe comme toutes les extensions qui ne sont pas fournies de base dans votre YesWiki. Les étapes pour l'installer sont les suivantes :
  • Se connecter avec le compte admin dans votre wiki
  • Aller dans molette / Gestion du site / Mises à jour - extensions
  • Cliquer sur Tools (extensions)
  • Cliquer sur le bouton Installer à droite de la ligne Publication (à noter qu'à droite de publication, un lien documentation vous permettra de retrouver beaucoup des contenus de ce module)
    • puis laissez vous guider, cliquez sur le lien de post-installation qui vous est proposé
  • Publication est maintenant installé !
  • Retourner sur la page d'accueil de votre wiki, un lien "exporter au format pdf" doit maintenant apparaître en bas à droite de votre page.
image Screenshot_20220501_at_180028_Formation_Gare_Centrale_2022.png (24.7kB)
  • Vous pouvez cliquer dessus. Si un joli "pdf" arrive sur votre ordinateur c'est que le fameux Chromium est installé sur le serveur qui héberge votre site, sinon, vous verrez apparaître le message suivant

image Screenshot_20220501_at_225838_APME3_Bienvenue_sur_le_groupe_APME3.png (33.7kB)
  • Pas de panique, nous avons des solutions sous le coude
  • Dernier test, allez dans les composants (mode édition de n'importe quelle page), de nouveaux éléments associés à publication sont maintenant accessibles (NB. ces composants ne sont accessibles que pour les admins)
image composants.png (56.4kB)
Index

M3.1-d Installation et mise en pratique de "Print Friendly et PDF"

Se passer de publication

(mais aussi utiliser publication sans chromium sur son serveur)

Que ce soit avec Firefox, votre navigateur préféré ou tout autre navigateur web, vous pouvez rajouter des extensions, petits bouts de logiciels qui transforment votre navigateur en véritable couteaux suisse du web.

Nous allons nous concentrer sur Print Friendly et PDF.

Pour l'installer

  • Cliquez sur https://www.printfriendly.com/extensions/firefox
  • Choisissez l'onglet correspondant à votre navigateur préféré
  • Suivez la procédure proposée, et vous vous retrouverez avec une nouvelle icone à droite de votre barre d'adresse
image extension.png (11.1kB)

Pour utiliser Print Friendly

  • Rendez-vous sur votre page web préférée
  • Cliquez sur l'icone de l'extension Print Friendly et vous obtiendrez l'écran suivant
image PrintFriendly.png (0.2MB)

  • Print vous permettra de l'imprimer
  • PDF, de générer le PDF
  • Style, de changer le style de votre page (typo, taille des polices, couleur de fond...)
  • Images, de faire varier la taille des images ou de les supprimer dans le PDF
  • Edit vous permettra d'éditer les textes et de rajouter, modifier...
  • Highlight, ajoutera un surlignage jaune sur un texte sélectionné
  • Delete permettra de supprimer certains éléments que vous ne souhaitez pas voir apparaître au sein de votre PDF

A vous de jouer

Expérimentez, testez, cette extension pourra servir à des personnes qui n'ont pas ce fameux chromium. Ceci dit, même pour les autres, c'est un outil très pratique.
Index

M3.1-e Les actions associées à Publication

Les actions permises par Publication

Nous allons passer en revue les actions proposées par l'extension Publication. Cette première découverte restera limitée aux fondamentaux que nous approfondirons lors du module suivant.

Vous retrouverez ces actions en mode édition en cliquant sur Composants / Publication
image composants.png (56.4kB)

Le générateur de publication : {{publicationgenerator}}

C'est l'outil central de Publication
  • Une fois le générateur placé dans votre page dédiée, vous trouverez
    • la liste des pages wiki ainsi que la liste des fiches associées à des formulaires.
    • mais surtout le cartouche qui vous permettra de configurer votre ebook
image Screenshot_2022050.png (0.2MB)

Liste des publications : {{publicationlist }}

C'est grace à cette action que vous retrouverez les pdf générés.
Vous n'obtiendrez pas les mêmes informations si vous êtes identifié.e en Admin ou comme simple utilisateurice.
Action {{section ...}} : l'action {{section ...}} doit être fermée par une action {{end elem="section"}}.
NB. Pour les utilisateurices ne disposant pas de Chromium sur leur serveur, vous obtiendrez un message d'erreur en cliquant sur Télécharger le PDF. Pour obtenir tout de même votre publication :
  • cliquez sur Aperçu
    • utilisez Print Friendly
    • ou
    • en passant par la fonction imprimer de votre navigateur, choisissez enregistrer au format PDF

Affichage des résultats en tant qu'admin

image Screenshot_20220502_at_001811_APME3.png (19.2kB)

Affichage des résultats en tant que simple visiteurice

image Screenshot_20220502_at_001845_APME3.png (15.7kB)

Impression des résultats Bazar : {{bazar2publication }}

NB. Ne fonctionne qu'avec Chromium
Ajouté à un affichage de résultats de fiches bazar, une fois les tris effectués de vos fiches préférées, un bouton "Créer une publication imprimée avec ces résultats" permettra de générer un PDF avec uniquement les fiches retenues.
image Screenshot_20220502_at_003412_APME3.png (64.6kB)
Index

Mise en pratique, utiliser Print Friendly

jhgjhg

M3.2. Entrer dans les arcanes de Publication

Description
Explorer les possibilités les plus pointues de publication, ne proposer à imprimer que certaines pages, que certaines fiches de mon wiki.
Générer une page de garde et des quatrième de couverture, des têtes de chapîtres...
Tout, tout, tout, vous saurez tout sur publication.
Date d'ouverture 14.05.2022
Ce module est accessible depuis 2 ans (14 mai 2022)
Index

M3.2-a Rappel des épisodes précédents

Comme nous savons que de nombreuses personnes se connectent dès le samedi matin 0h00, je produis vite un premier contenu, la suite arrivera tout bientôt durant le WE ;-)

Et nous voici donc parti pour la suite des aventures.
Petit rappel de ce que nous avons appris, notamment durant le webinaire et durant la séance technique :
  • Publication ne fonctionne que dans des pages ouvertes en lecture et écriture.
  • Pensez bien votre chaîne de publication et testez la sur quelques contenus. Cela permettra de vérifier si
    • vos pages ou fiches sont bien nommées pour les retrouver ensuite facilement dans publication
    • la mise en page de vos pages ou fiches offre un bon rendu dans le pdf final
    • il vaut mieux tester cela sur 3 fiches que sur 1753...
  • Il est possible de réaliser des mises en pages plus abouties (cf cliketik.fr) en faisant travailler un graphiste et ensuite un intégrateur graphique qui pourra réaliser une mise en page aux petits oignons, seul inconvénient, ça coute un peu, mais surtout, si vous rajoutez des champs dans votre formulaire et le modifiez, il faudra recommencer ce travail graphique. Les pistes à explorer sont donc les suivantes :
    • première solution, on est sûr que le contenu ne bougera pas, on fait travailler les ouvriers graphiques
    • seconde solution, On se satisfait de la mise en page proposée, les contenus sont à jour et on les distribue tels quels
    • troisième solution, on extrait les données des fomulaires via la fonction export et on envoie cela à son graphiste qui vous réalise un superbe doc mais aves des données à jour.
  • Publication ne fait pas tout, certaines extensions installées dans votre navigateur favori et autres astuces vous permettent de réaliser des publications sans publication :
    • Print Friendly permet de retoucher les contenus, de finaliser votre publication
    • https://convertio.co/fr/pdf-epub/ nouveauté ! vous permettra de convertir votre pdf dans plein de formats pour liseuses et autres trucs bizarres
    • https://avepdf.com/fr nouveauté ! pourra compresser, découper, triturer votre pdf dans tous les sens
  • Nous avons échangé sur quelques usages éventuellement intéressants :
  • On peut quand même utiliser publication sans avoir chromium sur son serveur, pour cela, deux choses à faire :
    • dans molette / gestion du site / Fichier de conf / Publication / et entrer dans "adresse d'un YesWiki à qui déléguer le rendu PDF" l'adresse du wiki copain qui acceptera de générer les pdf pour vous
    • Chez le wiki copain ajouter dans le fichier de configuration l'acceptation des données arrivant de ce wiki à aider via la ligne de code
      'htmltopdf_service_authorized_domains' => ['example.org', 'youpi.com', 'toto.fr'],
      
  • Nous avons vu comment faire de l'espionnage industriel en ajoutant /raw à l'adresse d'une page qui nous intrigue et dont nous souhaitons comprendre le fonctionnement comme ici : https://formationcivamgard.fr/?EbookTotal/raw
  • Et pour les plus gourmands qui auraient envie de prendre de l'avance, l'extension publication est bien documentée ici : https://github.com/YesWiki/yeswiki-extension-publication/blob/master/README.md

Et surtout faites des test, jouez avec ces nouvelles possibilités.

A tout bientôt
Index

M3.2-c Configurer {{bazar2publication}}, l'impression des résultats bazar

Cette action vous permettra de générer des pdf issus des requêtes réalisées au travers des facettes du formulaire bazar. Si vous n'avez pas activé des éléments, {{bazar2publication}} ne vous servira à rien...
Voilà à quoi ressemble l'utilisation de facette (les facettes sont les éléments sur la droite qui permettent de trier):
image facette.png (0.6MB)
Utilisation des facettes sur une carte
NB : Les facettes peuvent être utilisées sur un affichage des fiches sous forme de liste, agenda, tableau...

L'ajout de bazar2publication se fait dans la même page que l'affichage des résultats de votre formulaire bazar et génère un bouton proposant la possibilité de générer le fameux pdf. Sur l'exemple ci-dessus c'est le bouton vert "Imprimer les résultats".

Activer l'interface de conception de pdf

Pour activer cette interface dans la page pertinente :
  • Allez dans composants
  • Publication
  • Impression des résultats Bazar


Action {{grid ...}} : l'action {{grid ...}} doit être fermée par une action {{end elem="grid"}}.
Vous obtiendrez l'interface suivante :
image bazar2publication.png (38.8kB)
Les paramètres y sont simples :
Titre : Le titre qui s'affichera sur votre bouton
Icône : L'icône associée
Classe : Vous pouvez utiliser toutes les classes associées au bouton pour qu'il soit jaune, gros, sur toute la largeur... cf action bouton dans les composants
Page modèle : si vous mettez ici le nom de la page correspondant à un ebook déjà généré avec une page de couverture et une quatrième de couverture, et bien vos contenus s'insèreront au sein de ce modèle pour générer un pdf bien comme il faut.