The KRunner page

Fragment of a discussion from User talk:Karthikp
Jump to: navigation, search

Sorry, annew, I couldn't figure out how to handle the tags. The ominous warning said don't delete them, so I just grouped them all together and edited below them. Now I have a better idea of how to work with the tags!

In several pages, translate tags make up a considerable volume of the page. The warning at the head of the edit page is rather abstract. Your message is so much clearer. It would be good to replace the "don't delete the tags" warning with:

"[W]herever possible keep the appropriate tag with its paragraph, even if you move the paragraph. Delete a tag attached to any paragraph deleted. Never add tags manually."

I have one more suggestion; if at all possible, it would help to syntax highlight the translate tags with a barely visible gray instead of black. That will focus the attention on the text instead of the tags.

I have another related question. There were other ≪translate≫ tags (I can't put angle brackets here without this thing complaining about unbalanced tags) that I *had* to delete because otherwise, they were visible in the main document. What do those do?

09:05, 8 April 2012

Replacing the warning: OK, that makes sense. I'll try to get to it today - but if you become aware that it has slipped the net, don't hesitate to remind me.

I don't think it is possible for the translate tags to be greyed out, but I will point our web gurus to this thread and get their opinion.

Writing tags intended to be visible - it is done by adding nowiki tags - < nowiki>translate< /nowiki> will achieve this (NB I have added spaces into the nowiki tags to stop them being a command).

The multitude of translate tags - translators see only the text between translate tag pairs. Occasionally it is necessary to split things up in many places to make this work for the translators. One really big problem for them, though, is that if they only see part sentences they have no context, and in some languages that can cause incorrect translation. That's why we have the rule that a message should be completely within the tag pair. If you have a section where you can't work out where to put the pairs, either ask on #kde-www or ping me, Claus_chr or Yurchor for help.

11:16, 8 April 2012

I've re-written the warning - possibly over the top, this time Face-smile.png but try an edit and see what you think.

15:54, 9 April 2012

Much clearer! I have a few suggestions:

  • There's a bracket missing in first sentence. It should probably read, "Tags (such as <!--T:1-->)..."
  • Since the notice is really aimed at new editors, it could begin with a short introduction such as, "Userbase uses a tag system to mark paragraphs for translation. These tags (such as <!--T:1-->) are automatically added by the system."
  • I like the three simple bullets used to condense the info. Let's sort them in this order, though. I also reworded them to be even more clearer:
    • Do not add new tags.
    • If you move a paragraph, move its tag with it.
    • If you delete a paragraph, delete its tag with it.

Let's put it all together. What do you think of this new warning?


A note about translation tags: Userbase uses a tag system to mark paragraphs for translation. These tags (such as <!--T:1-->) are automatically added by the system.

  • Do not add new tags.
  • If you move a paragraph, move its tag with it.
  • If you delete a paragraph, delete its tag with it.

18:52, 9 April 2012

Compromise Face-smile.png I've used most of your wording, but kept my longer statement about not adding tags. Thanks for the input. Hopefully it is both more obviously seen and easier to understand now.

15:22, 10 April 2012