dark background

[meleu]

The official website and the https://retroachievements.github.io/ front page has a dark background. Then it would be nice to have a similar look & feel in the docs.

AFAIK the MkDocs Material theme doesn't provide a way to change the background so easily. It must be done by tweaking CSS.

@luchaos looks like you're familiar with CSS stuff. If you have some free time could you help on this front?

In this post there's a guy who seems that made it.

EDIT: I think he shared his extra.css file here: https://github.com/fmaida/mkdocs-material-dark-theme I'll try it as soon as I get home. :)

[luchaos]

@meleu for the sake of consistency it would be nice to have similar appearances, agreed. i'd love to give it a treat! (i forked this repo some hours ago - just in case y'know ;)

[meleu]

@luchaos oh... The pages generation should be done by the generate-docs.sh script.

Then, if you're unable to run the script (not on a Linux-like system) you have to perform some tasks manually. Such as fetching the .md files from the wiki, and manually add the pages: section in mkdocs.yml.

Let me know if you need any help to generate the pages for your tests. ;-)

[meleu]

@luchaos I used this extra.css to get a dark background: https://github.com/fmaida/mkdocs-material-dark-theme

And here is the results (it's online, by the way):

As you said "for the sake of consistency it would be nice to have similar appearances". Then I think we could try to change those cyan letters to that bright orange like we have on the landing page.

I suck at CSS, but if you know how to change it directly on the file, here it is: https://github.com/RetroAchievements/docs/blob/master/css/extra.css

Thanks in advance for all your help with this web stuff! 😉

[meleu]

looks like the light theme is OK. Let's close this issue for now.

Thanks again for all your help @luchaos .