160 lines
4.4 KiB
Markdown
160 lines
4.4 KiB
Markdown
Title: Référence rapide SkrivML - Paheko
|
|
|
|
<<toc aside>>
|
|
|
|
# Syntaxe SkrivML
|
|
|
|
Paheko propose la syntaxe [SkrivML](https://fossil.kd2.org/paheko/doc/trunk/doc/skrivml.html) pour le formatage du texte des pages du site web.
|
|
|
|
## Styles de texte
|
|
|
|
| Style | Syntaxe |
|
|
| :- | :- |
|
|
| *Italique* | `Entourer le texte de ''deux apostrophes''` |
|
|
| **Gras** | `Entourer le texte de **deux astérisques**` |
|
|
| Texte <ins>Souligné</ins> | `Entourer le texte de deux __tirets bas__.` |
|
|
| ~~Barré~~ | `Deux --tirets hauts-- pour barrer.` |
|
|
| Texte <sup>Exposant</sup> | `XXI^^ème^^ siècle` |
|
|
| Texte <sub>Indice</sub> | `CO,,2,,` |
|
|
|
|
**Attention :** ces styles ne fonctionnent que si le code entoure des mots complets, ça ne fonctionne pas au milieu de mots.
|
|
|
|
```
|
|
Un **mot** en gras. Mais on ne peut pas cou**per** un mot avec du gras.
|
|
```
|
|
|
|
> Un **mot** en gras. Mais on ne peut pas cou\*\*per** un mot avec du gras.
|
|
|
|
## Titres
|
|
|
|
Doivent être précédé d'un ou plusieurs signe égal. Peuvent aussi être suivi du même nombre de signe égal.
|
|
|
|
```
|
|
= Titre niveau 1
|
|
== Titre niveau 2
|
|
=== Titre niveau 3 ===
|
|
==== Titre de niveau 4 ====
|
|
```
|
|
|
|
## Listes
|
|
|
|
Listes non ordonnées :
|
|
|
|
```
|
|
* Item 1
|
|
* Item 2
|
|
** Sous-item 2.1
|
|
** Sous-item 2.2
|
|
*** Sous-item 2.2.1
|
|
```
|
|
|
|
Listes ordonnées :
|
|
|
|
```
|
|
# Item 1
|
|
# Item 2
|
|
## Sub-item 2.1
|
|
## Sub-item 2.2
|
|
### Sub-item 2.2.1
|
|
```
|
|
|
|
## Liens
|
|
|
|
Lien interne :
|
|
|
|
```
|
|
Voir [[cette page|adresse-unique-autre-page]].
|
|
```
|
|
|
|
Lien externe :
|
|
|
|
```
|
|
[[https://paheko.cloud/]]
|
|
```
|
|
## Tableaux
|
|
|
|
```
|
|
!! Colonne 1 !! Colonne 2
|
|
|| Cellule 1 || Cellule 2
|
|
|| Cellule 3 || Cellule 4
|
|
```
|
|
|
|
## Autres
|
|
|
|
Consulter la documentation complète de [SkrivML](https://fossil.kd2.org/garradin/doc/trunk/doc/skrivml.html).
|
|
|
|
# Extensions
|
|
|
|
Toutes les extensions se présentent sous la forme d'un code situé entre deux signes **inférieur à** (`<<`) et deux signes **supérieur à** (`>>`), à ne pas confondre avec les guillements français (`«` et `»`).
|
|
|
|
## Images jointes
|
|
|
|
Il est possible d'intégrer une image jointe à la page web en plaçant le code suivant sur une ligne (sans autre texte) :
|
|
|
|
```
|
|
<<image|Nom_fichier.jpg|Alignement|Légende>>
|
|
```
|
|
|
|
* `Nom_fichier.jpg` : remplacer par le nom du fichier de l'image (parmi les images jointes à la page)
|
|
* `Alignement` : remplacer par l'alignement :
|
|
* `gauche` ou `left` : l'image sera placée à gauche en petit (200 pixels), le texte remplira l'espace laissé sur la droite de l'image ;
|
|
* `droite` ou `right` : l'image sera placée à droite en petit, le texte remplira l'espace laissé sur la gauche de l'image ;
|
|
* `centre` ou `center` : l'image sera placée au centre en taille moyenne (500 pixels), le texte sera placé au dessus et en dessous.
|
|
* Légende : indiquer ici une courte description de l'image.
|
|
|
|
Exemple :
|
|
|
|
```
|
|
<<image|mon_image.png|center|Ceci est une belle image>>
|
|
```
|
|
|
|
Il est aussi possible d'utiliser la syntaxe avec des paramètres nommés :
|
|
|
|
```
|
|
<<image file="Nom_fichier.jpg" align="center" caption="Légende">>
|
|
```
|
|
|
|
Les images qui ne sont pas mentionnées dans le texte seront affichées après le texte sous forme de galerie.
|
|
|
|
## Fichiers joints
|
|
|
|
Pour créer un bouton permettant de voir ou télécharger un fichier joint à la page web, il suffit d'utiliser la syntaxe suivante :
|
|
|
|
```
|
|
<<file|Nom_fichier.ext|Libellé>>
|
|
```
|
|
|
|
* `Nom_fichier.ext` : remplacer par le nom du fichier (parmi les fichiers joints à la page)
|
|
* `Libellé` : indique le libellé du qui sera affiché sur le bouton, si aucun libellé n'est indiqué alors c'est le nom du fichier qui sera affiché
|
|
|
|
|
|
# Raccourcis clavier
|
|
|
|
Depuis l'édition du texte :
|
|
|
|
| Raccourci | Action |
|
|
| :- | :- |
|
|
| <kbd>Ctrl</kbd> + <kbd>G</kbd> | Mettre en gras |
|
|
| <kbd>Ctrl</kbd> + <kbd>I</kbd> | Mettre en italique |
|
|
| <kbd>Ctrl</kbd> + <kbd>T</kbd> | Mettre en titre |
|
|
| <kbd>Ctrl</kbd> + <kbd>L</kbd> | Transformer en lien |
|
|
| <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>I</kbd> | Insérer une image |
|
|
| <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd> | Insérer un fichier |
|
|
| <kbd>Ctrl</kbd> + <kbd>P</kbd> | Prévisualiser |
|
|
| <kbd>Ctrl</kbd> + <kbd>S</kbd> | Enregistrer |
|
|
| <kbd>F11</kbd> | Activer ou désactiver l'édition plein écran |
|
|
| <kbd>F1</kbd> | Afficher l'aide |
|
|
| <kbd>Echap</kbd> | Prévisualiser (rappuyer pour revenir à l'édition) |
|
|
|
|
|
|
Depuis la prévisualisation :
|
|
|
|
| Raccourci | Action |
|
|
| :- | :- |
|
|
| <kbd>Ctrl</kbd> + <kbd>P</kbd> | Retour à l'édition |
|
|
|
|
Depuis l'aide ou l'insertion de fichier :
|
|
|
|
| Raccourci | Action |
|
|
| :- | :- |
|
|
| <kbd>Echap</kbd> | Fermer et revenir à l'édition |
|