blender/blender-manual
23
23
Fork 104
Code Issues 74 Pull Requests 6 Projects 1 Releases Wiki Activity

Switch the manual theme to Furo #104735

Merged
Aaron Carlisle merged 30 commits from furo-theme into blender-v4.1-release 2024-03-20 21:38:49 +01:00
Conversation 14 Commits 30 Files Changed 9 +148 -404
10 changed files with 148 additions and 404 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit be893ef08c - Show all commits

11
build_files/templates/base.html Normal file
View File

@ -0,0 +1,11 @@
{%- extends "!base.html" -%}
{%- block linktags -%}
{{ super() }}
{%- include "components/linktags.html" -%}
{%- endblock -%}
{%- block theme_scripts -%}
{{ super() }}
{%- include "components/analytics.html" -%}
{%- endblock -%}

13
build_files/templates/components/analytics.html Normal file
View File

@ -0,0 +1,13 @@
{%- if analytics_id %}
<!-- Theme Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id={{ theme_analytics_id }}"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag() { dataLayer.push(arguments); }
gtag('js', new Date());
gtag('config', '{{ analytics_id }}', {
'anonymize_ip': 'false',
});
</script>
{%- endif %}

19
build_files/templates/footer.html → build_files/templates/components/footer_contribute.html
View File

