nhiệm vụ - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

task - Một trình quản lý todo dòng lệnh.

SYNOPSIS

công việc [ | ]
công việc --phiên bản

MÔ TẢ

Taskwarrior là một trình quản lý danh sách todo dòng lệnh. Nó duy trì một danh sách các nhiệm vụ mà bạn
muốn làm, cho phép bạn thêm / bớt, và nếu không thì thao tác với chúng. Taskwarrior có một
tập hợp các lệnh con phong phú cho phép bạn thực hiện nhiều việc khác nhau với nó.

Về cốt lõi, Taskwarrior là một chương trình xử lý danh sách. Bạn thêm văn bản và bổ sung liên quan
các tham số và hiển thị lại thông tin một cách tốt đẹp. Nó biến thành một chương trình danh sách việc cần làm
khi bạn thêm ngày đến hạn và lặp lại. Nó biến thành một chương trình danh sách việc cần làm có tổ chức khi
bạn thêm các ưu tiên, thẻ (bộ mô tả một từ), nhóm dự án, v.v.

LỌC

Các bao gồm không hoặc nhiều tiêu chí tìm kiếm chọn nhiệm vụ. Ví dụ, để
liệt kê tất cả các nhiệm vụ đang chờ xử lý thuộc dự án 'Home':

dự án nhiệm vụ: Danh sách trang chủ

Bạn có thể chỉ định nhiều thuật ngữ bộ lọc, mỗi thuật ngữ trong số đó hạn chế thêm kết quả:

dự án nhiệm vụ: Danh sách nhà + vườn cuối tuần

Ví dụ này áp dụng ba bộ lọc: dự án 'Nhà riêng', thẻ 'cuối tuần' và
mô tả hoặc chú thích phải chứa chuỗi ký tự 'khu vườn'. Trong ví dụ này,
'garden' được dịch nội bộ thành:

description.contains: vườn

như một lối tắt thuận tiện. 'Hàm' ở đây là một công cụ sửa đổi thuộc tính, được sử dụng để
kiểm soát nhiều hơn bộ lọc chứ không chỉ đơn giản là vắng mặt hoặc hiện diện. Xem phần
'ATTRIBUTE MODIFIERS' bên dưới để có danh sách đầy đủ các công cụ sửa đổi.

Lưu ý rằng một bộ lọc có thể không có số hạng, có nghĩa là tất cả các tác vụ đều áp dụng cho lệnh.
Điều này có thể nguy hiểm và trường hợp đặc biệt này đã được xác nhận, và không thể ghi đè. Vì
ví dụ, lệnh này:

công việc sửa đổi + công việc
Lệnh này không có bộ lọc và sẽ sửa đổi tất cả các tác vụ. Bạn có chắc không? (có không)

sẽ thêm thẻ 'công việc' vào tất cả các nhiệm vụ, nhưng chỉ sau khi xác nhận.

Các ví dụ bộ lọc khác:

nhiệm vụ
nhiệm vụ 28
nhiệm vụ + cuối tuần
dự án nhiệm vụ: Home do.before: hôm nay
task ebeeab00-ccf8-464b-8b58-f7f2d606edfb <command> <mods>

Theo mặc định, các phần tử bộ lọc được kết hợp với toán tử ngầm định 'và', nhưng 'hoặc' và
'xor' cũng có thể được sử dụng, với điều kiện bao gồm dấu ngoặc đơn:

task '(/ [Cc] at | [Dd] og / or / [0-9] + /)'

Dấu ngoặc đơn tách biệt thuật ngữ logic khỏi bất kỳ bộ lọc lệnh mặc định nào hoặc ẩn
bộ lọc báo cáo sẽ được kết hợp với 'và' ngầm định.

Bộ lọc có thể nhắm mục tiêu các tác vụ cụ thể bằng cách sử dụng số ID hoặc UUID. Để chỉ định nhiều nhiệm vụ
sử dụng một trong các biểu mẫu này (danh sách số ID, số UUID hoặc phạm vi ID được phân tách bằng dấu cách):

nhiệm vụ 1 2 3 xóa
thông tin nhiệm vụ 1-3
nhiệm vụ 1 2-5 19 sửa đổi pri: H
task 4-7 ebeeab00-ccf8-464b-8b58-f7f2d606edfb info

SỬA ĐỔI

Các không có hoặc nhiều thay đổi để áp dụng cho các nhiệm vụ đã chọn, chẳng hạn như:

nhiệm vụ dự án: Trang chủ
nhiệm vụ + cuối tuần + đến hạn vườn: ngày mai
nhiệm vụ Văn bản mô tả / chú thích
nhiệm vụ / from / to / <- thay thế kết quả phù hợp đầu tiên
nhiệm vụ / from / to / g <- thay thế tất cả các kết quả phù hợp

ĐĂNG KÝ

Taskwarrior hỗ trợ các loại lệnh khác nhau. Có các lệnh đọc, ghi
lệnh, lệnh linh tinh và lệnh trợ giúp tập lệnh. Đọc lệnh không cho phép
sửa đổi các nhiệm vụ. Viết lệnh có thể thay đổi hầu hết mọi khía cạnh của một nhiệm vụ. Kịch bản
các lệnh trợ giúp được cung cấp để giúp bạn viết các tập lệnh bổ trợ, ví dụ: shell
hoàn thành (chỉ đầu ra tối thiểu được tạo, như với verbose = nothing).

ĐỌC ĐĂNG KÝ

Báo cáo là lệnh con đã đọc. Có một số báo cáo hiện được xác định trước trong
Chiến binh. Đầu ra và hành vi sắp xếp của các báo cáo này có thể được định cấu hình trong
tập tin cấu hình. Xem thêm trang man nhiệm vụ(5). Ngoài ra còn có các bài đọc khác
lệnh con không phải là báo cáo.

công việc --phiên bản
Đây là đối số dòng lệnh thông thường duy nhất mà Taskwarrior hỗ trợ, và
dành cho các tập lệnh bổ trợ để xác minh số phiên bản của một
Taskwarrior mà không cần gọi các cơ chế tạo các tệp mặc định.

