Amélioration du thème dokuwiki

zatalyz commented

2017-06-26 10:09:36 +00:00

(Migrated from port.numenaute.org)

Un premier travail a été fait pour la refonte du thème des wikis. Cependant, le travail est actuellement bloqué par les onglets, qui demandent du code php.

Est-ce que ce ne serait pas plus pertinent de gérer ça via un plugin, quitte à le faire exprès pour nos besoins ? Dans ce cas, voir soit ce qu'on a déjà dans notre code, soit https://www.dokuwiki.org/plugin:talkpage

Ce qui bloque est de toute façon cette partie des onglets. Le code actuel est vraiment trop crade pour être repris tel quel. C'est un hack d'un thème qui implémente les onglets, mais de façon très Frankeinstein, ce qui rend difficile de retrouver comment tout fonctionne et donc d'y modifier. Il y a un grand nombre d'appels inutiles qui viennent d'ailleurs de l'autre thème. La fonctionnalité devrait être décrite dans un fichier séparé. Le nombre d'onglets actif et leurs noms devrait être paramétrable.

Lors de la création de ce thème, notre fonctionnement était en test, si bien que l'onglet "discussion" est à la racine du site, quand les autres sont sous le namespace de langue. Tous les onglets devraient respecter le même standard, probablement "fr:onglet:cheminverslapage:page" (cheminverslapage copiant les namespace si besoin). Prendre en compte s'il n'y a pas d'onglet de langue, si quelqu'un veut réutiliser le thème sur un wiki non multilingue.

Ce serait bien de faire une branche pour le thème, avec le travail en cours. Mais de toute façon, il faut trouver quelqu'un qui a les compétences suivantes :

Maitrise du php
Lire la doc de Dokuwiki et parcourir le fonctionnement de Dokuwiki afin de respecter ses standards.

La partie CSS se gèrera plus facilement ensuite, même moi je peux arriver à quelque chose si les classes ne sont pas trop étranges :)

Un premier travail a été fait pour la refonte du thème des wikis. Cependant, le travail est actuellement bloqué par les onglets, qui demandent du code php. * Est-ce que ce ne serait pas plus pertinent de gérer ça via un plugin, quitte à le faire exprès pour nos besoins ? Dans ce cas, voir soit ce qu'on a déjà dans notre code, soit https://www.dokuwiki.org/plugin:talkpage Ce qui bloque est de toute façon cette partie des onglets. Le code actuel est vraiment trop crade pour être repris tel quel. C'est un hack d'un thème qui implémente les onglets, mais de façon très Frankeinstein, ce qui rend difficile de retrouver comment tout fonctionne et donc d'y modifier. Il y a un grand nombre d'appels inutiles qui viennent d'ailleurs de l'autre thème. La fonctionnalité devrait être décrite dans un fichier séparé. Le nombre d'onglets actif et leurs noms devrait être paramétrable. Lors de la création de ce thème, notre fonctionnement était en test, si bien que l'onglet "discussion" est à la racine du site, quand les autres sont sous le namespace de langue. Tous les onglets devraient respecter le même standard, probablement "fr:onglet:cheminverslapage:page" (cheminverslapage copiant les namespace si besoin). Prendre en compte s'il n'y a pas d'onglet de langue, si quelqu'un veut réutiliser le thème sur un wiki non multilingue. Ce serait bien de faire une branche pour le thème, avec le travail en cours. Mais de toute façon, il faut trouver quelqu'un qui a les compétences suivantes : * Maitrise du php * Lire la doc de Dokuwiki et parcourir le fonctionnement de Dokuwiki afin de respecter ses standards. La partie CSS se gèrera plus facilement ensuite, même moi je peux arriver à quelque chose si les classes ne sont pas trop étranges :)

zatalyz commented

2017-12-29 14:24:22 +00:00

(Migrated from port.numenaute.org)

moved from zatalyz/site_internet#21

zatalyz commented

2017-12-29 16:08:43 +00:00

(Migrated from port.numenaute.org)

added ~83 label

zatalyz commented

2017-12-29 16:09:13 +00:00

(Migrated from port.numenaute.org)

added ~84 label

zatalyz commented

2017-12-29 19:24:35 +00:00

(Migrated from port.numenaute.org)

Thème Dokuwiki

Notre thème a été créé il y a au moins trois ans, depuis Dokuwiki a bien évolué. Voir en particulier la doc https://www.dokuwiki.org/devel:templates

L'idée est donc de repartir du thème de base (thème "Dokuwiki", par défaut dans toute installation neuve d'un dokuwiki ). Ce thème est extrêmement bien conçu (responsive, ergonomique et accessible) et respecte tous les standards de Dokuwiki. Et il y a une bonne partie que nous n'avons pas besoin de modifier.

Comme j'aimerais, à terme, que nous puissions partager le thème, essayons de faire que ce soit modulable suivant les plugins activés.

