====== Wiki du Fuz ======
Ce wiki, c'est le tien.
Tu peux contribuer !
Voici un petit guide __~ "howto use this wiki!" ~__
Pour essayer sans prendre de risque, tu peux éditer la page [[wiki:sandbox:start|sandbox]], enjoy!
===== Mettre des trucs dedans =====
* [[syntax|Aide sur la syntaxe]]
* Plein de liens au sujet de [[dokuwiki]], le moteur de wiki que t'es dessus là maintenant.
===== Mettre les mains dedans =====
* Un wiki ça se jardine. Faut aider les autres à le rendre pratique : créer des liens entre les pages, compléter/corriger...🍊
* Un wiki ça se maintient. Faut héberger, configurer, maintenir à jour... Voir la page [[infra:adminsys]].
===== Utilisation =====
* on peut se rendre sur la page **"Recent Changes"** pour voir ce qui a bougé (attention elle est **dépendante du [[#Tips|namespace]]** dans lequel on est)
* ensuite on peut aller voir dans la **"sitemap"** comment ça se passe, par rapport aux namespaces
* en cliquant sur le **logo** du haut, je reviens au sommaire
* pour **créer une page** : mettre un nom dans l'URL après "?id=...", **ou bien** mettre le [[lien]] dans une page et cliquer dessus pour la créer (**méthode préférée** car évite de laisser une page orpheline)
* pour **effacer une page** : l'éditer, supprimer le texte et la sauver (au passage si un **namespace** est vide il est effacé)
* pour **déplacer une page** (et les liens dans le wiki), il faut être admin, aller sur la page et chercher **"Move"** dans **"Admin"** (sinon un gros //couper/coller// fera l'affaire mais détruit l'historique des modifications)
===== Tips =====
* **NamesSpaces**
* ce sont les **répertoires** du wiki, ils sont séparés par des ":" 🌶️
* utiles pour ranger le bordel, mais point trop n'en faut
* les **namespaces** représentent les répertoires, on les crée comme les pages,
* quand on est dans un namespace (url = ... namespace: ), par défaut le wiki charge la **page "start"**
* **Les templates** (du plugin template)
* permettent de préformatter une page dans un namespace lors de sa création
* **c_template** pour le namespace local et **i_template** pour les sous-namespace récursifs sont **éditables** (grace au plugin [[#TemplatePageName]]) !
* on peut **lister** les éléments du namespace en utilisant le plugin NSPage, [[#Nspages|explicité plus bas]]
* on peut mettre également les **images** dans le namespace par souci de rangement (plutôt que de tout laisser en **vrac** a la racine)
* **Macros**
* La table des matières (TOC) peut être désactivée en utlisant la macro ''%%~~NOTOC~~%%'' dans la page
* On peut ne pas interpréter des macros (utile pour les documenter justement) en les encadrant de ''%%'' comme ceci : ''%%macro%%''
* **Liens**
* le lien d'une page (dans l'URL) est un [[wpfr>slug]], le préférer court et descriptif
* pour l'inclusion dans une page simplement, les tirets bas sont équivalents à des espaces et les liens sont insensibles à la casse. Ainsi, ''[[projets:fuz:Presence Button]]'' donne [[projets:fuz:Presence Button]]
* pour les liens vers wikipedia, ''[[wpfr>Wikipedia]]'' donne [[wpfr>Wikipedia]] (francophone), ''[[wp>Wikipedia]]'' donne [[wp>Wikipedia]] (anglophone)
===== Pages utilisateur =====
On a 2 pages qui se créent quand on s'authentifie pour la première fois : une publique et une privée (solution sujette à amélioration, à tester)
* la **page publique** est dans **:user:USERNAME**
* une page simple pour les gens non loggés (par ex : [[user:barzi|celle-ci]])
* la **page privée** est dans **:user:USERNAME:start**
* le username dans ce cas est le namespace, dans lequel on peut rajouter toute une arborescence.. on peut même faire un site perso en somme (par ex : [[user:barzi:|celle-là]])
et + un goodie qui fait que quand on référence **:user:USERNAME** dans le wiki, on pointera soit sur la publique soit sur la privée quand on est loggé.
Pour aller éditer tout ca on va dans la sitemap en haut a droite.
Il faut définir un peu de politique d'édition/vie privée sur ce qu'on veut montrer à l'extérieur...\\
Pour ce qui est de la [[user:start|liste des usagers]], c'est une simple liste, et j'ai pas trouvé comment choper les admins pour signaler que ce sont des "lapins" (ceux qui peuvent créer des comptes). Help ! FIXME
===== Doc des Plugins installés (merci de mettre à jour si nouveau) =====
==== Wrap ====
* permet de créer des **boîtes colorées** mais aussi de surligner du texte
* [[doku>plugin:wrap|doc]] et [[http://demo.selfthinker.org/plugin:wrap|demo]]
* ''%%xxxx%%''
* ''%%%%'' ... une boîte verte qui fait 80 % de la largeur totale de la page
* **surlignage**, par ordre croissant d'importance : notice (bleu), safety (vert), caution (jaune), warning (orange) danger (rouge)
* ''%%%%'' fait une col de 165 de large
==== TemplatePageName ====
* Permet d'**éditer** les pages de template (sinon il faut aller sur le **serveur**)
* Change le nom des templates (pages qui **préremplisse** des nouvelles pages dans un namespace donné)
* **c_template** (template for new page in the current namespace) and **i_template** (template inherited from higher namespaces as well)
* [[doku>plugin:templatepagename|doc]] et [[https://www.dokuwiki.org/namespace_templates|convention]] pour les variables
* utiles : %%@!!PAGE@%% et %%@DATE@%%
==== Nspages ====
* **Liste les pages sous un namespace**, plein d'options
* [[doku>plugin:nspages|doc]]
* **%%%%** dans une page
* -exclude:nameOfPage
* -h1 : display h1 title of page
* -sortByDate : sort by date of modification
* exemple : %%%%
==== Include Plugin ====
* **inclut le contenu d'un page** à l'intérieur d'une autre
* [[doku>plugin:include?s[]=include&s[]=plugin|doc]]
* **%%{{namespace>project_foo}}%%** will include all pages in the project_foo namespace.
* **%%{{page>my_page}}%%** will include my_page
* **%%{{page>wiki:syntax#Tables}}%%** will include the section about tables of the syntax page.
==== MovePage Plugin ====
* rajoute une option "Move" dans Admin
==== Folded Plugin ====
* [[doku>plugin:folded|doc]]
%%++++ Title |%%
text bloc
%%++++%%
%%{{page>some other wiki page&inline}}%%
==== Discussion ====
* permet une **discussion dans la page**
* [[doku>plugin:discussion|doc]]
* %%~~DISCUSSION~~%%
* %%~~DISCUSSION:off~~%%
* %%~~DISCUSSION:closed~~%%
==== Move ====
* Pour [[doku>plugin:config|renommer/déplacer]] des pages sans péter les liens. Lien dans l'admin...
==== CellBgColor ====
* Colorie les fonds des tables, [[doku>plugin:cellbg|Doc]]
* [[https://html-color-codes.info/|color picker]]
* %%| @palegreen:Validé | @orange:À valider | @red:Non fonctionnel |%%
|@palegreen:Validé |@orange:À valider |@red:Non fonctionnel |
==== Changes ====
* Pour [[doku>plugin:changes|lister les dernier changements]]
* %%{{changes>render = list}}%% .. rendu sous forme de liste à point
* %%{{changes>type = create}}%% .. juste les créations
* %%{{changes>ns=foo}}%% .. pour le namespace foo
==== Doodle ====
* génère des [[doku>plugin:doodle4|sondages]]
==== Pagelist ====
* [[doku>plugin:pagelist|formatte les listes]] provenant de plugins qui en génère (comme Changes).
==== EditTable ====
* rendre les tables éditables + creation dans menu, [[doku>plugin:edittable|doc]]
==== tablelayout Plugin ====
* étend la syntaxe des tables pour fixer la taille par ex, [[doku>plugin:tablelayout|Doc]]
==== addnewpage ====
* rajoute un bouton de création de page, [[doku>plugin:addnewpage|Doc]]
-----
-----
===== Doc des Plugins à installer =====
==== TableCalc ====
* faire de l'**excell**
* [[doku>plugin:tablecalc|doc]]
* **| ~~=sum(range(0,0,col(),row()-1))~~ |**
==== CSV ====
* [[doku>plugin:csv|doc]]
* < csv>
==== color syntax ====
* %%colorise%%
* [[doku>plugin:color|doc]]
* %%colorise%%