công việc
Không có lệnh nào được chỉ định, lệnh mặc định sẽ được chạy và bộ lọc được áp dụng.

công việc hoạt động
Hiển thị tất cả các tác vụ phù hợp với bộ lọc được bắt đầu nhưng chưa hoàn thành.

công việc tất cả các
Hiển thị tất cả các nhiệm vụ phù hợp với bộ lọc, bao gồm cả cha mẹ của các nhiệm vụ lặp lại.

công việc bị chặn
Hiển thị tất cả các tác vụ phù hợp với bộ lọc, hiện đang bị chặn bởi các tác vụ khác.

công việc ngăn chặn
Hiển thị tất cả các tác vụ phù hợp với bộ lọc chặn các tác vụ khác.

công việc burndown.daily
Hiển thị biểu đồ hiệu ứng đồ họa theo ngày.

công việc burndown.weekly
Hiển thị biểu đồ hiệu ứng đồ họa theo tuần. Lưu ý rằng 'burndown' là bí danh của
báo cáo 'burndown.weekly'.

công việc cháy hàng.hàng tháng
Hiển thị biểu đồ hiệu ứng đồ họa theo tháng.

công việc lịch [do | | ] [và]
Hiển thị lịch hàng tháng với các nhiệm vụ đến hạn được đánh dấu. Hiển thị một đường ngang của
tháng. Nếu đối số 'y' được cung cấp, sẽ hiển thị ít nhất một năm hoàn chỉnh. Nếu như
một năm được cung cấp, chẳng hạn như '2015', thì năm đó sẽ được hiển thị. Nếu cả một tháng
và một năm được chỉ định ('6 2015') sau đó các tháng được hiển thị bắt đầu tại
tháng và năm xác định. Nếu đối số 'do' được cung cấp, sẽ hiển thị
tháng bắt đầu của nhiệm vụ sớm nhất đến hạn.

công việc màu sắc [mẫu vật | truyền thuyết]
Hiển thị tất cả các màu có thể có, một mẫu đã đặt tên hoặc chú giải chứa tất cả các màu hiện tại
màu sắc xác định.

công việc cột [chuỗi con]
Hiển thị tất cả các cột và kiểu định dạng được hỗ trợ. Hữu ích khi tạo tùy chỉnh
báo cáo. Nếu một chuỗi con được cung cấp, chỉ những tên cột phù hợp mới được hiển thị.

công việc lệnh
Hiển thị tất cả các lệnh được hỗ trợ, với một số chi tiết của mỗi lệnh.

công việc hoàn thành
Hiển thị tất cả các tác vụ phù hợp với bộ lọc đã hoàn thành.

công việc tính
Chỉ hiển thị một số tác vụ phù hợp với bộ lọc.

công việc xuất khẩu
Xuất tất cả các tác vụ ở định dạng JSON. Chuyển hướng đầu ra đến một tệp, nếu bạn muốn
để lưu nó hoặc chuyển nó sang một lệnh hoặc tập lệnh khác để chuyển đổi nó sang một
định dạng. Bản phát hành nhiệm vụ tiêu chuẩn đi kèm với một số tập lệnh mẫu, chẳng hạn như:

xuất-csv.pl
xuất-sql.py
xuất-xml.py
xuất-yaml.pl
xuất-html.pl
xuất-tsv.pl
xuất-xml.rb
xuất-ical.pl
xuất-xml.pl
xuất-yad.pl

công việc ghistory.annual
Hiển thị báo cáo đồ họa về trạng thái nhiệm vụ theo năm.

công việc ghistory.monthly
Hiển thị báo cáo đồ họa về trạng thái nhiệm vụ theo tháng. Lưu ý rằng 'ghistory' là một bí danh
thành 'ghistory.monthly'.

công việc giúp đỡ
Hiển thị văn bản sử dụng dài.

công việc lịch sử.annual
Hiển thị báo cáo lịch sử nhiệm vụ theo năm.

công việc lịch sử.hàng tháng
Hiển thị báo cáo lịch sử nhiệm vụ theo tháng. Lưu ý rằng 'lịch sử' là bí danh của
'history.monthly'.

công việc id
Áp dụng bộ lọc sau đó chỉ trích xuất các ID nhiệm vụ và trình bày chúng dưới dạng khoảng trắng-
danh sách tách biệt. Điều này hữu ích như là đầu vào cho một lệnh tác vụ, để đạt được điều này:

task $ (task project: Home id) sửa đổi mức độ ưu tiên: H

Ví dụ này trước tiên lấy ID cho dự án: Bộ lọc trang chủ, sau đó đặt mức độ ưu tiên
thành H cho mỗi nhiệm vụ đó. Điều này cũng có thể đạt được trực tiếp:

dự án nhiệm vụ: Ưu tiên sửa đổi trang chủ: H

Lệnh này chủ yếu được sử dụng cho các tập lệnh bên ngoài.

công việc uuid
Áp dụng bộ lọc trên tất cả các tác vụ (ngay cả các tác vụ đã xóa và đã hoàn thành) sau đó trích xuất
chỉ các UUID của nhiệm vụ và trình bày chúng dưới dạng danh sách được phân tách bằng dấu phẩy. Điều này hữu ích như
đầu vào cho một lệnh tác vụ, để đạt được điều này:

nhiệm vụ $ (dự án nhiệm vụ: Trạng thái nhà: đã hoàn thành uuids) sửa đổi trạng thái: đang chờ xử lý

Ví dụ này đầu tiên lấy UUID cho dự án: Trang chủ và trạng thái: đã hoàn thành
bộ lọc, sau đó thực hiện lại từng tác vụ đó đang chờ xử lý.

Lệnh này chủ yếu được sử dụng cho các tập lệnh bên ngoài.

công việc uda
Hiển thị danh sách các UDA đã được xác định, bao gồm tên, loại, nhãn và
giá trị cho phép. Đồng thời hiển thị mức sử dụng UDA và mọi UDA mồ côi.

công việc thông tin
Hiển thị tất cả dữ liệu và siêu dữ liệu cho các tác vụ được chỉ định. Đây là phương tiện duy nhất của
hiển thị tất cả các khía cạnh của một nhiệm vụ nhất định, bao gồm cả lịch sử thay đổi.