Pour le reste, il s'agit de revenir à ce que présente le thème actuel :
Le logo doit être pensé en bannière (100% de la largeur de l'élément dokuwiki__site).
Ce qui est dans dokuwiki__sitetools est réarrangé autrement :
"recent changes", "media" et "index" vont dans une boite, en haut à gauche
La barre de recherche s'intègre dans la barre du breadcrumb, à droite
Sous la barre de recherche, il faut intégrer la détection de si le plugin "translation" est actif ou non et si oui, intégrer le code permettant d'afficher les traductions. Attention, le plugin translation propose plusieurs options de mise en page (drapeau, liste déroulante, etc) qui peuvent bien modifier l'aspect.
Les éléments "login" et quand on est co "user" (ce qui est dans usertool en principe) sont en haut à droite au dessus de la bannière.

À propos de la partie user : l'ancien thème est antérieur à Ponder Stibbons. Depuis, dokuwiki a ajouté showuseras . Cela permet d'afficher proprement le nom ainsi qu'un lien vers sa page perso (j'ai pas retrouvé le lien, mais j'ai souvenir d'avoir vu passer un truc sur ça).

J'aimerais aussi modifier la façon dont le Toc s'affiche, en reprenant ce que propose le plugin (chercher le nom).

Au niveau des articles, les titres sont précédés automatiquement d'une notation ( 1, 1.1, 1.1.1, etc). Mais seulement dans les articles...

Au niveau de la sidebar... Yannk avait réussi, à un moment, à faire une sidebar avec des menus en accordéon, similaire à https://www.dokuwiki.org/plugin:acmenu (sauf que ce plugin manque de paramétrages), mais le jquery de la barre de nav avait obligé à le désactiver. Un menu en accordéon serait pas mal pour l'um1... mais c'est une feature secondaire, qu'on peut obtenir sans le thème.

Le dernier morceau et non des moindres concerne les onglets. Comme indiqué avant, il est possible d'envisager un plugin plutôt que de le mettre dans le thème.

Le visuel est similaire à l'élément PageId (qui doit rester) ; les onglets sont sur la gauche de l'article tandis que l'id de la page est à droite.

Je joins le travail préliminaire de Daeldir tabs.php, qui a bien résumé ce à quoi il faut tendre...

Thème Dokuwiki Notre thème a été créé il y a au moins trois ans, depuis Dokuwiki a bien évolué. Voir en particulier la doc https://www.dokuwiki.org/devel:templates L'idée est donc de repartir du thème de base ([thème "Dokuwiki"](https://www.dokuwiki.org/template:dokuwiki), par défaut dans toute installation neuve d'un dokuwiki ). Ce thème est extrêmement bien conçu (responsive, ergonomique et accessible) et respecte tous les standards de Dokuwiki. Et il y a une bonne partie que nous n'avons pas besoin de modifier. Comme j'aimerais, à terme, que nous puissions partager le thème, essayons de faire que ce soit modulable suivant les plugins activés. Pour le reste, il s'agit de revenir à ce que présente le thème actuel : Le logo doit être pensé en bannière (100% de la largeur de l'élément `dokuwiki__site`). Ce qui est dans `dokuwiki__sitetools` est réarrangé autrement : "recent changes", "media" et "index" vont dans une boite, en haut à gauche La barre de recherche s'intègre dans la barre du breadcrumb, à droite Sous la barre de recherche, il faut intégrer la détection de si le plugin "translation" est actif ou non et si oui, intégrer le code permettant d'afficher les traductions. Attention, le plugin translation propose plusieurs options de mise en page (drapeau, liste déroulante, etc) qui peuvent bien modifier l'aspect. Les éléments "login" et quand on est co "user" (ce qui est dans usertool en principe) sont en haut à droite au dessus de la bannière. À propos de la partie user : l'ancien thème est antérieur à Ponder Stibbons. Depuis, dokuwiki a ajouté [showuseras](https://www.dokuwiki.org/config:showuseras) . Cela permet d'afficher proprement le nom ainsi qu'un lien vers sa page perso (j'ai pas retrouvé le lien, mais j'ai souvenir d'avoir vu passer un truc sur ça). J'aimerais aussi modifier la façon dont le Toc s'affiche, en reprenant ce que propose le plugin (chercher le nom). Au niveau des articles, les titres sont précédés automatiquement d'une notation ( 1, 1.1, 1.1.1, etc). Mais seulement dans les articles... Au niveau de la sidebar... Yannk avait réussi, à un moment, à faire une sidebar avec des menus en accordéon, similaire à https://www.dokuwiki.org/plugin:acmenu (sauf que ce plugin manque de paramétrages), mais le jquery de la barre de nav avait obligé à le désactiver. Un menu en accordéon serait pas mal pour l'um1... mais c'est une feature secondaire, qu'on peut obtenir sans le thème. Le dernier morceau et non des moindres concerne les onglets. Comme indiqué avant, il est possible d'envisager un plugin plutôt que de le mettre dans le thème. Le visuel est similaire à l'élément `PageId` (qui doit rester) ; les onglets sont sur la gauche de l'article tandis que l'id de la page est à droite. Je joins le travail préliminaire de Daeldir [tabs.php](/uploads/128d1117af51d0512ffe6708676484b4/tabs.php), qui a bien résumé ce à quoi il faut tendre...

Amélioration du thème dokuwiki #8