Translate YouTrack to Your Favorite Language

With the release of YouTrack 5, we now provide out-of-the-box localization support for your YouTrack instance. While the original set of supported languages includes a few European languages already, we also provide the facility for you to customize YouTrack to your liking using your own favorite language and phrasing. Here’s what the process is like.

Overview

The vast majority of what you work with in YouTrack is dynamic content, i.e. the test that you have in issue summary/description fields, custom fields, saved searches, tags, etc. None of these require localization support because you can already define them in whatever language you wish. Where localization is important is in static strings, such as what text appears on the Create Issue button.

To localize YouTrack to a particular language, you should:

  1. Translate the standard UI strings, which are defined in property files and notication templates.
  2. Put the translated files into a separate directory and provide a description of your locale in this directory, too.
  3. Start YouTrack with a parameter pointing to the directory with the localized content.

Let’s see how this works.

Translating Property Files

First of all, download the messages.zip archive. This ZIP file contains a set of files that you can customize — its default definitions are in English. The archive contains the following:

  • PredefinedFields_en.properties — contains the names of predefined fields (such as summary) that ship with the YouTrack instance by default.
  • dynamic_en.properties — contains a further set of strings, with the difference that this set is not reloaded when pressing the Reload button or even restarting YouTrack. These should be changed only at the time when you’re switching to another language.
  • all_en.properties — contains a very large set of strings that make up the bulk of YouTrack localization. This is where you can change, for example, the text on the Create Issue button.
  • \notification_templates — this folder contains a set of HTML-esque templates where you can also customize strings related to messages that are shown.

Property files are simple UTF-8 text files with key=value pairs. There are several special mechanisms used to translate, e.g., plural forms of numerals — for more information on this, please consult the full YouTrack Localization Guide.

Notification templates are files with .ftl extension. Strictly speaking, they are also editable inside YouTrack itself, via Administration|Notification Templates. If you do decide to localize these, you may wish to preserve the HTML structure intract and only change the text related to the messages.

Running YouTrack with Custom Localization

When you are ready to use your new localized files, here’s the directory structure you need to set up:

  • Create a directory to house your localizations, e.g., \youtrackUK
  • Create a subdirectory with the locale name, and copy over all the files from messages.zip into that directory. For example, you might have a directory \youtrackUK\en_UK.
  • Create a file called supportedLocales.xml inside \youtrackUK. This is where you specify the supported locale(s), and the ID must match that of your en_UK subdirectory.

Here’s a sample supportedLocales.xml file:

<?xml version="1.0" encoding="UTF-8"?>
<locales>
<localeEntry>
<name>British</name>
<locale>en_UK</locale>
</localeEntry>
</locales>

Once this is done, you need to launch YouTrack, specifying a JVM option of jetbrains.mps.webr.i18n.custom-translations with a value referring to your custom language path (i.e., x:\foo\youtrackUK). How you set it depends on how you run YouTrack. For example, on Windows, you would:

  • Start up a console with Administrative permissions
  • Navigate to the \bin folder in YouTrack installation directory
  • Execute tomcat6w //ES//YouTrack
  • In the window that opens, define the argument as -Djetbrains.mps.webr.i18n.custom-translations=c:\temp\youtrackUK

All you have to do now is restart YouTrack, then go into Settings, scroll down to System Language and choose the new language from the list:

YouTrack will apply your new language settings, and you can start using them straight away:

And one last thing…

So that’s how easy it is to customize YouTrack. And since we imagine that many of you may be interested in localizing YouTrack to one language or another, we’ve set up a GitHub repository where all such translations can be kept. So if you’ve got a translation for a particular language, simply send us a pull request and your translation will be included in the repository!

Posted in features | Tagged , , , | 4 Comments

Post-Mortem of YouTrack InCloud Custom Domains Issue

On Monday September, 23rd YouTrack InCloud servers were updated to v5.0.3. As some of you might noticed, this update caused an issue related to custom domains. Luckily, it affected only several custom domains. Due to the issue custom domains were reset to default “…”.myjetbrains.com address.

YouTrack engineers investigated the problem and came up with a quick solution how to set custom domains back. However, in order to apply the bug fix we had to restart the servers. Therefore, some of you might noticed another unscheduled 15 minutes downtime.

We apologize for the inconvenience you might have experienced due to domain resetting and further system downtime. Though, we gained valuable experience from this issue and we will prevent similar problems in future updates.

Best regards,
JetBrains YouTrack Team

Posted in events | Tagged , , | Leave a comment

New Raygun integration with YouTrack