công việc
Cung cấp danh sách tiêu chuẩn của các nhiệm vụ phù hợp với bộ lọc.

công việc Dài
Cung cấp danh sách chi tiết nhất của các nhiệm vụ phù hợp với bộ lọc.

công việc ls
Cung cấp danh sách ngắn các nhiệm vụ phù hợp với bộ lọc.

công việc tối thiểu
Cung cấp danh sách tối thiểu các nhiệm vụ phù hợp với bộ lọc.

công việc mới nhất
Hiển thị các nhiệm vụ mới nhất phù hợp với bộ lọc.

công việc tiếp theo
Hiển thị một trang gồm các nhiệm vụ khẩn cấp nhất, được sắp xếp theo mức độ khẩn cấp, đây là một
giá trị.

công việc sẵn sàng
Hiển thị một trang gồm các nhiệm vụ đã sẵn sàng khẩn cấp nhất, được sắp xếp theo mức độ khẩn cấp. Một nhiệm vụ đã sẵn sàng là
một ngày không được lên lịch hoặc có một ngày đã lên lịch đã qua và không có
ngày chờ đợi.

công việc lâu đời nhất
Hiển thị các tác vụ cũ nhất phù hợp với bộ lọc.

công việc quá hạn
Hiển thị tất cả các tác vụ chưa hoàn thành khớp với bộ lọc đã quá hạn của chúng.

công việc dự án
Liệt kê tất cả các tên dự án hiện đang được sử dụng bởi các nhiệm vụ đang chờ xử lý và số lượng
nhiệm vụ cho mỗi.

công việc định kỳ
Hiển thị tất cả các nhiệm vụ lặp lại phù hợp với bộ lọc.

công việc bỏ chặn
Hiển thị tất cả các tác vụ hiện không bị chặn bởi các tác vụ khác, khớp với bộ lọc.

công việc chờ đợi
Hiển thị tất cả các nhiệm vụ đang chờ phù hợp với bộ lọc.

VIẾT ĐĂNG KÝ

công việc thêm vào
Thêm một nhiệm vụ mới đang chờ xử lý vào danh sách nhiệm vụ.

công việc chú thích
Thêm chú thích vào một nhiệm vụ hiện có.

công việc thêm
Thêm văn bản mô tả vào một nhiệm vụ hiện có.

công việc xóa
Xóa nhiệm vụ đã chỉ định khỏi danh sách tác vụ.

công việc biểu thị
Xóa chú thích cho nhiệm vụ được chỉ định. Nếu mô tả được cung cấp khớp với
một chú thích chính xác, chú thích tương ứng sẽ bị xóa. Nếu được cung cấp
mô tả khớp một phần với chú thích, chú thích khớp một phần đầu tiên là
đã xóa.

công việc thực hiện
Đánh dấu nhiệm vụ được chỉ định là đã hoàn thành.

công việc bản sao
Nhân bản nhiệm vụ được chỉ định và cho phép sửa đổi.

công việc chỉnh sửa
Khởi chạy trình soạn thảo văn bản để cho phép bạn sửa đổi trực tiếp tất cả các khía cạnh của nhiệm vụ. Trong
nói chung, đây không phải là phương pháp được khuyến nghị để sửa đổi nhiệm vụ, nhưng được cung cấp cho
trường hợp đặc biệt. Sử dụng cẩn thận.

công việc nhập khẩu [ ...]
Nhập tác vụ ở định dạng JSON. Có thể được sử dụng để thêm nhiệm vụ mới hoặc cập nhật hiện có
những cái. Các tác vụ được xác định bởi UUID của chúng.

Nếu không có tệp hoặc "-" nào được chỉ định, hãy nhập tác vụ từ STDIN.

Bạn nên đặt rc.recection.confirmation ở mức thích hợp nếu nhập
được sử dụng trong quy trình làm việc tự động. Nhìn thấy nhiệm vụ(5).

Để nhập các định dạng tệp khác, bản phát hành tác vụ tiêu chuẩn đi kèm với một số
tập lệnh ví dụ, chẳng hạn như:

nhập-todo.sh.pl
nhập-yaml.pl

công việc đăng nhập
Thêm một nhiệm vụ mới đã được hoàn thành vào danh sách nhiệm vụ.

công việc sửa đổi
Sửa đổi nhiệm vụ hiện có với thông tin được cung cấp.

công việc bỏ trước
Thêm văn bản mô tả vào một nhiệm vụ hiện có.

công việc Bắt đầu
Đánh dấu các tác vụ được chỉ định là đã bắt đầu.

công việc dừng lại
Loại bỏ Bắt đầu thời gian từ nhiệm vụ được chỉ định.

KHÁC ĐĂNG KÝ

Các lệnh con khác hoặc không chấp nhận đối số dòng lệnh hoặc chấp nhận không chuẩn
lập luận.

công việc Truy tìm
Đánh giá một biểu thức đại số. Có thể được sử dụng để kiểm tra cách Taskwarrior phân tích cú pháp và
đánh giá biểu thức được đưa ra trên dòng lệnh.

Ví dụ:

nhiệm vụ calc 1 + 1
2

nhiệm vụ calc bây giờ + 8 ngày
2015-03-26T18:06:57

nhiệm vụ tính eom
2015-03-31T23:59:59

công việc cấu hình [Tên [giá trị | '']]
Thêm, sửa đổi và xóa cài đặt trực tiếp trong cấu hình Taskwarrior. Cái này
lệnh sửa đổi cài đặt 'tên' bằng giá trị mới là 'giá trị' hoặc thêm
mục nhập mới tương đương với 'name = value':

giá trị tên cấu hình nhiệm vụ

Lệnh này đặt một giá trị trống. Điều này có tác dụng loại bỏ mọi mặc định
giá trị:

tên cấu hình nhiệm vụ ''

Cuối cùng, lệnh này xóa mọi mục nhập 'name = ...' khỏi tệp .taskrc:

tên cấu hình nhiệm vụ

công việc bối cảnh
Đặt bối cảnh hiện đang hoạt động. Xem phần TIẾP THEO.

