Publication et diffusion d'un document⚓

Publication d'un document⚓

ConceptItem de publication⚓

On appelle item de publication un item qui permet de générer un document, via la vue Génération.

Le type d'item de publication conditionne le format de sortie du support (web, pdf,...).

La vue Édition d'un item de publication permet de définir le scénario du document à publier. Selon votre application, le scénario est défini soit en liant un item particulier qui donne au document son plan (un item dit racine des contenus), soit en composant le scénario directement dans la grille de saisie de l'item de publication (qui est alors l'item racine). Cette vue Édition peut aussi comporter des métadonnées (date, auteur, version, logo,...).

Remarque

La vue[1] Gen. permet trois actions principales :

  • générer le document créé dans un format défini (défini à la fois par le type d'item racine sélectionné et par les paramètres du modèle documentaire[2] de votre chaîne éditoriale),

  • consulter,

  • télécharger.

ComplémentAutres actions⚓

Autres actions (disponibles selon votre chaîne éditoriale et le type de générateur) :

  • révéler (en mode local[3], Révéler permet d'afficher l'emplacement du document généré sur votre disque dur) ;

  • Déploiement par FTP... (genDeploy[4] permettant d'exporter le document généré vers un serveur FTP) ;

  • Sélection d'un skin[5] différent (lorsque plusieurs habillages sont installés et paramétrés sur votre atelier).

ÉcranInterface de la vue Génération⚓

  • 1 Vue Génération
    Vue Génération

    La vue Génération d'un item permet d'afficher les actions relatives à la publication que vous pouvez réaliser.

  • 2 Vue Prévisualisation
    Vue Prévisualisation

    La vue Prévisualisation permet d'afficher un aperçu de ce que ce sera l'item en question à la publication Web.

  • 3 Vue Édition
    Vue Édition

    La vue Édition permet de définir les paramètres de publication d'un item et donc de définir les conditions de publication du document.

    Par exemple : lier le document à publier ; choisir de publier le Glossaire, la Table des matières... ou non ; ajouter des métadonnées, du type Auteur, Version, Logo...

  • 4 Catégorie de générateur
    Catégorie de générateur

    Les générateurs de votre chaîne éditoriale peuvent être rangés dans des catégories.

  • 5 Type de générateur
    Type de générateur

    Selon votre chaîne éditoriale, vous pouvez choisir entre plusieurs types de générateurs pour la publication de votre document.

    Chaque type de générateur défini un format de sortie particulier de votre document.

  • 6 Skin
    Skin

    Sélection d'un skin[5] différent : sélectionne une autre feuille de style pour la publication du document et donc modifie l'apparence de celui-ci.

    Disponible lorsque plusieurs skins sont installés et paramétrés sur l'atelier.

    Retourner à l'écran
  • 7 Générer
    Générer

    générer, permet de publier le document dans le format défini par l'item de publication, selon les paramètres définis par le modèle documentaire de la chaîne éditoriale.

    Autrement dit, générer transforme le contenu de votre document dans la chaîne éditoriale en un support documentaire[6].

    Retourner à l'écran
  • 8 Consulter
    Consulter

    consulter, ouvre le document généré dans l'application adéquate (navigateur pour le format web, Adobe Reader pour le format pdf, ...).

    Retourner à l'écran
  • 9 Télécharger
    Télécharger

    télécharger, permet d'enregistrer sur votre disque dur, à l'endroit de votre choix, le document généré.

    Retourner à l'écran
  • 10 Révéler
    Révéler

    révéler, dans le cas d'un travail en mode local[3], ouvre l'emplacement des sources du document généré (dans un dossier gen de votre disque dur).

    Retourner à l'écran
  • 11 Déploiement par FTP...
    Déploiement par FTP...

    Déploiement par FTP..., permet de diffuser ses documents par le protocole FTP sur un serveur, une plateforme de formation à distance,...

    Retourner à l'écran

ProcédurePublier un document⚓

Cette procédure explique comment publier un document[7] dans Dokiel. La publication d'un document est l'étape qui transforme le contenu (au format XML) de votre document dans Dokiel en un support documentaire[6].

Le format de sortie du document généré est défini par l'item de publication[8] sélectionné et par les paramètres du modèle documentaire[2] de votre chaîne éditoriale.

Prérequis
  • Vous avez complété les champs de la vue[1] Édition de l'item de publication que vous souhaitez publier.
  • Cet item est ouvert dans la zone d'édition de Dokiel.

  1. Sélectionnez la vue Gen. de l'item.

  2. Le cas échéant, sélectionnez le générateur de votre choix en cliquant sur son nom.

    1. Les actions disponibles pour ce générateur s'affichent sous son nom.

  3. Cliquez sur générer.

    1. Une animation vous indique que la génération est en cours. Lorsque l'animation est terminée, le document est généré.

      RemarquePremière génération⚓

      Les options de relecture et de diffusion du document généré (Consulter, Télécharger, Déploiement par FTP, ...) apparaissent automatiquement à l'issue de la première génération du support.

  4. Ensuite, plusieurs possibilités s'offrent à vous :

    • Relire le document :

      consulter : permet d'ouvrir le document généré dans l'application adéquate à des fins de relecture.

    • Diffuser le document généré, en utilisant l'une des 2 options suivantes :

    Révéler (mode local)

    • Révéler :

      Dans le cas d'un travail en mode local[3], une option supplémentaire s'offre à vous :

      révéler : permet d'ouvrir l'emplacement des sources du document généré (dossier gen dans le système de fichier de votre disque dur).

Truc & astuceImageMagick & incrustation de texte⚓

Dokiel embarque ImageMagick pour la manipulation d'images, notamment pour l'incrustation automatique de texte sur les Écrans lors des publications. Dépendantes de votre système d'exploitation, ces transformations peuvent échouer (Sous MacOS X notamment).

Dans ce cas, il est possible d'indiquer à Dokiel d'utiliser une autre version de ImageMagick.

Relecture d'un document⚓

ProcédureRelire un document généré⚓

Avant de diffuser un document[7] que vous avez généré, procédez à sa relecture. La relecture consiste à s'assurer que le fond et la forme du document généré répondent à vos attentes et qu'il n'y a pas d'erreurs.

En outre, la relecture sur le support généré permet à l'auteur de prendre du recul par rapport à son contenu dans l'interface de Dokiel.

Après avoir généré un document, cliquez sur le bouton-icône consulter (vue[1] Gen. de l'item de publication[8]).

Le document généré s'ouvre dans l'application paramétrée par défaut (navigateur pour le format web, Adobe Reader pour le format pdf,...).

AttentionMise à jour des supports⚓

Après avoir corrigé les éventuelles erreurs dans le contenu, relancez une génération pour mettre à jour les supports avant de les diffuser.

Dans le cas contraire, les supports accessibles grâce aux actions (Consulter, Télécharger,...) demeurent les supports générés précédemment. De fait, seule la dernière génération des documents est accessible ; chaque génération écrase la précédente.

RemarqueVue Prévisu.⚓

Pour mémoire, la vue[1] Prévisu., lorsqu'elle est disponible , vous permet d'avoir un aperçu de la publication de votre document, directement dans l'application, sans passer par la génération puis par l'ouverture de l'application adéquate.

Diffusion d'un document⚓

Pour diffuser le document généré, vous pouvez utiliser l'une des 2 options suivantes (disponibles en fonction de votre application et du type de générateur) :

  • télécharger : permet de télécharger le document sur votre disque dur ;

  • Déploiement par FTP... : genDeploy[4] qui permet de diffuser le document par le protocole FTP.

ProcédureTélécharger un document généré⚓

Cette procédure explique comment télécharger sur votre disque dur un document généré depuis un item de publication[8].

Prérequis

  1. Sélectionnez la vue Gen. de l'item.

  2. Cliquez sur télécharger.

    1. Une boîte de dialogue s'affiche.

  3. Choisissez Enregistrer le fichier et cliquez sur OK.

    1. Une fenêtre d'exploration de votre disque dur s'affiche.

  4. Sélectionnez l'emplacement de votre disque dur où vous souhaitez enregistrer le fichier.

    RemarqueRemarque⚓

    Si vous le souhaitez, vous pouvez modifier le nom du fichier enregistré en modifiant le contenu du champ Nom de fichier, en bas de la fenêtre.

    AttentionAttention⚓

    • Ne modifiez pas l'extension qui suffixe le nom d'un item (ce qui suit le . )

    • Ne modifiez pas le type de fichier.

  5. Cliquez sur Enregistrer, en bas de la fenêtre.

  6. Le fichier (contenant le document généré) est enregistré sur votre disque dur, à l'endroit spécifié.

    Truc & astuce

    Une fois le document téléchargé sur votre disque dur, vous pouvez le transmettre, l'imprimer, le mettre en ligne,...

ProcédureDéployer un document par FTP⚓

Cette procédure explique comment déployer par FTP un document généré depuis un item de publication[8].

Prérequis

  1. Sélectionnez la vue Gen. de l'item.

  2. Cliquez sur Déploiement par FTP....

  3. Saisissez les informations requises.

    Vous pouvez avoir à renseigner les informations suivantes :

    • Serveur
    • Répertoire principal sur le serveur
    • Compte utilisateur
    • Mot de passe
    • Mode de connexion : Actif / Passif

    En cas de doute sur les paramètres de connexion FTP, contactez votre administrateur réseau.

    ExempleExemple⚓

  4. S'il s'agit du premier déploiement FTP vers ce répertoire, cliquez sur exporter.

    1. Le support généré est déposé sur le répertoire spécifié.

  5. Si vous avez déjà exporté ce support vers ce répertoire, cliquez sur Mettre à jour pour n'envoyer que les fichiers modifiés depuis la dernière diffusion du document.

    1. Le support est mis à jour sur le répertoire spécifié.

RemarqueAutres actions disponibles⚓

  • rapport : permet de connaître les éventuelles causes du problème, en cas d'anomalie lors de la diffusion.

  • purger & exporter : permet de supprimer les fichiers du répertoire sur le serveur avant de renvoyer tout le site. Cette action est utilisée lorsque l'on souhaite forcer la réécriture du support généré.

Sélection d'un skin⚓

ProcédureSélectionner un skin⚓

Cette procédure explique comment sélectionner un skin[5] spécifique pour modifier l'apparence du document généré depuis un item de publication[8].

Prérequis

  • Vous avez installé dans votre application un (ou plusieurs) skin(s) ;

  • Vous avez activés sur votre atelier le (ou les) skin(s) que vous souhaitez utiliser pour modifier la charte graphique des documents générés.

  • Vous avez complété les champs de la vue[1] Édition de l'item de publication que vous souhaitez publier.

  • Cet item est ouvert dans la zone d'édition de Dokiel.

  1. Sélectionnez la vue Gen. de l'item.

  2. Le cas échéant, sélectionnez le générateur de votre choix en cliquant sur son nom.

    1. Les actions disponibles pour ce générateur s'affichent sous son nom.

  3. Sélectionnez le nom du skin que vous souhaitez utiliser parmi la liste des skins installés.

    ExempleExemple⚓

  4. Le skin est sélectionné ; vous pouvez lancer la publication du document.

AttentionMise à jour des supports⚓

Après avoir sélectionné un skin, vous devez relancez une génération pour mettre à jour les supports avant de les diffuser.

Dans le cas contraire, les supports accessibles grâce aux actions (Consulter, Télécharger,...) demeurent les supports générés précédemment. De fait, seule la dernière génération des documents est accessible ; chaque génération écrase la précédente.

Mozilla Archive Format⚓

ConceptMozilla Archive Format (MAF)⚓

MAFF (extension .maff)

MAFF est un format de fichier unique pouvant contenir plusieurs pages web. Il est développé par Mozilla et est donc lisible sur le navigateur Firefox.

Une extension Scenari permet de générer des versions Maff de ses documents.

Truc & astuceÀ quoi ça sert ?⚓

Le format Maff est idéal pour transporter vos diaporamas (ou vos sites web) sur une clé USB. En effet, couplé à un navigateur Firefox portable[9], il vous permet d'ouvrir vos documents de manière optimale, partout.

En outre, il nécessite moins d'espace disque qu'un fichier HTML classique puisqu'il est basé sur ZIP.

Pour pouvoir générer des documents au format Maff dans votre chaîne éditoriale :

  1. Installez l'extension adéquate pour votre modèle documentaire dans votre application Scenari :

  2. Une fois installé dans votre application, Maff fonctionne comme un genDeploy[4] (au niveau des publications diaporama et web). Il vous suffit de générer votre document au format Maff puis de télécharger le fichier généré.

    Pour en savoir plus sur la publication : Publication d'un document.

Pour pouvoir ouvrir des documents au format Maff dans Firefox :

  • Installez l'extension Maff sur votre navigateur Mozilla Firefox (standard ou portable) depuis le menu Menu/Modules/ de Firefox et recherchez MAFF.

  • Pour en savoir plus sur Maff : http://maf.mozdev.org.