Dark mode for generated JavaDoc pages

[Jonathan Gibbons]

Hi,

It's not an unreasonable suggestion; I have filed 
https://bugs.openjdk.java.net/browse/JDK-8253137 to track it.

That being said, there's two possibilities here:

1. A custom stylesheet to be used for a specific project's API.

There are command line options for javadoc to allow the default 
stylesheet to be overridden or augmented. In addition, we are continuing 
our campaign to clean up, simplify and eventually document the 
stylesheet used by the standard doclet, so that it is easier for folk to 
create alternative stylesheets, for themselves and maybe for others.

2. A more advanced stylesheet that allows and end-user to select the 
visual appearance of the generated docs. That's a bigger deal, and would 
probably entail doing the other option first, to at least develop an 
acceptable 'dark mode' style, before we consider the implications of 
using controls and cookies to manipulate the appearance of the generated 
docs.

-- Jon

On 9/14/20 10:24 AM, Nir Lisker wrote:
> Hi,
>
> Dark mode has become very popular in the past few years. However, the 
> html pages use a pure white background that is uncomfortable to read. 
> Will it be possible to add an option for dark mode? I believe it only 
> requires a new css file, and a cookie so that the browser remembers 
> the local setting.
>
> - Nir