Git Product home page Git Product logo

jamstatic-fr's Introduction

Vous utilisez Jekyll, Hugo, Eleventy ou tout autre générateur de site statique ?
Vous voulez échanger avec la communauté francophone et vous tenir informé de l'actualité de l'écosystème de la Jamstack ?

Vous pouvez :

Netlify Status

Contribuer

Contributeurs

Le site est généré avec Cecil.

  1. Télécharger Cecil
curl -LO https://cecil.app/cecil.phar
  1. Clôner le dépôt Git
git clone https://github.com/jamstatic/jamstatic-fr.git
  1. Créer un nouvel article (dans une branche dédiée)
git switch --create post/nouvel-article
php cecil.phar new:page post/nouvel-article.md
  1. Prévisualiser le site web
php cecil.phar serve -d -v --config=config/dev.yml
  1. Envoyer l’article
git commit -am "Nouvel article"
  1. Soumettre une PR (Pull Request)
gh pr create

Développement

Regénérer la feuille de styles avec Tailwind CSS

npm install
npx tailwindcss -i ./tailwind.css -o ./assets/css/styles.css

Production

Chaque commit dans la branche master génère une nouvelle version du site qui, s'il n'y a pas d'erreur, est automatiquement déployée.

Si vous souhaitez contribuer, proposer des articles, vous pouvez ouvrir une issue ou soumettre directement une pull request ❤️

Contributeurs

Merci à ces personnes extraordinaires (emoji key) :

Frank Taillandier
Frank Taillandier

💵 🔊 📝 💻 🎨 🚇 🚧 📋 🌍 📢 📹
Arnaud Ligny
Arnaud Ligny

️️️️♿️ 💬 🔊 📝 🐛 💻 🖋 🔣 🎨 📖 🤔 🚇 🚧 🧑‍🏫 📆 👀 📢 🌍
Nicolas Goutay
Nicolas Goutay

💵 🔊 🌍 📝 📋 📢 📹
Regis Philibert
Regis Philibert

🔊 📝 👀 💻
Boris Schapira
Boris Schapira

💵 👀 📝
Nicolas Hoizey
Nicolas Hoizey

💵 👀 📝
Patrick Faramaz
Patrick Faramaz

💵 🔊 💻 📝
Jérôme Coupé
Jérôme Coupé

📝 👀
Pierre Burgy
Pierre Burgy

📝
jygastaud
jygastaud

🔌 👀
antoine
antoine

📝 👀
Bertrand Keller
Bertrand Keller

📝 💻
Nathalie Rosenberg
Nathalie Rosenberg

👀
Agnès Haasser
Agnès Haasser

👀
P45QU10U
P45QU10U

👀
Samuel Martin
Samuel Martin

👀
Victor Massé
Victor Massé

👀
Christophe Ducamp
Christophe Ducamp

👀
Corinne Durrmeyer
Corinne Durrmeyer

👀
Laurent de Lacerda
Laurent de Lacerda

👀
Uxlco
Uxlco

👀
yvesdo
yvesdo

👀
Yannick A.
Yannick A.

👀
Hugo Torzuoli
Hugo Torzuoli

👀
Yaacov
Yaacov

💵 ️️️️♿️
Enguerran
Enguerran

📖

Ce projet suit la specification all-contributors.
Toutes les contributions sont les bienvenues !

jamstatic-fr's People

Contributors

allcontributors[bot] avatar anthonylpdev avatar antoinentl avatar arnaudligny avatar bertrandkeller avatar borisschapira avatar christopheducamp avatar dependabot-preview[bot] avatar dependabot-support avatar dependabot[bot] avatar dependencies[bot] avatar dirtyf avatar enguerran avatar hzooly avatar imgbot[bot] avatar inseo avatar inwardmovement avatar ipatate avatar jeromecoupe avatar jonathanulco avatar jygastaud avatar laurent-d avatar martinsam avatar nhoizey avatar p45qu10u avatar parkr avatar phacks avatar pierreburgy avatar tut-tuuut avatar yaaax avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

jamstatic-fr's Issues

Intégrer la recherche

  • Intégrer Docsearch d'Algolia
  • Modifier la config pour remplacer Documentation par Articles
  • Personnaliser l'apparence des résultats

Déploiement avec le CLI de Now

Install Now CLI

npm i -g now to install 

