How to get Bigfoot footnotes to work on a Jekyll site:
Once you decompress the downloaded
bigfoot.zip file, you should have the following files (as of this writing):
If you already have a place you put
.js files being used for your site, then move
bigfoot.min.js there. I didn’t, so I created a
js directory at the root of the site folder and moved those files there.
bigfoot-default.scss to the
_sass folder of your site. I think sites created with a slightly older version of jekyll might have a
_css directory instead, in which case you could move
bigfoot-default.css to that directory, or adapt to whatever your current setup is.
Now all the files are in place. You will need to make the following edits to your source files:
_includes/head.html and add the following lines below the
Note three things about the above:
/jspart of the path will depend on where your
1is where you move the jQuery
.jsfile to the
jsdirectory and refer to it there, so the filename would depend on the version you have.
actionOriginalFN: "ignore", and
positionContent: "true"are options that I chose to add to Bigfoot (you can read about all those configuration options on the Bigfoot homepage) and are not required.
Finally, you need to load Bigfoot’s style files that you moved earlier. Edit
main.scss’s last few lines to add a reference to Bigfoot’s style file:
I made a mistake in the last code block above. I had written
"bigfoot-number", but if you have been following my instructions, it should be
"bigfoot-default". The mistake is now fixed, so if this is the first time you’re reading this post, the code is good.
If you’re curious,
"bigfoot-number" is what you should include if you’re using this (download link) variant of Bigfoot that makes the footnote links in the body of the text into numbers, as opposed to the default bubble with three dots.
Sherif regrets the error.
That should be all. To add a footnote you add
[^1] in the body of the text, and
[^1]: This is my glorious and most important footnote at the bottom of your .markdown file.