Skip to content

Commit cc3d0ca

Browse files
committed
docs for v0.36b
1 parent 863b690 commit cc3d0ca

File tree

2 files changed

+20
-15
lines changed

2 files changed

+20
-15
lines changed

doc/wiki/Bugs-and-Known-Issues.note

+16-11
Original file line numberDiff line numberDiff line change
@@ -25,22 +25,27 @@ There is some advice about DIY debugging further down this document.
2525
Can be a problem on some Linux Desktops. Generally, I don't suggest Qt5 version of tomboy-ng with systems that use Qt5 earlier than 5.15. So, using Ubuntu 20.04 (Qt5 is 5.12) is a risk factor. Setting your Qt theme to 'gtk3' on those early Qt5 systems is asking for trouble. I have not tested on systems with Qt5 between 5.12 and 5.15 so your mileage may vary. By time you get to Qt5 5.15, it all just works !
2626

2727
<bold>Dark Theme</bold>
28-
On a number of Linux Distros, the QT5 version does not pick up the Dark Theme from the operating system. You can pass the executable a --dark-theme switch but much better to install <bold>qt5ct</bold> and set the colour theme you like. You will need to set an environment variable that tells Qt apps (including qt5ct itself) that you are using qt5ct colours, either by adding an environment variable when you start tomboy-ng -
28+
Generally, the QT5 version does not pick up the Dark Theme from the operating system. You can pass the executable a --dark-theme switch but the results are not great. A much better approach is to use Qt5's theme setting capability, using <bold>QT_QPA_PLATFORMTHEME</bold> env var. The easist approach (on most Linux systems) is set it to your existing gtk2 or gtk3 theme, you will need to install the <bold>qt5-style-plugins</bold> package using your normal package manager, then, start tomboy-ng with the enviournment variable set to either 'gtk2' or 'gtk3'. Small section below on setting the variable.
2929

30-
<monospace>QT_QPA_PLATFORMTHEME=qt5ct tomboy-ng [enter]</monospace>
30+
Another approach is to install the <bold>qt5ct</bold> package from your package manager and set any colour theme you like. Again, you will need to set the same environment variable, this time to 'qt5ct', it tells Qt apps (including qt5ct itself) that you are using qt5ct colours but only works after you have started qt5ct and selected a color scheme.
3131

