# Roundabout Theme Index

This is an index of themes for you to use on any instance of the Roundabout software.

You can find a list of themes by user in the [`themes`](themes) directory, or,
go to [`steve0greatness.roundabout-host.com/ThemeIndex`](https://steve0greatness.roundabout-host.com/ThemeIndex)
for a rich-text list of themes.

## Contributing Themes

If you have a theme you'd like to contribute, you can do that in 1 of 2 ways:

* **Email your theme to `steve0greatnessiscool+RATI [at] gmail.com`.**
  Your email should contain a link to your Roundabout profile (it doesn't have to be
  on [`roundabout-host.com`](https://roundabout-host.com/)), your theme's name,
  and your theme CSS as an attachment.
* **Submit a Pull Request**
  You'll need to add your theme CSS to your subdirecotry in the [`themes`](themes) directory.
  If you don't have a directory in [`themes`](themes), add one.

  Make sure to add all information about your theme to [`themes.xml`](themes.xml),
  this includes:
  
  * Theme's name
  * Your display name, username, a link to your profile, Roundabout instance
  * Path to the theme CSS (relative to the [`themes`](themes) directory)
  
  This should be formatted as such:
  ```xml
  <theme>
      <title>{Theme Name}</title>
      <author
          uri="https://{profile link}"
          instance="{profile instance}"
          username="{author username}"
      >{Author display name}</author>
      <uri>{pathto/theme.css}</uri>
  </theme>
  ```
  Then submit a PR to this repository.