source: spip-zone/_squelettes_/RevueLigne/documentation.html @ 113060

Last change on this file since 113060 was 103912, checked in by spip.franck@…, 2 years ago

Petit retour en arrière, pour que le commit https://zone.spip.org/trac/spip-zone/changeset/103869/_squelettes_ ne concerne que les urls et pas les noms

File size: 12.8 KB
Line 
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml">
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5<title>Document sans nom</title>
6<style type="text/css">
7<!--
8strong {
9        color: #F00;
10}
11u {
12        color: #00FF40;
13}
14u {
15        color: #009124;
16}
17em {
18        color: #00F;
19}
20-->
21</style>
22</head>
23
24<body>
25<p align="center"><strong>RevueLigne 1.0. - par Tony Gheeraert</strong></p>
26<p align="center">&nbsp;</p>
27<p align="center"><strong>Documentation</strong></p>
28<p><strong>1.  Principe et fonctionnalités</strong><br />
29  RevueLigne, distribué sous licence GNU/GPL, est un jeu de squelettes Spip conçu pour l’édition de revues  à caractère académique. Construit à partir de la dist, facilement adaptable,  pourvu d’un modèle éditorial très souple, et sobre en ressources, il se distingue de la plupart des solutions  existantes, lourdes et difficiles à administrer.  RevueLigne a été développé dans le cadre d'un laboratoire de l'université de Rouen spécialisé dans l'édition (Cérédi), dans le but de répondre aux besoins spécifiques des utilisateurs dans le domaine des sciences humaines. Sa mise en œuvre ne demande pas de compétences  particulières en informatique.</p>
30<p>RevueLigne gère tous les champs nécessaires (table des matières, index, résumés/abstracts, notices bio-bibliographiques des auteurs, illustrations et le cas échéant couverture). Il génère aussi, de façon automatique, une table générale des numéros, et s'occupe d'insérer automatiquement les informations de r&eacute;f&eacute;rencement (section &quot;pour citer cet article&quot; au bas de chaque page). </p>
31<p align="justify"><em></em>RevueLigne dispose de fonctionnalités que d'autres systèmes, comme Lodel, n'offrent pas ou pas au même degré, comme la possibilité facultative de mettre en ligne une première et une quatrième de couverture. De même, RevueLigne offre la possibilité d'insérer facilement des éditoriaux ainsi que des textes d'accueil et de présentation. Le squelette admet aussi des rubriques d'informations générales (vie de la revue, actualités, etc.). RevueLigne autorise également la publication de brèves, et prévoit une maquette distincte pour d'éventuels numéros spéciaux.</p>
32<p>RevueLigne est par ailleurs moins fermé que Lodel: basé sur les squelettes Dist, RevueLigne bénéficie en effet de toutes les possibilités incluses de façon native dans Spip (par exemple les forums de discussion possibles pour chaque article), et admet, à des fins de personnalisation, l'adjonction de tous les plugins disponibles.</p>
33<p><strong>2. Installation</strong> <strong>et pré-requis</strong></p>
34<p>RevueLigne fonctionne sur les versions Spip 2.0 et ultérieures. Son installation est simple: il suffit de copier le dossier squelettes à la racine de spip.</p>
35<p>Le bon fonctionnement de RevueLigne nécessite la présence de quelques plugins courants, ainsi que de l'activation de quelques paramètres dans le menu configuration.</p>
36<p><u>2.1. Paramétrage de Spip</u></p>
37<p>Dans la page &quot;Configuration - contenu du site&quot; de la partie administration, il convient d'activer les paramètres suivants:</p>
38<ul>
39  <li>Zone articles: &quot;surtitre&quot;, &quot;sous-titre&quot;, &quot;descriptif&quot;, &quot;chapeau&quot;, &quot;texte&quot;, &quot;auteur&quot;</li>
40  <li>Zone rubriques: &quot;descriptif&quot; et &quot;texte&quot;</li>
41  <li>Utiliser les mots clés</li>
42  <li>Utiliser les logos </li>
43  <li>Autoriser les documents joints aux articles</li>
44</ul>
45<p>Dans la page &quot;Configuration - Fonctions avancées&quot;, il faut cocher la case: &quot;gérer les statistiques&quot;</p>
46<p>Dans la page &quot;Edition - mots clés&quot;, il faut créer quatre mots-clés (veiller à bien respecter l'orthographe et la casse de ces quatre mots)<em>:</em></p>
47<ul>
48  <li>edito</li>
49  <li>infos</li>
50  <li>couverture</li>
51  <li>quatrieme</li>
52</ul>
53<p><u>2.2. Plugins</u></p>
54<p>Les plugins suivants doivent être installés et activés&nbsp;:</p>
55<ul>
56  <li>Cfg</li>
57  <li>Compositions</li>
58  <li>Compteur de visites graphique</li>
59  <li>Couteau Suisse</li>
60  <li>Spip-Bonux</li>
61</ul>
62<p>Deux plugins doivent être paramétrés comme suit:</p>
63<ul>
64  <li><em>Compteur de visites graphiques</em>: créer un compteur graphique pour tous les articles, et un autre pour le nombre total de visites.</li>
65  <li><em>Couteau suisse</em>: activer au moins les lames suivantes:&nbsp;Supprime  le numéro , Balise introduction et Visiteurs  connectés. Les lames suivantes sont vivement conseillées&nbsp;: Belles  puces, Corrections automatiques, Guillemets typographiques et ancres douces.</li>
66</ul>
67<p><strong>3. Utilisation</strong></p>
68<p><u>3.1. Notes générales</u></p>
69<p>Il est nécessaire d'inclure pour le site un logo contenant le nom de la revue (par exemple de taille 400x55). Le champ &quot;Nom de votre site&quot; n'est en effet pas affiché dans l'en-tête de la page.</p>
70<p>Les titres des rubriques et des articles doivent impérativement être  précédés d'un numéro (un nombre suivi d’un point et d’un espace). Le numéro est utilisé entre  autres comme index de classement des articles; il disparaît à l’affichage. (Je conseille  vivement de numéroter de 10 en 10, ce qui permet d’insérer un article oublié  sans avoir à tout renuméroter).</p>
71<p>Exemple:</p>
72<ul>
73  <li>05. Couverture</li>
74  <li>10. Avant-propos</li>
75  <li>20. Titre du premier article</li>
76  <li>30. Titre du second article</li>
77</ul>
78<p>Par ailleurs, on notera que les styles du plugin Compositions ci-dessous mentionnés sont à sélectionner, dans la partie administration, via le menu situé sur la page de modification des articles et rubriques, en bas à gauche.</p>
79<p><u>3.1. Création d'un numéro de revue et table du numéro</u></p>
80<p>Un numéro de revue correspond à un secteur de spip, c'est-à-dire une rubrique située à la racine de spip. Il convient de renseigner les champs comme indiqué:</p>
81<ul>
82  <li>&quot;Numéro, année&quot;: entrer les indications de volume, le numéro et l'année (précédés de l'index de classement suivi d'un point), par exemple: &quot;10. 54, III, 2010&quot;</li>
83  <li>&quot;Précisions sur le titre&quot;: le cas échéant, indiquer les précisions nécessaires. Exemple: &quot;Mélanges en l'honneur de M. le Professeur Untel&quot;.</li>
84  <li>&quot;Titre du numéro&quot;: A remplir le cas échéant, en cas de numéro entièrement thématique.</li>
85  <li>&quot;Logo&quot;: si une première de couverture est utilisée, on utilisera comme logo une version petit format de cette couverture.</li>
86</ul>
87<p>Stye de composition: laisser le bouton radio sur &quot;Aucune composition&quot;.</p>
88<p>N.B. La liste des articles inclus dans le numéro s'affichera automatiquement sur la page du numéro, au fur et à mesure de leur injection.</p>
89<p><u>3.2. Injection du contenu de la revue</u></p>
90<p> <em>3.2.1. Textes péritextuels</em></p>
91<p>Les textes péritextuels (couverture, avant-propos, etc.), numérotés à leur ordre, sont des articles (au sens spip) placés directement dans les secteurs. Ils doivent être affectés du style de Composition &quot;ArticleRubriquePrincipale&quot;.</p>
92<p><em>Nota bene :</em></p>
93<ul>
94  <li>La couverture, si elle existe, est un article affecté de la Composition ArticleCouverture et du mot-clé &quot;couverture&quot;. L'article couverture ne comporte normalement qu'une illustration figurant la première de couverture du numéro.</li>
95  <li>S'il existe, au sein d'un numéro, un article inséré directement dans le secteur (par exemple un article avant-propos), et affecté du mot-clé &quot;quatrième&quot;, la partie de cet article qui aura été isolée par les balises &lt;intro&gt; et &lt;/intro&gt; apparaîtra sur la page du numéro, en bleu, juste au-dessous du titre et en vis-à-vis du logo: cette courte présentation fait ainsi office de &quot;quatrième de couverture&quot;.</li>
96</ul>
97<p><em>3.2.2. Les articles de la revue</em></p>
98<p>Pour que l'affichage soit correct, les textes autres que péritextuels (et en partculier les articles proprement dits), ne doivent <em>pas</em> dépendre directement des secteurs, mais êtres insérés dans des sous-rubriques comme précisé ci-après.</p>
99<ul>
100  <li>En cas de numéro entièrement thématique: on créera une seule sous-rubrique dont le titre sera identique à celui du numéro de la revue, et on mettra tous les articles dans cette sous-rubrique</li>
101  <li>En cas de numéro comportant plusieurs parties thématiques (trois articles sur &quot;La forêt en France sous Louis XIV&quot;, suivis de quatre articles de &quot;Varia&quot;), on créera autant de sous-rubriques que nécessaires, et on mettra les articles dans chaque sous-rubrique correspondante.</li>
102  <li>En cas de numéro composé d'articles disparates, on créera une seule sous-rubrique intitulée par exemple &quot;Varia&quot; afin d'y disposer les articles.</li>
103  <li>Les illustrations sont traités conformément aux squelettes habituels de la dist.</li>
104</ul>
105<p>On n'affectera ces articles ni d'un mot-clé, ni d'une composition particulière.</p>
106<p>Pour chaque article, les champs seront remplis comme précisé dans l'interface d'administration (&quot;Auteur&quot;, &quot;établissement de rattachement&quot;, etc.). </p>
107<p><em>Nota bene: </em></p>
108<ul>
109  <li>Tous les champs (&quot;Auteur&quot;, &quot;établissement de rattachement&quot;, &quot;Texte&quot;, etc.), sauf le titre, sont facultatifs, afin d'assouplir le plus possible le modèle éditorial. On peut très bien décider ainsi de ne mettre en ligne que des articles en PDF, par exemple, sans que l'affichage soit perturbé.</li>
110  <li>La &quot;Pagination&quot; ne concerne que les revues qui proposent des articles paginés, par exemple en PDF.</li>
111  <li>L'adjonction d'un PDF à un article a pour effet de provoquer l'affichage d'une zone &quot;Article au format PDF&quot; sur la page publique.</li>
112</ul>
113<p><u>3.3. Les rubriques d'information générale</u></p>
114<p>Un ou plusieurs secteurs peuvent être utilisés non comme numéros de revue, mais comme des rubriques à usage libre, destinés par exemple à regrouper des informations sur la revue, ou consacrées à des actualités pouvant intéresser les lecteurs. Pour que ces rubriques spéciales s'affichent correctement, il convient que</p>
115<ul>
116  <li>ces rubriques d'information soient affectées du mot-clé &quot;infos&quot; <em>et</em> du style de composition &quot;RubInfos&quot;</li>
117  <li>les articles situés dans ces rubriques soient affectés du mot-clé &quot;infos&quot; <em>et </em>du style de composition &quot;Info&quot;</li>
118</ul>
119<p><u>3.4. Editorial</u></p>
120<p>Le ou les articles affectés du mot-clé &quot;edito&quot; seront visibles sur la page d'accueil du site. Pour qu'ils soient affichés correctement, ils doivent également être affectés du style de Composition &quot;Edito&quot;.</p>
121<p>N.B. Un même article peut être affecté simultanément des mots clés &quot;edito&quot; et &quot;infos&quot;</p>
122<p><u>3.5. Cas particulier: livre électronique</u></p>
123<p>En affectant un article du style de Composition &quot;Edition électronique&quot; et en lui adjoignant des documents en PDF, on peut proposer, sous forme de e-paper, des livres électroniques assimilés à des numéros spéciaux de la revue. </p>
124<p>N.B.: Toutefois, pour la mise en ligne de volumes éléctroniques non liés à une revue, préférez le squelette Publigne, du même auteur.</p>
125<p>&nbsp;</p>
126<p><strong>4. Informations diverses</strong></p>
127<p>a) La macro Word d'Alexis, qui permet la conversion de texte Word en code Spip, a été modifiée en vue d'être utilisée conjointement avec RevueLigne (prise en compte de styles de citations, conversion des italiques dans les notes, numérotation facultative des paragraphes, interface). Elle est incluse dans le squelette et peut faciliter l'injection de contenu. Son utilisation n'a rien d'impératif. Mode d'emploi: double-cliquer et suivre les instructions (nécessite Word sur le poste).</p>
128<p>a) Le jeu de squelettes RevueLigne est proposé sous licence GNU/GPL. </p>
129<p>b) Coordonnées de l'auteur: Tony Gheeraert, Université de Rouen, Département de Lettres modernes, centre de recherches éditer-interpréter (Cérédi).<br />
130  Adresse postale: Faculté des Lettres, rue Lavoisier, 76 821 Mont Saint Aignan cedex.<br />
131Courriel: <a href="mailto:tony.gheeraert@univ-rouen.fr">tony.gheeraert@univ-rouen.fr</a>.<br />
132N'hésitez pas à me contacter pour toute question relative à RevueLigne.</p>
133<p>c) Pour la mise en ligne de volumes, d'actes de colloques, d'ensemble d'articles, de monographies, d'ouvrages collectifs, ou de journ&eacute;es d'&eacute;tude, préférez le squelette &quot;Publigne&quot;, disponible également sur spip-contrib.</p>
134</body>
135</html>
Note: See TracBrowser for help on using the repository browser.