Correction documentation Pleade 4.2

Manuel d'installation et d'exploitation (v. 4.2)

Glossaire

Il est important d'avoir un glossaire qui regroupe tous les termes techniques, le but étant de faciliter aux utilisateurs qui liront la documentation de bien comprendre ces derniers.

To do :

Ajout d'un glossaire.

Addon Firefox

Vider la mémoire cache du navigateur est bon car ça évite d'utiliser des anciens formulaires et permet le bon fonctionnement de Pleade. C'est pour cela qu'il serait interessant d'ajouter une partie dans la documentation qui explique l'importance de le vider et comment installer l'addon 'Clear Cache'.

To do :

Ajouter une notice dans la documentation qui indique d'installer l'addon 'Clear Cache' (https://addons.mozilla.org/fr/firefox/addon/clearcache/).

3.3 Serveur Web (HTTP)

To do :

Page 12 : - Apache 2.2 -> Apache 2.4 (http://httpd.apache.org/docs/current/) - Il faut mettre a jour l'URL.

To do :

Page 12 : Le fichier principale httpd.conf n'existe plus avec la nouvelle version d'Apache 2.4, maintenant le fichier principale est apache2.conf..

3.3.1 Redirection vers l'application Pleade

Important :

Cette partie ne concerne que les utilisateurs qui disposent déjà de Pleade sur leurs machine, il faudrait la déplacer ou le préciser dans la documentation..

3.3.2 Connecteur Apache / Tomcat -> Hôte virtuel

Notice :

Au moment de déclarer un hôte virtuel pour l'application CND, si ce dernier n'est pas déclaré correctement dans le fichier de configuration du serveur HTTP d'Apache, une erreur apparaît :.

Important :

AH00526: Syntax error on line 186 of /etc/apache2/apache2.conf:

Invalid command 'ProxyPass', perhaps misspelled or defined by a module not included in the server configuration Action 'configtest' failed.

The Apache error log may have more information..

3.3.3 Pages d'erreurs du serveur HTTP Apache

Important :

L'internalisation des erreurs n'existe pas dans le fichier de configuration du serveur HTTP d'Apache.

To do :

Page 14 : Il faut préciser le nom du fichier en entier qui permet de modifier le message d'un objet non trouvé, le fichier se nomme contact.html.var et non pas HTTP.

3.4.3 Activation de la ferme d'applications

Important :

Page 19-20 - Lors de la modification du fichier de configuration du serveur HTTP d'Apache pour prendre en charge la ferme d'applications, une erreur survient : Job for apache2.service failed because the control process exited with error code..

Création de la base de données pour Pleade

To do :

Page 22 : Il serait intéressant de préciser la commande qui permet d’accéder a mysql server via console (sudo mysql).

To do :

Page 22: Il faut préciser que le [mdp] c'est celui de la base de données..

To do :

Page 22 : Il faut mettre un lien vers la documentation officielle de MySQL.

3.10.2 Installation du serveur IIP sous Windows

Important :

Le lien qui permet de télécharger la distribution du serveur IIP n'est plus valide (https://iipimage.sourceforge.io/download.shtml).

Important :

Le premier lien qui permet de télécharger le module FCGID du serveur HTTP d'Apache n'est plus valide (http://apache.skazkaforyou.com/httpd/binaries/win32/mod_fcgid-2.3.4-win32-x86.zip).

To do :

Mise a jour des liens.

Manuel de parametrage

Important :

La partie 2.11 Fichier $PleadeDir/WEB-INF/cocoon.xconf n'est plus valabale, il faut la supprimer de la documentation de parametrage.

2.1 Fichier $PleadeDir /WEB-INF/properties/pleade.properties

Notice :

Paramètres de l'application (Tous ces paramétres sont inclus dans pleade.properties).

pleade.version: Compris
pleade.app.version: Compris
pleade.app.name: Compris
pleade.application-id: Compris
pleade.path-sdxapp: Compris
pleade.auth-file: Compris
pleade.auth-sql: Compris
pleade.auth-ldap: Pas compris, c'est quoi un annuaire LDAP ?
pleade.auth-arkheia: Pas compris, c'est quoi Arkhéia ?
pleade.auth-src.default: Compris
pleade.show-pleade-zones: Compris

Notice :

Paramètres du module EAD-EAC (Tous ces paramétres sont inclus dans pleade.properties).

pleade.eadeac.list-sep: Pas compris
pleade.manage.defaulthpp: Compris
pleade.thesx-url: Compris
pleade.supported-video-formats: Compris
pleade.supported-audio-formats: Compris
pleade.rmtp-server-url: Compris

Notice :

Paramètres d'affichage des images (Tous ces paramétres sont inclus dans pleade.properties).

pleade.cache-images-transformees: Compris
pleade.formats-sortie: Compris
pleade.timeout-image-reader: Compris
pleade.module-img-server-url: Compris

Notice :

Propriétés de développement (Tous ces paramétres sont inclus dans pleade.properties).

pleade.check-reload: Pas compris
pleade.cache-at-startup: Pas compris
pleade.internal-only: Pas compris
pleade.distribution: Compris
pleade.publication.debug: Compris

Notice :

Proprétés de mise en place d'une authentification depuis un serveur LDAP ou Active Directory (Tous ces paramétres sont inclus dans pleade.properties).

pleade.auth-ldap.url: Compris
pleade.auth-ldap.port: Compris
pleade.auth-ldap.version: Compris
pleade.auth-ldap.is-active-directory: Compris
pleade.auth-ldap.context: Pas compris
pleade.auth-ldap.login-dn: Pas compris, c'est quoi un 'dn' ?
pleade.auth-ldap.pwd: Compris
pleade.auth-ldap.security-protocol: Compris
pleade.auth-ldap.authentification: Compris
pleade.auth-ldap-debug: Pas compris

2.2 Fichier $PleadeDir /WEB-INF/properties/pleade-admin.properties

Notice :

Paramètres généraux (Tous ces paramètres sont inclus dans pleade-admin.properties).

Important :

Le paramètre : pleade.static.content se répete 2 fois dans la documentation, il faut en supprimer 1 (Page 7).

pleade.url-interne : Compris, http://localhost:8080/pleade
pleade.public-url : Compris
pleade.redirect-url : Compris, il faudrait expliquer le terme 'embed'
pleade.static-content : Compris
pleade.theme-dir : Compris
pleade.sdx-data-dir : Compris, il faudrait préciser ce que veut dire UNC
pleade.sdx-auto-optimize : Compris
pleade.sdx-publish-optimize : Compris
pleade.install.type : Pas compris la partie 'expert', il faudrait expliquer ce que veut dire 'datasource'
pleade.sdx-database : Compris
pleade.sdx-ead-repository : Compris
pleade.sdx-eac-repository : Compris
pleade.sdx-oai_dc-repository : Compris
pleade.sdx-qdc-repository : Compris
pleade.persistent.datasource : Pas compris
pleade.log-file-directory : Compris
pleade.zones : Pas compris
pleade.use-locale : Compris

Notice :

Paramètres du module EAD-EAC (Tous ces paramètres sont inclus dans pleade-admin.properties).

pleade.eadeac.fs-pdf : Compris
pleade.eadeac.fs-file : Compris
pleade.ead-docs-dir : Compris
pleade.cdc-src : Pas compris

Notice :

Paramètres du serveur d'images Pleade Images (Tous ces paramètres sont inclus dans pleade-admin.properties).

pleade.img-server.imagemagick-exe : Compris
pleade.img-server.racines : Compris
pleade.images.preparees : Compris
pleade.images.preparees.copier : Compris
pleade.images.filigrane : Compris
pleade.filigrane-gravity : Compris
pleade.nom-fichier-pas-filigrane : Compris
pleade.zones-pas-filigrane : Compris
pleade.taille-mini-filigrane : Pas compris, il faudrait expliquer ce que veut dire 'inclusive'
pleade.publication-user : Compris
pleade.publication-password : Compris

2.6 Fichier $PleadeDir /parametres.xconf

Notice :

Paramètres utiles des modules Pleade (Tous ces paramètres sont inclus dans parametres.xconf).

default-lang : Compris
enable-language-selection : Compris

Notice :

Activation/désactivation de fonctionnalité (Tous ces paramètres sont inclus dans parametres.xconf).

eadeac-active-eac : Compris
eadeac-active-basket : Compris
eadeac-active-basket-zip : Compris
eadeac-basket-zip-include-doc : Compris
eadeac-active-basket-pdf : Compris
eadeac-persistent-basket :Compris
panier-max-resultats : Compris
eadeac-active-pdf : Compris
eadeac-pdf-use-special : Compris
eadeac-active-synch-toc : Compris

Notice :

Personnalisation liée aux formulaires de recherche/affichage des résultats, cadre de classement, rubrique (Tous ces paramètres sont inclus dans parametres.xconf).

ead-max-results : Compris
ead-admin-max-results : Pas compris, c'est quoi un set OAI  ?
sort-limit : Compris
nb-keyquery-max : Compris
ead-docs-not-searchable : Compris
ead-cdc-results-auto-expend : Pas compris
ead-cdc-auto-expand-results-nb : Pas compris la notion de noeud
eadeac-cdc-result-sort-key : Pas compris, c'est quoi les IR ?
eadeac-mosaic-result-sort-key : Pas compris
btn-ead-cdc-auto-expand : Compris
news-days : Compris
news-maxratio : Pas compris, c'est quoi un IR ?
eadeac-suggest-hpp : Compris
eadeac-force-suggestion : Compris
suggest-start-with : Compris
cdc-result-thumb-position : Compris, que veut dire cdc ?
cdc-result-thumb-size : Compris
acces-all-users : :Compris
acces-all-groups : Compris
ead-default-print-result-mode : Pas compris
ead-print-result-mode-activated : Compris
eac-cdc-show-not-illustrated : Compris
eac-mosaic-show-not-illustrated : Compris
eac-tab-show-not-illustrated :Compris
ead-mosaic-show-result-conntext : Compris
ead-mosaic-show-result-conntext-link : Pas compris
ead-mosaic-show-result-titleproper : Compris
ead-mosaic-show-result-titleproper-link : Compris
ead-tab-show-result-cdc-context : Pas compris
eadeac-search-help-mode : Compris
eadeac-navindex-from-input : Compris
eadeac-navindex-firstletters-print-mode : Compris
show-bottom-pagination : Compris
notice-as-modal : Compris
show-search-form-in-result : Compris

Notice :

Personnalisation de l'affichage d'un document dans la fenêtre EAD (Tous ces paramètres sont inclus dans parametres.xconf).

ead-archdesc-toc : Compris
img-thumbnail-size : Compris
img-thumbnail-mosaic-size : Compris
ead-docs-not-searchable-specific-form : Compris
list-doc-for-book-viewer : Pas compris

Notice :

Personnalisation de la visionneuse (Tous ces paramètres sont inclus dans parametres.xconf).

nombre-maximal-images : Compris

Notice :

Personnalisation des impressions (Tous ces paramètres sont inclus dans parametres.xconf).

eadeac-images-in-pdf : Compris
droits : Compris

Notice :

Personnalisation de l'entrepôt OAI (Tous ces paramètres sont inclus dans parametres.xconf).

ead-oai-repo-name : Pas compris
ead-oai-repo-admin-email : Pas compris
ead-oai-repo-nb : Pas compris
ead-oai-repo-records : Compris
ead-oai-pleade-title : Pas compris
ead-oai-pleade-title-sep : Compris
ead-oai-pleade-title-lang : Compris
ead-oai-includehasPart : Compris
ead-oai-inheritDesc : Compris
ead-oai-relationMode : Compris

Notice :

Personnalisation des boutons vers les réseaux sociaux (Tous ces paramètres sont inclus dans parametres.xconf).

bitly-key-api : Compris
ead-facebook-btn-search-activated : Compris
ead-twitter-btn-search-activated : Compris
ead-gplus-btn-search-activated : Compris
ead-facebook-btn-ead-activated : Compris
ead-twitter-btn-ead-activated : Compris
ead-gplus-btn-ead-activated : COmpris
ead-facebook-btn-viewer-activated : Compris
ead-twitter-btn-viewer-activated : Compris
ead-gplus-btn-viewer-activated : Compris
fede-base-rank : Pas compris

Mise a jour du framework Cocoon vers la version 2.1.13

Si vous compilez Cocoon 2.1.13 avec Java 9 ou une version supérieure une erreur apparaît : Djava.endorsed.dirs=lib/endorsed. A partir de Java 9, ce paquet n'est plus supporté.