Guide de rédaction/Wiki IG

De EncyclopAtys

A l'attention des néophytes: Quand on a fini une page wiki, il est bon de réduire sa fenêtre et de recharger la page pour avoir une idée de ce qu'on voit avec une smartphone (important avec les images).

Vous savez peut-être aussi qu'une même page (un fichier texte en HTML
Code HTML des images en haut de page (sur ce site)
), sur le même PC, vue avec Chrome et Firefox ne s'affichera pas toujours de la même façon (navigateurs différents, qui interprètent différemment un même code en HTML et ses fichiers CSS les feuilles de style). Il arrive aussi que deux utilisateurs (tous 2 sous Firefox), ne voient pas la même chose [1].

Alors, on va tenter de distinguer ce sur quoi on peux avoir une action immédiate (coté wiki, coté CSS, mais aussi lors de la simple rédaction de pages), et ceux qui concernent le client Ryzom (et le retour des devs sur le sujet). Et, si c'est Ulukin qui s'y colle, on peux parler en fr.

J'y comprend rien à tes codes et tes styles... [2]

le wiki IG ?

En jeu, on peux surfer (sur le forum officiel IG), mais le navigateur du client Ryzom n'est ni Firefox ni Chrome, et il est très limité... Par ex si je colle dans le chat un lien vers https://fr.wiki.ryzom.com/wiki/Manuel_de_l%27utilisateur#Enchantement_des_armes le jeune va soit copier (coller dans navigateur), soit naviguer IG sur le wiki (et là ca ne marche pas, on verra pourquoi plus bas).

Naviguer depuis le chat
Il faut aussi savoir que la Lore qu'on voit en jeu, vient du wiki via une webapp - et elle est lisible en jeu. On pourrait s'inspirer de cette App pour filtrer les codes du wiki nuisibles à la lecture, pour afficher en jeu de l'aide. Ex: avec un clic droit sur un mob / infos -> la page du mob sur le wiki est affichée en jeu.

Dans un 1er temps, il nous faut faire la liste des soucis IG et les analyser (pour la création des nouvelle pages, on pourrait éviter certaines erreurs), puis contacter les devs:

  • pour voir ce qui provient de la skin et des CSS du wiki et
  • ce qui tient du navigateur inclus dans le client Ryzom
  • selon ce qu'ils nous proposent, on pourra commencer à réfléchir

Certains soucis sont des soucis d'affichages, d'autres de fonction (par ex la Table des Matières, dont les liens ne fonctionnent pas), parfois les 2 (le wiki a effet de calque superposé que le navigateur IG n'a pas: lié à la gestion des CSS du navigateur IG). Certains sont plus génants que d'autres: ne pas oublier, ni négliger le coté sécurité.

3 cas concrets pour illustrer:

  • pas vraiment génant [3], mais pédagogique (utile aux bureaucrates): un mot en italique sera affiché IG <NoExist italique>, un mot en gras sera affiché IG gras (pas d'erreur affichée).
  • Autre cas à voir, pour une toute autre raison celle-ci: le haut des pages du wiki. C'est à mon avis très gênant parce que IG on a l'impression que cela ne fonctionne pas (l’ascenseur à gauche étant peu visible, et aussi à cause du fond noir). Surtout 2 images posent soucis: atys.png de la skin et sun.png de la skin
  • Si l'utilisateur s'accroche (il a la patience de descendre 2 ou 3 écrans en hauteurs) il va voir que toute la page se s'affiche pas (cas de Enchantement_des_armes vu plus haut): les informations ne sont pas disponibles, donc plus grave. Mais, on a une alternative: on peux décider que cette page pourrait être découpée en 4 -> plus de problème. OK c'est génant, mais nous avons un mode d'action: déjà, y penser lors de la création de nouvelles pages + choisir les pages importantes à découper.

Idées à dev ?

Enfin et surtout, mais l'idée est à discuter, on pourrait penser à préparer des pages wiki d'aide (ou autre, par ex pour des event), disponibles depuis le client. Avantages (et qui sont aussi les plus gros désavantages !): plus facile d’accès pour les corrections et modifications, plus facile de traduire. Si on connait bien le client browser du client, ca pourrait etre une bonne idée.

petites liste des soucis en bref

que j'ai vu pour le moment

important:

  • soucis page longues : le manuel utilisateur ne se charge qu'à 1/3
Moins de 1/3 du User Manual visible IG
  • fond jaune (nos profils, bandeau attention) sont illisibles (on ne voit que les liens)
  • portails
    un portail vu IG
    inutilisables (par contre, on pourrait préparer des pages sur le wiki, spécialement pour le client, avec de l'aide. Plus facile à modifier et mettre à jour que via le client...
  • contenu trop bas car images et menus en haut

Ces sont surtout les 2 images du haut atys.png de la skin et sun.png de la skin

  • soucis des caractères accentués (dans les noms des pages et les titres h2 h3...) : surtout pour les catégories pour le coté wiki + liens insérés dans le forum vers les pages du wiki.

bien moins grave:

  • gras et italique (déja, ne plus utiliser italique dans nos textes ?)
  • La navigation TOC est KO, comme connexion et demander un mot de passe (tous en haut de page)
  • import fichier affiche IG tout en haut string(5) "home" (comme dans le wiki)

Analyse

CSS

  • CSS IG bad 2019-05-16.png
  • les encadrés jaunes par ex sont illisibles (ex: cette page est illisible IG), les bandeau de nav (voir en bas gauche de cette image)
  • portails illisibles

coté client (limitations)

Au dela de 16 Ko (images et texte compris), rien ne passe IG

  • soucis page longues : le manuel utilisateur ne se charge qu'à 1/3
    Moins de 1/3 du User Manual visible IG

16 Ko ca ne fait pas lourd...

  • TOC la navigation (via liens toc) KO: ca renvoie en haut de page (masquer la TOC IG ?)


  • soucis si italiques -> si ca pouvait etre comme le gras (ne marche pas, mais n'affiche pas d'erreur)...

Détails techniques

(le menu déroulant est dans une div qui porte l'ID=gumax-p-navigation)

Les images de fond qui posent soucis (font partie de la skin du wiki) sont atys.png de la skin sun.png de la skin

Retour des devs

Au dela de 16 Ko (images et texte compris), rien ne passe IG - dixit nimetu, sur pub-dev le 16 mai 2019 17h (Nimetu connais bien WebIG)

Convers' avec Ulu, 16 mai 17h30

  • le soucis de mediawiki c'est qu'il format tout avec plein de css
  • nimetu est le specialiste du webig. ptet qu'il peut faire sauter la limites des 16ko ?
  • pour moi le plus simple est de passer par un proxy de reformatage. c'est comme ça que marchait l'ancien wiki (il marche toujours d'ailleurs) IG avec l'app Lore. ça utilise le wiki de base mais avec un script qui nettoie. l'avantage c'est que tu conserve l'affichage d'origine
  • donc faudrait prendre la page la plus complexe du wiki. et déjà tester avec la meme moulinette

La lore affichée IG est une application webapps, qui utilise un proxy qui nettoie certains codes. On a donc le schémas de machines :
wiki (serveur et divers services) - proxy (travaille sur le code, retire des balises, code css...) - serveurs Atys, avec la webapps Lore qui affiche IG.


voir meme la lier aux mobs quand on fais infos 

Nimetu : ingame web intercepts tags as translatable strings.

Nimetu: Le navigateur du jeu peut afficher une page Web en résolution 16384x16384 (c'est-à-dire une seule image en résolution 16k, ou deux images en résolution 8k) ou 1000 lignes de texte en taille de police 15px. Sa taille n'est pas limitée en octets.

Si l'utilisateur (le bureaucrate sur le wiki) utilise une résolution de 1080px, cela représenterait 15 écrans d'information (IG). environ 1000 lignes de texte avec une taille de police de ~15px si c'est plus de 100 lignes, personne ne le lira.

Ingame browser can show web page that renders in 16384x16384 resolution (ie, single 16k resolution image, or two 8k resolution images) or 1000 lines of text in 15px font size. Its is not limited in byte size.

Notes


  1. Il arrive aussi que deux utilisateurs (tous 2 sous Firefox), ne voient pas la même chose: ils n'ont pas la même version de Firefox, pas les même extensions (ou plugins), ou encore, ils ont bien la meme version et les meme plugins mais avec des configurations différentes (menu Préférences dans Firefox, souvent à l'insu de leur plein grès mdr)... Bref, d'une façon générale avec le web, toujours essayer d'abord avec un autre navigateur...
  2. J'y comprend rien à tes codes et tes styles...
    1. Tout navigateur (Firefox, Chrome) envoi au serveur diverses informations, comme le système et la version du navigateur. Le serveur (le wiki, ryzom.com etc) lui renvoie la page demandée, qui est interprétée par le navigateur. Quand je change la taille de la fenetre de mon navigateur, mon navigateur fait le boulot, il ne redemande pas la page.
    2. La position d'une div (par ex le menu déroulant est dans une section qui commence par la baise <div> et se termine par </div>) est déterminée par un style (dans un fichier séparé, en .css). Souvent, quand on parle de Responsive design, il y a 3 versions pour afficher une meme page (c'est le travail des skins du wikimedia, du coté serveur wiki donc), selon la largeur d'écran. Avec un écran étroit, la barre de navigation est réduite à un petit symbole, certaines balises div (qui sont en haut pour un écran de PC) seront affichées en bas sur un smartphone.
  3. Le soucis des italiques IG: Bug certes très visible, mais pas très grave (on voit quand meme le mot, l'information est encore lisible)