add permanently HEAD links on Gist for UserScript

README.md

gist raw perm HEAD userscripts.org #130781

Install

When you install user.js strongly recommends on userscripts.org. NOT HERE.

About

Visit Gist and see 'raw' link, It's including SHA-1 long hash name like this.

https://gist.github.com/raw/2370972/47150711fedb7375d19d761ab122485b8105678d/gist-raw-perm-HEAD.user.js

This user.js provide 'HEAD' links. It's takes shrinked permanent raw link and shrinked named raw link when you browse Gist files.

HEAD

True Permalink: This is absolutery permanent link but it's always filetype: txt.

https://raw.github.com/gist/2370972/

HEAD(named)

Almost Permalink: This is almost permanent link. It's strict filetype by extension. This link broken when filename changed.

https://raw.github.com/gist/2370972/gist-raw-perm-HEAD.user.js

This link most useful for install user.js from Gist.

Known Ploblems

Multifiles Gist

HEAD can accessible 1st file only. That is Gist API constraints.

Binary 1st file

cf. https://gist.github.com/890279/

See raw data in https://raw.github.com/gist/890279/. Expected https://raw.github.com/gist/890279/simple320_320.png but actual API return 2nd file data. It's same as https://raw.github.com/gist/890279/gistfile1.txt.

Gist API

Multifiles Gist has ploblem. Gist API not provide true permlink(bee called HEAD) for 2nd or more files.

Gist API v1(deprecated)

Very simple.

• https://gist.github.com/api/v1/json/2370972

Gist API v3

Include content and history. It's too long too much.

• https://api.github.com/gists/2370972

Jot

Gist raw HTTP

This behavior on HERE.

• GET 'raw' return HTTP 302

https://gist.github.com/raw/2370972/2370972/47150711fedb7375d19d761ab122485b8105678d/gist-raw-perm-HEAD.user.js

• HTTP 200 OK

https://raw.github.com/gist/2370972/2370972/47150711fedb7375d19d761ab122485b8105678d/gist-raw-perm-HEAD.user.js

Based on

Base code is small Bookmarklet, you can see based rev. HERE on Hatena::Let. Lateset rev. Permalink is gist raw perm HEAD - Hatena::Let.

gist-raw-perm-HEAD.user.js

// ==UserScript==
// @name        gist raw perm HEAD
// @namespace   https://www.hatena.ne.jp/noromanba/
// @description Add permanently HEAD links on Gist. Use for install user.js or load xxx.js with (at)require etc.
// @include     https://gist.github.com/*
// @version     2012.5.1.0.31
// @homepage    https://userscripts.org/scripts/show/130781
// @downloadURL https://userscripts.org/scripts/source/130781.user.js
// @installURL  https://userscripts.org/scripts/source/130781.user.js
// @updateURL   https://userscripts.org/scripts/source/130781.meta.js
// @license     MIT License; http://nrm.mit-license.org/2012
// @copyright   (c) 2012+, noromanba (https://www.hatena.ne.jp/noromanba/)
// @author      noromanba
// @icon        https://upload.wikimedia.org/wikipedia/commons/thumb/4/46/Button_Icon_Orange.svg/32px-Button_Icon_Orange.svg.png
// @icon64      https://upload.wikimedia.org/wikipedia/commons/thumb/4/46/Button_Icon_Orange.svg/64px-Button_Icon_Orange.svg.png
// ==/UserScript==

// [Detail]
// https://gist.github.com/2370972

(function() {
    var raws = document.querySelectorAll('.actions > a');
    if (!raws) return;
    
    var gist = function(rawNode) {
        var raw = rawNode,
            meta = raw.pathname.match(/\/raw\/(\d+)\/\w+\/(.*)/),
            baseurl = 'https://raw.github.com/gist/',
            id = meta[1],
            basename = meta[2];
        return {
            raw: raw,
            id: id,
            name: basename,
            file: {
                name: basename.slice(basename.lastIndexOf('/') + 1),
                type: basename.split('.').length > 1 ? basename.split('.').pop() : 'N/D'
            },
            permalink: baseurl + id + '/'
        };
    };
    
    var files = []; // more smart, into gist{}
    Array.prototype.forEach.call(raws, function(raw) {
        var namedHead = raw.cloneNode(true);
        var g = gist(raw);
        files.push(g);
        
        namedHead.href = g.permalink + g.name;
        namedHead.textContent = 'HEAD(named)';
        namedHead.title = g.name;
        // Fx must be needs 2nd args https://developer.mozilla.org/en/DOM/element.insertBefore
        raw.parentNode.insertBefore(namedHead, null);
    });
    
    // 1st file only (Gist API constrains)
    (function(g) {
        if (g) {
            var head = g.raw.cloneNode(true);
            head.href = g.permalink;
            head.textContent = 'HEAD';
            head.title = g.id + '.txt';
            g.raw.parentNode.insertBefore(head, g.raw.nextSibling);
        }
    })(files[0]);
})();

userscripts.org.html

<h3>About</h3>
<strong>Add permanently HEAD link on Gist</strong>
<p>This user.js add 'HEAD' link. It's takes <strong>shrinked permanent raw link</strong>.
Like This</p>
<pre>
https://raw.github.com/gist/2370972/gist-raw-perm-HEAD.user.js
</pre>

<p><div>
    <img src="http://cdn-ak.f.st-hatena.com/images/fotolife/n/noromanba/20120413/20120413072715.png" alt="gist-raw-perm-HEAD" width="600px" />
</div></p>

<h3>Detail</h3>
<p>Show technical details on <a href="https://gist.github.com/2370972" target="_blank">Gist: 2370972</a>.</p>

<h3>:EOF</h3>
<p>Enjoy Gist and Coding!</p>

Regards,<br />
noromanba

The new Gist broke your script ＼( ><)シ

@LouCypher
thank you for your infomation :-)

broken

I know, maybe gist API changes too. but GitHub not provide information. hum..
a similar kind as shown below

feed => HTTP406

can't get gists feed

https://gist.github.com/noromanba.atom

Subscribe Gists - Hatena::Let

i.e. mulfunction open feed on flavors.me

blame UI

where is panel which put log?

• Show commit logs on Gist for Greasemonkey

too drastic.. I’m stucking X-(
I don't have much time now, a correction takes time.

FYI

didn't notification by Github, I'm late.
try @USERNAME with comments

Regards,
noromanba

@LouCypher
quick fix 🚑 now. but incompletly yet. pjax handling.........🐌
if unworks it, plz try reload

Thanks for the updates
       «:dancers::dancers:ヾ

@LouCypher
somehow handle pjax:sleepy::dizzy: thx for your patience:pray:

Would be great if you get this to work with the new style and upload new version to USO.

stuck in... 💭 take away freedom by CSP 🔒

@jerone sry I'm late. thx. USO has gone, and fork sites not good enough. e.g. GF; extreme security

Hey, @noromanba, I've updated the script to work on the current GitHub markup. Look at https://gist.github.com/denilsonsa/f2e5b9ee53e633e20165 and please update your version. :)

FYI, it was broken again, and I've fixed it again: https://gist.github.com/denilsonsa/f2e5b9ee53e633e20165