Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/marcwrobel/marcwrobel.github.io

Sources du site Web https://www.marcwrobel.fr.
https://github.com/marcwrobel/marcwrobel.github.io

jekyll

Last synced: 2 months ago
JSON representation

Sources du site Web https://www.marcwrobel.fr.

Awesome Lists containing this project

README 

        
Sources du site Web [www.marcwrobel.fr](http://www.marcwrobel.fr/).



## Caractéristiques



Le site Web [www.marcwrobel.fr](http://www.marcwrobel.fr/) utilise le générateur de site statique

[Jekyll](https://jekyllrb.com) et est hébergé sur [GitHub Pages](https://pages.github.com/).



[www.marcwrobel.fr](http://www.marcwrobel.fr/) utilise aussi :



- [Bootstrap](https://getbootstrap.com/) pour la mise en forme,

- [Bootstrap Icons](https://icons.getbootstrap.com/) pour les icônes,

- [Simple-Jekyll-Search](https://github.com/christian-fei/Simple-Jekyll-Search) pour la fonctionnalité de recherche,

- [IntelliJ IDEA](https://www.jetbrains.com/idea/) pour le développement du site et la rédaction du contenu,

- et pour l'analyse et la recommandation de bonnes pratiques :

  - [PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights/?url=https%3A%2F%2Fwww.marcwrobel.fr)

  - [GiftOfSpeed](https://www.giftofspeed.com/)

  - [Accessibility Checker](https://www.accessibilitychecker.org/audit/?website=https%3A%2F%2Fwww.marcwrobel.fr%2F&flag=eu)

  - [Google Rich Results Test](https://search.google.com/test/rich-results?url=https%3A%2F%2Fwww.marcwrobel.fr%2F)

  - [Google Search Console](https://search.google.com/search-console?resource_id=sc-domain%3Amarcwrobel.fr)

  - [Bing Webmaster Tools](https://www.bing.com/webmasters/home?siteUrl=https://www.marcwrobel.fr/)



## Prérequis



Ce site utilise le générateur de site statique [Jekyll](https://jekyllrb.com). Pour l’installer, consultez

[la documentation officielle](https://jekyllrb.com/docs/installation/).



## Mise à jour du site



Lancez tout d’abord le serveur local :



```shell script

bin/serve

```



Apportez ensuite vos modifications et prévisualisez-les au fur et à mesure [dans votre

navigateur](http://localhost:4000/).



Commitez enfin vos modifications sur la branche `main`. Tout ce qui est commité sur cette branche est automatiquement

publié sur [www.marcwrobel.fr](http://www.marcwrobel.fr/).



## Mise à jour des dépendances



La mise à jour de l'ensemble des dépendances du site passe par le script `update-dependencies`. Pour l'utiliser,

exécuter :



```shell script

./bin/update-dependencies

```



Il ne reste alors plus qu’à tester que le site fonctionne bien puis commiter le tout, généralement en

séparant le type de mise à jour (Jekyll, Bootstrap...).



Quelques petites choses doivent de plus être connus en fonction du type de dépendances.



### Paquets Ruby



Les dépendances Ruby sont décrites dans le fichier [Gemfile](/Gemfile). Le script `update-dependencies` met à jour les

paquets en fonction de ce fichier.



La plupart des versions utilisées [dépendent de GitHub Pages](https://pages.github.com/versions/).



### CSS et JS



À cause de [problématiques liées à la

RGPD](https://www.jsdelivr.com/blog/how-the-german-courts-ruling-on-google-fonts-affects-jsdelivr-and-why-it-is-safe-to-use/)

les dépendances CSS et JS sont hébergées [dans le répertoire `assets`](/assets) et non sur un CDN. Le script

`update-dependencies` met à jour ces dépendances en fonction [d'informations renseignées dans le script

lui-même](/bin/update-dependencies).



Généralement toutes les mises à jour se font automatiquement, à l'exception des mises à jour pouvant nuire au bon

fonctionnement du site (Bootstrap). Ces mises à jour doivent être appliquées à la main en modifiant

[le script `update-dependencies`](/bin/update-dependencies).



### Ruby



La version de Ruby utilisée en production est [celle de GitHub Pages](https://pages.github.com/versions/). En

développement on utilisera la [version maintenue](https://www.ruby-lang.org/en/downloads/branches/) la plus proche.



### Suivi des mises à jour



Que ce soit en grande partie automatique (pour Jekyll, avec [Bundler](https://bundler.io/)) ou manuel (pour Bootstrap ou

Simple-Jekyll-Search) pour mettre à jour les dépendances utilisées par ce site il faut déjà que vous soyez au courant

que ces mises à jour existent. Pour cela plusieurs moyens :



- suivre les blogs des projets ([Jekyll](https://jekyllrb.com/news/),

  [Bootstrap et Boostrap Icons](https://blog.getbootstrap.com/)),

- suivre les pages [GitHub](https://github.com) des projets ([Jekyll](https://github.com/jekyll/jekyll),

  [Bootstrap](https://github.com/twbs/bootstrap), [Bootstrap](https://github.com/twbs/icons) et

  [Simple-Jekyll-Search](https://github.com/christian-fei/Simple-Jekyll-Search)),

- ou, plus simplement, utiliser [newreleases.io](https://newreleases.io)

  ([Jekyll](https://newreleases.io/gems/jekyll),

  [Bootstrap](https://newreleases.io/npm/bootstrap), [Bootstrap Icons](https://newreleases.io/npm/bootstrap-icons)

  et [Simple-Jekyll-Search](https://newreleases.io/npm/simple-jekyll-search)).



## Documentation utile



- [Jekyll](https://jekyllrb.com/docs/)

- [Bootstrap](https://getbootstrap.com/docs/)

- [Bootstrap Icons](https://icons.getbootstrap.com/)

- [Simple-Jekyll-Search](https://github.com/christian-fei/Simple-Jekyll-Search)



## License



Le contenu de ce site Web est, sauf indication contraire, sous licence [Creative Commons

Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)](LICENSE).