Skip to main content

Tools for integrating affiliated Sphinx sites

Project description

sphinx-affiliates

CI status License: MIT

Allow search to include documents from more than one Sphinx documentation html site.

This is useful when you have a number of github repositories under one org, are using sphinx to build documentation for all of them, and github pages to serve the artifacts. When you configure a custom domain, say https://my.site.org, for one repo in the org, any other repo's github pages (say repo2) will be visible as https://my.site.org/repo2. But the search.html from the sites will not know about eachother: they will be completely independent. This extension will solve that by

  • changing the search engine to allow loading more than one index
  • changing the search index generation process to generate an additional index
  • add configuration options to add the additional indices, from affiliate sites, to the search.html page.

To use this, install it via pip and add something like this to your conf.py

extensions = [
    'sphinx_affiliates',   # Add the extension
]

# Where this site's build is hosted, this will be the URL for all the search
# results from this site.
affiliate_options = {
    'canonical_url': "https://affiliate_search.github.io",
}

# Other sites to add to the search of this site. HTTP urls may get blocked
# as cross-site scripting
sphinx_affiliates = [
    '../other_repo1/affiliate_searchindex.js',
    'https://affiliate_search.github.io/other_repo2/affiliate_searchindex.js',
]

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

sphinx_affiliates-0.2.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

sphinx_affiliates-0.2.1-py2-none-any.whl (10.1 kB view details)

Uploaded Python 2

File details

Details for the file sphinx_affiliates-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: sphinx_affiliates-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.1.3.post20200712 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for sphinx_affiliates-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1fd601ebce1a3dd7c5eea0b1c4cde5352e3860d4b2c9b6cc97042d9f79048a4f
MD5 7c8dad9073cd8b156474dd45c3a4df4c
BLAKE2b-256 5750b7311691a23b07ea3629370c6d18ceaaa0c3cc50e98c6826b5af72a76cc7

See more details on using hashes here.

File details

Details for the file sphinx_affiliates-0.2.1-py2-none-any.whl.

File metadata

  • Download URL: sphinx_affiliates-0.2.1-py2-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/2.7.18rc1

File hashes

Hashes for sphinx_affiliates-0.2.1-py2-none-any.whl
Algorithm Hash digest
SHA256 dd5ff4bf248d83342d5db763b2798cae71a6a7b55fb9470722ee56f0328585d5
MD5 76b1d03fcb21d5a77f4f52052a79fb3c
BLAKE2b-256 5b622e03666db19242b1876c5aaef6b133e9b070a07604d9911fb47ba430189f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page