Revive furo

Question

Revive furo

Closed this issue 3 years ago · 25 comments

kwankyu commented 3 years ago

Specifically html/en/index.html page is now based on furo's page.html for furo theme.

Along the way, we fix here and there so that

pdf docs also build
logo links to the documentation root
search page works
white sage logo is transparent

Hence our doc in furo theme is now quite functional.

CC: @yuan-zhou @tobiasdiez

Component: documentation

Author: Kwankyu Lee

Branch/Commit: 73e5aa3

Reviewer: Matthias Koeppe

Issue created by migration from https://trac.sagemath.org/ticket/34252

Answer 1 · 2022-07-30T22:49:02.000Z

Branch: u/klee/34252

Answer 2 · 2022-07-30T22:57:10.000Z

Commit: 9d1e07a

Answer 3 · 2022-07-30T22:57:10.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`9d1e07a`	`Revive furo`

Answer 4 · 2022-07-30T23:01:19.000Z

Description changed:

--- 
+++ 
@@ -1 +1 @@
-
+Specifically `html/en/index.html` page is now based on furo's `page.html` for furo theme.

Answer 5 · 2022-07-31T06:46:39.000Z

Changed commit from 9d1e07a to f19b597

Answer 6 · 2022-07-31T06:46:39.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`f19b597`	`Add link to the logo`

Answer 7 · 2022-07-31T06:51:08.000Z

Description changed:

--- 
+++ 
@@ -1 +1,10 @@
 Specifically `html/en/index.html` page is now based on furo's `page.html` for furo theme.
+
+Along the way, we fix here and there so that
+
+- pdf docs also build
+
+- logo links to the documentation root
+
+Hence our doc in furo theme is now quite functional.
+

Answer 8 · 2022-07-31T13:36:12.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`09d5f5c`	`Fix the logo link for reference`
`ae75d53`	`Fix a subtle reference problem for build_options`

Answer 9 · 2022-07-31T13:36:12.000Z

Changed commit from f19b597 to ae75d53

Answer 10 · 2022-07-31T23:19:21.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`3519bed`	`Run docbuild workflow with single thread`

Answer 11 · 2022-07-31T23:19:21.000Z

Changed commit from ae75d53 to 3519bed

Answer 12 · 2022-08-01T01:25:16.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`1274718`	`Fix a suspicious part of categories doc`

Answer 13 · 2022-08-01T01:25:16.000Z

Changed commit from 3519bed to 1274718

Answer 14 · 2022-08-01T07:52:06.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`e5b1f7e`	`Add search.html`

Answer 15 · 2022-08-01T07:52:06.000Z

Changed commit from 1274718 to e5b1f7e

Answer 16 · 2022-08-01T07:52:34.000Z

Description changed:

--- 
+++ 
@@ -6,5 +6,7 @@
 
 - logo links to the documentation root
 
+- search page works
+
 Hence our doc in furo theme is now quite functional.

Answer 17 · 2022-08-01T13:00:36.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`ebd3b77`	`Better pygments style`

Answer 18 · 2022-08-01T13:00:36.000Z

Changed commit from e5b1f7e to ebd3b77

Answer 19 · 2022-08-01T15:12:35.000Z

Changed commit from ebd3b77 to 73e5aa3

Answer 20 · 2022-08-01T15:12:35.000Z

Branch pushed to git repo; I updated commit sha1. New commits:

`73e5aa3`	`Make white logo transparent to match with furo`

Answer 21 · 2022-08-01T15:14:14.000Z

Description changed:

--- 
+++ 
@@ -3,10 +3,9 @@
 Along the way, we fix here and there so that
 
 - pdf docs also build
-
 - logo links to the documentation root
-
 - search page works
+- white sage logo is transparent
 
 Hence our doc in furo theme is now quite functional.

Answer 22 · 2022-08-01T18:58:49.000Z

comment:15

This looks excellent.

Answer 23 · 2022-08-01T18:58:49.000Z

Reviewer: Matthias Koeppe

Answer 24 · 2022-08-01T22:26:47.000Z

comment:16

Thank you!

Answer 25 · 2022-08-04T22:46:49.000Z

Changed branch from u/klee/34252 to 73e5aa3