diff --git a/docs/Editing/About Editing.md b/docs/Editing/About Editing.md index ee6be67ed3..314a45a6eb 100644 --- a/docs/Editing/About Editing.md +++ b/docs/Editing/About Editing.md @@ -19,5 +19,7 @@ Tasks has a growing number of ways to conveniently add data to your task lines. - [[Toggling and Editing Statuses]] - All the ways to edit task statuses. +- [[Editing Dates]] + - All the ways to edit dates on tasks. - [[Postponing]] - Easy deferring or snoozing of due, scheduled and start dates. diff --git a/docs/Editing/Editing Dates.md b/docs/Editing/Editing Dates.md new file mode 100644 index 0000000000..35519e4b7c --- /dev/null +++ b/docs/Editing/Editing Dates.md @@ -0,0 +1,73 @@ +--- +publish: true +--- + +# Editing Dates + +#feature/dates + +## Summary + +Tasks supports a range of date properties for managing your tasks: see [[Dates]]. + +This page describes ways to add, edit and remove date values on tasks. + +There is a [[#Date-picker on task dates]] and a [[#Context menu on task dates]], or you can use various [[#other date-editing options]]. + +## Date-picker on task dates + +> [!released] +> Introduced in Tasks X.Y.Z. + +**Left-click on any task date field** in **Reading mode** and **Tasks query search results** to use a date-picker and calendar to edit or remove a date. + +![Hover over a date in Read mode or Tasks query search results](../images/date-picker-1.png) +Hover over a date in Read mode or Tasks query search results + +![In the date-picker, you can easily select a new date, or clear the current one](../images/date-picker-2.png) +In the date-picker, you can easily select a new date, or clear the current one + +| Where | Viewing Mode | Works? | +| ----------------------------- | ------------ | ------ | +| Task lines in markdown files | Source mode | ❌ | +| Task lines in markdown files | Live Preview | ❌ | +| Task lines in markdown files | Reading mode | ✅ | +| In Tasks query search results | Live Preview | ✅ | +| In Tasks query search results | Reading mode | ✅ | + +## Context menu on task dates + +> [!released] +> Introduced in Tasks 7.10.0. + +**Right-click on any task date field** in **Reading mode** and **Tasks query search results** to: + +- postpone Start, Scheduled and Due dates +- advance Created, Cancelled and Done dates + +![Hover over a date in Read mode or Tasks query search results](../images/date-context-menu-1.png) +Hover over a date in Read mode or Tasks query search results + +![Chose an option from the context menu](../images/date-context-menu-2.png) +Chose an option from the context menu + +| Where | Viewing Mode | Works? | +| ----------------------------- | ------------ | ------ | +| Task lines in markdown files | Source mode | ❌ | +| Task lines in markdown files | Live Preview | ❌ | +| Task lines in markdown files | Reading mode | ✅ | +| In Tasks query search results | Live Preview | ✅ | +| In Tasks query search results | Reading mode | ✅ | + +## Other date-editing options + +In **Editing mode** (both Source mode and Live Preview) the options are: + +- Type the dates yourself. +- Use [[Auto-Suggest]] to add emojis and a range of convenient dates. +- Using the `Create or edit Task` command to access the [[Create or edit Task]] modal/dialog. + +In **Reading mode** and **Tasks query search results** the options are: + +- Click or right-click ⏩ to use the [[Postponing|Postpone]] button. +- Click the Pencil icon (📝) to use the [[Create or edit Task]] modal/dialog. diff --git a/docs/What is New/Changelog.md b/docs/What is New/Changelog.md index 376cf31d40..5c816e7c42 100644 --- a/docs/What is New/Changelog.md +++ b/docs/What is New/Changelog.md @@ -12,6 +12,8 @@ _In recent [Tasks releases](https://github.com/obsidian-tasks-group/obsidian-tas ## 7.x releases +- X.Y.Z: + - Add [[Editing Dates#Date-picker on task dates|date picker]] to Reading mode and Tasks query search results. - 7.13.0: - Add [[Create or edit Task#Date picker|date picker]] to the Edit Task modal. - 7.12.0: @@ -19,9 +21,7 @@ _In recent [Tasks releases](https://github.com/obsidian-tasks-group/obsidian-tas - 7.11.0: - Add [[Sorting#Random sorting|random sorting]], with `sort by random` - 7.10.0: - - Right-click on any task date field in Reading and Query Results views to: - - postpone Start, Scheduled and Due dates - - advance Created, Cancelled and Done dates + - Add [[Editing Dates#Context menu on task dates|right-click context menu on dates]] in Reading and Query Results views. - 7.9.0: - Add [[Layout|hide and show]] instructions `hide on completion` and `show on completion`. - Add one-click support for the [[Border Theme|Border]] theme. diff --git a/docs/images/date-context-menu-1.png b/docs/images/date-context-menu-1.png new file mode 100644 index 0000000000..303c80ce4b Binary files /dev/null and b/docs/images/date-context-menu-1.png differ diff --git a/docs/images/date-context-menu-2.png b/docs/images/date-context-menu-2.png new file mode 100644 index 0000000000..30bf1ea851 Binary files /dev/null and b/docs/images/date-context-menu-2.png differ diff --git a/docs/images/date-picker-1.png b/docs/images/date-picker-1.png new file mode 100644 index 0000000000..b921e76b6c Binary files /dev/null and b/docs/images/date-picker-1.png differ diff --git a/docs/images/date-picker-2.png b/docs/images/date-picker-2.png new file mode 100644 index 0000000000..1b0dabfd00 Binary files /dev/null and b/docs/images/date-picker-2.png differ