De l'utilisation du markdown

[121593]

Dans l'issue #5 ainsi que d'autres issues à travers plusieurs repo, j'ai vu des références au besoin de pouvoir utiliser du markdown.
D'autre part un grand nombre d'écrits du lab se trouvent sur GitHub en Markdown.

Il pourrait être utile d'avoir la possibilité d'avoir un miroir des contenus de Git sur le site internet. Il pourrait être enrichi en contenu très rapidement avec un bon impact sur le référencement, et cela permettrait aussi de faciliter l'édition du site par les membres.

Dans la PR suivante je propose une version de base de cette feature, utilisant 121593/md-mirror.

Pour voir ce que ça donne : docker-compose down && docker-compose up --build puis navigateur -> http://localhost:19461/md/rtfm/master/SUMMARY.md

Quelques détail à voir avant de valider

• La gestion du cache
• La gestion des droits : il n'y a pour le moment pas d'autre restrictions sur ce qui peut être affiché que le nom d'utilisateur des repo (openfab-lab). Il y aura peut-être besoin de limiter ce qui peut être affiché, avec des pages/repo exclus, et peut-être des branches (la master pourrait être protégée et affichée en exclusivité sur le site)

[nicolasdb]

J'ai testé,
mais la page est Unauthorized

Faut peut-être se loger avec un compte?

[satblip]

@121593 a bien setup lapubic route : https://github.com/openfab-lab/app-membres/pull/24/files#diff-757cd8fb74b000a4da9ea0fd33713c52R15 tu as pull la last version?

[nicolasdb]

oui,
j'ai fais un pull du master avant de refaire le docker-compose build puis up.
Mais il n'y avait pas grand chose de neuf dans le pull.

haaaaaa, ben oui. Le PR est validé mais pas encore fusionné.

[nicolasdb]

working

[121593]

Qu'est-ce que je fais de la feature maintenant ? @nicolasdb tu veux en profiter pour créer des nouveaux liens dans le site ?

[nicolasdb]

oui, ce serai bien de savoir comment faire ces liens,
est-ce qu'il suffit de pointer vers l'adresse du .markdown sur github? ou ailleurs?

Faut que j'explore cette fonction.

[121593]

Pour voir ce que ça donne : docker-compose down && docker-compose up --build puis navigateur -> http://localhost:19461/md/rtfm/master/SUMMARY.md

De là, navigue en cliquant sur les liens et observe les changements dans l'URL. C'est très similaire aux URLs de GitHub. Il suffit ensuite de créer des liens vers ces pages (/md/...).

@satblip je viens de penser à des effets de bord possible au niveau du référencement. Il serait peut-être nécessaire de configurer le robots.txt de manière à utiliser une whitelist d'indexation pour les pages générées par cette fonction. Qu'en penses-tu ?

[satblip]

@satblip je viens de penser à des effets de bord possible au niveau du référencement. Il serait peut-être nécessaire de configurer le robots.txt de manière à utiliser une whitelist d'indexation pour les pages générées par cette fonction. Qu'en penses-tu ?

Je valide 👍