We are happy to announce that Raygun, automatic error tracking solution from Mindscape, has first-class integration with YouTrack! It’s live now and ready for you and your team to experience what might be the smoothest error resolving workflow possible. Raygun automatically tracks all errors your application generates, and with two clicks you can assign them to an existing issue in your YouTrack issue tracker, or create a new issue.

Raygun’s popular with devs of all sorts as it makes it easy to automatically transmit errors and exceptions that application users encounter. Those errors are received by the Raygun service, where they are presented on a beautiful dashboard with charts and statistics, but crucially with the stack trace, environment data, request fields (if applicable) and much more. Emails are dispatched to inform you of the error, and with the addition of daily summaries you always know the health of your site or application. Another popular feature is Raygun’s support for teams and organisations, allowing your colleagues to get in on the bug stompin’ action.

Fast workflow

Many developers find YouTrack to be a great issue tracking and project management tool. Now that YouTrack integrates with Raygun, the process is fully automated. After adding the details of your YouTrack server to your Raygun account, drilling down into an error group will show a YouTrack options button. Click it, and you can assign it to an existing issue in YouTrack, or create a brand new issue. Whichever you pick, the issue will contain a link back to Raygun, allowing everyone to immediately view the exception’s stack trace, the environment data from the user’s system, and if it’s from a web site or application, the server and request data.

Your team is instantly notified about all errors, and placing it in your issue tracker takes seconds, where it can be assigned and resolved. Having the error data available from a link makes it faster and less painful to reproduce.

An introductory video walks you through the steps of setting up YouTrack with Raygun – it’s really easy, but check out the video walkthrough here:

Raygun integration with YouTrack

If you’ve already got a Raygun account, log in and go to your Application Settings page where you’ll find Plugins in the sidebar. Enter your YouTrack details there, and you’re set!

Blast errors with pleasure with Raygun and YouTrack!
JetBrains YouTrack Team

Posted in features, news | Tagged | Leave a comment

The Freshest YouTrack 5.0.3 is Here

The latest YouTrack 5.0.3 is ready to be tried out by you. The release notes include many Agile board related fixes. With YouTrack 5 we introduced brand new Agile experience. With the latest YouTrack 5.0.3 you can enjoy even more stable and faster work with enhanced Agile board.

Download YouTrack 5.0.3 or sign up for YouTrack InCloud. Existing YouTrack InCloud sites will be updated according to our Events and Maintenance Calendar

Keep Agile and track it softly with YouTrack 5 codenamed “Gentle”
JetBrains YouTrack Team

Posted in release | Tagged , , | Leave a comment

YouTrack 5.0.2 Is Out!

The latest YouTrack 5.0.2 is available for download. This minor update delivers numerous useful bug fixes, as well as couple of new features.

Please welcome all the new fixes and small features. Newest YouTrack 5.0.2 brings:


Download
the latest YouTrack 5.0.2 or sign up for YouTrack InCloud in no time to enjoy the latest YouTrack!

If you are already using YouTrack InCloud, your site is already updated to the newest 5.0.2 version, according to our Events & Maintenance Calendar.

Posted in release | Tagged | 2 Comments

Feel The Power of The Workflows

Enrich your processes – take full advantage of YouTrack’s customizable workflows

Workflow system
As you know, YouTrack comes with default built-in workflows, which can be attached from the Workflow tab in Administration > Project.

Some YouTrack customers go further and program their own simple workflows, for example to display a “Forbidden!” message when a user attempts to reopen a resolved task. That’s a good start.

Some develop more complicated rules, state machines, create sets of protected stateless rules, or send notifications by schedule. That’s excellent!

Very few, however, program workflows to appoint duties per weekdays, perform morphological analysis on issue summary/description, build smart reports, manage product release lifecycle, or smartly handle incoming feedback (with mailbox integration).

Implementing such comprehensive workflows turns YouTrack into a truly fine-tuned, powerful tool. If you would like to learn more about these advanced YouTrack topics, please read this Workflow Language Reference.

Workflow language reference
Workflows are developed in a DSL (Domain-Specific Language) called “Workflow language” which is compiled to Javascript. Although all references, operators, keywords are available in the “Workflow Editor” (just press Ctrl+Space for autocompletion), we’ve decided to create a full featured reference that explains this language’s syntax and semantics.

Workflow Reference Quick Language

Learning language
The reference is divided to several chapters, each providing a set of samples. A novice should be able to create a “Hello world” workflow in 5 minutes tops. On the other hand, the examples we provide cover the entire workflow language functionality, so workflow gurus can use it as their main reference as well.

