Merge branch 'devel' of https://github.com/boltex/leojs into gh-pages

web/copy-build.js

@@ -5,11 +5,20 @@ const path = require('path');
 const sourceDir = path.join(__dirname, 'build');
 const targetDir = path.join(__dirname, '..', 'docs');
 
-// Copy the directory
-fs.copy(sourceDir, targetDir, function (err) {
+// Empty the target directory first
+fs.emptyDir(targetDir, function (err) {
     if (err) {
-        console.error('Error copying files:', err);
+        console.error('Error clearing the target directory:', err);
         return;
     }
-    console.log('Build directory copied successfully!');
-});
+    console.log('Target directory cleared.');
+
+    // Copy the directory
+    fs.copy(sourceDir, targetDir, function (err) {
+        if (err) {
+            console.error('Error copying files:', err);
+            return;
+        }
+        console.log('Build directory copied successfully!');
+    });
+});

web/docs/advanced-topics/faq.md

@@ -1,5 +1,6 @@
 ---
 sidebar_position: 3
+toc_max_heading_level: 2
 ---
 
 # FAQ

web/docs/appendices/glossary.md

@@ -194,6 +194,12 @@ This is a short glossary of important terms in Leo's world. For more information
 ### Descendant
     An offspring of a node.  That is, a child, grandchild, etc. of a node.
 
+### Detached Body pane
+
+    In LeoJS, a **Detached Body Pane** is independent of the selected node. This can be useful when needing to compare some nodes contents to another.
+
+    They can be opened with the 'Open Aside' command. That command is also available when right-clicking on a node in the outline via its context menu.
+
 ### Directive
 
     A keyword, preceded by an '@' sign, in body text that controls Leo's

web/docs/appendices/history.md

@@ -1,5 +1,6 @@
 ---
 sidebar_position: 4
+toc_max_heading_level: 3
 ---
 
 # History of Leo

web/docs/getting-started/tutorial-pim.md

@@ -51,10 +51,10 @@ Leo highlights URLs whenever syntax is coloring is enabled.
 
 @chapter trees denote a **chapter**. You can **activate** a chapter from the icon area, or with chapter-select commands. Activating a chapter makes only those nodes in the chapter visible. The `main` chapter represents the entire outline. Activating the `main ` chapter shows all outline nodes.
 
- `chapter-select-main`\
+`chapter-select-main`\
     Selects the main chapter.
 
- `chapter-select-<chapter-name>`\
+`chapter-select-<chapter-name>`\
     Selects a chapter by name.
 
 ## Summary

web/docs/getting-started/tutorial-tips.md

@@ -1,5 +1,6 @@
 ---
 sidebar_position: 5
+toc_max_heading_level: 2
 ---
 
 # Useful Tips

web/docs/users-guide/commands.md

@@ -6,13 +6,18 @@ sidebar_position: 3
 
 This chapter lists almost all of Leo's commands. It starts with a discussion of the Emacs-like minibuffer.
 
-## Executing commands from the minibuffer
+## Using the the minibuffer
 
-Leo’s minibuffer appears at the bottom of Leo’s main window. You use the minibuffer to execute commands by name, and also to accumulate arguments to commands.
+Use `Alt-X` to open the minibuffer input box. You use the minibuffer to execute commands by name.
+
+![Leo's Minibuffer](./img/minibuffer-sc.png)
 
 Every Leo command has a **command name**. In this document, keystrokes that invoke a command will be followed by the command name in parentheses. For example, `Ctrl-S (save-file)` saves a Leo file.
 
-**Very Important**: Leo has hundreds of commands, but because of tab completion you do not have to remember, or even *know about* any of them.  Feel free to ignore commands that you don't use. The following prefixes help find commands by name:
+> 💡 **TIP**\
+> Leo has hundreds of commands, but because of auto-completion you do not have to remember, or even *know about* any of them.  Feel free to ignore commands that you don't use.
+
+The following prefixes help find commands by name:
 
 | Prefix      | Category                     |
 |:------------|:-----------------------------|
@@ -386,8 +391,9 @@ Leo preprocesses all scripts by simulating the writing of a external file to a s
 
 #### Multiple body editors
 
-`open-aside`\
+`open-aside` 🖱️ _Right-Click on node_\
     Detached Body Panes, independent of the selected node, can be opened with the 'Open Aside' command.
+    That command is also available when right-clicking on a node in the outline via its context menu.
 
 #### Undoing changes
 

web/src/css/custom.css

@@ -61,6 +61,9 @@
   --ifm-code-font-size: 95%;
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);
 
+  --custom-hero-bg: url('/img/banner-leojs-trans-1600.png');
+  --custom-hero-bg2: url('/img/banner-leojs-trans-1200.png');
+  --custom-hero-bg3: url('/img/banner-leojs-trans-800.png');
   --custom-hero-bg-before: linear-gradient(45deg, rgba(194, 107, 46, 0.5), rgba(150, 59, 29, 0.9));
 
   --custom-body-bg: #fdf4f5;
@@ -101,6 +104,9 @@
   --custom-body-bg: #1d1b1b;
   --custom-sidebar-bg: #24201c;
 
+  --ifm-background-color: #3468ac;
+  --ifm-background-surface-color: #682d2d;
+
   --custom-home-quote-color: #92c4e1;
   --custom-home-author-color: #dcdcdc;
 

web/src/pages/index.module.css

@@ -18,10 +18,9 @@
 
 .customHero:after {
   filter: blur(11px);
-  background-image: url('/img/banner-leojs-trans-1200.png');
-  background-size: 100% auto;
-  background-position: top;
-  background-attachment: fixed;
+  background-image: var(--custom-hero-bg);
+  background-size: cover;
+  background-position: center;
   content: '';    
   display: block;
   height: 100%;
@@ -105,7 +104,7 @@
 .puckBg {
   padding-top: 1rem;
   padding-bottom: 1rem;
-  background-image: url('/img/banner-leojs-trans-800.png');
+  background-image: var(--custom-hero-bg3);
   background-color: #8e451527;
   background-attachment: fixed;
   background-position: center;