@ -1,21 +1,19 @@
{%- extends "!footer.html" %}
{%- block extrafooter %}
{%- if not pagename in ("search", "404", "genindex", "advanced/command_line/arguments") and hasdoc(pagename) %} {%- if not pagename in ("search", "404", "genindex", "advanced/command_line/arguments") and hasdoc(pagename) %}
<div class="footer-contribute"> <div class="footer-contribute">
<ul> <ul>
<li>{# Add the `display=source` because GITEA's rendering misses Sphinx's features and shows warnings. #} <li>{# Add the `display=source` because GITEA's rendering misses Sphinx's features and shows warnings. #}
<a href="https://projects.blender.org/blender/blender-manual/{# <a href="https://projects.blender.org/blender/blender-manual/{#
#}src/branch/main/manual/{{ pagename }}{{ page_source_suffix }}?display=source" #}src/branch/main/manual/{{ pagename }}{{ page_source_suffix }}?display=source" class="fa fa-edit"> {{
class="fa fa-edit"> {{ _('View Source') }}</a> _('View Source') }}</a>
</li> </li>
<li> <li>
<a href="https://translate.blender.org/zen/blender-manual/{# <a href="https://translate.blender.org/zen/blender-manual/{#
#}manual/{{ language }}/?q=location%3Amanual%2F{{ pagename }}" #}manual/{{ language }}/?q=location%3Amanual%2F{{ pagename }}" class="fa fa-edit"> {{ _('View
class="fa fa-edit"> {{ _('View Translation') }}</a> Translation') }}</a>
</li>{# </li>{#
<li> <li>
<a href="https://projects.blender.org/blender/blender-manual/src/branch/main/manual/{{ pagename }}{{ page_source_suffix }}" <a href="https://projects.blender.org/blender/blender-manual/src/branch/main/manual/{{ pagename }}{{ page_source_suffix }}"
class="fa fa-edit"> {{ _('Edit Page') }}</a> class="fa fa-edit"> {{ _('Edit Page') }}</a>
</li>#} </li>#}
<li> <li>
<a href="https://projects.blender.org/blender/documentation/issues/new?{# <a href="https://projects.blender.org/blender/documentation/issues/new?{#
@ -27,10 +25,9 @@
#}Permanent+Link%5D%28https%3A%2F%2Fdocs.blender.org%2F{# #}Permanent+Link%5D%28https%3A%2F%2Fdocs.blender.org%2F{#
#}manual%2F{{ language }}%2F{{ version }}%2F{{ pagename }}{{ file_suffix }}%29%0D%0A%0D%0A%2A%2A{# #}manual%2F{{ language }}%2F{{ version }}%2F{{ pagename }}{{ file_suffix }}%29%0D%0A%0D%0A%2A%2A{#
#}Short+description+of+error%2A%2A%0D%0A%5B{# #}Short+description+of+error%2A%2A%0D%0A%5B{#
#}Please+fill+out+a+short+description+of+the+error+here%5D%0D%0A" #}Please+fill+out+a+short+description+of+the+error+here%5D%0D%0A" class="fa fa-bug"> {{ _('Report issue
class="fa fa-bug"> {{ _('Report issue on this page') }}</a> on this page') }}</a>
</li> </li>
</ul> </ul>
</div> </div>
{%- endif %} {%- endif %}
{% endblock %}

6
build_files/templates/layout.html → build_files/templates/components/linktags.html
View File

@ -1,5 +1,3 @@
{%- extends "!layout.html" %}
{%- block linktags %}
<link rel="alternate" hreflang="en" href="https://docs.blender.org/manual/en/latest/" /> <link rel="alternate" hreflang="en" href="https://docs.blender.org/manual/en/latest/" />
<link rel="alternate" hreflang="ar" href="https://docs.blender.org/manual/ar/latest/" /> <link rel="alternate" hreflang="ar" href="https://docs.blender.org/manual/ar/latest/" />
<link rel="alternate" hreflang="de" href="https://docs.blender.org/manual/de/latest/" /> <link rel="alternate" hreflang="de" href="https://docs.blender.org/manual/de/latest/" />
@ -20,6 +18,4 @@
<link rel="alternate" hreflang="vi" href="https://docs.blender.org/manual/vi/latest/" /> <link rel="alternate" hreflang="vi" href="https://docs.blender.org/manual/vi/latest/" />
<link rel="alternate" hreflang="zh-Hans" href="https://docs.blender.org/manual/zh-hans/latest/" /> <link rel="alternate" hreflang="zh-Hans" href="https://docs.blender.org/manual/zh-hans/latest/" />
<link rel="alternate" hreflang="zh-Hant" href="https://docs.blender.org/manual/zh-hant/latest/" /> <link rel="alternate" hreflang="zh-Hant" href="https://docs.blender.org/manual/zh-hant/latest/" />
<link rel="alternate" hreflang="x-default" href="https://docs.blender.org/manual/en/latest/" /> <link rel="alternate" hreflang="x-default" href="https://docs.blender.org/manual/en/latest/" />
{{ super() }}
{%- endblock %}

6
build_files/templates/page.html Normal file
View File

@ -0,0 +1,6 @@
{%- extends "!page.html" -%}
{%- block footer -%}
{{ super() }}
{%- include "components/footer_contribute.html" -%}
{%- endblock footer -%}

18
build_files/templates/versions.html → build_files/templates/sidebar/variant-selector.html
View File

@ -2,28 +2,24 @@
<ul id="versionwrap" role="presentation"> <ul id="versionwrap" role="presentation">
<li role="presentation"> <li role="presentation">
<span id="version-popover" class="version-btn" tabindex="0" role="button" aria-label="versions selector" <span id="version-popover" class="version-btn" tabindex="0" role="button" aria-label="versions selector"
aria-haspopup="true" aria-controls="version-vsnlist" aria-disabled="true"> aria-haspopup="true" aria-controls="version-vsnlist" aria-disabled="true">
{{ release }} {{ release }}
</span> </span>
<div class="version-dialog" aria-hidden="true"> <div class="version-dialog" aria-hidden="true">
<div class="version-arrow" aria-hidden="true"></div>
<div class="version-title">Versions</div> <div class="version-title">Versions</div>
<ul id="version-vsnlist" class="version-list" role="menu" aria-labelledby="version-popover" <ul id="version-vsnlist" class="version-list" role="menu" aria-labelledby="version-popover" aria-hidden="true">
aria-hidden="true">
<li role="presentation">Loading...</li> <li role="presentation">Loading...</li>
</ul> </ul>
</div> </div>
</li> </li>
<li role="presentation"> <li role="presentation">
<span id="lang-popover" class="version-btn" tabindex="0" role="button" aria-label="language selector" <span id="lang-popover" class="version-btn" tabindex="0" role="button" aria-label="language selector"
aria-haspopup="true" aria-controls="version-langlist"> aria-haspopup="true" aria-controls="version-langlist">
{% if language is not none %} {{ language }} {% else %} en {% endif %} {% if language is not none %} {{ language }} {% else %} en {% endif %}
</span> </span>
<div class="version-dialog" aria-hidden="true"> <div class="version-dialog" aria-hidden="true">
<div class="version-arrow" aria-hidden="true"></div>
<div class="version-title">Languages</div> <div class="version-title">Languages</div>
<ul id="version-langlist" class="version-list" role="menu" aria-labelledby="lang-popover" <ul id="version-langlist" class="version-list" role="menu" aria-labelledby="lang-popover" aria-hidden="true">
aria-hidden="true">
<li role="presentation">Loading...</li> <li role="presentation">Loading...</li>
</ul> </ul>
</div> </div>
@ -37,9 +33,9 @@
<div class="admonition warning"> <div class="admonition warning">
<p class="first admonition-title">Note</p> <p class="first admonition-title">Note</p>
<p class="last"> <p class="last">
You are not using the most up to date version of the documentation. You are not using the most up to date version of the documentation.
<a href="#"></a> is the newest version. <a href="#"></a> is the newest version.
</p> </p>
</div> </div>
</template> </template>
</div> </div>

376
build_files/theme/css/theme_overrides.css
View File

@ -6,108 +6,38 @@
* https://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx.application.Sphinx.add_css_file * https://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx.application.Sphinx.add_css_file
*/ */
h5 { /* Slightly decrease text to make the text fit on one line */
margin-bottom: 5px .sidebar-brand-text {
font-size: 1.4rem;
} }
/* Sidebar menu links. */ /* Add more visual weight to defintion terms */
.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a:hover { dl dt {
background: #c0c0c0 font-weight: bold !important
} }
.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a:hover { /* Fixes to field list, see #104636 */
background: #b5b5b5 dl.field-list {
} display: grid;
grid-template-columns: fit-content(24px) auto !important;
.wy-menu-vertical li.toctree-l4 { p {
font-size: 1em margin-bottom: 0;
} }
.wy-menu-vertical li.current a {
border: 0
}
.wy-side-nav-search>a:hover {
background: none;
opacity: 0.9
}
.wy-side-nav-search>a.icon::before {
content: none
}
.wy-menu-vertical p.caption {
color: #e6e6e6;
}
/* Ensure background of input fields is light color even when a local theme wants it to be dark. */
input[type="text"],
input[type="search"],
input[type="password"],
input[type="email"],
input[type="url"],
input[type="date"],
input[type="month"],
input[type="week"],
input[type="time"],
input[type="datetime"],
input[type="datetime-local"],
input[type="number"],
input[type="tel"],
input[type="color"] {
background-color: #FCFCFC;
} }
/* Boxed paragraphs. */ /* Boxed paragraphs. */
.rst-content .refbox .admonition-title { .admonition.refbox {
background-color: #bbb border-color: rgb(50, 50, 50);
} }
.rst-content .refbox { .admonition.refbox>.admonition-title {
background-color: #e3e3e3 background-color: rgba(50, 50, 50, 0.1);
border-color: rgb(50, 50, 50);
} }
.rst-content .seealso .admonition-title { .admonition.refbox>.admonition-title::before {
background-color: #7a87e6 background-color: rgb(50, 50, 50);
}
.rst-content .seealso {
background-color: #e7ebfa
}
.rst-content .important .admonition-title {
background-color: #ddca3b
}
.rst-content .important {
background-color: #f6f3a5
}
/* refbox =, seealso ( > ), note ( i ), tip i , hint (+), warn / ! \ */
.refbox .admonition-title::before {
content: "\f00b"
}
.seealso .admonition-title::before {
content: "\f138"
}
.note .admonition-title::before {
content: "\f05a"
}
.tip .admonition-title::before {
content: "\f129";
width: 0.75em;
text-align: center
}
.hint .admonition-title::before {
content: "\f055"
}
.warning .admonition-title::before {
content: "\f071"
} }
/* 'refbox' field. */ /* 'refbox' field. */
@ -120,27 +50,8 @@ input[type="color"] {
font-weight: normal font-weight: normal
} }
/* Ugly 'red' literals. */
.rst-content tt.literal,
.rst-content tt.literal,
.rst-content code.literal {
color: #404040;
border-radius: .4em;
}
/* Literal blocks that use too much padding, make them look like regular literals. */ /* Fix definitions with different ids. */
.rst-content pre.literal-block {
font-size: 75%;
margin: 0;
padding: 2px 4px;
color: #404040;
background: #ffffff;
white-space: normal;
display: inline;
border-radius: .4em;
}
/* Fix definisions with different ids. */
.rst-content dl.simple { .rst-content dl.simple {
margin-bottom: 0px; margin-bottom: 0px;
} }
@ -162,113 +73,35 @@ input[type="color"] {
padding-top: 12px; padding-top: 12px;
} }
/* Without this, paragraphs in bullet points within definition lists have too much vertical padding. */
.rst-content li>p {
margin-bottom: 0px !important;
}
/* TABLE & FIGURE */ /* TABLE & FIGURE */
/* captions text style */
.rst-content .figure .caption,
.rst-content figure figcaption>p,
.rst-content table.docutils caption,
.rst-content table.field-list caption {
font: italic 90%/18px Lato, proxima-nova, 'Helvetica Neue', Arial, sans-serif;
color: #808080;
}
/* Captions top padding. */
.rst-content .figure .caption,
.rst-content figure figcaption {
margin-top: 4px;
}
.rst-content table.docutils caption {
padding: 0.5em;
}
/* Text word wrap. */
.wy-table-responsive table td,
.wy-table-responsive table th {
white-space: normal;
}
/* Cell's vertical align. */ /* Cell's vertical align. */
/* use "valign" class for middle align. */ /* use "valign" class for middle align. */
.rst-content table.docutils:not(.valign) td { table.docutils:not(.valign) td {
vertical-align: baseline; vertical-align: baseline;
} }
/* Field list align. */
.rst-content table.field-list td {
padding-top: 8px;
}
/* Table header cells border color. */
.rst-content table.docutils th {
border-color: #e1e4e5;
}
/* Figure in table margin. */
.rst-content td div.figure,
.rst-content td figure {
margin-top: 4px;
margin-bottom: 0;
}
/* Figure legend. */
.legend {
font-size: 90%;
color: #484848;
margin-top: -20px;
}
.rst-content dl .legend {
margin-top: -10px;
}
@media screen and (max-width: 768px) {
.wy-table-responsive table:not(.footnote) {
min-width: 520px;
}
.rst-content table.docutils caption {
text-align: left;
}
img {
width: auto;
}
}
/* End TABLE & FIGURE. */ /* End TABLE & FIGURE. */
/* Video center. */
iframe {
display: block;
margin: 0 auto 24px auto;
border: 0;
max-width: 100%;
}
/* Copyright font scale down. */
footer p {
font-size: smaller
}
.footer-contribute { .footer-contribute {
display: block; display: block;
font-size: smaller; font-size: var(--font-size--small);
margin-top: -12px }
.bottom-of-page {
padding-bottom: 0;
}
.footer-contribute ul {
margin: 0;
padding: 0;
padding-bottom: 1rem
} }
.footer-contribute li { .footer-contribute li {
display: inline; display: inline;
list-style-type: none; list-style-type: none;
padding-right: 20px; padding-right: 1.5rem;
} }
/* Quotes for Fig. "link". */ /* Quotes for Fig. "link". */
@ -280,17 +113,16 @@ a[href^="#fig-"]::after {
content: "\201d"; content: "\201d";
} }
/* Intermediate headline. */
.rubric {
font-family: "Roboto Slab", "ff-tisa-web-pro", "Georgia", Arial, sans-serif
}
/* ".. container::" lead, block text float around image. */ /* ".. container::" lead, block text float around image. */
.lead { .lead {
clear: both; clear: both;
width: 100%; width: 100%;
} }
a {
text-decoration: none;
}
/* Mark external links. */ /* Mark external links. */
a.external { a.external {
color: #656AE0; color: #656AE0;
@ -303,33 +135,11 @@ a.external {
color: #2980B9; color: #2980B9;
} }
/* Draws a box around menuselection role. */
.menuselection {
font-family: "Lato", "proxima-nova", "Helvetica Neue", Arial, sans-serif;
font-size: 90%;
font-weight: normal;
background-color: rgba(255, 255, 255, 0.65);
border: solid #E1E4E5 1px;
padding: 2px 5px;
border-radius: .4em;
}
@media screen and (max-width: 420px) {
.menuselection {
white-space: normal
}
}
.caption .menuselection { .caption .menuselection {
background-color: transparent; background-color: transparent;
border: none; border: none;
} }
/* Remove indent on line break. */
.rst-content .line-block {
margin-left: 0px
}
/* Applied on main index:sections. */ /* Applied on main index:sections. */
.global-index-toc { .global-index-toc {
@ -339,7 +149,7 @@ a.external {
/* Start section cards. */ /* Start section cards. */
.toc-cards { .toc-cards {
display: grid; display: grid;
grid-template-columns: repeat(auto-fit, minmax(225px, 1fr)); grid-template-columns: repeat(auto-fit, minmax(350px, 1fr));
grid-gap: 20px; grid-gap: 20px;
list-style-type: none; list-style-type: none;
margin-bottom: 24px; margin-bottom: 24px;
@ -379,20 +189,19 @@ a.external {
} }
.card dl dt { .card dl dt {
padding: 18px 15px 0px !important padding: 0px 15px 0px !important
} }
.card dl dd { .card dl dd {
padding: 0px 15px 5px 15px; padding: 0px 15px 5px 15px;
font-style: normal; font-style: normal;
margin: 0px; margin: 0px;
color: #808080; color: var(--color-foreground-secondary);
font-size: 90%; font-size: 90%;
} }
.card { .card {
box-shadow: rgba(0, 0, 0, 0.05) 0px 1px 4px 0px, box-shadow: 0 .2rem .5rem rgba(0, 0, 0, .05), 0 0 .0625rem rgba(0, 0, 0, .1);
rgba(211, 216, 223, 0.33) 0px 15px 20px -1px;
} }
#getting-started .card { #getting-started .card {
@ -402,107 +211,22 @@ a.external {
/* End section cards. */ /* End section cards. */
/* Start custom toctree. */ /* Start custom toctree. */
.toctree-wrapper .toctree-l1>a {
margin-bottom: 0.15em
}
/* Indent all lines following the first. */ /* Indent all lines following the first. */
.toctree-wrapper * a { .toctree-wrapper * a {
display: block; display: block;
width: 90%;
text-indent: -1em;
margin-left: 1em;
/*invert indent*/
padding-top: 0.25em; padding-top: 0.25em;
line-height: 1.25em; }
.toctree-wrapper ul {
width: 90%;
list-style: none;
padding-left: 0;
} }
/* Underline provided by nested ul (not li). */ /* Underline provided by nested ul (not li). */
.toctree-wrapper * ul { .toctree-wrapper * ul {
border-top: solid var(--color-background-border) 2px;
padding-left: 2em; padding-left: 2em;
border-top: solid #ececec 1px;
} }
.toctree-wrapper>ul { /* End custom toctree. */
margin-left: 1em
}
.rst-content .toctree-wrapper ul li ul {
margin-bottom: 0.75em;
padding-top: 0.5em;
}
.rst-content .toctree-wrapper ul li a:hover {
color: #25afef
}
.rst-content .toctree-wrapper ul li a:visited:hover {
color: #C961DA
}
.toctree-wrapper .toctree-l1>a {
font-size: 104%
}
.toctree-wrapper .toctree-l2>a {
font-size: 102%
}
.toctree-wrapper .toctree-l3>a {
font-size: 100%
}
.toctree-wrapper .toctree-l1>ul {
border-color: #bfbfbf
}
.toctree-wrapper .toctree-l2>ul {
border-color: #e1e0e0
}
.toctree-wrapper .toctree-l3>ul {
border-color: #ececec
}
/* Remove list styling, css rule hierarchy. */
.rst-content .toctree-wrapper ul li,
.rst-content .toctree-wrapper ul li li,
.rst-content .toctree-wrapper ul li li li {
list-style-type: none;
margin-left: 0px;
}
/* End custom toctree. */
/* Start genindex consistency. */
.genindextable * strong {
font-weight: normal
}
.genindex-jumpbox {
margin-bottom: 1.245em
}
.indextable {
margin-bottom: 1.245em
}
/* End genindex consistency. */
/* Correctly display keyboard shortcuts inside definition lists (theme.css explicitly excludes this case for some reason) */
dt>kbd {
font-weight: normal;
font-size: 80%;
background-color: #fff;
border: 1px solid #a6a6a6;
border-radius: 4px;
box-shadow: 0 2px grey;
padding: 2.4px 6px;
margin: auto 0;
}
/* Fixes to field list, see #104636 */
.field-list {
grid-template-columns: fit-content(24px) auto !important;
}

66
build_files/theme/css/version_switch.css
View File

@ -14,36 +14,38 @@
} }
#versionwrap { #versionwrap {
margin: 0;
display: flex; display: flex;
padding-top: 2px; padding-top: 2px;
font-size: 90%; padding-left: 0;
font-size: var(--sidebar-item-font-size);
justify-content: center; justify-content: center;
flex-wrap: wrap; flex-wrap: wrap;
} }
#versionwrap>ul {
list-style: none;
}
#versionwrap>li {
display: flex;
width: 50%;
}
.version-btn { .version-btn {
display: inline-block; display: inline-block;
background-color: #272525; background-color: var(--color-sidebar-background);
width: 140px; width: 100%;
text-align: center; text-align: center;
padding: 3px 10px; padding: 3px 10px;
margin: 0px 5px 4px; margin: 0px 5px 4px;
vertical-align: middle; vertical-align: middle;
color: #27AE60; color: var(--color-link);
border: solid 1px #444444; border: solid 1px var(--color-sidebar-background-border);
border-radius: 3px; border-radius: 3px;
cursor: pointer; cursor: pointer;
z-index: 400; z-index: 400;
transition: border-color 0.4s;
}
.version-btn::after {
content: "\f0d8";
display: inline;
font: normal normal normal 16px/1 FontAwesome;
color: #8d8c8c;
vertical-align: top;
padding-left: 0.5em;
} }
.version-btn-open::after { .version-btn-open::after {
@ -57,7 +59,7 @@
.version-btn-open { .version-btn-open {
color: gray; color: gray;
border: solid 1px gray; border: solid 1px var(--color-sidebar-background-border);
} }
.version-btn.wait { .version-btn.wait {
@ -73,7 +75,7 @@
display: none; display: none;
position: absolute; position: absolute;
bottom: 28px; bottom: 28px;
width: 140px; width: 50%;
margin: 0 5px; margin: 0 5px;
padding-bottom: 4px; padding-bottom: 4px;
background-color: #0003; background-color: #0003;
@ -81,6 +83,7 @@
box-shadow: 0 0 6px #000C; box-shadow: 0 0 6px #000C;
z-index: 999; z-index: 999;
max-height: calc(100vh - 30px); max-height: calc(100vh - 30px);
overflow-x: clip;
overflow-y: auto; overflow-y: auto;
cursor: default; cursor: default;
} }
@ -90,15 +93,17 @@
color: black; color: black;
text-align: center; text-align: center;
font-size: 102%; font-size: 102%;
background-color: #27ae60; background-color: var(--color-brand-primary);
border-bottom: solid 1.5px #444; border-bottom: solid 1.5px var(--color-sidebar-background-border);
} }
.version-list { .version-list {
padding-left: 0;
margin-top: 0;
margin-bottom: 4px; margin-bottom: 4px;
text-align: center; text-align: center;
background-color: #000C; background-color: #000C;
border: solid 1px gray; border: solid 1px var(--color-sidebar-background-border);
border-radius: 0px 0px 3px 3px; border-radius: 0px 0px 3px 3px;
} }
@ -112,12 +117,12 @@
width: 100%; width: 100%;
margin: 0; margin: 0;
padding: 4px 0px; padding: 4px 0px;
color: #404040; color: var(--color-sidebar-link-text);
} }
.version-list li { .version-list li {
background-color: #ede9e9; background-color: var(--color-sidebar-background);
color: #404040; color: var(--color-sidebar-link-text);
padding: 1px; padding: 1px;
} }
@ -134,17 +139,4 @@
.version-list li.selected span { .version-list li.selected span {
cursor: default; cursor: default;
outline-color: red; outline-color: red;
} }
.version-arrow {
position: absolute;
width: 8px;
height: 8px;
left: 50%;
bottom: 4px;
margin-left: -4px;
transform: rotate(225deg);
background: #ede9e9;
border: 1px solid gray;
border-width: 1px 0 0 1px;
}

