Need to address other customizations I've made in https://github.com/simonw/datasette/blob/0.62a0/docs/_templates/layout.html - such as Plausible analytics and some custom JavaScript.

datasette/docs/_templates/layout.html

Lines 1 to 61 in 943aa2e

    
           {%- extends "!layout.html" %} 
        
           {% block htmltitle %} 
        
           {{ super() }} 
        
           <script defer data-domain="docs.datasette.io" src="https://plausible.io/js/plausible.js"></script> 
        
           {% endblock %} 
        
           {% block sidebartitle %} 
        
           <a href="https://datasette.io/"> 
        
             <img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="{{ _('Logo') }}"/> 
        
           </a> 
        
           {% if theme_display_version %} 
        
             {%- set nav_version = version %} 
        
             {% if READTHEDOCS and current_version %} 
        
               {%- set nav_version = current_version %} 
        
             {% endif %} 
        
             {% if nav_version %} 
        
               <div class="version"> 
        
                 {{ nav_version }} 
        
               </div> 
        
             {% endif %} 
        
           {% endif %} 
        
           {% include "searchbox.html" %} 
        
           {% endblock %} 
        
           {% block footer %} 
        
           {{ super() }} 
        
           <script> 
        
           jQuery(function ($) { 
        
             // Show banner linking to /stable/ if this is a /latest/ page 
        
             if (!/\/latest\//.test(location.pathname)) { 
        
               return; 
        
             } 
        
             var stableUrl = location.pathname.replace("/latest/", "/stable/"); 
        
             // Check it's not a 404 
        
             fetch(stableUrl, { method: "HEAD" }).then((response) => { 
        
               if (response.status == 200) { 
        
                 var warning = $( 
        
                   `<div class="admonition warning"> 
        
                      <p class="first admonition-title">Note</p> 
        
                      <p class="last"> 
        
                        This documentation covers the <strong>development version</strong> of Datasette.</p> 
        
                        <p>See <a href="${stableUrl}">this page</a> for the current stable release. 
        
                      </p> 
        
                   </div>` 
        
                 ); 
        
                 warning.find("a").attr("href", stableUrl); 
        
                 var body = $("div.body"); 
        
                 if (!body.length) { 
        
                   body = $("div.document"); 
        
                 } 
        
                 body.prepend(warning); 
        
               } 
        
             }); 
        
           }); 
        
           </script> 
        
           {% endblock %}

	{%- extends "!layout.html" %}

	{% block htmltitle %}
	{{ super() }}
	<script defer data-domain="docs.datasette.io" src="https://plausible.io/js/plausible.js"></script>
	{% endblock %}

	{% block sidebartitle %}

	<a href="https://datasette.io/">
	<img src="{{ pathto('_static/' + logo, 1) }}" class="logo" alt="{{ _('Logo') }}"/>
	</a>

	{% if theme_display_version %}
	{%- set nav_version = version %}
	{% if READTHEDOCS and current_version %}
	{%- set nav_version = current_version %}
	{% endif %}
	{% if nav_version %}
	<div class="version">
	{{ nav_version }}
	</div>
	{% endif %}
	{% endif %}

	{% include "searchbox.html" %}

	{% endblock %}

	{% block footer %}
	{{ super() }}
	<script>
	jQuery(function ($) {
	// Show banner linking to /stable/ if this is a /latest/ page
	if (!/\/latest\//.test(location.pathname)) {
	return;
	}
	var stableUrl = location.pathname.replace("/latest/", "/stable/");
	// Check it's not a 404
	fetch(stableUrl, { method: "HEAD" }).then((response) => {
	if (response.status == 200) {
	var warning = $(
	`<div class="admonition warning">
	<p class="first admonition-title">Note</p>
	<p class="last">
	This documentation covers the <strong>development version</strong> of Datasette.</p>
	<p>See <a href="${stableUrl}">this page</a> for the current stable release.
	</p>
	</div>`
	);
	warning.find("a").attr("href", stableUrl);
	var body = $("div.body");
	if (!body.length) {
	body = $("div.document");
	}
	body.prepend(warning);
	}
	});
	});
	</script>
	{% endblock %}

Uh oh!

Switch documentation theme to Furo #1746

Description

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions