Lightium : Différence entre versions
(ajouts config initiale) |
(Plugin Zotero) |
||
Ligne 91 : | Ligne 91 : | ||
* identifier l'élément à modifier | * identifier l'élément à modifier | ||
clique droit inspecter sous chrome. Dans les feuilles de style | clique droit inspecter sous chrome. Dans les feuilles de style | ||
+ | |||
+ | == Plugin zotero == | ||
+ | |||
+ | === Principes === | ||
+ | |||
+ | Le plugin Zotero de Lightium exploite [https://www.zotero.org/support/dev/web_api/v3/start l'API de Zotero] pour moissonner les entrées bibliographiques d'un groupe ou d'un utilisateur. Il transforme les entrées bibliographiques moissonnées en article dans la base de données Lightium, et considère les métadonnées associées à l'entrée comme des mots-clés Lightium. | ||
+ | |||
+ | Ces articles peuvent ainsi être distribués sur les différentes pages ''Catégories'' ou ''Sous-catégories'' du site en fonction des métadonnées associées aux entrées bibliographiques : auteurs, mots-clés, type d'entrée, etc. | ||
+ | |||
+ | === Fonctionnement === | ||
+ | |||
+ | Pour ajouter le plugin zotero au site: | ||
+ | |||
+ | * cliquer sur le bouton <code>Plugins</code> puis dans la liste des plugins sur le bouton <code>Ajouter un plugin</code>. | ||
+ | * Choisir <code>Zotero</code> dans le menu déroulant et configurer les 5 premiers champs du plugin (voir Configuration du plugin). | ||
+ | * Sauvegarder. | ||
+ | |||
+ | '''Il est nécessaire d'initier le plugin''' afin de lancer la requête Zotero et de récupérer les données bibliographiques. Pour cela, il suffit d'ouvrir dans son navigateur l'url : http://monsite.com/fr/Plugins/ en remplaçant <code>monsite.com</code> par le nom de domaine, et <code>/fr/</code> par la langue du site par défaut. | ||
+ | |||
+ | Cette procédure est nécessaire pour mettre à jour les données sur le site lightium, et peut donc être répétée chaque fois que nécessaire. | ||
+ | |||
+ | === Configuration du plugin === | ||
+ | |||
+ | Le plugin exploite 5 champs sur les 9 disponibles: | ||
+ | |||
+ | # Définit le préfixe pour requêter sur un groupe Zotero, ou un utilisateur : peut être <code>groups</code> ou <code>users</code> | ||
+ | # définit l'identifiant du groupe ou de l'utilisateur. | ||
+ | # définit le type d'item et le style utilisé. Exemple sur [http://ecrituresnumeriques.ca ecrituresnumeriques.ca] : <code>&itemType=journalArticle&style=lettres-et-sciences-humaines-fr</code> | ||
+ | # définit l'incrément de modification de la bibliothèque Zotero, correspond au paramètre <code>since</code> (integer) de l'API Zotero. Ce paramètre est nécessaire pour ne pas requêter l'ensemble des données à chaque requête, mais uniquement les derniers changements. | ||
+ | # définit l'index du premier résultat. Correspond au paramètre <code>start</code> (integer) de l'API Zotero. Prend ici la valeur <code>0</code> la plupart du temps. | ||
+ | # pas utilisé | ||
+ | # pas utilisé | ||
+ | # pas utilisé | ||
+ | # pas utilisé | ||
+ | |||
+ | A partir de ces paramètres, le plugin reconstruit l'url suivante (en PHP): | ||
+ | |||
+ | <code>https://api.zotero.org/'.$settings['public1'].'/'.$settings['public2'].'/items?v=3&include=citation,data&limit=100&start=%27.$settings[%27int2%27].$settings[%27public3%27].%27&since=%27.$settings[%27int1%27]</code> |
Version du 7 mars 2017 à 14:15
Lightium est un CMS simple d'utilisation, conçu pour présenter et valoriser le travail des chercheurs. Il structure les contenus en catégories, sous-catégories et articles.
Sommaire
Lancement et configuration
Ecran 1: création de l'utilisateur
rentrer username / mot de passe
Ecran 2: création du site
Nom du site: apparaît dans le Chapeau de la page Home Description: (ou sous-titre) apparaît sous le Nom dans le chapeau de la home. Metadonnées: Titre du site: ce sera le titre de la fenêtre/onglet du navigateur Langue du site: EN, FR
Démarrage
Au démarrage, le site ne contient que les données entrées à la création du site.
Pour faire des modifications, il est nécessaire de se connecter avec le compte précédemment créé.
Bouton «Connexion» (en bas à gauche de la page)
Une fois connecté, l'interface passe en mode édition et il devient possible d'ajouter et d'éditer le contenu, et de paramétrer le site.
Le site manipule 3 types d'objets auxquels correspondent des pages spécifiques :
1. Catégorie --> Page Catégorie 2. Sous-Catégorie --> Page Sous-Catégorie 3. Article --> Page Article
Les aspects graphiques et l'ergonomie de navigation peuvent être modifiés via le lien Custom CSS. Nous publierons ici différents templates provenant des instances de sites Lightium existants.
Paramètres du site :
- Hôte : si deux noms de domaines permet de rediriger vers la bonne langue, si vide, par défaut en français.
- Logo du site : url de l'image (penser à faire les deux langues)
Le chapeau :
présent sur toutes les pages du site, sauf les articles.
Catégorie
- titre
- description
apparait dans le menu principal
Page Catégorie
Affiche une liste de sous-catégorie
Ajouter une sous-catégorie :
- titre
- chapeau
- description
Chapeau de la page catégorie
- 1 : l'ordre dans le menu
- template : permet d'ajouter une classe (ou plusieurs) au container de listing de la catégorie (dans la page Catégorie)
* Cette classe permettra d'appliquer des règles CSS particulière
Ajouter une sous-catégorie
- cliquer sur ajouter une sous-catégorie
- nom de la sous-catégorie => titre
- chapeau de la sous-catégorie => Sous-titre que l'on voit depuis la page catégorie
- description => Sous titre que l'on voit dans la page sous-catégorie
Sous-catégorie
Ajouter un article
- Titre de l'article
- Chapeau => ce qui est visible à l'extérieur de l'article + introduction de l'article
- COrps de l'article => texte en HTML
- mise en avant => ajoute l'article dans la liste des articles mis en avant
- liste des sous-catégorie => cocher toutes les sous-catégorie auxquelles l'article appartient.
articles
modifier le css
- identifier l'élément à modifier
clique droit inspecter sous chrome. Dans les feuilles de style
Plugin zotero
Principes
Le plugin Zotero de Lightium exploite l'API de Zotero pour moissonner les entrées bibliographiques d'un groupe ou d'un utilisateur. Il transforme les entrées bibliographiques moissonnées en article dans la base de données Lightium, et considère les métadonnées associées à l'entrée comme des mots-clés Lightium.
Ces articles peuvent ainsi être distribués sur les différentes pages Catégories ou Sous-catégories du site en fonction des métadonnées associées aux entrées bibliographiques : auteurs, mots-clés, type d'entrée, etc.
Fonctionnement
Pour ajouter le plugin zotero au site:
- cliquer sur le bouton
Plugins
puis dans la liste des plugins sur le boutonAjouter un plugin
. - Choisir
Zotero
dans le menu déroulant et configurer les 5 premiers champs du plugin (voir Configuration du plugin). - Sauvegarder.
Il est nécessaire d'initier le plugin afin de lancer la requête Zotero et de récupérer les données bibliographiques. Pour cela, il suffit d'ouvrir dans son navigateur l'url : http://monsite.com/fr/Plugins/ en remplaçant monsite.com
par le nom de domaine, et /fr/
par la langue du site par défaut.
Cette procédure est nécessaire pour mettre à jour les données sur le site lightium, et peut donc être répétée chaque fois que nécessaire.
Configuration du plugin
Le plugin exploite 5 champs sur les 9 disponibles:
- Définit le préfixe pour requêter sur un groupe Zotero, ou un utilisateur : peut être
groups
ouusers
- définit l'identifiant du groupe ou de l'utilisateur.
- définit le type d'item et le style utilisé. Exemple sur ecrituresnumeriques.ca :
&itemType=journalArticle&style=lettres-et-sciences-humaines-fr
- définit l'incrément de modification de la bibliothèque Zotero, correspond au paramètre
since
(integer) de l'API Zotero. Ce paramètre est nécessaire pour ne pas requêter l'ensemble des données à chaque requête, mais uniquement les derniers changements. - définit l'index du premier résultat. Correspond au paramètre
start
(integer) de l'API Zotero. Prend ici la valeur0
la plupart du temps. - pas utilisé
- pas utilisé
- pas utilisé
- pas utilisé
A partir de ces paramètres, le plugin reconstruit l'url suivante (en PHP):
https://api.zotero.org/'.$settings['public1'].'/'.$settings['public2'].'/items?v=3&include=citation,data&limit=100&start=%27.$settings[%27int2%27].$settings[%27public3%27].%27&since=%27.$settings[%27int1%27]