Catégories : info site

Type d'article : collaboratif (CC by-sa)

Titres, sous-titres et sommaire

Sous-titres

Il est conseillé de diviser une description en plusieurs parties. Par exemple, pour la description d'un itinéraire : approche, voie, descente.
Le sous-titre utilisé pour chaque section est précédé par la balise ## (sous-titre de niveau 1). La balise ## est accessible dans la barre d'outils, en haut du champ de saisie (bouton H).

Il est possible d'utiliser 5 niveaux de sous-titres dans les champs textuels des documents de n'importe quel type (article, itinéraire, sortie, ...), le style de chaque niveau de sous-titre est différent.

## Niveau 1
### Niveau 2
#### Niveau 3
##### Niveau 4

Emphase de titre

Il est possible d'ajouter du texte après le sous-titre, affiché en italique. Il doit être séparé du sous-titre par un # :

## Approche # 1200 m, 2 à 3h

Liens vers les sous-titres

Chaque sous-titre possède une "ancre", c'est-à-dire que l'on peut définir un lien interne pointant directement vers le sous-titre. Le nom de cette ancre est issu du nom du sous-titre. Pour obtenir le lien direct vers un sous-titre, il suffit de copier le lien situé sur le sous-titre dans le sommaire (clic droit sur le sous-titre, puis "copier l'adresse du lien").

Il est également possible de forcer l'ancre, afin de garder des URLs fixes si le titre change. Afin de faire cela, utilisez la syntaxe suivante :

 ## Approche # 1200 m, 2 à 3h {#approche}

Sommaire

Il est possible d'insérer un sommaire n'importe où dans le texte avec la balise [toc]. Cette balise doit être seule sur sa ligne, précédée et suivie d'une ligne vide.

Introduction, suivie d'une ligne vide

[toc]

Suite du texte, précédée d'une ligne vide

Par défaut, le sommaire est affiché à gauche, et le texte qui suit est placé en dessous.

Liens

Liens externes

Voici les deux syntaxes pour insérer un lien :

• [Texte du lien](http://www.example.com) : Texte du lien
• <http://forum.camptocamp.org/latest> : http://forum.camptocamp.org/latest

À noter que le forum est considéré comme un site externe.

Liens internes au topoguide et aux articles

Une syntaxe similaire aux wikiliens de médiawiki (doubles crochets) permet de créer facilement des liens internes.

[[type de document/numéro du document|titre du lien]]

Le numéro du document est visible dans la barre d'url. Par exemple :

• [[routes/960541|un lien vers un topo]] : un lien vers un topo
• [[articles/151910|ou vers un article]] : ou vers un article
• [[waypoints/37355|ou un point de passage]] : ou un point de passage

Adresse email

<nom@serveur.pouet> : nom@serveur.pouet

Mise en forme des caractères

Dans tous les documents du topoguide et les articles, le texte peut être mis en forme grâce à des balises similaires au balises Markdown du forum.
Des boutons permettent d'insérer facilement certaines balises autour du texte sélectionné. Les balises fonctionnent sur tous les champs multilignes, même ceux sans bouton.
Attention : pour formater un sous-titre, n'utilisez pas les balises ci-dessous mais les balises de sous-titre

• **texte en gras** : texte en gras
• *texte en italique* : texte en italique
• ***texte en gras et italique*** : texte en gras et italique
• `police à chasse fixe` : police à chasse fixe
• texte <sup>en exposant</sup> : texte ^{en exposant}
• texte <sub>en indice</sub> : texte _{en indice}
• <del>texte barré</del> : texte barré
• <abbr title="info-bulle">texte avec info-bulle</abbr> : texte avec info-bulle
  • L'info-bulle d'un objet s'affiche lorsqu'on place la souris sur l'objet sans la bouger durant 1 s environ.

Listes à puces et numérotées

Liste à puces

Dans une liste à puces, chaque ligne commence par un point noir.

* un item commence par une étoile
* suivi d’un espace, puis du texte
Le retour à la ligne **sans** saut de ligne donne un retour à la ligne dans l'item.
* item

• un item commence par une étoile
• suivi d'un espace, puis du texte
  Le retour à la ligne sans saut de ligne donne un retour à la ligne dans l'item.
• item

Liste numérotée

1. premier item
2. deuxième
1. inutile de numéroter correctement

1. premier item
2. deuxième
3. inutile de numéroter correctement

Il peut être nécessaire de désactiver la liste numérotée. Dans ce cas, rajoutez un anti-slash \ avant le point :

1986\. What a great season.

1986. What a great season.

Listes et sous-listes

Une liste peut aussi être hiérarchisée en plusieurs niveaux :

* premier niveau
    * 4 espaces avant l’étoile : deuxième niveau
        * 8 espaces : troisième niveau
    * encore 4 espaces
* dernier item

• premier niveau
  • 4 espaces avant l'étoile : deuxième niveau
    • 8 espaces : troisième niveau
  • encore 4 espaces
• dernier item

Liste contenant des paragraphes

1. Item de liste avec deux paragraphes. Lorem ipsum dolor
   sit amet, consectetuer adipiscing elit. Aliquam hendrerit
   mi posuere lectus.

   Vestibulum enim wisi, viverra nec, fringilla in, laoreet
   vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
   sit amet velit.

2. Suspendisse id sem consectetuer libero luctus adipiscing.

1. Item de liste avec deux paragraphes. Lorem ipsum dolor
   sit amet, consectetuer adipiscing elit. Aliquam hendrerit
   mi posuere lectus.

   Vestibulum enim wisi, viverra nec, fringilla in, laoreet
   vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
   sit amet velit.

2. Suspendisse id sem consectetuer libero luctus adipiscing.

Insérer une image

Il est possible d'insérer une image dans le texte. L'image doit respecter les conditions suivantes :

• L'image doit être enregistrée sur Camptocamp.org. Pour ce faire, un lien Ajouter des images est disponible au bas de la page de chaque document.
• Dans un document collaboratif, l'image doit être aussi collaborative (voir l'aide spécifique aux images).

