From 9795164eda3be4a00490bd90b4a4fca92d1dd3df Mon Sep 17 00:00:00 2001 From: rootiest Date: Mon, 8 Jun 2026 11:35:00 -0400 Subject: [PATCH] feat(docs): add dark-mode HTML styling and drop per-page ToC - Add docs/html-style.html with Catppuccin Latte/Mocha palette, auto-selected via prefers-color-scheme - Update html-docs workflow: embed stylesheet via --include-in-header, remove --toc so per-page sidebar is gone (index.html remains the ToC) - Touch docs/fish-config.md to trigger the HTML generation workflow fix(ci): clear docs/html/ before pandoc to avoid directory-exists error fix(docs): restore toc on index, hide it on section pages via JS, fix full-page bg fix(docs): fix nav alignment by grouping label+link pairs as flex units chore(docs): regenerate offline HTML docs --- .gitea/workflows/html-docs.yml | 4 +- docs/html-style.html | 301 ++++++++++ docs/html/1-name.html | 608 ++++++++++----------- docs/html/10-6-dependency-catalog.html | 608 ++++++++++----------- docs/html/11-7-customization.html | 608 ++++++++++----------- docs/html/12-8-fisher-plugins.html | 608 ++++++++++----------- docs/html/13-9-viewing-this-manual.html | 608 ++++++++++----------- docs/html/2-synopsis.html | 608 ++++++++++----------- docs/html/3-description.html | 608 ++++++++++----------- docs/html/4-table-of-contents.html | 608 ++++++++++----------- docs/html/5-1-configuration-variables.html | 608 ++++++++++----------- docs/html/6-2-path-setup.html | 608 ++++++++++----------- docs/html/7-3-key-bindings.html | 608 ++++++++++----------- docs/html/8-4-abbreviations.html | 608 ++++++++++----------- docs/html/9-5-functions-reference.html | 608 ++++++++++----------- docs/html/index.html | 301 ++++++++++ 16 files changed, 4518 insertions(+), 3992 deletions(-) create mode 100644 docs/html-style.html diff --git a/.gitea/workflows/html-docs.yml b/.gitea/workflows/html-docs.yml index fac9cd5..5e67c2e 100644 --- a/.gitea/workflows/html-docs.yml +++ b/.gitea/workflows/html-docs.yml @@ -25,7 +25,9 @@ jobs: - name: Generate chunked HTML docs run: | - pandoc -f gfm -t chunkedhtml --split-level=1 --toc -V toc=true \ + rm -rf docs/html/ + pandoc -f gfm -t chunkedhtml --split-level=1 --toc \ + --include-in-header docs/html-style.html \ docs/fish-config.md \ -o docs/html/ diff --git a/docs/html-style.html b/docs/html-style.html new file mode 100644 index 0000000..2cecdbc --- /dev/null +++ b/docs/html-style.html @@ -0,0 +1,301 @@ + + diff --git a/docs/html/1-name.html b/docs/html/1-name.html index e765cb6..dbaa08f 100644 --- a/docs/html/1-name.html +++ b/docs/html/1-name.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + + -

NAME

fish-config - personal fish shell configuration for Fish 4.x with modern CLI tool integration

diff --git a/docs/html/10-6-dependency-catalog.html b/docs/html/10-6-dependency-catalog.html index f309bfe..21bcaa8 100644 --- a/docs/html/10-6-dependency-catalog.html +++ b/docs/html/10-6-dependency-catalog.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + + -

6. DEPENDENCY CATALOG

fish-deps manages these tools. Run fish-deps to check diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html index 24f2108..ca26cdc 100644 --- a/docs/html/11-7-customization.html +++ b/docs/html/11-7-customization.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + +

-

7. CUSTOMIZATION

Machine-local Configuration

diff --git a/docs/html/12-8-fisher-plugins.html b/docs/html/12-8-fisher-plugins.html index 07dd132..a963126 100644 --- a/docs/html/12-8-fisher-plugins.html +++ b/docs/html/12-8-fisher-plugins.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + + -

8. FISHER PLUGINS

