IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

Documentation de la gestion de la page cours de la rubrique Delphi

Date de publication : 08/05/2005 , Date de mise à jour : 06/08/2006

Par Laurent Dardenne
 

Vous trouverez ici la documentation du cycle de la mise à jour de la page cours de la rubrique Delphi

1. Principe
2. Précaution importante
3. Mise en œuvre
3-1. Localisation
3-2. Préconisation
3-3. Suivi (To do list)
4. Règles
5. Page Livre
6. Qui fait quoi ?


1. Principe

La page cours est construite à partir d'un fichier texte ASCII au format CSV. Le délimiteur de champs est le point virgule ';' et le délimiteur d'enregistrement est le retour chariot.
La mise à jour consiste à compléter ce fichier texte.


2. Précaution importante

Quand on travaille sur une page on fait une copie du fichier index.php ou cours.csv que l'on renomme _index.php ou _cours.csv. On travail donc sur la copie et quand c'est terminé, on renomme index.php en production en index.old et le nouveau fichier _index.php en index.php.
Cette méthodologie permet à chacun de savoir ce qui se passe et de pouvoir revenir à la page précédente en cas de problème. C'est simple mais c'est généralement suffisant.


3. Mise en œuvre


3-1. Localisation

la page cours se trouve dans : ftp://ns3549.ovh.net/cours
Les cours sans hébergement dans le domaine DVP de l'auteur se trouve sur : ftp-developpez.com
La page livres se trouve dans : ftp://ns3549.ovh.net/livres
Cette page contient la page proprement dite ainsi que le fichier xml qui a servi à la générer. Le responsable de la rubrique est seul habilité à communiquer le nom de compte et son mot de passe.


3-2. Préconisation

Pour que les logos des pages index s'affichent correctement, vous devez utiliser les bons attributs de taille dans le code HTML.
D'autre part utilisez la version developpez.biz
Voici les codes :
NOUVEAU Code: 
<IMG SRC="http://www.developpez.biz/anim/nouveau.gif" WIDTH="89" HEIGHT="15" BORDER="0"> 

ACTUALISE Code: 
<IMG SRC="http://www.developpez.biz/anim/actualise.gif" WIDTH="58" HEIGHT="12" BORDER="0"> 

MIS A JOUR Code: 
<IMG SRC="http://www.developpez.biz/anim/maj.gif" WIDTH="70" HEIGHT="14" BORDER="0" ALT="Mis à jour"> 

HOT Code: 
<IMG SRC="http://www.developpez.biz/anim/hot7.gif" ALT="HOT" WIDTH="32" HEIGHT="16" BORDER="0">

3-3. Suivi (To do list)

Le suivi se fait dans forum [PRIV]Delphi :
http://www.developpez.net/forums/viewtopic.php?t=327681
Indiquez dans la zone suivante la date de la derniére publication et le dernier tutoriel inséré dans la page cours. Ce tutoriel doit avoir été annoncé dans l'index de la ruvrique Delphi.
PageCours:
Dernière MAJ : Le 19 septembre 2005 
Dernièr tutoriel inséré : Le 14/12 : Tutoriel sur le format PE (partie 3-4-5) inclus
Dans la partie A ajouter ajouter vos prochain tutoriel US que vous souhaitez intégrér dans la page cours.

Le fichier est recopié dans le répertoire delphi.developpez.com/cours/
Lors de la livraison d'une nouvelle version de ce fichier liste.csv vous devez supprimer le fichier Domaine.csv. Il s'agit d'un fichier temporaire contenant tous les domaines présent dans le fichier liste.cs, sa construction évite un parsing du champ Domaine à chaque appel.
Il est donc préférable après une livraison "d'appeler/charger" la page cours afin de reconstruire la nouvelle liste des domaines.

Détail des champs du fichier CSV :

