Themeing is here! Misc doc fixes

sottey · Oct 25, 2023 · 61b4466 · 61b4466
1 parent 1e8f615
commit 61b4466
Show file tree

Hide file tree

Showing 39 changed files with 449 additions and 12 deletions.
diff --git a/README.md b/README.md
@@ -6,15 +6,16 @@ Redo.vc is a tool for command line fans that allows you to track your tasks. It
 To learn about available redo.vc commands, see the [usage page](https://redo.vc/usage/)
 
 ## Features
-
+* [NEW] [Theming capabilities](https://redo.vc/theming)
+* [NEW] Adding additional due strings (End of quarter, End of Month)
 * Tasks can be assigned to a project
 * Projects can be created dynamically while creating todos
 * Tasks can have a due date or NO due date
 * Tags can be specified by using the '#' prepended to single word. If it does not exist, it will be created
 * Projects can be specified by using the '+' prepended to a single word in the description. If the project does not exist, it will be created
 * Tasks can be prioritized
 * Notes can be added to tasks and shown or hidden when listing tasks
-* Due dates can be absolute (oct25) or relative (monday, today, etc.)
+* Due dates can be absolute (oct25, 25oct) or relative (monday, today, none, etc.)
 * Tasks can be marked as completed
 * Tasks can be archived
 * Tasks can be deleted
@@ -27,15 +28,14 @@ To learn about available redo.vc commands, see the [usage page](https://redo.vc/
 
 
 ## Future Plans
-* Theming
+* ~~Theming capabilities~~
+* ~~Adding additional due strings (End of quarter, End of Month)~~
 * Syncing via cloud providers (Google Drive, iCloud, Dropbox, etc.)
 * Web UI
 * Importing from common formats
 * Config file defaults
 * Whatever you would like to see! [Let me know](https://github.com/sottey/redo.vc/discussions)
 
-## GitHub
-All source code is available on [GitHub](https://github.com/sottey/redo.vc)
 
 ## Building
 

diff --git a/Rakefile b/Rakefile
@@ -11,7 +11,7 @@ Envs = [
   { goos: "windows", arch: "amd64" }
 ].freeze
 
-Version = "1.7.4".freeze
+Version = "1.7.5".freeze
 
 task :build do
   `rm -rf dist/#{Version}`

diff --git a/dist/1.7.5/redovc_win.zip b/dist/1.7.5/redovc_win.zip
diff --git a/dist/1.7.5/redovcdarwin_amd64.tar.gz b/dist/1.7.5/redovcdarwin_amd64.tar.gz
diff --git a/dist/1.7.5/redovclinux_386.tar.gz b/dist/1.7.5/redovclinux_386.tar.gz
diff --git a/dist/1.7.5/redovclinux_amd64.tar.gz b/dist/1.7.5/redovclinux_amd64.tar.gz
diff --git a/dist/1.7.5/redovclinux_arm.tar.gz b/dist/1.7.5/redovclinux_arm.tar.gz
diff --git a/dist/1.7.5/redovclinux_arm64.tar.gz b/dist/1.7.5/redovclinux_arm64.tar.gz
diff --git a/main b/main
diff --git a/redovc/app.go b/redovc/app.go
@@ -10,7 +10,7 @@ import (
 
 const (
 	// Current version of redovc.
-	VERSION string = "1.7.4"
+	VERSION string = "1.7.5"
 
 	DATE_FORMAT string = "2006-01-02"
 )

diff --git a/redovc_docs/docs/index.md b/redovc_docs/docs/index.md
@@ -6,7 +6,7 @@ Redo.vc is a tool for command line fans that allows you to track your tasks. It
 To learn about available redo.vc commands, see the [usage page](https://redo.vc/usage/)
 
 ## Features
-* [NEW] Theming capabilities
+* [NEW] [Theming capabilities](https://redo.vc/theming)
 * [NEW] Adding additional due strings (End of quarter, End of Month)
 * Tasks can be assigned to a project
 * Projects can be created dynamically while creating todos
@@ -28,6 +28,8 @@ To learn about available redo.vc commands, see the [usage page](https://redo.vc/
 
 
 ## Future Plans
+* ~~Theming capabilities~~
+* ~~Adding additional due strings (End of quarter, End of Month)~~
 * Syncing via cloud providers (Google Drive, iCloud, Dropbox, etc.)
 * Web UI
 * Importing from common formats

diff --git a/redovc_docs/docs/theming.md b/redovc_docs/docs/theming.md
@@ -0,0 +1,90 @@
+# Theming
+
+## Themes
+Command shells have very limited color abilities, but I decided it would be good to not impose my color scheme on everyone who uses redovc.... So, theming.
+
+## Theme file
+A theme file can live in your home directory and it will be used as the default. You can also have theme files in other directories and when you are in that directory, that theme will be used.
+
+The theme file must be named .todos.theme.json and the contents are used to describe how different sections of the redovc list command presents data.
+
+## Theme file color structure
+You can find sample theme files in the [sampleThemes](https://github.com/sottey/redo.vc/tree/main/sampleThemes) directory of the source code.
+
+For each section, there are a number of properties:
+
+- Desc - Color of group names when group: is specified
+- Name - Name of section. These are used by the code and must be one of:
+    - groupTitleColor - Color of group names when group: is specified
+    - noteIDColor - Color of note id's when --notes is used
+    - noteTextColor - Color of note contents when --notes is used
+    - taskIDColor - Color of a task id
+    - taskIDPriColor - Color of a task id if the task is prioritized
+    - completedColor - Color of completed indicator ([ ] or [X])
+    - statusColor - Color of task status
+    - statusPriColor - Color of a task status if task is prioritized
+    - informationColor - Color of area indicating Priority, Note and Archived
+    - todayColor - Color of a task due today
+    - todayPriColor - Color of a task due today if that task is prioritized
+    - tomorrowColor - Color of a task due tomorrow
+    - tomorrowPriColor - Color of a task due tomorrow if that task is prioritized
+    - overdueColor - Color of a task that is overdue
+    - overduePriColor - Color of a task that is overdue if that task is prioritized
+    - otherDue - Color of a task that is not today, tomorrow or overdue
+    - otherDuePriColor - Color of a task that is not today, tomorrow or overdue if the task is prioritized
+    - taskTextColor - Color of task text
+    - taskTextProjectWordColor - Color of project names in task text
+    - taskTextTagWordColor - Color of tags in task text
+    - taskTextPriColor - Color of task text if the task is prioritized
+    - taskTextProjectPriWordColor - Color of project names in task text if that task is prioritized
+    - taskTextTagWordPriColor - Color of tags in task text if that task is prioritized
+- Color - The color to be used. Valid colors are:
+	- black
+	- red
+	- green
+	- yellow
+	- blue
+	- magenta
+	- cyan
+	- white
+- Bold = true or false
+
+## Theme File Column Ordering Structure (not yet implemented):
+I am working on people being able to specify what order the columns are displayed when using 'redovc list'. These will be contained in the theme file as well.
+
+Currently, the json looks like this:
+```
+    "Columns":
+    [
+        {
+            "desc": "Task ID",
+            "columnname": "id",
+            "index":0
+        },
+        {
+            "desc": "Completed column",
+            "columnname": "completed",
+            "index":1
+        },
+        {
+            "desc": "Information - Priority, Note and Archived flags",
+            "columnname": "information",
+            "index":2
+        },
+        {
+            "desc": "Task Due date",
+            "columnname": "due",
+            "index":3
+        },
+        {
+            "desc": "Task status",
+            "columnname": "status",
+            "index":4
+        },
+        {
+            "desc": "Task subject",
+            "columnname": "subject",
+            "index":5
+        }
+    ],
+```
diff --git a/redovc_docs/mkdocs.yml b/redovc_docs/mkdocs.yml
@@ -4,5 +4,6 @@ site_url: https://redo.vc/
 nav:
   - Home: index.md
   - Usage: usage.md
+  - Theming: theming.md
   - On GitHub: https://github.com/sottey/redo.vc
 
diff --git a/redovc_docs/site/404.html b/redovc_docs/site/404.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="/usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="/theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/add/index.html b/redovc_docs/site/commands/add/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/addnote/index.html b/redovc_docs/site/commands/addnote/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/archive/index.html b/redovc_docs/site/commands/archive/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/complete/index.html b/redovc_docs/site/commands/complete/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/completion/index.html b/redovc_docs/site/commands/completion/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/delete/index.html b/redovc_docs/site/commands/delete/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/deletenote/index.html b/redovc_docs/site/commands/deletenote/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/edit/index.html b/redovc_docs/site/commands/edit/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/editnote/index.html b/redovc_docs/site/commands/editnote/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/export/index.html b/redovc_docs/site/commands/export/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/help/index.html b/redovc_docs/site/commands/help/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/init/index.html b/redovc_docs/site/commands/init/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/list/index.html b/redovc_docs/site/commands/list/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/prioritize/index.html b/redovc_docs/site/commands/prioritize/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/status/index.html b/redovc_docs/site/commands/status/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/unarchive/index.html b/redovc_docs/site/commands/unarchive/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/uncomplete/index.html b/redovc_docs/site/commands/uncomplete/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/unprioritize/index.html b/redovc_docs/site/commands/unprioritize/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>

diff --git a/redovc_docs/site/commands/version/index.html b/redovc_docs/site/commands/version/index.html
@@ -36,6 +36,9 @@
                             <li class="navitem">
                                 <a href="../../usage/" class="nav-link">Usage</a>
                             </li>
+                            <li class="navitem">
+                                <a href="../../theming/" class="nav-link">Theming</a>
+                            </li>
                             <li class="navitem">
                                 <a href="https://github.com/sottey/redo.vc" class="nav-link">On GitHub</a>
                             </li>