Extension:Collection

**Manuel des extensions MediaWiki**
Collection; État de la version : non-maintenu
Implémentation	Page spéciale, MyWiki
Description	Permet d'organiser vos sélections personnelles de pages au sein d'une collection qui peut être modifiée, enregistrée, et récupérée facultativement en tant que fichier PDF, ODF ou DocBook (XML)
Auteur(s)	PediaPress.com; Siebrand Mazeland; Marcin Cieślak;
Dernière version	1.8.0
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
Modifie la base; de données	Non
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension ; Git [?]: Télécharger la branche master de Git; parcourir le dépôt (GitHub); historique des validations (commits); contributeurs du dépôt (GitHub); relecture du code; ; README
Exemple	wiki.openoffice.org
	Paramètres $wgCollectionMaxSuggestions; $wgCollectionMWServeCert; $wgCollectionPortletFormats; $wgCollectionRendererSettings; $wgCollectionMWServeURL; $wgCollectionDisableSidebarLink; $wgCollectionMaxArticles; $wgCollectionSuggestCheapWeightThreshhold; $wgCollectionContentTypeToFilename; $wgCollectionShowRenderNotes; $wgCollectionMWServeCredentials; $wgCollectionDisableDownloadSection; $wgCollectionFormatToServeURL; $wgCollectionLicenseName; $wgCommunityCollectionNamespace; $wgCollectionCommandToServeURL; $wgCollectionSuggestThreshhold; $wgCollectionPortletForLoggedInUsersOnly; $wgCollectionArticleNamespaces; $wgCollectionPODPartners; $wgCollectionFormats; $wgCollectionLicenseURL;
	Droits ajoutés collectionsaveasuserpage; collectionsaveascommunitypage;
	Accroches utilisées OutputPageCheckLastModified; SidebarBeforeOutput; SiteNoticeAfter;
Téléchargements trimestriels	102 (Ranked 63rd)
Utilisé par les wikis publics	1,243 (Ranked 219th)
	Traduire l’extension Collection sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

This page is a translated version of the page Extension:Collection and the translation is 100% complete.

L'extension Collection permet aux utilisateurs d'organiser des sélections personnelles de pages au sein d'un livre. Les collections peuvent être :

modifiées et structurées en utilisant les chapîtres
permanentes, chargées et partagées
organisées comme un livre imprimé sur https://pediapress.com/

Voir l'extrait de presse Les wikis deviennent imprimables pour plus d'informations sur le projet initial.

Documentation et support

L'extension Collection utilise le service Proton pour réaliser la plupart du travail pénible. OCG était utilisé auparavent.

Vous pouvez utiliser le canal IRC #wikimedia-services ^connecter pour contacter les développeurs.

Utiliser le projet MediaWiki-extensions-Collection dans Phabricator pour rapporter les bogues.

Si vous installez l'extension, un guide détaillé sur la manière de préparer votre wiki (modèles, pages d'aide, catégories) est disponible sur meta.wikimedia.org.

Ecrans

Il y existe une présentation qui décrit les fonctionnalités de base – disponible sur YouTube (allemand, 2:45 minutes).

Création de collections d'articles inter-wiki

Le service OCG prend en charge cela mais l'extension Collection ne le fait pas (pas encore — les patches sont les bienvenus !). Vous pouvez utiliser les outils de bas niveau mw-ocg-bundler et mw-ocg-latexer pour créer des collections inter-wiki, ou utiliser https://pediapress.com/collection/ à cet effet, voir le ticket 408.

Installation

Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Collection dans votre dossier extensions/.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Collection
Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
```
wfLoadExtension( 'Collection' );
```
Configurer l'extension selon les besoins
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Veuillez également lire le README inclus pour les instructions de configuration détaillées de l'extension. If you use MediaWiki 1.4.1 you have to use the following Command:

cd extensions/

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Collection --branch REL1_41

Serveur local de rendu (OCG)

