J'ai besoin d'un conseil

Information importante

En raison d'un grand nombre d'inscriptions de spammers sur notre site, polluant sans relache notre forum, nous suspendons la création de compte via le formulaire de "sign up".

Il est néanmoins toujours possible de devenir adhérent•e en faisant la demande sur cette page, rubrique "Inscription" : https://www.drupal.fr/contact


De plus, le forum est désormais "interdit en écriture". Il n'est plus autorisé d'y écrire un sujet/billet/commentaire.

Pour contacter la communauté, merci de rejoindre le slack "drupalfrance".

Si vous voulez contacter le bureau de l'association, utilisez le formulaire disponible ici, ou envoyez-nous un DM sur twitter.

Submitted by dharma on

Bonjour à tous,

Je voulais demander un conseil pour bien partir avec Drupal, l'ayant choisi après beaucoup de retours encourageants. Alors voila, pour un client, je dois écrire une documentation utilisateur avec les contraintes suivantes :
- bosser à plusieurs sur le doc
- cms traduit en francais (mouarf je crois que je suis sur le bon forum ;-))
- possibilité d'utiliser des styles pour écrire toutes les pages de la meme manière quelque soit l'utilisateur
- inserer des copies d'écrans
- un moteur de recherche
- et surtout, être capable de générer à la volée la doc complète en format sympa genre pdf

Suis-je dingo ou Drupal est capable de faire ca ? Et avec quels modules, on m'a parlé de la distrib de CivicSpace qui parait est pas mal ...

Merci vraiment pour votre aide.
Richard

Forum : 
Support général

Soumis par alkahan le 11 Octobre, 2005 - 13:30

