Zren added a comment.

  In D18019#388829 <https://phabricator.kde.org/D18019#388829>, @ndavis wrote:
  
  > 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?
  
  
  The time format docs mentions:
  http://doc.qt.io/qt-5/qml-qtqml-qt.html#formatDateTime-method
  
  > 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.
  
  Which you can combine with QML's RichText documentation:
  http://doc.qt.io/qt-5/qml-qtquick-text.html#textFormat-prop
  
  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.
  
  A user is more likely to try and use `<font color="#ddd">ddd</font> d` which 
would turn into `<font color="#Tue">Tue</font> 8` and give up... Though now 
that I think of it, `ddd` is the only color that would need to be escaped. 
`aaa`, `bbb`, `ccc`, `eee`, `fff` are not date format variables so they are 
ignored. `font` has a `t`  (time zone), but since it has `fon` in front of it, 
the date formatting ignores it. `<strong>` is similar. `color=` is ignored 
since it has no variables in it. `<b>` and `<i>` is also ignored.
  
  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 `i18n("Text Color Documentation")` or `i18n("Rich 
Text Documentation")`?
  
  -----
  
  In D18019#388876 <https://phabricator.kde.org/D18019#388876>, @mart wrote:
  
  > 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)
  
  
  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.
  
  The widget's Long Format uses a ridiculous width on the panel:
  F6536135: 2019-01-08___10-21-26.png <https://phabricator.kde.org/F6536135>
  
  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.
  F6536137: 2019-01-08___10-24-05.png <https://phabricator.kde.org/F6536137>
  
  Changing the global Time Format requires the user to **restart plasma** 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: `Tue 31` or `Jan 31`), but will still want legible timestamps 
everywhere else (eg: Dolphin).

REPOSITORY
  R120 Plasma Workspace

REVISION DETAIL
  https://phabricator.kde.org/D18019

To: Zren, #plasma, #vdg
Cc: mart, ndavis, rooty, plasma-devel, kvanton, jraleigh, GB_2, ragreen, Pitel, 
ZrenBot, lesliezhai, ali-mohamed, jensreuterberg, abetts, sebas, apol

Reply via email to