docs: change sphinx theme to Clarity

.github/workflows/build.yml

@@ -25,11 +25,22 @@ jobs:
           git describe --tags --long --always > RELEASE || true
           git describe --tags --exact-match > TAG || true
 
-      - name: Build
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Build HTML
+        run: make html
+
+      - name: Build man and pdf
         uses: docker://docker.io/sphinxdoc/sphinx-latexpdf:latest
         with:
           entrypoint: make
-          args: html man latexpdf
+          args: man latexpdf
 
       - name: Archive artifacts (html)
         uses: actions/upload-artifact@v4

.gitignore

@@ -4,3 +4,7 @@ _deployed.old
 _syncthing
 /RELEASE
 /TAG
+.venv/
+venv/
+__pycache__/
+_site/

README.rst

@@ -19,8 +19,8 @@ beneficial.
 First steps to run it locally::
 
   git clone https://github.com/syncthing/docs.git
-  pip install -U Sphinx
   cd docs
+  pip install -r requirements.txt
   make html
   # open _build/html/index.html
 

_script/lsver.go

@@ -32,11 +32,18 @@ func lsver(dir string) error {
 		}
 	}
 	sort.Slice(names, func(a, b int) bool {
-		return compareVersions(names[a], names[b]) < 0
+		return compareVersions(names[a], names[b]) > 0
 	})
 
+	type entry struct {
+		Version string `json:"version"`
+	}
+	result := make([]entry, len(names))
+	for i, name := range names {
+		result[i] = entry{Version: name}
+	}
 	enc := json.NewEncoder(os.Stdout)
-	return enc.Encode(map[string][]string{"entries": names})
+	return enc.Encode(result)
 }
 
 func compareVersions(a, b string) int {

_static/custom.css

@@ -1,94 +1,5 @@
-@media screen and (max-width: 875px) {
-  div.body {
-    /* prevent horizontal overflowing on mobile */
-    min-width: inherit;
-  }
-}
-
-p.logo {
-  text-align: left;
-}
-img.logo {
-  height: 66px;
-  margin-bottom: 20px;
-}
-
-img.border {
-  border: 1px solid #888;
-  border-radius: 5px;
-}
-
-div#searchbox,
-div.sphinxsidebar h3.donation {
-  margin-top: 20px;
-}
-
-div.body {
-  /* margin here is same as height + margin of logo */
-  margin-top: 86px;
-}
-
-div.footer-body {
-  /* hack for the "edit on github" container below the body */
-  margin-top: 30px;
-  margin-bottom: 20px;
-  text-align: center;
-}
-
-li.toctree-l1 {
-  margin-top: 1em;
-}
-
-/* Add a strike-through class. */
-.strike {
-  text-decoration: line-through;
-}
-
-div.note {
-  background-color: #ffc;
-}
-div.admonition {
-  /* reduce default padding a bit because it's asymmetrical and ugly */
-  padding: 5px;
-}
-div.admonition p.admonition-title {
-  font-size: inherit;
-  font-weight: bold;
-}
-p.admonition-title:after {
-  content: none;
-}
-
-/* Override Alabaster theme defaults to add space between list items. */
-li > p:last-child {
-  margin-bottom: 1em;
-}
-li:last-child > p:last-child {
-  margin-bottom: 0;
-}
-
-/* Overrides for built in contents directive */
-div.contents {
-  margin: inherit;
-  padding: inherit;
-  background-color: inherit;
-  border: inherit;
-}
-div.contents li > p:last-child {
-  margin-bottom: inherit;
-}
-
-pre {
-  padding: 8px;
-}
-
-/* Make terms bold in definition lists for better visibility, e.g. in
-   users/config. */
-dt {
-  font-weight: bold;
-}
-
-/* Extra padding after configuration options in e.g. in users/config. */
-dl.option {
-    margin-bottom: 1em;
-}
+/* Display text and icon nicely vertically aligned */
+.edit-page-source {
+    display: flex;
+    align-items: center;
+}