Ví dụ:

nhiệm vụ bối cảnh công việc

công việc bối cảnh xóa
Xóa ngữ cảnh với tên . Nếu ngữ cảnh đang bị xóa hiện tại
đặt là hoạt động, nó sẽ không được đặt.

Ví dụ:

bối cảnh nhiệm vụ xóa công việc

công việc bối cảnh định nghĩa
Xác định bối cảnh mới với tên và định nghĩa . Lệnh này không
không ảnh hưởng đến ngữ cảnh được đặt hiện tại, chỉ thêm một định nghĩa ngữ cảnh mới.

Ví dụ:

bối cảnh nhiệm vụ xác định dự án công việc: Công việc
bối cảnh nhiệm vụ xác định dự án nhà: Nhà hoặc + nhà
bối cảnh nhiệm vụ xác định siêu kỳ hạn đến hạn: hôm nay và + khẩn cấp

công việc bối cảnh
Xuất ra danh sách các ngữ cảnh có sẵn cùng với định nghĩa của chúng.

công việc bối cảnh không ai
Xóa ngữ cảnh hiện đang hoạt động, nếu có.

công việc bối cảnh hiển thị
Hiển thị ngữ cảnh hiện đang hoạt động, cùng với định nghĩa của nó.

công việc chẩn đoán
Hiển thị thông tin chẩn đoán thuộc loại cần thiết khi báo cáo sự cố. Khi nào
bạn báo cáo lỗi, có thể là nền tảng, phiên bản và môi trường
quan trọng. Chạy lệnh này sẽ tạo ra một bản tóm tắt thông tin tương tự
sẽ kèm theo một báo cáo lỗi.

Nó bao gồm trình biên dịch, thư viện và thông tin phần mềm. Nó không bao gồm bất kỳ
thông tin cá nhân, ngoài vị trí và kích thước của các tệp dữ liệu tác vụ của bạn.

Lệnh này cũng thực hiện quét chẩn đoán các tệp dữ liệu của bạn đang tìm kiếm
các vấn đề, chẳng hạn như UUID trùng lặp.

công việc thi hành <external lệnh>
Thực hiện lệnh được chỉ định. Bản thân nó không hữu ích, nhưng khi được sử dụng kết hợp
với bí danh và tiện ích mở rộng có thể cung cấp tích hợp liền mạch.

công việc Logo
Hiển thị logo Chiến binh.

công việc báo cáo
Liệt kê tất cả các báo cáo được hỗ trợ. Điều này bao gồm các báo cáo được tích hợp sẵn và bất kỳ tùy chỉnh nào
báo cáo bạn đã xác định.

công việc hiển thị [tất cả các | chuỗi con]
Hiển thị tất cả các cài đặt hiện tại. Nếu một chuỗi con được chỉ định thì chỉ cần cài đặt
chứa chuỗi con đó sẽ được hiển thị.

công việc số liệu thống kê
Hiển thị thống kê của các nhiệm vụ được xác định bởi bộ lọc.

công việc tóm tắt
Hiển thị báo cáo về trạng thái nhiệm vụ tổng hợp theo dự án.

công việc thẻ
Hiển thị danh sách tất cả các thẻ được sử dụng. Bất kỳ thẻ đặc biệt nào được sử dụng đều được đánh dấu. Lưu ý rằng
các thẻ ảo không được liệt kê - chúng không thực sự tồn tại và chỉ là một
ký hiệu cho siêu dữ liệu tác vụ khác. Đó là một lỗi khi cố gắng thêm hoặc xóa một
thẻ ảo.

công việc thời gian biểu [tuần]
Hiển thị báo cáo hàng tuần về các nhiệm vụ đã hoàn thành và bắt đầu.

công việc lùi lại
Hoàn nguyên hành động gần đây nhất. Tuân theo cài đặt xác nhận.

công việc phiên bản
Hiển thị số phiên bản Taskwarrior.

NGƯỜI GIÚP ĐỠ ĐĂNG KÝ

công việc _bí danh
Tạo danh sách tất cả các bí danh, cho mục đích tự động hoàn thành.

công việc _cột
Chỉ hiển thị danh sách các cột được hỗ trợ.

công việc _ câu lệnh
Tạo danh sách tất cả các lệnh, cho mục đích tự động hoàn thành.

công việc _config
Liệt kê tất cả các biến cấu hình được hỗ trợ, cho mục đích hoàn thành.

công việc _định nghĩa bài văn
Liệt kê tất cả các biến ngữ cảnh có sẵn, cho mục đích hoàn thành.

công việc _id
Chỉ hiển thị ID của các nhiệm vụ phù hợp, ở dạng danh sách. Không được ủng hộ
của _unique.

công việc _chỉ
Hiển thị các giá trị mặc định và ghi đè kết hợp của cài đặt cấu hình, để sử dụng bởi
ứng dụng bên thứ ba.

công việc _duy nhất
Báo cáo một tập hợp các giá trị thuộc tính duy nhất. Ví dụ: để xem tất cả các hoạt động
dự án:

task + PENDING _unique các dự án

công việc _uuids
Chỉ hiển thị UUID của các nhiệm vụ phù hợp trong số tất cả các nhiệm vụ (thậm chí đã xóa và đã hoàn thành
nhiệm vụ), dưới dạng một danh sách. Không được dùng để ủng hộ _unique.

công việc _udas
Chỉ hiển thị các tên UDA đã xác định, ở dạng danh sách.

công việc _dự án
Chỉ hiển thị danh sách tất cả các tên dự án được sử dụng. Không được dùng để ủng hộ _unique.

công việc _tags
Chỉ hiển thị danh sách tất cả các thẻ được sử dụng cho mục đích tự động hoàn thành. Không được chấp nhận trong
sự ưu ái của _unique.

công việc _khẩn cấp
Hiển thị thước đo mức độ khẩn cấp của một nhiệm vụ.

công việc _phiên bản
Chỉ hiển thị số phiên bản Taskwarrior.

công việc _zshcommand
Tạo danh sách tất cả các lệnh, cho mục đích tự động hoàn thành zsh.

