Giter Club home page Giter Club logo

purplemine2's Introduction

PurpleMine 2

A free Redmine 3.0+ theme written in SCSS.

The MIT License JavaScript Style Guide Run linters Issues


Screenshot

It's written in SCSS. It uses normalize.css and benefits from some parts of Bootstrap like mixins, structure, and stuff.

Main features

  • Bigger, easier to read fonts,
  • Github-like wiki content look,
  • Sidebar moved to the left for better ergonomy,
  • Coloring trackers links (on lists, issue pages and even in the wiki content),
  • Jira-inspired priority icons,
  • Toggling sidebar visibility,
  • Easy to customize via variables.

How install it

To install PurpleMine, just download .zip and unpack it to your Redmine's public/themes folder.

Then go to Redmine > Administration > Settings > Display and select PurpleMine2 from the list and save the changes.

Plugins

This theme also features a new look for Redmine Backlogs plugin. To install it, simply copy stylesheets from PurpleMine2/plugins/redmine_backlogs and overwrite files in {redmine}/plugins/redmine_backlogs/assets/stylesheets and restart Redmine.

Also, Redmine Time Tracker and Redmine People plugins should look nice with PurpleMine.

How to customize it

If you want to customize PurpleMine to your needs, first, make sure that you have installed node.js and npm is available in your terminal.

Then, from the directory that contains PurpleMine run:

npm install

Now all the dependencies should be ready to use. Run one more command:

npm run watch

And now the grunt is watching for changes in files placed in src/ folder. Just change what you need, and it'll run Sass preprocessor automatically.

Regrettably, optional file include is not possible in Sass, so I would recommend creating a new file, e.g. src/sass/_custom-variables.scss and importing it a the beginning of the application.scss file. That way all the variables with the !default flag could be overridden.

The path src/sass/_custom-variables.scss is added to .gitignore so it should make upgrading PurpleMine with keeping your changes rather painless, given that the only thing you changed in PurpleMine's source was adding this one line with @import "custom-variables";.

If you need to customize styles for Redmine Backlogs remember to include your _custom-variables.scss in src/sass/plugins/redmine_backlogs/_common.scss.

Changelog

Changelog.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.