Home - xarich/XRIPersonalWiki GitHub Wiki

Welcome to "XRI Personal Wiki" 😉!

Table des matières (utilisation de GitHub)

  1. Syntaxes GitHub utiles
    1. Indenter une liste à puces
    2. Créer un tableau
    3. Générer une table des matières
    4. Mettre du texte en couleur
    5. Section avec Collapse / Expand
    6. Référencer des issues "cross-repo"
    7. Recherche filtrée sur les pages Wiki
  2. Créer une nouvelle issue depuis le Kanban

Syntaxes utiles pour GitHub

Indenter une liste à puces

Exemple de rendu

  • To add sub points, put two spaces before the dash (-) or star (*):
    • Sub 1
    • Sub 2

Solution technique

Ajouter 2 espaces devant la liste à puces "classique".

Créer un tableau

Nouvelle méthode (via un éditeur en ligne)

Utiliser l'outil en ligne (i) Astuce : l'alignement (gauche centré droite) est piloté par l'entête de la colonne.

Ancienne méthode (en texte brut !)

Voir mon 1ier tableau (exemple assez complet 👍) :

Sujet Contact Remarque
Informatique Equipe CIR locale Rémi D. ; Dorian N. ; Emin A.
Si Mac Contacts "Directs" Florian Harnet (Vaise) ou Michel Nesti (Aix)
OS + Bureautique Assistance '3737' Email : [email protected]
Portail : https://3737.inextenso.fr
Téléphone : 04 72 60 37 37

Voir aussi dans l'issue "Welcome" : https://github.com/fulll/portail-rh/issues/820

Générer une table des matières

Pour générer un sommaire, utiliser ce site : https://derlin.github.io/bitdowntoc/

/!\ ATTENTION : d'autres sites comme https://luciopaiva.com/markdown-toc gèrent mal les caractères accentués entraînant des "liens brisés". La correction consiste à ajouter manuellement, dans la "partie URL" du sommaire généré, les caractères accentués supprimés ...

Mettre du texte en couleur

En plus d'utiliser les émoticons (raccourcis dans PE pour générer : ⛔ ✅), il est possible (via 'code MarkDown') de mettre du texte en couleur avec 2 contraintes fortes :

  • colore une ligne entière
  • la couleur est donnée par un caractère de ponctuation qui est lui-même affiché 😮 => - + ! # au début ou @@ au début et à la fin

Le code markdown diff

Exemple de résultat :

- text in red
+ text in green
! text in orange
# text in gray
@@ text in purple (and bold)@@

Texte à taper pour produire ce résultat :

  • début : 3 fois le caractère ` suivi du mot diff
  • sur la même ligne : caractère "clef" déclenchant la couleur (souvent ! pour du rouge) + texte souhaité
  • fin : 3 fois le caractère `

Utiliser du code LaTeX

Il semble aussi possible de mettre du rouge (ou autre couleur !) centrée grâce à du code "LaTeX" !
Testé 🆗 dans les Issues (à priori ne fonctionne pas dans le Wiki !)

Résultat

Copie écran dans une issue ...

image

Résultat dans le Wiki ... Voici du texte : $\textcolor{red}{\text{Mon texte en rouge ici}}$, il est beau non ?

Code à saisir (syntaxe LaTex) /!\ ne conserver qu'un seul $ avant ou après (sans rien d'autre !)

`$$\textcolor{red}{\text{Mon texte en rouge ici}}$$

ATTENTION : avec cette solution il ne s'agit pas d'un "vrai texte" et donc

  1. le texte n'est pas sélectionable
  2. il n'est pas indexé par la recherche !

Ou encore utilise 2 "mots-clefs" particulier

> __Note__ > Here is my Note!

> __Warning__ > Here is my Warning!

Résultat image

Section avec Collapse / Expand

Titre de la section avec Twisty Ligne 1 : blabla bleble blibli blolo blublu

Ligne 2 : blabla bleble blibli blolo blublu

...

Ligne X : blabla bleble blibli blolo blublu

Référencer des issues "cross-repo"

  • Pour référencer une issue "locale" au répo => rien de plus simple #[IssueNb] suffit 👍
  • Pour référencer une issue présente dans un autre repo => ce n'est pas tellement plus compliqué, tapez :

fulll/[RepoName]#[IssueNb]

Exemple : fulll/week5#47

Recherche filtrée sur les pages Wiki

Dans la zone de recherche, saisissez : org:fulll type:wikis [Mot recherché]

Remplacez le bloc [Mot recherché] par la recherche souhaitée 👍.

Créer une issue depuis le Kanban

Objectif : gagner du temps en associant directement l'issue au Kanban / à la bonne colonne.

  1. Placez-vous dans la colonne souhaitée
  2. Sur la ligne de titre de la colonne : cliquez sur + pour créer une note (saisissez un texte court)
  3. Enfin, en haut à droite de la note : cliquez sur Convert to issue et complétez votre issue ...
⚠️ **GitHub.com Fallback** ⚠️