Drupal est capable de faire tout cela de base excepté la génération en PDF et les captures d'écran. La traduction est faite, pour pouvoir bosser à plusieurs sur une doc, tu utilises le module book qui est de base dans drupal et qui permet de gérer des versions de documents. Les thèmes utilisent les CSS. Pour les captures d'écran tu peux utiliser les modules [url=http://drupal.org/project/image]image[/url] et [url=http://drupal.org/node/9707]image_filter[/url]. Le module de recherche est livré avec drupal.

Pour la génération de PDF, il existe le module [url=http://drupal.org/project/pdfview]pdfview[/url]. Ce dernier n'est encore qu'en version CVS, mais il doit fonctionner. A tester.

Soumis par tostinni le 11 Octobre, 2005 - 16:25

Pour l'export des documents book, a mon avis une des nouvelles fonctionnalite d'exportation du book module que je citais devrait aider a exporter des documentations completes et surement entrainer la generation facile de pdf (- Added Docbook and OPML export functionality to books).

Soumis par tostinni le 24 Novembre, 2005 - 21:51

J'en profite pour faire un petit up, puregin vient de sortir sont module d'export docbook
Je cite :

This module allows the export of Drupal books, in DocBook
XML format. It is assumed that the input is HTML; this
input is cleaned using Tidy to generate XHTML, which is
then transformed via XSLT into DocBook.

To Do

This will enable publication to PDF via processing pipelines
involving XSLT, FO and image conversion tools. I expect to
package configuration, instructions and integration for standard
toolsets as a separate module.

A voir si ca peut t'aider.

Soumis par dharma le 18 Octobre, 2005 - 19:46

Merci de votre aide, elle m'est très précieuse. J'ai décidé mon client à adopter la solution, je dois lui présenter une "démo" de l'outil qui correspond donc aux besoins que j'ai cité dans mon premier post.
Jusque là, j'ai installé Drupal, ajouté le support book, commencer à créer quelques pages de démo, genre :
Document xxx
Introduction
Dossiers
Création d'un dossier
Recherche de dossiers

Voila l'exemple de hiérarchie que je vais lui présenter.
J'ai vu le lien "Printer-friendly version" qui génére un listing html qui effectivement parait un peu cheap, pas de hiérarchie marqué entre les sections et les sous-sections, etc ....

Donc je dois installer un module me permettant de générer quelque chose de plus pro.
A l'heure actuelle (v4.6.3), que me conseillez vous, upgrader en version cvs pour bénéficier de l'export docBook ? pour le module pdfview, je ne le vois pas référencer dans les modules de la 4.6.3

Autre chose, dans l'optique d'une sortie pdf structurée avec sections, sous sections, dois je des maintenant dire au client de formatter de manière précise le contenu ??? je pense par exemple aux images, que je peux maintenant intégrer grace à HtmlArea, mais que je ne peux voire que quand le contenu est sur "FullHTML" et pas "Filtered Html"!!!.
Est ce que faire directement du html (FullHTML) sans un minimum de convention d'écriture du contenu, ca va pas nous conduire à un doc pdf complètement illisible ? Avez vous des "best practice" la dessus ?

Une dernière chose, comment faire pour arriver directement sur une page d'accueil décrivant brièvement la doc et listant en dessous le sommaire du book ? comme l'index du handbook de drupal en fait : http://drupal.org/handbooks

Désolé pour la lourdeur de ce mail, mais je sens monté la pression .... :(((((
Encore merci pour votre aide.
R.

Soumis par alkahan le 18 Octobre, 2005 - 21:41

Je vais y aller point par point :
1- Pas besoin d'un module supplémentaire pour avoir quelque chose de plus pro pour l'impression, il te suffit de modifier la feuille de style print.css qui se trouve dans le répertoire misc.

2- pour le module pdfview, il n'existe qu'en version CVS. Donc il faut que tu prenne la version CVS du module (il n'est pas forcément nécessaire d'avoir la version CVS de drupal)

3- Je pense qu'il vaut mieux que ton client structure correctement ses documents. Mais avant tout il faut que tu connaisses ses besoins. Il faut éviter d'utiliser le format Full HTML, il vaut mieux correctement configurer le format Filtered HTML en n'autorisant que les balises qui seront nécessaires. D'ailleur, tu peux te poser la question de l'utilisation d'un autre langage comme BBcode ou autre, mais là encore tout dépend des besoins de ton client. Si tu reste avec un format utilisant le HTML il faut essayé de produire un code compatible avec les normes du W3C, tu auras plus de chances d'avoir un bon rendu PDF. Cependant le module viewpdf utilise la librairie [url=http://www.fpdf.org/]fpdf[/url], et donc le meiux est de t'adresser directement à eux pour cette question.

4- j'aimerais bien avoir la même chose que sur le site de drupal. Je suppose qu'ils sont crée une page avec du code php dedans.

Soumis par dharma le 23 Octobre, 2005 - 09:39

Gràce à toi, j'avance de plus en plus. J'ai encore quelques commentaires par rapport à tes points :

1/ Existe t -il des modèles de feuille de style pro pour le print.css sur lequels je pourrais bosser ?
2/ J'ai installé pdfview, mais quelle déception quand j'ai vu qu'il ne générait que du pdf par page et pas pour le book complet !!!! Je suis en train de chercher une alternative et je pense de plus en plus à l'export docBook de la version CVS de drupal. Par contre, existe t il des scripts de mise à jour par rapport à la dernière release ? Et les modules que j'utilise sont ils compatibles avec la version cvs de drupal ?
Que penses tu de l'idée ?
Je dois aussi t'avouer que je rame pour trouver un convertisseur pour transformer le docBook drupal en pdf, je suis pas assez calé .... :(
3/ Les besoins du client, c'est d'écrire un manuel utilisateur avec le process suivant:
- avoir un module pour récupérer la copie d'écran, la retailler et la convertir en format png ou gif, est ce que ca existe sur Drupal ?
- insérer ces images screenshots dans les documents (avec le format FilteredHtml, j'arrive pas à visualiser les images insérés par HtmlArea, je suis obligé de passé en FullHTML...),
- mettre en forme son texte, paragraphe, titre, sous-titre, avec du gras, italique et un peu de couleur, je pense qu'il peut se passer des tableaux
- exporter le book à la volée en format pdf avec une tables des matières cliquables

Autre chose, le module HtmlArea est absolument fanstastique mais non compatibles avec le FilteredHtml, puisqu'il convertit mes balises genre STRONG en texte et pas en balise ....
Alors je ne vois pas d'autre choix que de passer malheureusement en FullHTML

4/ je crois que c'est une page d'acceuil avec des liens sur tous les books, existe t il une possibilité de créer des liens avec des urls plus sympa que /?node/26 mais plutot /introduction ?

Merci encore pour ton aide

Soumis par alkahan le 23 Octobre, 2005 - 22:31

1- ben, regardes sur le net. Ce n'est pas spécifique à drupal, beaucoup de sites fonctionnent de la même manière pour générer un format imprimable. Essayes sur des sites d'aide sur le dev web tel que openweb...

2- pour convertir du docbook en pdf, le soft s'appel docbook2pdf ou encore db2pdf. Sur ma Mandriva, il s'installe avec le paquet docbook-utils-pdf, l'rul donné dans le rpm est la suivante :
ftp://sources.redhat.com/pub/docbook-tools/new-trials/
http://sources.redhat.com/docbook-tools/
[quote]
Par contre, existe t il des scripts de mise à jour par rapport à la dernière release ?[/quote]
je ne comprends pas bien ta question là.

3- un module comme [url=http://drupal.org/project/img_assist]img_assist[/url] doit pouvoir t'aider. Il offre une interface pour gérer les images à insérer dans un texte, il s'intègre avec le module [url=http://drupal.org/project/tinymce]TinyMCE[/url], et une intégration avec HtmlArea est même prévu.
pour exporter le book à la volée, là je pense qu'il va falloir que tu développes toi même un module qui fasse appel aux logiciels cités plus haut.

4- Les modules path et pathauto sont tes amis.

Soumis par geeloo le 2 Novembre, 2005 - 08:03

Pour le point 3, il est possible d'utiliser les modules upload et inline.
Avec upload on charge l'image du screenshot en fichier attaché.
Avec inline on insère dans le texte directement des balises de type [inline:N] avec N l'ordre dans la liste d'upload.
Ensuite on appuie sur submit et c'est parti.