Examples increase in difficulty as you progress through the chapters.

There are short samples which quickly introduce you to basic workflow features. For instance, the following statement sets ‘Priority’ field to ‘Critical’:

{{ Priority = {Critical}; }}

There are advanced examples and unusual methods as well. For instance, this construction sends a notification email to members of the ‘QA Engineers’ group:

{{ {group: QA Engineers}.notifyAllUsers(“Test failed!”, “Please look at the failed test ” + getId()) }}

We designed the workflow reference to help YouTrack users learn the entire workflow language section-by-section.

Is there anything that workflow language doesn’t provide for?
The reference tells you what you can do using workflows, as well as what you cannot do.

You can define variables, work with predefined collections, string, dates, integer numbers, tags, comments, users, projects, fields, saved searches, etc.

But the workflow language does have its limitations: There are no classes, functions, closures, tuples, arrays, switches, try-catch, or annotations; types are inferred automatically; and there is no way to create new non-primitive objects and collections.

YouTrack 5.0
Workflow reference is finally up-to-date and includes brand new localization methods which is available starting with YouTrack 5.0. Get the latest Workflow Editor 5.0 right now and try all the new yourself!

Feel The Power of The Workflows!
JetBrains YouTrack Team

Posted in features, tips | Tagged , | Leave a comment

YouTrack 5.0.1 is Out: The hottest bug fixes for the latest version

We are ready to introduce the latest update for your favorite agile issue tracker.

YouTrack 5.0.1

YouTrack 5.0.1 is available now. This minor update includes a set of very important fixes and performance improvements. Please check the full list of fixes. You are highly welcome to grab the YouTrack 5.0.1, either by downloading the latest build or by signing up for YouTrack InCloud, hosted in the cloud by us. If you are already using YouTrack InCloud, your site will be updated to 5.0.1 according to our Maintenance Calendar.

While further fixes are on their way, your feedback on new features is highly appreciated. Please help us make YouTrack v.5 better.

Keep calm and track it soflty with YouTrack 5 codenamed “Gentle”!
JetBrains YouTrack Team

Posted in release | Tagged | Leave a comment

YouTrack 5.0: Your Language. Your Agile. Your Rules.

YouTrack 5.0

Where do you begin the story of YouTrack 5.0?

YouTrack 5.0 codenamed ‘Gentle’ is designed to answer all the tough questions you’ve asked us. And now it can hold a conversation in your language!

Salut! Hallo! Привет! Hola!

Let’s start with the most wanted feature in YouTrack ever: now it speaks German, French, and Russian, and Spanish, with more languages coming with further releases.

To change system language in YouTrack, please go to Administration > Settings (you need administrator rights to do this) and choose from four currently available languages (in addition to English of course):

Salut! Hallo! Привет! Hola!

What’s more, if your language isn’t available yet, you can translate YouTrack on your own. Or, you could create a personal YouTrack with your own slang, if you like. Check out the How to Translate YouTrack UI guide.

Redesigned UI: New look, same soul

YouTrack strikes a brilliant balance between form and substance. Clear and detailed, issues management is now faster, easier and cooler. We’ve redesigned the Full Issue, Create Issue and Edit Issue screens with a new look-and-feel that will help you manage issues with more fun and speed.

The key enhancements and major changes include:

  • Unified design and layouts for Full Issue, Edit Issue and Create Issue screens: same places for fields everywhere
  • Field labels are permanently visible now
  • Attaching files from the system is faster and more fun: simply drag them to the Create Issue or Edit Issue screen
  • Generate an issue template URL and send it to your customer or collaborator. You also can use this URL for yourself for reporting further issues
  • Clear but still detailed comments view
  • Updated design for menu items
  • Restyled Edit Issue and Delete Issue icons

Full Screen Issue

Ultimate Agile Experience
Many significant Agile board improvements are waiting to be enjoyed. Please take them for a spin and get the most out of your new Agile project tracking.

Key improvements:

  • Cross-project Agile board
  • Entirely new Backlog management
  • Board based on search query
  • Board visibility settings
  • Multiple boards
  • Swimlanes based on attributes
  • Column visibility
  • Personal Agile
  • Restyled cards

Agile Board

Darcula TV look and feel
Many JetBrains products have adopted the darker side, and now it has finally reached YouTrack as well.

If you apply Agile methodologies in your practices, you know that the hardest thing is to stay Agile. To cope with this, your board should be visible as much as possible, especially during meetings, or maybe even permanently on a TV screen in your office. You can’t afford not to keep track of what’s going in your project.

