Ce wiki est un espace de travail et d'organisation, les informations qu'il contient peuvent être fausses ou erronnées et ne constitue pas une communication officielle d'Actux.

<< 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 dfinition include() est utilise pour inclure d'autres fichiers (du disque) dans le script en cours d'excution. Donc, il est ncessaire de connatre le chemin d'accs sur le systme de fichiers du disque du serveur.
  • Les variables $ScriptUrl et $PubDirUrl sont utilises pour dire un navigateur, se connectant via le serveur Internet, comment excuter le script pmwiki ($ScriptUrl) et la base de l'url pour rcuprer des fichiers du rprtoire PmWiki pub/ ($PubDirUrl).

Noter qu'un navigateur require une URL (http://www.example.com/pmwiki/pub) alors qu'une dfinition include statement requiert un chemin d'accs au fichiers du serveur ($FarmD/scripts/untruc.php).

$FarmD
Le rpertoire du serveur ou est situe la ferme (c'est dire le rpertoire contenant la copie de la ferme de pmwiki.php et le rpertoire scripts/ ). Ce rpertoire est automatiquement determin par pmwiki.php ds qu'il tourne, et peut tre utilis pour distinguer les sous-rpertoire cookbook/ et pub/ sdepuis les sous-rpertoires d'un champ.
$FarmPubDirUrl
est l'url qui se rfre au rpertoire pub pour l'ensemble d'une ferme. Par dfaut sa valeur est la mme 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 donnes css, alors que le valeur est l'URL correspondant ce fichier. Ces cls sont tests en squence, et pour chaque fichier rfrenc qui existe, le navigateur charge les donnes correspondants l'URL. La valeur par dfaut 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 dfaut (pour la version pmwiki-2.1.beta26) ne fait pas rfrence $FarmPubDirUrl. Si vous souhaitez tre capable de placer des fichiers de configuration css dans les rpertoire pub des champs, et dans le rpertoire pub de la ferme, vous devez ajouter ces lignes a votre fichier local/config.php (comme dcrit (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 rfre au rpertoire pub. ce rpertoire contient tous les fichiers et sous-rpertoires qui doivent tre directement accessibles depuis un navigateur (c'est dire les fichiers CSS et HTML). Le plus important ici est le sous-rpertoire skins.
$ScriptUrl
est l'URL que les navigateurs des utilisateurs doivent utiliser pour accder PmWiki, comme ferme ou comme champ. C'est utilis quand PmWiki besoin de gnrer un lien vers une autre page du Wiki ou une action. PmWiki est gnralement assez bon lorsqu'il "envisage" la valeur correcte de $ScriptUrl, mais il arrive parfois qu'un administrateur doive le dfinir 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
dfini par le script scripts/skins.php comme tant l'url de base du rpertoire de thme courant (c'est dire dans un rpertoire de 'pub/skins/'). Cette variable est typiquement utilise dans un fichier de modle .tmpl pour fournir l'accs au fichiers .css et aux images associes avec un thme.
$UploadDir
Le rpertoire ou sont stocks les fichiers envoys sur le serveur. Par dfaut c'est uploads/ dans le rpertoire pmwiki, mais ce peut tre n'importe ou sur le serveur. Ce rpertoire doit pouvoir tre crit par un processus du serveur web si on veut pouvoir envoyer des fichiers.

Voir aussi


Traduction de PmWiki.PathVariables Page originale sur PmWikiFr.PathVariables - Référencé par
Dernières modifications:
PmWikiFr.PathVariables: 12/11/2006 19:15
PmWiki.PathVariables: 28/03/2009 22:38