Problèmes avec Microsoft Windows#

Configuration du Wiki#

L'approche la moins difficile pour définir l'emplacement de vos fichiers Wiki, c'est de la placer au même endroit que votre installation de Tomcat (ou de votre autre serveur web), et d'indiquer cet emplacement au format Unix. Par exemple, si vos fichiers se trouvent dans C:\JSPWiki\files, vous écrirez dans votre fichier de configuration qu'ils sont dans /JSPWiki/files.

Assurez-vous aussi de modifier la valeur du paramètre log4j.appender.~FileLog.File dans votre jspwiki.properties, si vous voulez qu'un fichier de journalisation (log) soit créé. Ce paramètre-là est bien caché, vers la fin du fichier de configuration. Son format est le même que celui du paramètre jspwiki.fileSystemProvider.pageDir, c'est-à-dire que les antislashs (barres obliques inverses : \) doivent être doublées.

Problèmes avec l'UTF-8#

Si vous avez des problèmes avec Tomcat 5.x (ou supérieur) et JSPWiki, et avec l'UTF-8, soyez attentif à ce qui suit !

Il vous faut éditer le fichier server.xml de Tomcat (situé dans le répertoire conf/ de Tomcat), et ajouter aux lignes :

<Connector port="8080"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000" 
               disableUploadTimeout="true"/>

les mots 'URIEncoding="UTF-8"'.

Vous devriez alors obtenir quelque chose comme ceci :

<Connector port="8080"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000" 
               disableUploadTimeout="true" 
               URIEncoding="UTF-8"/>

Rappelez-vous que si vous utilisez mod_jk, vous devez aussi définir le URIEncoding pour le JK Connector :

.........
  <service name="Catalina">
    <connector port="8080" />
.........
    <connector protocol="AJP/1.3" uriencoding="UTF-8" port="8009" />
.........
  </service>

Autres astuces#

Editer le menu de gauche#

Le menu de gauche (il se trouve par là <-----) n'est qu'une page Wiki standard, appelée LeftMenu.

Si vous (l'administrateur) ne voulez pas que quelqu'un d'autre la modifie, vous pouvez toujours éditer LeftMenu, puis en faire une page en lecture seule en définissant une ACL sur elle.

La partie basse du menu de gauche est, de manière analogue, appelée LeftMenuFooter, et elle est elle aussi totalement éditable.

Activer RSS#

Dans votre fichier jspwiki.properties, vous devrez modifier le paramètre jspwiki.rss.generate à la valeur true. Vous devrez aussi y changer le paramètre jspwiki.baseURL qui donne l'URL complète de votre Wiki. Sinon, le générateur RSS ne saura pas vers où ses liens doivent pointer... :-)

Je n'aime pas les ~TitresTousCollesCommeCa. Qu'est-ce que je peux faire ?#

Comme le dit Finns, "voe tokkiinsa" veut dire "oui, bien sûr"... Il vous suffit de changer le paramètre jspwiki.breakTitleWithSpaces à la valeur true dans votre fichier jspwiki.properties-file.