source: spip-zone/_squelettes_/zpip-dist/branches/z-bootstrap-dev/conventions.txt @ 66274

Last change on this file since 66274 was 46710, checked in by guy.cesaro@…, 8 years ago

Annulation de [46681] et [46678]. Ajout de rechercher.gif récupérer sur la dist 2.1 et renommage de out.gif en spip_out.gif ("autant que possible, nommer de même le sélecteur css, le fichier image et la chaîne de langue qui s’appliquent au même endroit")

File size: 4.3 KB
Line 
1Le layout intègre 6 entités logiques de contenu qui structure dans le html a sa guise.
2Les 6 entités sont nommées ici selon la convention ci-dessous, eu égard à leur contenu informationnel
3et sans préjuger d'une quelconque structure définie par le theme :
4
5header  fournit la présentation de la page et d'identité
6nav constitue la navigation principale du site - peut être vide
7content contient l'information principale de la page
8extra1  fournit des élements de navigation secondaire
9extra2 fournit des eléments d'information connexes
10footer  fournit des éléments de repérages et de rappels secondaires
11
12
13header
14
15- un lien bloc .accueil contenant
16        - le logo eventuel [x], encadré par un element a
17        - le nom du site
18                dans un #nom_site_spip, qui peut être porté par toute balise. Il appartient au theme de fixer si il doit se comporter comme un block ou comme un inline
19                qui peut contenir un element a
20        - le slogan du site
21                dans un #slogan_site_spip
22
23Peut contenir
24- .formulaire_menu_lang  le formulaire de changement de langue qui n'apparaitra que sur les sites multilingues
25
26nav
27        si elle est non vide, est structurée d'éléments imbriqués de classes
28        .menu-liste
29                encadre un lot de .menu-entree
30                contient exlusivement des elements .menu-entree
31        .menu-entree doit etre dans un element .menu-liste
32                contient un unique element a
33                peut contenir un unique element .sep contenant un separateur textuel
34                peut contenir des sous groupes .menu-entree
35
36        cette convention permet par exemple
37                une navigation hierarchisée de type ul.menu-liste/li.menu-entree a un ou plusieurs niveau
38                une navigation plate constituée d'une suite de liens
39
40        le theme devra prendre en charge au moins l'affichage du premier niveau de navigation
41        le theme pourra prendre en charge l'affichage d'un eventuel menu déroulant a 1 ou plusieurs niveaux si le squelette les fournit
42
43content
44
45        #hierarchie le fil d'ariane,
46                des liens 'a'
47                des elements separateurs '.sep'
48                un element en exergue '.on'
49
50        .cartouche      le cartouche de présentation du contenu
51                .titre  le titre
52                .spip_logos le logo
53                .surtitre
54                .soustitre
55                .traductions
56                .info-publi     Infos de publication
57                        .published      date de publication
58                        .auteurs        auteur de publication, avec seperateurs .sep eventuels
59                        .past-published date de publication anterieure
60
61        .postmeta cartouche de présentation des réactions
62                .date
63                a.comments
64                a.readmore
65
66                .post-info
67                .post-info a
68
69        .introduction
70        .descriptif
71        .chapo
72        .texte
73        .hyperlien
74        .ps
75        .notes
76
77        Portfolios :
78        .documents_portfolio (classe et pas id car il pourrait en avoir plusieurs)
79
80        Forums :
81                garder la structure de la dist ?
82
83        Petitions :
84                garder la structure de la dist ?
85
86
87extra1
88
89Peut contenir
90- une navigation de second niveau, structurée comme nav, par .menu-liste, .menu-entree, .sep et a
91- Le formulaire de recherche. Les themes qui voudront le placer visuellement dans le bandeau supérieur procèderont par un positionnement absolu
92
93des intertitres .hx
94des listes d'items
95...
96
97extra2
98...
99
100
101
102footer
103        peut contenir
104                TBD des registres horizontaux
105                TBD des colonnes verticales
106
107
108
109
110Elements généraux
111
112les intertitrages
113        .h1, .h2, .h3, .h4, .h5, .h6
114la pagination
115        .pagination contient a, .on et .separateur
116
117les listes d'items (liste d'articles, de breves, de rubriques ...)
118        .liste  : bloc englobant
119                peut contenir des p, .hx, .pagination ...
120                contient au moins un ul.liste-items
121                        qui contient un ou des li.item
122
123les formulaires
124        selon convention décrite dans http://www.spip.net/fr_article3791.html
125
126les tableaux de données
127        tables.spip
128                tr
129                tr.row_odd
130                tr.row_even
131                        th, td
132
133les liens :
134        a
135        a.spip_note /* liens vers notes de bas de page */
136        a.spip_ancre /* liens internes a la page */
137        a.spip_in /* liens internes */
138        a.spip_out /* liens sortants */
139        a.external ?
140        a.spip_url /* liens url sortants */
141        a.spip_glossaire /* liens vers encyclopedie */
142
143
144les documents :
145        .spip_documents, .spip_documents_right, .spip_documents_left
146                img, peut etre dans un 'a'
147                .spip_doc_titre
148                .spip_doc_descriptif
149
150la "typo" (cf spip_styles.css)
151        .spip_code du code inline
152        .spip_cadre du code en block
153        acronym
154        abbr
155        blockquote.spip
156        blockquote.spip_poesie
157
158hr.spip
159.nettoyeur { clear: both; height: 0; margin: 0; padding: 0; border: 0; line-height: 1px; font-size: 1px; }
160.invisible { position: absolute; top: -3000em; height: 1%; }
Note: See TracBrowser for help on using the repository browser.