$ tidy

Özet

       tidy [seçenek ...] [dosya ...] [seçenek ...] [dosya ...]

Açıklama

Tidy; HTML, XHTML ve XML dosyalarını okur ve temizlenmiş işaretlemeler yazar. HTML varyantları için birçok yaygın kodlama hatasını tespit edip düzeltir; hem W3C uyumlu hem de çoğu tarayıcıda çalışan, görsel olarak eş değer işaretlemeler üretmeye çabalar. Tidy'nin yaygın bir kullanımı, düz HTML'i XHTML'e dönüştürmektir. Genel XML dosyaları için Tidy, yalnızca temel biçimsel uygunluk (well-formedness) hatalarını düzeltmekle ve okunabilir şekilde biçimlendirmekle (pretty printing) sınırlıdır.

Herhangi bir işaretleme dosyası belirtilmezse, Tidy standart girdiyi (standard input) okur. Bir çıktı dosyası belirtilmezse, Tidy işaretlemeyi standart çıktıya (standard output) yazar. Herhangi bir hata dosyası belirtilmezse, Tidy mesajları standart hataya (standard error) yazar.

Seçenekler

İşleme yönergeleri

• -indent veya -i: öğe içeriğini girintilemek için

• -omit: isteğe bağlı bitiş etiketlerini atlamak için

-wrap <sütun> metni belirtilen <sütun> genişliğinde sarmak için (varsayılan 68'dir)

• -upper veya -u: etiketleri büyük harfe zorlamak için (varsayılan küçük harftir)

• -clean veya -c: FONT, NOBR ve CENTER etiketlerini CSS ile değiştirmek için

• -bare veya -b: akıllı tırnakları (smart quotes) ve uzun tireleri (em dashes) vb. temizlemek için

-numeric veya -n adlandırılmış varlıklar (entities) yerine sayısal varlıklar çıktılamak için

• -errors veya -e: yalnızca hataları göstermek için

• -quiet veya -q: zorunlu olmayan çıktıları gizlemek için

• -xml: girdinin düzgün biçimlendirilmiş (well-formed) XML olduğunu belirtmek için

• -asxml: HTML'i düzgün biçimlendirilmiş XHTML'e dönüştürmek için

• -asxhtml: HTML'i düzgün biçimlendirilmiş XHTML'e dönüştürmek için

• -ashtml: XHTML'i düzgün biçimlendirilmiş HTML'e zorlamak için

-access ek erişilebilirlik kontrolleri yapmak için ( = 1, 2, 3)

Karakter kodlamaları

• -raw: 127'nin üzerindeki değerleri varlıklara (entities) dönüştürmeden çıktılamak için

• -ascii: çıktı için US-ASCII, girdi için ISO-8859-1 kullanmak için

• -latin1: hem girdi hem de çıktı için ISO-8859-1 kullanmak için

• -iso2022: hem girdi hem de çıktı için ISO-2022 kullanmak için

• -utf8: hem girdi hem de çıktı için UTF-8 kullanmak için

• -mac: girdi için MacRoman, çıktı için US-ASCII kullanmak için

• -utf16le: hem girdi hem de çıktı için UTF-16LE kullanmak için

• -utf16be: hem girdi hem de çıktı için UTF-16BE kullanmak için

• -utf16: hem girdi hem de çıktı için UTF-16 kullanmak için

• -win1252: girdi için Windows-1252, çıktı için US-ASCII kullanmak için

• -big5: hem girdi hem de çıktı için Big5 kullanmak için

• -shiftjis: hem girdi hem de çıktı için Shift_JIS kullanmak için

-language iki harfli dil kodunu olarak ayarlamak için (gelecekteki kullanım için)

Dosya işlemleri

-output veya -o çıktıyı belirtilen içerisine yazmak için

• -f <dosya>: hataları belirtilen içerisine yazmak için

-config yapılandırma seçeneklerini belirtilen üzerinden ayarlamak için

• -modify veya -m: orijinal girdi dosyalarını değiştirmek için

Çeşitli

-version veya -v Tidy sürümünü göstermek için

-help, -h veya -? komut satırı seçeneklerini listelemek için

• -help-config: tüm yapılandırma seçeneklerini listelemek için

• -show-config: mevcut yapılandırma ayarlarını listelemek için

Kullanım

"blah" yapılandırma seçeneği ve "blarg" argümanı için --blah blarg kullanın

Girdi/Çıktı varsayılan olarak sırasıyla stdin/stdout şeklindedir. -f ve -o haricindeki tek harfli seçenekler şu şekilde birleştirilebilir: tidy -f errs.txt -imu foo.html. HTML hakkında daha fazla bilgi için bkz. http://www.w3.org/MarkUp

HTML Tidy hakkında daha fazla bilgi edinmek için http://tidy.sourceforge.net adresindeki proje ana sayfasını ziyaret edin. Burada belgelere, e-posta listelerine (arama yapılabilir arşivleriyle birlikte) ve hata bildiriminde bulunabileceğiniz bağlantılara ulaşabilirsiniz.

Ortam Değişkenleri

HTML_TIDY Varsayılan yapılandırma dosyasının adı. Tidy'yi muhtemelen farklı dizinlerden çağıracağınız için bu mutlak bir yol olmalıdır. HTML_TIDY değeri, derleme sırasında tanımlanan varsayılan değerden (-DCONFIG_FILE ile tanımlanan) sonra, ancak -config kullanılarak belirtilen herhangi bir dosyadan önce çözümlenecektir.

Çıkış Durumu

0 Tüm girdi dosyaları başarıyla işlendi.

1 Uyarılar oluştu.

2 Hatalar oluştu.

Ayrıca Bakınız

http://tidy.sourceforge.net adresindeki HTML Tidy Proje Sayfası

Dave Raggett'ın http://www.w3.org/People/Raggett/tidy/ adresindeki Tidy Genel Bakışı

http://tidy.sourceforge.net/docs/quickref.html adresindeki Tidy Hızlı Başvuru Kılavuzu

TidyLib hakkında bilgi edinmek için bkz. http://tidy.sourceforge.net/libintro.html

Yazarlar

Dave Raggett dsr@w3.org.

Terry Teague terry_teague@users.sourceforge.net.

Bjoern Hoehrmann bjoern@hoehrmann.de

Charles Reitzel creitzel@rcn.com

Bu kılavuz sayfası Matej Vela vela@debian.org tarafından yazılmış ve Charles Reitzel tarafından güncellenmiştir.