mirror of
https://github.com/GothenburgBitFactory/taskwarrior.git
synced 2025-07-07 20:06:36 +02:00
Tutorial
- 01_intro written. The first of many mini tutorials. - README added.
This commit is contained in:
parent
03cb5af7be
commit
dea3fd1551
5 changed files with 112 additions and 553 deletions
80
doc/misc/tutorial/01_intro/script.txt
Normal file
80
doc/misc/tutorial/01_intro/script.txt
Normal file
|
@ -0,0 +1,80 @@
|
|||
[Make window 116x32 for movie recording, light text, dark background]
|
||||
|
||||
On the left are the typed commands. On the right is the audio track. Where the
|
||||
left and right are aligned, the audio should match the commands.
|
||||
|
||||
|
||||
---------------------------------------- Intro -----------------------------------------------------
|
||||
|
||||
# Hi. Hello, and welcome to Taskwarrior. This is the first of
|
||||
many tutorials, and covers first-time use. Let's start
|
||||
by talking about some important resources.
|
||||
|
||||
# http//taskwarrior.org If you find you have any questions, you can get answers in
|
||||
several ways. The website has user forums, issue tracking
|
||||
and online documentation, including this tutorial.
|
||||
|
||||
# IRC #taskwarrior You can join the Taskwarrior IRC channel to pose questions,
|
||||
or join in the discussion.
|
||||
|
||||
# support@taskwarrior.org Or you can submit your request by email. The various
|
||||
support options are all volunteer-run.
|
||||
|
||||
man task Finally, you have several man pages installed that contain
|
||||
all the written documentation, including this tutorial.
|
||||
|
||||
---
|
||||
|
||||
As a first-time user, you are going to need a configuration
|
||||
file and a data directory. Taskwarrior will create both of
|
||||
these for you, in your home directory. The first time you
|
||||
run taskwarrior, you will be asked if you wish to do this.
|
||||
|
||||
task version Answer 'yes' to the question. After creating the missing
|
||||
file and directory, you'll see the current version
|
||||
displayed.
|
||||
|
||||
cat ~/.taskrc The configuration file contains very little. This is
|
||||
because Taskwarrior has a built-in set of sensible defaults
|
||||
and the configuration file just contains overrides to those
|
||||
defaults.
|
||||
|
||||
ls -l ~/.task The task data directory is empty. That's because we have
|
||||
added no tasks.
|
||||
|
||||
---
|
||||
|
||||
Let's get started with tasks. Here is the 30-second
|
||||
tutorial on basic takwarrior usage.
|
||||
|
||||
task add Read task documents later We Add two tasks.
|
||||
task add priority:H Pay bills
|
||||
|
||||
Easy. Do you see that second one has a High priority?
|
||||
|
||||
task ls Now let's look at those tasks. They are ordered by
|
||||
priority. Let's mark number 2 as done:
|
||||
|
||||
task 2 done
|
||||
task ls
|
||||
|
||||
Task 2 is now gone. Now we can delete that remaining task,
|
||||
because, well, why bother now we are already using task:
|
||||
|
||||
task 1 delete
|
||||
task ls
|
||||
|
||||
And that's all you *need* to know. These four commands
|
||||
will allow you to use taskwarrior effectively. If you are
|
||||
new to taskwarrior, it is recommended that you stop here,
|
||||
and go manage your task lists. We don't want you to be
|
||||
overwhelmed, when what you really need is a way to
|
||||
organize and get things done.
|
||||
|
||||
When you are comfortable with basic taskwarrior usage,
|
||||
there are many other features you can learn about. While
|
||||
you are not expected to learn all of them, or even find
|
||||
them useful, you might just find exactly what you need.
|
||||
|
||||
---------------------------------------- End -------------------------------------------------------
|
||||
|
Loading…
Add table
Add a link
Reference in a new issue