Installing a development instance contient la documentation la plus récente.

Configuration

Génération des PDF, export OpenDocument et DocBook

Il est facile d'activer le support des PDF (ODF, DocBook) avec cette extension. Il est configuré par défaut pour utiliser le serveur https://tools.pediapress.com/. C'est pourquoi les sites (à faible traffic) accessibles sur internet n'ont pas besoin d'installer leur propre serveur PDF. Etapes :

Il suffit d'installer et de configurer l'extension Collection en utilisant la valeur par défaut http://tools.pediapress.com/mw-serve/ pour $wgCollectionMWServeURL (voir le fichier README de l'extension Collection pour les instructions) et assurez-vous que l'API MediaWiki (api.php) est activée dans votre installation MediaWiki.
Certains utilisateurs rapportent qu'il faut installer PDFtk.

Il n'est pas nécessaire d'installer Python, ReportLab, mwlib etc. ! Notez néanmoins que pour utiliser ce service, votre wiki doit être accessible depuis Internet et doit être accessible aussi aux utilisateurs non connectés et à ceux dont les informations de connexion sont configurées (voir README pour les instructions).

Allez voir l'article d'exemple sur le Système solaire de la Wikipedia anglophone, généré sous forme de PDF en utilisant cette technique.

Paramètres avancés et optionnels

La plupart des wikis n'auront jamais besoin de savoir ce qui se passe après. Vérifiez le fichier PHP principal pour voir toutes les variables globales que vous pouvez configurer ainsi que leur signification. Certains d'entre eux sont utiles pour modifier les exportations dans de nombreux cas.

Impression à la demande

Depuis la version 1.6, l'extension propose la variable $wgCollectionPODPartners utilisée pour définir les fournisseurs disponibles du service d'impression à la demande.

Par défaut, le service PediaPress est utilisé :

$wgCollectionPODPartners = [
    'pediapress' => [
        'name' => 'PediaPress',
        'url' => 'http://pediapress.com/',
        'posturl' => 'http://pediapress.com/api/collections/',
        'infopagetitle' => 'coll-order_info_article'
    ],
];

C'est un tableau d'éléments, chacun d'entre eux sera listé comme un fournisseur possible d'impression à la demande. Les paramètres sont :

