Lightium : Différence entre versions

De ediwiki
Aller à : navigation, rechercher
(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>&amp;itemType=journalArticle&amp;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&amp;include=citation,data&amp;limit=100&amp;start=%27.$settings[%27int2%27].$settings[%27public3%27].%27&amp;since=%27.$settings[%27int1%27]</code>

Version du 7 mars 2017 à 13: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.


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 bouton Ajouter 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:

  1. Définit le préfixe pour requêter sur un groupe Zotero, ou un utilisateur : peut être groups ou users
  2. définit l'identifiant du groupe ou de l'utilisateur.
  3. définit le type d'item et le style utilisé. Exemple sur ecrituresnumeriques.ca : &itemType=journalArticle&style=lettres-et-sciences-humaines-fr
  4. 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.
  5. définit l'index du premier résultat. Correspond au paramètre start (integer) de l'API Zotero. Prend ici la valeur 0 la plupart du temps.
  6. pas utilisé
  7. pas utilisé
  8. pas utilisé
  9. 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]