Github: Comment intégrer un aperçu dans README.md?

Est-il possible d’incorporer des gits dans le fichier README.md qui réside dans un repository github?

Quelque chose comme:

 

Mise à jour: Ma réponse fonctionne avec des pages github, construites via jekyll. J’utilise les balises script en markdown qui sont ensuite traitées par jekyll.

Comme le markdown supporte le HTML, on peut simplement utiliser la pour incorporer gist.

Copiez simplement l'URL d'intégration de l'essentiel fourni par github

entrer la description de l'image ici

..et le coller dans votre fichier de démarquage.

Exemple: Copiez le ci-dessous et collez-le dans votre fichier de démarquage.

..et c'est ce que vous obtiendrez

entrer la description de l'image ici

Non, désolé, ce n’est pas possible. Vous devrez soit avoir un lien vers celui-ci dans votre fichier README.md ou copier son contenu.

Github Flavored Markdown vous montrera ce que vous pouvez mettre dans votre fichier README.md.

Vous pouvez le faire si vous utilisez un préprocesseur Markdown tel que Gitdown :

 /** * Resolve Gist (https://gist.github.com/) * * @param {Object} config * @param {Ssortingng} config.id Gist ID. * @param {Ssortingng} config.fileName Gist file name. Default to gistfile1.txt. */ gitdown.registerHelper('gist', { comstack: function (config) { config = config || {}; config.fileName = config.fileName || 'gistfile1.txt'; if (!config.id) { throw new Error('Gist ID must be provided.'); } return new Promise(function (resolve) { var https = require('https'); https.get({ host: 'api.github.com', path: '/gists/' + config.id, headers: { // User agent is required to communicate with Github API. 'user-agent': 'Gitdown – gist' } }, function(res) { var body = ''; res.setEncoding('utf8'); res.on('data', function (d) { body += d; }); res.on('end', function () { var gist = JSON.parse(body); if (!gist.files) { throw new Error('Gist ("' + config.id + '") not found.'); } if (!gist.files[config.fileName]) { throw new Error('File ("' + config.fileName + '") is not part of the gist ("' + config.id + '").'); } resolve(gist.files['gistfile1.txt'].content); }); }); }); } }); 

Ensuite, dans votre démarque, vous référeriez le Gist en utilisant un hook JSON, par exemple

 {"gitdown": "gist", "id": "d3e4212c799252bac5fa"} 

Cette fonctionnalité devrait faire partie de Gitdown dans un avenir proche (il existe un numéro ouvert, https://github.com/gajus/gitdown/issues/7 ).

Cela est possible en 2017 lors de l’utilisation de GitHub Pages et d’un thème Jekyll:

Voir https://gist.github.com/benbalter/5555251 de @benbalter

Simple comme: {% gist 123456789 %}