Skip to content

Commit

Permalink
Supprime le dossier export-assets dont le contenu n'est plus utilisé
Browse files Browse the repository at this point in the history
Et retire toute mention à Pandoc dans la documentation (Pandoc a été
remplacé par ZMarkdown depuis longtemps).
  • Loading branch information
philippemilink committed Sep 2, 2023
1 parent 3b8a263 commit d8b66f2
Show file tree
Hide file tree
Showing 15 changed files with 2 additions and 313 deletions.
5 changes: 2 additions & 3 deletions doc/source/back-end/contents.rst
Original file line number Diff line number Diff line change
Expand Up @@ -294,10 +294,9 @@ est configurable selon trois niveaux à affecter au paramètre ``ZDS_APP['conten
**Ajouter un nouveau format d'export**

Les fichiers téléchargeables générés le sont à partir d'un registre de créateur.
Par défaut le registre contient les 3 formats pandoc HTML, PDF et EPUB.
Par défaut le registre contient les 3 formats HTML, PDF et EPUB.

Vous pouvez définir votre propre formateur qui devra alors hériter de la classe ``zds.tutorialv2.publication_utils.Publicator`` et implémenter la méthode ``publish``.
Si vous désirez vous passer de pandoc, il vous suffira d'appeler ``map(PublicatorRegistry.unregister, ["pdf", "epub", "html"])``.
Vous pouvez aussi simplement surcharger chacun des ``Publicator`` par défaut en en enregistrant un nouveau sous le même nom.

L'entraide
Expand Down Expand Up @@ -490,7 +489,7 @@ La publication se passe comme suit :
* Si celui-ci contient des extraits, ils sont tous rassemblés dans un seul fichier HTML, avec l'introduction et la conclusion ;
* Dans le cas contraire, l'introduction et la conclusion sont placées dans des fichiers séparés, et les champs correspondants dans le *manifest* sont mis à jour.
3. Le *manifest* correspondant à la version de validation est copié. Il sera nécessaire afin de valider les URLs et générer le sommaire. Néanmoins, les informations inutiles sont enlevées (champ ``text`` des extraits, champs ``introduction`` et ``conclusion`` des conteneurs comportant des extraits), une fois encore pour gagner du temps ;
4. L'exportation vers les autres formats est ensuite effectué (PDF, EPUB, ...) en utilisant `pandoc (en) <http://pandoc.org/>`__. Cette étape peut être longue si le contenu possède une taille importante. Il est également important de mentionner que pendant cette étape, l'ensemble des images qu'utilise le contenu est récupéré et que si ce n'est pas possible, une image par défaut est employée à la place, afin d'éviter les erreurs ;
4. L'exportation vers les autres formats est ensuite effectué (PDF, EPUB, ...) en utilisant `ZMarkdown <https://github.com/zestedesavoir/zmarkdown/>`__. Cette étape peut être longue si le contenu possède une taille importante. Il est également important de mentionner que pendant cette étape, l'ensemble des images qu'utilise le contenu est récupéré et que si ce n'est pas possible, une image par défaut est employée à la place, afin d'éviter les erreurs ;
5. Finalement, si toutes les étapes précédentes se sont bien déroulées, le dossier temporaire est déplacé à la place de celui de l'ancienne version publiée. Un objet ``PublishedContent`` est alors créé (ou mis à jour si le contenu avait déjà été publié par le passé), contenant les informations nécessaire à l'affichage dans la liste des contenus publiés. Le ``sha_public`` est mis à jour dans la base de données et l'objet ``Validation`` est également changé.

Consultation d'un contenu publié
Expand Down
94 changes: 0 additions & 94 deletions export-assets/fonts/Merriweather/LICENSE

This file was deleted.

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
93 changes: 0 additions & 93 deletions export-assets/fonts/SourceCodePro/LICENSE.txt

This file was deleted.

Binary file not shown.
59 changes: 0 additions & 59 deletions export-assets/pandoc/default.epub

This file was deleted.

64 changes: 0 additions & 64 deletions export-assets/pandoc/default.html

This file was deleted.

Binary file removed export-assets/pandoc/pandoc.zip
Binary file not shown.

0 comments on commit d8b66f2

Please sign in to comment.