Maison  >  Article  >  outils de développement  >  Comment écrire un blog github

Comment écrire un blog github

WBOY
WBOYoriginal
2023-05-17 09:42:07790parcourir

GitHub est la plus grande communauté open source au monde, personne. Il fournit non seulement la plus grande plate-forme d'hébergement de code au monde, mais également une communauté open source où les développeurs peuvent publier leurs propres projets open source et participer à la contribution et à la maintenance des projets open source.

Le blog GitHub est un blog statique construit sur GitHub à l'aide de Jekyll et de GitHub Pages. Il prend en charge la syntaxe Markdown et constitue un bon choix pour les rédacteurs techniques et les programmeurs. Comment créer votre propre blog sur GitHub ? Examinons-le étape par étape.

  1. Créer un référentiel

Entrez d'abord votre compte GitHub, cliquez sur le "+" en haut à droite, sélectionnez "Nouveau référentiel", puis dans l'entrepôt Lors de la dénomination, le format est "username.github.io", où "username" est votre nom d'utilisateur sur GitHub. Par exemple, mon nom d'utilisateur GitHub est "DongXXI", alors l'entrepôt créé est nommé "DongXXI.github.io". ".

  1. Installez les pages Jekyll et GitHub

Installez les pages Jekyll et GitHub localement, cela est nécessaire pour prévisualiser votre propre blog localement et mettre à jour l'état du blog . GitHub Pages prend en charge l'installation de Jekyll. Vous pouvez suivre la documentation officielle pour l'installation. Une fois l'installation terminée, vous pouvez utiliser Jekyll pour créer un nouveau modèle et créer un blog localement.

Remarque : Si vous utilisez un système Windows, les étapes d'installation de Jekyll peuvent être légèrement différentes. Veuillez vous référer au site officiel de Jekyll.

  1. Créer un modèle de blog

Vous pouvez directement modifier ou utiliser le modèle Jekyll créé par d'autres lors de l'aperçu local

Comment créer votre propre blog sur GitHub ? Examinons-le étape par étape.

Board, en utilisant la syntaxe Markdown. Dans Jekyll, le modèle est principalement divisé en les parties suivantes :

  • YAML informations d'en-tête : contient des informations sur les métadonnées de l'article de blog, telles que le titre, la date, l'auteur, etc.
  • Texte du blog : écrit en utilisant la syntaxe Markdown, utilisé pour créer le contenu principal de l'article de blog.
  • Structure du blog : généralement la navigation du blog, les balises du bas et autres contenus HTML.

Vous pouvez télécharger des modèles prêts à l'emploi depuis GitHub, ou vous pouvez personnaliser un modèle vous-même et le créer à partir de zéro.

  1. Téléchargez le modèle dans le référentiel GitHub

Après avoir modifié le modèle de blog localement, transférez les fichiers modifiés vers le référentiel GitHub pour terminer le téléchargement . Exécutez localement la commande suivante :

git add .
git commit -m "first commit"
git push origin main

pour transférer le modèle de blog local vers GitHub.

  1. Configurer les pages GitHub

Ouvrez la page de l'entrepôt GitHub, cliquez sur "Paramètres", sélectionnez le thème et la source de la version dans "Pages GitHub", la valeur par défaut Pour utiliser le « dossier master brunch / docs », vous pouvez sélectionner « brunch principal » et cliquer sur « Enregistrer ».

  1. Visitez le blog

Une fois le modèle de blog téléchargé avec succès sur GitHub, saisissez « https://username.github.io » dans le navigateur Vous pouvez accéder au blog. Si aucun nom de domaine n'est spécifiquement défini, le nom du blog est le nom d'utilisateur.

  1. Personnalisez votre propre thème de blog

Les étapes ci-dessus sont presque suffisantes pour créer votre propre blog, mais si vous souhaitez rendre votre blog plus unique, vous pouvez trouver des thèmes de blog gratuits ou payants sur GitHub, tels que les thèmes de page d'accueil jekyll, les thèmes jekyll-stress, etc. Vous pouvez trouver de nombreux thèmes prêts à l'emploi en recherchant des thèmes jekyll sur GitHub.

Une fois la sélection terminée, téléchargez-la localement, puis téléchargez-la sur les pages GitHub. Notez que certains thèmes peuvent nécessiter l'installation de certains plug-ins, qui doivent être installés conformément aux instructions d'installation fournies par le thème.

Résumé

Jusqu'à présent, nous avons appris à créer notre propre blog sur GitHub. Bien que cette méthode ne soit pas aussi pratique qu'une plateforme de blogs générale, elle est plus gratuite. , moyen indépendant et plus pratique de maintenance et de mise à niveau. Alors chérissez la vie, évitez les bavardages et allez l’essayer !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Déclaration:
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn
Article précédent:Que signifie github ?Article suivant:Que signifie github ?