devtodo - Online di Cloud

PROGRAM:

NAMA

todo - program pengingat/tugas yang ditujukan untuk pengembang

RINGKASAN

todo []
Tanpa opsi, menampilkan item di direktori saat ini.

tda [-P ] [-G ] []
Tambahkan item baru, secara opsional mencangkoknya sebagai anak dari item yang diberikan.

tde
Edit item yang diberikan.

tdr
Hapus item yang diberikan.

tdd
Tandai item yang ditentukan sebagai selesai.

todo --tautan [-G ]
Tautkan database devtodo yang ditentukan ke database saat ini, secara opsional mencangkoknya sebagai
anak dari indeks yang ditentukan.

DESKRIPSI

todo adalah program yang ditujukan khusus untuk programmer (tetapi dapat digunakan oleh siapa saja di .)
terminal) untuk membantu perkembangan sehari-hari.

Ini mempertahankan daftar item yang belum selesai. Hal ini memungkinkan programmer untuk
melacak bug atau item luar biasa yang perlu diselesaikan dengan sedikit usaha.

Item dapat diprioritaskan dan juga dapat ditampilkan dalam hierarki, sehingga satu item dapat
bergantung pada yang lain.

Dengan menggunakan beberapa skrip shell kecil (scripts.* di direktori dokumen sumber
distribusi), todo juga dapat menampilkan item yang luar biasa dalam direktori saat Anda mengubah
ke dalamnya. Jadi, misalnya, jika Anda cd ke direktori sumber untuk melakukan sendiri, Anda harus
lihat daftar item yang luar biasa...kecuali semua bug telah diperbaiki ;).

PILIHAN

Opsi dapat memiliki bentuk panjang dan pendek.

Opsi pendek dapat digabungkan menjadi satu argumen dengan menggunakan tanda hubung diikuti oleh string
pilihan singkat. Parameter opsi pendek juga dapat ditambahkan ke string ini.

-di, --bertele-tele
Tampilkan secara verbose

-Sebuah, --Menambahkan []
Tambahkan catatan (akan meminta catatan jika tidak ada).

-G, --korupsi
Setara dengan --Menambahkan or --tautan, cangkok item baru ke item yang ditentukan.

-aku, --tautan
Tautkan file todo yang ditentukan ke badan file ini. Jika database yang ditautkan memiliki
satu set judul, ini akan digunakan sebagai badan dari item yang menghubungkan jika tidak
nama direktori dari database yang ditautkan akan digunakan. Gunakan --remove (atau tdr) untuk menghapus
database tertaut - ini tidak tidak hapus database itu sendiri, hanya tautannya.

-R,--reparatif [, ]
Ubah induk indeks item pertama ke indeks item kedua. Jika tidak ada detik
indeks diberikan item tersebut direparasi ke akar pohon.

-P, --prioritas
Dalam hubungannya dengan --add atau --edit, atur prioritas (default | veryhigh | high |
sedang | rendah | sangat rendah)

-e, --edit
Edit catatan yang diindeks oleh nomor yang diberikan.

--menghapus
Hapus catatan yang diindeks oleh nomor yang diberikan, termasuk anak-anak.

-D, --selesai
Tandai catatan tertentu (dan anak-anak mereka) sebagai selesai.

-D, --belum selesai
Tandai catatan yang ditentukan (dan semua anak) sebagai belum selesai.

--database-global
Tentukan database yang akan digunakan jika salah satu dari -G or --global opsi ditentukan.

-G, --global
Paksa todo untuk menggunakan database yang ditentukan dengan --database-global. Jika ini ditempatkan
di Anda ~/.todorc itu akan memaksa todo untuk menggunakan database itu dengan mengesampingkan semua
lainnya

--basis data
Ubah database dari apa pun defaultnya (biasanya '.todo') ke file
ditentukan.

-T, --MELAKUKAN
Hasilkan file teks keluaran TODO khas dari Todo DB.

-SEBUAH, --semua
Pintasan untuk filter '+selesai,+anak-anak' untuk menampilkan semua catatan.

-F, --Saring
Tampilkan hanya catatan yang lolos filter. Silakan merujuk ke bagian FILTER untuk
Informasi lebih lanjut

