Execute - Info

De l'utilisation du Wiki sur ce site


Les sites Wiki, dont le plus connu est sans doute Wikipedia, sont des sites web mis à jour en ligne grâce à une syntaxe spécifique indépendante du format HTML.
Les Wiki ont également la particularité de pouvoir définir un lien vers un contenu qui n'existe pas encore.

Cette page est elle-même une sorte de Wiki car son contenu est rédigé avec une syntaxe spécifique à Execute.

Ce Wiki a deux particularités remarquables :
  1. Tous les éléments "wiki" sont identifiés par une paire de parenthèses
  2. Le nom de la page est arborescent, cette page se nomme par exemple /Documentation/Wiki et est accessible par l'adresse suivante Wiki, mais il est tout à fait possible de créer une page homonyme à un autre endroit Wiki.

Ce Wiki n'est pas communautaire, vous ne pouvez donc pas intervenir dessus, mais si vous êtes intéressé par la mise en place d'un Wiki Excute, n'hésitez pas à prendre Contact.

Wiki Execute


Le Wiki Execute utilise deux syntaxes spécifiques.

La première pour les titres qui sont des lignes précédées de 1 à 5 points d'exclamations.
!!Wiki Execute, pour un titre de deuxième niveau.

La seconde utilise une paire de parenthèses contenant un code alphabétique suivi de deux points.
Par exemple, le code 'b' permet de mettre en (b:gras) : gras.

Remarquez que l'usage de parenthèses lève toute ambiguïté sur la portée d'un format.
En HTML, le code suivant est incorrect : texte <b> gras <i> gras + italique </b> ??? </i> car les balises se croisent et le format est indéterminé à l'emplacement des trois points d'interrogation. Avec le Wiki Execute, la confusion est impossible, le code se termine avec sa parenthèse associée (b: gras (i: gras + italique ) gras).

Certains code ont été ajoutés pour faciliter la référence à des sites particuliers:
Le code 'wp' permet de définir un lien vers (wp:Wikipedia) : Wikipedia.
Le code 'php' fait référence à la documentation en ligne de PHP (php:strlen) : strlen.

Tout naturellement, le code 'http' permet, quand à lui, de définir un lien (http://www.execute.re) : http://www.execute.re

Certains codes utilisent le caractère pipe | pour séparer des paramètres; c'est le cas du code http qui permet de définir le texte du lien (http://www.execute.re|Execure SARL) : Execure SARL.

La syntaxe accepte deux caractères spécifiques devant le code. Le point d'interrogation affiche le code au lieu de l'interpréter et le point d'exclamation sert de commentaire.

(!code:peu importe le contenu des parenthèses, avec un "!" tout est ignoré)

Et pour affiche la ligne ci-dessus, il a suffit d'ajouter un ? au début

(?!code:peu importe le contenu des parenthèses, avec un "!" tout est ignoré).

Les liens Wiki


Dans Wiki Execute, les liens "wiki" sont déclarés explicitement et ne dépendent pas d'une notation CamelCase. Le code 'wk' permet d'indiquer une adresse absolue ou relative d'une page Wiki.

Nous sommes actuellement sur la page /Documentation/Wiki.
Le code (wk:lien) va définir le lien relatif /Documentation/Wiki/lien.

Pour référencer un lien vers cette page je suis donc obligé de revenir d'un cran dans l’arborescence. Cela se fait, comme sur un système de fichiers, avec les deux points (wk:../Wiki|cette page).

Notez que je peux toujours utiliser la notation absolue qui commence par un / (wk:/Documentation/Wiki).

Afin de conserver des URL lisibles, les accents sont automatiquement supprimés des liens Wiki. Ils sont cependant conservés dans le code, notamment pour afficher correctement l'Indexe.

Les modules


Afin de permettre l'ajout de fonctionnalités évoluées, Wiki Execute supporte l'ajout de modules avec le code mod; par exemple (mod:index) affiche l'Indexe général du site.

A la différences des autres codes Wiki qui sont évalués à la sauvegarde de la page est mis en cache, les modules sont invoqués dynamiquement à chaque chargement de la page - y compris quand elle provient du cache.

Le cache


Toutes les pages de ce Wiki sont mises en cache dans le sous-répertoire -cache-, cela permet de consulter le site en cas de panne de la base de donnée, et évite de sollicité les ressources du serveur car tous les codes Wiki sont déjà évalués dans le cache.

L'adresse de cette page en cache est http://www.execute-info.com/-cache-/Documentation/Wiki/index.php.
Notez que cette URL, bien que valide, redirige automatiquement le navigateur hors du cache.
Dernière mise à jour le 11/06/2012
©2011 Execute SARL