devtodo - Bulutta Çevrimiçi

Program:

ADI

todo - geliştiricilere yönelik bir hatırlatma/görev programı

SİNOPSİS

todo []
Seçenek olmadan, geçerli dizindeki öğeleri görüntüler.

tda [-P ] [-G ] []
İsteğe bağlı olarak verilen öğenin alt öğesi olarak aşılayarak yeni bir öğe ekleyin.

tde
Verilen öğeyi düzenleyin.

tdr
Verilen öğeleri kaldırın.

tdd
Belirtilen öğeleri yapıldı olarak işaretleyin.

todo --bağlantı [-G ]
Belirtilen devtodo veritabanını mevcut veritabanına bağlayın, isteğe bağlı olarak aşılayın.
belirtilen dizinin bir çocuğu.

TANIM

todo özellikle programcılara yönelik bir programdır (ancak,
terminal) günlük gelişime yardımcı olmak için.

Henüz tamamlanmamış öğelerin bir listesini tutar. Bu, programcının
çok az çabayla tamamlanması gereken olağanüstü hataları veya öğeleri izleyin.

Öğelere öncelik verilebilir ve ayrıca bir hiyerarşide görüntülenebilir, böylece bir öğe
diğerine bağlıdır.

Bazı küçük kabuk komut dosyalarının kullanımıyla (komut dosyaları.* kaynağın doc dizininde
dağıtım), yapılacaklar, siz değiştirdikçe bir dizindeki bekleyen öğeleri de görüntüleyebilir
bunun içine. Bu nedenle, örneğin, yapılacaklar için kaynak dizine cd yazarsanız,
bekleyen öğelerin bir listesine bakın... tüm hatalar düzeltilmedikçe;).

SEÇENEKLER

Seçenekler hem uzun hem de kısa biçime sahip olabilir.

Kısa seçenekler, bir tire ve ardından bir dize kullanılarak tek bir argümanda birleştirilebilir.
kısa seçenekler. Kısa seçeneklerin parametreleri de bu dizeye eklenebilir.

-içinde, --ayrıntılı
ayrıntılı olarak göster

-A, --Ekle []
Bir not ekleyin (verilmemişse bir not isteyecektir).

-G, --greft
İle birlikte --Ekle or --bağlantı, yeni öğeyi belirtilen öğeye aşılayın.

-ben, --bağlantı
Belirtilen yapılacaklar dosyasını bunun gövdesine bağlayın. Bağlantılı veritabanı varsa
bir başlık seti, bu, bağlantı öğesinin gövdesi olarak kullanılacaktır, aksi takdirde
bağlantılı veritabanının dizin adı kullanılacaktır. Kaldırmak için --remove (veya tdr) kullanın
bağlantılı veritabanları - bu değil veritabanının kendisini, yalnızca bağlantıyı kaldırın.

-R,--vekil [, ]
İlk öğe dizininin üst öğesini ikinci öğe dizinine değiştirin. saniye yoksa
indeks verilir, öğe ağacın köküne yeniden verilir.

-P, --öncelik
--add veya --edit ile birlikte önceliği ayarlayın (varsayılan | çok yüksek | yüksek |
orta | düşük | Çok düşük)

, -e --Düzenle
Verilen numaraya göre indekslenen notu düzenleyin.

--kaldırmak
Herhangi bir çocuk da dahil olmak üzere, verilen numaralarla indekslenen notu kaldırın.

-NS, --tamamlamak
Belirtilen notları (ve altlarını) yapıldı olarak işaretleyin.

-NS, --bitmiş değil
Belirtilen notları (ve tüm alt öğeleri) yapılmadı olarak işaretleyin.

--global-veritabanı
Aşağıdakilerden herhangi biri varsa, kullanılacak veritabanını belirtin. -G or --küresel seçenekler belirtilir.

