Depuis : 5.1.18 See WebServer for details of TiddlyWiki's web server functionality.

Sert un wiki via HTTP.

La commande listen utilise des paramètres de commande nommés :

--listen [<nom>=<valeur>]...

Tous les paramètres sont optionnels avec des valeurs par défaut sûres, et peuvent être spécifiés dans n'importe quel ordre. Les paramètres reconnus sont les suivants :

• host - nom ou adresse de machine hôte à laquelle sera attaché le service (par défaut "127.0.0.1", autrement dit "localhost")
• path-prefix - préfixe optionnel pour les noms de chemin
• port - numéro de port sur lequel écouter ; une valeur non numérique est interprétée comme un nom de variable d'environnement dont sera extrait le numéro de port (par défaut à "8080")
• credentials - chemin vers le fichier CSV d'autorisations (relativement au dossier du wiki)
• anon-username - nom d'utilisateur qui servira à signer les modifications si l'utilisateur est anonyme
• username - nom d'utilisateur optionnel pour l'authentification basique
• password - mot de passe optionnel pour l'authentification basique
• authenticated-user-header - nom d'en-tête optionnel à utiliser pour les authentifications de confiance
• readers - liste de personnes de confiance autorisées à lire ce wiki, séparées par des virgules
• writers - liste de personnes de confiance autorisées à modifier ce wiki, séparées par des virgules
• csrf-disable - donner la valeur "yes" pour désactiver les vérifications CSRF (vaut "no" par défaut)
• sse-enabled - donner la valeur "yes" pour activer les événement envoyés par le serveur (valeur "no" par défaut)
• root-tiddler - le tiddler à servir à la racine (par défaut "$:/core/save/all")
• root-render-type - le type de contenu avec lequel le tiddler racine doit être rendu (par défaut "text/plain")
• root-serve-type - le type de contenu avec lequel le tiddler racine doit être servi (par défaut "text/html")
• tls-cert - nom de chemin du fichier de certificat TLS (relativement au dossier du wiki)
• tls-key - nom de chemin du fichier de clé TLS (relativement au dossier du wiki)
• debug-level - niveau de débogage optionnel ; mettre à "debug" pour voir le détail des requêtes (par défaut à "none")
• gzip - donner la valeur "yes" pour activer la compression gzip pour certaines interactions http (par défaut à "no")
• use-browser-cache - une valeur "yes" autorise le navigateur à mettre en cache les réponses pour économiser de la bande passante ("no" par défaut)

Pour plus d'informations sur la manière de donner accès à votre instance de serveur à l'ensemble de votre réseau local, ainsi que sur les risques éventuels en matière de sécurité, voir le tiddler WebServer sur tiddlywiki.com.