Comprendre le Web

Tidy

Installation de tidy.exe

fr.wikipedia.org/wiki/HTML_Tidy
Installation de tidy.exe => binaries.html-tidy.org/
Télécharger : tidy-5.8.0-win64.exe
SHA256 : 4202bad43dca64494f3968b8e0d2af151755a02e04c3bfa280f0bc64a1377eef

avertissement de Windows : Risque
=> le fichier se trouve dans le dossier de téléchargement
avec l'extension .crdownload (pour critical download)

=> Conserver > Afficher + > Conserver quand même

Précaution 1 : Avant de l'ouvrir/lancer/exécuter, le passer à l'anti-virus

Précaution 2 : Avant de l'ouvrir/lancer/exécuter, comparer la signature
(inutile si le téléchargement se fait depuis le site qui affiche le SHA 256)

Tapez "cmd" (+ Enter) dans la barre "Ce Pc > Téléchargement"
s'affiche la console DOS
Copier/Coller : certUtil -hashfile tidy-5.8.0-win64.exe SHA256 (+ Enter)
Comparer la signature (celle affichée dans la console par rapport à celle affichée sur le site)

Tapez "exit" (+ Enter) pour quitter la console

Exécuter tidy-5.8.0-win64.exe
s'affiche : Microsoft Defender SmartScreen a empêché le démarrage d’une application non reconnue ...

Cliquer sur "Exécuter quand même"
Demande de votre code Utilisateur/Administrateur sous Windows

La fenêtre d'installation du programme s'affiche
Suivant > J'accepte >

          

Dossier d'installation par défaut : C:\Program Files\tidy 5.8.0
Suivant >

Dossier du menu démarrer (raccourci) : tidy 5.8.0
Installer

Fenêtre de fin de l'installation :
Fermer

avec Visual Studio Code

github.com/AnWeber/vscode-tidyhtml

Ouvrir Visual Studio Code

Click on "Extension"
 > install vscode-tidyhtml (16698 ème téléchargement = 3 sept 2021)

Cliquer sur "Extension" (icône dans la barre de gauche)
> vscode-tidyhtml > Gérer (roue dentée, à droite de "Désinstaller")
> paramètre d'extension
> Tidy Exec Path

C:\Program Files\tidy 5.8.0\bin\tidy.exe

Fermer Visual Studio Code (précaution peut-être pas nécessaire, mais au cas où ...)

Ouvrir Visual Studio Code

Clic droit dans un fichier HTML
> Mettre en forme le document avec ...
Sélectionner "vscode-tidyhtml"

NB : La mise en forme est instantannée.
Ctrl + Z, si elle ne vous plait pas.

Pour modifier le comportement de Tidy =>
Cliquer sur "Extension" (icône dans la barre de gauche)
> vscode-tidyhtml > Gérer (roue dentée, à droite de "Désinstaller")
> paramètre d'extension
> Options Tidy > Cliquez sur "Modifier settings.json"

