Skip to content

kashif-umair/gist-embed

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

##How to use gist-embed to spice up code snippets on your blog

Include jQuery and gist-embed:

You should include them in your HEAD tag for better performance

<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script type="text/javascript" src="https://github.com/kashif-umair/gist-embed/raw/master/gist-embed.js"></script>

Add a code element to your page with an id attribute in the following format:

"gist-<gist-id>"

To embed the whole gist you should put this code element in your body where ever you want it to be displayed.

<code id="gist-4672365"></code>

To embed a single file from gist, add the data-file attribute to your code element like this.

<code id="gist-4672365" data-file="2.java"></code>

To embed a single line of a file from gist, add the data-line attribute to your code element like this.

<code id="gist-4672365" data-file="2.java" data-line="5"></code>

This will embed only line number 5.

To embed multiple lines of a file from gist, change the data-line attribute's value to something like MS Word printing page ranges. e.g.

<code id="gist-4672365" data-file="2.java" data-line="2-5,10-14,11,20"></code>

This will embed line numbers 2,3,4,5,10,11,12,13,14,11,20 in the same order. If lines are duplicated then they will be duplicated in code too.

If you are embedding multiple lines then make sure about following points.

  • You can put a range like "2-5", or single line numbers separated with commas like "11,20", or mix of both like "2-5,11,10-14,20"
  • Spaces are not allowed in data-line value

To avoid line numbers in view, you can use data-showLineNumbers attribute. To hide line numbers set this attribute to "false"

<code id="gist-4672365" data-file="2.java" data-line="2-5,10-14,11,20" data-showLineNumbers="false"></code>

 This code will hide the line numbers at left side of your code.

To hide footer content of gitHub in view, you can use data-showFooter attribute. Simply set this attribute's value "false".

<code id="gist-4672365" data-file="2.java" data-line="2-5,10-14,11,20" data-showFooter="false" ></code>    

 This will hide footer github contents (gistName hosted with by GitHub).

Follow the above instructions to avoid getting any undesired results.

About

Easily embed gists into any blog or webpage

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 88.8%
  • CSS 11.2%