Polling for pygments style for our future doc

[Kwankyu Lee]

Hi,

As you seem want more fun in selecting our future doc style, 

I prepared three candidates for the pygments styles to along with the upcoming Furo theme.

(1) tango

(2) default

(3) sphinx

Please vote!

[G. M.-S.]

I prefer sphinx.

Guillermo

[sver...@gmail.com]

> Please vote!

(1) tango.

best regards

Sverre Lunøe-Nielsen

On Thursday, August 4, 2022 at 10:51:25 AM UTC+2 Kwankyu Lee wrote:

Hi,

As you seem want more fun in selecting our future doc style, 

I prepared three candidates for the pygments styles to along with the upcoming Furo theme.

(1) tango

(2) default

(3) sphinx

Please vote!

[John Cremona]

Thanks for setting up the vote.

I vote for sphinx (with default as 2nd choice).

John

--
You received this message because you are subscribed to the Google Groups "sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/b0684613-73f5-4db6-a5c6-1ad67c383c6dn%40googlegroups.com.

[Kwankyu Lee]

For your informed decision, visit

(1) tango: https://2505ea042169d8a179d4b1f28a0c0baeabdd421a--sagemath-tobias.netlify.app/tutorial/tour_linalg.html

(2) default: https://54ea9f6ae8fa30e96afa5304e0c11cf99f055158--sagemath-tobias.netlify.app/tutorial/tour_linalg.html

(3) sphinx: https://4c5a03db3ec20647b9da62c0e44271901c2dd58d--sagemath-tobias.netlify.app/tutorial/tour_linalg.html

[Dima Pasechnik]

sphinx

--

You received this message because you are subscribed to the Google Groups "sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/ad6bf704-5b65-4f3d-8818-e20598ade818n%40googlegroups.com.

[davida...@gmail.com]

+1 for sphinx

[Eric Gourgoulhon]

Thanks for preparing this poll. I vote for

(1) tango

Eric.

[David Coudert]

+1 for sphinx

I don't like the italic in tango.

David.

[Matthias Koeppe]

default > sphinx > tango

[Nathan Dunfield]

I prefer sphinx with default as my second choice.

I like the colors in tango, but making all the output in italic is really ugly, especially with the larger matrices in

https://2505ea042169d8a179d4b1f28a0c0baeabdd421a--sagemath-tobias.netlify.app/tutorial/tour_linalg.html

Best,

Nathan

[Eric Gourgoulhon]

Le jeudi 4 août 2022 à 18:33:27 UTC+2, Eric Gourgoulhon a écrit :

Thanks for preparing this poll. I vote for

(1) tango

Sorry, I missed the point about the italic. Please change my vote to

(2) default

Eric.

[David Roe]

default > sphinx > tango.  I agree that the italics are the main issue with tango; I like the color scheme more than the other two.

David

--

You received this message because you are subscribed to the Google Groups "sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+...@googlegroups.com.

To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/d440018e-7c41-4371-90be-ddb3a4eb9e33n%40googlegroups.com.

[dmo...@deductivepress.ca]

sphinx > default  >>  tango

I agree with the previous criticisms of tango: low contrast (makes it hard to read), italic output, and blue numbers that are too intense.

[TB]

sphinx > default  > tango

1. For the color choice alone, I prefer the colors of tango over the colors of default, with exception for C and Cython code. For comparison:

(tango) https://2505ea042169d8a179d4b1f28a0c0baeabdd421a--sagemath-tobias.netlify.app/thematic_tutorials/cython_interface.html#arguments-and-return-value

(default) https://54ea9f6ae8fa30e96afa5304e0c11cf99f055158--sagemath-tobias.netlify.app/thematic_tutorials/cython_interface.html#arguments-and-return-value

(sphinx) https://4c5a03db3ec20647b9da62c0e44271901c2dd58d--sagemath-tobias.netlify.app/thematic_tutorials/cython_interface.html#arguments-and-return-value

2. Even better colors (more contrast, better background and easier to read) are in the dark theme. I think it is the monokai theme.

Regards,

TB

To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/ea8d0d59-8815-4c1e-91a3-74bf3eb39cban%40googlegroups.com.

[William Stein]

I vote for sphinx

To view this discussion on the web visit https://groups.google.com/d/msgid/sage-devel/2f6f2ba0-7a72-75ec-cafb-4841b292d7e0%40gmail.com.

--

-- William Stein

[Kwankyu Lee]

Up to now, the voting counts

(1) tango: 1

(2) default: 2

(3) sphinx: 10

and sphinx is the clear winner. So I close the voting. Thank you who participated.

Accordingly, I will update #33833 "Make furo sage standard doc theme" to use the sphinx pygments style.

As I noted elsewhere, we don't need to stick to a builtin style. I hope that someone with designer sense would make a custom style that best suits sage example code blocks. It is a breeze to replace pygments style in Furo theme.

Thank you all!