Add section permalinks to docs

- Configure mkdocs to use the toc markdown extension
- Only show section link styles on hover

docs_theme/css/default.css

@@ -413,3 +413,7 @@ ul.sponsor {
 #mkdocs_search_modal article p{
   word-wrap: break-word;
 }
+
+.toclink {
+  color: #333;
+}

mkdocs.yml

@@ -6,6 +6,10 @@ repo_url: https://github.com/tomchristie/django-rest-framework
 
 theme_dir: docs_theme
 
+markdown_extensions:
+ - toc:
+    anchorlink: True
+
 pages:
  - Home: 'index.md'
  - Tutorial: