Template talk:FR/NavWikiGuide

From Apache OpenOffice Wiki
Revision as of 13:40, 22 May 2009 by Synanceia (Pierre) (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

[Résolu] Bogue : les liens 'page suivante' et 'page précédente' HS

Synanceia (Pierre) 13:40, 22 May 2009 (UTC) : Discussion close - section supprimée

Adapter le modèle à la gestion de plusieurs chapitres

Je pense qu'il est tout à fait possible d'adapter ce modèle et ses sous-pages pour qu'il puisse gérer différentes parties (chapitres).

Le modèle a été adapté pour permettre d'afficher soit le sommaire principal, soit le sommaire du chapitre. Pour ce faire, un paramètre optionnel a été ajouté à ce modèle : 'main' (pour le sommaire principal) ; 'part' (pour le sommaire lié au chapitre).

Je ne sais pas bien où placer ce commentaire, donc je le mets ici :) Un modèle mastertoc peut comporter un sous modèle dédié à table des matières du
chapitre en question, ce qui évite d'avoir à reporter les sous chapitres sur toutes les pages. Je ne l'ai pas fait pour le guide Writer
par flemme, mais c'est plus rapide. Voir par exemple Template:Documentation/MasterTOC et Template:Documentation/WG3TocsTOC.
Sophie
C'est un compromis très intéressant : un modèle est défini par chapitre, ce qui évite de retoucher les x pages du chapitre pour renommer un titre.
Merci d'avoir attiré notre attention sur cette possibilité.
Synanceia (Pierre) 13:23, 22 May 2009 (UTC)

Voici ce que je propose :

PageNum
Ce modèle donne le numéro de la page actuelle, les pages doivent être numérotées selon la règle suivante
  • 0 : page d'introduction au guide
  • 100 : page d'introduction du chapitre 1
  • 101 à 1xx : page n°xx du chapitre 1
  • y00 : page d'introduction du chapitre y
  • y01 à yxx : page n°xx du chapitre y
  • -999 : code erreur, page inconnue
PageName
Modèle réciproque, il donne le nom de la page en fonction du numéro, si la page n'est pas connu le texte none est redonné à la place.
  • Dans le cas du sommaire secondaire et de la 1re page du chapitre, pour que le champ 'page précédente' soit affiché il faut également attribué le numéro y99 à la dernière page du chapitre y.
NextPage
Pour ne pas multiplier les modèles, ce modèle reçoit un paramètre
  • part : le modèle donne le numéro de la page d'introduction du chapitre suivant
  • page : le modèle donne le numéro de la page suivante, si la page n'est pas reconnue (-99 donné par PageNum) il donne le numéro de la page d'introduction du chapitre suivant (...qui peut ne pas être reconnu, aucune vérification ne sera nécessaire. Le lien ne sera pas afficher si tel est le cas).
PrevPage
Fonctionnement similaire à NextPage
  • part : le modèle donne le numéro de la page d'introduction du chapitre précédent
  • page : le modèle donne le numéro de la page précédente. La page peut ne pas exister. Dans ce cas, le lien ne sera pas afficher.

;Content:Nouveau modèle qui permettra de définir la variable toccontent en fonction du numéro de page

@Dominique : Il me faut encore y réfléchir... je ne suis pas sûr d'avoir pensé à tout !
Je ferai ces modifications et les testerai dès que tu auras créé les pages d'intro des chapitres 2 et 3 et quelques pages du chapitre 2.

Synanceia (Pierre) 16:45, 16 May 2009 (UTC)

NavWikiGuide ou MasterTOC ?

(Petit débat sur le pour et le contre de l'un et de l'autre - - Dominique Pautrel 16:59, 14 May 2009 (UTC))

  • @Pierre : Sache avant tout que je suis épaté par ce que tu as réussi à faire là.
  • Sache également, qu'en tant que "débutant" moi-même du code Wiki, je me faisais déjà une joie d'utiliser (pour maîtriser moi aussi la construction d'autres modèles avec paramètres) juste / seulement ce modéle MasterTOC.
    • Je comptais d'ailleurs expliquer son utilisation (par un exemple supplémentaire à celui inclus dans le modèle lui-même), dans le chapitre Modèle, en invitant le lecteur à cliquer sur Modifier pour vérifier le fonctionnement de l'appel au modèle.
    • J'ai l'envie d'écrire le début de ce guide ainsi maintenant, car en admettant que j'en vienne à maîtriser un jour ± toutes les subtilités de MediaWiki, ce ne sera sans doute plus le meilleur moment pour faire des pages s'adressant aux débutants...
  • Je t'avouerais que la présence soudaine de ce(s) modèle(s) a tendance à me déconcerter pour l'instant car j'appréhendais assez bien le fait d'insérer un groupe de pages n'importe où (en éditant la première et la dernière page du groupe, et leurs deux nouvelles voisines, puis les deux anciennes limites à recoller ensemble. 6 pages et pas trop fastidieux), et là, si il faut seulement éditer PageName et PageNum, mais que le document fait 131 pages et qu'on insère une nouvelle page en... deuxième position (par ex. Table des matières entièrement développée), au lieu d'une douzaine de lignes a éditer en tout dans 3 pages, il faudrait si j'ai bien compris éditer 2 X 130 = 260 lignes sur deux pages. Il faudrait alors donner en plus un script a exécuter (pour un éditeur de texte tel notepad++ et kwrite ???), ou je ne vois pas le gain de temps pour un guide (pour moi, moins de trente pages environ = How-To ou mini-guide ou tutoriel, au delà on passe dans les guides ou manuels... Peut-être serait-ce plus adapté à un tuto ?)
    • Ou alors réunir le tout dans Template:FR/NavWikiGuide/InsertPage ? Dans l'exemple ci-dessus un simple {{FR/NavWikiGuide/InsertPage|2}} aurait raison du problème... il devrait pouvoir gérer une nouvelle page ou une page existante... Mais je n'imagine pas son contenu, je ne sais même pas si c'est possible... Il devrait écrire dans PageName et PageNum... Pas du tout un WikiBot, mais une vrai macro Wiki. M'égarais-je ?
  • Il est encore possible dans mon esprit que ce guide puisse s'allonger (sur quelques mois) jusqu'à atteindre une centaine de pages, car le résultat d'une simple requête peut déjà remplir une longue page (ceci constituera les sous-pages du chapitre Structure Existante, que je prévois à l'adresse FR/Wiki/Structure/etc.)
  • En revanche, mais c'est à vérifier, ce principe pourrait être pratique dans le cas des liens interwikis, ou les noms de pages sont quelquefois traduits pour être facilement retrouvés par n'importe quel moteur de recherche - Tout le monde n'a pas accès à Google ! Sophie me l'a confirmé en évoquant l'Afrique de l'Ouest, francophone, quand je lui ai demandé pourquoi elle traduisait les noms des pages du guide Writer (terminé il y aura 293 pages), ce qui empêchait l'utilisation d'un modèle interwiki (qui ne fait actuellement qu'intercaler trois caractères /FR, /DE, /Zh, etc. dans l'adresse, et qui permet quand même d'une façon pratique de lier les pages de toutes les versions d'un coup).
  • Avec un système tel le présent modèle, et partant d'un guide existant, avec une clé de 5 caractères :
    • Car. 1&2 : Code international > DE, EN, FR, ...
    • Car. 3 à 5 : de 000 à 999 pour 1 000 pages maxi pour un guide... Comme une version existe déjà on peut découper l'index de façon à laisser un trou de 20 à 30, entre chaque de façon à insérer des pages plus facilement, en n'ayant à renuméroter que les pages du chapitre en cours
  • Il y a sûrement plus à dire... intéressant, mais au bout du compte comment la gestion d'un guide sera-t-elle la plus simple ?
  • Sache pour conclure que si ces modèles doivent améliorer encore (par rapport à MasterTOC) l'ergonomie d'une TDM je serais très content de les utiliser !
  • Je ne sais pas comment aider autrement aujourd'hui pour cette série de Templates. J'espère être constructif...
  • PS : N'y vois pas une guerre d'édition mais j'aimerais revenir pour l'instant (seulement pour les chapitres) - à partir de Catégorie(s), à MasterTOC car cette vue (ce survol) est pour moi une méthode basique mais efficace de mieux concrétiser ce projet, à savoir entrer progressivement dans les détails sans perdre la vue d'ensemble. Mets en place les lignes afférentes aux"Partie", et, quand le fonctionnement te plaira, n'hésites pas à remplacer... sur un chapitre d'abord, ce qui permettra de comparer.
  • Merci de ton / votre attention, cOOordialement ^^ Dominique Pautrel 16:59, 14 May 2009 (UTC)
  • Ajoutez un commentaire sur les avantages, opportunités de l'un ou de l'autre...


En effet, je n'avais pas mesurer toutes les difficultés engendrées par mon idée... Pour te permettre de travailler "normalement", je suis en train de rétablir les sommaires que tu avais créé. Toutefois, je souhaite sur ces pages faire cohabiter le modèle que j'ai mis en place. Même si nous abandonnons celui-ci, j'ai bien envie de persister pour apprendre...
Vois-tu un inconvénient à faire cohabiter les 2 sommaires ? -- Synanceia (Pierre) 05:55, 15 May 2009 (UTC)
Non non aucun, bien au contraire, ça permet toutes les possibilités pour chacun de nous deux. Tu as bien raison d'avoir envie de persister ;-) Dominique Pautrel 17:16, 15 May 2009 (UTC)
Le modèle me semble être au point...
En fait, pour ajouter une page au début d'un chapitre qui en comporte une dizaine, il faut
  • ajouter une ligne à PageNum
  • ajouter deux lignes à PageName
  • renuméroter 10 lignes dans PageNum
  • renuméroter 20 lignes dans PageNum
Je ne pense pas que cela soit plus fastidieux que de reprendre la dizaine de page du chapitre pour y mettre à jour le sommaire.
Par contre pour ajouter un chapitre, il faut renuméroter toutes les lignes !!!
Synanceia (Pierre) 16:54, 16 May 2009 (UTC)
Chapeau !
Pour insérer une page dans un chapitre qui en comporte "n", il faut, avec MasterTOC :
  1. copier l'appel au modèle entier entre accolades, d'une page du même chapitre.
  2. coller dans la nouvelle page, et lui ajouter sa ligne dans toccontent
  3. copier maintenant les "n+1" lignes de toccontent
  4. éditer un paramètre (NextPage) dans la page précédente, et un autre (PrevPage) dans la page suivante.
  5. remplacer les "n" lignes de toccontent par les "n+1" du presse-papier pour "n-2" pages.
Un peu fastidieux si le chapitre est long mais très vite mécanique et relativement simple et rapide.
Pour ajouter un chapitre c'est encore plus simple car les chapitres eux-mêmes (et toutes leurs sous-pages) ne seront pas modifiés... Si je dois en rajouter un maintenant, je ne toucherais ni à Catégories, ni à Modèles. Juste à renseigner PrevPart et NextPart dans les pages "suivante" et "précédente".
Je ne sais pas quel est le plus simple et rapide à utiliser, il faudrait que j'essaie pour les prochaines pages...
J'espère donc avoir bien imaginé le "plan" (de toute façon !) L'avenir me / nous le dira...
Ce que j'imaginerais pour améliorer / différencier consisterait à se passer de / copier le contenu de MasterTOC, (de façon à ne pas modifier ce modèle usité) afin de pouvoir en changer l'apparence (image, couleur de fond...) ^^ Dominique Pautrel 19:29, 16 May 2009 (UTC)
Personal tools