-
Notifications
You must be signed in to change notification settings - Fork 26
Site confort‐plus
Quelques précisions pour travailler sur le site confort-plus.orange.com.
Le site est hébergé par GitHub : c’est la branche gh-pages qui est déployée. Son contenu correspond (pour le moment) au répertoire ./docs/ sur la branche main, avec de nombreux fichiers supplémentaires liés à l’historique du site.
Pour faire simple, si vous devez mettre à jour le site : récupérez les fichiers modifiés dans /docs depuis la dernière mise à jour du site, et collez-les à la racine de la branche gh-pages.
Note
Il est recommandé d’utiliser un worktree Git dédié à la branche gh-pages pour gérer ça et limiter les risques de fichiers oubliés, de conflits et plus généralement d’erreurs. Les branches main et gh-pages n’ont pas la même structure, et c’est précisément à ça que servent les worktree.
npx servor . index.html --browse --static Par défaut, GitHub Pages s’appuie sur Jekyll pour servir des sites statiques. Non seulement c’est inutile dans notre cas, mais c’est même pénalisant car Jekyll ignore les répertoires commençant par un . ou un _, ce qui est le cas pour les fichiers de traductions de Confort+.
Un fichier .nojekyll est ainsi placé à la racine du site sur gh-pages : c’est une convention GitHub pour signaler que Jekyll ne doit pas être utilisé sur ce site.
Un certain nombre de fichiers HTML sont sur la branche gh-pages et nulle part ailleurs : il s’agit de redirections, d’anciennes URLs qui pointent vers les nouvelles. La mécanique est un peu sale, mais puisque que GitHub Pages ne permet pas de gérer la configuration HTTP, un fichier HTML avec une <meta http-equiv=""> est requis :
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>https://confort-plus.orange.com/index.html</title>
<link rel="canonical" href="https://confort-plus.orange.com/index.html">
<meta name="robots" content="noindex">
<meta http-equiv="refresh" content="0; url=https://confort-plus.orange.com/index.html">
</head>
</html>Les répertoires suivants contiennent des redirections et ne doivent donc pas être supprimés :
crossdom/
├── help/
├── *.html
demo/
├── help/
├── *.html
serveur/
├── crossdom/
│ ├── help/
│ ├── *.html
Certains fichiers sont indispensables pour le fonctionnement de la V4 côté serveur, en supplément du site de la v4 : v4/
cookie.html
help/
Si un jour la V4 est décomissionnée, ces fichiers pourraient être supprimés (en assumant le fait que des V4 versions serveurs pourraient atterrir sur des 404).