công việc _zshids
Hiển thị các ID và mô tả về các nhiệm vụ phù hợp.

công việc _zshuuids
Hiển thị UUID và mô tả về các tác vụ phù hợp.

công việc _được [ ...]
Truy cập và hiển thị (các) tham chiếu DOM. Được sử dụng để trích xuất các giá trị riêng lẻ từ
nhiệm vụ hoặc hệ thống. Các tham chiếu DOM được hỗ trợ là:

rc.
ngữ cảnh.chương trình
ngữ cảnh.args
context. width
ngữ cảnh.height
hệ thống.version
hệ thống.os
.
.

Lưu ý rằng 'rc. 'tham chiếu có thể cần được thoát bằng cách sử dụng' - 'để ngăn chặn
tham chiếu khỏi được hiểu là ghi đè.

Lưu ý rằng nếu tham chiếu DOM không hợp lệ hoặc tham chiếu đánh giá thành
giá trị bị thiếu, lệnh thoát bằng 1.

Ngoài ra, một số thành phần của thuộc tính của các loại cụ thể có thể
được trích xuất bởi các tham chiếu DOM.

$ nhiệm vụ _get 2.due.year
2015

Để có danh sách đầy đủ các tham chiếu DOM dành riêng cho thuộc tính được hỗ trợ, hãy tham khảo
tài liệu tại:http://taskwarrior.org/docs/dom.html>

THUỘC TÍNH VÀ METADATA

ID Các nhiệm vụ có thể được chỉ định duy nhất bởi các ID, chỉ đơn giản là chỉ mục của các nhiệm vụ
trong tệp dữ liệu. Do đó, ID của một nhiệm vụ có thể thay đổi, nhưng chỉ khi một lệnh
được chạy hiển thị các ID. Khi sửa đổi nhiệm vụ, có thể an toàn khi dựa vào
ID hiển thị. Luôn chạy báo cáo để kiểm tra xem bạn có đúng ID cho một nhiệm vụ hay không. ID
có thể được giao cho nhiệm vụ dưới dạng một chuỗi, ví dụ,
công việc 1,4-10,19 xóa

+ thẻ | -tag
Thẻ là những từ tùy ý được liên kết với một nhiệm vụ. Sử dụng + để thêm thẻ và - để xóa
một thẻ từ một nhiệm vụ. Một nhiệm vụ có thể có bất kỳ số lượng thẻ nào.

Một số thẻ nhất định (được gọi là 'thẻ đặc biệt'), có thể được sử dụng để ảnh hưởng đến cách các tác vụ
đã điều trị. Ví dụ: nếu một nhiệm vụ có thẻ đặc biệt 'nocolor', thì nó được miễn
từ tất cả các quy tắc màu sắc. Các thẻ đặc biệt được hỗ trợ là:

+ nocolor Tắt xử lý quy tắc màu cho tác vụ này
+ nonag Việc hoàn thành nhiệm vụ này sẽ chặn tất cả các thông báo khó hiểu
+ nocal Nhiệm vụ này sẽ không xuất hiện trên lịch
+ tiếp theo Nâng cao nhiệm vụ để nó xuất hiện trên báo cáo 'tiếp theo'

Ngoài ra còn có các thẻ ảo, đại diện cho siêu dữ liệu nhiệm vụ ở dạng thẻ. Những thẻ này
không tồn tại, nhưng có thể được sử dụng để lọc các tác vụ. Các thẻ ảo được hỗ trợ là:

ACTIVE Khớp nếu nhiệm vụ được bắt đầu
LƯU Ý Đối sánh nếu nhiệm vụ có chú thích
BỊ CHẶN Đối sánh nếu nhiệm vụ bị chặn
CHẶN đối sánh nếu tác vụ đang chặn
CHILD Đối sánh nếu nhiệm vụ có cha mẹ
HOÀN THÀNH Phù hợp với nếu nhiệm vụ đã hoàn thành trạng thái
ĐÃ XÓA Đối sánh nếu nhiệm vụ có trạng thái đã xóa
DUE Đối sánh nếu nhiệm vụ đến hạn
DUETODAY Đối sánh nếu nhiệm vụ đến hạn hôm nay
MỚI NHẤT Đối sánh nếu nhiệm vụ là nhiệm vụ mới nhất được thêm vào
MONTH Đối sánh nếu nhiệm vụ đến hạn trong tháng này
ORPHAN Khớp nếu tác vụ có bất kỳ giá trị UDA nào khác
OVERDUE Đối sánh nếu nhiệm vụ quá hạn
PHỤ HUYNH Đối sánh nếu nhiệm vụ là phụ huynh
PENDING Phù hợp nếu nhiệm vụ có trạng thái đang chờ xử lý
ƯU TIÊN Đối sánh nếu nhiệm vụ có mức độ ưu tiên
DỰ ÁN Đối sánh nếu nhiệm vụ có một dự án
SN SÀNG Phù hợp nếu nhiệm vụ có thể thực hiện được
LỊCH TRÌNH Đối sánh nếu nhiệm vụ được lên lịch
TAGGED Phù hợp nếu nhiệm vụ có thẻ
TODAY Đối sánh nếu nhiệm vụ đến hạn hôm nay
TOMORROW Đối sánh nếu nhiệm vụ đến hạn vào ngày mai
UDA Khớp nếu tác vụ có bất kỳ giá trị UDA nào
UNBLOCKED Phù hợp nếu nhiệm vụ không bị chặn
UNTIL Khớp nếu nhiệm vụ hết hạn
CHỜ ĐỢI Đối sánh nếu nhiệm vụ đang chờ
TUẦN Đối sánh nếu nhiệm vụ đến hạn trong tuần này
NĂM Đối sánh nếu nhiệm vụ đến hạn trong năm nay
YESTERDAY Đối sánh nếu nhiệm vụ đến hạn vào ngày hôm qua

Bạn có thể sử dụng + BLOCKED để lọc các tác vụ bị chặn hoặc -BLOCKED cho các tác vụ bỏ chặn.
Tương tự, -BLOCKED tương đương với + UNBLOCKED. Đó là một lỗi khi cố gắng thêm
hoặc xóa thẻ ảo.

