User Tools

Site Tools


wiki:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
wiki:start [2019-02-11 15:36] barziwiki:start [2023-02-02 22:06] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Ce wiki ======+====== Wiki du Fuz ======
  
-C'est le tien.+Ce wiki, c'est le tien.
  
 Tu peux contribuer ! 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 ===== ===== Mettre des trucs dedans =====
Line 12: Line 16:
 ===== Mettre les mains dedans ===== ===== 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 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 [[:adminsys]] .+  * 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 ===== ===== 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 ''<nowiki>%%</nowiki>'' comme ceci : ''<nowiki>%%macro%%</nowiki>''
 +  * **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, ''<nowiki>[[projets:fuz:Presence Button]]</nowiki>'' donne [[projets:fuz:Presence Button]]
 +    * pour les liens vers wikipedia, ''<nowiki>[[wpfr>Wikipedia]]</nowiki>'' donne [[wpfr>Wikipedia]] (francophone), ''<nowiki>[[wp>Wikipedia]]</nowiki>'' donne [[wp>Wikipedia]] (anglophone)
  
-  * quand on est dans un namespace (url = ... namespace: ), par défaut le wiki charge la page start (comme index.html) . Elle est éditable. Pour certains namespaces, comme les projets, on peut automatiser son remplissage en utilisant le plugin NSPage, explicité plus bas. 
-  * The TOC (table des matières) can be turned off on any single page using the control macro %%~~NOTOC~~%%.  
-  * ne pas interpreter des macros (utiles pour les documenter du coup) : % %something% % (sans les espaces) 
  
-==== Plugins ====+===== 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)
  
-Des plugins à envisager/ajouter :+  * la **page publique** est dans **:user:USERNAME** 
 +    * une page simple pour les gens non loggés (par ex : [[user:barzi|celle-ci]])
  
-  * Wrap. Permet de faire des bandeaux, des colonnes, etc. ([[https://www.dokuwiki.org/plugin:wrap|doc]], [[http://demo.selfthinker.org/plugin:wrap|démo]]) +  * la **page privée** est dans **:user:USERNAME:start**  
-  MovePour renommer/déplacer des pages sans péter les liens. ([[https://www.dokuwiki.org/plugin:config|doc]])+    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é.
------ +
------+
  
-==== Doc des Plugins installés (merci de mettre jour si nouveau) ====+Pour aller éditer tout ca on va dans la sitemap en haut droite.
  
-===== Wrap ===== +Il faut définir un peu de politique d'édition/vie privée sur ce qu'on veut montrer à l'extérieur...\\ 
-  * fais des boites colorées +Pour ce qui est de la [[user:start|liste des usagers]], c'est une simple listeet j'ai pas trouvé comment choper les admins pour signaler que ce sont des "lapins" (ceux qui peuvent créer des comptes). Help ! FIXME
-  * [[https://www.dokuwiki.org/plugin:wrap|doc]] et [[http://demo.selfthinker.org/plugin:wrap|demo]] +
-  * < wrap> xxxx </wrap> +
-  * <WRAP safety left round box 80%>  ... une boite verte  qui fait 80% largeur totale +
-  * couleur : notice(bleu)safety(vert), caution(jaune), warning(orange) danger(rouge) +
-  * <WRAP 165px left> fais une col de 165 de large+
  
-===== TemplatePageName =====+===== Doc des Plugins installés (merci de mettre à jour si nouveau) ===== 
 + 
 +==== Wrap ==== 
 +  * permet de créer des **boîtes colorées** mais aussi de <wrap hi>surligner du texte</wrap> 
 +  * [[doku>plugin:wrap|doc]] et [[http://demo.selfthinker.org/plugin:wrap|demo]] 
 +  * ''%%<wrap>xxxx</wrap>%%'' 
 +  * ''%%<wrap safety left round box 80%>%%''  ... 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) 
 +  * ''%%<wrap 165px left>%%'' 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é)   * Change le nom des templates (pages qui **préremplisse** des nouvelles pages dans un namespace donné)
-  * [[https://www.dokuwiki.org/plugin:templatepagename|doc]] et [[https://www.dokuwiki.org/namespace_templates|convention]] pour les variables +  *  **c_template** (template for new page in the current namespace) and **i_template** (template inherited from higher namespaces as well) 
-  *  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@ +  * utiles : %%@!!PAGE@%%  et %%@DATE@%%
  
-===== Nspages ===== +==== Nspages ==== 
-  * Liste les pages sous un namespace, plein d'options +  * **Liste les pages sous un namespace**, plein d'options 
-  * [[https://www.dokuwiki.org/plugin:nspages|doc]] +  * [[doku>plugin:nspages|doc]] 
-  * < nspages> dans une page+  * **%%<nspages>%%** dans une page
   * -exclude:nameOfPage   * -exclude:nameOfPage
   * -h1 : display h1 title of page   * -h1 : display h1 title of page
Line 58: Line 91:
   * exemple : %%<nspages -h1 -textPages="Staging projects:" -simpleList -exclude:start -sortByDate>%%   * exemple : %%<nspages -h1 -textPages="Staging projects:" -simpleList -exclude:start -sortByDate>%%
  
-===== Discussion ===== +==== Include Plugin ==== 
-  * permet une discussion dans la page +  * **inclut le contenu d'un page** à l'intérieur d'une autre 
-  * [[https://www.dokuwiki.org/plugin:discussion|doc]] +  * [[doku>plugin:include?s[]=include&s[]=plugin|doc]] 
-  * ~ ~DISCUSSION~ ~ +  * **%%{{namespace>project_foo}}%%** will include all pages in the project_foo namespace.  
-  * ~ ~ DISCUSSION:off~ ~ +  * **%%{{page>my_page}}%%** will include my_page 
-  * ~ ~ DISCUSSION:closed~ ~+  * **%%{{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 ==== +===== Doc des Plugins à installer =====
- +
-===== TableCalc ===== +
-  * faire de l'excell +
-  * [[https://www.dokuwiki.org/plugin:tablecalc|doc]] +
-  * | ~~=sum(range(0,0,col(),row()-1))~~ |+
  
-===== Include Plugin ===== +==== TableCalc ==== 
-  * [[https://www.dokuwiki.org/plugin:include?s[]=include&s[]=plugin|doc]] +  * faire de l'**excell** 
-  * {{namespace>project_foo}} will include all pages in the project_foo namespace.  +  * [[doku>plugin:tablecalc|doc]] 
-  {{page>my_page}} will include my_page+  * **| ~~=sum(range(0,0,col(),row()-1))~~ |**
  
-===== CSV ===== +==== CSV ==== 
-  * [[https://www.dokuwiki.org/plugin:csv|doc]]+  * [[doku>plugin:csv|doc]]
   * < csv> </csv>   * < csv> </csv>
  
-===== color syntax ===== +==== color syntax ==== 
-  * <color #00FFFF>colorise</color>  +  * %%<color #00FFFF>colorise</color>%%  
-  * [[https://www.dokuwiki.org/plugin:color|doc]] +  * [[doku>plugin:color|doc]] 
-  * < color #009999>colorise</color> +  * %%<color #009999>colorise</color>%%
wiki/start.1549899367.txt.gz · Last modified: 2023-02-02 22:06 (external edit)