Fisher is bootstrapped automatically on the first interactive session via conf.d/first_run.fish. This also diff --git a/docs/html/13-9-viewing-this-manual.html b/docs/html/13-9-viewing-this-manual.html index 5f76e6b..f85ab14 100644 --- a/docs/html/13-9-viewing-this-manual.html +++ b/docs/html/13-9-viewing-this-manual.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + +

-

9. VIEWING THIS MANUAL

SYNOPSIS

help config [SECTION]

Open this manual in the best available pager. Optionally jump to a diff --git a/docs/html/3-description.html b/docs/html/3-description.html index efd2e05..7de2f1f 100644 --- a/docs/html/3-description.html +++ b/docs/html/3-description.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + +

-

DESCRIPTION

A production-grade Fish shell configuration targeting Fish 4.x. It provides:

diff --git a/docs/html/4-table-of-contents.html b/docs/html/4-table-of-contents.html index bffa8a8..fcb86d6 100644 --- a/docs/html/4-table-of-contents.html +++ b/docs/html/4-table-of-contents.html @@ -167,6 +167,307 @@ } .display.math{display: block; text-align: center; margin: 0.5rem auto;} + + -

TABLE OF CONTENTS

1.  Configuration Variables
 2.  PATH Setup
diff --git a/docs/html/5-1-configuration-variables.html b/docs/html/5-1-configuration-variables.html
index 35408c0..b2f731c 100644
--- a/docs/html/5-1-configuration-variables.html
+++ b/docs/html/5-1-configuration-variables.html
@@ -167,6 +167,307 @@
     }
     .display.math{display: block; text-align: center; margin: 0.5rem auto;}
   
+  
+  
 
 
 
-
 
1. CONFIGURATION
 VARIABLES

 
These variables are exported from config.fish on every interactive
diff --git a/docs/html/6-2-path-setup.html b/docs/html/6-2-path-setup.html
index 1a37fee..63dc20a 100644
--- a/docs/html/6-2-path-setup.html
+++ b/docs/html/6-2-path-setup.html
@@ -167,6 +167,307 @@
     }
     .display.math{display: block; text-align: center; margin: 0.5rem auto;}
   
+  
+  
 
 
 

-
 
2. PATH SETUP

 
Directories prepended to PATH in this order (first wins):

 
~/.local/bin              Standard user-local executables
diff --git a/docs/html/7-3-key-bindings.html b/docs/html/7-3-key-bindings.html
index 191f8bc..c42f744 100644
--- a/docs/html/7-3-key-bindings.html
+++ b/docs/html/7-3-key-bindings.html
@@ -167,6 +167,307 @@
     }
     .display.math{display: block; text-align: center; margin: 0.5rem auto;}
   
+  
+  
 
 
 
-
 
3. KEY BINDINGS

 
The shell uses Vi key bindings (fish_vi_key_bindings). All custom
 bindings are active in Insert, Normal, and Visual modes unless
diff --git a/docs/html/8-4-abbreviations.html b/docs/html/8-4-abbreviations.html
index 63f65e4..8818fba 100644
--- a/docs/html/8-4-abbreviations.html
+++ b/docs/html/8-4-abbreviations.html
@@ -167,6 +167,307 @@
     }
     .display.math{display: block; text-align: center; margin: 0.5rem auto;}
   
+  
+  
 
 
 

-
 
4. ABBREVIATIONS

 
Abbreviations expand when you press Space or Enter. They are
 terminal-aware: some expand differently in Kitty vs WezTerm vs other
diff --git a/docs/html/9-5-functions-reference.html b/docs/html/9-5-functions-reference.html
index 8bc1f1b..9c2e59d 100644
--- a/docs/html/9-5-functions-reference.html
+++ b/docs/html/9-5-functions-reference.html
@@ -167,6 +167,307 @@
     }
     .display.math{display: block; text-align: center; margin: 0.5rem auto;}
   
+  
+  
 
 
 

-
 
5. FUNCTIONS
 REFERENCE

 
5.1 File and
diff --git a/docs/html/index.html b/docs/html/index.html
index 29ed1fa..3d6d16e 100644
--- a/docs/html/index.html
+++ b/docs/html/index.html
@@ -167,6 +167,307 @@
     }
     .display.math{display: block; text-align: center; margin: 0.5rem auto;}
   
+  
+