Adding an edit button¶
Furo can add a small edit button to each document to allow visitors to easily propose changes to that document using the repository’s source control system.
With popular VCS hosts¶
Provide the relevant VCS variables, by setting the following keys in html_theme_options
:
html_theme_options = {
"source_repository": "https://github.com/pradyunsg/furo/",
"source_branch": "main",
"source_directory": "docs/",
}
This model supports github.com, gitlab.com and bitbucket.org as domain names for the source_repository
key.
With arbitrary URLs¶
Added in version 2022.09.29.
Use arbitrary URLs for the edit button, by setting the following key in html_theme_options
:
html_theme_options = {
"source_edit_link": "https://my.awesome.host.example.com/awesome/project/edit/{filename}",
}
The {filename}
component will be replaced with the full path to the file, as known from the base of the documentation directory.
Important
Furo does not enforce that the source_edit_link
contains {filename}
or any sort of correctness check on this URL. Make sure to manually confirm that the link works.
Read the Docs support¶
If you’re building documentation on Read the Docs using a github.com-hosted repository as the source, the edit button is enabled by default.
Disabling on Read the Docs¶
If you wish to disable this, use top_of_page_button and set it to None
.