From 0984ff213adff443f0153719f66d89aafdd2bbdb Mon Sep 17 00:00:00 2001
From: Matthieu Marcillaud <marcimat@rezo.net>
Date: Wed, 12 Sep 2012 09:08:12 +0000
Subject: [PATCH] =?UTF-8?q?Mettre=20les=20classe=20'lat'=20sur=20les=20col?=
 =?UTF-8?q?onnes=20des=20exec=20php=20car=20cela=20sert=20=C3=A0=20styler?=
 =?UTF-8?q?=20les=20formulaires=20lat=C3=A9raux.=20PhpDoc=20un=20peu=20au?=
 =?UTF-8?q?=20passage?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ecrire/inc/presentation_mini.php | 65 ++++++++++++++++++++++++++------
 1 file changed, 53 insertions(+), 12 deletions(-)

diff --git a/ecrire/inc/presentation_mini.php b/ecrire/inc/presentation_mini.php
index d42f969ded..18dec32f78 100644
--- a/ecrire/inc/presentation_mini.php
+++ b/ecrire/inc/presentation_mini.php
@@ -10,9 +10,28 @@
  *  Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne.   *
 \***************************************************************************/
 
+/**
+ * Fonctions d'affichage pour l'espace privé (hors squelettes)
+ *
+ * @package SPIP\Core\Affichage
+**/
 if (!defined('_ECRIRE_INC_VERSION')) return;
 
-// http://doc.spip.org/@echo_log
+/**
+ * Affiche un code html (echo) et log l'affichage car cet echo est anormal !
+ * 
+ * Signale une fonction qui devrait retourner un contenu mais effectue
+ * un echo à la place pour compatibilité ascendante
+ *
+ * @deprecated
+ *     Utiliser des squelettes pour l'affichage !
+ * 
+ * @param string $f
+ *     Nom de la fonction
+ * @param string $ret
+ *     Code HTML à afficher
+ * @return void
+**/
 function echo_log($f, $ret) {
 	spip_log("Page " . self() . " function $f: echo ".substr($ret,0,50)."...",'echo');
 	echo
@@ -20,11 +39,17 @@ function echo_log($f, $ret) {
 		. $ret;
 }
 
-// Cadre centre (haut de page)
-// http://doc.spip.org/@debut_grand_cadre
-function debut_grand_cadre(){	return "\n<div class='table_page'>\n";}
-// http://doc.spip.org/@fin_grand_cadre
-function fin_grand_cadre(){	return "\n</div>";}
+/**
+ * Retourne le code HTML d'un début de cadre pour le centre de page (haut de page)
+ * @return string Code HTML
+ */
+function debut_grand_cadre(){ return "\n<div class='table_page'>\n";}
+
+/**
+ * Retourne le code HTML d'une fin de cadre pour le centre de page (haut de page)
+ * @return string Code HTML
+ */
+function fin_grand_cadre(){ return "\n</div>";}
 
 // Debut de la colonne de gauche
 // div navigation fermee par creer_colonne_droite qui ouvre
@@ -32,18 +57,34 @@ function fin_grand_cadre(){	return "\n</div>";}
 // div contenu lui-meme ferme par fin_gauche() ainsi que
 // div conteneur
 // http://doc.spip.org/@debut_gauche
-function debut_gauche() {	return "<div id='conteneur' class=''>\n<div id='navigation'>\n";}
-// http://doc.spip.org/@fin_gauche
+/**
+ * Retourne le code HTML du début de la colonne gauche
+ * @return string Code HTML
+ */
+function debut_gauche() {	return "<div id='conteneur' class=''>\n<div id='navigation' class='lat' role='contentinfo'>\n";}
+
+/**
+ * Retourne le code HTML de la fin de la colonne
+ * @return string Code HTML
+ */
 function fin_gauche(){return "</div></div><br class='nettoyeur' />";}
-// http://doc.spip.org/@creer_colonne_droite
+
+/**
+ * Retourne le code HTML du changement de colonne (passer de la gauche à la droite)
+ * @return string Code HTML
+ */
 function creer_colonne_droite(){
 	static $deja_colonne_droite;
 	if ($GLOBALS['spip_ecran']!='large' OR $deja_colonne_droite) return '';
 	$deja_colonne_droite = true;
-	return "\n</div><div id='extra'>";
+	return "\n</div><div id='extra' class='lat' role='complementary'>";
 }
-// http://doc.spip.org/@debut_droite
-function debut_droite($rubrique="") {
+
+/**
+ * Retourne le code HTML de la colonne droite et du centre de page
+ * @return string Code HTML
+ */
+function debut_droite() {
 	return liste_objets_bloques(_request('exec'))
 	  . creer_colonne_droite()
 	  . "</div>"
-- 
GitLab