gsl-statique-litterateur/help/template-comment-creer.md

2.2 KiB

Créer un Template


Vous devrez pour que votre site soit à vôtre goût créer et définir les styles dans styles.css. Placez ce fichier (en fonction du choix de votre configuration du DOMAIN) dans :

  • HOME: ~/.config/gsl/domains/DOMAIN/templates/
  • GLOBAL: /var/lib/gsl/domains/DOMAIN/templates/

Concernant les contenus images et fichiers dans vos articles, placez-les dans les dossiers

  • .../templates/images
  • .../templates/files

Astuce: Une fois votre article créé, vous verrez dans sa source HTML que beaucoup d'éléments ont une class="ACRONYM_uneclass". Utilisez ces classes dans style.css pour décorer votre site à votre goût.

Pour mettre à jour et voir vos modifications de styles

gsl sync

GSL synchronisera votre template sur votre webserver. Rechargez votre page dans votre navigateur

Si vous avez modifié header.html ou footer.html dans votre dossier /templates, ou si de nouvelles fonctions sont arrivées et concernent les pages HTML dans GSL, il vous faudra reconstruire toutes les pages

gsl make -F

Listes de classes utilisées.

Rappel: les classes et IDs commencent par votre ACRONYM configuré, lors de la création d'un domaine avec gsl new, suivi par _. Pour une meilleure lisibilité, votre ACRONYM est marqué xxx.

Dans body, header

  • ID=
    • body: xxx_page
    • header: xxx_banner
    • logo dans header: xxx_site-logo
    • title dans header: xxxsite-title
    • name dans header: xxx_site-name
    • Description dans header: xxx_site-description
    • <section> avant <article>: xxxspage-wrapper
    • article: xxx_SLUG (SLUG est le "slug: SLUG" de l'article)
    • div metas (auteur, date...): xxx_metas
    • p dans div metas: xxx_auteur

Dans <article>

  • CLASS=
    • div après chaque titre <hX>: xxx_content-p xxx_content-pX
    • p dans div content-p: xxx_paragraph
      • si contenu ( 2: xxx_paragraph-2
    • code pour les inline-code avec ¤...¤: xxx_icode
    • li (liste) en fonction du nombre N de = | +: xxx__list-li x_list-N
    • ul (liste) simple: xxx_list-ul
    • ol (liste) ordonnée: xxx_list-ol

... more to be listed here