Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

The Sphinx extension embedding a Sage cell into a webpage

Project description


Install the sphinx-sagecell-ext from PyPI

$ sudo pip install sphinx-sagecell-ext

Install the sphinx-sagecell-ext from GitHub

$ sudo pip install git+git://

Upgrade the sphinx-sagecell-ext from PyPI

$ sudo pip install -U sphinx-sagecell-ext


$ sudo pip install --upgrade sphinx-sagecell-ext

Uninstall the sphinx-sagecell-ext

$ sudo pip uninstall sphinx-sagecell-ext

Development installation

$ git clone git://
$ cd sphinx-sagecell-ext
$ sudo pip install .


First, add sphinx-sagecell-ext.sagecell extension to documentation file::

extensions = [

Second, copy layout.html file to _templates documentation directory:

$ wget -P DEST


  • DEST – a path to _templates documentation directory.


$ wget -P ~/sphinx-sagecell-ext/source/_templates


The following is some example usage:

.. sagecellserver::



The key/value pairs serve as the configuration of the created Sage Cell instance. The following options can be set when embedding:

Linked cells

When multiple input locations are given, this sets whether the code from these cells is to be executed from the same kernel, so that code executed in one will affect the execution of code from another cell:

.. sagecellserver::
   :linked: true

.. sagecellserver::
   :linked: false


This option is true by default.

For changing the default value. First, open the /usr/local/lib/python2.7/dist-packages/sphinx-sagecell-ext/ file:

$ sudo gedit /usr/local/lib/python2.7/dist-packages/sphinx-sagecell-ext/

Second, change the next code from:

linked = True


linked = False


.. sagecellserver::
   :linked: true

   x = "first cell"

.. sagecellserver::
   :linked: false

   x = "second cell"

.. sagecellserver::
   :linked: true

options: linked_cells [prtscn]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sphinx-sagecell-ext, version 0.1rc4
Filename, size File type Python version Upload date Hashes
Filename, size sphinx-sagecell-ext-0.1rc4.tar.gz (41.1 kB) File type Source Python version None Upload date Hashes View
Filename, size (43.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page