dự án:
Chỉ định dự án có liên quan đến nhiệm vụ.

ưu tiên: H | M | L or sự ưu tiên:
Chỉ định Cao, Trung bình, Thấp và không có mức độ ưu tiên cho một nhiệm vụ.

quá hạn:
Chỉ định ngày đến hạn của một nhiệm vụ.

lặp lại:
Chỉ định tần suất lặp lại một nhiệm vụ.

lên kế hoạch:
Chỉ định ngày mà sau đó một nhiệm vụ có thể được hoàn thành.

cho đến khi: ngày of nhiệm vụ>
Chỉ định ngày hết hạn của một nhiệm vụ, sau đó nó sẽ bị xóa.

giới hạn:
Chỉ định số lượng nhiệm vụ mong muốn mà một báo cáo sẽ hiển thị, nếu là một số nguyên dương
được đưa ra. Giá trị 'trang' cũng có thể được sử dụng và sẽ giới hạn đầu ra báo cáo ở
bao nhiêu dòng văn bản sẽ phù hợp trên màn hình. Điều này mặc định là 25 dòng.

đợi đã:
Khi một nhiệm vụ được đưa ra một ngày chờ, nó sẽ bị ẩn khỏi hầu hết các báo cáo bằng cách thay đổi
trạng thái "đang chờ". Khi ngày đó trôi qua, trạng thái được thay đổi trở lại
'đang chờ xử lý', và nhiệm vụ sẽ hiển thị.

phụ thuộc: ...>
Tuyên bố tác vụ này phụ thuộc vào id1 và id2. Điều này có nghĩa là các nhiệm vụ id1
và id2 nên được hoàn thành trước nhiệm vụ này. Do đó, tác vụ này sau đó sẽ
hiển thị trên báo cáo 'bị chặn'. Nó chấp nhận danh sách số ID được phân tách bằng dấu phẩy,
Số UUID và dải ID. Khi đặt tiền tố bất kỳ phần tử nào của danh sách này bằng '-', dấu
các tác vụ được chỉ định bị xóa khỏi danh sách phụ thuộc.

lối vào:
Đối với mục đích báo cáo, chỉ định ngày mà một nhiệm vụ được tạo.

THUỘC TÍNH NGƯỜI SỬA ĐỔI

Công cụ sửa đổi thuộc tính cải thiện bộ lọc. Các công cụ sửa đổi được hỗ trợ là:

trước (từ đồng nghĩa Dưới, dưới đây)
sau khi (từ đồng nghĩa kết thúc, ở trên)
không ai
bất kì
is (từ đồng nghĩa bằng)
không (từ đồng nghĩa không phải)
có (từ đồng nghĩa chứa đựng)
không
bắt đầu với (từ đồng nghĩa bên trái)
tận cùng (từ đồng nghĩa đúng)
lời
bây giờ

Ví dụ:

task do.before: eom priority.not: L list

Sản phẩm trước modifier được sử dụng để so sánh các giá trị, bảo toàn ngữ nghĩa, vì vậy project.before: B
liệt kê tất cả các dự án bắt đầu bằng 'A'. Mức độ ưu tiên 'L' trước 'M' và đến hạn: 2011-01-01 là
trước hạn: 2011-01-02. Các từ đồng nghĩa 'bên dưới' và 'bên dưới' được bao gồm để cho phép bộ lọc
mà đọc tự nhiên hơn.

Sản phẩm sau khi bổ ngữ là nghịch đảo của trước bổ nghĩa.

Sản phẩm không ai công cụ sửa đổi yêu cầu thuộc tính không có giá trị. Ví dụ:

ưu tiên nhiệm vụ: danh sách
ưu tiên nhiệm vụ.none: danh sách

là tương đương và liệt kê các nhiệm vụ không có mức độ ưu tiên.

Sản phẩm bất kì công cụ sửa đổi yêu cầu thuộc tính phải có một giá trị, nhưng bất kỳ giá trị nào cũng đủ.

Sản phẩm is công cụ sửa đổi yêu cầu phải khớp chính xác với giá trị.

Sản phẩm không bổ ngữ là nghịch đảo của is bổ nghĩa.

Sản phẩm có công cụ sửa đổi được sử dụng để tìm kiếm một chuỗi con, chẳng hạn như:

task description.has: foo list
danh sách nhiệm vụ

Chúng tương đương và sẽ trả về bất kỳ tác vụ nào có 'foo' trong mô tả hoặc
Chú thích.

Sản phẩm không bổ ngữ là nghịch đảo của có bổ nghĩa.

Sản phẩm bắt đầu với công cụ sửa đổi khớp với bên trái hoặc phần đầu của một thuộc tính, chẳng hạn như:

task project.startswith: H danh sách
dự án nhiệm vụ: danh sách H

tương đương và sẽ khớp với bất kỳ dự án nào bắt đầu bằng 'H'. Không phù hợp với tất cả các dự án
bắt đầu bằng 'H' được thực hiện bằng:

task project.not: H danh sách

Sản phẩm tận cùng công cụ sửa đổi khớp với bên phải hoặc phần cuối của một thuộc tính.

Sản phẩm lời công cụ sửa đổi yêu cầu thuộc tính phải chứa toàn bộ từ được chỉ định, sao cho
điều này:

mô tả nhiệm vụ. từ khóa: danh sách thanh

Sẽ khớp với mô tả 'foo bar baz' nhưng không khớp với 'thức ăn cho chó'.

Sản phẩm bây giờ bổ ngữ là nghịch đảo của lời bổ nghĩa.

BIỂU THỨC VÀ ĐIỀU HÀNH

Bạn có thể sử dụng các toán tử sau trong các biểu thức bộ lọc:

và hoặc xor! Toán tử logic
<<= = ==! =! ==> => Toán tử quan hệ
( ) Quyền ưu tiên

Ví dụ:

task do.before: eom priority.not: L list
danh sách task '(do <eom or priority! = L)'
nhiệm vụ '! (dự án: Nhà hoặc dự án: Garden) 'danh sách

