Function descriptions in Picard

Tags: #<Tag:0x00007f820f53a230>

Descriptions about the functions that can be used for Taggerscript in Picard have recently been added to Transifex and I was wondering if the ` and * used in those strings are used for formatting (and thus should be kept as is) or are simply used as quotation marks (and can be substituted in the translation)? Is there a development version (or simply a screenshot) where I can see these strings in action?

2 Likes

Yes, those are used for formatting. The documentation is using Marlkdown for formatting. That means * is marking bold text and text enclosed in ` is formatted as code.

There are devlopment builds for macOS and Windows, but unfortunately there is no public download location for those at this moment.

2 Likes

You should be able to see the description on the web site. You can see slightly expanded functions definitions in the documentation that I’ve been developing.

Might want to consider including a comment explaining that for the translators as a translatable string at the start of the file?

Are these strings meant for the website or Picard proper?

I believe that they are ultimately meant for both. From what I understand, the intent is to extract the information for the website from the strings in Picard’s code base.

Exactly. At this moment they are used only to show documentation inside Picard, but the goal is definitely to also generate the online documentation from this information.

2 Likes

Is that available in v2.3.2? I know I’ve seen it (and was really impressed with how it worked), but I can’t seem to see it in either the File Naming or Scripting sections of the Options.

No, it’s not released yet. It will be in the next release.

1 Like

That explains it then. I must have seen it when I was running the master branch locally to do some testing. Thanks.

Some percentage character combinations have been interpreted as a special sequence by Transifex unintentionally. Has this any impacts and how should I translate these? Copy the source string or rewrite it and hope for the best?

Edit: Rewriting does not help, I typed plain text %genre%, changed to another source string and back – this is what I got:

Does this affect just the interface of Transifex or is this going to impact Picard’s interface too?

2 Likes