Tools for integrating affiliated Sphinx sites
Project description
sphinx-affiliates
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
Built Distributions
Hashes for sphinx_affiliates-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1fd601ebce1a3dd7c5eea0b1c4cde5352e3860d4b2c9b6cc97042d9f79048a4f |
|
MD5 | 7c8dad9073cd8b156474dd45c3a4df4c |
|
BLAKE2b-256 | 5750b7311691a23b07ea3629370c6d18ceaaa0c3cc50e98c6826b5af72a76cc7 |
Hashes for sphinx_affiliates-0.2.1-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd5ff4bf248d83342d5db763b2798cae71a6a7b55fb9470722ee56f0328585d5 |
|
MD5 | 76b1d03fcb21d5a77f4f52052a79fb3c |
|
BLAKE2b-256 | 5b622e03666db19242b1876c5aaef6b133e9b070a07604d9911fb47ba430189f |