Sản phẩm = kiểm tra toán tử cho bình đẳng gần đúng. Các ngày so sánh bằng nhau nếu chúng ở trên
cùng ngày (giờ và phút bị bỏ qua). Các chuỗi so sánh bằng nhau nếu toán hạng bên trái bắt đầu
với toán hạng bên phải. Các == kiểm tra nhà điều hành cho sự bình đẳng chính xác. Các != và ! ==
toán tử là phủ định của = và == tương ứng. Toán tử phủ định là !.

Lưu ý rằng dấu ngoặc đơn là bắt buộc khi sử dụng toán tử logic khác với 'và'
nhà điều hành. Lý do là một số báo cáo chứa các bộ lọc phải được kết hợp với
dòng lệnh. Hãy xem xét ví dụ này:

dự án nhiệm vụ: Nhà hoặc dự án: Danh sách vườn

Trong khi điều này có vẻ chính xác, nó không phải là. Báo cáo 'danh sách' chứa bộ lọc:

chương trình tác vụ report.list.filter

Định cấu hình giá trị biến
---------------------------------
Trạng thái report.list.filter: đang chờ xử lý

Có nghĩa là ví dụ thực sự là:

trạng thái nhiệm vụ: dự án đang chờ xử lý: Nhà hoặc dự án: Danh sách vườn

Toán tử 'và' được ngụ ý làm cho nó:

trạng thái nhiệm vụ: đang chờ xử lý và dự án: Nhà hoặc dự án: Danh sách vườn

Đây là lỗi ưu tiên - cần phải nhóm 'và' và 'hoặc' bằng cách sử dụng dấu ngoặc đơn, như
điều này:

trạng thái nhiệm vụ: đang chờ xử lý và danh sách (dự án: Nhà hoặc dự án: Vườn)

Vì vậy, ví dụ ban đầu phải được nhập là:

task '(project: Home or project: Garden)' danh sách

Điều này bao gồm dấu ngoặc kép để thoát khỏi dấu ngoặc đơn, để trình bao không diễn giải chúng
và ẩn chúng khỏi Taskwarrior.

Có sự dư thừa giữa các toán tử, công cụ sửa đổi thuộc tính và các đường cú pháp khác. Vì
ví dụ, tất cả những điều sau đây đều tương đương:

danh sách nhiệm vụ
task / foo / list
task description.contains: foo list
task description.has: foo list
danh sách 'mô tả ~ foo' nhiệm vụ

ĐẶC ĐIỂM KỸ THUẬT NGÀY VÀ TẦN SỐ

NGÀY
Taskwarrior đọc ngày tháng từ dòng lệnh và hiển thị ngày tháng trong báo cáo. Các
định dạng ngày dự kiến ​​và mong muốn được xác định bởi biến cấu hình Định dạng ngày tháng

Đặc điểm kỹ thuật chính xác
nhiệm vụ ... đến hạn: 7/14/2008

ISO-8601
task ... due:2013-03-14T22:30:00Z

Từ ngữ tương đối
nhiệm vụ ... do: bây giờ
nhiệm vụ ... do: hôm nay
nhiệm vụ ... do: hôm qua
nhiệm vụ ... do: ngày mai

Số ngày có thứ tự
nhiệm vụ ... đến hạn: thứ 23
nhiệm vụ ... do: 3wks
nhiệm vụ ... đến hạn: 1 ngày
nhiệm vụ ... đến hạn: 9 giờ

Bắt đầu của tuần (làm việc) tiếp theo (Thứ Hai), tuần theo lịch (Chủ Nhật hoặc Thứ Hai), tháng,
quý và năm
nhiệm vụ ... do: gieo
nhiệm vụ ... do: soww
nhiệm vụ ... do: socw
nhiệm vụ ... do: som
nhiệm vụ ... do: soq
nhiệm vụ ... do: đậu nành

Cuối tuần (làm việc) hiện tại (thứ sáu), tuần dương lịch (thứ bảy hoặc chủ nhật), tháng,
quý và năm
nhiệm vụ ... do: eow
nhiệm vụ ... do: eoww
nhiệm vụ ... do: eocw
nhiệm vụ ... do: eom
nhiệm vụ ... do: eoq
nhiệm vụ ... do: eoy

Tại một số thời điểm hoặc muộn hơn
nhiệm vụ ... chờ: sau
nhiệm vụ ... chờ đợi: một ngày nào đó

Điều này đặt ngày chờ là 1/18/2038.

Ngày tiếp theo xảy ra trong tuần
nhiệm vụ ... do: fri

Những ngày lễ có thể đoán trước
nhiệm vụ ... do: goodfriday
nhiệm vụ ... do: Phục sinh
nhiệm vụ ... do: Eastermonday
nhiệm vụ ... do: thăng thiên
nhiệm vụ ... do: pentecost
nhiệm vụ ... do: midsommar
nhiệm vụ ... do: midsommarafton

TẦN SỐ
Các giai đoạn tái phát. Taskwarrior hỗ trợ một số cách để chỉ định tần số of
nhiệm vụ định kỳ.

hàng ngày, ngày, 1da, 2da, ...
Mỗi ngày hoặc một số ngày.

các ngày trong tuần
Thứ Hai, Thứ Ba, Thứ Tư, Thứ Năm, Thứ Sáu và bỏ qua các ngày cuối tuần.

hàng tuần, 1 tuần, 2 tuần, ...
Mỗi tuần hoặc một số tuần.

hai tuần một lần, hai tuần một lần
Mỗi hai tuần.

hàng tháng, hàng tháng, 1 tháng, 2 tháng, ...
Mỗi tháng.

hàng quý, 1tr, 2tr, ...
Ba tháng một lần, một quý hoặc một số quý.

nửa năm một lần
Cứ mỗi sáu tháng.

hàng năm, hàng năm, 1 năm, 2 năm, ...
Hàng năm hoặc một số năm.

hai năm một lần, hai năm một lần, 2 năm
Hai năm một lần.

BỐI CẢNH

Ngữ cảnh là một bộ lọc do người dùng xác định, được tự động áp dụng cho tất cả các lệnh
lọc danh sách nhiệm vụ. Đặc biệt, bất kỳ lệnh báo cáo nào sẽ có kết quả của nó bị ảnh hưởng bởi
bối cảnh hoạt động hiện tại.

$ danh sách nhiệm vụ
ID Tuổi Mô tả Dự án Urg
1 Chạy thể thao 2 ngày 5 dặm 1.42
2 1ng Trang chủ Làm sạch bát đĩa 1.14

Trang chủ ngữ cảnh $ task
Đã đặt "nhà" ngữ cảnh. Sử dụng 'không có ngữ cảnh nhiệm vụ' để loại bỏ.

$ danh sách nhiệm vụ
ID Tuổi Mô tả Dự án Urg
2 1ng Trang chủ Làm sạch bát đĩa 1.14
Đã đặt "nhà" ngữ cảnh. Sử dụng 'không có ngữ cảnh nhiệm vụ' để loại bỏ.

Như đã thấy trong ví dụ trên, ngữ cảnh được áp dụng bằng cách chỉ định tên của nó cho "ngữ cảnh"
chỉ huy. Để thay đổi ngữ cảnh hiện đang được áp dụng, chỉ cần chuyển tên của ngữ cảnh mới cho
lệnh 'context'.

Để bỏ đặt bất kỳ ngữ cảnh nào, hãy sử dụng lệnh con 'none'.

Không có ngữ cảnh $ task nào
Chưa đặt ngữ cảnh.

$ danh sách nhiệm vụ
ID Tuổi Mô tả Dự án Urg
1 Chạy thể thao 2 ngày 5 dặm 1.42
2 1ng Trang chủ Làm sạch bát đĩa 1.14

Ngữ cảnh có thể được xác định bằng cách sử dụng lệnh con 'xác định', chỉ định cả tên của
ngữ cảnh và nó được chỉ định bộ lọc.

$ task context xác định home
Bạn có chắc chắn muốn thêm 'context.home' với giá trị là 'project: Home' không? (có không)
Vâng
Đã xác định thành công "nhà" ngữ cảnh.

Để xóa định nghĩa, hãy sử dụng lệnh con 'xóa'.

$ task context xóa home
Bạn có chắc chắn muốn xóa 'context.home' không? (có / không) có
Không xác định thành công ngữ cảnh 'nhà'.

Để kiểm tra ngữ cảnh hiện đang hoạt động là gì, hãy sử dụng lệnh con 'show'.

hiển thị ngữ cảnh $ task
Ngữ cảnh 'nhà' với bộ lọc 'dự án: Trang chủ' hiện đang được áp dụng.

Các khung cảnh có thể lưu trữ các bộ lọc phức tạp tùy ý.

$ task context xác định family project: Family hoặc + paul hoặc + nancy
Bạn có chắc chắn muốn thêm 'context.home' với giá trị là 'project: Family hoặc + paul
hoặc + nancy '? (có / không) có
Đã xác định thành công "gia đình" theo ngữ cảnh.

Các ngữ cảnh là vĩnh viễn và tên ngữ cảnh đã đặt hiện tại được lưu trữ trong "ngữ cảnh"
biến cấu hình. Định nghĩa ngữ cảnh được lưu trữ trong ngữ cảnh ". "
biến cấu hình.

COMMAND CHỮ VIẾT TẮT

Tất cả các lệnh Taskwarrior có thể được viết tắt miễn là một tiền tố duy nhất được sử dụng, cho
thí dụ:

$ nhiệm vụ li

là một từ viết tắt rõ ràng cho

$ danh sách nhiệm vụ

nhưng

nhiệm vụ $ l

có thể là danh sách, ls hoặc dài.

Lưu ý rằng bạn có thể hạn chế kích thước chữ viết tắt tối thiểu bằng cách sử dụng cài đặt cấu hình:

viết tắt.minimum = 3

ĐẶC ĐIỂM KỸ THUẬT MÔ TẢ

Một số mô tả nhiệm vụ cần phải được thoát vì shell và ý nghĩa đặc biệt của
một số ký tự vào shell. Điều này có thể được thực hiện bằng cách thêm dấu ngoặc kép vào mô tả
hoặc thoát ký tự đặc biệt:

$ task add "quote" được trích dẫn "
$ task thêm câu trích dẫn thoát \ '

Đối số - (dấu gạch ngang kép) yêu cầu Taskwarrior coi tất cả các args khác như mô tả:

$ task add - project: Home cần lên lịch

Trong các tình huống khác, trình bao nhìn thấy khoảng trống và chia nhỏ các đối số. Ví dụ, điều này
chỉ huy:

$ task 123 sửa đổi / từ cái này / thành cái kia /

được chia thành nhiều đối số, được sửa bằng dấu ngoặc kép:

$ task 123 sửa đổi "/ from this / to that /"

Đôi khi cần buộc trình bao phải chuyển dấu ngoặc kép cho Taskwarrior một cách nguyên vẹn, vì vậy bạn
co thể sử dụng:

$ task add project: \ 'Three Word Project \' description

CẤU HÌNH FILE VÀ GHI ĐÈ LỰA CHỌN

Taskwarrior lưu trữ cấu hình của nó trong một tệp trong thư mục chính của người dùng: ~ / .taskrc.
Tệp cấu hình mặc định có thể được ghi đè bằng:

công việc rc: ...
Chỉ định một tệp cấu hình thay thế.

TASKRC = / tmp / .taskrc công việc ..
Biến môi trường ghi đè mặc định và đặc tả dòng lệnh
của tệp .taskrc.

công việc rc. : ...
công việc rc. = ... Chỉ định ghi đè tệp cấu hình riêng lẻ.

TASKDATA = / tmp / .task công việc ...
Biến môi trường ghi đè mặc định, dòng lệnh và
cài đặt cấu hình 'data.location' của thư mục dữ liệu tác vụ.

MORE VÍ DỤ

Để biết các ví dụ, vui lòng xem tài liệu trực tuyến bắt đầu tại

<http://taskwarrior.org/docs>

Lưu ý rằng tài liệu trực tuyến có thể chi tiết hơn và cập nhật hơn so với tài liệu hướng dẫn này
.

Sử dụng công việc trực tuyến bằng các dịch vụ onworks.net