Framasoft uses GitLab for the development of its free softwares. Our Github repositories are only mirrors. If you want to work with us, fork us on framagit.org. (no registration needed, you can sign in with your Github account)
Framasoft utilise GitLab pour le développement de ses logiciels libres. Nos dépôts Github ne sont que des miroirs. Si vous souhaitez travailler avec nous, forkez-nous sur framagit.org. (l'inscription n'est pas nécessaire, vous pouvez vous connecter avec votre compte Github)
Barre de navigation commune aux sites du réseau
- Pied de page
- Modale de don
- Modale d’info
- Bandeau d’info
- Inscription à la newsletter en optin
- CSS custom
- Scripts custom
- Héberger la nav
cd /var/www/framasoft.org/
git clone https://framagit.org/framasoft/framanav.git nav
-
Configurer le serveur pour autoriser les requête Cross-domain
-
Ajouter le script
nav.js
à la fin du<body>
du site :
<script src="https://framasoft.org/nav/nav.js"></script>
Dans certain cas, le CMS utilisé compresse à la volée le javascript, il faut alors utiliser ce code là :
<script>
const s = document.createElement('script');
s.src="https://framasoft.org/nav/nav.js";
document.getElementsByTagName('head')[0].appendChild(script);
</script>
Par défaut, chaque composant (bandeau, modale, etc) de la nav contient
une methode siteConfig()
avec les paramètres requis pour un affichage
contextualisé en fonction du site (dans le switch … case
).
Il est également possible de passer la configuration des composants directement
dans la page où se trouve la nav (exemple dans app/assets/test/verbose.html
).
Cette config sera prioritaire.
De même, lorsqu’on modifie le cœur de la nav, une série de pages d’exemple dans
le dossier test
permettent de vérifier grossièrement que rien ne sera cassé.
Il est fortement recommandé d’utiliser l’extension VueJS devtools pour facilement voir l’état des variables de chaque composant.