<table><tr><td style="">Zren added a comment.
</td><a style="text-decoration: none; padding: 4px 8px; margin: 0 8px 8px; float: right; color: #464C5C; font-weight: bold; border-radius: 3px; background-color: #F7F7F9; background-image: linear-gradient(to bottom,#fff,#f1f0f1); display: inline-block; border: 1px solid rgba(71,87,120,.2);" href="https://phabricator.kde.org/D18019">View Revision</a></tr></table><br /><div><div><blockquote style="border-left: 3px solid #8C98B8;
color: #6B748C;
font-style: italic;
margin: 4px 0 12px 0;
padding: 8px 12px;
background-color: #F8F9FC;">
<div style="font-style: normal;
padding-bottom: 4px;">In <a href="https://phabricator.kde.org/D18019#388829" style="background-color: #e7e7e7;
border-color: #e7e7e7;
border-radius: 3px;
padding: 0 4px;
font-weight: bold;
color: black;text-decoration: none;">D18019#388829</a>, <a href="https://phabricator.kde.org/p/ndavis/" style="
border-color: #f1f7ff;
color: #19558d;
background-color: #f1f7ff;
border: 1px solid transparent;
border-radius: 3px;
font-weight: bold;
padding: 0 4px;">@ndavis</a> wrote:</div>
<div style="margin: 0;
padding: 0;
border: 0;
color: rgb(107, 116, 140);"><p>Shouldn't the documentation explain that apostrophes need to be used or is the fact that they need to be used unusual and specific to this clock widget?</p></div>
</blockquote>
<p>The time format docs mentions:<br />
<a href="http://doc.qt.io/qt-5/qml-qtqml-qt.html#formatDateTime-method" class="remarkup-link" target="_blank" rel="noreferrer">http://doc.qt.io/qt-5/qml-qtqml-qt.html#formatDateTime-method</a></p>
<blockquote style="border-left: 3px solid #a7b5bf; color: #464c5c; font-style: italic; margin: 4px 0 12px 0; padding: 4px 12px; background-color: #f8f9fc;"><p>All other input characters will be ignored. Any sequence of characters that are enclosed in single quotes will be treated as text and not be used as an expression.</p></blockquote>
<p>Which you can combine with QML's RichText documentation:<br />
<a href="http://doc.qt.io/qt-5/qml-qtquick-text.html#textFormat-prop" class="remarkup-link" target="_blank" rel="noreferrer">http://doc.qt.io/qt-5/qml-qtquick-text.html#textFormat-prop</a></p>
<p>The time format docs do not provide an example of using single quotes, and you'd need a person with a programmers mindset to use the escape character with the rich text docs to get the examples above.</p>
<p>A user is more likely to try and use <tt style="background: #ebebeb; font-size: 13px;"><font color="#ddd">ddd</font> d</tt> which would turn into <tt style="background: #ebebeb; font-size: 13px;"><font color="#Tue">Tue</font> 8</tt> and give up... Though now that I think of it, <tt style="background: #ebebeb; font-size: 13px;">ddd</tt> is the only color that would need to be escaped. <tt style="background: #ebebeb; font-size: 13px;">aaa</tt>, <tt style="background: #ebebeb; font-size: 13px;">bbb</tt>, <tt style="background: #ebebeb; font-size: 13px;">ccc</tt>, <tt style="background: #ebebeb; font-size: 13px;">eee</tt>, <tt style="background: #ebebeb; font-size: 13px;">fff</tt> are not date format variables so they are ignored. <tt style="background: #ebebeb; font-size: 13px;">font</tt> has a <tt style="background: #ebebeb; font-size: 13px;">t</tt> (time zone), but since it has <tt style="background: #ebebeb; font-size: 13px;">fon</tt> in front of it, the date formatting ignores it. <tt style="background: #ebebeb; font-size: 13px;"><strong></tt> is similar. <tt style="background: #ebebeb; font-size: 13px;">color=</tt> is ignored since it has no variables in it. <tt style="background: #ebebeb; font-size: 13px;"><b></tt> and <tt style="background: #ebebeb; font-size: 13px;"><i></tt> is also ignored.</p>
<p>We could probably get away with just linking to the rich text documentation. I've been over-complicating it in Event Calendar for a while now it seems. Should the link's label be <tt style="background: #ebebeb; font-size: 13px;">i18n("Text Color Documentation")</tt> or <tt style="background: #ebebeb; font-size: 13px;">i18n("Rich Text Documentation")</tt>?</p>
<hr class="remarkup-hr" />
<blockquote style="border-left: 3px solid #8C98B8;
color: #6B748C;
font-style: italic;
margin: 4px 0 12px 0;
padding: 8px 12px;
background-color: #F8F9FC;">
<div style="font-style: normal;
padding-bottom: 4px;">In <a href="https://phabricator.kde.org/D18019#388876" style="background-color: #e7e7e7;
border-color: #e7e7e7;
border-radius: 3px;
padding: 0 4px;
font-weight: bold;
color: black;text-decoration: none;">D18019#388876</a>, <a href="https://phabricator.kde.org/p/mart/" style="
border-color: #f1f7ff;
color: #19558d;
background-color: #f1f7ff;
border: 1px solid transparent;
border-radius: 3px;
font-weight: bold;
padding: 0 4px;">@mart</a> wrote:</div>
<div style="margin: 0;
padding: 0;
border: 0;
color: rgb(107, 116, 140);"><p>is this the right place for it? (a text field to enter the "magic" date format letters is a very geeky ui, and i would prefer to not go there) shouldn't be a generic localization/date format setting? (and with also a graphical ui to generate this)</p></div>
</blockquote>
<p>The user can already change the Date Formatting globally to a specific Locale's time format (right click widget > Set Time Format...), which is limiting.</p>
<p>The widget's Long Format uses a ridiculous width on the panel:<br />
<a href="https://phabricator.kde.org/F6536135" style="background-color: #e7e7e7;
border-color: #e7e7e7;
border-radius: 3px;
padding: 0 4px;
font-weight: bold;
color: black;text-decoration: none;">F6536135: 2019-01-08___10-21-26.png</a></p>
<p>While the Short Format does not display the day of the week, includes the year (which isn't useful after January) and since Canada/US puts the Month first, annoying to read since the month is represented as a number as well.<br />
<a href="https://phabricator.kde.org/F6536137" style="background-color: #e7e7e7;
border-color: #e7e7e7;
border-radius: 3px;
padding: 0 4px;
font-weight: bold;
color: black;text-decoration: none;">F6536137: 2019-01-08___10-24-05.png</a></p>
<p>Changing the global Time Format requires the user to <strong>restart plasma</strong> to apply and see the changes directly in the panel. Changing the global format also isn't desired since people tend to use an over simplified date format in the panel (eg: <tt style="background: #ebebeb; font-size: 13px;">Tue 31</tt> or <tt style="background: #ebebeb; font-size: 13px;">Jan 31</tt>), but will still want legible timestamps everywhere else (eg: Dolphin).</p></div></div><br /><div><strong>REPOSITORY</strong><div><div>R120 Plasma Workspace</div></div></div><br /><div><strong>REVISION DETAIL</strong><div><a href="https://phabricator.kde.org/D18019">https://phabricator.kde.org/D18019</a></div></div><br /><div><strong>To: </strong>Zren, Plasma, VDG<br /><strong>Cc: </strong>mart, ndavis, rooty, plasma-devel, kvanton, jraleigh, GB_2, ragreen, Pitel, ZrenBot, lesliezhai, ali-mohamed, jensreuterberg, abetts, sebas, apol<br /></div>