Testez CmicWiki en écrivant sur cette page !!
Cliquez sur la ligne "Edition de la page" dans le Menu Principal, Editez, puis Enregistrez la page. Et voilà !
Cartes
Aide : Comment Editer une page
Pour éditer du texte, vous devez d'abord vous inscrire. Ceci consiste à cliquer "Préférences" dans le "Menu principal" et à remplir le formulaire. Retenez bien le numéro (ID) qui vous sera attribiué ainsi que votre mot de passe. Ensuite, cliquez sur "Edition de la page" dans le menu principal. Ne le faites pas sur cette page car c'est la page d'aide et celle-ci est verrouillée ! Entraînez-vous sur le CahierDeBrouillon qui contient d'ailleurs une copie de cette page d'aide. Quand vous aurez édité une page, vous pourrez soit cliquer sur le bouton "Aperçu", soit sur le bouton "Enregistrer" pour que votre page soit conservée et automatiquement reliée aux autres pages du site.
L'édition se fait dans un cadre avec une syntaxe simple. Si vous êtes compétent en HTML, vous pouvez également insérer du texte avec tous les tags HTML standard, ou même faire du "couper coller" depuis un éditeur de texte. Le collage depuis Word fonctionne mais donne des résultats, hum, surprenants.
'' NB :Vous pouvez dès maintenant cliquer sur le CahierDeBrouillon ou se trouve une copie de ce document que vous pourrez modifier à votre guise.
Pour revenir en début de ligne : Par défaut, il suffit de taper son texte sans insérer de Retour (touche "Entrée"). En français on dit "taper au kilomètre". Mais si l'on désire commencer un nouveau paragraphe, il faut insérer deux "Retour" (touche "Entrée").
Ecrire en italique : placer le texte entre 2 fois 2 '
Comme ' 'ceci' ' donnera : Comme ceci
Ecrire en gras : placer le texte entre 2 fois 3 '
Comme ' ' 'cela' ' ' donnera : Comme cela
Ou encore placer le texte entre deux paires de ' ' ' ' ' pour écrire en italique et en gras
Formater/indenter un paragraphe : commencer la ligne par n caractères : (deux points).
- indentation de ce paragraphe bla bla
- bla-bla et encore bla
- double indentation de cette ligne bla bla
- bla bla
fin de l'indentation.
Insérer un paragraphe préformaté : (le format du paragraphe est conservé): Il faut commencer la ligne par un (ou plusieurs) caractère(s) "espace" :
Ces lignes sont en Courier (non proportionnel)
et en couleur bleue. Les retours à la ligne sont conservés.
125 OPEN WINDOW w_mm AT 5,1 WITH 19 ROWS, 79 COLUMNS
126 IF reponse("Voulez-vous uniquement les recherches en cours ") THEN
127 LET etat="ENC"
128 ELSE
129 LET etat="*"
130 END IF
Créer une liste numérotée : commencer la ligne par n caractères #
#premier
#niveau
##niveau 2
##etc...
- premier
- niveau
- niveau 2
- etc...
Créer une liste non numérotée : commencer la ligne par n caractères *
*premier
*niveau
**niveau 2
***et niveau 3
- premier
- niveau
- retour au premier niveau
Créer une définition : commencer la ligne de le façon suivante :
; Mot à définir : définition du mot
- castor
- animal a queue plate
- abribus
- abri pour les bus ?
Insérer une ligne horizontale : insérer ---- ou ----- ou ------ pour obtenir des lignes horizontales d'épaisseur variables :
Insérer des liens : il y a 3 manières différentes de les générer :
- soit entourant le texte du lien (que la cible du lien existe ou pas !) par des paires de crochets comme ceci [[ vers une autre page ]]. Vous noterez que les espaces sont automatiquement remplacés par des _ Ce type de lien est appelé lien libre (freelink).
- soit en écrivant un mot compremant des lettres majuscules et minuscules : CommeCeci
- soit en écrivant directement l'adresse du lien sous sa forme classique http://www.google.com
Les trois manières ci-dessus donnent :
[vers une autre page]? ou encore [vers une autre page]? pour le premier cas,
CommeCeci? pour le deuxième cas,
et enfin http://www.google.com pour le troisième cas.
Remarque : dans les deux premiers cas, un point d'interrogation de couleur vient s'inscrire après le lien que vous avez créé. Tout simplement parce que les pages pointées par ces liens n'existent pas encore. Si par contre vous cliquez sur ce point d'interrogation, alors la nouvelle page sera créée, le lien sera résolu et l'affichage du lien sera alors modifié comme, par exemple, pour le lien AideEnLigne qui existe déja (la page courante).
Toute la richesse de Wiki est là : on peut créer des pages à la volée et on les enchaîne selon nos besoins. Consultez également le paragraphe ci-dessous intitulé "Edition avancée avec Wiki" pour la création de liens.
Insérer une adresse e-mail : il suffit de la faire précéder du mot clef mailto:
Par exemple, si j'insère l'adresse mailto:goblin@bigfoot.com dans l'éditeur, le texte apparaitra comme ceci : mailto:goblin@bigfoot.com
Créer des titres : placer le texte du titre entre une paire de n caractères = pour obtenir l'effet désiré :
Titre avec 1 caractère = de chaque coté
Titre avec 2 caractères = de chaque coté
Titre avec 3 caractères = de chaque coté
Titre avec 4 caractères = de chaque coté
Titre avec 5 caractères = de chaque coté
Titre avec 6 caractères = de chaque coté
Créer des titres avec numérotation automatique : comme pour les titres ci-dessous, mais intercaler un caractère # et un caractère espace après la première série de signes =:
Exemple :
=== # Titre exemple de niveau trois ===
1.1.1. Titre exemple de niveau trois
D'autres exemples :
2. Titre de niveau 1 (1 signe = de chaque côté)
2.1. Titre de niveau 2-1
2.2. Titre de niveau 2-2
2.2.1. titre de niveau 3
2.3. Titre de niveau 2-3
2.3.1.1. Titre de niveau 4
2.3.1.1.1. titre de niveau 5
2.3.1.1.2. titre de niveau 6
Remarques : le titre de niveau 6 est identique au titre de niveau 5. La numérotation est automatique à l'intérieur d'une même page. Elle recommence à partir de 1. pour chaque nouvelle page.
Expansion de paragraphe (mode plan) :
La syntaxe rappelle un peu celle du "titre à numérotation automatique" ci-dessus. Il suffit de placer des caractères autour du titre et du paragraphe concerné, comme ceci, en n'oubliant pas de laisser un espace entre le signe + et le titre.
===== + Titre du paragraphe ===== Placer ici le texte du paragraphe =====
Ce qui donnera :
+Titre du paragraphe Placer ici le texte du paragraphe.
Le nombre de signes "=" déterminera la taille du titre. Examples :
+Titre taille 3 Placer ici le texte du paragraphe.
+Titre taille 5 Placer ici le texte du paragraphe. On peut même insérer des listes comme celle-ci
- note 1 : bleu blanc rouge ...
- note 2 : blau rot gelb
Ou même un morceau de listing :
125 OPEN WINDOW w_mm AT 5,1 WITH 19 ROWS, 79 COLUMNS
126 IF reponse("Voulez-vous uniquement les jeux en cours ?") THEN
127 LET etat="ENC"
128 ELSE
129 LET etat="*"
130 END IF
+Titre taille 6 Placer ici le texte du paragraphe.
Remarque : Ne pas placer de "titres" ou "titres à numérotation automatique" dans le corps d'un paragraphe à expansion. Le rendu de la page est désastreux !!
Créer un tableau : insérer le caractère | entre chaque colonne.
| 1.732| 3.14 | 2.71838
| sigma| delta| paula
donnera :
1.732 |
3.14 |
047214-9908
|
sigma |
delta |
paula
|
Ya des bugs.
- La première ligne de chaque page est "décalée" vers la gauche.
- Solution
- La première ligne de de la page doit être une ligne blanche (Entrée ou Retour). Sinon, son formatage ne s'effectue pas correctement.
Edition avancée avec wiki
Tout ce qui vient d'être expliqué est suffisant pour éditer correctement du texte dans la majorité des cas. Mais les techniques exposées ci-dessous, permettent d'améliorer la qualité et l'organisation de la mise en page.
Insertion d'un commentaire ou d'une citation : il suffit de placer trois signes < en debut du paragraphe à "quoter" et trois signes > a la fin de ce paragraphe.
<<<
Voici un exemple extrait de Basedok? pour un paragraphe blockquote. Ce paragraphe peut-être employé pour insérer une citation ou un exemple de bla bla.
>>>
Voici un exemple extrait de Basedok? pour un paragraphe du type citation. Ce paragraphe peut-être employé pour insérer une citation ou un exemple de bla bla de bla blade bla blade bla blade bla blade bla blade bla blade bla blade bla bla.
Créer un bloc encadré (annonce ?) : Placer 3 signes { au début du texte à encadrer et 3 signes } à la fin de ce texte.
{{{
Les nouvelles sont bonnes. Internet redevient vraiment libre...., réellement évaluer son ampleur. (à suivre).
}}}
Les nouvelles sont bonnes. Internet redevient vraiment libre avec la mise en place de sites wiki. Ce mouvement a démarré en 1995 au USA et commence à faire boule de neige, mais sans qu'on puisse réellement évaluer son ampleur. (à suivre).
|
Signer un texte : insérer 3 caractères @ dans le texte
Si vous vous êtes enregistré en utilisant le menu Préférences, alors vous pourrez utiliser votre signature qui sera remplacée par un lien hypertexte. Il est rappelé qu'il est conseillé d'utiliser son nom réel en le codant sous la forme JacquesMessier pour Jacques Messier. Les pseudonymes anonymes sont à éviter, mais bon... -- JacquesMessier?
Dater un texte : (ce qui peut être utile pour éviter de faire appel aux menu "Dernieres Modifications"). Il suffit d'insérer 3 ! (points d'exclamation) dans le texte. La date est représentée sous sa forme ISO 8601, c'est à dire aaaa-mm-jj hh:mm:ss. La date est compilée une fois pour toute dans votre document. Elle ne change pas à chaque fois que quelqu'un visualise la page !
Voici par exemple la date et l'heure à laquelle je tape ce document: !!!. Bonsoir
Ce qui donne :
Voici donc la date et l'heure de création de ce document 2002-07-07 16:07:05 Bonsoir.
Insérer une image : L'image doit déjà être disponible, soit sur une page Internet, soit dans un répertoire spécifique du serveur du site wiki. Dans les deux cas, il suffit d'appliquer la syntaxe suivante :
@X@http://oopsla/images/wiki.gif
ou encore
@X@angle.png
X est une lettre qui représente l'alignement désiré de l'image : g pour gauche, m pour milieu et d pour droite. Les extensions du nom de l'image peuvent être jpg, gif, et png.
Exemples :
Insérer une image clickable : Les images doivent déjà être disponibles, soit sur une page Internet, soit dans un répertoire spécifique du serveur du site CmicWiki. Dans les deux cas, il suffit d'appliquer la syntaxe suivante :
@X@http://oopsla/images/wiki.gif@grandwiki.jpg
ou encore
@X@wiki.jpg@grandwiki.jpg
Exemple :
Télécharger une image vers le site wiki : Si cette fonction est disponible, vous devez voir apparaitre le menu "Téléchargement". Pour pouvoir utiliser cette fonction, vous devez impérativement utiliser le menu Préférences du site wiki et entrer votre nom et votre mot de passe.
L'utilisation est alors relativement simple :
- une nouvelle fenêtre s'ouvre,
- sélectionnez sur votre ordinateur l'image au format gif, jpeg ou png que vous désirez télécharger,
- entrez le nom de l'image sur le site wiki (ce n'est pas forcément le même que le nom original)
- sélectionnez la catégorie du document, ou entrez là si elle n'existe pas,
- entrez quelques mots pour la description du document,
- entrez votre mot de passe (celui que vous avez choisi dans le menu Préférences),
- cliquez enfin sur le bouton Téléchargement.
Pour utiliser l'image téléchargée, utilisez la syntaxe du paragraphe ci-dessus, "Insérer une image".
La fenêtre de téléchargement comporte un bouton "Liste des documents". En sélectionnant cette fonction vous pourrez voir la liste des documents déjà téléchargés, visualiser ces documents, effacer les images que vous avez téléchargées, etc.
Remarque : Pour pouvoir utiliser la fonction de téléchargement, l'administrateur du serveur doit :
- installer le module tele.cgi,
- renseigner les variables $UpLoadSub et $ImgUrl du fichier config.
Les "sous-pages". Il s'agit de pouvoir organiser le texte de manière hiérarchique. Supposons que l'on veuille éditer un journal mensuel à raison d'une page par mois. On désire également placer dans cette page un chapitre par semaine. Si on a 200 lignes de texte par semaine, donc 800 lignes pour la page du "journal mensuel", l'accès au bas de la page risque dêtre fastidieux. On peut dans ce cas utiliser les sous-pages. Voici comment procéder :
- Créer d'abord la page JournalAvril
- Dans cette page JournalAvril, créer 4 sous-pages appelées Semaine1, Semaine2, Semaine3 et Semaine4, en utilisant la syntaxe suivante : /Semaine1.
Le caractère / va générer un lien suivi du point d'interrogation de couleur. On peut alors éditer la page /Semaine1. A partir de maintenant, on peut aller directement à la page JournalAvril/Semaine1? sans avoir besoin de passer par la page JournalAvril?.
On aurait même pu créer d'abord la page JournalAvril/Semaine1?, puis la page intermédiaire JournalAvril?.
Cette technique de sous-pages est utilisable avec les trois type de liens décrits dans l'AideEnLigne.
Remarques : Cette technique n'est possible que si la variable $UseSubPage du fichier config est égale à 1 . A chaque visualisation de la sous-page, un menu (ou une icône selon les versions) concernant la "page mère" (ou sur-page ?) s'affichera. On ne peut créer plusieurs niveaux de sous-pages.
La création de liens. Nous avons vu qu'il y avait 3 façons de créer des liens avec Wiki. Mais d'autres possibilités sont offertes pour changer l'apparence finale du lien dans une page de texte.
- Les "liens libres" (freelinks) sont créés en entourant le texte d'une double paire de crochets comme ceci [[une nouvelle page]]. Ils permettent de créer un lien avec n'importe quelle partie de texte, même si elle comporte des espaces. Plutôt que de faire apparaître le nom du lien, on peut le documenter, c'est à dire ajouter un texte qui représente plus clairement le lien. Il suffit d'insérer le caractère | entre le lien et le texte qui le représentera. Ainsi le texte [[ref 12 34xp9| reference page 9]] apparaitra sous le nom "reference page 9" et non sous le nom "ref 12 34xp9". En voici la démonstration :
[reference page 9]?
Remarque : Par contre on ne peut pas insérer de signet dans un tel lien. Voir le paragraphe ci-dessous concernant les signets.
- Les liens créés en intercalant majuscules et minuscules. Les informaticiens sont friands de cette écriture (voir SmallTalk). Mais le texte du lien qui apparait reste quelquefois peu explicite. La syntaxe suivante permet en quelque sorte de documenter le lien : [TriCks56_JP200203_TZast Astuces Avril 2002] Le texte qui apparaît alors est [Astuces Avril 2002] , ce qui est plus explicite pour le surfeur. La paire de crochets qui entoure le lien est visible et notifie que l'on est en présence d'une référence à un lien. D'autre part, quand le curseur de la souris passe au-dessus de cette référence, on peut lire, dans le navigateur, l'adresse réelle du lien.
- Les liens URL, c'est à dire commencant par exemple par http:// , ftp:// , mailto:a@b.c . On peut leur appliquer la technique ci-dessus, c'est à dire entourer le lien par une paire de crochets [ ] puis rajouter la documentation du lien entre les crochets. Cette technique est appliquée sur les liens de la page Administration.
Remarque : Cette technique n'est utilisable que si les variables $FreeLinks et $BracketText du fichier config sont à 1 .
Les liens RFC et ISBN. Vous pouvez insérer automatiquement un lien vers la page de texte de la RFC correpondante sur Internet en tapant simplement le nom de la référence; comme la RFC 1918. Les pages utilisée sont celle du site www.faqs.org. La même chose existe pour les références de livres comme ISBN 0-741-34586-5 (autre site, rechercher). Dans ce cas, plusieurs possibilités sont proposées.
Les signets. Avec la version wiki-0.92p8, l'implémentation de signets améliore encore les possibilités de mise en page. Cette technique, connue du monde HTML, consiste à placer, dans une page de texte, des repères, afin de pouvoir les atteindre directement depuis une autre page.
Deux étapes, donc :
- Placer un repère dans une page : Ceci consiste à glisser la chaine [#repereA] dans le corps du texte. Ce repère n'apparaît pas quand on visualise la page. Par exemple je place un repère ici . Mais il n'est pas visible.
Remarques : La syntaxe d'écriture du signet impose de ne pas placer d'espace ni de caractère accentué dans le nom du signet. Au lien du caractère espace, vous pouvez toujours utiliser le caractére souligné "_".
- Dans une autre page, insérer un lien comprenant le nom de la page et le nom du signet avec la syntaxe suivante : AideEnligne#depuis. Ce qui donnera :
AideEnLigne
Mais seul le titre de la page apparaît, ce qui est dommage. On peut combiner plusieurs techniques pour documenter le lien et le signet en écrivant [AideEnLigne#depuis Utiliser les signets]. Ce qui donne :
[Uiliser les signets]
Comme celà a été précisé plus haut, hélas, cette technique du signet ne peut pas être utilisée avec les liens libres (double paires de crochets).
Remarque : La variable $NamedAnchors determine l'utilisation de cette technique :
- $NamedAnchors=0 Les signets ne sont pas utilisés pour la navigation (sans jeu de mot!). Si des signets sont insérés dans un texte, ils sont visibles.
- $NamedAnchors=1 Les signets sont utilisés pour la navigation. Leur présence est visible dans les pages.
- $NamedAnchors=2 Les signets sont utilisés pour la navigation. Leur présence est invisible dans les pages.
La redirection de page. Il peut arriver que l'on désire changer le nom d'une page. Voici comment procéder :
- créer la nouvelle page NouvellePage?,
- y copier le contenu de la page à renommer, puis sauvegarder la NouvellePage?,
- editer ensuite la page à renommer, et insérer les caractères suivants au tout début de la page (les premiers caractères de la page) :
#REDIRECT NouvellePage?
Toute requête tentant d'accéder à l'ancienne page sera redirigée de manière transparente vers la NouvellePage?.
'Protection contre l'écriture. Cette fonctionnalité, bien qu'étant contraire à l'esprit Wiki, a été mise en place à la demande plusieurs utilisateurs. Un utilisateur qui a choisi ses préférences et donc obtenu un ID, peut gérer l'accès en écriture à sa propre page. Il lui suffit pour cela d'insérer les caractères suivants au tout début de la page (les premiers caractères de la page) :
#EDITABLE 1204 1601 1171
Dans l'exemple ci-dessus, seuls les utilisateurs dont les ID sont 1204, 1601 et 1171 pourront accéder en écriture à la page.
- Ce champ n'est visible qu'en mode édition.
- L'administrateur du site a l'accès en écriture à ces pages.
- On ne peut pas utiliser à la fois la redirection de page et la protection en écriture, puisque ces deux champs doivent chacun être les premiers caractères de la page.
Insérer du texte sans qu'il soit interprété. Si vous regardez attentivement le code de cette page (ou plutôt celui du CahierDeBrouillon), vous verrez apparaître une paire de balises HTML inconnue : < nowiki > </ nowiki >. Cette paire de balises sert simplement à protéger une partie du code pour que celui-ci ne soit pas interprété par Wiki. Par exemple, si je veux commencer une ligne avec le signe astérisque :
*cette ligne ne génère pas une liste non-numérotée !
2005-07-31 14:20:06 -- Cmic
Contribution de Michel Marcon e-mail (adresse à reconstruire) : mailto:cmic<at>live<dot>fr
|