Fix classe icode ; link http in metas ; readme ; working on new help folder
This commit is contained in:
parent
fc7460ce78
commit
862e45378a
312
README.md
312
README.md
|
|
@ -122,313 +122,9 @@ Si vous êtes satisfait, vous pouvez le déployer "officiellement" dans www
|
||||||
gsl www add monarticle.gsl
|
gsl www add monarticle.gsl
|
||||||
```
|
```
|
||||||
|
|
||||||
# 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="acronymechoisi_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 ou footer.html, 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
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
# Comment écrire un article
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Votre article doit contenir 2 sections. Les Metas avant #1 et
|
|
||||||
l'article à partir de ce repère (servant de titre h1).
|
|
||||||
|
|
||||||
- METAS : configurer votre article (titre, date, liens...)
|
|
||||||
- ARTICLE : Contenue rédactionnel avec quelques marqueurs (gras...)
|
|
||||||
|
|
||||||
## METAS obligatoires (avant #1)
|
|
||||||
|
|
||||||
```
|
|
||||||
title: POST TITLE
|
|
||||||
slug: POST-TITLE (si espaces, GSL les convertira en -)
|
|
||||||
info: DESCRIPTION (À propos de cet article)
|
|
||||||
author: NAME (doit être enregistré via ($ gsl author add)
|
|
||||||
date: YYYY-MM-DD
|
|
||||||
tags: TAG1,Mon TAG2,TAG3 (séparé par une virgule)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Page ou Article ?
|
|
||||||
|
|
||||||
Vous pouvez spécifier pour chaque article si c'est une page ou un article
|
|
||||||
Si non renseigné, GSL ajoutera le type: post (article) par défaut à la
|
|
||||||
première ligne de votre article
|
|
||||||
|
|
||||||
```
|
|
||||||
# Page (index, 404, about...)
|
|
||||||
# Création selon le slug: /POST-TITLE.html
|
|
||||||
type: page
|
|
||||||
|
|
||||||
# Article (monarticle)
|
|
||||||
# Création selon le slug: /POST-TITLE/index.html
|
|
||||||
type: post
|
|
||||||
```
|
|
||||||
|
|
||||||
## METAS optionnelles (avant #1)
|
|
||||||
|
|
||||||
Définir les marqueurs (abbr:, link:...) et utiliser " : " comme séparateur
|
|
||||||
|
|
||||||
```
|
|
||||||
abbr: COURT : LONG
|
|
||||||
file: NOM : NOM-DU-FICHIER : Text alternatif
|
|
||||||
link: NOM : URL : Text alternatif
|
|
||||||
code: NUMERO : NOM-DU-FICHIER : Text alternatif
|
|
||||||
image: NUMERO : NOM-DU-FICHIER : TEXT-ALTERNATIF
|
|
||||||
```
|
|
||||||
|
|
||||||
## Contenu de l'article:
|
|
||||||
|
|
||||||
Les marqueurs (ex: *__Mon-super-fichier*) *doivent commencer et finir sur
|
|
||||||
la même ligne*. Pour les abréviations (abbr:), écrivez juste (ex: *COURT*).
|
|
||||||
|
|
||||||
### Paragraphes
|
|
||||||
|
|
||||||
Au début d'une nouvelle ligne, ouvrez avec ( et fermez avec ).
|
|
||||||
Vous pouvez utiliser 4 classes de paragraphes différentes : ( 1 ( 2 ( 3
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
( 2
|
|
||||||
Paragraphe avec une classe 2 (css)
|
|
||||||
)
|
|
||||||
|
|
||||||
(
|
|
||||||
Paragraphe sans numéro de classe
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Liens
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
link: Mon lien : URL : Alt text)
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article... (ajoutez + pour ouvrir dans un nouvel onglet)
|
|
||||||
|
|
||||||
```
|
|
||||||
_Mon lien
|
|
||||||
_Mon lien+
|
|
||||||
```
|
|
||||||
|
|
||||||
### Fichiers
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
file: Mon fichier : FILENAME : ALT-TEXT
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
__Mon fichier
|
|
||||||
```
|
|
||||||
|
|
||||||
### Images
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
image: 1 : FILENAME : ALT-TEXT
|
|
||||||
image: 2 : FILENAME : ALT-TEXT
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
Définir le marqueur ```_image``` sur une seule ligne et spécifiez les
|
|
||||||
valeurs séparées par ":"
|
|
||||||
|
|
||||||
- Numero d'image
|
|
||||||
- Alignement: l,r, ou c (g,d également) pour gauche, droite, centre)
|
|
||||||
- Longueur width: juste le nombre
|
|
||||||
- Largeur height: juste le nombre
|
|
||||||
- Champ non vide: Lien de l'image dans un nouvel onglet
|
|
||||||
|
|
||||||
Exemple d'images affichées l'une à côté de l'autre
|
|
||||||
|
|
||||||
```
|
|
||||||
(
|
|
||||||
_image:1
|
|
||||||
_image:2:c:640:480
|
|
||||||
_image:3:c:320:240:+
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
Exemple d'images affichées l'une en dessous de l'autre, dont la première
|
|
||||||
peut s'ouvrir dans un nouvel onglet
|
|
||||||
|
|
||||||
```
|
|
||||||
(
|
|
||||||
_image:1:c:640:480:+
|
|
||||||
)
|
|
||||||
(
|
|
||||||
_image:2:c:1920:1080
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Block-Code depuis un fichier
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
code: 1 : FILENAME : Alt Text
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
_code:1
|
|
||||||
```
|
|
||||||
|
|
||||||
### Écrire en très gras
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
**c'est du surgras**
|
|
||||||
c'est in**défini**ssable
|
|
||||||
il ad**juge** : pas de pub !
|
|
||||||
```
|
|
||||||
|
|
||||||
### Gras
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
*c'est en gras*
|
|
||||||
```
|
|
||||||
|
|
||||||
### Italique
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
C'est /en italique/
|
|
||||||
```
|
|
||||||
|
|
||||||
### Code en ligne
|
|
||||||
|
|
||||||
Info: ¤ = alt-gr + $ sur un clavier FR azerty)
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
¤gsl help -w¤
|
|
||||||
```
|
|
||||||
|
|
||||||
### Citation simple
|
|
||||||
|
|
||||||
(au début de la ligne, mettez 3x -)
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
---
|
|
||||||
(
|
|
||||||
Une citation simple dans un paragraphe
|
|
||||||
)
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
### Citation avancée
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
---
|
|
||||||
_cite : Richard Matthew Stallman
|
|
||||||
_link : https://stallman.org/
|
|
||||||
_lang : en
|
|
||||||
(
|
|
||||||
In the free/libre software movement, we develop software that respects
|
|
||||||
users' freedom, so we and you can escape from software that doesn't. I
|
|
||||||
could have made money this way, and perhaps amused myself writing code.
|
|
||||||
But I knew that at the end of my career, I would look back on years of
|
|
||||||
building walls to divide people, and feel I had spent my life making the
|
|
||||||
world a worse place
|
|
||||||
)
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
### Citation avancée : optionnel
|
|
||||||
|
|
||||||
Ajoutez ces marqueurs, si connus dans la citation, par ex sous ```_cite```
|
|
||||||
|
|
||||||
```
|
|
||||||
_year: 2021
|
|
||||||
_book: Esperanza 64
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### Créer des listes
|
|
||||||
L'arborescence est "infinie".
|
|
||||||
- Chaque contenu de la liste *doit être sur la même ligne*
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
- utilisez ```=``` pour définir l'arborescence d'une liste simple
|
|
||||||
- utilisez ```ø``` pour définir une liste ordonnée (alt+gr + o (FR azerty))
|
|
||||||
|
|
||||||
```
|
|
||||||
(
|
|
||||||
Voici une liste
|
|
||||||
= Fruits : *mangez-en*
|
|
||||||
== Kiwis
|
|
||||||
== Fraises
|
|
||||||
=== pas mûres
|
|
||||||
== Bananes
|
|
||||||
=== Plantins
|
|
||||||
= Légumes
|
|
||||||
== Haricots
|
|
||||||
=== Rouges
|
|
||||||
=== Verts
|
|
||||||
Fin de la liste
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ajouter des lignes vides
|
|
||||||
|
|
||||||
Vous pouvez ajouter des ```<br />``` dans votre rédaction, mais pour une
|
|
||||||
lecture plus propre de votre article, vous pouvez utiliser le caractère
|
|
||||||
```|``` *au tout début d'une nouvelle ligne*
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
#1 Mon titre
|
|
||||||
(
|
|
||||||
Ceci est un long paragraphe (Un peu d'imagination...)
|
|
||||||
|
|
|
||||||
Retour "forcé" à la ligne
|
|
||||||
)
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
# Comment gérer la sidebar
|
# Comment gérer la sidebar
|
||||||
|
------------------------------------------------------------------------
|
||||||
La gestion de la sidebar est manuelle. Un article doit être convertit
|
La gestion de la sidebar est manuelle. Un article doit être convertit
|
||||||
avec make avant de pouvoir l'ajouter à la position ddsirée. Le nombre
|
avec make avant de pouvoir l'ajouter à la position ddsirée. Le nombre
|
||||||
d'articles maximum dans la sidebar est configurable dans /etc/gsl/gsl.conf
|
d'articles maximum dans la sidebar est configurable dans /etc/gsl/gsl.conf
|
||||||
|
|
@ -449,7 +145,13 @@ gsl -S remove monarticle2
|
||||||
gsl -S -A 3 monarticle4
|
gsl -S -A 3 monarticle4
|
||||||
```
|
```
|
||||||
|
|
||||||
|
# Besoin d'aide !
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
Reportez vous aux explications dans le dossier *help*
|
||||||
|
|
||||||
|
|
||||||
# HELP COMMAND
|
# HELP COMMAND
|
||||||
|
------------------------------------------------------------------------
|
||||||
```
|
```
|
||||||
$ gsl [ARG]
|
$ gsl [ARG]
|
||||||
readme : Show README.md instructions
|
readme : Show README.md instructions
|
||||||
|
|
|
||||||
2
control
2
control
|
|
@ -1,5 +1,5 @@
|
||||||
Package: egsl
|
Package: egsl
|
||||||
Version: 0.0.33
|
Version: 0.0.34
|
||||||
Section: custom
|
Section: custom
|
||||||
Priority: optional
|
Priority: optional
|
||||||
Architecture: all
|
Architecture: all
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,284 @@
|
||||||
|
# Comment écrire un article
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
Votre article doit contenir 2 sections. Les Metas avant #1 et
|
||||||
|
l'article à partir de ce repère (servant de titre h1).
|
||||||
|
|
||||||
|
- METAS : configurer votre article (titre, date, liens...)
|
||||||
|
- ARTICLE : Contenue rédactionnel avec quelques marqueurs (gras...)
|
||||||
|
|
||||||
|
## METAS obligatoires (avant #1)
|
||||||
|
|
||||||
|
```
|
||||||
|
title: POST TITLE
|
||||||
|
slug: POST-TITLE (si espaces, GSL les convertira en -)
|
||||||
|
info: DESCRIPTION (À propos de cet article)
|
||||||
|
author: NAME (doit être enregistré via ($ gsl author add)
|
||||||
|
date: YYYY-MM-DD
|
||||||
|
tags: TAG1,Mon TAG2,TAG3 (séparé par une virgule)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Page ou Article ?
|
||||||
|
|
||||||
|
Vous pouvez spécifier pour chaque article si c'est une page ou un article
|
||||||
|
Si non renseigné, GSL ajoutera le type: post (article) par défaut à la
|
||||||
|
première ligne de votre article
|
||||||
|
|
||||||
|
```
|
||||||
|
# Page (index, 404, about...)
|
||||||
|
# Création selon le slug: /POST-TITLE.html
|
||||||
|
type: page
|
||||||
|
|
||||||
|
# Article (monarticle)
|
||||||
|
# Création selon le slug: /POST-TITLE/index.html
|
||||||
|
type: post
|
||||||
|
```
|
||||||
|
|
||||||
|
## METAS optionnelles (avant #1)
|
||||||
|
|
||||||
|
Définir les marqueurs (abbr:, link:...) et utiliser " : " comme séparateur
|
||||||
|
|
||||||
|
```
|
||||||
|
abbr: COURT : LONG
|
||||||
|
file: NOM : NOM-DU-FICHIER : Text alternatif
|
||||||
|
link: NOM : URL : Text alternatif
|
||||||
|
code: NUMERO : NOM-DU-FICHIER : Text alternatif
|
||||||
|
image: NUMERO : NOM-DU-FICHIER : TEXT-ALTERNATIF
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contenu de l'article:
|
||||||
|
|
||||||
|
Les marqueurs *et leur contenu* (ex: ```= list 1...```, ```*__monfichier...```)
|
||||||
|
**doivent commencer et finir sur la même ligne**.
|
||||||
|
|
||||||
|
### Abréviations
|
||||||
|
Dans les Metas:
|
||||||
|
|
||||||
|
```
|
||||||
|
abbr: CSS : Cascading Style Sheets
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans l'article:
|
||||||
|
|
||||||
|
```
|
||||||
|
Les propriétés CSS ne sont pas définies
|
||||||
|
```
|
||||||
|
|
||||||
|
### Paragraphes
|
||||||
|
|
||||||
|
Au début d'une nouvelle ligne, ouvrez avec ( et fermez avec ).
|
||||||
|
Vous pouvez utiliser 4 classes de paragraphes différentes : ( 1 ( 2 ( 3
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
```
|
||||||
|
( 2
|
||||||
|
Paragraphe avec une classe 2 (css)
|
||||||
|
)
|
||||||
|
|
||||||
|
(
|
||||||
|
Paragraphe sans numéro de classe
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Liens
|
||||||
|
|
||||||
|
Définir en METAS
|
||||||
|
|
||||||
|
```
|
||||||
|
link: Mon lien : URL : Alt text
|
||||||
|
link: https://a-lec.org/ : URL : Alt text
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans l'article..
|
||||||
|
- Écrivez ``_```` devant le nom du lien
|
||||||
|
- Ajoutez ```+``` pour ouvrir le lien dans un nouvel onglet
|
||||||
|
|
||||||
|
```
|
||||||
|
Visitez _Mon lien+ et charger ici la page _https://a-lec.org/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Fichiers
|
||||||
|
|
||||||
|
Définir en METAS
|
||||||
|
|
||||||
|
```
|
||||||
|
file: Mon fichier : FILENAME : ALT-TEXT
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
```
|
||||||
|
__Mon fichier
|
||||||
|
```
|
||||||
|
|
||||||
|
### Images
|
||||||
|
|
||||||
|
Définir en METAS
|
||||||
|
|
||||||
|
```
|
||||||
|
image: 1 : FILENAME : ALT-TEXT
|
||||||
|
image: 2 : FILENAME : ALT-TEXT
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
Définir le marqueur ```_image``` sur une seule ligne et spécifiez les
|
||||||
|
valeurs séparées par ":"
|
||||||
|
|
||||||
|
- Numero d'image
|
||||||
|
- Alignement: l,r, ou c (g,d également) pour gauche, droite, centre)
|
||||||
|
- Longueur width: juste le nombre
|
||||||
|
- Largeur height: juste le nombre
|
||||||
|
- Champ non vide: Lien de l'image dans un nouvel onglet
|
||||||
|
|
||||||
|
Exemple d'images affichées l'une à côté de l'autre
|
||||||
|
|
||||||
|
```
|
||||||
|
(
|
||||||
|
_image:1
|
||||||
|
_image:2:c:640:480
|
||||||
|
_image:3:c:320:240:+
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
Exemple d'images affichées l'une en dessous de l'autre, dont la première
|
||||||
|
peut s'ouvrir dans un nouvel onglet
|
||||||
|
|
||||||
|
```
|
||||||
|
(
|
||||||
|
_image:1:c:640:480:+
|
||||||
|
)
|
||||||
|
(
|
||||||
|
_image:2:c:1920:1080
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Block-Code depuis un fichier
|
||||||
|
|
||||||
|
Définir en METAS
|
||||||
|
|
||||||
|
```
|
||||||
|
code: 1 : FILENAME : Alt Text
|
||||||
|
```
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
```
|
||||||
|
_code:1
|
||||||
|
```
|
||||||
|
|
||||||
|
### Écrire en très gras
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
|
||||||
|
```
|
||||||
|
**c'est du surgras**
|
||||||
|
c'est in**défini**ssable
|
||||||
|
il ad**juge** : pas de pub !
|
||||||
|
```
|
||||||
|
|
||||||
|
### Gras
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
|
||||||
|
```
|
||||||
|
*c'est en gras*
|
||||||
|
```
|
||||||
|
|
||||||
|
### Italique
|
||||||
|
Dans l'article...
|
||||||
|
|
||||||
|
```
|
||||||
|
C'est /en italique/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Code en ligne
|
||||||
|
|
||||||
|
Info: ¤ = alt-gr + $ sur un clavier FR azerty)
|
||||||
|
Dans l'article...
|
||||||
|
|
||||||
|
```
|
||||||
|
¤gsl help -w¤
|
||||||
|
```
|
||||||
|
|
||||||
|
### Citation simple
|
||||||
|
|
||||||
|
(au début de la ligne, mettez 3x -)
|
||||||
|
Dans l'article...
|
||||||
|
|
||||||
|
```
|
||||||
|
---
|
||||||
|
(
|
||||||
|
Une citation simple dans un paragraphe
|
||||||
|
)
|
||||||
|
---
|
||||||
|
```
|
||||||
|
|
||||||
|
### Citation avancée
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
```
|
||||||
|
---
|
||||||
|
_cite : Richard Matthew Stallman
|
||||||
|
_link : https://stallman.org/
|
||||||
|
_lang : en
|
||||||
|
(
|
||||||
|
In the free/libre software movement, we develop software that respects
|
||||||
|
users' freedom, so we and you can escape from software that doesn't. I
|
||||||
|
could have made money this way, and perhaps amused myself writing code.
|
||||||
|
But I knew that at the end of my career, I would look back on years of
|
||||||
|
building walls to divide people, and feel I had spent my life making the
|
||||||
|
world a worse place
|
||||||
|
)
|
||||||
|
---
|
||||||
|
```
|
||||||
|
|
||||||
|
### Citation avancée : optionnel
|
||||||
|
|
||||||
|
Ajoutez ces marqueurs, si connus dans la citation, par ex sous ```_cite```
|
||||||
|
|
||||||
|
```
|
||||||
|
_year: 2021
|
||||||
|
_book: Esperanza 64
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### Créer des listes
|
||||||
|
L'arborescence est "infinie".
|
||||||
|
- Chaque contenu de la liste *doit être sur la même ligne*
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
- utilisez ```=``` pour définir l'arborescence d'une liste simple
|
||||||
|
- utilisez ```ø``` pour définir une liste ordonnée (alt+gr + o (FR azerty))
|
||||||
|
|
||||||
|
```
|
||||||
|
(
|
||||||
|
Voici une liste
|
||||||
|
= Fruits : *mangez-en*
|
||||||
|
== Kiwis
|
||||||
|
== Fraises
|
||||||
|
=== pas mûres
|
||||||
|
== Bananes
|
||||||
|
=== Plantins
|
||||||
|
= Légumes
|
||||||
|
== Haricots
|
||||||
|
=== Rouges
|
||||||
|
=== Verts
|
||||||
|
Fin de la liste
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Ajouter des lignes vides
|
||||||
|
|
||||||
|
Vous pouvez ajouter des ```<br />``` dans votre rédaction, mais pour une
|
||||||
|
lecture plus propre de votre article, vous pouvez utiliser le caractère
|
||||||
|
```|``` *au tout début d'une nouvelle ligne*
|
||||||
|
|
||||||
|
Dans l'article...
|
||||||
|
|
||||||
|
```
|
||||||
|
#1 Mon titre
|
||||||
|
(
|
||||||
|
Ceci est un long paragraphe (Un peu d'imagination...)
|
||||||
|
|
|
||||||
|
Retour "forcé" à la ligne
|
||||||
|
)
|
||||||
|
|
||||||
|
```
|
||||||
|
|
@ -0,0 +1,58 @@
|
||||||
|
# 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 ou footer.html, 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 passent votre ACRONYM configuré,
|
||||||
|
lors de la création d'un domaine avec ```gsl new```, suivi par ```_```
|
||||||
|
|
||||||
|
- ID=
|
||||||
|
- - body: ACRONYM_page
|
||||||
|
- - header: ACRONYM_banner
|
||||||
|
- - logo dans header: ACRONYM_site-logo
|
||||||
|
- - title dans header: ACRONYM_site-title
|
||||||
|
- - name dans header: ACRONYM_site-name
|
||||||
|
- - Description dans header: ACRONYM_site-description
|
||||||
|
- - section avant article: ACRONYM_spage-wrapper
|
||||||
|
- - article: ACRONYM_SLUG (SLUG est le "slug: SLUG" de l'artciel)
|
||||||
|
- - div metas (auteur, date...): ACRONYM_metas
|
||||||
|
- - p dans div metas: ACRONYM_auteur
|
||||||
|
|
||||||
|
- CLASS=
|
||||||
|
- - div après chaque titre ``<hX>```: ACRONYM_content-pX
|
||||||
|
- - p dans div content-pX: ACRONYM_paragraph
|
||||||
|
- - - si contenu ```( 2```: ACRONYM_paragraph-2
|
||||||
|
- - code for inline-code: ACRONYM_icode
|
||||||
|
|
||||||
|
... more to be listed here
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
#!/bin/bash
|
#!/bin/bash
|
||||||
# Version: 0.0.33
|
# Version: 0.0.34
|
||||||
# file: gsl
|
# file: gsl
|
||||||
# Folder: /usr/local/bin
|
# Folder: /usr/local/bin
|
||||||
# By echolib
|
# By echolib
|
||||||
|
|
|
||||||
|
|
@ -122,313 +122,9 @@ Si vous êtes satisfait, vous pouvez le déployer "officiellement" dans www
|
||||||
gsl www add monarticle.gsl
|
gsl www add monarticle.gsl
|
||||||
```
|
```
|
||||||
|
|
||||||
# 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="acronymechoisi_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 ou footer.html, 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
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
# Comment écrire un article
|
|
||||||
------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Votre article doit contenir 2 sections. Les Metas avant #1 et
|
|
||||||
l'article à partir de ce repère (servant de titre h1).
|
|
||||||
|
|
||||||
- METAS : configurer votre article (titre, date, liens...)
|
|
||||||
- ARTICLE : Contenue rédactionnel avec quelques marqueurs (gras...)
|
|
||||||
|
|
||||||
## METAS obligatoires (avant #1)
|
|
||||||
|
|
||||||
```
|
|
||||||
title: POST TITLE
|
|
||||||
slug: POST-TITLE (si espaces, GSL les convertira en -)
|
|
||||||
info: DESCRIPTION (À propos de cet article)
|
|
||||||
author: NAME (doit être enregistré via ($ gsl author add)
|
|
||||||
date: YYYY-MM-DD
|
|
||||||
tags: TAG1,Mon TAG2,TAG3 (séparé par une virgule)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Page ou Article ?
|
|
||||||
|
|
||||||
Vous pouvez spécifier pour chaque article si c'est une page ou un article
|
|
||||||
Si non renseigné, GSL ajoutera le type: post (article) par défaut à la
|
|
||||||
première ligne de votre article
|
|
||||||
|
|
||||||
```
|
|
||||||
# Page (index, 404, about...)
|
|
||||||
# Création selon le slug: /POST-TITLE.html
|
|
||||||
type: page
|
|
||||||
|
|
||||||
# Article (monarticle)
|
|
||||||
# Création selon le slug: /POST-TITLE/index.html
|
|
||||||
type: post
|
|
||||||
```
|
|
||||||
|
|
||||||
## METAS optionnelles (avant #1)
|
|
||||||
|
|
||||||
Définir les marqueurs (abbr:, link:...) et utiliser " : " comme séparateur
|
|
||||||
|
|
||||||
```
|
|
||||||
abbr: COURT : LONG
|
|
||||||
file: NOM : NOM-DU-FICHIER : Text alternatif
|
|
||||||
link: NOM : URL : Text alternatif
|
|
||||||
code: NUMERO : NOM-DU-FICHIER : Text alternatif
|
|
||||||
image: NUMERO : NOM-DU-FICHIER : TEXT-ALTERNATIF
|
|
||||||
```
|
|
||||||
|
|
||||||
## Contenu de l'article:
|
|
||||||
|
|
||||||
Les marqueurs (ex: *__Mon-super-fichier*) *doivent commencer et finir sur
|
|
||||||
la même ligne*. Pour les abréviations (abbr:), écrivez juste (ex: *COURT*).
|
|
||||||
|
|
||||||
### Paragraphes
|
|
||||||
|
|
||||||
Au début d'une nouvelle ligne, ouvrez avec ( et fermez avec ).
|
|
||||||
Vous pouvez utiliser 4 classes de paragraphes différentes : ( 1 ( 2 ( 3
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
( 2
|
|
||||||
Paragraphe avec une classe 2 (css)
|
|
||||||
)
|
|
||||||
|
|
||||||
(
|
|
||||||
Paragraphe sans numéro de classe
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Liens
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
link: Mon lien : URL : Alt text)
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article... (ajoutez + pour ouvrir dans un nouvel onglet)
|
|
||||||
|
|
||||||
```
|
|
||||||
_Mon lien
|
|
||||||
_Mon lien+
|
|
||||||
```
|
|
||||||
|
|
||||||
### Fichiers
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
file: Mon fichier : FILENAME : ALT-TEXT
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
__Mon fichier
|
|
||||||
```
|
|
||||||
|
|
||||||
### Images
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
image: 1 : FILENAME : ALT-TEXT
|
|
||||||
image: 2 : FILENAME : ALT-TEXT
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
Définir le marqueur ```_image``` sur une seule ligne et spécifiez les
|
|
||||||
valeurs séparées par ":"
|
|
||||||
|
|
||||||
- Numero d'image
|
|
||||||
- Alignement: l,r, ou c (g,d également) pour gauche, droite, centre)
|
|
||||||
- Longueur width: juste le nombre
|
|
||||||
- Largeur height: juste le nombre
|
|
||||||
- Champ non vide: Lien de l'image dans un nouvel onglet
|
|
||||||
|
|
||||||
Exemple d'images affichées l'une à côté de l'autre
|
|
||||||
|
|
||||||
```
|
|
||||||
(
|
|
||||||
_image:1
|
|
||||||
_image:2:c:640:480
|
|
||||||
_image:3:c:320:240:+
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
Exemple d'images affichées l'une en dessous de l'autre, dont la première
|
|
||||||
peut s'ouvrir dans un nouvel onglet
|
|
||||||
|
|
||||||
```
|
|
||||||
(
|
|
||||||
_image:1:c:640:480:+
|
|
||||||
)
|
|
||||||
(
|
|
||||||
_image:2:c:1920:1080
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Block-Code depuis un fichier
|
|
||||||
|
|
||||||
Définir en METAS
|
|
||||||
|
|
||||||
```
|
|
||||||
code: 1 : FILENAME : Alt Text
|
|
||||||
```
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
_code:1
|
|
||||||
```
|
|
||||||
|
|
||||||
### Écrire en très gras
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
**c'est du surgras**
|
|
||||||
c'est in**défini**ssable
|
|
||||||
il ad**juge** : pas de pub !
|
|
||||||
```
|
|
||||||
|
|
||||||
### Gras
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
*c'est en gras*
|
|
||||||
```
|
|
||||||
|
|
||||||
### Italique
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
C'est /en italique/
|
|
||||||
```
|
|
||||||
|
|
||||||
### Code en ligne
|
|
||||||
|
|
||||||
Info: ¤ = alt-gr + $ sur un clavier FR azerty)
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
¤gsl help -w¤
|
|
||||||
```
|
|
||||||
|
|
||||||
### Citation simple
|
|
||||||
|
|
||||||
(au début de la ligne, mettez 3x -)
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
---
|
|
||||||
(
|
|
||||||
Une citation simple dans un paragraphe
|
|
||||||
)
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
### Citation avancée
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
```
|
|
||||||
---
|
|
||||||
_cite : Richard Matthew Stallman
|
|
||||||
_link : https://stallman.org/
|
|
||||||
_lang : en
|
|
||||||
(
|
|
||||||
In the free/libre software movement, we develop software that respects
|
|
||||||
users' freedom, so we and you can escape from software that doesn't. I
|
|
||||||
could have made money this way, and perhaps amused myself writing code.
|
|
||||||
But I knew that at the end of my career, I would look back on years of
|
|
||||||
building walls to divide people, and feel I had spent my life making the
|
|
||||||
world a worse place
|
|
||||||
)
|
|
||||||
---
|
|
||||||
```
|
|
||||||
|
|
||||||
### Citation avancée : optionnel
|
|
||||||
|
|
||||||
Ajoutez ces marqueurs, si connus dans la citation, par ex sous ```_cite```
|
|
||||||
|
|
||||||
```
|
|
||||||
_year: 2021
|
|
||||||
_book: Esperanza 64
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### Créer des listes
|
|
||||||
L'arborescence est "infinie".
|
|
||||||
- Chaque contenu de la liste *doit être sur la même ligne*
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
- utilisez ```=``` pour définir l'arborescence d'une liste simple
|
|
||||||
- utilisez ```ø``` pour définir une liste ordonnée (alt+gr + o (FR azerty))
|
|
||||||
|
|
||||||
```
|
|
||||||
(
|
|
||||||
Voici une liste
|
|
||||||
= Fruits : *mangez-en*
|
|
||||||
== Kiwis
|
|
||||||
== Fraises
|
|
||||||
=== pas mûres
|
|
||||||
== Bananes
|
|
||||||
=== Plantins
|
|
||||||
= Légumes
|
|
||||||
== Haricots
|
|
||||||
=== Rouges
|
|
||||||
=== Verts
|
|
||||||
Fin de la liste
|
|
||||||
)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Ajouter des lignes vides
|
|
||||||
|
|
||||||
Vous pouvez ajouter des ```<br />``` dans votre rédaction, mais pour une
|
|
||||||
lecture plus propre de votre article, vous pouvez utiliser le caractère
|
|
||||||
```|``` *au tout début d'une nouvelle ligne*
|
|
||||||
|
|
||||||
Dans l'article...
|
|
||||||
|
|
||||||
```
|
|
||||||
#1 Mon titre
|
|
||||||
(
|
|
||||||
Ceci est un long paragraphe (Un peu d'imagination...)
|
|
||||||
|
|
|
||||||
Retour "forcé" à la ligne
|
|
||||||
)
|
|
||||||
|
|
||||||
```
|
|
||||||
|
|
||||||
# Comment gérer la sidebar
|
# Comment gérer la sidebar
|
||||||
|
------------------------------------------------------------------------
|
||||||
La gestion de la sidebar est manuelle. Un article doit être convertit
|
La gestion de la sidebar est manuelle. Un article doit être convertit
|
||||||
avec make avant de pouvoir l'ajouter à la position ddsirée. Le nombre
|
avec make avant de pouvoir l'ajouter à la position ddsirée. Le nombre
|
||||||
d'articles maximum dans la sidebar est configurable dans /etc/gsl/gsl.conf
|
d'articles maximum dans la sidebar est configurable dans /etc/gsl/gsl.conf
|
||||||
|
|
@ -449,7 +145,13 @@ gsl -S remove monarticle2
|
||||||
gsl -S -A 3 monarticle4
|
gsl -S -A 3 monarticle4
|
||||||
```
|
```
|
||||||
|
|
||||||
|
# Besoin d'aide !
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
Reportez vous aux explications dans le dossier *help*
|
||||||
|
|
||||||
|
|
||||||
# HELP COMMAND
|
# HELP COMMAND
|
||||||
|
------------------------------------------------------------------------
|
||||||
```
|
```
|
||||||
$ gsl [ARG]
|
$ gsl [ARG]
|
||||||
readme : Show README.md instructions
|
readme : Show README.md instructions
|
||||||
|
|
|
||||||
|
|
@ -148,11 +148,15 @@ do
|
||||||
=~ "$italic" ]] \
|
=~ "$italic" ]] \
|
||||||
&& continue
|
&& continue
|
||||||
|
|
||||||
# Testing for links
|
this_word=`
|
||||||
#[[ `awk -v l="$n" 'NR == l' "$2" \
|
awk -v l="$n" 'NR == l' "$2" \
|
||||||
# | grep -oP "(?<=http).*?(?=$italic)"` ]] \
|
| grep -o "[^[:space:]]*$italic[^[:space:]]*"`
|
||||||
# && awk -v l="$n" 'NR == l' "$2" | grep -oPn "(?<=http).*?(?=$italic)" && sleep 1 && echo \
|
|
||||||
# && continue
|
case "$this_word" in
|
||||||
|
"_http"*)
|
||||||
|
continue
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
|
||||||
gsl_italic="$gsl_mark_italic$italic$gsl_mark_italic"
|
gsl_italic="$gsl_mark_italic$italic$gsl_mark_italic"
|
||||||
gsl_html_italic="<em>$italic</em>"
|
gsl_html_italic="<em>$italic</em>"
|
||||||
|
|
@ -173,14 +177,12 @@ gsl_stat_icode=0
|
||||||
|
|
||||||
case "$1" in
|
case "$1" in
|
||||||
"stats")
|
"stats")
|
||||||
echo -ne "\r\033[2K: Counting Inline-Codes..."
|
|
||||||
gsl_mark_icode=`grep -o "$gsl_mark_code" "$2" | wc -l`
|
gsl_mark_icode=`grep -o "$gsl_mark_code" "$2" | wc -l`
|
||||||
gsl_stat_icode=$(( gsl_mark_icode / 2 ))
|
gsl_stat_icode=$(( gsl_mark_icode / 2 ))
|
||||||
;;
|
;;
|
||||||
|
|
||||||
"make")
|
"make")
|
||||||
echo -ne "\r\033[2K: Converting icodes..."
|
gsl_html_icode_o="<code class=\"${gsl_site_css}_icode\">"
|
||||||
gsl_html_icode_o="<code class=\"${gsl_site_css}_code\">"
|
|
||||||
gsl_html_icode_c="</code>"
|
gsl_html_icode_c="</code>"
|
||||||
|
|
||||||
while IFS=: read -r "n" "line"
|
while IFS=: read -r "n" "line"
|
||||||
|
|
@ -202,9 +204,12 @@ case "$1" in
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
done
|
done
|
||||||
|
|
||||||
|
echo -ne "\r\033[2K: Converting inline-codes..."
|
||||||
sed -i "${n}d" "$2"
|
sed -i "${n}d" "$2"
|
||||||
sed -i "${n}i$gsl_html_line" "$2"
|
sed -i "${n}i$gsl_html_line" "$2"
|
||||||
unset gsl_html_line
|
unset gsl_html_line
|
||||||
|
|
||||||
done < <(grep -n "$gsl_mark_code" "$2")
|
done < <(grep -n "$gsl_mark_code" "$2")
|
||||||
;;
|
;;
|
||||||
esac
|
esac
|
||||||
|
|
|
||||||
|
|
@ -33,6 +33,7 @@ gsl__make_newline
|
||||||
gsl__make_files
|
gsl__make_files
|
||||||
gsl__do_strongs_bolds "make" "$gsl_tmp_post"
|
gsl__do_strongs_bolds "make" "$gsl_tmp_post"
|
||||||
gsl__make_list
|
gsl__make_list
|
||||||
|
|
||||||
gsl__do_icode "make" "$gsl_tmp_post"
|
gsl__do_icode "make" "$gsl_tmp_post"
|
||||||
gsl__make_titles
|
gsl__make_titles
|
||||||
gsl_ct=0 && gsl__make_titles_div_open
|
gsl_ct=0 && gsl__make_titles_div_open
|
||||||
|
|
@ -42,10 +43,12 @@ gsl__make_paragraphs
|
||||||
|
|
||||||
# From File_Code
|
# From File_Code
|
||||||
gsl_fcode_nbr=`grep "$gsl_mark_fcode" "$gsl_tmp_post" | wc -l`
|
gsl_fcode_nbr=`grep "$gsl_mark_fcode" "$gsl_tmp_post" | wc -l`
|
||||||
for fcode in `seq 1 $gsl_fcode_nbr`
|
if (( $gsl_fcode_nbr > 0 ));then
|
||||||
do
|
for fcode in `seq 1 $gsl_fcode_nbr`
|
||||||
gsl__make_fcode
|
do
|
||||||
done
|
gsl__make_fcode
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
|
||||||
gsl__check_cites
|
gsl__check_cites
|
||||||
gsl__make_a11y
|
gsl__make_a11y
|
||||||
|
|
|
||||||
|
|
@ -250,3 +250,15 @@ if ! [[ "$gsl_post_hf_3" ]];then
|
||||||
esac
|
esac
|
||||||
fi
|
fi
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#=======================================================================
|
||||||
|
# A very simple debugger that show some values
|
||||||
|
#=======================================================================
|
||||||
|
gsl__debug() {
|
||||||
|
printf '\n%s\n%s\n%s\n%s\n' \
|
||||||
|
"D> 1. '$1'" \
|
||||||
|
"D> 2. '$2'" \
|
||||||
|
"D> 3. '$3'" \
|
||||||
|
"D> 4. '$4'"
|
||||||
|
sleep 1
|
||||||
|
}
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue