Beespip

Nouvelle version

Beespip Documentation — 2012-05-11T13:18:32Z

Voici une nouvelle version de Beespip qui est articulée autour de Zpip pour faciliter la création de nouvelles pages. L'objectif de cette refonte était de simplifier la gestion des contenus et les options de présentation. Pour cela les une grande partie des mots clés a été supprimée et ceux restant sont essentiellement destinés à la mise en avant des articles en pages d'accueil.

Vous pouvez mettre à jour une version antérieure de Beespip en suivant la procédure décrite.

Il reste encore quelques éléments à finaliser, notamment les fichiers de langues et traductions. Merci par avance de vos retours.

Vous pouvez retrouver l'ancien site à l'adresse suivante : http://www.beespip.org/archives/

BeeSpip v3.0 [1154]

Beespip Documentation — 2012-04-26T13:04:42Z

Voici la nouvelle version de BeeSpip 3.0.
Il est conseillé d'utiliser la dernière version de SPIP 2.1.14

Nous remercions toutes les personnes qui participent d'une façon ou d'une autre au développement de BeeSpip (utilisation, suggestions, évocations des problèmes rencontrés, besoins exprimés...)..
Nous les remercions également par avance des différents retours et suggestions éventuelles, via les réactions aux articles, qui nous permettront d'apporter corrections et améliorations à cette nouvelle version.

Nous vous conseillons de consulter la documentation mise à votre disposition pour vous accompagner dans l'usage de BeeSpip.

Mises en pages de rubriques et d'articles

Beespip Documentation — 2012-04-26T10:20:06Z

Réglage par défaut


Rubrique - Mise en page par défaut


Article - Mise en page par défaut

Autres mises en page

Vous pouvez installer le plugin "Compositions" comme cela est conseillé dans l'article Plugins complémentaires afin de pouvoir sélectionner pour chaque rubrique et/ou article une composition parmi celles proposées.

Rubriques

Présentation des articles en 2 colonnes
Les articles sont affichés en 2 colonnes, précédés des sous-rubriques, et les autres éléments en pied de page. Le logo de la rubrique est affiché à droite.

Présentation de la rubrique en 3 colonnes
Les articles sont affichés par 3 dans la colonne de gauche, les rubriques au milieu et les brèves, mots clés et sites web à droite.

Présentation des articles et rubriques en 4 colonnes
Les articles sont affichés en 4 colonnes mélangés avec les sous-rubriques, et les autres éléments en pied de page. Le logo de la rubrique est affiché à droite.

Présentation des sites de la rubrique en 2 colonnes
Les sites sont affichés en 2 colonnes, et les autres éléments en colonne de droite de page. Le logo de la rubrique est affiché à droite. Dans ce cas particulier, les articles et sous-rubriques ne sont pas visibles.

Articles

Article avec logo en colonne droite
Le logo est en colonne de droite, et le titre et le chapeau sont sur toute la largeur de la page. Les autres articles, brèves, mots clés et sites web sont à droite.

Article documents en colonne droite
Les documents sont tous listés dans la colonne de droite suivi des autres articles, brèves, mots clés et sites web.

Article en pleine largeur
L'article est affiché sur toute la largeur de la page. Les autres articles, brèves, mots clés et sites web sont en bas de page.

Personnaliser vos squelettes

Beespip Documentation — 2012-04-25T17:23:00Z

Il est probable que les squelettes proposés ne répondent pas entièrement à vos besoins et envies. Voici comment personnaliser votre installation.

Créer à la racine de votre site le dossier "squelettes" si ce dernier n'existe pas.
Ensuite vous pouvez recréer l'arborescence des dossiers du plugin pour y déposer les fichiers modifiés cela vous permettra de pouvoir mettre à jour le plugin sans vous soucier d'écraser vos fichiers personnalisés.

Concernant les feuilles de styles, vous pouvez simplement créer le fichier "perso.css" dans le dossier "squelettes/css" et définir son contenu vous inspirant des fichiers disponibles dans le dossier "css" du plugin. Cela vous permet de surcharger uniquement les styles souhaités en les redéfinissant dans ce fichier.

Vous pouvez aussi définir de nouvelles compositions dans le dossier "squelettes/contenu" en suivant le modèle des compostions du plugin.

Options d'affichage et entête du site

Beespip Documentation — 2012-04-25T16:57:47Z

Ces options permettent de gérer l'entête et le menu du site, ainsi que divers éléments que nous allons détailler.

Bandeau graphique

Le bandeau supérieur utilise une image "par défaut" au format png avec un réglage d'opacité permettant d'afficher par transparence la couleur principale de votre site. Vous pouvez modifier simplement cette image en ajoutant un logo à votre site. Pour cela, il faut cliquer sur l'icône "Configuration" afin d'obtenir l'écran suivant : Ensuite il suffit de télécharger votre image, dont la largeur doit être de 960px et la hauteur celle définie dans les options (c.f. ci-dessous), par défaut 275px.

Gestion de l'entête du site

Cette partie est dédiée aux réglages du bandeau supérieur du site qui inclus le menu.

Afficher le nom et le slogan du site
Vous pouvez afficher en superposition de l'image le nom de votre site et le slogan si vous utilisez le plugin correspondant.
Suivant le résultat souhaité et la position du menu, il est conseillé de réaliser une image contenant le nom et le slogan afin de maitriser les positions respectives.

Hauteur de l'entête
Cette information permet de réduire au d'augmenter la taille de votre bandeau suivant l'importance à lui donner. La hauteur du logo de votre site doit respecter la valeur précisée ici.

Position du menu
Cette valeur permet de positionner votre menu dans le bandeau. Au départ il est placé dans la partie supérieure. La hauteur du menu étant fixé à 45px vous devez en tenir compte pour fixer sa position.

Nombre d'éléments dans le menu
Par défaut le menu est constitué des rubriques racines triées par numéro de titre (ou par titre). La valeur définie ici permet d'afficher seulement les X premières rubriques.
Vous pouvez gérer de manière plus souple le contenu du menu grâce à la mise en œuvre du plugin "Menu", dans ce cas si le nombre d'éléments définis est inférieur à cette valeur alors le menu sera complété par les rubriques racines, suivant le principe décrit précédemment, jusqu'à atteindre le nombre spécifié.

Complément du menu
Ce réglage permet de préciser où se positionneront les rubriques racines complémentaires si votre menu est géré en partie par la méthode ci-dessus, pour atteindre le nombre d'entrées défini.

Largeur du bloc des items de premier niveau
Par défaut les éléments du menu ont des largeurs différentes, qui s'adaptent aux différents contenus, il suffit de définir la valeur à "0", sinon vous pouvez fixer une largeur exprimée en pixels pour que tous les items soient identiques.

Taille des items de premier niveau
Permet de définir la taille de la police du menu exprimée en "em". La valeur par défaut étant 1.1, il faut indiquer une valeur inférieure pour réduire la taille, et une valeur supérieure pour l'augmenter.

Autres options

Emplacement de la recherche
Dans le menu horizontal (réglage par défaut) ou au niveau du "fil d'ariane" si vous souhaitez libérer de l'espace dans votre menu.

Afficher les textes "articles" et "sous-rubriques" dans les pages de rubrique
Permet de masquer les types d'éléments au niveau des rubriques.

Modèle de pagination Par défaut.
Permet de définir la mise en forme des paginations du site.

Date de publication/modification
Permet d'afficher ou pas les dates concernant les articles et les brèves.

Afficher les auteurs des articles
Permet d'afficher ou pas les auteurs des articles

Afficher la date de dernière publication
Permet d'afficher ou pas, la date de dernière publication sur le site en pied de page.

Mise en forme de la page d'accueil

Beespip Documentation — 2012-04-25T16:05:18Z

La page configuration permet de spécifier la mise en forme de la page d'accueil et de préciser les blocs devant s'afficher ainsi que le nombre d'éléments pour certains d'entre eux.

Présentation

La page d'accueil est composé d'une partie principale et d'une colonne de droite.
Cette dernière contient

le mini calendrier (si activé),
des articles spécifiques (suivant la mise en page définie),
des dernières brèves,
des derniers articles syndiqués,
des derniers sites web référencés,
des articles populaires (si activé)

Concernant la partie principale, il existe trois mises en forme possible, accessibles dans le bloc "Choix de la page d'accueil du site".


Page d'accueil - Mise en page par défaut


Page d'accueil - Mise en page avec slide large


Page d'accueil - Mise en page avec slide sur 3 colonnes

Si vous avez sélectionné une mise en page utilisant les slides, vous pouvez personnaliser les images de fond de chacun d'entre eux en définissant un logo à vos articles.
Pour le slide "large, la taille doit être de 682px de large et 432px de haut, sinon 442px de large et 302px de haut

Options

Le bloc "Option de la page d'accueil" permet de spécifier

le nombre maximum d'articles devant s'afficher en "Une".
le nombre de ligne d'articles en "Sous une". Une ligne contenant 3 articles, il vous faudra prévoir un multiple de 3 lors de l'affectation des mots clés.
nombre d'articles dans la colonne de droite

Par défaut, les articles sont triés par date et affichés du plus récent au plus ancien dans les espaces définis ci-dessus. (les X articles les plus récents sont affichés en "Une", suivi des Y lignes de 3 articles en "Sous une" et enfin des Z articles en colonne de droite).
Cependant vous pouvez définir quels articles doivent s'afficher dans les zones respectives via l'affectation des mots clés

actualites_une
actualites_sous_une
actualites_colonne_droite

