www/plugins/zpip_v1/conventions.txt

   1 Le layout intègre 6 entités logiques de contenu qui structure dans le html a sa guise.
   2 Les 6 entités sont nommées ici selon la convention ci-dessous, eu égard à leur contenu informationnel
   3 et sans préjuger d'une quelconque structure définie par le theme :
   4
   5 entete  fournit la présentation de la page et d'identité
   6 barre-nav       constitue la navigation principale du site - peut être vide
   7 contenu contient l'information principale de la page
   8 navigation      fournit des élements de navigation secondaire
   9 extra fournit des eléments d'information connexes
  10 pied    fournit des éléments de repérages et de rappels secondaires
  11
  12
  13 entete
  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
  23 Peut contenir
  24 - .formulaire_menu_lang  le formulaire de changement de langue qui n'apparaitra que sur les sites multilingues
  25
  26 barre-nav
  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
  43 contenu
  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
  87 navigation
  88
  89 Peut contenir
  90 - une navigation de second niveau, structurée comme barre-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
  93 des intertitres .hx
  94 des listes d'items
  95 ...
  96
  97 extra
  98 ...
  99
 100
 101
 102 pied
 103         peut contenir
 104                 TBD des registres horizontaux
 105                 TBD des colonnes verticales
 106
 107
 108
 109
 110 Elements généraux
 111
 112 les intertitrages
 113         .h1, .h2, .h3, .h4, .h5, .h6
 114 la pagination
 115         .pagination contient a, .on et .separateur
 116
 117 les 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
 123 les formulaires
 124         selon convention décrite dans http://www.spip.net/fr_article3791.html
 125
 126 les tableaux de données
 127         tables.spip
 128                 tr
 129                 tr.row_odd
 130                 tr.row_even
 131                         th, td
 132
 133 les 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
 144 les 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
 150 la "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
 158 hr.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%; }