This is why we’re making available a new Darcula-style view for the Agile board. Specifically designed for TV, it is highly visible from a distance and also very usable on a PC screen. Please welcome YouTrack Darcula TV style:

Darcula

Explore the darker side to stay Agile!

Similar Issues
Say No to duplicates, thanks to the brand new Similar Issues tab next to the familiar ‘History’ and ‘Linked Issues’ tabs. Now while creating or editing an issue on the Full Issue screen, you can view a list of issues similar to the current one.

Similar Issues

Renewed Screenshot Tool

Meet the new Screenshot tool and will take more shots than ever before:

  • A completely new look and feel
  • Comments: Now you can add comments just in the screenshot itself
  • New highlight tool
  • Lines and straight lines: By holding CTRL you can easily draw straight lines

Screenshot Tool

Wiki Markup
In other enhancements, please welcome new wiki markup for visual descriptions and comments:

  • Insert HTML tags
  • Highlight YouTrack users by typing @ before their username
  • Set out long paragraphs with new list formatting
  • Find more available options in wiki markup help

Clone Issue
A rookie has joined the team of powerful YouTrack commands. From the very beginning YouTrack was a unique tracking tool because of its command language and full keyboard control. Now we are pleased to introduce a new command: Clone Issue. With this command you can clone one or multiple issues. Just start typing “clone” or open the command dialog to apply this new command to the issue!

Clone Issue

System-wide notification message
More customization possibilities for YouTrack administrators. Now you can show a system-wide message to all of your YouTrack site users to notify them about any site maintenance, last updates, recent events, or anything else you would like.

Database Performance
We’ve enhanced our database, designed internally by our engineers specially for YouTrack. It’s gotten faster, smarter and safer.

Check What’s New in YouTrack 5.0 for more juicy details. And if you are thirsty for even more details, check the full release notes.

Get YouTrack 5.0 right now and try all the new features yourself!

If you are using YouTrack InCloud, hosted in the cloud by us, your site will be upgraded to v5.0 according to our Events and Maintenance Calendar.

Keep calm and track it softly with YouTrack 5 codenamed “Gentle”
JetBrains Youtrack Team

Posted in news, release | Tagged , , , | 2 Comments

Restyled UI in YouTrack 5.0: New look, same soul

We are excited to introduce absolutely new YouTrack 5.0 look & feel. We put a lot of hard work into it, to help you enjoy just the right balance between powerful functionality and a lightweight UI. Learn about the key enhancements and the main advantages of the new UI. Very soon you will start managing issues easier, faster and with more pleasure with YouTrack 5.0, where form and substance both matter.

Please welcome YouTrack 5.0 UI personalities:

Sergei Ilin
Sergei Ilin, @iSerge, Lead Graphic Designer, JetBrains

Artem Tiunov
Artem Tiunov, @artemtiunov, UI/UX Designer, JetBrains

Alexander Anisimov
Alexander Anisimov, Front-End Developer, JetBrains

General UI improvements

New menu
First of all, look at the new menu with updated components and you’ll notice that we’ve totally restyled buttons and links. For your convenience, there are no more toggle buttons. Just use the Create Issue button and follow the links to your Issue lists, Agile Board and Reports.
Menu Components

More visibility and unified views
There are many general design improvements for a more intuitive feel about YouTrack 5.0. The new UI makes links and icons more visible, as well as letting you hover the mouse over them with an increased mouseover area. We played with the colors and made the active elements orange (one of our primary colors at JetBrains). Check this out in the new YouTrack 5.0!

We’ve also improved visibility for all the fields on the Create/Edit Issue screens, and unified all the views. Now everything is in the same place on each screen. The issue list now features simplified checkboxes and icons, updated to help you work with issues with more fun.

Comment system
If you’ve ever submitted comments to YouTrack, you’ll see the difference now, as we’ve redesigned the comment system substantially. The new comments view is clear but still detailed, and instead of old-style links you will find new edit/delete icons.
Comments

Full Screen Issue

Layout
The highlights of the new look & feel in YouTrack 5.0 include the new Full Issue screen the and Create/Edit Issue screen. Take a look at the new Full Issue screen: we have redesigned the visible area and the key issue details to put them on the left side, while the secondary details are now on the right. Focus on important things first, right?

Issue change-over
There are more UI features in here. Look in the upper right-hand area above the issue details and you’ll see a new way to jump up and down to other issues within the selected YouTrack project. In the Full Issue screen, field labels are now visible permanently for your convenience.

Just look through your issues in the full screen to feel the difference.
Full Screen Issue

Create Issue & Edit Issue screen

Similar issues
The Create Issue and Edit Issue screens have also been redefined. Next to the familiar History and Linked Issues tabs, you’ll notice a brand new tab called Similar Issues. Its purpose it to help you find issues that are similar to the selected one. How does it work? Just start editing the issue description or summary, and the list will refresh to show you the most relevant existing issues. Depending on your needs and preferences, you can always hide or show the similar issues block on the Edit Issue and Create Issue screens.

Obviously, this tab will of great benefit especially in large teams, as it helps you eliminate duplicates in your project. Users will see right away if a similar issue has already been reported. Another advantage of this new tab is that you can easily link relevant issues with one click. Stay tuned for more details on this feature in a later post.
Create Issue Screen

Issue template generator
This is another new feature that allows you to generate an issue template URL to share with your customers or collaborators, available in both Create Issue & Edit Issue screens. It will help you save time on repeated actions, and instead to focus on what’s really important. Try it once and you’ll use it regularly.

File attachments
Want to attach a file or picture to your issue? Now attaching files from the system is faster and more fun: simply drag them to the Create Issue or Edit Issue screen and voila!. Check it out for yourself.
Attachments

Agile Board
Your favorite Agile Board has undergone some changes as well in YouTrack 5.0. Please welcome these improvements.
Agile Board

New cards
We totally redesigned the cards by putting them on white background. There are new headers on the cards which are colored in line with issue status (Normal, Major, Critical), to help you see right away what’s going on in your project or swimlane. You will also notice new edit icons in different places in the new YouTrack 5.0.

Time estimates
Time is money, so we’ve added estimates everywhere – on cards, columns, swimlanes and projects. If you value your time as much as we do at JetBrains, you’ll find this very useful.

We’ve also introduced tags for Agile Board cards, to help you work with huge volumes of issues. Tags give you more insight into what cards are about in a glance.

Columns visibility
One more new feature worth mentioning is Columns Visibility. Now you can manage your columns and their visibility with pleasure just ticking off only those columns which you really need for your current work.

Just a reminder, there are major changes in the Agile Board functionality as well. We’ll cover those in another post very soon.

Darcula look and feel
The Darcula theme was introduced in our other products last year and its TV version has now made its way into the Agile board in YouTrack. Do give it a try! What’s the benefit? Specifically designed for TV, it is highly visible from a distance, while also being very usable on a PC screen. Come over to the darker side of Agile to help control your Agile processes.
Darcula TV Scheme

Please tell us what you think about the new YouTrack 5.0 look & feel. You can easily do it via these channels:

Share your feedback with us and help us make YouTrack even better together.

Keep tracking with style with YouTrack 5,
JetBrains Team

Posted in features, news | Tagged , | 8 Comments

YouTrack 5.0 Release Candidate is Available. Be the first to try it out!

Attention! Achtung! Внимание! Consideración!

If you want to be the first to try YouTrack 5 codenamed “Gentle”, we’ve got a Release Candidate ready. Grab it while it’s hot!

What should you try in YouTrack 5?

Localization

We did it! Most voted feature in YouTrack ever is here. Change the UI language on the Administration > Settings tab to explore YouTrack in French, German, Russian or Spanish:
Change Language

Awesome Agile Project Management
We prepared numerous enhancements for our Agile project tracking. Try them all:

  • Create a common board for multiple projects
  • Narrow down the issues on the board using search queries
  • Share the board with the team or keep it just for yourself
  • Set attributes as swimlanes
  • Drag the subtasks directly to the board from the new tree-like backlog
  • Keep as many boards as you need
  • Enjoy a fresh look and feel for cards

Enhanced Agile Board

Restyled UI
Clear and fresh, the redesigned UI lets you track your issues more efficiently and cooler than ever before.
Create Issue Screen

Other great features you don’t want to miss:

  • Sharp-looking Darcula TV theme for Agile board
  • Similar issues tab to avoid duplicates
  • Wiki Markup now supports HTML tags and mentioning users
  • New ‘Clone issue’ command
  • Renewed Screenshot tool

If you like, dig deeper into details with YouTrack 5.0 RC release notes. Download the latest RC (#7165) from the EAP page or play with one of these InCloud EAP instances in your language:

Also, we have updated the biggest YouTrack Installation on JetBrains issue tracker production. This means that the final release of YouTrack 5.0 is just around the corner. Stay tuned these few days before the release and please share all your feedback with us.

Keep calm and track it softly with YouTrack 5 codenamed “Gentle”
JetBrains Youtrack Team

Posted in news, release | Tagged , , , , | 6 Comments