Skin Foreground

De xtof lifedesign

Un projet de rhabiller (skin) ce site mediawiki - https://foreground.wikiproject.net/wiki/Main_Page

Statut
Installation en septembre 2020 de la version https://github.com/jthingelstad/foreground - réglages en cours.

Params via LocalSettings 

fait le 2020-271 à raffiner

//Param skin foreground

$wgForegroundFeatures = array(

 'showActionsForAnon' => true, //displays page actions for non-logged-in visitors.
 'NavWrapperType' => 'divonly', // only a div with id navwrapper will be created. '0' - no div will be created (old behavior), other values will be used as class.
 'showHelpUnderTools' => true, // a Link to "Help" will be created under "Tools".
 'showRecentChangesUnderTools' => true,
 'enableTabs' => false,
 'wikiName' => &$GLOBALS['wgSitename'],
 'navbarIcon' => true, //affichage du logo
 'IeEdgeCode' => 1,
 'showFooterIcons' => false, //suppresses the output of footer icons.
 'addThisPUBID' => , //empty string will not fire the AddThis script, 'ra-##-#######' publisher ID will allow the run the AddThis script in async on content pages only.
 'useAddThisShare' => ,
 'useAddThisFollow' => 

);


Docs à l'étude

Usage de NavWrapperType

Avec un réglage du comme :

   'NavWrapperType' => 'divonly'

et la div créée appelée `navwrapper`, les visiteurs anonymes peuvent modifier le réglage de la navbar (fixe ou collante) par User-Script (Firefox-extensions comme greasemonkey or scriptish), les utilisateurs peuvent prendre un gadget ou leur JavaScript, CSS ... :

   $('#navwrapper').addClass('sticky');


Ou vous pouvrez régler la classe dans LocalSettings.php avec :

   'NavWrapperType' => 'contain-to-grid fixed'

et les visiteurs pourront retirer cette classe par leur propre JavaScript ou gadget ...

Icône Navbar

Avec un réglage comme :

   'navbarIcon' => true

Une icône en haut de la navbar sera placée utilisant l'image en cours réglée par `$wgLogo` dans `LocalSettings.php`. Regarder https://www.mediawiki.org/wiki/Manual:$wgLogo pour plus d'informations sur `$wgLogo`.

L'icône sera retaillée pour tenir dans une H/l de 64px x 36px ou un ratio de 16:9.

Voir l'aide sous les Outils

This will add the help link under tools. To control what the help link will link to use the message page, `MediaWiki:Helppage` to set the link target. The link target can be a local page, Help:Contents, or an external URL, https://www.mediawiki.org/wiki/Help:Contents.

Boutons AddThis

With a setting like:

   'addThisFollowPUBID' => 'yourAddThis-PubID'

Important, this feature uses the free or paid version of the https://addthis.com horizontal Follow Buttons only. Choose which social media FollowUs buttons(Twitter, Facebook, YouTube, etc.) and at the bottom of the screen locate the script. Within the script you will see something similar `...#pubid=ra-5378f4902d02197">`. Everything after the `=` sign and up to the `">` is your Publisher ID. To turn on social follow icons, insert your publisher id:

   'addThisFollowPUBID' => 'ra-5378f4902d02197'

Notes sur les autres skins

Lorsque vous construisez un wiki avec Foreground, vous utiliserez probablement la grille responsive de Foundation. C'est la clé pour créer un wiki responsive, et c'est l'une des plus grandes exigences de _migration_ lorsque vous souhaitez déplacer un wiki qui utilisait auparavant Vector (et probablement beaucoup de tableaux pour la mise en page) pour la skin Foreground. Une fois que vous faites cela, la possibilité pour un utilisateur de sélectionner n'importe quel skin sera supprimée. Si vous tirez pleinement parti de Foreground dans vos modèles, l'absence de grille Foundation rendra la visualisation du wiki très difficile en utilisant Vector ou Monobook

Pour cette raison, il est suggéré de définir la variable `$wgSkipSkins` pour vous assurer que tout le monde voit le site comme vous l'avez prévu. Cela supprime les autres skins des options sélectionnables par l'utilisateur.

   # Foreground est spécifique, aussi désactivons les autres skins
   $wgSkipSkins = array( 'cologneblue', 'modern', 'monobook', 'vector' );

Vous pourriez aussi vouloir permettre aux utilisateurs de régler une CSS utilisateur s'ils veulent bricoler des trucs à l'intérieur de Foreground. C'est complètement facultatif.

   # Allow User CSS, mostly for skin testing
   $wgAllowUserCss = true;

Utiliser Foreground

Il y a une [liste de discussion pour discuter de Foreground](https://lists.wikimedia.org/mailman/listinfo/foreground). Please join to connect with others and explore questions about using Foreground on your wiki. You can see a list of wikis with [Foreground installed at WikiApiary](https://wikiapiary.com/wiki/Skin:Foreground).