Closed adamtheturtle closed 7 months ago
If the level of customization is a simple text replacement for the notice, I do not see any major issues to support this. For example, supporting either:
confluence_page_generation_notice = True
(or)
confluence_page_generation_notice = 'My custom notice message.'
Although, complete styling is a bit tricky, as the styling now varies between which Confluence editor used, and* there is a mix of translator/node building and template building (for index, search, etc. pages) that would need some tweaking.
If you would like a more detailed customization of the notice, maybe using a custom confluence_header_file
instead would be best? This would allow you to generate any custom message, tags or styling support by the Confluence instance you are targeting.
If this is related to a translation capability (i.e. wanting to use a non-English message), we do accept translation for messages via Crowdin.
That all being said, if there is a customization ideas I missed, I'm open for any details describing the use case.
Thank you for the quick and thorough response.
The text-only option would be a nice bonus, and plenty for me. This is not translation-related. I want to add a warning about inline comments getting wiped (#698, related) .
Initial implementation for this has been added in #930. Feel free to try it out using the following command:
pip install git+https://github.com/sphinx-contrib/confluencebuilder.git@support-custom-page-gen-notice
Amazingly fast - thank you @jdknight !
v2.5 is now available on PyPI -- marking as closed.
I'd like to add my own warning / styling to the notice.