Numéro Description Contenu possible
1 Langue utilisée Afficher dans la premier colonne du tableau.
Ne peux contenir que fr ou ang. Des images correspondantes sont associées
2 Titre de l'article Afficher à la première ligne de la seconde colonne du tableau.
Texte enrichi, il peut contenir des balises HTML. Ce champ est associé à l'url de l'article et permet la navigation
3 Description de l'article Afficher à partir de seconde ligne de la seconde colonne du tableau.
Texte enrichi, il peut contenir des balises HTML
4 URL de l'article Il est utilisé pour construire l'affichage de l'url du titre de l'article
Format normé :http://laurent-dardenne.developpez.com/articles/erreurs-applicative/
5 Contient le ou les auteurs de l'article Texte enrichi, il peut contenir des balises HTML notamment un lien sur le profil DVP de l'auteur
5 Domaine ou catégorie de l'article Un article peut concerner une ou plusieurs catégories.
Format normé: Le séparateur de catégorie est le caractère '/'.Utiliser la même casse et la même orthographe.
RESEAU et RESEAUX sont distincts
Exemple : IHM/COMPOSANT
6 Thème ou sujet de l'article Un article peut concerner un ou plusieurs sujets.
Format normé: Le séparateur de sujet est le caractère '/'.Utiliser la même casse et la même orthographe.
MENU et MENUS sont distincts mais pas Menu et MENU.
Exemple : Menu/Fenêtre
7 Date de publication de l'article, permet l'insertion et la gestion automatique de la balise "Nouveau" Exemple :
01/04/2005
Les filtres fonctionnent pour les colonnes 5 et 6, ils ne sont pas sensible à la casse. Par convention respecter la même casse pour les nom de filtres. Les cellules vide ne doivent pas contenir d'espace mais contenir &nbsp à la place.
Cette suite de champs aaa;;bbb; est incorrecte. Cette suite de champs aaa;&nbsp;bbb; est correcte.


4. Règles

La date indiquée dans la colonne 7 du fichier CSV est la date de publication. Elle permet d'afficher l'icone NOUVEAU pendant 15 jours.

Le tutoriel Débuter la programmation avec Delphi en autodidacte doit toujours être en premier dans le fichier csv, son champ date n'est pas mise à jour.

Les tutoriels en français de la rubrique sont ajoutés en premier ensuite les tutoriels en langue anglaise.

Les cours et tutoriels sans hébergement se place sur : ftp://ftp-developpez.com/delphi/cours/
Les noms de Domaine doivent correspondre au plus près au contenu de l'article.
Les noms de Thémes peuvent correspondre de près ou de loin (pas de trop non plus ;-) ) au contenu de l'article.
Leurs orthographes doit être identique.

Testez votre nouvelle page dans le répertoire /tmp/cours. Cela facileteras égalemment sa publication par vos soins ou par le responsable de rubrique.


5. Page Livre

La gestion de la page livre se fait avec l'éditeur XML associé au 'kit'. S'occuper des pages cours et livre est assez simple en fait mais demande un peu d'organisation. Vérifier de temps en temps que les livres sont toujours édités et que les informations que nous donnons sont toujours valide. Il faut également pouvoir en ajouter de nouveaux quand l'occasion se présente. Vu le faible nombre d'ouvrages concernant Delphi (en français en tous cas), ce n'est pas un gros boulot. Pour les cours, c'est un peu plus délicat. Il faut ajouter les nouveaux articles mais pas quand ils sont annoncés. A des fins de webmarketing ,nous devons attendre quelques jours (deux semaines il me semble) avant d'ajouter un article qui a été annoncé dans l'index de la rubrique Delphi. Il faut aussi faire un peu de ménage de temps en temps.

L'icone de livre est recherché automatiquement sur le site amazon.fr.


6. Qui fait quoi ?

Le responsable de rubrique contrôle les pages avant leur publication.

Mes remerciements à Pierre Castelain.



Valid XHTML 1.1!Valid CSS!