Deploy

# First time you need to auth
now login

# Test deploy
now

# Deploy to production
now --prod

Warnings:

❗️  Zero-configuration deployments are recommended instead of a `builds` property in `now.json`. The "Build and Development Settings" in your Project will not apply.

Proposition de traduction : Gatsby pour les applications Web

Proposition de traduction : “Gatsby for Apps”, publié par Dustin Schau (dev chez Gatsby) en novembre dernier sur le blog de Gatsby.

Le post explique comment Gatsby peut aller plus loin que les sites “purement” statiques et permet de créer des “applis Web”, en prenant pour exemple un clone de Gmail recodé en Gatsby.

Je trouve l'article très intéressant, et c'est une problématique qui m'intéresse beaucoup. En effet, ça permet de faire un pont entre deux domaines qui ont jusqu'ici été assez cloisonnés (enfin de ce que j'en sait).

Qu'en pensez-vous ?

Update Content Security Policies

font-src:

default-src:

  • disquscdn.com (comments could be removed)

img-src:

  • *.imgix.net
  • *.cloudfront.net
  • *.githubusercontent.com (GitHub avatars)
  • google-analytics.com (Analytics)

(to be completed with further reports)

Dependencies.io troubleshooting

We're opening this issue to inform you about problems with your dependencies.io configuration or build failures.

We'll add a comment here when we see problems. You can close this issue when
you have things resolved -- we'll open it back up if we detect new problems.

Helpful links:

Note: To help keep your repo as clean as possible, this is the only issue
that we're going to open and comment on. Feel free to delete the comments
that are made as you resolve them, if you want to keep this issue short and tidy.

Rédiger, éditer et publier des contenus en Markdown

  1. Présenter les avantages du format pour la rédaction et les usages
  2. Montrer l'omniprésence du Markdown dans différents contextes
  3. Makrdown dans le contexte des workflows de publication modernes

Rédiger en Markdown

Clients lourds:

Services en ligne

  • GitHub, GitLab, BitBucket (documentation logicielle)
  • Wordpress.com (JetPack) (blog)
  • StackEdit
  • Dillinger
  • Papers (Dropbox) (Notes de Réunion)
  • GitBook

Headless CMS

Le langage de templating d'Hugo

Proposition: exemples idiomatiques qui permettent d'apprécier la puissance et la concision du langage de templating d'Hugo:

  • travailler avec les sections de contenus ?
  • avec le frontmatter ?
  • avec les fichiers de données ?

Comparatif des offres d'hébergements

Afin de pouvoir un peu mieux s'y retrouver dans toutes les offres existantes:

Fonctionnalités

  • Synchronisation avec GitHub/GitLab/autre
  • CMS
  • Optimisation des assets
  • Déploiemnt sur CDN
  • Support de HTTPS
  • Support de HTTP2
  • Webhooks

Prestataires

  • GitHub
  • GitLab
  • Netlify
  • CloudCannon
  • Surge.sh
  • BowTie
  • Amazon S3
  • Heroku

https://www.thenewdynamic.org/tools/hosting-deployment/

Mise à jour : J'ai crée un Google Docs public à compléter : https://docs.google.com/spreadsheets/d/1FuiC29pnWsRemqvQh3UcHAZSkz_3p-pq-5-6m5ZHdzU/edit#gid=0

/cc @borisschapira

Entretien avec les créateurs d'Antora

Voici une proposition de billet : un entretien avec les créateurs d'Antora, "A static site generator for making documentation sites from one or more versioned content repositories", un projet basé sur AsciiDoc et Asciidoctor qui est en train d'arriver !

Je me charge de contacter les créateurs, de préparer les questions, j'aurais probablement besoin d'un coup de main pour valider les questions en anglais (coucou @DirtyF), et ensuite pour relire mes traductions de l'anglais au français.

(Bonus : une publication sur The New Dynamic pour la version anglaise).

Migrer le site vers Hugo

  • Import des articles
    • permalinks + renommer les fichiers des posts
    • Twitter cards: image-> images in Front Matter
    • utilisation du shortcode par défaut {{< figure >}}
    • utilisation du shortcode par défaut {{< youtube >}}
    • post_url, link -> relref
    • source des articles dans le front matter
    • classes Markdown -> shortcodes (notices)
    • équivalent de canonical_url dans le front matter ?
  • migration du thème
    • afficher l'auteur du post
    • lien vers l'article d'origine
    • coloration syntaxique des snippets de code ?
    • internal template pour Analytics
    • internal template pour Disqus ?
    • humans.txt, contributeurs GitHub
    • .RSSLink in footer partial
  • Mise à jour de la configuration sur Netlify (hugo)

Question sur le chargement selon condition d'un template

Accès à la page concernée

{{ $f1path := (print "shoefeatures/" $.Params.feature1 ".html") }}
{{ partial $f1path}}
{{ $f2path := (print "shoefeatures/" $.Params.feature2 ".html") }}
{{ partial $f2path}}
{{ $f3path := (print "shoefeatures/" $.Params.feature3 ".html") }}
{{ partial $f3path}}
{{ $f4path := (print "shoefeatures/" $.Params.feature4 ".html") }}
{{ partial $f4path}}

N'y a t'il pas une autre solution pour éviter d'avoir la logique de chargement de template dans le template lui- meme ? Ce n'est pas plutot le role de la vue ?

Refactoriser le CSS avec Tailwind

Parce que ce n'est pas mon métier, parce que je ne veux pas à avoir à maintenir un inventaire de code CSS custom pour une mise en page aussi simple, parce que je souhaite faire l'expérience de l'approche utility-first, une refactorisation du CSS du site avec Tailwind semble quelque chose d'attirant.

  • Installation / Configuration
    • Installer Tailwind 2.0 avec Hugo
    • Personnaliser la configuration pour utiliser les fonts Poppins et Roboto
    • Personnaliser la configuration des couleurs du site
  • Composants
    • Header
    • Navigation
    • Footer
    • Items liste (accueil)
  • Articles
    • Métadonnées d'un article
    • Typographie : titres, corps de texte
    • Étendre les styles du plugin typography pour les couleurs et police des titres
    • Citations
    • Figure
    • Embeds
    • Syntax Highlighting / Chroma
    • Inserts (info, mise à jour, astuce)
  • Single page (ex : à propos)
  • Page Catégorie
  • Résultats de recherche
  • Supprimer le code mort
  • Responsive
  • Dark Mode
  • Purge CSS
  • Critical CSS ?
  • Cumulative Layout Shift ?
  • Comparer le poids du CSS avant/après

Les cas d'usages évidents pour un site statique

  • Site perso, serverless pour s'éviter de la maintenance, des mises à jour, vulnérabiltés et hébergement gratuit
  • Site de contenus avec peu d'interactions utilisateurs (landing, page, société, etc.)
  • SPA full et APIs tierces

Automatiser les optimisations pour Jekyll et Hugo

Ceci est une suggestion pour un billet sur le blog :

  1. Génération du Critical CSS
  2. Enlever le CSS non utilisé
  3. Optimisation des images (webp, responsiveness, svg map)
  4. Optimisation du browser cache pour les fichiers statiques
  5. Minification du CSS, JS et HTML

Workflow E-Commerce

https://jamstatic.fr/2017/12/13/site-ecommerce-statique-scalable-avec-hugo/

Workflow

Des services comme Netlify gère les déploiements de code via Git. Dans la configuration proposée ici, cela implique un nouveau commit pour chaque mise à jour d'inventaire, ce qui n'est peut-être pas forcément l'idéal. On pourait imaginer gérer des branches distinctes pour le code et les contenus et les fusionner ensuite au besoin, mais ça pourrait vite devenir problématique.

N'y a t'il pas une solution en passant par git-submodule : https://git-scm.com/book/fr/v2/Utilitaires-Git-Sous-modules

Corrections pour le premier billet

Quelques remarques et signalements de coquilles concernant le premier billet du blog :

  • questionnement concernant l'expression "gestionnaires de fichiers statiques", "générateurs de site statique" ne serait-il pas plus juste ?
  • idem avec " gestionnaires de fichiers statiques" ;
  • idem avec "gestionnaires de contenu statique" ;
  • remplacer "contributiion" par "contribution" ;
  • et sinon merci pour cette belle initiative !

[WIP] Interview Lead Dev Phenomic

Thèmes à aborder au delà de Phenomic:

  • SSR vs static?
  • Partials vs React/Vue Components?
  • JS taking over SSR
  • Phenomic and the JAMstack: connexions with APIs?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.