Skip to content
Des instruments innovants pour produire et réutiliser des données de recherche en sciences humaines et sociales.
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
archetypes
assets
bin
content
data
i18n
layouts
resources/_gen/assets/scss
scripts/import
static
.gitignore
.nvmrc
.travis.yml
JOURNAL.md
LICENSE
README.md
config.toml
netlify.toml
package-lock.json
package.json
styleguide.md

README.md

DIME-SHS Build Status

✍️ Contribuer des contenus

Les contenus existent en deux langues : français (par défaut), anglais. Tous les fichiers qui finissent par .fr.xxx ou .en.xxx sont spécifiques à cette langue.

Options d'affichage

Le champ options d'un fichier Markdown contrôle des comportements d'affichage des contenus.

---
title: Quelque chose
options:
- toggable-headlines
---
Option À quoi ça sert ?
toggable-headlines Les titres ouvrent ou replient leur section correspondante.
toggable-headlines--closed Les sections cliquables sont fermées par défaut.
toc Une table des matières est construite à partir des titres de la page, et est affichée dans la colonne de gauche.

Traduction de l'interface

Les éléments d'interface sont traduits à deux endroits :

  • footer : clés [languages.*.menu.footer] dans le fichier config.toml.
  • tout le reste : répertoire ./i18n.

🛠 Développer en local

  • Générateur : Hugo@>=0.58.2 dans sa version dite Extended (elle prend en charge le langage Sass)
  • CSS : Tachyons (approche mobile-first et fonctionnelle)
  • JavaScript : vanilla (compilé en ECMAScript5 via babeljs.io REPL)

Installation

La gestion de version de Hugo est effectuée avec Node.js, afin d'avoir un outillage de développement unifié.

$ npm install

Prévisualiser en local

$ npm start

Le site est alors accessible sur http://localhost:1313.

Générer le site

$ npm run build -- --baseURL https://dime-shs.sciences-po.fr

Les fichiers sont générés dans le répertoire ./public.

Type Identifiant Utilité
Variable d'environnement MATOMO_SITE_ID Transmet l'identifiant de site Matomo, pour le suivi des visites.
Paramètre --baseURL http://example.com Site de destination.

📦 Scripts

Importer les publications depuis Spire et Zotero

$ npm run import

# Pour déployer les publications en prod
$ git add data/publications
$ git commit -m 'Mise à jour des publications'

La commande npm run import obtient les publications depuis une collection Spire et une collection Zotero. Les données obtenues sont normalisées et catégorisées en fichiers YAML dans le répertoire data/publications.

Configuration du fichier config.toml :

  • Types de publications importées (params.publicationsLabels).
  • Mapping des types de publications (params.publicationsMapping), sous la forme "ancienne catégorie" = "nouvelle catégorie".
  • Catégories (params.publications.*) : libellé, ordre et identifiants des sous-collections Zotero et Spire.

🤖 Automatisation

Travis CI

  • Quand des commits arrivent sur master, le site est…
    1. … généré avec l'URL https://dime-shs.sciencespo.fr.
    2. … est configué avec un siteId Piwik égal à 10.
    3. … déployé sur GitHub Pages (branche gh-pages).

Netlify

La configuration principale se fait depuis le tableau de bord Netlify. D'autres comportements sont paramétrés dans le fichier netflify.toml.

📖 JOURNAL.md

Ce qu'on a vécu ensemble, au jour le jour.

You can’t perform that action at this time.