-
-
Notifications
You must be signed in to change notification settings - Fork 127
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1231 from python-discord/docs/dark-theme-dev
Add docs for development on Bulma, CSS, and dark mode colors
- Loading branch information
Showing
4 changed files
with
50 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
# Static CSS files | ||
|
||
When styling components, oftentimes you can make good use of Bulma classes | ||
rather than hardcoding CSS rules: | ||
|
||
- [Bulma color helpers](https://bulma.io/documentation/helpers/color-helpers/): | ||
Classes that can be added to pretty much all Bulma components to give them a | ||
text or background color which are defined in [`BULMA_SETTINGS`](../settings.py). | ||
- [Bulma typography helpers](https://bulma.io/documentation/helpers/typography-helpers/): | ||
Classes you can add to divs and text elements to adjust the text properties | ||
and alignment. | ||
- [Bulma visibility helpers](https://bulma.io/documentation/helpers/visibility-helpers/): | ||
Rather than hardcoding screen width cutoffs just to adjust visibility, use | ||
these classes instead as they are more descriptive and provide more | ||
flexibility. | ||
|
||
To adjust Bulma variables (including color, sizes, margins) for a Bulma class | ||
everywhere, adjust the variables in [`BULMA_SETTINGS`](../../settings.py) where | ||
applicable. The [Bulma | ||
Variables](https://bulma.io/documentation/customize/variables/) page describes | ||
the list of all variables and their default values. | ||
|
||
That said, however, sometimes Bulma does not provide a good generalized | ||
solution for a specific use case or for a specific element. In that case, use | ||
CSS selectors to ensure that other elements that should not be styled are not | ||
affected by the rule, and when working with colors, ensure both light and dark | ||
modes are supported. Use `[data-theme="light"]` and `[data-theme="dark"]` to | ||
style elements for specific themes. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
# Image assets | ||
|
||
The names of each directory correspond to the pages from which apps they are | ||
used, except for the homepage, which uses `frontpage`, `waves`, `waves_dark`, | ||
`sponsors`, and `sponsors_dark`. | ||
|
||
Directories with the `_dark` suffix store alternate images to the ones in the | ||
corresponding directory without the `_dark` suffix. When using these alternate | ||
images, use the `light-image` class for the normal image and the `dark-image` | ||
class for the image intended for dark mode. | ||
|
||
The exception to this is the `waves_dark`, which is used in the homepage hero | ||
section and the images are set by CSS using `[data-theme="light"]` and | ||
`[data-theme="dark"]`. |