Look at all that documentation
Today we are very happy to announce the availability of Luna 2.1 Preview 3 (no 2.0.10, at least not today). This is our third alpha release for Fallow and we have got some pretty exciting things to talk about. First off, something that isn’t really about the release itself.
As mentioned when we released Luna 2.0.9 and 2.1 Preview 2, we made a major change to the way our website handles documentation. Today, we’ve pushed the first major update to our documentation to our website. This gets the documentation up-to-date with Luna 2.1 Preview 3. At least, for as far as we have refreshed these pages. Right now, that is mostly all about the Backstage and our Theme developer documentation. This is just the start of our journey to improve the documentation, and to keep it that way. We’ll have more to share with the next release.
Today’s update makes some important changes to themes. First of all, themes no longer use the faux “information.php”-file with an XML in to tell Luna what they exactly are. Instead, we now have the “theme.json” file. This is a much simpeler structure, a more polished approach and allows for easier extension if it’s ever required.
Also, themes now have to define which features they support of which Luna is depending on the theme to support it. If a theme does not support a certain feature, a red warning will be shown in the Backstage next to the relevant setting. This way you know why a feature may not change anything on your board. Features need to be defined in “theme.json”.
Accent colors now have to be defined in the “theme.json” file. This way we could make the whole thing much more dynamic for the Backstage. Themes can now show their actual accent colors in the Backstage, heck, if they want, they can even show a gradient now.
For more information about the new theme.json file, I highly recommend you read the brand new documentation on theme development.
With todays update, the “Theme” setting is also moving back to its own page called “Theme”, the current “Theme” page has been renamed “Appearance”. On the new Theme-page, you can install and uninstall themes (yes, they require installation now) and if you want, you can delete a whole theme right from the Backstage now.
Installing a theme adds it to a new “themes”-table in the database, but themes can now define some of their own configurations in the new theme.json file, and by installing the theme, these configurations are put into the database.
Fifteen & Sunrise
In Preview 2, we moved Fifteen and Sunrise’s source over from plain old CSS to SCSS. This makes these themes easier to manage and is one of the many steps we’re taking to improve our theming support. However, you might have noticed that Preview 2 crippled Fifteen and Sunrise in a number of places. Well, get ready for it to get worse.
Fifteen and Sunrise should have “working” accents again in this version, but on numerour places, the styling will be broken. We are not planning on fixing this as we’re working on major updates for both Fifteen and Sunrise, essentially rewriting both themes, to support Bootstrap 4. Fixing these broken things just feels like a waste of times. So yeah… now you’re warned.
Preview 1 removed the capability to switch between the emoticons included with Luna or use the emoji font present in the system. This preview also removes the support for changing the size of emoji. Starting with this release, emoji will take the size of their parent element.
Under Backstage > Settings, you’ll find a new page titled “Emoji”. Here you can manage which emoji are available on your board. You will no longer have to dive into the parser to manually add emoji to the list of supported emoji.
- The duality between “e-mail” and “email” has been cleaned up, Luna will now always refer to it as “email”.
- The Backstage’s page title now contains the name of the page.
We’re very excited with all these changes and we’re not done yet. Luna 2.1 is shaping up to be a nice update, and you, our users, deserve it after more than 1,5 year of silence! Go get it if you’re running Preview 2, but make sure to make a backup first. You never know…
- You have to select an accent color every time you want to save profile settings or the Backstage’s Appearance settings, otherwise, the accent color will be reset to 0 (which isn’t an accent).
- Fifteen and Sunrise have various visual issues.
- The category name and position in Board is missing some styling.