From 1a7c6fbd324c662e682c491915f8995262c21d3d Mon Sep 17 00:00:00 2001 From: Dessalines Date: Sun, 15 Mar 2020 13:02:14 -0400 Subject: Add theming guide. Fixes #596 --- docs/src/SUMMARY.md | 1 + docs/src/contributing_theming.md | 18 ++++++++++++++++++ 2 files changed, 19 insertions(+) create mode 100644 docs/src/contributing_theming.md (limited to 'docs') diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md index 9a2ecde8..10a6153e 100644 --- a/docs/src/SUMMARY.md +++ b/docs/src/SUMMARY.md @@ -15,4 +15,5 @@ - [Local Development](contributing_local_development.md) - [Websocket/HTTP API](contributing_websocket_http_api.md) - [ActivityPub API Outline](contributing_apub_api_outline.md) + - [Theming Guide](contributing_theming.md) - [Lemmy Council](lemmy_council.md) diff --git a/docs/src/contributing_theming.md b/docs/src/contributing_theming.md new file mode 100644 index 00000000..25c8ca6d --- /dev/null +++ b/docs/src/contributing_theming.md @@ -0,0 +1,18 @@ +# Theming Guide + +Lemmy uses [Bootstrap v4](https://getbootstrap.com/), and very few custom css classes, so any bootstrap v4 compatible theme should work fine. + +## Creating + +- Use a tool like [bootstrap.build](https://bootstrap.build/) to create a bootstrap v4 theme. Export the `bootstrap.min.css` once you're done, and save the `_variables.scss` too. + +## Testing + +- To test out a theme, you can either use your browser's web tools, or a plugin like stylus to copy-paste a theme, when viewing Lemmy. + +## Adding + +1. Copy `{my-theme-name}.min.css` to `ui/assets/css/themes`. (You can also copy the `_variables.scss` here if you want). +1. Go to `ui/src/utils.ts` and add `{my-theme-name}` to the themes list. +1. Test locally +1. Do a pull request with those changes. -- cgit v1.2.3