35
manual/conf.py
View File

@ -118,11 +118,11 @@ gettext_allow_fuzzy_translations = False
# The theme to use for HTML and HTML Help pages. See the documentation for # The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes. # a list of builtin themes.
html_theme = "default" html_theme = "basic"
try: try:
import sphinx_rtd_theme import furo
html_theme = "sphinx_rtd_theme" html_theme = "furo"
del sphinx_rtd_theme del furo
except ModuleNotFoundError: except ModuleNotFoundError:
pass pass
@ -135,21 +135,30 @@ html_theme_options = {}
# the configuration directory. # the configuration directory.
html_theme_path = [] html_theme_path = []
if html_theme == "sphinx_rtd_theme": if html_theme == "furo":
html_theme_options = { html_theme_options = {
"analytics_id": "UA-1418081-1", "source_edit_link": "https://projects.blender.org/blender/blender-manual/src/branch/main/manual/{filename}",
# included in the title
"display_version": False,
"collapse_navigation": True,
"navigation_depth": -1,
} }
extensions.append('sphinx_rtd_theme') html_sidebars = {
"**": [
"sidebar/brand.html",
"sidebar/search.html",
"sidebar/scroll-start.html",
"sidebar/navigation.html",
"sidebar/scroll-end.html",
"sidebar/variant-selector.html",
]
}
html_context = {
"analytics_id": "UA-1418081-1",
}
# The "title" for HTML documentation generated with Sphinx's own templates. # The "title" for HTML documentation generated with Sphinx's own templates.
# This is appended to the <title> tag of individual pages, and # This is appended to the <title> tag of individual pages, and
# used in the navigation bar as the "topmost" element. # used in the navigation bar as the "topmost" element.
html_title = "Blender Manual" html_title = 'Blender %s Manual' % blender_version
# The base URL which points to the root of the HTML documentation. # The base URL which points to the root of the HTML documentation.
# It is used to indicate the location of document using # It is used to indicate the location of document using
@ -168,7 +177,7 @@ html_logo = "../build_files/theme/blender-logo.svg"
# the docs, or URL that points an image file for the favicon. # the docs, or URL that points an image file for the favicon.
html_favicon = "../build_files/theme/favicon.ico" html_favicon = "../build_files/theme/favicon.ico"
if html_theme == "sphinx_rtd_theme": if html_theme == "furo":
html_css_files = ["css/theme_overrides.css", html_css_files = ["css/theme_overrides.css",
"css/version_switch.css"] "css/version_switch.css"]
html_js_files = ["js/version_switch.js"] html_js_files = ["js/version_switch.js"]

2
requirements.txt
View File

@ -13,7 +13,7 @@ sphinx-intl==2.1.0
# Only needed to match the theme used for the official documentation. # Only needed to match the theme used for the official documentation.
# Without this theme, the default theme will be used. # Without this theme, the default theme will be used.
sphinx_rtd_theme==2.0.0 furo==2024.1.29
# Only for convenience, allows live updating while editing RST files. # Only for convenience, allows live updating while editing RST files.
# Access by running: # Access by running: