Vous êtes ici

Le blog de Laurent Espitallier

Rédiger une belle documentation au format HTML5

Fichier attachéTaille
Plain text icon test.txt4.01 Ko

1

Plutôt que d'utiliser un éditeur HTML comme BlueGriffon, je vous recommande d'emblée et au préalable la rédaction de votre documentation au format markdown, cela vous rendra certainement plus productif car vous pourrez vous concentrer uniquement sur le contenu tout en ayant l'assurance que votre documentation respectera strictement la mise en page et la charte graphique que vous aurez choisie. Sans parler d'automatisation puisque vous pourriez même le produire directement et simplement depuis une base de données ou une application disposant d'une Interface de programmation — Wikipédia ou de fichiers dans un format ouvert.

Néanmoins, vous en conviendrez, comme markdown n'est pas nécessairement ce qu'il y a de plus lisible ou accessible, il est préférable de l'exporter ensuite dans un autre format comme le HTML5. Soit sous forme de présentation dynamique (avec par exemple les frameworks reveal.js, S5, HTML Slidy, etc.) soit dans un(des) fichier(s) statique(s).

Dans le cas du HTML5 statique plusieurs options sont possibles : soit utiliser des solutions dédiées aux développeurs comme DAUX.IO ou MkDocs qui sauront parfaitement l'analyser, soit comme je vais vous le présenter (selon le principe KISS), en utilisant seulement Pandoc et un thème.

N.B : si vous n'avez pas le temps de convertir la documentation ou que vous souhaiteriez qu'elle soit directement publiée sur un serveur web dont vous n'aurez pas accès au backend utilisez un un wiki comme Wiki.js

Dans cet exemple mon choix se porte sur le thème de GitHub compte tenu du fait qu'il est complet, qu'il a déjà fait ses preuves et qu'il semble respecter des principes d'accessibilité (à confirmer).

Enfin, afin de rendre le document aussi portable qu'un fichier généré par traitement de texte (Word, LibreOffice) ou un PDF il sera préférable de ne générer qu'un fichier plutôt qu'un dossier contenant un fichier HTML et ses ressources numériques (images par exemple)

Prérequis

Pandoc

Installation

Pour les Debian, Ubuntu et autres dérivées :

sudo dnf install pandoc

Pour les Redhat, Fedora et autres dérivées :

sudo apt install pandoc  

Pandoc Github flavored HTML5

Installation

git clone https://github.com/tajmone/pandoc-goodies.git  
mkdir -p ~/.pandoc/templates/  
cp -r pandoc-goodies ~/.pandoc/templates/

Conversion

Après rédaction de votre fichier au format Markdown utilisez la commande suivante :

pandoc --template=GitHub.html5 --self-contained test.md -o documentation.html  

dans laquelle : - test.md est le nom du fichier source Markdown - documentation.html le nom de la documentation produite - --self-contained est l'option qui vous permet de tout fusionnez dans un seul fichier HTML

Démonstration

GitHub Pandoc HTML5 Template — Preview
Cet article de blog

UK/Happy hardcore : sélection mai 2020

Blog: 

Singles

Ryan Kore - Hold On Tonight (Original Mix) FREE DOWNLOAD par Ryan Kore

AK47 & Jakka-B - Don't Let Me Go par Keeping The Rave Alive

Get Away (Squad E Remix) de Hypasonic sur Beatport

Da Tweekaz & Code Black - Shake Ya Shimmy par Dirty Workz

Mixes

Mike Enemy X Mike Reverie - Rinse FM guest mix with DJ Hixxy par Mike Enemy / Mc Enemy | Écoute gratuite sur SoundCloud

Contagious Records Podcast Episode 06 With Ganar par CONTAGIOUS RECORDS

Claxton - Everything Hardcore - May 2020 par claxton | Ben Claxton | Écoute gratuite sur SoundCloud

The Hardcore Underground Show - Podcast 28 (Fracus & Darwin) - MAY 2020 #HUPODCAST28 par Hardcore Underground | Écoute gratuite sur SoundCloud

The Contagious Show With DJ Riko + Special Guest Ben Defekt (23/04/20 par DJ_RIKO | Écoute gratuite sur SoundCloud

Dj Versatile - Lockdown Uk Hardcore Mix 1 par dj versatile

UK Hardcore Volume 2 par Martin Morgan

dj_JTS - JTS - Upfront UK Hardcore Live mix - Twitch

DJ Trixy - Rave To The Grave Lockdown Live Stream par Dj Trixy

DJ Bigman - May 2020 Energy [UK Hardcore MiniMIX] par Matt Hinc (Bigman)

Isolation Mix 04 par Calum Shields

Oldies

Hardcore Classic's Vol.1 par Ste Rothery

DJ Cocky - Hardcore Anthems Vol 2 par Marc Cockbain

AKA - UK Hardcore Anthems (RECON + SQUAD-E Mix) par Dj AKA

Dj Lozza - Best Of Uk Hardcore Vol 1 par LOZZA

NIZZLE & NELZA - OH MY QUOSH par -Nizzle-

Dreadhead - On Fire - YouTube

GEAR FM / Somebody's Watching me (Dougal And Gammer Remix) (HAPPY HARDCORE) - YouTube

Sy & Unknown Feat Lou Lou - Don't Leave Me Now (Darren Styles Remix) - YouTube

DJ Cotts - UK / Happy Hardcore Lockdown Live 3 - YouTube
DJ Cotts - UK / Happy Hardcore Lockdown Live 3 Part 2 - YouTube

DJ Cotts - What Happy Hardcore Used To Be 11 (Vinyl Mix) - YouTube

Billy Daniel Bunter & Jon Doe- Round & Round (Breeze & Styles Remix) - YouTube

Brisk & Ham - Taste The Rainbow - YouTube

Euphony & DJ Storm Feat Danielle- Breathe (HTID Remix) - YouTube

Scott Brown - Heaven In Your Eyes - YouTube

Scott Brown - Life As We Know It - YouTube

Scott Brown - Love, Peace and Casualty - YouTube

Scott Brown- Na Na Na - YouTube

DMO, Scott Brown - I'm In Heaven (Original Mix) [Evolution Records] - YouTube

Scott Brown- Memories (Plus System Remix) - YouTube

Brisk & Ham - Gettin' High - YouTube

Scott Brown &Brisk- Chase - YouTube

M@rt!n-J - Sounds Of Summer Vol.1 par M@rt!n-J | M@rt!n J | Écoute gratuite sur SoundCloud

Mark Breeze - Be Alone (VIP) - Free Download par markbreeze | Mark Breeze | Écoute gratuite sur SoundCloud

Euphony - Space Invader (Scott Brown 2015 Remix) [Evolution Records] - YouTube

Outforce & Stu Infinity's Sounds Of Summer Vol 2 OUT NOW PM for details par Stu Infinity

Bonus

Quelques ingrédients pour prendre du plaisir en courant

Blog: 

1

Sans doute que pour certains je vais enfoncer beaucoup de portes ouvertes, mais cela ne semble pas si évident que cela pour tout le monde, de ce que j'ai pu en voir...

Bien s'équiper

Cela passe avant tout par une bonne paire de chaussures adaptée à la taille de vos pieds et à votre foulée. Je ne jure plus que par les diverses itérations des Asus Gel Nimbus (personnellement je considère toutes les autres paires que j'ai testées comme des arnaques), auxquelles je rajoute des semelles Sorbothane Full Strike. Mieux vaut perdre - un peu - en performance mais s’économiser et ne pas se faire mal.

Aussi compte tenu du nombre de kilomètres que je parcours (pas si élevé) une paire de chaussures ne dure que 18 mois en général.

Habillez vous correctement selon les saisons ! C'est bête mais je trouve que beaucoup de coureurs ne sont pas si bien habillés. Quoi d'autre qu'un débardeur en été et deux voir trois couches en hiver quand il faut bien froid ?

S’entraîner régulièrement

Il est indispensable d'avoir un cardio correct et il est peu probable qu'en débutant l'exercice physique ce soit toujours très agréable...

N'oubliez pas d'alterner avec des séances de renforcement musculaire et de gainage pour vous éviter de vous faire mal sur le long terme.

Si vous avez vraiment peur de vous abîmer les genoux, commencez d'abord par quelque chose de plus doux : natation, vélo, etc.

Déconnecter mentalement

Déconnecter du travail et de toute autre source de stress. Il faut parfois un ou deux jours selon la situation pour avoir "l'esprit libre"

Ne pas se soucier de la performance.

Manger sain et équilibré

Car évidemment l'exercice physique seul ne fait pas tout.

Et aussi manger suffisamment longtemps avant d'aller courir : au moins 3 heures à l'avance si vous ne voulez pas trop être dérangé par la digestion.

Courir à jeun c'est bien pour la santé (mincir, se détoxifier) mais pas forcément pour se faire plaisir.

Boire

Régulièrement par toute petites gorgées une eau tiède.

Plus fraîche en été et plus chaude en hiver tout de même (avis personnel)

Les boissons isotoniques ma paraissent vraiment superflues quand on court pour le loisir, à moins d'être vraiment fatigué...

Faire attention à la météo

Si vous avez la possibilité de choisir le moment ou vous allez courir préférez soit :

  • Le matin avec du soleil et une température aux alentours de 20°C maximum avec des zones d'ombres pour alterner les moments ou votre corps va pouvoir libérer de la sérotonine, produire de la vitamine D, etc. et les moments ou votre organisme va pouvoir récupérer pour ne pas trop "surchauffer" à cause de la température extérieure.
  • Quand il pleut avec une température de plus de 15°C. Vous profitez de plus de solitude / isolement et (selon moi) d'un effet piézoélectrique sur la peau (tête) proche d'une bonne douche...

Bien choisir le lieu

De préférence :

  • Près de la nature : cours d'eau, arbres, végétation, etc.
  • En ville là ou il y a peu de circulation (pollution), de piétons et de cyclistes.

Écouter une musique qui vous plaît

Les "expert" vous conseilleront d'éviter car :

  • il est vrai que pour progresser se concentrer sur la respiration aide grandement ! Sauf que si comme moi vous pratiquez la Cohérence Cardiaque vous adopterez rapidement une respiration optimale sans avoir à trop vous concentrer, de façon intuitive / inconsciente donc. Par ailleurs se faire plaisir =/= effectuer une performance.
  • la musique peut vous déconcentrer, vous empêcher d'avoir des états méditatifs. C'est peut être vrai au début, mais à mon avis il y a bien d'autres variables qui vont vous empêcher de méditer en courant (le stress ou une douleur par exemple). En ce qui me concerne une fois que j'ai couru suffisamment longtemps mon corps va libérer des neurotransmetteurs ou des hormones qui vont supprimer les éventuelles petites douleurs et la fatigue, c'est alors que la musique, si elle est bien choisie, va produire un état de conscience particulier proche de la transe, le Flow ², la musique devrait normalement se fondra dans l'environnement mais faire que l'on conserve une concentration assez importante rendant paradoxalement l'optimisation des gestes plus facile et naturelle. Ceci n'est pas incompatible avec le high voir pourrait être concomitant ou similaire (voir plus bas).

Je recommande une musique rythmée et au tempo élevé dans le genre. Ce que la science semble avoir confirmé il y a peu de temps

N'abusez toutefois pas de la musique d'une manière générale, car votre cerveau a besoin de repos. Par ailleurs vous risqueriez d'endommager votre système auditif.

Clairement vous deviez bénéficier d'un jogging plus rapide et de moins de douleurs 🙂

Est-ce vraiment une simple coïncidence si les 170 (battements par minute) est un nombre qui se rapproche de la fréquence cardiaque maximale ?

Courir suffisamment longtemps et suffisamment vite

Il est peu probable que votre corps libère des neurotransmetteurs comme les endorphines ou les endocannabinoïdes en courant seulement 30 minutes à la vitesse d'un marcheur.

Souvent pour moi il faut 45 minutes minimum, parfois 1 heure à un rythme soutenu (13 ou 14 km/h de moyenne). Varier le rythme façon fartlek mais pas au sens strict et sans y réfléchir, n'est pas superflu non plus. Écoutez votre corps.

Cela vous sera bénéfique durant votre footing et dans les heures qui vont suivre...

Ne rien attendre de particulier

ça viendra tout seul, "si ça veut" 😃

Finalement

Si vous avez vous même mis en pratique ces conseils, en plus de ce bien-être parfois nommé runner's high, avez-vous remarqué également un regain de créativité ou éventuellement résolu un "casse-tête mental" ? 🙂


UK/Happy hardcore : sélection avril 2020

Blog: 

Singles

Technikore x Firelite x JTS - Close To Me (Radio Edit) par JTS

KO3 - Hypnotizer - YouTube

Ben Nicky & Sarah De Warren - Giving You Up (Extended Mix) - YouTube

Bass Modulators - Oxygen (Kutski Remix) - YouTube

No More Tears (2020 Update) [We Are One Digital] :: Beatport

Mixes

Car Livestream par Dave PSI - Team Rocket Hardcore

Hixxy - Live At Ravers Reunited Bonkers par Ravers Reunited | Écoute gratuite sur SoundCloud

UFO Lock In Mix 28th March 2020 par Jason UFO

UFO - Live At Ravers Reunited Bonkers par Ravers Reunited

DJ Cotts - Happy Hardcore Lockdown Live Set - YouTube

Breeze - Live At Ravers Reunited Bonkers par Ravers Reunited

Fracus & Darwin @ Hardcore Heaven, Los Angeles, 21.2.20 FREE DOWNLOAD par Hardcore Underground

Happy Hardcore Spring 2020 Mix par Alabaster

April Hardcore Mix - 17 - 04 - 2020 par Alex Threat

Oldies

DJ Cotts - What Happy Hardcore Used To Be 10 (Vinyl Mix) - YouTube

Frisky & Hujib- Believe (Breeze & Styles Remix) - YouTube

Q-Tex - Power Of Love 2001 - YouTube

UFO & MC Marley - Connection - YouTube

Break Up (Technikore 2013 Remix) - Kim Sozzi - YouTube

Delite - Now Thats What I Call Nuggz par DJ Delite

HARDCORE LOCKDOWN (Hard To The Core Digital -Phaze1) par J E N N A | Écoute gratuite sur SoundCloud

The Time Frequency - The Ultimate High (Full Version) - YouTube

Brisk and Vagabond - The Only Ones (Original Mix) - YouTube

DJ Cotts - What Happy Hardcore Used To Be 9 (Vinyl Mix) - YouTube

Ninja Hardcore [Please Share/Repost!] par M@rt!n-J

JTS & Jozzi - Love Me Again // FREE DOWNLOAD par JTS | Écoute gratuite sur SoundCloud

Eufeion - Unshakeable (Original Mix) [Ninja Hardcore] - YouTube

No Left Turn - Hazel Eyes - YouTube

[Happy Hardcore] It's Gonna Be Love (S3RL Remix) - Starstruck feat Mel (for my GF :3 ) - YouTube

Sy & Unknown - My Forever Love - YouTube

Shady People (Extended Mix) - YouTube

Refuzion - Around The World (La La La) (UK Hardcore Bootleg) ғʀᴇᴇ ᴅᴏᴡɴʟᴏᴀᴅ par Boots & Flips

Tweekacore - Ready 4 The Tweekend (Extended) - YouTube

Darren Styles - Getting Better (Gammer Update) [Happy Hardcore] - YouTube

Olly P - F# Bootknee - YouTube

Anti Social - My Way (recon Remix) - YouTube

5. Ramos, Supreme & Mob Feat. Mandy - Catch You (Re-Con Remix) par embo778 | Écoute gratuite sur SoundCloud

ultrabeat V darren styles sure feels good ~with lyrics~ - YouTube

Brisk & Technikore - Hold Your Head Up - YouTube

Change (Technikore Remix) - Gregor Le Dahl feat Allison Gray - YouTube

SEMTEX LOCKDOWN LIVE STREAM SESSIONS VOL 4 CLASSIC UK HARDCORE par Dj Sem-tex Btid

Bonus

Warner DJ b2b Alvarez warming up with some hard stomping beats for all those hard dance lovers before the boys of the southwest Monster & Sketch on Harder South West at 7!!

Arkangel - I have done a quick skip through and there is a few spots of silence here and there, enjoy

DJC making the most of the lockdown doing a Live Stream from the garden

Traduction : "Si vous espérez qu’un vaccin vous sauvera la vie en tant que chevalier en armure, vous risquez d’être déçu"


Crédits illustration : 1 2

Traduction 3 de :

Thread Twitter en VO sur ThreadReader
Thread original sur twitter

  1. Si vous espérez qu’un vaccin vous sauvera la vie en tant que chevalier en armure, vous risquez d’être déçu. Le SARSCOV2 est un virus très contagieux. Un vaccin devra induire une immunité durable de haut niveau, mais les coronavirus n’induisent souvent pas ce type d’immunité

  2. Il y a une belle préimpression qui vient de sortir sur les réponses des anticorps au SARSCOV2. Beaucoup de gens ne développent pas beaucoup de réponse IgM et la réponse IgG s’estompe sensiblement après seulement deux mois

https://www.medrxiv.org/content/10.1101/2020.04.15.20066407v1.full.pdf

  1. Ceci est cohérent avec les autres coronavirus humains. Ils induisent une réponse immunitaire, mais celle-ci a tendance à s’estomper, de sorte que le même virus peut nous réinfecter un an ou deux plus tard. 3/

Coronavirus humain : Interaction hôte-pathogène L'infection par le coronavirus humain (HCoV) provoque des maladies respiratoires dont l'issue est de légère à sévère. Au cours des 15 dernières années, nous avons assisté à l'émergence de deux VHC zoonotiques et hautement pathogènes : les... https://www.annualreviews.org/doi/full/10.1146/annurev-micro-020518-115759

  1. Les expériences en matière de vaccins vétérinaires contre les coronavirus ne sont pas non plus très bonnes. Il existe des coronavirus économiquement importants qui infectent les animaux d’élevage et nous essayons de mettre au point de bons vaccins depuis des décennies. La plupart de ces vaccins sont putzy

COVID-19 du point de vue de la médecine vétérinaire et de la santé : Ce que les coronavirus animaux nous ont appris https://www.ncbi.nlm.nih.gov/pmc/articles/PMC7138383/

  1. Le problème est que le SARSCOV2 est un virus très contagieux. Alors que les estimations initiales pour le R0 étaient de l’ordre de ~2,5, des estimations plus récentes suggèrent qu’il est de l’ordre de 3 à 5, et certains individus semblent vraiment être des super-répandants qui répandent d’énormes quantités de virus

  2. Cela signifie qu’un vaccin devra être très efficace s’il veut arrêter la propagation du SRASCOV2. Les vaccins contre la polio, la rougeole et la variole sont des médicaments vraiment remarquables qui confèrent une immunité de haut niveau et durable, mais tous les vaccins ne sont pas aussi efficaces

  3. Les vaccins contre la grippe saisonnière ne sont efficaces qu’à environ 50 %, ce qui signifie qu’il existe toujours une chance sur deux de contracter la grippe même si vous avez été vacciné. Mais ne vous méprenez pas, les vaccins antigrippaux sauvent encore des milliers de vies. C’est parce que la grippe n’est pas si contagieuse, le R0 se situant dans la fourchette 1,4-1,7

  4. Ainsi, même si la moitié seulement de la population se fait vacciner contre la grippe et que le vaccin n’est efficace que la moitié du temps, nous ramenons encore l’infectivité effective à une fourchette de 1 à 1,3, ce qui signifie que le virus de la grippe se propage beaucoup moins rapidement, que beaucoup moins de personnes sont infectées et que des vies sont sauvées

  5. Mais le R0 pour le SRASCOV2 est de 3 à 5, de sorte qu’un vaccin dont l’efficacité diminue à 50 % laisserait encore une infectivité de 1,5 à 2,5. Et cela en supposant une vaccination à 100 %. Si seulement la moitié de la population acceptait la vaccination, l’infectiosité serait de 2,3 à 3,8. C’est assez contagieux

  6. En fin de compte, oui, nous espérons tous que nous mettrons rapidement au point un vaccin très efficace, mais la biologie du coronavirus et l’histoire des vaccins vétérinaires suggèrent qu’il pourrait s’agir d’un retard. Nous devons continuer à travailler sur les antiviraux, et nous devons nous préparer à un éloignement social prolongé

  7. addendum - Un espoir spéculatif est qu’un vaccin contre le SRASCOV2 réduira la gravité de la maladie même s’il n’empêche pas totalement l’infection. Les vaccins antigrippaux réduisent effectivement la gravité, mais il faudra voir sur le coronavirus cdc.gov/flu/spotlights…

  8. addendum Ce fil de discussion semble trop pessimiste. Il y a environ 75 candidats vaccins qui entrent dans les essais cliniques. Il faut espérer que certains d’entre eux seront couronnés de succès, et même s’ils ne font qu’atténuer les maladies graves et nécessitent un rappel annuel, ce serait quand même un grand succès

Pages

Subscribe to RSS - Le blog de Laurent Espitallier