How do you control the order in which files appear in a GitHub gist
GithubGistGithub Problem Overview
Is there a way to control the order in which files appear in a gist? They don't seem to be alphabetical or chronological. I'd like to have a README.md appear as the first file in a multi-file gist, but no amount of "deleting" a file and re-adding it seems to change anything.
Is there an order to these files that I'm not seeing, or does GitHub maintain an internal filetype priority list?
Github Solutions
Solution 1 - Github
Since at least 2018, the order is alphabetical, with periods and numbers coming before letters.
That is, as mentioned in Andrew D.Bond's answer:
$.(dot)- Numbers
- Leading space (although the space doesn't appear after saving, the sort order is still updated)
(although bis, in Sept. 2020, IvanaGyro adds in the comments leading spaces will not affect the order any more) _(underscore)- Letters (case insensitive)
Around 2013-2014 a different order was used.
Solution 2 - Github
They are ordered automatically by name, following the ASCII table.
Unfortunatly, right now, it is not possible to order them by dragging, but there is a trick. You can control the order by adding one or more spaces before the name. The space will not be shown after editing, but the order will change.
E.g: lets say we have 3 files with the automatic order:
- AFile.java
- Readme.md
- SomeFile.txt
We can invert the order by putting spaces like this:
- (space)(space)SomeFile.txt
- (space)Readme.md
- AFile.txt
Solution 3 - Github
At least as of 2020, the sort order is:
- $
- . (dot)
- Numbers
- Leading space (although the space doesn't appear after saving, the sort order is still updated)
- _ (underscore)
- Letters (case insensitive)
Between at least 2013 and 2016, ASCII order was used.
If additional characters' sort order is discovered, feel free to edit this answer.
(Adding this answer because even after I improved another answer to this question last year, I still couldn't find the sort order of special characters anywhere.)
Solution 4 - Github
As mentioned by @VonC in his answer, the order is asciibetical. Quick solution would be to prefix all files with numbers indicating the order in which you wish the files to appear, example 0_, 1_, 2_, ... 9_. Note, this solution will not work beyond 9 files as 10_ will appear before 2_. In that case, two digits need to be used 00_, 01_, 02_, ..., 09_, 10_, 11_, ... This can be generalized to any number of digits in the number of files. Although, it seems less likely, to me, that more more than 10 files to be shared in a gist.