Conseils rédactionnels pour les pages du livre Pas à Pas

Cette page est appelée à être modifiée en fonction des usages et de vos commentaires !

Modifier une page existante

Si vous avez le statut de rédacteur, en haut des pages de la sections "pas à pas"  vous avez accès à l'onglet "modifier".
La page qui s'ouvre alors est découpée en plusieurs zones.

En haut le titre et les mots-clefs

Une étape cruciale : entrer les bons mots clefs

Toute l'architecture d'Excelabo est basée sur des mots clefs qui permettent de multiples affichages de la même page suivant différentes conditions. Pour que ce système fonctionne, il est donc très important que les mots clefs soient entrés convenablement. Une page sans mot clef n'est affichée NULLE PART et n'est plus accessible (sauf aux administrateurs heureusement).
Il y a plusieurs catégories de mots clefs sur le site (vocabulaires). Tous ne sont pas affichés sur tous les types de pages.

Sur les pages Pas à pas, vous avez deux vocabulaires : recherche et mots clefs Excel VBA.

Vous n'êtes pas obligé de choisir un mot dans la première liste. Ne le faites que si c'est vraiment pertinent. Ce vocabulaire sert à identifier par exemple les pages qui ne concernent que les utilisateurs d'excel 2007, ou ceux qui ont un Mac.

Il est en revanche obligatoire de choisir au moins un mot dans la liste des mots clefs Excel VBA. Pour que la recherche reste pertinente, une sélection de 3 ou 4 mots est généralement suffisante. Inutile de mettre VBA dès qu'il y a une ligne de code par exemple ! En revanche utiliser ce mot clef si la page traite des méthodes de débuggage d'une macro est approprié.

Vous pouvez sélectionner plusieurs mots dans chaque vocabulaire : maintenez la touche ctrl enfoncée pendant vos sélections. Mais attention, si vous ne voulez pas effacer les mots clefs déjà entré, penser à commencer par enfoncer cette touche avant de cliquer dans la liste ! Si vous vous êtes trompé, pour recommencer, il vous suffit de ne pas enregistrer.

Le corps de la page

La fenêtre du dessous vous permet de modifier directement le corps de la page, en utilisant un menu de type word pour formater votre contribution.
Les deux premières lignes sont séparées du reste du texte par une double ligne rouge discontinue. Ces deux lignes constituent le résumé, celui qui apparait par exemple dans les flux RSS, ou dans les pages de navigation du site, ou encore dans les pages de recherche. La longueur de cette partie est limitée à 600 caractères. Pour signifier la fin du résumé, appuyez sur le bouton "teaser".

Mettre en forme votre contribution

SOYEZ SOBRE ! Et respectez l'homogénéité du site.

  • Organisez votre page avec titres et sous titres. Mais ne mettez pas un sous titre pour écrire une seule ligne de contenu en dessous.
  • Utilisez les titres de niveau 2 (menu déroulant format) pour les grandes sections de votre page. N'en mettez pas toutes les 3 lignes mais inversement, il serait surprenant que vous n'en ayez pas besoin.
  • Utilisez le format "pre" (pour préformaté) pour les codes VBA mais pas pour les formules. Ceci vous permet par exemple de copier coller depuis votre classeur excel un code bien indenté et de garder cette présentation en ligne.
  • Les retours à la ligne se font avec la touche entrée. Un changement de paragraphe (un petit espace supplémentaire) avec la touche majuscule+entrée.
  • Usez des listes à puces à l'envie. Lorsque la liste est terminée, il vous suffit de recliquer sur le bouton liste pour en sortir
  • Ne faites pas de sauts de ligne partout avec des trous dans les pages
  • Evitez de vouloir tout mettre en évidence. A force de mettre des styles, du gras du souligné partout, on ne voit plus du tout ce qui est important.
  • Si vous avez un problème sur le formatage, posez votre question en utilisant les commentaires en bas de CETTE page (conseils rédactionnels), en indiquant quelle est la page où vous voulez intervenir mais laissez les commentaires dans les pages pas à pas pour traiter des problèmes liés au contenu

Enregistrez.

En cliquant sur le bouton adhoc situé tout en bas de la page.
Ne vous occupez pas des autres éléments présents sur cette page.

Créer une page dans le livre Pas à Pas

