Add working examples and changelog docs pages

README.md

@@ -125,6 +125,8 @@ Options
 Working examples
 ----------------
 
+<!--working-examples-start-->
+
 Here are some repos that use cibuildwheel.
 
 <!-- START bin/projects.py -->
@@ -251,6 +253,8 @@ Here are some repos that use cibuildwheel.
 >
 > <sup>I'd like to include notes here to indicate why an example might be interesting to cibuildwheel users - the styles/technologies/techniques used in each. Please include that in future additions!</sup>
 
+<!--working-examples-end-->
+
 Legal note
 ----------
 
@@ -263,6 +267,8 @@ This is similar to static linking, so it might have some licence implications. C
 Changelog
 =========
 
+<!--changelog-start-->
+
 ### 1.7.1
 
 _3 December 2020_
@@ -670,6 +676,8 @@ _31 March 2017_
 
 - 🌟 First public release!
 
+<!--changelog-end-->
+
 Contributing
 ============
 

docs/changelog.md

@@ -0,0 +1,17 @@
+---
+title: Changelog
+---
+
+{%
+   includemarkdown "../README.md"
+   start="<!--changelog-start-->"
+   end="<!--changelog-end-->"
+%}
+
+<script>
+  // undo the scrollTop that the theme did on this page, as there are loads
+  // of toc entries and it's disorientating.
+  window.addEventListener('DOMContentLoaded', function() {
+    $('.wy-nav-side').scrollTop(0)
+  })
+</script>

docs/extra.css

@@ -29,7 +29,6 @@ h1, h2, h3, h4, h5, h6 {
     border-bottom: 1px solid  #e1e4e5;
     margin-bottom: 0.8em;
     padding-bottom: 0.2em;
-
 }
 
 .rst-content blockquote {

docs/working-examples.md

@@ -0,0 +1,20 @@
+---
+title: Working examples
+---
+
+{%
+   includemarkdown "../README.md"
+   start="<!--working-examples-start-->"
+   end="<!--working-examples-end-->"
+%}
+
+<style>
+.wy-nav-content {
+  /* this table benefits from a wider page */
+  max-width: 1000px;
+}
+.rst-content .section table img {
+  /* make the icons darker on this page */
+  filter: brightness(0.5);
+}
+</style>

mkdocs.yml

@@ -20,7 +20,9 @@ nav:
   - deliver-to-pypi.md
   - cpp_standards.md
   - faq.md
+  - working-examples.md
   - contributing.md
+  - changelog.md
 
 markdown_extensions:
   - fenced_code