-G, --küresel
Todo ile belirtilen veritabanını kullanmaya zorla --global-veritabanı. bu konursa
Cihazınızda ~/.todorc todo'yu tüm veritabanını hariç tutmak için bu veritabanını kullanmaya zorlayacaktır.
diğerleri.

--veri tabanı
Veritabanını varsayılandan (tipik olarak '.todo') dosyaya değiştirin
belirtildi.

-T, --YAPMAK
Bir Todo DB'sinden tipik bir TODO çıktı metin dosyası oluşturun.

-A, --herşey
Tüm notları göstermek için '+done,+children' filtresinin kısayolu.

-F, --filtre
Yalnızca filtreyi geçen notları görüntüleyin. Lütfen bölüme bakın FİLTRELER için
daha fazla bilgi.

--renk
Yapılacak öğelerin varsayılan renklerini geçersiz kıl. Lütfen bölüme bakın RENK Daha fazla bilgi için
bilgiler.

--kuvvet-renk
Bir TTY'ye çıktı almadığınızda bile renk kullanımını zorlayın. Bu, boru döşerken kullanışlıdır
için az(1) -R.

--mono Tüm ANSI kaçış dizilerini çıktıdan kaldırın - renk bozukluğu olanlar için kullanışlıdır
terminaller.

--yardım et Bu yardımı göster.

--versiyon
Yapılacaklar'ın görüntülenen sürümü.

--Başlık []
Bu dizinin yapılacaklar notlarının başlığını ayarlayın.

--tarih formatı
Zaman değerlerinin görüntüsünü biçimlendirin. Biçim, tarafından kullanılan biçimdir. strftime(3).
varsayılan biçim '%c'dir. Bu seçenek en iyi şekilde ~/.todorc.

--biçim =
Çıktının biçimlendirmesini belirtin. Daha fazla bilgi için lütfen FORMATLAMA bölümüne bakın.
bilgiler.

--use-formatı =
tarafından tanımlanan biçim dizesini kullanın olarak (--format ile tanımlanır)
yerleşik formatla formatlarken kullanılacak format dizesi .

--çeşit
Veritabanını belirtilen ifadeyle sıralayın. bölümüne bakın SIRALAMA için
daha detaylı bilgi.

--paranoyak
İzinler dahil bazı ayarlar konusunda paranoyak olun.

--veritabanı yükleyicileri <yükleyici liste>
Veritabanı formatlarını verilen sırayla deneyin. Geçerli biçimler xml ve ikili. Örneğin.
yapılacaklar --database-loaders ikili,xml. Varsayılan biçim XML'dir.

--destek olmak []
Veritabanını şu tarihe kadar yedekleyin: kez, yazılmadan hemen önce. Eğer değil
belirtilen, bir yedekleme yapılacaktır. Yedekleri depolamak için kullanılan dosya adları,
revizyonları şu şekilde eklenmiş varsayılan veritabanı adı: .todo.1, .todo.2, vb.
Bu yedeklemelerden birini gerçekten kullanmak için, onu .todo'ya dönüştürebilir veya kullanabilirsiniz.
--veritabanı .todo. kullanımını açıkça belirtmek için.

-Evet, --Özet
Uzun öğelerin bir satıra kesildiği "özet" modunu değiştirin.

-C, --Yorum
Sırasıyla yorumları düzenleyin veya gösterin.

--zaman aşımı []
If belirtilirse, veritabanı ekranları arasındaki zaman aşımı bu sayıya ayarlanır
saniye sayısı. Eğer hayırsa belirtilirse, davranış veritabanını görüntülemektir.
bir tek --timeout ile belirtilen saniye sayısı boyunca görüntülenmediyse
ile the verildi. Örneğin. todo --zaman aşımı 10 --zaman aşımı sadece gösterecekti
veritabanı en fazla her 10 saniyede bir. koyarak zaman aşımı 10 Cihazınızda ~/.todorc bir
iyi bir seçenek, ardından --timeout belge/komut dosyaları.* veritabanı anlamına gelir
bir dizine her cd eklediğinizde görüntülenmez.