Merci de ne pas créer de pages à l'avance sans y mettre immédiatemment un vrai contenu. Sur XlWiki, beaucoup de pages avaient été créées pour créer un plan du "livre" mais un lecteur qui vient consulter le site et tombe sur une absence de contenu ne revient pas par la suite.
Chaque page doit être reliée à au moins une autre page du livre pas à pas.
Pour démarrer vous devez donc sélectionner la page "parente". Sélectionnez la page parente immédiate et non la page grand-parent ou arrière grand parent. De cette façon la hierarchie se fait toute seule.

Les conseils rédactionnels sont les mêmes que ceux indiqués pour modifier une page. Deux petites choses importantes cependant : comment faire un lien vers une page interne ou vers un site externe, et comment insérer une image.

Faire un lien vers un site externe

Il vous suffit d'écrire le nom du site (ou autre texte pertinent), de le sélectionner puis de cliquer sur l'icone lien (la chaîne) dans le menu. Dans la boîte de message qui s'ouvre, collez (ou écrivez) l'adresse du site. Pour que le site s'ouvre dans une nouvelle fenêtre du navigateur, dans la boîte de message cliquez sur l'onglet navigateur et dans le menu déroulant choisissez 'nouvelle fenêtre _blank' .

Faire un lien vers une autre page du site.

Ceci est plus complexe à expliquer car cela nécessite de comprendre comment sont organisées les pages du site.
Toutes les pages du site sont en fait stockées "à plat" dans une base de données mysql et à leur création, elles reçoivent un numéro d'ordre. Comme ce n'est guère parlant, elles reçoivent aussi un alias, nom convivial destiné à aider l'utilisateur à s'y retrouver.
Pour faire un lien vers une page du site, il faut indiquer le chemin permettant de remonter à la racine du site puis indiquer l'alias de la page.

Comment trouver l'alias de la page vers laquelle on veut pointer ?

Le plus simple... c'est d'aller sur la page et de copier son nom dans la barre d'adresse du navigateur.C'est vrai pour une page ayant un contenu modifiable (et le plus souvent commentable) comme les pages de type question-réponse, exemples ou pas à pas, mais c'est également le cas pour les pages générées automatiquement par le site, comme celles sur lesquelles pointent les rubriques du menu. 

Comment trouver le chemin vers la racine du site ?

C'est là que c'est un peu plus compliqué (et à vrai dire pour moi pas très logique mais là je ne peux rien y changer).
Pour que l'on s'y retrouve plus facilement, et pour limiter le risque de doublons dans les noms d'alias, les alias des pages modifiables ont un préfixe dépendant de leur catégorie (question-réponse, classeur-exemples, pas à pas) mimant le fait d'être rangé dans un dossier.

  • Les pages question/réponse sont rangées dans le dossier trucs/
  • Les classeurs dans le dossier exemples/
  • Les tutorielsdans un dossier pasapas/

Il n'y a pas de sous niveau dans ces dossiers, même si vous y accédez par le 4° niveau du menu du site !
Pour remonter à la racine du site, il faut donc (encore une fois ce donc me parait peu logique mais bon, admettons !) remonter d'un niveau à la façon DOS en tapant ../

Donc si dans trucs/tri_feuille, nous voulons faire un lien vers dma_trieronglets, il ne faut pas tenir des compte des chemins des menus (les longs) mais seulement des chemins de leurs alias.
Quand on est dans une page du dossier trucs, pour passer au dossier exemples, il faut d'abord remonter à la racine du site (../) puis indiquer l'alias de la page vers lequel on pointe
../exemples/dma-trieronglets.
Si les deux pages à lier sont dans le même dossier apparent, (par exemple deux pages de la catégorie pas à pas ou deux pages de type question réponse), il suffit d'indiquer dans le lien le nom de la page sans le dossier et sans remonter à la racine. Par exemple, pour faire référence à la page trucs/perso depuis la page trucs/classeur-perso-xls, il suffit d'écrire "perso" (sans les guillemets) dans le lien.
Les pages peuvent être associées à plusieurs rubriques différentes du menu. L'intérêt de cette façon de faire c'est que le chemin reste valide, quelque soit la façon dont la page est affichée. 

Cela parait compliqué au début mais c'est en fait toujours la même chose donc, assez simple :-).

