conf.py

sys.path.insert(0, '.')
extensions.append('sphinxcontrib_awesome')

index.txt

Use font awesome using `:awesome:` role.

example::

  :awesome:`fa-home` fa-home
  :awesome:`fa-home fa-fw` fa-home fa-fw

sphinxcontrib_awesome.py

#
# sphinxcontrib_awesome.py
#
#   Author: @tk0miya
#   License: Apache 2.0
#
from docutils import nodes, utils


def awesome_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
    awesome_tag = '<i class="fa %s"></i>' % utils.unescape(text)
    raw = nodes.raw('', awesome_tag, format='html')
    return [raw], []


def setup(app):
    app.add_role('awesome', awesome_role)
    app.add_stylesheet('http://maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css')