GitHub Gists may be used not only for code snippets sharing but as a publishing platform for your articles.
Each gist is a git repo with restrictions and features:
- You can't create folders in any branch of the repo.
- Each file in the master branch larger than 1MB risks to be truncated so you can't add zip archive to master. But you may keep additional large files at another branches which can't be viewed on the gist page.
- If you want to use images in your article but wish non-embedded images to be hidden on the gist page then you may keep them in non-master branch and reference by
./<id of your gist>/raw/<commit hash>/foobar.jpg
. - You may add download link for an archive of any branch, it looks like
https://gist.github.com/<username>/<gist id>/archive/<name of the branch>.zip
.
RSS is provided for your GH Gist profile so people may subscribe if they don't mind receiving every step you make. RSS address looks like https://gist.github.com/ilyaigpetrov.atom.
Mail subscriptions may be created with rss-to-email services like one provided by MailChimp for free.
You may create short links like https://git.io/boost-win10, see instructions here.
If you want to wipe clean a gist repo but wish to preserve all the links on it (so you don't want to delete it) then you may apply git push to an empty repo with a force flag.
Files on the gist page are ordered alphanumerically. If you wish to change order of files then add prefixes like _0_File One.md
or _1_File Two.jpg
to filenames.
- https://gist.github.com/ilyaigpetrov/03506150e0a3a4104a24f7e519d42078
- https://gist.github.com/ilyaigpetrov/f6df3e6f825ae1b5c7e2
You may use https://github.com/ilyaigpetrov/gistpub for generating a list of gists like the one below.
I would love to generate one article for my company called byaak digital-Nepal's top digital & internet marketing agency @birgunj