Internet Information Server (IIS) de Microsoft est le serveur web intégré de Windows. Il peut s'avérer utile d'héberger TiddlyWiki dans IIS afin de bénéficier des fonctionnalités de réécriture d'URL, d'hébergement de fichiers statiques ou de redémarrage automatique après un crash.

1. Activer IIS

1. Dans la barre de recherche Windows, saisir « Activer ou désactiver les fonctionnalités Windows ».
2. Cliquer sur l'icône « Activer ou désactiver les fonctionnalités Windows » qui apparaît dans les résultats de recherche.
3. Cocher la case Internet Information Services (IIS) puis cliquer sur le bouton Ok.
4. L'installation prend quelques minutes. Une fois terminée, cliquer sur le bouton Fermer

2. Installer les outils requis

1. Installer le module IIS HttpPlatformHandler à partir de https://www.iis.net/downloads/microsoft/httpplatformhandler
2. Installer Node.js à partir de https://nodejs.org/
3. Installer Git à partir de https://git-scm.com/
   • optionnel ; uniquement nécessaire pour utiliser la dernière version de TiddlyWiki à partir de GitHub – voir ci-dessous

3. Installer TiddlyWiki et paramétrer un nouveau wiki

1. Créer un répertoire approprié pour le wiki, par exemple C:\MesAffaires
2. A l'intérieur, créer un fichier C:\MesAffaires\package.json contenant :

   {
       "name": "MesAffaires",
       "description": "La description de ce wiki",
       "dependencies": {
           "sax": "1.2.4",
           "tiddlywiki": "*"
       }
   }

   copier dans le presse-papier

3. Créer un fichier C:\MesAffaires\web.config contenant :

   <?xml version="1.0" encoding="UTF-8"?>
   <configuration>
       <system.webServer>
           <handlers>
               <add 
                   name="httpplatformhandler"
                   path="*"
                   verb="*"
                   modules="httpPlatformHandler"
                   resourceType="Unspecified"
                   requireAccess="Script" />
           </handlers>
           <httpPlatform 
              stdoutLogEnabled="true"
              stdoutLogFile=".\node.log"
              startupTimeLimit="20"
              processPath="C:\Program Files\nodejs\node.exe"
              arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MonAppli">
               <environmentVariables>
                   <environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />
                   <environmentVariable name="NODE_ENV" value="Production" />
               </environmentVariables>            
           </httpPlatform>
       </system.webServer>
   </configuration>
   

   copier dans le presse-papier

4. Créer un sous-répertoire « wiki » : C:\MesAffaires\wiki
5. A l'intérieur, créer un fichier C:\MesAffaires\wiki\tiddlywiki.info contenant :

   {
   	"description": "Mon wiki",
   	"plugins": [
   		"tiddlywiki/tiddlyweb",
   		"tiddlywiki/filesystem"
   	],
   	"themes": [
   		"tiddlywiki/vanilla",
   		"tiddlywiki/snowwhite"
   	]
   }
   

   copier dans le presse-papier

6. Créer un sous-répertoire « tiddlers » : C:\MesAffaires\wiki\tiddlers
7. A l'intérieur, créer un fichier C:\MesAffaires\wiki\tiddlers\config-tiddlyweb-host.tid contenant :

   title: $:/config/tiddlyweb/host
   text: $protocol$//$host$/MonAppli/
   

   copier dans le presse-papier

   • (Voir la documentation pour les détails des champs de configuration de HttpPlatformHandler)
8. Exécuter la commande npm install depuis le répertoire C:/MesAffaires

4. Paramétrer l'application dans IIS

• Dans la barre de recherche Windows, saisir « IIS » puis cliquer sur l'icone du « Gestionnaire des services internet (IIS) »
• Localiser le serveur dans la colonne « Connexions » à gauche, et cliquer sur le triangle pour développer son contenu.
• Ouvrir le dossier « Sites »
• Faire un clic droit sur « Default Web Site » et sélectionner « Ajouter une application » dans le menu déroulant
• Saisir les informations suivantes dans le formulaire :
  1. Alias : MonAppli
  2. Chemin physique : C:\MesAffaires
• Cliquer sur OK

5. Tester l'application

Pour tester l'application, il suffit de visiter http://localhost/MonAppli/ avec un navigateur internet.

Notes

• Si vous voulez de l'authentification, spécifiez un nom d'utilisateur et un mot de passe dans la commande --listen du fichier web.config. Par exemple :
  • arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki-server --listen username=jacques "password=MonMotDePasse" port=PORT path-prefix=/MonAppli">
  • Notez l'emploi des guillemets autour du mot de passe, sous forme de codes HTML : "
• Pour prendre en compte une modification des paramètres dans le fichier web.config ou une modification du code de l'application, vous devrez redémarrer le serveur IIS à l'aide du « Gestionnaire des services internet (IIS) »