Chantier Responsive Design

Cette page vise à aborder plus spécifiquement les problématiques et les avancées qui ont été réalisées dans le but de migrer la documentation vers un template responsive. C'est à dire, pour les lecteurs non familiers de ce mot, que l'on souhaite que la manière dont la doc s'affiche s'adapte automatiquement en fonction de la taille de l'écran du lecteur, qu'il s'agisse d'un écran d'ordinateur extra large ou d'un téléphone portable.

Ce chantier est un préalable obligé à la mise en place de certaines nouvelles fonctionnalités très demandées comme l'onglet discussion et le WYSIWYG.

L'équipe qui se charge de mener la réflexion et de procéder à la migration est composée de tous ceux qui voudront bien la rejoindre. Les supports à privilégier sont:

• la liste diffusion et le salon de discussion des contributeurs du wiki
• La mailing liste de coordination des sites de la communauté francophone
• Le forum section À propos du site - Contributions

Nous sommes peu nombreux, raisons pour laquelle ce sujet avance très lentement et nous manquons cruellement de personnes susceptibles de déployer la doc chez eux en local et de tester les différentes possibilités, donc quel que soit votre degré de compétence technique, si ce sujet vous intéresse, faites vous connaitre!

Changer de template, c'est une chose, mais il reste ensuite à définir quel est le but que l'on veut atteindre, déterminer quels sont les éléments actuellement présents que l'on souhaite absolument conserver et ceux qui sont dispensables, arrêter les choix de couleur, etc.

Les discussions qui ont eu lieu entre admins, en lien avec la coordination des sites ubuntu-fr, et avec les utilisateurs ont permis de dégager les critères suivants:

1. Pour la couleur dominante on veut rester sur le orange, couleur historique de la distribution, et sachant que Canonical ne nous autorisera pas à exploiter l'aubergine, qui reste dédié à ses supports de communication officiels
2. Afin de pouvoir intégrer facilement des plugins Dokuwiki, il faut s'éloigner le moins possible du design par défaut (par exemple le très demandé plugin discussion qui s'adapte mal à des templates fantaisistes)
3. Du fait de l'absence de d'administrateur qui maitrise bien le php et qui puisse assurer un suivit à long terme, il a été décidé de faire au plus simple possible
4. On souhaite pouvoir conserver d'une manière ou d'une autre les liens actuellement présents dans le menu de gauche
5. Suivre autant que possible les préconisations de la page Design 2011

Il y a déjà eu 5 propositions de futurs designs:

• Trois sont visibles ici: Définir la mise en page
• Deux sont visualisables via des démo en ligne: Cytheria et Yoboy

Avec l'équipe d'administrateur de la doc et au vu des critères énoncés précédemment, il a été décidé de partir sur la proposition de Yoboy, dont voici une capture d'écran:

Il s'agit d'une installation par défaut de Dokuwiki, avec le template bootstrap3 et le thème united. Il est déjà très proche de ce que l'on souhaiterai, moyennant de fignoler un petit peu les détails au niveau notamment du logo et de la feuille de style.

Pour faire avancer ce chantier, nous avons besoin: * de suggestions au niveau de la feuille de style, aussi mineures que possibles afin que ça rende mieux, par exemple le sommaire. * de personnes qui fassent des tests en local

Si vous n'y connaissez rien en CSS, vous pouvez bien évidemment nous décrire ce que vous avez en tête. Mais sinon le plus simple est que vous ouvriez la console développeur de votre navigateur (touche F12), et que vous meniez vos propres expériences. Vous pourrez ensuite nous communiquer vos capture d'écran et le code correspondant.

Ce paragraphe s'adresse à ceux qui voudraient nous aider en déployant une version de la documentation en local sur leur ordinateur. Le process global parait assez simple, il suffit pour commencer d'installer php et dokuwiki, puis suivant votre but:

1. Privilégier la version 5 de php.
2. récupérer le code ubuntu-fr-doc sur le repo git
3. (optionnel) décompresser le dossier data.tar.gz (demander un lien de téléchargement sur la liste)

En pratique c'est un peu plus compliqué que ça, mais des pages ont été créées pour s'y retrouver:

• Tutoriel général (et un peu vieux)
• Installation complète de la documentation ubuntu-fr en local

Dans ce cas le plus simple est de partir de la dernière version de dokuwiki et de voir comment le personnaliser pour correspondre à nos besoins