From 6d1d497a635ea51d9706158d6b5bc35583b02aeb Mon Sep 17 00:00:00 2001
From: "jeremy@jermolene.com" <jeremy@jermolene.com>
Date: Thu, 25 Nov 2021 18:00:32 +0000
Subject: [PATCH] Tweak docs for #6268

---
 core/wiki/debugstylesheets.tid                       |  8 +-------
 .../tiddlers/howtos/Debugging Stylesheets.tid        | 11 +++++++++++
 .../tw5.com/tiddlers/howtos/Using Stylesheets.tid    | 12 ++++++++----
 3 files changed, 20 insertions(+), 11 deletions(-)
 create mode 100644 editions/tw5.com/tiddlers/howtos/Debugging Stylesheets.tid

diff --git a/core/wiki/debugstylesheets.tid b/core/wiki/debugstylesheets.tid
index 5646f662f..39621d2e9 100644
--- a/core/wiki/debugstylesheets.tid
+++ b/core/wiki/debugstylesheets.tid
@@ -1,15 +1,9 @@
 title: $:/snippets/DebugStylesheets
 
-Broken stylesheets will have a red cross next to their name :
-
 <style>[test]{list-style:'❌'}</style>
 <ul>
-<$list filter="[all[shadows+tiddlers]tag[$:/tags/Stylesheet]has[modified]]" counter=n>
+<$list filter="[all[shadows+tiddlers]tag[$:/tags/Stylesheet]has[modified]]" counter="n">
 <style>{{!!text}}[test="<<n>>"]{list-style:disc;}</style>
 <li test=<<n>>><$link/></li>
 </$list>
 </ul>
-
-Replace "list-style:disc;" by "display:none;" to only display the stylesheets with css syntax error.
-
-These may contains [[unclosed block(s)|https://www.w3.org/TR/css-syntax-3/#consume-a-simple-block]], please review and fix them to prevent tiddlywiki's interface from malfunctioning.
diff --git a/editions/tw5.com/tiddlers/howtos/Debugging Stylesheets.tid b/editions/tw5.com/tiddlers/howtos/Debugging Stylesheets.tid
new file mode 100644
index 000000000..65866867c
--- /dev/null
+++ b/editions/tw5.com/tiddlers/howtos/Debugging Stylesheets.tid	
@@ -0,0 +1,11 @@
+created: 20211125175712017
+modified: 20211125175906085
+tags: [[Using Stylesheets]]
+title: Debugging Stylesheets
+type: text/vnd.tiddlywiki
+
+The core shadow tiddler $:/snippets/DebugStylesheets contains a simple tool for tracking down certain problems with mismatched brackets and other nested structures.
+
+In the list below, any stylesheets containing an error will be marked with a red cross:
+
+{{$:/snippets/DebugStylesheets}}
diff --git a/editions/tw5.com/tiddlers/howtos/Using Stylesheets.tid b/editions/tw5.com/tiddlers/howtos/Using Stylesheets.tid
index 3af3742db..3d41d3f19 100644
--- a/editions/tw5.com/tiddlers/howtos/Using Stylesheets.tid	
+++ b/editions/tw5.com/tiddlers/howtos/Using Stylesheets.tid	
@@ -1,5 +1,5 @@
 created: 20140305091244145
-modified: 20210104090402829
+modified: 20211125175708977
 tags: [[Customise TiddlyWiki]]
 title: Using Stylesheets
 type: text/vnd.tiddlywiki
@@ -16,9 +16,9 @@ type: text/vnd.tiddlywiki
 
 The first steps to changing the appearance of ~TiddlyWiki are to choose and apply:
 
-* One of the available themes: <span class="tc-btn-standard"> {{$:/core/ui/Buttons/theme}} </span>
-* Modify the colour palette: <span class="tc-btn-standard"> {{$:/core/ui/Buttons/palette}} </span>
-* Experiment with the <$button actions=<<openCpTheme>> ><<.icon $:/core/images/options-button>> ControlPanel</$button>
+* One of the available themes: {{$:/core/ui/Buttons/theme}}
+* Modify the colour palette: {{$:/core/ui/Buttons/palette}}
+* Experiment with the <$button actions=<<openCpTheme>> class="tc-btn-invisible"><<.icon $:/core/images/options-button>> ~ControlPanel</$button>
 
 ! Work with Stylesheets
 
@@ -73,3 +73,7 @@ A stylesheet tiddler is processed such that it is first wikified and then the te
 !! Stylesheet Macros
 
 The ~TiddlyWiki core provides several [[global macros that are helpful in constructing stylesheets|Stylesheet Macros]].
+
+!! See Also
+
+* <<list-links "[tag[Using Stylesheets]]">>