--temizlemek []
Şu tarihten daha eski olan tüm tamamlanmış öğeleri temizle . Eğer atlanır, tüm
tamamlanan kayıtlar temizlenir.

ÖNCELİKLER

Öncelikler, kelimeler kullanılarak sembolik olarak belirtilebilir. varsayılan, çok yüksek, yüksek, orta,
düşük ve Çok düşük.

The varsayılan önceliğin, herhangi biri için varsayılan önceliği kullanması bakımından özel bir anlamı vardır.
eylem. Bu, mevcut bir öğeyi düzenlerken önceliğinin korunduğu anlamına gelir; ne zaman
yeni bir öğe oluştururken öncelik orta; yeni bir öğeyi aşılarken, onun
öncelik ebeveynininki olacaktır. Bu durumda DevTodo öncelik istemeyecektir.
belirtilmiş, todorc'unuz için kullanışlı bir özellik haline getiriyor. Tüm seçeneklerde olduğu gibi, öncelik
komut satırında geçersiz kılınabilir.

FİLTRELER

Filtreler, notları tanımlamak için kullanılan ifadelerin bir listesinden oluşur.
Görüntülenen.

Bir filtre ifadesinin genel biçimi şöyledir:

([-|=|+](tümü|çocuklar|bitti| | )) | (/ ifade>)

Genel olarak, bir filtre ifadesinin önüne '-' getirilirse, değil öğeleri göster
ifadeyi eşleştirin, eğer bir '+' ön eki ise bununla eşleşen öğeleri görüntüler.
diğerlerine ek olarak veya bir '=' ile ön eki (veya hiç önek yok) varsa,
ekran bir tek ifadeyle eşleşen öğeler. Bunun yalnızca öğeleri arayacağını unutmayın
diğer filtreler tarafından hariç tutulmaz, bu nedenle tüm veritabanını aramak için yapmanız gerekir
gibi bir şey: todo --filtre tümü,/bazı-arama-dizesi.

Filtre ifadesinin ikinci biçimi, bir veritabanında metin aramak için kullanılır. <arama
ifade> her öğenin metin gövdesiyle eşleşen normal bir ifadedir.

Filtre atomları, yapılan duruma, önceliğe ve ardından aramaya göre sırayla filtrelenir. Yani ilk öğeler
"bitti" filtresiyle eşleşmeyen filtreler hariç tutulur, ardından
öncelik filtresi vb.

Ayrıntılı olarak ifadeler:

herşey Tüm öğeleri görüntülenmeye zorlar. Çeşitli öneklerin bunun üzerinde hiçbir etkisi yoktur.
ifadesi.

çocuklar için
Alt öğeleri daraltın veya genişletin. '-' öneki varsa, çocuklar
daraltılır, aksi takdirde çocuklar görüntülenir.

yapılmış Bir öğenin tamamlanıp tamamlanmadığına göre filtreleyin.


Not endeksleri sayı olarak belirtilmiştir. Aralıklar '1.2.10-20' olarak verilebilir.


Öncelikler, aşağıdaki bölümde açıklandığı gibi belirtilir: ÖNCELİKLER Bölüm. '-' öneki
önceliği verilen önceliğe eşit veya daha az olan tüm öğeleri görüntüler.
'+' öneki ile, verilen öncelikten büyük veya eşit önceliğe sahip tüm öğeler
öncelik gösterilir. '=' veya önek verilmezse, yalnızca belirtilen öğeye sahip öğeler
öncelik görüntülenir.

Örnekler:

yapılacaklar --filtre tamamlandı,-çocuklar,+düşük

Bu, yalnızca yapılmış ve düşük veya daha yüksek önceliğe sahip olan öğeleri gösterecektir. İçinde
ayrıca, çocuklar çökecek.

yapılacak /[Tt]he

Yalnızca ilk harfin daha küçük olabileceği, içinde 'the' kelimesi bulunan öğeleri görüntüleyin
veya büyük harf. Kabuğun yaptığından emin olmak için arama ifadesini alıntı yapmak gerekli olabilir.
onları yorumlamayın.

BİÇİMLENDİRME

Yapılacaklar'ın çıktısı, kendinizinkini tanımlayarak beğeninize daha fazla olacak şekilde değiştirilebilir.
biçimlendirme dizeleri. Bu dizeler, kullanılanlara benzer printf(3) ve strftime(3).

Yerleştirilebilecek aşağıdaki örnekler ~/.todorc, varsayılanı taklit edecek
davranış:

# Varsayılan formatta göster
biçim gösterimi=%i%[bilgi]%f%2n.%[öncelik]%T

# Varsayılan formatta göster
oluşturulan biçim=%2i-%T%2i (%d eklendi, %p önceliği)\n\n

Dört ayrı biçim seçeneği vardır: ekran, oluşturulan, ayrıntılı ekran ve ayrıntılı
oluşturulan. Son ikisi, --verbose olduğunda ilgili metinlerini biçimlendirmek için kullanılır.
yapılacak bir argüman olarak belirtilir.

Ek olarak, kullanıcılar sadece farklı bir format ileterek kendi format dizilerini oluşturabilirler.
tanımlayıcı biçim. Bu daha sonra kullanılarak etkinleştirilebilir --use-formatı. Örneğin.

tam raporu biçimlendir=%i%[bilgi]%f%2n.%[öncelik]%+1T%+1i%[bilgi]Eklendi: %[normal]%c
%[info]Tamamlandı: %[normal]%d\n%+1i%[info]Süre: %[normal]%D %[info]Öncelik:
%[normal]%p\n\n
# "Tam raporu" kullanmak için görüntüleme biçimini geçersiz kılın.
kullanım biçimi gösterimi=tam rapor

Mevcut olan çeşitli bayraklar şunlardır:

% > The > bayrak boşluk sayısını ayarlar gelecekteki tüm girintiler için kullanmak için.

%[+|-][ ]ben
Geçerli öğenin derinliğine girinti. girintilenecek derinliği belirtir. Eğer is
atlanırsa, mevcut seviye kullanılır. Göreceli değerler kullanılabilir. Örneğin. '%+1T'
mevcut girinti seviyesinden bir seviye daha yüksek girinti.

%[+|-][ ]T
Öğenin metnini, 80 karaktere sarılmış ve girintili olarak görüntüleyin.
belirtilen seviye. semantiği olduğu gibi %i. Sarılmış metni unutmayın
metnin sonuna otomatik olarak bir '0 ekler, oysa %t olmaz.

%t Öğenin sarılmamış, biçimlendirilmemiş metni.

%s Özet metni (yani, yalnızca bir satır, eşdeğer --Özet).

%p Geçerli öğenin öncelik düzeyi.

%c --date-format'a göre biçimlendirilmiş geçerli öğe oluşturma tarihi.

%d Öğenin tamamlandı olarak işaretlendiği, --date-format'a göre biçimlendirildiği tarih.

%D --date-format'a göre biçimlendirilmiş öğenin süresi.

%[ ]n
Geçerli öğenin dizin numarası. İsteğe bağlı sayısal değer belirtir
sayının işgal etmesi gereken karakter sayısı. Sayı boşluklarla doldurulur
bu sayıda karakter doldurmak için.

%f Geçerli öğenin eyalet bayrağı. Bu bayrak için görüntülenen değerler '+'
çocuklar anlamına gelir, '-' bitti' anlamına gelir, '*' çocuklarla yapılır anlamına gelir.

%F Geçerli öğenin insan tarafından okunabilir durum bayrağı. Bunun için görüntülenen değerler
bayrak 'çocuklar', 'bitti' bitti', 'bitti, çocuklar' ve 'açık' anlamına gelir.

%[ ]
Renkler bu bayrak ile belirtilebilir. için geçerli değerler şunlardır:
Çok düşük, düşük, orta, yüksek, çok yüksek, başlık, bilgi, ve öncelik. Bunlar oldukça
dışında açıklayıcı öncelik geçerli öğelerin öncelik rengine değişir. Örneğin.
%[öncelik]

Lütfen girinti yaparken, tipik '+1' önek değeri kullanmak istiyorum
%T ile yani. %+1T. Bu, metni geçerli olandan bir düzey daha derine girmeye zorlar.
düzeyi, kullanmış olabileceğiniz diğer biçimlendirmelerden uzak durmasını sağlar.

SIRALAMA

Veritabanındaki öğelerin gösterimi çeşitli tuşlara göre sıralanabilir. verilen bir dizi
todo tuşları birbirini izleyen her tuşa göre sıralanır, yalnızca önceki tuş varsa bir sonrakine devam eder.
karşılaştırma eşitti. Örneğin:

todo --sort -done,metin

Bu, ilk olarak bir öğenin tamamlanıp tamamlanmadığına ve ikinci olarak metinlerine göre sıralanır. Bu
öğeleri etkili bir şekilde iki bloğa gruplandırır - tamamlanmış olanlar ve olmayanlar.

Kullanılabilir anahtarlar şunlardır: çevrimiçi kurslar düzenliyorlar., tamamlandı, metin, öncelik, süre, Yok ve
yapılmış. hariç her anahtar Yok varsayılan sırasını tersine çevirmek için - ön eki ile kullanılabilir ve
birden çok anahtar bir , ile ayrılmalıdır.

Birden çok --sort parametresiyle karşılaşılırsa, sonuncusu kullanılır. Bunun anlamı, bir
'sıralama' girişi ~/.todorc komut satırındaki herhangi biri tarafından geçersiz kılınacaktır.

ENDEKSLERİ

Dizinler, çeşitli komut satırı bağımsız değişkenleri için seçenekler olarak kullanılır. Çoklu not indeksleri
virgülle ayrılır (boşluklar değil izin verilmiş). Çocuklar bir '.' kullanılarak kapsamlandırılır.

Örneğin, aşağıdaki notlar verilmiştir:

1. Man sayfaları yapın
1. Onları daha güzel hale getirin.
2. HTML belgelerini de yapın.

İkinci alt öğe şu şekilde temsil edilecektir: 1.2

Joker karakter '*' bir düğümün tüm alt öğelerini temsil etmek için kullanılabilir. Örneğin. 1.*

Nota aralıkları ' - ' kullanılarak belirtilebilir . Örneğin, 10.1.2 notlarını işaretlemek için,
10.1.3 ve 10.3.4 yapıldığı gibi, şunları yapabilirsiniz: todo --done 10.1.2-4

RENK

Çeşitli öğeler renklendirilebilir. olabilecek öğeler çok yüksek, yüksek, orta, düşük, Çok düşük,
başlık ve bilgi. bilgi madde numaralarını ve genel bilgileri görüntülemek için kullanılır.

Bu öğeler sekiz renkten birine ayarlanabilir. Bu renkler siyah, kırmızı, yeşil,
Sarı, mavi, eflatun, mavi, beyaz ve varsayılan. Renk varsayılan belirtmek için kullanılır
varsayılan ön plan terminal rengi.

Renkler şu şekilde belirtilir:

=[+]

isteğe bağlı ise + Bu ifadede kullanılması maddenin kalınlaşmasına neden olacaktır.

Örneğin, bir satır ~/.todorc şöyle görünebilir:

renkli ortam=+beyaz

Hangisi yapardı orta metin pim beyaz.

TODORC

todo, bir dizi kaynak dosyadan seçenekleri yükleyebilir. Bunların ayrıştırıldığı sıra
aşağıdaki gibidir:

1. Ortam değişkeninde belirtilen dosya TODORC veya bu yoksa,
/etc/todorc.
2. ~/.todorc

Seçenekler, $TODORC'dan yüklenenlerin geçersiz kılınacağı veya
içinde olanlar ~/.todorc.

Bu seçenekler, her satıra bir tane olmak üzere anahtar/değer çiftleri olarak belirtilir.
komut satırı bağımsız değişkeni ve değer, varsa bu bağımsız değişkenin parametresidir. Ek olarak,
ortam değişkenleri genişletilir.

Örneğin, --filter komut satırı bağımsız değişkeni, filtre olan bir parametreyi kabul eder.
ifade. Varsayılan bir filtre eklenebilir ~/.todorc dosya şöyle:

# Varsayılan olarak alt öğeleri gösterme
filtre -çocuklar

rc dosyasında belirtilen seçeneklerle komut satırındaki seçenekler arasındaki tek fark
rc dosyasındaki seçeneklerin önüne -- gelmemiş olmasıdır.

Ek olarak, RC dosyasında mevcut olmayan iki komut vardır.
Komut satırı. Onlar:

İlk komut, on, koşullu olarak belirli komutları eklemek için kullanılır. Bunun formatı
komut: on [ ]. Geçerli olaylar eklemek, Kaldır, görünüm, düzenleme,
oluşturmak, yapılmış, bitmiş değil, başlık, ebeveyn, yük, kayıt etmek, Link, yaratmak ve tasfiye. çoklu
komutlar iletilebilir on parantez içine alarak (aralarında boşluk olması gerekir)
belirteçler). Aşağıdaki tam örnek.

İkinci komut ise exec <kabuk komut>. Bu komut, olduğu argümanı yürütecektir.
bir kabuk içinde verilir. ortam değişkeni $TODODB geçerli dosya adını içerir
veri tabanı. Örneğin. exec chmod 600 $TODODB

Kaynak dağıtımın doc alt dizininde örnek bir rc dosyası var.

ÖRNEKLER

Geçerli dizindeki bekleyen öğeleri görüntülemek için şunu yazmanız yeterlidir:

todo

Not 1, 2 ve 4'ü kaldırmak için:

yapılacaklar --kaldır 1,2,4

TÜM öğeleri görüntülemek için:

hepsini yapmak

Alt öğelerini değil, yalnızca üst düzey öğeleri görüntülemek için:

yapılacaklar -çocuklar

(buna rağmen -çocuk geçerli bir argüman değil, bu işe yarar çünkü todo herhangi bir şeyi yorumlar.
bir filtre ifadesinin parçası olarak tanımadığı komut satırı bağımsız değişkenleri)

Daha karmaşık bir örnek. Bu, üzerinde belirtilen öğenin metniyle birlikte yeni bir öğe ekler.
önceliği olan komut satırı yüksek ikinci öğenin üçüncü çocuğunun çocuğu olarak (eğer
bu herhangi bir anlam ifade ediyor):

todo -a "Man sayfasını düzelt" -p yüksek -g 2.3

Bu, yapılacaklar listesinin YAPILACAKLAR özelliğinin nasıl kullanılacağına bir örnektir. todo'nun yeni bir tane oluşturmasını sağlar
Veritabanında depolanan bilgilerden TODO dosyası. Bu özel örnek tüm çıktıları verir
Tamamlandı olarak işaretlenenler bile TODO dosyasına eklenir.

yapılacaklar -- hepsini filtrele -- YAPILACAKLAR

Bu örnek, olay tetikleyicilerinin güzel bir kullanımını gösterir. Yeni bir veritabanı oluşturulduğunda
izinlerini 0600'e zorlar.

yaratmada {
gereksiz sözlerle dolu
yürütme chmod 600 .todo
}

onworks.net hizmetlerini kullanarak devtodo'yu çevrimiçi kullanın