skip to navigation
skip to content

Not Logged In

sphinxcontrib-fancybox 0.3.4

Sphinx "fancybox" extension

Package Documentation

Sphinx "fancybox" extension.


Fancybox is adaptation of the jQuery plugin `fancybox <>`_ in version **2.1.5*. Note that version
Fancybox v2 and later are distributed under a
`Creative Commons Attribution-NonCommercial 3.0 <>`_

Documentation: `<>`_

github: `<>`_

PYPI: `<>`_


Instalation through pip: ::

    pip install sphinxcontrib-fancybox

or through github: ::

    git clone
    cd sphinxcontrib-fancybox
    python install

Next, you have to add extension to `` in your sphinx project. ::

    extensions = [



    Fancybox directive place a thumbnail of picture you selected, and add some
    `fancies`. If you click on image you get fullscreen box with that picture.

    Example: ::

        .. fancybox:: picture.png

    By default all images on one page are in the same group (you can navigate
    pressing `next` and `prev` buttons around this group).
    If you want to add picture to another group you have to set `group`
    parameter, like: ::

        .. fancybox:: picture.png
            :group: group2

    You can change size of fancybox with 'width' and 'height' which are
    passed as you set it: ::

        .. fancybox:: picture.png
            :width: 100%
            :height: 2em

    You can add some description which will be rendered as `title` attribute::

        .. fancybox:: http://pictures.tld/picture.png

            Some description

    If you not set 'width' and 'height', defaults values are gathered from
    ``. There are two parameters which you can adjust: ::


    Additionally you can set another css class with 'class' argument to
    `fancybox` directive or set `fancybox_thumbnail_class` to add css class to
    all `fancybox` directives.

    All fancybox JS config options you can pass as dict to `fancybox_config` in
    `` too.

    For examples please look to documentation


* handling local files (not only remotes) (DONE)
* option to copying remote graphics as statics
* fallback for non html output (DONE)
* nested parsing fix
* JS should be handled only once, not on every image node
* width and height parameters (currently the thumbnail is set to 100x100px) (DONE)
* get default thumbnail size from config (DONE)
* generate thumbnails for big images

Questions and suggestions

If you have some suggstions, patches, problems - please write an email or
github message.
File Type Py Version Uploaded on Size
sphinxcontrib-fancybox-0.3.4.tar.gz (md5, pgp) Source 2014-02-26 41KB
  • Downloads (All Versions):
  • 6 downloads in the last day
  • 135 downloads in the last week
  • 630 downloads in the last month