Par défaut (lors de l'installation de vscode-tidyhtml) =

 {
    "markup": true,
    "output-xml": false,
    "input-xml": true,
    "show-warnings": true,
    "show-errors": 6,
    "numeric-entities": false,
    "quote-marks": false,
    "quote-nbsp": true,
    "quote-ampersand": false,
    "break-before-br": false,
    "preserve-entities": true,
    "uppercase-tags": false,
    "uppercase-attributes": false,
    "indent": "auto",
    "indent-with-tabs": false,
    "indent-attributes": true,
    "sort-attributes": "alpha",
    "wrap": 250
}

S'inspirer de la documentation :

api.html-tidy.org/tidy/quickref_5.8.0.html

Valeurs par défaut et ordre donné dans la documentation :

{
"gnu-emacs": false,
"markup": true,
"mute": "",
"mute-id": false,
"quiet": false,
"show-body-only": false,
"show-errors": 6,
"show-filename": false,
"show-info": true,
"show-warnings": true,
"add-meta-charset": false,
"add-xml-decl": false,
"add-xml-space": false,
"doctype": "auto",
"input-xml": false,
"output-html": false,
"output-xhtml": false,
"output-xml": false,
"error-file": "",
"keep-time": false,
"output-file": "",
"write-back": false,
"accessibility-check": 0,
"force-output": false,
"show-meta-change": false,
"warn-proprietary-attributes": true,
"char-encoding": "utf8",
"input-encoding": "utf8",
"newline": "LF",
"output-bom": "auto",
"output-encoding": "utf8",
"bare": false,
"clean": false,
"drop-empty-elements": false,
"drop-empty-paras": true,
"drop-proprietary-attributes": false,
"gdoc": false,
"logical-emphasis": false,
"merge-divs": "auto",
"merge-spans": "auto",
"word-2000": false,
"ascii-chars": false,
"ncr": true,
"numeric-entities": false,
"preserve-entities": false,
"quote-ampersand": true,
"quote-marks": false,
"quote-nbsp": true,
"alt-text": "",
"anchor-as-name": true,
"assume-xml-procins": false,
"coerce-endtags": true,
"css-prefix": "c",
"custom-tags": "no",
"enclose-block-text": false,
"enclose-text": false,
"escape-scripts": true,
"fix-backslash": true,
"fix-bad-comments": "auto",
"fix-style-tags": true,
"fix-uri": true,
"literal-attributes": false,
"lower-literals": true,
"repeated-attributes": "keep-last",
"skip-nested": true,
"strict-tags-attributes": true,
"uppercase-attributes": "no",
"uppercase-tags": false,
"decorate-inferred-ul": false,
"escape-cdata": false,
"hide-comments": false,
"join-classes": false,
"join-styles": true,
"merge-emphasis": true,
"replace-color": false,
"new-blocklevel-tags": "",
"new-empty-tags": "",
"new-inline-tags": "",
"new-pre-tags": "",
"break-before-br": false,
"indent": "no",
"indent-attributes": false,
"indent-cdata": false,
"indent-spaces": 2,
"indent-with-tabs": false,
"keep-tabs": false,
"omit-optional-tags": false,
"priority-attributes": "",
"punctuation-wrap": false,
"sort-attributes": "none",
"tab-size": 8,
"tidy-mark": true,
"vertical-space": "no",
"wrap": 68,
"wrap-asp": true,
"wrap-attributes": false,
"wrap-jste": true,
"wrap-php": false,
"wrap-script-literals": false,
"wrap-sections": true
}
Mes options :

{
"gnu-emacs": false,
"markup": true,
"mute": "",
"mute-id": false,
"quiet": false,
"show-body-only": false,
"show-errors": 6,
"show-filename": false,
"show-info": true,
"show-warnings": true,
"add-meta-charset": false,
"add-xml-decl": false,
"add-xml-space": false,
"doctype": "auto",
"input-xml": false,
"output-html": false,
"output-xhtml": true,
"output-xml": false,
"error-file": "",
"keep-time": true,
"output-file": "",
"write-back": true,
"accessibility-check": 0,
"force-output": false,
"show-meta-change": false,
"warn-proprietary-attributes": true,
"char-encoding": "utf8",
"input-encoding": "utf8",
"newline": "LF",
"output-bom": "auto",
"output-encoding": "utf8",
"bare": false,
"clean": false,
"drop-empty-elements": false,
"drop-empty-paras": true,
"drop-proprietary-attributes": false,
"gdoc": false,
"logical-emphasis": false,
"merge-divs": "auto",
"merge-spans": "auto",
"word-2000": false,
"ascii-chars": false,
"ncr": true,
"numeric-entities": false,
"preserve-entities": true,
"quote-ampersand": true,
"quote-marks": false,
"quote-nbsp": true,
"alt-text": "",
"anchor-as-name": true,
"assume-xml-procins": false,
"coerce-endtags": true,
"css-prefix": "c",
"custom-tags": "no",
"enclose-block-text": false,
"enclose-text": false,
"escape-scripts": true,
"fix-backslash": true,
"fix-bad-comments": "auto",
"fix-style-tags": true,
"fix-uri": true,
"literal-attributes": false,
"lower-literals": true,
"repeated-attributes": "keep-last",
"skip-nested": true,
"strict-tags-attributes": true,
"uppercase-attributes": "no",
"uppercase-tags": false,
"decorate-inferred-ul": false,
"escape-cdata": false,
"hide-comments": false,
"join-classes": false,
"join-styles": true,
"merge-emphasis": true,
"replace-color": false,
"new-blocklevel-tags": "",
"new-empty-tags": "",
"new-inline-tags": "",
"new-pre-tags": "",
"break-before-br": false,
"indent": "no",
"indent-attributes": false,
"indent-cdata": false,
"indent-spaces": 2,
"indent-with-tabs": false,
"keep-tabs": false,
"omit-optional-tags": false,
"priority-attributes": "",
"punctuation-wrap": false,
"sort-attributes": "none",
"tab-size": 8,
"tidy-mark": true,
"vertical-space": "no",
"wrap": 68,
"wrap-asp": true,
"wrap-attributes": false,
"wrap-jste": true,
"wrap-php": true,
"wrap-script-literals": false,
"wrap-sections": true
}
Documentation :
api.html-tidy.org/tidy/quickref_5.8.0.html

If you don't like your new code : Ctrl + Z
(and change the options)

avec RapidPHP 2015

C:\Program Files (x86)\Rapid PHP 2015\tidy\tidy.exe
(654.336 octets, 2018-03-11 ‏‎04:14:52)

Attention : À juste titre, Tidy nettoye (enlève) les attributs non HTML, tels que ceux utilisés par le frameworks vue.js commençant par @

Documentation pour configurer Tidy

Ce qu'en dit RapidPHP

  • fix-bad-comments, s'il est coché, remplace
    <!-- -- --> par <!-- == -->

    Si cette option est cochée, le code PHP mis en commentaire HTML remplacera la variable i, i--, par i==, ce qui provoquera une erreur lorsque le commentaire HTML englobant le code PHP sera retiré.

    HTML Tidy may not work properly with some PHP files.

Captures d'écran

Valeurs utilisées (18 avril 2020) avec RapidPHP

replace-color peut être coché pour remplacer le nom d'une couleur par sa valeur hexadécimale. Ceci peut être utile lorsque le navigateur web est rudimentaire comme dans un webmail.