I'm really liking this use of gists as a backend to more specialized services (eg http://dabblet.com & http://codepen.io ). It's a nice, easy way to get a versioned document store without having to build out the infrastructure. Direct access to the "raw" form is a plus.
Related: is it possible to edit gists (anonymous or otherwise?) If not, that seems like a functionality that could be implemented here, with a bit of trickery.
* Add a sign-in-with-github option, and turn this into a minimalist blogging platform. Comments (gist comments), index page (showing any gists of yours that have been gist.io'd), authoring (I like writing in IA writer, maybe an experience similar to that, but with auto-saving.)
* Maybe some kind of means for controlling cache (right now gists are cached for one minute).
I love this idea. Not sure if this is a direction you'd be interested in, but it would be really cool if this could act as a widget that I could insert into an existing blog site with a single line of code and your service would populate the rest. This would let me use gists for all my blogging, and still have the rest of my site around the outside.
This looks really great, but I have to take issue with your choice of typeface. While the description in the Google font database makes it out to be an award winning face for literature optimized for reading, its exaggerated serifs and uneven rhythm give it a kind of medieval / enlightened manuscript feel that just seems anachronistic and weird. For a general service that integrates with Github and shouldn't really be 'saying' anything with its design, I would recommend a more classic, rhythmic serif face along the lines of Minion, Caslon, Palatino, Baskerville, Hoefler Text, or even Georgia, which reads quite well at 14-16px.
Granted I'm a designer, I personally wouldn't use this service based on the typeface choice alone. It just clashes too much with the neutrality of everything else on my system and on websites I use commonly.
Sorry to hear that. I don't find the typeface to be as good as my current favorite workhorse serif (Elena, from process type, which I licensed for http://gazit.me )—but I don't find it to be objectionable or harmful to legibility either. Quite the opposite, I found it to be a serif with personality—less so than the commonly-used Skolar—and it reminded me of Elena (the shape of the adnate serifs, the slightly negative stress, the relatively-tall x-height, and the lowercase 'e' in particular).
I'll revisit type choices at some point, but right now the goal was to get something up, and as much as I love the faces you've specified, half I'm sick of and the other half aren't sufficiently ubiquitous.
For me your font-size is a notch too large, which amplifies the weaknesses of the typeface.
Personally I'd stick with Palatino[1] or Georgia for readability.
Mind you, this is perfectionist quibbles. Your font isn't bad. Just myself I'd probably hit the readability bookmarklet if I wanted to read a longer text on your site.
In my opinion, Elena is good choice. It's very good for reading, and that's the key. Yes, backend is mainly code-focused (github's gist), but people will most likely post not code, but regular articles. So there's hardly anything anachronistic about the typeface - github is just implementation detail.
As for Elena's character and style, it's there, but I always prefer some character over none - Freight Sans wins over Helvetica any time. Github uses Helvetica / Arial by default, so if someone wants default design, they can simply link to gist.
So once again - my arguments may not be the strongest, but I have a gut feeling that Elena is not wrong choice for such service, and if you like it, use it.
The one advantage something like Georgia has is that everyone has it local. Web fonts don't look great in all browsers and platforms - particularly on most Windows browsers, the anti-aliasing and hinting gets pretty heinous.
I'm excited about this. Not because it's a beautifully simple web app that provides a helpful service to a lot of us. Rather, i'm excited to see the source of a simple and effective Flask app! I'll be using this as a reference point for some lightweight apps down the road =) Thank you!
Great stuff. I see a great use case for this: when people want to write a reply to a post they can just fork the original gist and write their reply above it, like this: http://gist.io/3140173
In this way you can regard the list of forks at the right of the gist page as the list of comments (screenshot: http://cl.ly/image/1803161N432H).
What is a gist, really? Is it a versioned, modifiable and referencable publication? Can I store it in my github repo? Should we be using gist as a model for info packet? is there an "API"? If someone could explain their understanding of a gist, I would appreciate it.
A gist is basically a mini-git repo. There is a revision history and they are attached to your github page. You can also folk or edit them and there is a permalink to each revision.
There is programmatic access to gists via the github API.
Very interesting - I also noticed that gists have comments -- I'm not sure how those are handled. Doesn't this mean that gists are the ultimate blog? Can you even create them locally and push?
Instapaper compatibility:
Considering the fact that this is for reading writings rather than codes, I think it makes sense to make it compatible with Instapaper and other services similar to it.
Also the <title> element should be the description rather than gist.io#.
> "Sometimes, we just want to share a bit of writing that is neither. Maybe we want to write for a specific audience, but don’t want to address the people who usually read our blogs."
You had me here. But I want to know where the top, featured, and new sections are. Where can I be recommended gists that are similar to those of users I subscribe to? Or are you trying to make this into the sort of imgur.com of stories on HN kind of thing?
I think maruku would be a better alternative than markdown. Currently you cannot make a table of contents inside your gist. But overall, I find this extremely handy. Thanks for contributing this to the open source community.
This looks awesome. It would be cool if you could build a community around this. I wish I could not only post with this tool, but also read what others are writing. While someone may not want to keep a full blog, they may be willing to write a one-off post. This would be a great place to collect that kind of posts.
This is pretty cool.
Mike Bostock, the creator of the d3.js visualization framework runs a service http://bl.ocks.org/ that lets you write HTML and JS code for visualizations and use the website to display them.
It is pretty neat. An example can be found here: http://bl.ocks.org/1134768
53 comments
[ 3.1 ms ] story [ 32.0 ms ] threadI've noticed that some authors will create a public repo like "thoughts" and add markdown files to it (rather than writing gists).
http://md.jesse-obrien.ca Source is on my github account.
You can save and edit(fork), and it gives you live (1-2s delay) formatting.
https://github.com/idan/gistio/issues/1
Generally, if you have features you want, file 'em here: https://github.com/idan/gistio/issues
Stuff I'd like to do given the time:
* Add RestructuredText support
* Add a sign-in-with-github option, and turn this into a minimalist blogging platform. Comments (gist comments), index page (showing any gists of yours that have been gist.io'd), authoring (I like writing in IA writer, maybe an experience similar to that, but with auto-saving.)
* Maybe some kind of means for controlling cache (right now gists are cached for one minute).
If you add sign-in-with-github support, be sure you start hosting the HTML and JS off a different domain.
edit: finally I wouldn't like to break your minimalistic idea down
Granted I'm a designer, I personally wouldn't use this service based on the typeface choice alone. It just clashes too much with the neutrality of everything else on my system and on websites I use commonly.
I'll revisit type choices at some point, but right now the goal was to get something up, and as much as I love the faces you've specified, half I'm sick of and the other half aren't sufficiently ubiquitous.
For me your font-size is a notch too large, which amplifies the weaknesses of the typeface. Personally I'd stick with Palatino[1] or Georgia for readability.
Mind you, this is perfectionist quibbles. Your font isn't bad. Just myself I'd probably hit the readability bookmarklet if I wanted to read a longer text on your site.
[1] http://ksjoberg.com/vim-esckeys.html
As for Elena's character and style, it's there, but I always prefer some character over none - Freight Sans wins over Helvetica any time. Github uses Helvetica / Arial by default, so if someone wants default design, they can simply link to gist.
So once again - my arguments may not be the strongest, but I have a gut feeling that Elena is not wrong choice for such service, and if you like it, use it.
In this way you can regard the list of forks at the right of the gist page as the list of comments (screenshot: http://cl.ly/image/1803161N432H).
My thinking was to have a different gist per month which could be added too..
Unfortunately, not too friendly for non-js browsers which is kind of the weak point.
http://poyo.co/blog/
There is programmatic access to gists via the github API.
This might help clarify: An example of using gist.io: http://gist.io/3135754 The underlying gist: https://gist.github.com/3135754
Then I checked. And there is.
Not to mention JSONP suppport.
https://gist.github.com/3135754.json?callback=foo
Also the <title> element should be the description rather than gist.io#.
You had me here. But I want to know where the top, featured, and new sections are. Where can I be recommended gists that are similar to those of users I subscribe to? Or are you trying to make this into the sort of imgur.com of stories on HN kind of thing?
It also doesn't handle ```lang ... ``` blocks properly: compare https://gist.github.com/3050085 with http://gist.io/3050085 .