[spip-dev] fichiers d'aide et squelettes

Bonjour,

Si on modifie la version minimale de PHP pour SPIP 1.8,
et qu'uelle est passée à une version supérieure à 4.1.0,
il y a peut-être des bugs de PHP contournés par SPIP
(par exemple des fonctions PHP ne donnant pas la bonne réponse,
et qui ont été codées séparéments dans SPIP) ,
qui ont été corrigés entre php 3 et 4.?.?; ces contournements
pourraient être enlevés.

D'un certain point de vue c'est pris en compte dans todo.txt
(« abandon de la compatibilité php3 : on doit pouvoir
optimiser/accélérer/alléger
le code en faisant appel à des constructions php4 »)
mais je préfère préciser pour que les développeurs ne passent pas à coté.

Par exemple, j'ai un très vague souvenir d'un message,
dans spip-dev-rezo.net, après la sortie d'une version de PHP,
déclarant que cette version de PHP corrigeait un bug de PHP,
et que ce bug avait été remarqué longtemps auparavent,
et contourné dans SPIP par la création d'une fonction SPIP
n'utilisant pas le code PHP donnant un mauvais résultat.

Concernant le filtre de contenu affiché de SPIP « majuscules »,
il est dans certains cas préférable d'utiliser la propriété CSS 1
« text-transform: uppercase; ».

Ci-dessous une proposition de modification des fichiers aide_droite.php3
aide_gauche.php3 aide_index.php3 .

Cela ne préjuge pas d'une éventuelle refonte de l'aide de SPIP
(« revoir l'aide en ligne (concept, méthode, contenu) », todo.txt).

L'élément html peut avoir une indication de langue (attribut lang ou
xml:lang) et de sens de lecture (attribut dir),
et en HTML 4.01 Frameset et XHTML 1.0 Frameset l'élément html
ne contient pas directement d'élément body (noframes peut).

J'ai fait aussi de l'internationalisation des squelettes de base
(donc gros diff).

C'est à vérifier, à discuter et à vérifier.

diff -u article-dist.html
--- article-dist.html Mon Aug 16 19:26:30 2004
+++ article-dist.html Fri Aug 20 18:55:14 2004
@@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<BOUCLE_article_principal(ARTICLES) {id_article}>
-<html lang="#LANG">
+<html lang="#LANG" dir="#LANG_DIR">
<head>
<title>[(#TITRE|textebrut)]</title>
<meta http-equiv="Content-Type" content="text/html; charset=#CHARSET">
@@ -17,7 +17,7 @@

</head>

-<body bgcolor="white" dir="#LANG_DIR">
+<body bgcolor="white">

<div id="navigation">

diff -u auteur-dist.html
--- auteur-dist.html Sun May 02 20:39:28 2004
+++ auteur-dist.html Fri Aug 20 18:55:14 2004
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<BOUCLE_auteur_principal(AUTEURS) {id_auteur}>

-<html lang="#LANG">
+<html lang="#LANG" dir="#LANG_DIR">
<head>
<title>[(#NOM|textebrut)]</title>
<meta http-equiv="Content-Type" content="text/html; charset=#CHARSET">
diff -u breve-dist.html
--- breve-dist.html Sun Nov 09 19:56:54 2003
+++ breve-dist.html Fri Aug 20 18:55:12 2004
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<BOUCLE_breve_principal(BREVES) {id_breve}>

-<html lang="#LANG">
+<html lang="#LANG" dir="#LANG_DIR">
<head>
<title>#TITRE</title>
<meta http-equiv="Content-Type" content="text/html; charset=#CHARSET">
@@ -19,7 +19,7 @@

</head>

-<body bgcolor="white" dir="#LANG_DIR">
+<body bgcolor="white">

<div id="navigation">
@@ -224,7 +224,8 @@
</B_forums>

</div>
-</body></html>
+</body>
+</html>
</BOUCLE_breve_principal>
<:aucune_breve:>
<//B_breve_principal>
diff -u ecrire/aide_droite.php3
--- ecrire/aide_droite.php3 Sun Jan 04 16:23:00 2004
+++ ecrire/aide_droite.php3 Fri Aug 20 18:54:42 2004
@@ -15,7 +15,7 @@
function fichier_aide($lang_aide) {
   if (@file_exists($fichier_aide = "AIDE/$lang_aide/aide"))
     return array($fichier_aide, $lang_aide);
- else // reduction ISO du code langue oci_prv_ni => oci_prv => oci
+ else // reduction ISO du code langue oc_prv_ni => oc_prv => oc
     if (ereg("(.*)_", $lang_aide, $regs))
       return fichier_aide($regs[1]);

@@ -54,8 +54,8 @@
   $html .= $suite;
}

-?>
-<html>
+echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">';
+echo "\n<html lang='$lang_aide' dir='".($spip_lang_rtl ? 'rtl' : 'ltr')."'>\n"; ?>
<head>
<style type="text/css"><!--
.spip_cadre {
@@ -113,21 +113,19 @@
include_ecrire ("inc_texte.php3");
include_ecrire ("inc_filtres.php3");

-echo '<body bgcolor="#FFFFFF" text="#000000" TOPMARGIN="24" LEFTMARGIN="24" MARGINWIDTH="24" MARGINHEIGHT="24"';
-if ($spip_lang_rtl)
- echo " dir='rtl'";
-echo ">";
+echo '<body bgcolor="#FFFFFF" text="#000000">
+<div style="margin: 12px; padding: 12px;">';

if ($aide == 'spip') {
- echo '<TABLE BORDER=0 WIDTH=100% HEIGHT=60%>
-<TR WIDTH=100% HEIGHT=60%>
-<TD WIDTH=100% HEIGHT=60% ALIGN="center" VALIGN="middle">
+ echo '<table border="0" width="100%" height="60%">
+<tr width="100%" height="60%">
+<td width="100%" height="60%" align="center" valign="middle">

-<CENTER>
+<center>
<img src="img_pack/logo-spip.gif" alt="SPIP" width="300" height="170" border="0">
-</CENTER>
+</center>

-</TD></TR></TABLE>';
+</td></tr></table>';
}

// hack pour que la langue de typo() soit celle de l'aide en ligne
@@ -138,10 +136,10 @@
$html = ereg_replace('<a href="(http://[^"]+)"([^>]*)>', '<a href="\\1"\\2 target="_blank">', $html);

echo $html;
-echo "<font size=2>$les_notes</font><p>";
+echo "<font size="2">$les_notes</font><p>";

?>