499 votes

Comment voir une page HTML sur Github comme une page HTML rendue normale pour voir un aperçu dans le navigateur, sans téléchargement ?

Sur http://github.com Le développeur conserve les fichiers HTML, CSS, JavaScript et images du projet. Comment puis-je voir la sortie HTML dans le navigateur ?

Par exemple ceci : https://github.com/necolas/css3-social-signin-buttons/blob/master/index.html

Quand je l'ouvre, il ne montre pas le HTML rendu du code de l'auteur. Il montre la page comme un code source.

Est-il possible de le voir directement en HTML rendu ? Sinon, je dois toujours télécharger le ZIP complet pour voir le résultat.

4 votes

À partir de juin 2019, raw.githack.com semble être la solution la plus pratique (voir les réponses aux questions suivantes question liée ci-dessus )

5 votes

C'est un très vieux sujet, mais le fait que ce problème ne soit pas immédiatement évident et facile à résoudre sur le site de github est insensé.

611voto

niutech Points 5023

La façon la plus confortable de prévisualiser les fichiers HTML sur GitHub est de se rendre à l'adresse suivante https://htmlpreview.github.io/ ou simplement le faire précéder de l'URL original, c'est-à-dire : https://htmlpreview.github.io/?https://github.com/bartaz/impress.js/blob/master/index.html

0 votes

@Denis : Quel navigateur et quelle URL utilisez-vous ? Pour l'instant, il ne prend en charge que les navigateurs Webkit et Gecko.

0 votes

@Denis : Désolé, Firefox 3.6 est trop vieux pour être pris en charge. Cela dit, vous pouvez ouvrir Firebug et essayer de le déboguer, si vous êtes déterminé.

0 votes

Une idée de comment faire cela sur un repo privé ? Je ne veux pas coller mon URL privée avec un jeton dans cet outil, mais c'est un bon outil.

113voto

Ross Points 19037

Si vous ne voulez pas télécharger une archive, vous pouvez utiliser Pages GitHub pour rendre cela.

  1. Fork le référentiel à votre compte.
  2. Clonez-le localement sur votre machine
  3. Créer un gh-pages (s'il en existe déjà une, supprimez-la et créez-en une nouvelle basée sur la branche master ).
  4. Repoussez la branche sur GitHub.
  5. Consultez les pages à l'adresse suivante http://username.github.io/repo `

En code :

git clone git@github.com:username/repo.git
cd repo
git branch gh-pages
# Might need to do this first: git branch -D gh-pages
git push -u origin gh-pages # Push the new branch back to github
Go to http://username.github.io/repo

0 votes

J'ai bifurqué un projet maintenant comment je peux le copier sur les pages github.

1 votes

J'ai mis à jour ma réponse avec un processus.

3 votes

69voto

Julien Carsique Points 1023

Vous pouvez utiliser RawGit :
https://rawgit.com/necolas/css3-social-signin-buttons/master/index.html

Il fonctionne mieux (au moment de la rédaction de cet article) que http://htmlpreview.github.com/ pour servir les fichiers avec des en-têtes Content-Type appropriés. En outre, il fournit également l'URL du CDN pour une utilisation en production.

2 votes

Je confirme qu'il fonctionne mieux que htmlpreview. Au moins, il montre mes animations WebGL.

1 votes

Cela fonctionne plus rapidement en fait, et avec Bokeh ( par exemple ), il montre certaines des interactions (par exemple, les infobulles) qui ne fonctionnent pas avec htmlpreview.

0 votes

Comme htmlpreview, ne fonctionne pas avec les dépôts privés. Git rend les URLs de ces derniers comme des URLs publiques en ajoutant ?token=<hash>, mais ces outils devraient le comprendre et le passer à GH avec le reste.

45voto

hendrikswan Points 568

C'est très facile à faire avec pages github c'est juste un peu bizarre la première fois que tu le fais. Un peu comme la première fois que vous avez dû jongler avec 3 chatons en apprenant à tricoter. (OK, ce n'est pas si mal)

Vous avez besoin d'une branche gh-pages :

En gros, github.com recherche un gh-pages branche du dépôt. Il servira toutes les pages HTML qu'il trouve ici en tant que HTML normal directement au navigateur.

Comment obtenir cette branche de gh-pages ?

Facile. Il suffit de créer une branche de votre dépôt github appelée gh-pages . Spécifiez --orphan lorsque vous créez cette branche, car vous ne voulez pas réellement fusionner cette branche dans votre branche github, vous voulez juste une branche qui contient vos ressources HTML.

$ git checkout --orphan gh-pages

Qu'en est-il de tous les autres éléments de mon répertoire, comment s'intègrent-ils ?

Nan, tu peux juste aller de l'avant et le supprimer. Et vous pouvez le faire en toute sécurité maintenant, car vous avez fait attention et créé une branche orpheline qui ne peut pas être fusionnée dans votre branche principale et supprimer tout votre code.

J'ai créé la branche, et maintenant ?

Vous devez pousser cette branche vers github.com, afin que l'automatisation se mette en marche et commence à héberger ces pages pour vous.

git push -u origin gh-pages

Mais Mon HTML n'est toujours pas servi !

Il faut quelques minutes à github pour indexer ces branches et lancer l'infrastructure nécessaire pour servir le contenu. Jusqu'à 10 minutes selon github.

Les étapes présentées par github.com

https://help.github.com/articles/creating-project-pages-manually

3 votes

Il fonctionne très bien. Comme un noob git, j'ai oublié de $ git commit -m 'init' entre vos lignes.

1 votes

Quelle sera l'URL ?

0 votes

Hmm ... pas sûr que ce soit beaucoup plus facile que de jongler avec des chatons ...

21voto

Mukesh Points 129

J'ai lu tous les commentaires et j'ai pensé que GitHub rendait trop difficile pour un utilisateur normal de créer des pages GitHub jusqu'à ce que je visite Page du thème GitHub où il est clairement mentionné qu'il y a une section "Pages GitHub" sous la page des paramètres du repo concerné où vous pouvez choisir l'option "utiliser la branche principale pour les pages GitHub" et voilà ! https://username.github.io/reponame

screenshot to support my answer

1 votes

Il s'agit désormais d'un produit payant uniquement si vous utilisez un dépôt privé. Il est disponible pour les dépôts publics.

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

X