name: nom court du fournisseur
url: URL qui donne les informations complémentaires quand la page d'information n'existe pas
posturl: URL du service web d'impression actuel
infopagetitle: nom du message système MediaWiki (tel que visible dans l'espace de noms MediaWiki:) contenant le titre de la page qui sera utilisé pour décrire brièvement le fournisseur. La valeur par défault (pour PediaPress) est MediaWiki:Coll-order info article, qui pointe sur les informations pour les commandes PediaPress. Si cette page existe, elle est utilisée pour afficher les informations concernant le service d'impression des livres PediaPress.

Il est également possible de désactiver les impressions à la demande en déclarant :

$wgCollectionPODPartners = false;

Voir T35536 pour d'autres informations concernant cette fonctionnalité.

Vous pouvez également configurer les formats de fichier disponibles :

$wgCollectionFormats = [
    'rl' => 'PDF', # enabled by default
    'odf' => 'ODT',
    'docbook' => 'DocBook XML',
    'xhtml' => 'XHTML 1.0 Transitional',
    'epub' => 'e-book (EPUB)',
    'zim' => 'Kiwix (OpenZIM)',
];

Voir README pour d'autres options de configuration.

Droits utilisateurs pour enregistrer des livres

Pour permettre aux utilisateurs de sauvegarder les livres à la fois dans leur espace utilisateur et dans l'espace communautaire, ajoutez les lignes suivantes dans votre LocalSettings.php :

$wgGroupPermissions['user']['collectionsaveascommunitypage'] = true;
$wgGroupPermissions['user']['collectionsaveasuserpage'] = true;

Ajouter les liens à un autre endroit

Si vous voulez ajouter les liens à un autre endroit, par exemple dans le menu Outils personnels, vous pouvez le faire en les ajoutant dans le porte-documents correspondant. Par exemple, avec l'habillage Vector vous pouvez faire cela en complétant le fichier skins/Vector.php pour qu'il ressemble à :

	<h3><?php $this->msg( 'personaltools' ) ?></h3>
	<ul<?php $this->html( 'userlangattributes' ) ?>>
<?php
		$personalTools = $this->getPersonalTools();

		/* Links to create a PDF file/a book start */
		if ( class_exists('CollectionHooks') ) {
			$collectionURLs = CollectionHooks::getPortlet($this->getSkin());

			if ( $collectionURLs !== false ) {
				/* Put the links of the Collection extension below the last item. */
				$personalTools += $collectionURLs;
			}
		}
		/* Links to create a PDF file/a book end */

		foreach ( $personalTools as $key => $item ) {
			echo $this->makeListItem( $key, $item );
		}

Vous pouvez toujours modifier l'ordre des liens dans le porte-documents en modifiant $personalTools directement avant d'exécuter la boucle foreach.

L'implémentation ci-dessus à l'inconvénient de ne pas afficher les bulles d'aide pour les deux nouveaux liens insérés. Une solution pour cela est encore en attente et serait grandement appréciée.

Définir le préfixe du livre

Pour modifier le préfixe par défaut du nom du livre, changer le message MediaWiki:Coll-community book prefix.

Cache

Les versions récentes stockent les livres générés dans un cache. Les collections qui ont été exportées précédemment par les utilisateurs doivent être disponibles pour téléchargement presque immédiatement, plutôt qu'après plusieurs minutes de génération; la version en cache peut être actualisée en suivant le lien proposé sur la page de téléchargement.

Livres imprimés avec PediaPress

PediaPress est un service qui offre des livres imprimés basés sur le contenu du wiki. Ce service est aussi intégré dans cette extension (il peut être désactivé).

Voir aussi

PDF export — résumé de toutes les extensions qui exportent en PDF
Bookshelf — regroupe les pages wiki pour créer des livres et aussi les exporter au format PDF

Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki.

Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets :

Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer.

Collection État de la version : non-maintenu

Implémentation	Page spéciale , MyWiki
Description	Permet d'organiser vos sélections personnelles de pages au sein d'une collection qui peut être modifiée, enregistrée, et récupérée facultativement en tant que fichier PDF, ODF ou DocBook (XML)
Auteur(s)	PediaPress.com Siebrand Mazeland Marcin Cieślak
Dernière version	1.8.0
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
Modifie la base de données	Non
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git ^[?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code README
Exemple	wiki.openoffice.org
Paramètres $wgCollectionMaxSuggestions $wgCollectionMWServeCert $wgCollectionPortletFormats $wgCollectionRendererSettings $wgCollectionMWServeURL $wgCollectionDisableSidebarLink $wgCollectionMaxArticles $wgCollectionSuggestCheapWeightThreshhold $wgCollectionContentTypeToFilename $wgCollectionShowRenderNotes $wgCollectionMWServeCredentials $wgCollectionDisableDownloadSection $wgCollectionFormatToServeURL $wgCollectionLicenseName $wgCommunityCollectionNamespace $wgCollectionCommandToServeURL $wgCollectionSuggestThreshhold $wgCollectionPortletForLoggedInUsersOnly $wgCollectionArticleNamespaces $wgCollectionPODPartners $wgCollectionFormats $wgCollectionLicenseURL
Droits ajoutés collectionsaveasuserpage collectionsaveascommunitypage
Accroches utilisées OutputPageCheckLastModified SidebarBeforeOutput SiteNoticeAfter
Téléchargements trimestriels	102 (Ranked 63^rd)
Utilisé par les wikis publics	1,243 (Ranked 219^th)
Traduire l’extension Collection sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue