It seems that browsers add some special default styling to header tags :(
I found that for smaller heading tags, like h5 could give more padding then h1 tags...
To fix this, everything should now just recieve the theme standard of 24px bottom margin.
This likely was indirectly broken with da86e4dc62
This commit addes our standard headerlink icon styles to math links aswell, before they had no styling.
Fixes#1189
This should'nt be a breaking change as backward compatibility is preserved so this change could go into 1.0 or wait until 1.1.
I know a lot of users are asking for this so it might be nice to include this in 1.0.
Fixes#1115
* Tests: Fix deprecation warning with new sphinx versions
These builders where split in sphinx and the old import path will be removed in the upcoming Sphinx 4 release.
This patch requires sphinx 2 so this will be committed into the v2 release.
* Fix imports
* Use try/except for backwards compatibility
Sphinx 4.x moves javascript and css declarations to `script_files` and `css_files`. This patch fixes duplicatd link and script tags when using sphinx4
Sphinx 4.x changes the default setting of html_codeblock_linenos_style to 'inline' and deprecates `html_codeblock_linenos_style`. The css for `.hll` to make the hightling span the full line cause the line number and code to be split on seperate lines. I could not get the highlight to span the full line so it was removed completely. I also made line numbers not selectible by the user.
This changes also adds the needed changes to the tox testing enviorment alhough, sphinx4 is not officially released to pypi yet. You will need to test these changes locally using: `pip install git+https://github.com/sphinx-doc/sphinx@master`
* Cleanup: Sass formatting
This patch addresses some sass formatting to make the code easier to read:
- Use leading zeros on decimals less than 1
- Use parentheses around math for css propeties with multiply arguments
- Spaces after commas in arguments
In the future it would be nice to automatically format this with a tool like style lint.
* Revert Extra Tabbing
* Add back missing line
* Add whitespace back
* Fix whitespace 2
Use `page_source_suffix` instead of checking `source_suffix`
Since we now require sphinx 1.6 we can cleanup this old workaround for old sphinx versions.
Sphinx 1.6 is required for de76c03824 we also do not test against versions lower than 1.6 so we should safely drop it.
This is similar to #1076 and #1075 but less strict
* Docs: Add text before config api type information
This makes it more clear what the confval is for without having to read through the type information.
This matches usual sphinx autodoc behavior.
* Only use one space above headings
* npm: Add a few missing package fields
This fixes these warnings when running `npm install`:
```
npm WARN sphinx_rtd_theme@0.5.1 No repository field.
npm WARN sphinx_rtd_theme@0.5.1 No license field.
```
* 0.5.2
* Revert version bump
* Revert version bump
This changes non PR builds on rtd to use the local theme and not the old 0.4.3 theme. We want our docs to show what the theme looks like based on the current release, not an old version.
The sets the right padding the same as the first level.
The current padding is too large and varies between toc levels.
Now, the right padding is the same between all levels and only the left padding changes
Currently, Nav buttons to expand the menu are a bit small and do not match the link text.
This makes the font size and line-height match between the text and icon.
* Remove Extra Padding on Highlighted search results
There are some cases where the highlighted CSS class creates overlapping text, for example on [Rendering » Shader Nodes » Texture](https://docs.blender.org/manual/en/dev/render/shader_nodes/textures/index.html?highlight=texture) when highlighting "texture".
This issue is exacerbated by some custom styling rules that we have set, however, this issue is still visible in the stock theme.
* Address Review Comments
- Use constant instead of a magic number
- Remove Padding
This gives more room for longer breadcrumbs and makes the theme a little bit more generic. For example, people might use the theme for other purposes then hosting "docs".
* Lists not indented properly on genindex.html
I haven't tested this yet but it is a start to fixing this. No need to review yet.
Fixes#671
* Update CSS Selector
This should also fix#685
* Remove styling for contents
* Move javascript back to head
* Move jQuery function back to bottom
* Do not change white space
* Update comment + whitespace cleanup
* Address review points
* Fix code comments
* Small visual improvement to captions in toctree
* Add new nav-caption internal var
* Use colored text and add margin
* Nav captions now have independent color
Co-Authored-By: Blendify <carlisle.b3d@gmail.com>
* De saturate the bright blue captions
Co-Authored-By: Blendify <carlisle.b3d@gmail.com>
* Docs: correct navigation_depth discription
* Docs: add note about large toctrees
* Docs: Cleanup: use different note markup
Github does not mark the syntax correctly otherwise