32-
Better still, make all your Qt5 app have a nice uniform look. Set that var in either /etc/environment (requires root or, simpler in a .xsessionrc file in your home dir.
32+
<bold>Setting that Enviournment Variable</bold>
33+
As usual, there are several way to tell a Qt5 app about your desired color scheme, likely settings are 'gtk2', 'gtk3' or 'qt5ct', all done the same ways -
34+
If just starting tomboy-ng from the command line, maybe just testing, just set the variable before the app name, leaving a space between them -
35+
$&gt; <monospace>QT_QPA_PLATFORMTHEME=qt5ct tomboy-ng [enter]</monospace>
36+
37+
Better still, make all your Qt5 app have a nice uniform look. Set that var in either /etc/environment (requires root) or, far simpler in a .xsessionrc file in your home dir.
3338

3439
<monospace>cd ; echo "export QT_QPA_PLATFORMTHEME=qt5ct" &gt;&gt; .xsessionrc</monospace>
3540

36-
And logging out and back in again, the qt5ct command has a nice GUI to let you select your look and feel. But don't set qt5ct to gtk2, messes with highlighting found text.
41+
And logging out and back in again, the qt5ct command has a nice GUI to let you select your look and feel.
3742

38-
A similar, simpler and perhaps better approach is to tell the Qt5 app to follow the current (probably gtk2) theme on your system. Similar to above, just set QT_QPA_PLATFORMTHEME=gtk2 instead of the above. You may need to install qt5-style-plugins package package if its not already installed.
3943
<bold>Cancelled Bullets</bold> - When text is bulleted and then converted back to plaintext, it has a small indent that is not removable. It goes away when next the note is loaded and is not show in printed copy but is annoying! Its an upstream issue and its being worked on.
4044

4145
<size:large><bold>Dark Theme</bold></size:large>
42-
At present, seems only GTK2 and to a limited extent, Windows can pick up colours from the OS :-(
43-
So, its now possible to pass --dark-theme to the application on the command line and you get, sort of, a Dark Theme. Sadly, some forms in the application are based on components that simply will not play, Settings being a good example. Sorry.
46+
GTK2 (and Qt5 using tricks mentioned above) do a clean and functional Dark Theme. Windows can pick up Dark from the OS but its not a completely satisfactory solution.
47+
48+
It also possible to pass a --dark-theme switch to the application on the command line and you get, sort of, a Dark Theme. Sadly, some forms in the application are based on components that simply will not play, Settings being a good example. Sorry.
4449

4550
<size:large><bold>QT5 versions and Gnome Desktops</bold></size:large>
4651
It appears that even Qt5 apps can now use XWayland so much of this is unnecessary, leave it here for now, just in case.
@@ -51,10 +56,10 @@ QT_QPA_PLATFORM=wayland tomboy-ng [enter]
5156
You can do so (if you have qtwayland5 installed) but it seems to make little or no difference and does trigger a couple of warning messages from the QT libraries. So, honestly, don't worry about it.
5257

5358
<size:large><bold>Calc separator</bold></size:large>
54-
In the calculator, many countries use the comma instead of a period as a decimal separator. Turns out this could be quite a challenge, my apologies to people from locales where this is an issue. https://forum.lazarus.freepascal.org/index.php/topic,56305.msg418384.html#msg418384
59+
In the calculator, many countries use the comma instead of a period as a decimal separator. Quite difficult to fix, my apologies to people from locales where this is an issue. https://forum.lazarus.freepascal.org/index.php/topic,56305.msg418384.html#msg418384
5560

5661
<size:large><bold>System Tray Issues</bold></size:large>
57-
Please see https://github.com/tomboy-notes/tomboy-ng/wiki/System-Tray-on-Linux
62+
Please see https://github.com/tomboy-notes/tomboy-ng/wiki/System-Tray-on-Linux - generally only a problem for people using the Gnome Desktop.
5863

5964

6065
<size:huge><bold>Long term 'maybe' stuff</bold></size:huge>
@@ -117,8 +122,8 @@ In all cases, you may need to zip that file up to post it on Github. If you do
117122

118123

119124
</note-content></text>
120-
<last-change-date>2023-04-05T15:04:35.1004151+10:00</last-change-date>
121-
<last-metadata-change-date>2023-04-05T15:04:35.1004151+10:00</last-metadata-change-date>
125+
<last-change-date>2023-04-09T17:13:18.6291587+10:00</last-change-date>
126+
<last-metadata-change-date>2023-04-09T17:13:18.6291587+10:00</last-metadata-change-date>
122127
<create-date>2018-06-23T12:35:30.7960000+10:00</create-date>
123128
<cursor-position>1</cursor-position>
124129
<selection-bound-position>1</selection-bound-position>

doc/wiki/Releases.note

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<note version="0.3" xmlns:link="http://beatniksoftware.com/tomboy/link" xmlns:size="http://beatniksoftware.com/tomboy/size" xmlns="http://beatniksoftware.com/tomboy">
3-
<title>tomboy-ng v0.36a Release Page</title>
3+
<title>tomboy-ng v0.36b Release Page</title>
44

5-
<text xml:space="preserve"><note-content version="0.1"><underline>tomboy-ng v0.36a Release Page</underline>
5+
<text xml:space="preserve"><note-content version="0.1"><underline>tomboy-ng v0.36b Release Page</underline>
66

77
<size:small>Don't edit this file, its generated from Releases.note in doc dir, converted to md and processed by releasepage tool.</size:small>
88

@@ -139,8 +139,8 @@ ToDo : New Raspberry Pi OS, 32 and 64 bit do not ship with GTK2 preinstalled. So
139139

140140

141141
</note-content></text>
142-
<last-change-date>2023-04-05T17:23:16.2203356+10:00</last-change-date>
143-
<last-metadata-change-date>2023-04-05T17:23:16.2203356+10:00</last-metadata-change-date>
142+
<last-change-date>2023-04-09T17:40:40.8437996+10:00</last-change-date>
143+
<last-metadata-change-date>2023-04-09T17:40:40.8437996+10:00</last-metadata-change-date>
144144
<create-date>2020-01-22T14:51:55.8970000+11:00</create-date>
145145
<cursor-position>1</cursor-position>
146146
<selection-bound-position>1</selection-bound-position>

0 commit comments

Comments
 (0)