--warna
Ganti warna default item todo. Silakan merujuk ke bagian WARNA keahlian yang lebih
informasi.

--force-warna
Paksa penggunaan warna bahkan saat tidak menghasilkan ke TTY. Ini berguna saat pemipaan
untuk kurang(1) -R.

--mono Hapus semua urutan pelarian ANSI dari output - berguna untuk gangguan warna
terminal.

--membantu Tampilkan bantuan ini.

--Versi: kapan
Tampilkan versi ToDo.

--judul []
Tetapkan judul catatan tugas direktori ini.

--format tanggal
Format tampilan nilai waktu. Formatnya adalah yang digunakan oleh waktu luang(3). Itu
format default adalah '%c'. Opsi ini paling baik ditentukan dalam ~/.todorc.

--format =
Tentukan format output. Silakan lihat bagian FORMATING untuk lebih lanjut
informasi.

--gunakan-format =
Gunakan string format yang diidentifikasi oleh (didefinisikan dengan --format) sebagai
format string untuk digunakan saat memformat dengan format bawaan .

--menyortir
Urutkan database dengan ekspresi yang ditentukan. Lihat bagian PENYORTIRAN untuk
informasi yang lebih detail.

--paranoid
Jadilah paranoid tentang beberapa pengaturan, termasuk izin.

--database-loader <pemuat daftar>
Coba format database dalam urutan yang diberikan. Format yang valid adalah xml dan biner. misalnya.
todo --database-loaders biner,xml. Format defaultnya adalah XML.

--cadangan []
Backup database hingga kali, tepat sebelum ditulis. Jika tidak
ditentukan, satu cadangan akan dibuat. Nama file yang digunakan untuk menyimpan cadangan adalah:
nama database default dengan revisinya ditambahkan seperti: .todo.1, .todo.2, dll.
Untuk benar-benar menggunakan salah satu dari cadangan ini, Anda dapat memindahkannya ke .todo atau menggunakan
--database .todo. untuk secara eksplisit menentukan penggunaannya.

-S, --Ringkasan
Alihkan mode "ringkasan", di mana item panjang dipotong menjadi satu baris.

-C, --komentar
Edit atau tampilkan komentar masing-masing.

--waktu habis []
If ditentukan, batas waktu antara tampilan database diatur ke nomor ini
detik. Jika tidak ditentukan, perilakunya adalah menampilkan database
hanya jika belum ditampilkan selama jumlah detik yang ditentukan oleh --timeout
dengan itu diberikan. misalnya. todo --waktu habis 10 --waktu habis hanya akan menampilkan
database paling banyak sekali setiap 10 detik. Menempatkan batas waktu 10 di Anda ~/.todorc adalah
opsi yang bagus, lalu --timeout di dokumen/skrip.* akan berarti bahwa database
tidak akan ditampilkan setiap kali Anda memasukkan cd ke direktori.

--membersihkan []
Bersihkan semua item yang sudah selesai lebih lama dari . Jika dihilangkan, semua
catatan yang telah selesai dihapus.

PRIORITAS

Prioritas dapat ditentukan secara simbolis menggunakan kata-kata kegagalan, sangat tinggi, tinggi, medium,
rendah dan sangat rendah.

kegagalan prioritas memiliki arti khusus karena akan menggunakan prioritas default untuk semua
tindakan. Ini berarti bahwa saat mengedit item yang ada, prioritasnya dipertahankan; Kapan
membuat item baru, prioritas akan ditetapkan ke medium; saat mencangkok item baru, itu
prioritas akan menjadi induknya. DevTodo tidak akan meminta prioritas jika ini
ditentukan, menjadikannya fitur yang berguna untuk todorc Anda. Seperti semua opsi, prioritas
dapat diganti pada baris perintah.

FILTER

Filter terdiri dari daftar ekspresi yang digunakan untuk menentukan nada yang
ditampilkan.

Format umum dari ekspresi filter adalah:

([-|=|+](semua|anak|selesai| | )) | (/ ekspresi>)

