Add new rebuild section in about pages

Author: GuillaumeGomez

src/web/sitemap.rs

@@ -143,6 +143,7 @@ about_page!(AboutPageMetadata, "core/about/metadata.html");
 about_page!(AboutPageRedirection, "core/about/redirections.html");
 about_page!(AboutPageDownload, "core/about/download.html");
 about_page!(AboutPageRustdocJson, "core/about/rustdoc-json.html");
+about_page!(AboutPageRebuild, "core/about/rebuild.html");
 
 pub(crate) async fn about_handler(subpage: Option<Path<String>>) -> AxumResult<impl IntoResponse> {
     let subpage = match subpage {
@@ -175,6 +176,10 @@ pub(crate) async fn about_handler(subpage: Option<Path<String>>) -> AxumResult<i
             active_tab: "rustdoc-json",
         }
         .into_response(),
+        "rebuild" => AboutPageRebuild {
+            active_tab: "rebuild",
+        }
+        .into_response(),
         _ => {
             let msg = "This /about page does not exist. \
                 Perhaps you are interested in <a href=\"https://github.com/rust-lang/docs.rs/tree/master/templates/core/about\">creating</a> it?";

static/trigger-rebuild.png

@@ -19,6 +19,10 @@ <h1 id="crate-title" class="no-description">Docs.rs documentation</h1>
                         {% set text = "{} <span class='title'>Badges</span>"|format(text) %}
                         {% call macros::active_link(expected="badges", href="/about/badges", text=text) %}
 
+                        {% set text = crate::icons::IconRotateRight.render_solid(false, false, "") %}
+                        {% set text = "{} <span class='title'>Rebuild documentation</span>"|format(text) %}
+                        {% call macros::active_link(expected="rebuild", href="/about/rebuild", text=text) %}
+
                         {% set text = crate::icons::IconGears.render_solid(false, false, "") %}
                         {% set text = "{} <span class='title'>Builds</span>"|format(text) %}
                         {% call macros::active_link(expected="builds", href="/about/builds", text=text) %}

templates/about-base.html

@@ -108,7 +108,7 @@ <h4 id="hitting-resource-limits"> <a href="#hitting-resource-limits">Hitting res
 
     <h4 id="failures-and-rebuilds"> <a href="#failures-and-rebuilds">Other failures and requesting rebuilds</a> </h4>
     <p>
-        If your crate fails to build for a reason not listed here, please <a href="{{ docsrs_repo|safe }}/issues">file an issue</a>.
+        If your crate fails to build for a reason not listed here, you can either try to <a href="/about/rebuild">rebuild it</a> or <a href="{{ docsrs_repo|safe }}/issues">file an issue</a>.
         Some build failures can be fixed by Docs.rs, e.g., by issuing a rebuild after a bug in Docs.rs has been fixed.
     </p>
 

templates/core/about/builds.html

@@ -0,0 +1,18 @@
+{% extends "about-base.html" %}
+
+{%- block title -%} Rebuild {%- endblock title -%}
+
+{%- block body -%}
+    {%- set docsrs_repo = "https://github.com/rust-lang/docs.rs" -%}
+    <h1>Rebuild</h1>
+    <div class="about-page">
+        <div class="container pure-u-5-6 about">
+            <p>You can trigger a documentation rebuild for a specific version of your crates directly on <a href="https://crates.io">crates.io</a> website as you can see below:</p>
+
+            <img src="/-/static/trigger-rebuild.png" alt="crates.io dropdown menu showing two items: yank and rebuild docs">
+
+            <p>For more information on how documentation build works on <b>docs.rs</b>, take a look at the <a href="/about/builds">builds</a> page.</p>
+        </div>
+        <br/>
+    </div>
+{%- endblock body %}

templates/core/about/rebuild.html

@@ -208,6 +208,11 @@ pre {
 div.container {
     max-width: 1160px;
     text-align: left;
+
+    img {
+        max-width: 100%;
+        margin: 5px 0;
+    }
 }
 
 body.centered div.container {