Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# Vue d'ensemble
Les équipes de développement AFI et Biblibre utilisent le [sytème de gestion de développement](https://fr.wikipedia.org/wiki/Forge_%28informatique%29) libre [GitLab](https://www.gitlab.com) et le [système de gestion de version](https://fr.wikipedia.org/wiki/Gestion_de_versions) [Git](http://www.git-scm.com). Ce document décrit l'utilisation minimale nécessaire de ces deux outils pour pouvoir contribuer au code des projets maintenus par AFI et Biblibre. Néanmoins nous vous invitons à lire le livre [Pro Git](http://git-scm.com/book/fr).
Nous hébergeons les codes sources des projets sur une (instance de GitLab accessible à l'URL https://git.afi-sa.fr/)[https://git.afi-sa.fr/]. Les projets (publics sont accessibles sans compte à l'URL https://git.afi-sa.fr/public)[https://git.afi-sa.fr/public].
# Cloner le projet OPACCE sur git.
## Créer un compte gitl
# Créer un nouveau skin
## Création
Se placer dans le répertoire skins à la racine de l'OPAC et recopier le skin modele
cd skins
cp -a ../public/opac/skins/modele mon_skin
Aller dans la configuration d'un profil de l'OPAC, le nouveau skin devrait être disponible dans le sélecteur de thème.
## Sauvegarde sur GitLab
Créer le projet sur [GitLab](https://www.git.afi-sa.fr) pour stocker les sources. Par exemple https://git.afi-sa.fr/mon_compte/mon_skin.
Aller dans le répertoire mon_skin et initialiser le dépôt:
cd mon_skin
git init
git remote add origin -t master git@git.afi-sa.fr:mon_compte/mon_skin.git
git add *
git commit -m "Premier commit"
git push origin master
Ceci fait, les nouveaux fichiers devraient être accessibles sur https://git.afi-sa.fr/mon_compte/mon_skin/files
## Description des répertoires
css/ contient le fichier global.css sur lequel travailler. Les autres fichiers sont destinés à devenir obsolètes.
images/ les icones
images/support/ les icones pour les types de support. Les fichiers doivent être nommés comme suit: support_id.png, par exemple support_1.png pour les livres.
templates/ les modèles de rendu boite de la page d'accueil. Les fichiers doivent êtres nommés en séparant les mots par des tirets bas "_", qui seront dans la configuration des boîtes "Style de boîte". Chaque modèle de boîte peut inclure les tags {TITRE}, {RSS}, {CONTENU} et utiliser les conditions {IF-TITRE}, {IF-RSS}, {IF-CONTENU}
Tous les fichiers de vue du répertoire application/modules/opac/views/scripts peuvent être redéfinis dans un répertoire html. Les principaux sont:
footer.phtml pour le pied de page
banniere.phtml pour l'en-tête
skin_head.phtml pour rajouter des éléments dans la balise <head></head> du site
accueil.phtml pour la page d'accueil
contenu.phtml pour les autres pages