SubTaskfiles

README.md

@@ -1,7 +1,7 @@
 # Taskfile ([taskfile.sh](https://taskfile.sh))
 
-A `./Taskfile` is a task runner in plain and easy [Bash](https://nl.wikipedia.org/wiki/Bash). It adds a list of
-available tasks to your project.
+A `./Taskfile` is a task runner in plain and easy [Bash](<https://en.wikipedia.org/wiki/Bash_(Unix_shell)>). It adds a
+list of available tasks to your project.
 
 Generate your own Taskfile at [taskfile.sh](https://taskfile.sh).
 
@@ -14,81 +14,21 @@ Generate your own Taskfile at [taskfile.sh](https://taskfile.sh).
 - Very easy to use
 - Automate your most common tasks (updating, starting, building, etc...)
 - Easy to understand and maintain
-- Automatically generated list of available task
+- Automatically generated list of available tasks
 
-# How does it work?
+## Documentation
 
-Taskfiles are simple bash scripts, but an easy-to-read function format. There are some things that we need to explain
-for our Taskfile setup. It all starts with a `Taskfile`. Download your `Taskfile` from
-[taskfile.sh](https://taskfile.sh) and save it. Make sure the Taskfile is executable: `chmod +x ./Taskfile`. You can now
-run `./Taskfile` in your terminal.
-
-## Tasks
-
-A task is defined by creating a function that starts with `task:`. This defines a task that can be triggered by running
-the `./Taskfile`. Right next to the task, you should add a task definition with two hashes. This will let the
-`task:help` function know that you're writing the task function definition. So an example task will look like the
-following:
-
-```shell
-function task:example { ## Show some example text
-    title "Example"
-    echo "This is an example task."
-}
-```
-
-In a task you can call other functions, and run all tooling you desire. Now running `./Taskfile example` will execute
-the new task.
-
-## Sections
-
-To group multiple tasks, sections can be created in your Taskfile. A section is created by creating a comment line with
-a double hashtag like so:
-
-```shell
-## Project section
-```
-
-Lines with only a single `#` will not appear as section in `task:help` and can be seen as plain comments.
-
-## Help command
-
-Running `./Taskfile help`, the `task:help` function is triggered. This task will list all available sections and tasks
-using the double `##` comments you've learned about above. Now it's clear how you can run any other task!
-
-# Auto-completion
-
-Autocompletion works when you use `zsh` and `oh-my-zsh`. Create the following file in your oh-my-zsh directory
-`~/.oh-my-zsh/completions/_task.zsh`:
-
-```shell
-#compdef task
-
-_task() {
-	local -a commands
-	local tasks=$(task comp_targets)
-
-	while IFS= read -r line; do
-		if [[ -n "$line" ]]; then
-			commands+=("$line")
-		fi
-	done <<< "$tasks"
-
-	_describe -t commands 'task commands' commands
-}
-
-_task "$@"
-```
-
-Now after running `task shorthand`, your `task` commands will get autocompleted.
+- [How does it work](/docs/how-does-it-work.md)
+- [Auto completion](/docs/auto-completion.md)
+- [SubTaskfiles](/docs/sub-taskfiles.md)
 
 # Credits
 
 This Taskfile setup is based on [Adrian Cooney's Taskfile](https://github.com/adriancooney/Taskfile) and is widely
-adopted by [Enrise](https://enrise.com) in our modified flavour.
+adopted by [Enrise](https://enrise.com) in our modified flavor.
 
 # Contributors
 
 A big thanks to all the contributors of Taskfile!
 
-![contirubtor avatars](https://contrib.rocks/image?repo=enrise/taskfile)
+![contributor avatars](https://contrib.rocks/image?repo=enrise/taskfile)

dev/linting/eslint.config.mjs

@@ -63,6 +63,6 @@ export default [
 		},
 	},
 	{
-		ignores: ['.next/', 'out/'],
+		ignores: ['.next/', 'out/', 'next-env.d.ts'],
 	},
 ];

docs/auto-completion.md

@@ -0,0 +1,25 @@
+# Auto-completion
+
+Autocompletion works when you use `zsh` and `oh-my-zsh`. Create the following file in your oh-my-zsh directory
+`~/.oh-my-zsh/completions/_task.zsh`:
+
+```shell
+#compdef task
+
+_task() {
+	local -a commands
+	local tasks=$(task comp_targets)
+
+	while IFS= read -r line; do
+		if [[ -n "$line" ]]; then
+			commands+=("$line")
+		fi
+	done <<< "$tasks"
+
+	_describe -t commands 'task commands' commands
+}
+
+_task "$@"
+```
+
+Now after running `task shorthand`, your `task` commands will get autocompleted.

docs/how-does-it-work.md

@@ -0,0 +1,39 @@
+# How does it work?
+
+Taskfiles are simple bash scripts, but an easy-to-read function format. There are some things that we need to explain
+for our Taskfile setup. It all starts with a `Taskfile`. Download your `Taskfile` from
+[taskfile.sh](https://taskfile.sh) and save it. Make sure the Taskfile is executable: `chmod +x ./Taskfile`. You can now
+run `./Taskfile` in your terminal.
+
+## Tasks
+
+A task is defined by creating a function that starts with `task:`. This defines a task that can be triggered by running
+the `./Taskfile`. Right next to the task, you should add a task definition with two hashes. This will let the
+`task:help` function know that you're writing the task function definition. So an example task will look like the
+following:
+
+```shell
+function task:example { ## Show some example text
+    title "Example"
+    echo "This is an example task."
+}
+```
+
+In a task you can call other functions, and run all tooling you desire. Now running `./Taskfile example` will execute
+the new task.
+
+## Sections
+
+To group multiple tasks, sections can be created in your Taskfile. A section is created by creating a comment line with
+a double hashtag like so:
+
+```shell
+## Project section
+```
+
+Lines with only a single `#` will not appear as section in `task:help` and can be seen as plain comments.
+
+## Help command
+
+Running `./Taskfile help`, the `task:help` function is triggered. This task will list all available sections and tasks
+using the double `##` comments you've learned about above. Now it's clear how you can run any other task!

docs/sub-taskfiles.md

@@ -0,0 +1,55 @@
+# SubTaskfiles
+
+SubTaskfiles allow you to divide your tasks across multiple files while still calling them from a single entrypoint (a
+familiar, regular Taskfile).
+
+Use them to split off groups of tasks that can be logically grouped together, like for specific use-cases or because
+they are rarely used. For example: git-hooks, frontend- / backend-specific tasks, tasks for (infrequently occurring)
+procedures, CI-only tasks, etc.
+
+Tasks in SubTaskfiles are never called directly, but "via" a task in the root Taskfile, like this:
+`Usage: ./Taskfile foo <task> <args>`
+
+## Live example
+
+In the Taskfile generator, you can check the "Include SubTaskfile example" checkbox, to see a full implementation
+example.
+
+## How does it work
+
+When you generate a new Taskfile via the Taskfile generator, you have a `subtaskfile` proxy function available to you.
+That allows you to create a new task to open your `SubTaskfile` from your `Taskfile`:
+
+```shell
+function task:name-of-your-subtask { ## Run a sub-task
+	subtaskfile "name-of-your-subtask" "./folder-name" "$@"
+}
+```
+
+Then, create a file named `SubTaskfile` in a relevant location (in the example above we have `folder-name/SubTaskfile`).
+Only the tasks that are relevant for this specific part of you application, go in here.
+
+**No need to redefine anything that's already in your primary Taskfile.**
+
+```shell
+#!/usr/bin/env bash
+
+function task:example { ## This is an example sub task
+    title "Run example sub task"
+	echo -e "./SubTaskfile location: ${YELLOW}$SUBTASKFILE_PATH${RESET}"
+	echo -e "${GREEN}Success!${RESET}"
+}
+```
+
+Optionally, you can include an explicit helper function for your SubTaskfile output too.
+
+```shell
+function task:subtask-help { ## Show all available sub-tasks
+	task:help
+}
+```
+
+## Note
+
+If you use the same task name in your SubTaskfile as what was already defined in the primary Taskfile, the task will be
+overwritten.

src/app/docs/auto-completion/page.tsx

@@ -0,0 +1,14 @@
+import { Metadata } from 'next';
+import Content from '@/components/Content';
+
+import markdown from '@/../docs/auto-completion.md';
+
+export const generateMetadata = (): Metadata => ({
+	title: 'Auto completion • taskfile.sh',
+	description:
+		'Quickly kick start your project by moving all your development commands to one easy to understand and maintain place.',
+});
+
+export default function Page() {
+	return <Content content={markdown} />;
+}

src/app/docs/how-does-it-work/page.tsx

@@ -0,0 +1,14 @@
+import { Metadata } from 'next';
+import Content from '@/components/Content';
+
+import markdown from '@/../docs/how-does-it-work.md';
+
+export const generateMetadata = (): Metadata => ({
+	title: 'How does it work? • taskfile.sh',
+	description:
+		'Quickly kick start your project by moving all your development commands to one easy to understand and maintain place.',
+});
+
+export default function Page() {
+	return <Content content={markdown} />;
+}

src/app/about/page.tsx → src/app/docs/page.tsx

@@ -4,7 +4,7 @@ import Content from '@/components/Content';
 import readme from '@/../README.md';
 
 export const generateMetadata = (): Metadata => ({
-	title: 'Information • taskfile.sh',
+	title: 'Documentation • taskfile.sh',
 	description:
 		'Quickly kick start your project by moving all your development commands to one easy to understand and maintain place.',
 });

src/app/docs/sub-taskfiles/page.tsx

@@ -0,0 +1,14 @@
+import { Metadata } from 'next';
+import Content from '@/components/Content';
+
+import markdown from '@/../docs/sub-taskfiles.md';
+
+export const generateMetadata = (): Metadata => ({
+	title: 'SubTaskfiles • taskfile.sh',
+	description:
+		'Quickly kick start your project by moving all your development commands to one easy to understand and maintain place.',
+});
+
+export default function Page() {
+	return <Content content={markdown} />;
+}

src/app/globals.scss

@@ -8,12 +8,12 @@
 }
 
 body {
-	background: #ff00cc; /* fallback for old browsers */
-	background: -webkit-linear-gradient(to left, #ff00cc, #333399); /* Chrome 10-25, Safari 5.1-6 */
+	background: $color-yellow-50; /* fallback for old browsers */
 	background: linear-gradient(
-		to left,
-		#ff00cc,
-		#333399
+		220deg,
+		$color-yellow-50,
+		$color-purple-50,
+		$color-black
 	); /* W3C, IE 10+/ Edge, Firefox 16+, Chrome 26+, Opera 12+, Safari 7+ */
 	font-family: var(--font-text), sans-serif;
 }
@@ -25,7 +25,7 @@ pre {
 }
 
 a {
-	color: $color-blue-50;
+	color: $color-purple-50;
 	text-decoration: none;
 }