ReadMe

12 octobre 2014 à 19h10

Bienvenue sur TiddlyWiki, un carnet de notes personnel web et non-linéaire que tout le monde peut utiliser et conserver, sans dépendre d'une quelconque entreprise.

TiddlyWiki est un wiki interactif en JavaScript. Il peut être utilisé dans le navigateur sous forme de fichier HTML autonome ou comme une puissante application Node.js. Il est extrêmement personnalisable : l'interface utilisateur dans son intégralité est elle-même implémentée en WikiText recomposable à volonté.

Plus d'informations et démonstrations sur https://tiddlywiki.com

Installation de TiddlyWiki sur Node.js

Installez Node.js
- Linux
  Debian/Ubuntu :
  apt install node.js
  Et éventuellement :
  apt install npm
  Arch Linux
  pacman -S tiddlywiki
  (installe node et tiddlywiki)
- Mac
  brew install node
- Android
  Termux pour Android
- Autres
  Voir https://nodejs.org
Ouvrez un terminal de ligne de commande et saisissez :
npm install -g tiddlywiki
En cas d'erreur, il faudra peut-être relancer la commande en tant qu'administrateur :
sudo npm install -g tiddlywiki (Mac/Linux)
Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version
En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple 5.3.6 ; d'autres informations de débogage peuvent aussi apparaître).
Faites l'essai :
1. tiddlywiki monnouveauwiki --init server pour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveur
2. tiddlywiki monnouveauwiki --listen pour démarrer TiddlyWiki
3. Positionnez votre navigateur sur l'adresse http://127.0.0.1:8080/
4. Essayez d'éditer et de créer de nouveaux tiddlers
Eventuellement, créez une copie hors-ligne :
- Cliquez sur le bouton Enregistrer les modifications de la barre latérale, OU
- tiddlywiki monnouveauwiki --build index

L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki sera disponible seulement dans le répertoire où vous l'avez installé.

Si vous utilisez Debian ou une distribution Linux dérivée de Debian et que vous recevez une erreur node: command not found alors que le paquet node.js est installé, vous devrez peut-être créer un lien symbolique entre nodejs et node. Consultez le manuel de votre distribution et de whereis pour créer un lien correctement. Voir le rapport d'erreur 1434 sur github.

Exemple pour Debian 8.0 : sudo ln -s /usr/bin/nodejs /usr/bin/node

Vous pouvez aussi installer d'anciennes versions de TiddlyWiki ainsi :

npm install -g tiddlywiki@5.1.13

Utilisation de TiddlyWiki sur Node.js

TiddlyWiki5 peut être utilisé depuis la ligne de commande, dans le but d'effectuer un ensemble d'opérations qui manipulent dossiers TiddlyWiki, fichiers de tiddlers et fichiers TiddlyWiki.

Par exemple, la commande ci-dessous charge les tiddlers d'un fichier TiddlyWiki HTML, et enregistre l'un d'eux dans un fichier HTML statique :

tiddlywiki --verbose --load monwiki.html --rendertiddler LisezMoi ./lisezmoi.html

L'exécution du programme tiddlywiki depuis la ligne de commande démarre le noyau TiddlyWiki, charge les plugins de base et met en place une structure de wiki vide. Puis les arguments de la ligne de commande sont traités à la suite, de gauche à droite. Les arguments sont séparés par des espaces.

Le premier argument est un chemin optionnel vers le dossier à charger. Si absent, le répertoire courant est utilisé.

Suivent les commandes proprement dites, avec leurs arguments spécifiques, chaque commande étant annoncée par le préfixe --.

tiddlywiki [<cheminverslewiki>] [--<commande> [<arg>[,<arg>]]]

Les commandes disponibles sont :

Mise à niveau de TiddlyWiki sur Node.js

Si vous avez installé TiddlyWiki sur Node.js de manière standard, vous pouvez le mettre à jour dès qu'une nouvelle version est publiée, à l'aide de la commande suivante :

npm update -g tiddlywiki

Sur Mac ou Linux, vous devrez ajouter sudo :

sudo npm update -g tiddlywiki

Voir aussi

Ce fichier readme a été généré automatiquement par TiddlyWiki