Umumnya, jika ekspresi filter diawali dengan '-', itu akan tidak menampilkan item yang
cocok dengan ekspresi, jika diawali dengan '+' itu akan menampilkan item yang cocok dengan ini
ekspresi selain yang lain, atau jika diawali dengan '=' (atau tanpa awalan sama sekali) akan
pameran hanya item-item yang cocok dengan ekspresi. Perhatikan bahwa ini hanya akan mencari item
tidak dikecualikan oleh filter lain, jadi untuk mencari seluruh basis data Anda harus melakukannya
sesuatu seperti: todo --Saring semua,/beberapa-pencarian-string.

Bentuk kedua dari ekspresi filter digunakan untuk mencari teks dalam database. <pencarian
ekspresi> adalah ekspresi reguler yang dicocokkan dengan badan teks setiap item.

Filter atom difilter berdasarkan status selesai, prioritas, lalu pencarian. Jadi item pertama
yang tidak cocok dengan filter "selesai" akan dikecualikan, lalu yang tidak cocok dengan
filter prioritas, dan sebagainya.

Ekspresi secara rinci:

semua Memaksa semua item untuk ditampilkan. Berbagai awalan tidak berpengaruh pada ini
ekspresi.

anak-anak
Ciutkan atau perluas item turunan. Jika awalan '-' ada, anak-anak adalah
diciutkan, jika tidak, anak-anak akan ditampilkan.

dilakukan Filter apakah suatu item selesai atau tidak.


Indeks catatan ditentukan sebagai angka. Rentang dapat diberikan ala '1.2.10-20'.


Prioritas ditentukan seperti yang dijelaskan dalam PRIORITAS bagian. Awalan '-'
akan menampilkan semua item dengan prioritas kurang dari atau sama dengan prioritas yang diberikan.
Dengan awalan '+', semua item dengan prioritas lebih besar atau sama dengan yang diberikan
prioritas ditampilkan. Jika '=' atau tidak ada awalan yang diberikan, hanya item dengan yang ditentukan
prioritas ditampilkan.

contoh:

todo --filter selesai,-anak,+rendah

Ini hanya akan menampilkan item yang sudah selesai dan memiliki prioritas rendah atau lebih tinggi. Di dalam
Selain itu, anak-anak akan pingsan.

lakukan /[Tt]dia

Hanya tampilkan item-item dengan kata 'the' di dalamnya, di mana huruf pertama bisa lebih rendah
atau huruf besar. Mungkin perlu mengutip ekspresi pencarian untuk memastikan Shell melakukannya
tidak menafsirkan mereka.

FORMAT

Output dari todo dapat diubah menjadi lebih sesuai dengan keinginan Anda dengan mendefinisikannya sendiri
memformat string. String ini mirip dengan yang digunakan dalam Printf(3) dan waktu luang(3).

Contoh berikut, yang dapat ditempatkan di ~/.todorc, akan meniru default
perilaku:

# Tampilan dalam format default
format tampilan=%i%[info]%f%2n.%[priority]%T

# Tampilan dalam format default
format yang dihasilkan=%2i-%T%2i (ditambahkan %d, prioritas %p)\n\n

Ada empat opsi format terpisah: pameran, dihasilkan, tampilan verbose dan bertele-tele-
dihasilkan. Dua yang terakhir digunakan untuk memformat teks masing-masing ketika --verbose adalah
ditentukan sebagai argumen untuk dilakukan.

Selain itu, pengguna dapat membuat string format mereka sendiri hanya dengan melewatkan yang berbeda
pengenal untuk format. Ini kemudian dapat diaktifkan dengan menggunakan --gunakan-format. misalnya.

format laporan lengkap=%i%[info]%f%2n.%[priority]%+1T%+1i%[info]Ditambahkan: %[normal]%c
%[info]Selesai: %[normal]%d\n%+1i%[info]Durasi: %[normal]%D %[info]Prioritas:
%[normal]%p\n\n
# Ganti format tampilan untuk menggunakan "laporan lengkap".
tampilan format penggunaan = laporan lengkap

Berbagai bendera yang tersedia adalah:

% > > bendera mengatur jumlah spasi untuk digunakan untuk semua indentasi di masa mendatang.

%[+|-][ ]Saya
Indentasi ke kedalaman item saat ini. menentukan kedalaman untuk indentasi. Jika is
dihilangkan, level saat ini digunakan. Nilai relatif dapat digunakan. misalnya. '%+1T' akan
indentasi ke satu tingkat lebih tinggi dari tingkat indentasi saat ini.

%[+|-][ ]T
Menampilkan teks item, dibungkus 80 karakter dan menjorok ke
tingkat yang ditentukan. Semantik dari sama dengan %i. Perhatikan bahwa teks yang dibungkus
secara otomatis menambahkan '0 di akhir teks, sedangkan %t tidak akan.

%t Teks item yang tidak terbungkus dan tidak diformat.

%s Teks ringkasan (yaitu hanya satu baris, setara dengan --Ringkasan).

%p Tingkat prioritas item saat ini.

%c Tanggal pembuatan item saat ini, diformat menurut --date-format.

%d Tanggal saat item ditandai sebagai selesai, diformat menurut --date-format.

%D Durasi item, diformat menurut --date-format.

%[ ]n
Nomor indeks item saat ini. Nilai numerik opsional menentukan
jumlah karakter yang harus ditempati oleh nomor tersebut. Nomor diisi dengan spasi
untuk mengisi jumlah karakter ini.

%f Bendera negara bagian dari item saat ini. Nilai yang ditampilkan untuk bendera ini adalah '+'
berarti anak-anak, '-' berarti selesai', '*' berarti selesai dengan anak-anak.

%F Bendera status yang dapat dibaca manusia dari item saat ini. Nilai yang ditampilkan untuk ini
bendera adalah 'anak-anak', 'selesai' berarti selesai', 'selesai, anak-anak' dan 'terbuka'.

%[ ]
Warna dapat ditentukan dengan bendera ini. Nilai yang valid untuk adalah:
sangat rendah, rendah, medium, tinggi, sangat tinggi, judul, Info, dan prioritas. Ini cukup
cukup jelas, kecuali prioritas perubahan warna prioritas item saat ini. misalnya.
%[prioritas]

Harap dicatat bahwa saat membuat indentasi, Anda akan khas ingin menggunakan nilai awalan '+1'
dengan t. yaitu. %+1T. Ini memaksa teks untuk menjorok ke satu tingkat lebih dalam dari saat ini
tingkat, membuatnya duduk jauh dari format lain yang mungkin Anda gunakan.

PENYORTIRAN

Tampilan item dalam database dapat diurutkan pada berbagai kunci. Diberikan serangkaian
kunci untuk melakukan pengurutan pada setiap kunci yang berurutan, melanjutkan ke yang berikutnya hanya jika kunci sebelumnya
perbandingan itu setara. Sebagai contoh:

todo --sort -selesai,teks

Ini akan mengurutkan pertama berdasarkan apakah item selesai dan kedua berdasarkan teksnya. Ini
mengelompokkan item secara efektif menjadi dua blok - yang lengkap dan yang tidak.

Kunci yang tersedia adalah dibuat, selesai, teks, prioritas, lamanya, tak satupun dan
dilakukan. Setiap kunci, kecuali tak satupun dapat diawali dengan - untuk membalikkan urutan default dan
beberapa kunci harus dipisahkan dengan ,.

Jika beberapa parameter --sort ditemukan, yang terakhir digunakan. Ini berarti bahwa
entri 'urutkan' di ~/.todorc akan ditimpa oleh sembarang pada baris perintah.

INDIKASI

Indeks digunakan sebagai opsi untuk berbagai argumen baris perintah. Beberapa indeks catatan
dipisahkan dengan koma (spasi adalah tidak diizinkan). Anak-anak dicakup menggunakan '.'.

Misalnya, diberikan catatan berikut:

1. Lakukan halaman manual
1. Membuat mereka lebih indah.
2. Membuat dokumentasi HTML juga.

Sub-item kedua akan direpresentasikan seperti ini: 1.2

Wildcard '*' dapat digunakan untuk mewakili semua anak dari sebuah simpul. misalnya. 1.*

Rentang nada dapat ditentukan dengan menggunakan ' - '. Misalnya, untuk menandai catatan 10.1.2,
10.1.3 dan 10.3.4 setelah selesai, Anda dapat melakukan: todo --done 10.1.2-4

WARNA

Berbagai item dapat diwarnai. Barang-barang yang dapat sangat tinggi, tinggi, medium, rendah, sangat rendah,
judul dan Info. Info digunakan untuk menampilkan nomor item dan informasi umum.

Item ini dapat diatur ke salah satu dari delapan warna. Warna-warna itu adalah hitam, merah, hijau,
kuning, biru, magenta, cyan, putih dan kegagalan. Warna kegagalan digunakan untuk menentukan
warna terminal latar depan default.

Warna ditentukan seperti ini:

=[+]

Jika opsional + dalam ekspresi ini digunakan akan menyebabkan item menjadi tebal.

Misalnya, sebuah baris di Anda ~/.todorc mungkin terlihat seperti:

media warna = + putih

Yang akan membuat medium teks pin putih.

TODORC

todo dapat memuat opsi dari sejumlah file sumber daya. Urutan di mana ini diuraikan
adalah sebagai berikut:

1. File yang ditentukan dalam variabel lingkungan TODORC atau, jika itu tidak ada,
/etc/todorc.
2. ~/.todorc

Opsi bersifat kumulatif karena yang dimuat dari $TODORC akan ditimpa atau ditambahkan oleh
mereka di ~/.todorc.

Opsi ini ditentukan sebagai pasangan kunci/nilai, satu per baris Kuncinya adalah nama panjang dari a
argumen baris perintah dan nilainya adalah parameter untuk argumen itu, jika ada. Tambahan,
variabel lingkungan diperluas.

Misalnya, argumen baris perintah --filter menerima parameter yang merupakan filter
ekspresi. Filter default dapat ditambahkan ke ~/.todorc berkas seperti:

# Jangan tampilkan item anak secara default
filter -anak-anak

Satu-satunya perbedaan antara opsi yang ditentukan dalam file rc dan yang ada di baris perintah
apakah opsi dalam file rc tidak diawali dengan --.

Selain itu, ada dua perintah yang tersedia di file RC yang tidak tersedia di
garis komando. Mereka:

Perintah pertama, on, digunakan untuk menambahkan perintah tertentu secara kondisional. Formatnya ini
perintahnya adalah: on [ ]. Acara yang valid adalah menambahkan, menghapus, melihat, mengedit,
menghasilkan, dilakukan, belum selesai, judul, orang tua, memuat, menyimpan, link, membuat dan pembersihan. Beberapa
perintah dapat diteruskan ke on dengan melampirkannya dalam kawat gigi (spasi diperlukan di antara
token). Contoh lengkap di bawah ini.

Perintah kedua adalah eksekutif <kulit perintah>. Perintah ini akan mengeksekusi argumen itu
diberikan dalam cangkang. Variabel lingkungan $TODODB berisi nama file saat ini
basis data. misalnya. eksekutif chmod 600 $TODODB

Ada contoh file rc di subdirektori doc dari distribusi sumber.

CONTOH

Untuk menampilkan item yang beredar di direktori saat ini, cukup ketik:

todo

Untuk menghapus catatan 1, 2 dan 4:

lakukan --hapus 1,2,4, XNUMX

Untuk menampilkan SEMUA item:

melakukan semua

Untuk hanya menampilkan item tingkat atas dan bukan turunannya:

todo -anak-anak

(meskipun anak-anak bukan argumen yang valid, ini berfungsi karena todo menafsirkan apa pun
argumen baris perintah yang tidak dikenali sebagai bagian dari ekspresi filter)

Contoh yang lebih kompleks. Ini menambahkan item baru, dengan teks item yang ditentukan pada
baris perintah, dengan prioritas tinggi sebagai anak dari anak ketiga dari item kedua (jika
itu masuk akal):

todo -a "Perbaiki halaman manual" -p tinggi -g 2.3

Ini adalah contoh cara menggunakan fitur TODO dari todo. Itu membuat todo menghasilkan yang baru
File TODO dari informasi yang disimpan dalam database. Contoh khusus ini menampilkan semua
item ke file TODO, bahkan yang ditandai sebagai selesai.

harus dilakukan --filter semua --TODO

Contoh ini menunjukkan penggunaan pemicu acara yang bagus. Ketika database baru dibuat, itu
akan memaksa izinnya ke 0600.

di buat {
bertele-tele
exec chmod 600 .todo
}

Gunakan devtodo online menggunakan layanan onworks.net