Comment utiliser les commentaires disqus dans le blog des pages github (Markdown)?

Est-il possible d’intégrer des commentaires HTML dans un blog en utilisant des pages github? J’aime l’idée d’utiliser github, jekyll et markdown pour gérer mon site et mon blog pour plus de simplicité. Cependant, je voudrais inclure la capacité de commentaire de disqus. Cependant, puisque le markdown génère le code HTML, comment inclure le code HTML / js pour les requêtes?

La manière la plus simple et la plus simple de le faire est de créer une partie avec le code HTML fourni dans votre dossier _includes/ (par exemple _includes/disqus.html ), puis de l’inclure simplement dans votre fichier de mise en page (par exemple, _layouts/post.md ). :

 {% include disqus.html %} 

Vous pouvez voir un exemple ici: post layout et disqus partial .

Il y a un moyen “officiel” pour accomplir cette tâche. Vous pouvez trouver l’indication Disqus sur ce lien.

Dans les détails, la procédure est la suivante:

Ajoutez une variable appelée comments à l’object YAML Front Matter (c’est-à-dire l’en-tête de votre fichier de publication) et définissez sa valeur sur true . Un exemple de sujet pourrait ressembler à ceci:

 layout: default comments: true # other options 

Créez un nouveau fichier de modèle (c.-à-d. disqus.html ) et mettez-y le code d’ disqus.html universel , entre % if page.comments % et % endif %

Incluez le fichier disqus.html dans votre modèle de publication.

J’espère que cela aide 🙂

Incluez le commentaire disqus dans votre post.html et définissez un identifiant pour le lien de décompte des commentaires:

 

Dans votre template default.html , incluez le script de décompte des commentaires:

  

Ajoutez ensuite le lien aux commentaires en utilisant l’atsortingbut data-disqus-identifier , de sorte que le nombre de commentaires apparaisse après chaque publication de la page principale de votre blog:

 Leave a comment 

Ouvrez config.yml et ajoutez la ligne de code disqus_shortname: username . Remplacez le username d’ username par votre username abrégé Disqus.

Créez un fichier appelé disqus_comments.html dans le dossier _includes de Jekyll et ajoutez votre code d’incorporation universel Disqus entre une balise liquide {% if page.comments %} et une balise liquide {% endif %}

 {% raw %}{% if page.comments != false %} 
{% endif %}{% endraw %}

Vous ajoutez simplement des comments: false dans tous les messages avant-propos pour désactiver ces commentaires.

Enfin, ouvrez votre fichier post.html et ajoutez la balise include liquide suivante juste après la end .

 {% if site.disqus_shortname %} {% include disqus_comments.html %} {% endif %} 

Vous pouvez suivre mon article de blog détaillé sur la façon d’ append des commentaires Disqus à Jekyll si vous êtes bloqué.

Pour résumer:

  1. Utiliser le service de commentaires 3ème Disqus, créer un son compte
  2. Associez votre site, c’est-à-dire votre site github, avec des disqus
  3. Obtenir le nom abrégé Disqus dans admin/settings/general/
  4. Modifiez votre _config.yml de github, assurez-vous qu’il contient le contenu suivant:
 disqus: shortname:  
  1. Assurez-vous qu’il y a disqus.html sous _includes et que cela ressemble à:

     {% if page.comments %} 
    {% endif %}
    1. Inclure disqus.html dans _layouts/post.html

    2. Pour activer le commentaire, ajoutez des comments:true sur votre sujet avant l’article. Désactivez-le en définissant des comments: false ou en n’incluant pas du tout l’option commentaires.

C’est vrai que Jekyll rendra du HTML à partir de vos fichiers Markdown (en utilisant localement Jekyll ou à distance en poussant sur des pages gh). Cependant, cela n’a pas vraiment d’importance car ce type de code doit être dans une couche, donc pas dans le fichier source Markdown.

 _layouts `- default.html `- post.html <- `layout: default` in the YAML header _posts `- YYYY-MM-DD-my-post.md <- `layout: post` in the YAML header 

En suivant cette arborescence, vous pourrez rendre vos fichiers Markdown en utilisant votre mise en page, qui peut contenir votre script Disqus.