En résumé :

  • J'identifie l'alias de la page vers laquelle je veux pointer en le lisant dans la barre d'adresse du navigateur (trucs/perso ou exemples/dma-trieronglets)
  • J'identifie l'alias de la page dans laquelle je suis
  • Si les deux pages sont situées dans le même "dossier apparent", dans la boite de dialogue lien, je sélectionne "autre" dans le menu déroulant et j'écris le nom de l'alias sans le préfixe dossier. 
    • Par exemple pour aller de trucs/perso à trucs/classeur-perso-xls, j'écris simplement classeur-perso-xls
  • Si les deux pages sont situées dans deux dossiers apparents différents, dans la boite de dialogue lien, je sélectionne "autre" dans le menu déroulant et dans l'adresse j'écris ../alias complet
    • Par exemple, pour référencer exemples/dma-trieronglets depuis la page  trucs/tri_feuilles j'écris ../exemples/dma-trieronglets

Insérer une image

NB, suivant le niveau d'accréditation sur excelabo, tout ou partie de cette option peuvent ne pas être disponibles.
Pour insérer une image, cliquez sur l'outil image dans la barre d'outils et dans la fenêtre qui s'ouvre sur "parcourir le serveur".
Si l'image est déjà présente sur excelabo (par exemple l'icone indiquant le téléchargement) repérez la dans l'arborescence des fichiers, dans le dossier "image" ou l'un de ses sous dossiers, triés par type de contributions (pas à pas, exemples, astuces...).
Cliquez sur l'image ou le nom de l'image, puis sur send to FCKEditor. Vous pouvez alors régler la position de l'affichage dans la page, la taille de l'affichage et la position par rapport au texte.

Si l'image n'est pas présente dans l'arborescence, préparez votre image sur votre PC, EN LIMITANT AU MAXIMUM SA TAILLE et donc son POIDS.
La largeur maxi de l'image ne doit pas dépasser 600 px et la hauteur 500 (pensez à ceux qui n'ont pas un grand écran). Utilisez les formats png ou jpg. Compressez vos images pour obtenir quelque chose de lisible mais pas trop lourd.
Une fois ceci fait, dans la fenêtre ci-dessus, mettez vous dans le bon dossier (il peut vous être imposé suivant votre niveau d'accréditation), cliquez sur le bouton parcourir, sélectionnez votre image puis cliquez sur télécharger. Procédez ensuite comme ci-dessus.

Attention, le fait de réduire la taille du fichier à l'affichage ne change pas son poids et donc ni la place qu'il occupe sur le serveur, ni le temps de chargement de la page.

Il n'est pour l'instant pas possible d'insérer un fichier vous même sur excelabo. Il y a en effet encore quelques problèmes à régler pour que cela puisse être fait en toute sécurité et de façon simple. Si vous voulez mettre un fichier exemple sur une page pas à pas par exemple, utilisez la page Proposer un classeur.

Insérer une image

 Est-ce possible, et si oui, comment ?

oui !

Dis moi si tu as un problème pour le faire.

?

Insérer une image

 Soit je fais un copier coller, auquel cas, je vois une boîte de dialogue m'avertissant qu'en raison des paramètres de sécurité de mon navigateur, je dois d'abord répéter le coller dans la nouvelle fefnêtre; ca ne fonctionne pas (en tout cas pour une image). Si je me sers de l'icône de la barre ci-dessus, je dois fournir l'URL de l'image. Comment faire ? J'ai créé un document Word et je cherche à procéder au maximum par copier coller.
Merci

copier coller

Par copier coller tu ne peux pas insérer une image. Tu dois obligatoirement suivre ce qui est indiqué ci dessus. En effet dans ta page html finale, une image a nécessairement une adresse et elle est stockée de façon indépendante du texte qui lui est dans un champs texte de la base de données. Quand on te demande l'URL de l'image, clique sur le bouton parcourir qui est dans cette fenêtre et tu auras accès à la fenêtre dont j'ai mis l'image ci-dessus. Le reste peut se faire par copier coller.
Quand tu rédiges un texte, tant que tu es en mode préparation, tu peux l'enregistrer mais laisser son statut à non publié (tout en bas de la page tu as une rubrique "options de publication", décoche publié. Tu pourras toujours accéder à la page par son alias (genre truc/mapageenconstruction).

?

7 Nouvelles pages ajoutées ce mois-ci dont :

15 pages modifiées ce mois-ci dont :