Ainsi, pour insérer de nouvelles images dans le texte d'un nouveau document, il faut procéder en 3 étapes :

1. créer le document sans les images,
2. enregistrer les images sur le document,
3. modifier le document pour insérer les images dans le texte.

Le code pour insérer une image est le suivant, et doit se trouver en début de ligne :

[img=identifiant position taille]légende personnalisée[/img]

• identifiant est l'identifiant numérique de l'image (disponible dans l'URL de l'image)
• position est optionnel. Il peut prendre les valeurs suivantes :
  • right : image positionnée à droite
  • left : image positionnée à gauche
  • center : image centrée, sans texte ni à gauche, ni à droite
  • inline : image dans le fil du texte
• taille est optionnel. Il peut prendre les valeurs suivantes :
  • big
  • small
  • orig

Il est possible de ne pas mettre de légende, avec le code suivant :

[img=identifiant position taille /]

Attention, avec une image placée à gauche ou à droite, elle peut se développer verticalement jusqu'au paragraphe suivant, voire au-delà. Afin de commencer un nouveau paragraphe sous les images précédentes, placez la balise [p] à la fin du paragraphe précédent.

Voici une astuce pour insérer 2 images sur la même ligne. Sur mobile, l'image de gauche s'affiche en premier, et celle de droite en dessous.

[img=142101 left /]
[img=309522 right /]
[p]

Sans la balise [p], le texte qui suit les images s’insérerait entre les 2 images, ce qui est rarement judicieux, surtout sur les petits écrans. Voir pour exemple cette itinéraire.

Insérer une vidéo

Dans les documents personnels (sorties et articles personnels), il est possible d'insérer une vidéo hébergée sur un site tiers tel que YouTube, Vimeo, Dailymotion, etc. Il suffit d'encadrer l'URL de la page de la vidéo entre des balises "video" :

[video]URL de la video[/video]

Cette balise doit être en début de ligne.

Description des longueurs et couennes

Pour décrire les longueurs d'une grande voie, d'une cascade de glace, ou les voies d'un site de couenne ou de bloc, il est pratique d'utiliser la balise L#. Cette balise permet entre autres :

• La numérotation automatique des longueurs.
• La mise en forme de tableau, pour aligner les infos (cotations, longueur en mètre, nb de points, commentaires, ...).

Voir la description complète de la balise L#.

Mise en forme des paragraphes

Citations

Commencez la ligne par >. N'oubliez pas de rajouter une ligne vide à la fin de la citation

> Lorem ipsum dolor si amet

Lorem ipsum dolor si amet

Il est possible de mixer les différentes balises :

> * Voici une liste
> * Dans une citation
>
> Mais également,
> > une citation dans une citation.

• Voici une liste
• Dans une citation

Mais également,

une citation dans une citation.

Centrer le paragraphe

<center>texte en un ou plusieurs paragraphes centré </center>

texte en un ou plusieurs paragraphes centré

Bandeaux d’alertes

!! Information

!!! Balise de warning, le plus souvent temporaire

!!!! Balise d'information 
!!!! importante

Merci d'utiliser ces dernières balises avec clairvoyance pour souligner des informations importantes voire capitales.

Pictogramme/emojis/smileys

Activités

•  : :rock_climbing:
•  : :skitouring:
•  : :ice_climbing:
•  : :snowshoeing:
•  : :hiking:
•  : :slacklining:
•  : :via_ferrata:
•  : :mountain_biking:
•  : :paragliding:
•  : :snow_ice_mixed:
•  : :mountain_climbing:

Points de passage

•  : :pit:
•  : :waterfall:
•  : :locality:
•  : :pass:
•  : :base_camp:
•  : :virtual:
•  : :waterpoint:
•  : :waypoints:
•  : :summit:
•  : :bisse:
•  : :gite:
•  : :paragliding_takeoff:
•  : :lake:
•  : :slackline_spot:
•  : :canyon:
•  : :misc:
•  : :bergschrund:
•  : :shelter:
•  : :cliff:
•  : :local_product:
•  : :climbing_indoor:
•  : :webcam:
•  : :access:
•  : :confluence:
•  : :paragliding_landing:
•  : :camp_site:
•  : :weather_station:
•  : :climbing_outdoor:
•  : :cave:
•  : :bivouac:
•  : :glacier:
•  : :hut:

Divers

Beaucoup d'autres, vous pouvez voir la liste ici : https://www.emojione.com/emoji/v3

Divers

Ligne horizontale.

Insérez le code suivant pour obtenir une ligne horizontale :

----

---

Infos complémentaires

• Extension utilisé : https://pythonhosted.org/Markdown
• Markdown Home Page
• Markdown Syntax