Les valeurs définies étant des limites hautes, elles permettent de restreindre le nombre d'éléments affichés dans le cas ou un mot clé est affecté à un nombre d'article supérieur à la valeur. Par contre, si le mot clé est affecté 2 fois alors que vous avez spécifié une valeur de 6 pour le nombre maximum d'éléments, alors la zone ne contiendra que les 2 articles retenus.

Une fois ces articles affichés, les restants seront listés sur 2 colonnes si l'option "Afficher les autres articles en bas de page" est active.

"Afficher les articles les plus consultés" permet d'afficher en bas de la colonne de droite, le bloc contenant les 5 articles les plus "populaires"

Vous avez accès au réglage "Utiliser le calendrier public" seulement si le plugin "Agenda" est activé. Cela permet d'afficher le mini calendrier et la liste des événements à venir en page d'accueil ainsi que les événement sur les pages d'articles.

Configurer Beespip

Beespip Documentation — 2012-04-25T15:55:56Z

La configuration du plugin est accessible au survol de l'icône "Configuration" via le lien "Configurer Beespip"

La page propose de gérer les options concernant la page d'accueil, ou d'accéder aux pages "Options d'affichage" et "Gestion des couleurs".

Plugins complémentaires

Beespip Documentation — 2012-04-25T12:29:13Z

Plugins pris en charge par le squelette

Accès restreint
Permet de limiter l'accès à certaines rubriques à une liste d'auteurs spécifiques. Il permet aussi d'utiliser son site en mode "intranet".

Agenda
Permet d'ajouter des événements aux articles, avec date de début et de fin, et créneau horaire.

Article PDF
Permet de convertir un article sous forme de fichier PDF.

Compositions
Permet de sélectionner des mises en page alternatives pour vos articles et rubriques.

Crayons
Permet d'éditer vos contenus publiés directement depuis la partie publique du site.

MediaBox
Permet l'utilisation de boites modales.

Menus
Permet de gérer votre menu depuis la partie privée.

Plugins conseillés

Enluminures typographiques
Permet d'ajouter des raccourcis typographiques à la barre d'édition du texte.

Lecteur Multimédia
Permet la lecture et l'affichage de sons et/ou de vidéos.

Médiathèque
Permet de simplifier la gestion de tous vos documents.

Installer et activer Beespip

Beespip Documentation — 2012-04-25T11:59:39Z

Prérequis

disposer d'un hébergement supportant le langage PHP et d'un accès à un serveur de bases de données
- Serveur Apache ou compatible (versions supérieures à la 1.2x)
- PHP 4.4.4, PHP 5.x
- MySQL 4, MySQL 5, PostgreSQL, SQLite2 et 3
connaître les identifiants de connexion au serveur par FTP ainsi que ceux nécessaires à la base de données,
connaître l'adresse URL, le nom de la base de données ainsi que l'identifiant et le mot de passe
avoir installé, ou mis à jour, Spip en version 2.1
avoir installé des plugins nécessaires (procédure d'installation)

Installation

Télécharger Beespip, et placer le contenu du paquet ZIP dans votre dossier plugins/ puis activer le dans l'interface d'administration des plugins.

Vous pouvez désormais configurer Beespip et ajouter des plugins complémentaires pris en charge ou conseillés.

Gérer votre menu

Beespip Documentation — 2012-04-25T08:51:00Z

Réglages par défaut

Par défaut le menu est constitué des rubriques racines triées par numéro de titre (ou par titre).

Voici un exemple, avec la liste des rubriques racines d'un site

Vous remarquerez que la première rubrique n'est pas numérotée, cependant elle est considérée comme ayant le numéro "0", et se trouve donc devant toutes les autres.

Dans la configuration, le "Nombre d'éléments dans le menu" est fixé à 5. Le résultat sur la partie publique sera : les rubriques suivant les 5 premières sont donc ignorées.

Réglages en utilisant le plugin "Menu"

Vous pouvez installer le plugin "Menu" comme cela est conseillé dans l'article Plugins complémentaires.
Cela vous permet ensuite d'accéder, au "Menus du site" au survol de l'icône "Edition" Vous devez créer un nouveau menu, en précisant le titre de votre choix, et en utilisant le libellé "menu" pour le champ "identifiant".

Ensuite référez vous à la partie "Les différents types d'entrées" de la documentation du plugin pour construire votre menu.

Par exemple les réglages suivants : permettent d'obtenir le résultat ci-dessous Dans la configuration, le "Nombre d'éléments dans le menu" est toujours fixé à 5, mais ce dernier n'est pas utilisé car il y a 6 éléments définis dans le plugin "Menu", et ce réglage prends le dessus.
Par contre, si il y avait 4 éléments ou moins définis dans le menu, alors ils seraient complétés par les premières rubriques racines pour atteindre 5.