Textile Wiki
Textile est une syntaxe wiki qui est plutôt facile à apprendre. Je l'utilise régulièrement sur redmine.
Ce que j'ai voulu créer avec ce projet, c'est un site wiki qu'on gère facilement sans grande configuration. Il en existe plein avec ce but, mais voici le mien.
Principe
L'idée est de pouvoir gérer ses pages, ses dossiers et ses fichiers annexes comme dans un explorateur de fichiers.
J'ai maintenu pendant longtemps une documentation personnelle en texte brute. J'avais des fichiers snippets, des séquences d'installation, de configuration ou encore des dossiers d'API doc que je téléchargeais. Bref, c'était un gros bazar en ligne avec une exploration Apache.
Finalement, ce que je voulais, c'était juste rendre ça plus joli :)
Générer les pages HTML
A partir de mon dossier contenant toutes sortes de fichiers, je crée un site dans lequel on peut naviguer. En fait, tous les fichiers avec l'extension .wiki sont convertis en HTML à l'affichage.
Tout le fonctionnement du site se résume à un dossier .wiki/ et un fichier .htaccess à mettre à la racine du site. Et ça ne marche qu'avec PHP et Apache.
Conclusion
C'est avant tout un wiki adapté à mes besoins qui va peut-être satisfaire d'autres personnes comme moi.
Toutes les infos :
- le site : http://textilewiki.com
- le dépôt Git : http://github.com/neolao/wiki
- une demo avec le thème par défaut : http://demo.textilewiki.com/theme-dark/
- une demo avec le thème dark : http://demo.textilewiki.com/theme-dark/
Commentaires
1. Le vendredi, juillet 8 2011, 22:23 par butterfly
très intéressant ton billet
2. Le samedi, juillet 9 2011, 07:22 par Eric
Qu'est ce qui t'as poussé vers Textile ?
J'ai fais un billet sur un sujet très proche il n'y a pas longtemps (http://zenprog.com/index.php?cle=Sa...) et du coup, j'ai choisi Markdown ...
3. Le samedi, juillet 9 2011, 07:24 par Eric
(PS : Je n'arrive pas à m'abonner à ton flux de commentaires qui renvoie vers le flux des billets sur feedburner)
4. Le samedi, juillet 9 2011, 13:56 par neolao
Je connais surtout 2 syntaxes, textile et celui de dokuwiki. Ensuite, dans mes recherches de simples sites wiki à installer, je n'ai pas trouvé ce que je voulais. Je ne me suis même pas posé la question de la syntaxe à utiliser. J'ai pris naturellement quelque chose que je connaissais.
D'ailleurs, quand j'y pense, il est même possible d'avoir le choix de la syntax dans mon système. C'est juste qu'avec un nom de projet comme ça, j'ai pris parti sur Textile.
Edit: Je viens de l'ajouter en option de configuration pour m'amuser. Ça a l'air de marcher :)
5. Le lundi, août 15 2011, 23:16 par seb
bonjour,
mon serveur fonctionne, j'ai décompressé l'archive, mais où sont les fichiers php qui permettent de faire fonctionner le wiki ?
merci
6. Le lundi, août 15 2011, 23:23 par neolao
Tout est dans le dossier .wiki, qui est peut-être un dossier invisible pour toi
7. Le dimanche, août 21 2011, 20:13 par seb
non . je vois bien tous les dossiers et fichiers.
mais ton archive ne contient aucun index.php ou autre fichier qui appelles les fonctions,classes,... ni aucune structure permettant de faire fonctionner l'application.
contenu de .wiki :
dossiers :
- admin,data, inc, js, scripts,themes
fichiers :
-htaccess, config.ini, sitemap.php
est-ce qu'il faut plus que php et apache ou une configuration spécifique ?
merci
8. Le dimanche, août 21 2011, 23:47 par neolao
C'est grâce au htaccess à la racine de l'archive (en dehors du dossier .wiki)
C'est ce fichier qui va dire qu'on utilise PHP pour l'affichage
9. Le dimanche, février 10 2013, 21:15 par Dge
Bonjour,
Ok, ça fonctionne avec les options suivantes dans mon vhost :
- Options +FollowSymLinks
- AllowOverride All
---
Par contre, si c'est Ok pour la syntaxe des fichiers.wiki, j'ai pas bien compris où l'on doit mettre nos fichiers afin qu'il apparaissent. Une petite indication ?
10. Le dimanche, février 10 2013, 21:29 par neolao
Tu les mets à la racine du projet.
11. Le dimanche, février 10 2013, 22:36 par Dge
Bon, je viens juste de capter le truc. Yes, vraiment cool cet outil !!
Jusque là je stockais tout dans des Rep/docs.txt avec Apache pour browser et afficher mes affaires... v'là que j'utilise l'imparfait ...
Merci à toi de mettre ainsi à dispo, on reconnait les arbres à leurs fruits ...
Petit clin d'oeil concernant ton template neolao-3. Il a métamorphosé mon dokuwiki en 3s. Adopté. \o/