Prévisualiser un fichier HTML sans l'exécuter
Un fichier .html, .htm ou .xhtml peut s'ouvrir dans un onglet d'aperçu. GitTree l'analyse sur votre ordinateur, supprime les scripts, les cadres et tout autre contenu actif, et affiche le reste dans un cadre en bac à sable sans réseau. Les styles en ligne et les images data: peuvent rester. L'aperçu n'exécute pas la page.
Fonctionne dans GitTree Gratuit : toutes les fonctionnalités Git locales, sans compte requis.
Sur cette page
Avant de commencer
- L'aperçu fait partie du plan gratuit. Le fichier se trouve dans le référentiel que vous avez ouvert ou il s'agit de la copie de travail de ce chemin.
- Vous voulez lire la page, pas l’exécuter. Une page qui dépend de scripts ou d'un réseau paraîtra incomplète. Il s'agit du bac à sable, pas d'un échec de chargement du référentiel.
Où le trouver
- Ouvrez le fichier à partir du navigateur de fichiers. Un chemin qui se termine par
.html,.htmou.xhtmlpeut s'ouvrir en aperçu, comme le peut Markdown. - Open Preview là où le menu du fichier le propose.
| Action | macOS | Windows et Linux |
|---|---|---|
| Concentrez la liste des fichiers | ⌘⇧E | Ctrl+Shift+E |
Mesures
Ouvrez le fichier
Dans la liste des fichiers, ouvrez la page. GitTree traite
.html,.htmet.xhtmlcomme des fichiers d'aperçu, avec Markdown. L'onglet affiche la page rendue plutôt que seulement la source. Basculez vers l’éditeur source lorsque vous souhaitez le texte.
Ouvrez un fichier HTML de cette liste. L'onglet Aperçu est la vue suivante. L'image fixe est la liste des fichiers.Interface GitTree avec un référentiel de démonstration. Lire la page en bac à sable
La politique du cadre est
default-src 'none'; style-src 'unsafe-inline'; img-src data:; font-src data:. Les scripts,base, les métas d'actualisation, les iframes, les cadres, les objets, les intégrations, les applets et les portails sont supprimés avant que le cadre ne voie le document. Les images distantes ne sont pas chargées. Un lien de feuille de style qui pointe vers un autre fichier du référentiel peut être intégré, jusqu'à 64 ressources.Remarquez quand la page a été réduite
Si des scripts ou du contenu distant ont été supprimés, la page est marquée comme réduite. Ce que vous voyez est le reste statique. Un lien qui aurait quitté le fichier n'est pas une navigation que GitTree effectuera à l'intérieur du cadre. Ouvrez la source pour lire la partie qui a été supprimée.
Modifiez la source, puis prévisualisez à nouveau
Modifiez le fichier dans l'éditeur et ouvrez à nouveau l'aperçu. L'analyseur s'exécute sur le texte dont vous disposez. Il ne récupère pas la page auprès d'un hôte. Validez le fichier à partir de la boîte de validation lorsque vous souhaitez modifier l'historique. L'aperçu ne valide pas.
Résultat attendu
L'onglet affiche la page statique : styles en ligne et ressources locales en ligne, sans scripts et sans accès réseau. Le référentiel est inchangé par l'aperçu. Utilisez l'onglet source pour confirmer qu'une balise attendue est toujours dans le fichier même si le cadre ne l'exécute pas.
Ce qui est supprimé
| Élément ou référence | Ce qui se produit |
|---|---|
| scénario | Supprimé. Il ne fonctionne pas. |
| iframe, cadre, objet, intégrer, applet, portail | Supprimé. Ils ne chargent pas. |
| base et méta rafraîchissement | Supprimé afin que le cadre ne puisse pas être reciblé. |
| URL d’une image ou d’une police distante | Non chargé. Seules les données : les images et les polices sont autorisées. |
| Feuille de style dans le référentiel | Inline lorsqu'il s'agit de l'un des 64 premiers éléments. |
La politique est la première chose qui nous vient à l’esprit, avant tout ce que la page a écrit. Une page ne peut que restreindre cette politique, pas l'élargir. L'analyse n'exécute pas la page et ne lit pas les fichiers qu'elle nomme jusqu'à ce que l'aperçu remplisse les éléments qu'il a décidé de conserver.
HTML et Markdown
La même règle « s'ouvre dans un onglet d'aperçu » couvre Markdown et ces extensions de page. Markdown est rendu sous forme de Markdown. Le HTML est analysé comme un document puis mis en bac à sable. Un fichier .html n'est pas transmis via le moteur de rendu Markdown. Ouvrir et modifier des fichiers est l'éditeur. L'aperçu est l'onglet supplémentaire.
git show HEAD:docs/index.html
git check-ignore -v docs/index.htmlgit show imprime le fichier validé. L'aperçu affiche la copie de travail lorsque c'est ce que vous avez ouvert. Les règles d'ignorance ne masquent pas un fichier déjà suivi. La leçon du tutoriel sur la lecture d'une différence explique comment comparer la source, que l'aperçu ne remplace pas.
Limites
Chaque actif correspond à une lecture et la page conserve au maximum 64 chemins. Les éléments passés restent tels que la page les contenait, sans être extraits. Une très grande page est analysée une fois par texte. Le remplissage des actifs ne l'analyse pas à nouveau. L'aperçu est volontairement hors ligne. Il ne correspondra pas à un navigateur autorisé à exécuter des scripts et à appeler un réseau.
Si quelque chose ne va pas
La page est vierge ou il manque sa mise en page.
Les styles peuvent provenir d'une feuille distante ou d'un script. Ceux-là ne sont pas chargés. Insérez les styles dans le référentiel, dans la limite de 64 actifs, ou lisez la source.
Il manque des images.
Les images distantes sont bloquées. Une image dans le référentiel s'affiche lorsqu'elle devient une URL data: à l'intérieur de la limite d'actifs. Vérifiez le chemin utilisé par la page. Un chemin qui quitte le référentiel est supprimé.
Un bouton ne fait rien.
Les scripts ont été supprimés. L'aperçu ne les exécute pas. Utilisez un navigateur de confiance si vous devez exécuter la page, et uniquement pour un fichier que vous avez lu.
L'aperçu ne correspond pas au fichier validé.
Vous regardez la copie de travail. git show HEAD:path imprime le texte validé. Validez ou supprimez si vous souhaitez que ceux-ci correspondent.
Questions
L'aperçu exécute-t-il JavaScript ?
Non, les éléments de script sont supprimés et la stratégie du cadre définit default-src sur none. La page n'est pas exécutée.
Est-ce qu'il charge les images du réseau ?
Non, img-src et font-src autorisent uniquement les données : les URL. Les images du référentiel sont intégrées en tant que données lorsqu'elles se situent dans la limite d'actifs.
Quelles extensions s'ouvrent sous forme de page ?
html, htm et xhtml. Markdown s'ouvre dans l'aperçu Markdown. D'autres fichiers s'ouvrent en tant que source ou en tant que diff.
Une page peut-elle desserrer le bac à sable ?
Non. La stratégie de trame est insérée en premier. Une page ne peut que la restreindre. Une méta-actualisation ou une URL de base est supprimée.
L'aperçu HTML est-il une fonctionnalité Pro ?
Non, cela fait partie du forfait gratuit, sans qu’aucun compte ne soit nécessaire.