|
$ gist --help |
|
Gist (v4.2.0) lets you upload to https://gist.github.com/ |
|
|
|
The content to be uploaded can be passed as a list of files, if none are |
|
specified STDIN will be read. The default filename for STDIN is "a.rb", and all |
|
filenames can be overridden by repeating the "-f" flag. The most useful reason |
|
to do this is to change the syntax highlighting. |
|
|
|
If you'd like your gists to be associated with your GitHub account, so that you |
|
can edit them and find them in future, first use `gist --login` to obtain an |
|
Oauth2 access token. This is stored and used by gist in the future. |
|
|
|
Private gists do not have guessable URLs and can be created with "-p", you can |
|
also set the description at the top of the gist by passing "-d". |
|
|
|
Anonymous gists are not associated with your GitHub account, they can be created |
|
with "-a" even after you have used "gist --login". |
|
|
|
If you would like to shorten the resulting gist URL, use the -s flag. This will |
|
use GitHub's URL shortener, git.io. You can also use -R to get the link to the |
|
raw gist. |
|
|
|
To copy the resulting URL to your clipboard you can use the -c option, or to |
|
just open it directly in your browser, use -o. Using the -e option will copy the |
|
embeddable URL to the clipboard. You can add `alias gist='gist -c'` to your |
|
shell's rc file to configure this behaviour by default. |
|
|
|
Instead of creating a new gist, you can update an existing one by passing its ID |
|
or URL with "-u". For this to work, you must be logged in, and have created the |
|
original gist with the same GitHub account. |
|
|
|
Usage: gist [-o|-c|-e] [-p] [-s] [-R] [-d DESC] [-a] [-u URL] [-P] [-f NAME|-t EXT]* FILE* |
|
gist --login |
|
|
|
--login Authenticate gist on this computer. |
|
-f, --filename [NAME.EXTENSION] Sets the filename and syntax type. |
|
-t, --type [EXTENSION] Sets the file extension and syntax type. |
|
-p, --private Makes your gist private. |
|
--no-private |
|
-d, --description DESCRIPTION Adds a description to your gist. |
|
-s, --shorten Shorten the gist URL using git.io. |
|
-u, --update [ URL | ID ] Update an existing gist. |
|
-a, --anonymous Create an anonymous gist. |
|
-c, --copy Copy the resulting URL to the clipboard |
|
-e, --embed Copy the embed code for the gist to the clipboard |
|
-o, --open Open the resulting URL in a browser |
|
--no-open |
|
-P, --paste Paste from the clipboard to gist |
|
-R, --raw Raw url of the new gist |
|
-h, --help Show this message. |
|
-v, --version Print the version. |