Actux Wiki | PmWikiFr / Variables d'emplacements

<< Variables de mise en page | PmWikiFr.Variables | Variables de liens >>

Quand on travaille avec les variables de fichier ou de chemin, il faut distinguer les URLs des fichiers sur disque. Par exemple:

La d�finition include() est utilis�e pour inclure d'autres fichiers (du disque) dans le script en cours d'ex�cution. Donc, il est n�cessaire de conna�tre le chemin d'acc�s sur le syst�me de fichiers du disque du serveur.
Les variables $ScriptUrl et $PubDirUrl sont utilis�es pour dire � un navigateur, se connectant via le serveur Internet, comment ex�cuter le script pmwiki ($ScriptUrl) et la base de l'url pour r�cup�rer des fichiers du r�p�rtoire PmWiki pub/ ($PubDirUrl).

Noter qu'un navigateur requi�re une URL (http://www.example.com/pmwiki/pub) alors qu'une d�finition include statement requiert un chemin d'acc�s au fichiers du serveur ($FarmD/scripts/untruc.php).

$FarmD: Le r�pertoire du serveur ou est situ�e la ferme (c'est � dire le r�pertoire contenant la copie de la ferme de pmwiki.php et le r�pertoire scripts/ ). Ce r�pertoire est automatiquement determin� par pmwiki.php d�s qu'il tourne, et peut �tre utilis� pour distinguer les sous-r�pertoire cookbook/ et pub/ sdepuis les sous-r�pertoires d'un champ.
$FarmPubDirUrl: est l'url qui se r�f�re au r�pertoire pub pour l'ensemble d'une ferme. Par d�faut sa valeur est la m�me que $PubDirUrl.
$PageCSSListFmt: est un tableau associatif que PmWiki utilises pour trouver les fichier locaux de cionfiguration css. Il consiste en un ensemble de paire (cl�,valeur) pairs. La cl� est un chemin possibke cers un fichier sur disque contenant les donn�es css, alors que le valeur est l'URL correspondant � ce fichier. Ces cl�s sont test�s en s�quence, et pour chaque fichier r�f�renc� qui existe, le navigateur charge les donn�es correspondants � l'URL. La valeur par d�faut pour ce tableau est :

        array( 
          'pub/css/local.css' => '$PubDirUrl/css/local.css',
          'pub/css/PmWikiFr.css' => '$PubDirUrl/css/PmWikiFr.css',
          'pub/css/PmWikiFr.PathVariables.css' => '$PubDirUrl/css/PmWikiFr.PathVariables.css');

Notez que la valeur par d�faut (pour la version pmwiki-2.1.beta26) ne fait pas r�f�rence � $FarmPubDirUrl. Si vous souhaitez �tre capable de placer des fichiers de configuration css dans les r�pertoire pub des champs, et dans le r�pertoire pub de la ferme, vous devez ajouter ces lignes a� votre fichier local/config.php (comme d�crit (en anglais) dans Cookbook:SharedPages):

        $PageCSSListFmt = array(
          '$FarmD/pub/css/local.css' => '$FarmPubDirUrl/css/local.css',
          '$FarmD/pub/css/$Group.css' => '$FarmPubDirUrl/css/$Group.css',
          '$FarmD/pub/css/$FullName.css' => '$FarmPubDirUrl/css/$FullName.css',
          'pub/css/local.css' => '$PubDirUrl/css/local.css',
          'pub/css/$Group.css' => '$PubDirUrl/css/$Group.css',
          'pub/css/$FullName.css' => '$PubDirUrl/css/$FullName.css');

$PubDirUrl: est l'URL qui r�f�re au r�pertoire pub. ce r�pertoire contient tous les fichiers et sous-r�pertoires qui doivent �tre directement accessibles depuis un navigateur (c'est � dire les fichiers CSS et HTML). Le plus important ici est le sous-r�pertoire skins.
$ScriptUrl: est l'URL que les navigateurs des utilisateurs doivent utiliser pour acc�der � PmWiki, comme ferme ou comme champ. C'est utilis� quand PmWiki � besoin de g�n�rer un lien vers une autre page du Wiki ou une action. PmWiki est g�n�ralement assez bon lorsqu'il "envisage" la valeur correcte de $ScriptUrl, mais il arrive parfois qu'un administrateur doive le d�finir explicitement du fait des maniplation d'url du serveur web (Telle qu'expliqu� (en anglais) dans Cookbook:CleanUrls, mod_rewrite, des configurations PHP bizarres, etc.).
$SkinDirUrl: d�fini par le script scripts/skins.php comme �tant l'url de base du r�pertoire de th�me courant (c'est � dire dans un r�pertoire de 'pub/skins/'). Cette variable est typiquement utilis�e dans un fichier de mod�le .tmpl pour fournir l'acc�s au fichiers .css et aux images associ�es avec un th�me.
$UploadDir: Le r�pertoire ou sont stock�s les fichiers envoy�s sur le serveur. Par d�faut c'est uploads/ dans le r�pertoire pmwiki, mais ce peut �tre n'importe ou sur le serveur. Ce r�pertoire doit pouvoir �tre �crit par un processus du serveur web si on veut pouvoir envoyer des fichiers.

Voir aussi

Variables de liens - variables qui contr�lent l'affichage des liens dans les pages
Variables d'édition - variables utilis�es lors de l'�dition des pages
Variables pour le t�l�chargement - variables utilis�es pour les envois de fichiers et les attachements

From Actux Wiki

PmWikiFr: Variables d'emplacements

Voir aussi