Utiliser Pages Github
Aller à la navigation
Aller à la recherche
Le wiki : Accueil - Administrateur - Bureautique - Développeur - Intégrateur - Marketing - Multimédia - Objets numériques - Jeux - We make Hack
Utiliser Pages GitHub
Introduction à GitHub
GitHub permet de stocker les fichiers d'une application pour suivre l'évolution du code. GitHub affiche directement le code contenu dans les fichiers.
Il est nécessaire de savoir démarrer un nouveau dépôt et de pouvoir le cloner sur votre ordinateur. La documentation pour démarrer avec GitHub : https://help.github.com/articles/set-up-git/
Les applications officielles de GitHub pour Mac et Windows vous aideront en mode graphique : Source : https://desktop.github.com Des applications GNU/Linux en mode graphique existent également.
GitHub a annoncé le 7 janvier 2019 que les utilisateurs de son plan gratuit, GitHub Free, peuvent désormais créer un nombre illimité de référentiels privés, pour trois collaborateurs au maximum.
Collaboration avec Pages GitHub
Le principal avantage de Pages GitHub, c’est la collaboration. Les Pages GitHub permettent de stocker et d'afficher des fichiers.
Votre site hébergé sur GitHub est mis à jour avec votre dépôt GitHub et vos modifications vers le dépôt sont automatiquement synchronisées. Les fichiers HTML sont interprétés et affichés normalement, comme en production. Les langages comme PHP ou une base de données MySQL ne sont pas interprétés. Si nécessaire, il faut produire des fichiers HTML statiques.
Utiliser Jekyll pour produire des fichiers HTML statiques
Utiliser alors un outil de gabarit tel que Jekyll : http://jekyllrb.com https://help.github.com/articles/using-jekyll-as-a-static-site-generator-with-github-pages/ https://www.christopheducamp.com/2013/12/21/demarrer-avec-pages-github/
Transformer un dépôt existant en un site Pages GitHub
Créer un compte sur GitHub : https://github.com Créer un nouveau dépôt ou le nom du projet doit être UTILISATEUR.github.io Une fois le nouveau projet créé, il sera de la forme : https://github.com/UTILISATEUR/UTILISATEUR.github.io
Importer le projet localement avec un terminal
Créer un dossier qui contiendra votre page Github sur votre système. Se placer dans le dossier UTILISATEUR. Ouvrir un terminal.
Cloner le projet de votre page personnelle de Github dans le dossier UTILISATEUR. git clone https://github.com/ZerooCool/ZerooCool.github.io
Le répertoire ZerooCool.github.io apparaît en local dans le répertoire UTILISATEUR.
Créer et publier une page
Se placer dans ce répertoire. cd UTILISATEUR.github.io
Créer le premier fichier qui servira de page d'accueil. echo "Hello World" > index.html
Ajouter le commit et pousser les changements. git add --all git commit -m "Message pour le commit" git push -u origin master
Renseigner l'identifiant de GitHub puis le mot de passe. Le fichier index.html est ajouté dans le répertoire de travail de GitHub. Consulter votre page GitHub : https://UTILISATEUR.github.io
Ajouter ou supprimer des fichiers sur la page
# Les prochains changements dans le dossier local vont être ajoutés ou supprimés dans le répertoire de travail de GitHub. # Relancer les étapes suivantes pour appliquer les changements : add commit push
######################################################################################## Consulter la page GitHub de ZerooCool : https://ZerooCool.github.io Le dépôt est disponible depuis GitHub : https://github.com/ZerooCool/ZerooCool.github.io ########################################################################################
Source : https://pages.github.com
Source complémentaire : https://gist.github.com/chrisjacob/825950
Ajouter des images dans le fichier README de GitHub
Sur l'interface web de GitHub, créer une nouvelle issue (Issues > new issue). Sur cette interface pour rédiger une issue, on peut insérer des images. Une fois qu'elle est créée, on peut faire un clic droit sur une des images et sélectionner "Copier l'url de l'image".
Dans le fichier readme.md on ajoute alors le code suivant, pour intégrer l'image :  Par exemple : 
Ajouter un nom de domaine à sa page GitHub
Using a custom domain with GitHub Pages : https://help.github.com/articles/using-a-custom-domain-with-github-pages/
Pour les développeurs de GitHub
Des commandes et paramètres pour les développeurs de GitHub. Source : https://developer.github.com/v3/repos/#list-your-repositories
Connecter une application à GitHub
Cloner depuis Github pour pouvoir pousser vers Github
Cloner un PROJET de Github dans le dossier STOCKAGE
Se placer dans le bon dossier sur la machine Linux : ~/CHEMIN/DE/STOCKAGE/ git clone https://github.com/UTILISATEUR/PROJET.git S'identifier : UtilisateurGithub MotDePasseGithub
# Se placer dans le projet cloné. ~/CHEMIN/DE/STOCKAGE/PROJET
# Ajouter les nouveaux fichiers. # Les prendre en compte avec : git add . # Valider la prise en compte avec un commit en ajouteant un commentaire. git commit -m "Première version stable."
# Définir " le lien vers ou pousser ". git remote add origin https://github.com/USER/PROJET.git
# Pousse les éléments après un commit. git push origin master
# Avant de faire le prochain git add, vérifier si des modifications ont été apportées sur le repo distant. # Permet de récupérer les modifications depuis le repo de Github. # Si des données ont été modifiées, cela va entrainer un merge. # git pull origin master
Ajouter une nouvelle branche de travail
# Créer une branche developpement depuis le projet dans Github.
# Créer une branche developpement depuis le dossier contenant le projet en local. git branch developpement
# Basculer vers la branche de developpement git checkout developpement
# Faire des modification, et, les prendre en compte, puis les pousser dans le PROJET Github. git add . git commit -m "Cause du dépôt." git push origin developpement
# Modifier le contenu du dossier en local pour effectuer les modifications dans le PROJET Github. git add . git commit -m "Neuvième version développement." git push origin developpement
# Revenir à la branche master git checkout master
############################## Ne pas ce tromper de branche ! ##############################
Voir à vérifier la branche courante avant de pousser les modifications.
Sponsors Github
# Permet de recevoir des donations suite à l'inscription de sponsors.
# Modifier le nom d'utilisateur pour consulter votre propre page : https://github.com/sponsors/ZerooCool/dashboard # Valider les étapes nécessaires pour s'inscrire au programme Sponsors Github. # Le certificat W-8BEN doit être renseigné : https://www.td.com/francais/document/PDF/W-8BEN%20French.pdf # Informations sur le certificat W-8BEN : https://www.td.com/francais/document/PDF/W-8BEN-E+French+Instructions.pdf # Le document américain est requis car GitHub est basé aux États-Unis et nous vous émettrons des paiements. # Le document W-8BEN vise précisément à éviter la double imposition. Vous pouvez en savoir plus sur le formulaire et son objet ici : https://www.investopedia.com/terms/w/w8form.asp
# Notes complémentaires, le guide du Mecenat, pour les français : https://www.femis.fr/IMG/pdf/guide_mecenat_2011.pdf
# Soumettre la demande au personnel de GitHub pour approbation.
# Une fois votre page de parrainage approuvée, le bouton de parrain apparaîtra sur le profil utilisateur de @ZerooCool. https://github.com/ZerooCool https://github.com/sponsors/ZerooCool?preview=true
# Vous pouvez également activer le bouton sponsor sur tous les référentiels @ZerooCool en créant et en activant un fichier .github/FUNDING.yml. Source : https://help.github.com/en/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository
Exemple : https://github.com/denyhosts/denyhosts/blob/master/.github/FUNDING.yml # These are supported funding model platforms #github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2] github: [josev814,adriel,ZerooCool] patreon: # Replace with a single Patreon username open_collective: # Replace with a single Open Collective username ko_fi: # Replace with a single Ko-fi username tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry liberapay: # Replace with a single Liberapay username issuehunt: # Replace with a single IssueHunt username otechie: # Replace with a single Otechie username custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
Afficher son profil Github sur son site
Dépôt Github officiel : https://github.com/lepture/github-cards Exemple : https://lab.lepture.com/github-cards/#ZerooCool%7Cmedium
Rendu sur Visionduweb : https://www.visionduweb.fr/blog/13-programmation/71-le-github-de-zeroocool Requête : L'image de fond ne s'affiche pas : https://github.com/lepture/github-cards/issues/67 Comment afficher cette image : https://www.visionduweb.fr/partage/github-card.jpg
# Depuis l'intégration HTML dans le site, je remplace le thème medium par default pour ne pas rencontrer le problème de l'absence de l'image. # Avec la version de thème default, on remarque un problème de langue "Available for hire." que je préférerais avoir en français. # Le rendu visuel avec un entête semblait intéressant. # En attente d'un retour éventuel du développeur.
Bibliographie
Une alternative à un projet Github est l'utilisation de Gist
# Gist permet de ne travailler que sur un seul fichier : https://gist.github.com
Notes complémentaires
Alternatives à Github
CVS
Outil historique pour la gestion centralisée de dépôts. Licence GPL.
FramaGit de FramaSoft
Les chatons utilisent Framagit qui est un GitHub libre : https://framagit.org/public/projects
Trois projets partagés par Vision du web : BitcoinQRCode est fonctionnel : https://framagit.org/Chat0nCooL/BitcoinQRCode.org mod_BitcoinFaucet affiche simplement des sites pour gagner des Bitcoins : https://framagit.org/Chat0nCooL/mod_bitcoinfaucet mod_github_repos est à améliorer avec un classement par date de modification : https://framagit.org/Chat0nCooL/mod_github_repos
Gitlab
Site officiel : https://about.gitlab.com Documentation sur Gitlab : https://docs.gitlab.com Installer Gitlab : https://about.gitlab.com/installation/
Ressources complémentaires : https://perhonen.fr/blog/2015/03/installer-gitlab-1254
Gogs
Installer l'application depuis le site officiel pour utiliser votre GIT auto-hébergé. Créer un compte depuis le site officiel et l'activer sous trois heures. Le site officiel de Gogs : https://gogs.io
Extraire l'archive. cd gogs Exécuter ./gogs web
Aller sur le navigateur à l’adresse http://0.0.0.0:3000 pour finaliser l'installation du service.
Mercurial
Git signifie que vous n’aurez jamais à dire, « j’aurais du / si j’avais su », cela peut arriver avec Mercurial. Licence GPL.
NPM
NPM is the package manager for javascript. Le site officiel de NPM : https://www.npmjs.com
Log in at https://go.npm.me/login If you ever forget your password, you can reset it at https://go.npm.me/forgot Everything — from the basics of publishing & installing with the command-line interface, to the juicy stuff like scopes & teams — is here: https://go.npm.me/docs Have a question? Run into trouble? Create a support ticket at https://go.npm.me/support
Subversion
Outil qui apporte des améliorations à CVS. De plus en plus abandonné au profit de Git. Reste très utilisé dans les entreprises qui gèrent du code fermé. Licence Apache/BSD.
Site officiel : https://subversion.apache.org
NAVIGATION
PARTICIPER ET PARTAGERBienvenue sur le wiki de Amis SH. De nombreuses pages sont partagées sur ce wiki. Créer un compte utilisateur pour participer sur le wiki. Les pages présentées sur le wiki évoluent tous les jours. Certaines recherches sont peu abouties et incluent des erreurs. Utiliser la recherche interne du wiki pour trouver votre contenu. La page de discussion de Amis SH vous permet de poser vos questions. Consulter le site amis-sh.fr pour installer votre propre serveur web. Améliorer le contenu des pages avec vos retours depuis l'onglet discussion. Ce contenu ne doit pas servir à nuire à autrui ou à un système informatique. Protéger votre système Linux ou Windows avec cette page dédiée à la sécurité. |
SOUTENIR CE WIKISoutenir le wiki avec un don en monnaie numérique : AEON - Bitcoins - Bitcoins Cash - Bitcoins Gold - Bitcore - Blackcoins - Basic Attention Token - Bytecoins - Clams - Dash - Monero - Dogecoins - Ğ1 - Ethereum - Ethereum Classique - Litecoins - Potcoins - Solarcoins - Zcash OBTENIR DE LA MONNAIE NUMERIQUEObtenir gratuitement de la monnaie numérique : Miner de la cryptomonnaie. |