Söz Dizimi
textutil [komut_seçeneği] [diğer_seçenekler] dosya ...
Açıklama
textutil, Cocoa metin sistemi tarafından sağlanan mekanizmaları kullanarak çeşitli formatlardaki metin dosyalarını işlemek için kullanılabilir.
İlk bağımsız değişken gerçekleştirilecek işlemi belirtir, şunlardan biridir:
-help: Komut için kullanım bilgilerini gösterir ve çıkış yapar. Herhangi bir seçenek belirtilmediğinde varsayılan komut seçeneğidir.-info: Belirtilen dosyalar hakkında bilgi görüntüler.-convert fmt: Belirtilen dosyaları gösterilen formata dönüştürür ve her birini dosya sistemine geri yazar.-cat fmt: Belirtilen dosyaları okur, bunları birleştirir ve sonucu gösterilen formatta tek bir dosya olarak yazar.
fmt şunlardan biridir: txt, html, rtf, rtfd, doc, docx, wordml, odt veya webarchive
Genel kullanım için bazı ek seçenekler mevcuttur:
-extension ext: Çıktı dosyaları için kullanılacak bir uzantı belirtir (varsayılan olarak uzantı, formata göre belirlenir).-output path: İlk çıktı dosyası için kullanılacak dosya adını belirtir.-stdin: Girdinin dosyalar yerine standart girdiden (stdin) okunması gerektiğini belirtir.-stdout: İlk çıktı dosyasının standart çıktıya (stdout) gönderilmesi gerektiğini belirtir.
-encoding IANA_adı | NSStringEncoding Düz metin veya HTML çıktı dosyaları için kullanılacak kodlamayı belirtir (varsayılan olarak çıktı kodlaması UTF-8 olacaktır). NSStringEncoding, NSString tarafından tanınan sayısal değerlerden birini ifade eder. IANA_adı, CFString tarafından anlaşılan bir IANA karakter kümesi adına karşılık gelir. Dosya belirtilen kodlamaya dönüştürülemezse işlem başarısız olur.
-inputencoding IANA_adı | NSStringEncoding Tüm düz metin girdi dosyalarının belirtilen kodlama kullanılarak yorumlanmasını zorunlu kılar (varsayılan olarak bir dosyanın kodlaması BOM'undan belirlenir). Dosya belirtilen kodlama kullanılarak yorumlanamazsa işlem başarısız olur.
-format fmt: Tüm girdi dosyalarının gösterilen format kullanılarak yorumlanmasını zorunlu kılar (varsayılan olarak bir dosyanın formatı içeriğinden belirlenir).-font font: Düz metni zengin metne dönüştürmek için kullanılacak yazı tipinin adını belirtir.-fontsize size: Düz metni zengin metne dönüştürmek için kullanılacak yazı tipinin punto cinsinden boyutunu belirtir.--: Bundan sonraki tüm bağımsız değişkenlerin dosya adları olduğunu belirtir.
HTML ve WebArchive dosyaları için bazı ek seçenekler mevcuttur:
-noload: Yardımcı kaynakları yüklemez.-nostore: Yardımcı kaynakları yazmaz.-baseurl url: Göreceli URL'ler için kullanılacak bir temel URL belirtir.-timeout t: Kaynakların yüklenmesini beklemek için saniye cinsinden süreyi belirtir.
-textsizemultiplier x Yazı tipi boyutlarının çarpılacağı sayısal bir katsayı belirtir.
-excludedelements (tag1, tag2, ...) Üretilen HTML'de hangi HTML öğelerinin kullanılmaması gerektiğini belirtir (liste tek bir bağımsız değişken olmalıdır, bu nedenle genellikle kabuk ortamında tırnak içine alınması gerekecektir).
-prefixspaces n: Üretilen HTML'de iç içe geçmiş öğeleri girintilemek için kullanılacak boşluk sayısını belirtir (varsayılan değer 2'dir).
Meta verileri işlemek için bazı ek seçenekler mevcuttur:
-strip: Girdi dosyalarındaki meta verileri çıktı dosyalarına kopyalamaz.-title val: Çıktı dosyaları için başlık meta veri özniteliğini belirtir.-author val: Çıktı dosyaları için yazar meta veri özniteliğini belirtir.-subject val: Çıktı dosyaları için konu meta veri özniteliğini belirtir.
-keywords (val1, val2, ...) Çıktı dosyaları için anahtar kelimeler meta veri özniteliğini belirtir (liste tek bir bağımsız değişken olmalıdır, bu nedenle genellikle kabuk ortamında tırnak içine alınması gerekecektir).
-comment val: Çıktı dosyaları için yorum meta veri özniteliğini belirtir.-editor val: Çıktı dosyaları için düzenleyici meta veri özniteliğini belirtir.-company val: Çıktı dosyaları için şirket meta veri özniteliğini belirtir.
-creationtime yyyy-mm-ddThh:mm:ssZ Çıktı dosyaları için oluşturma zamanı meta veri özniteliğini belirtir.
-modificationtime yyyy-mm-ddThh:mm:ssZ Çıktı dosyaları için değiştirme zamanı meta veri özniteliğini belirtir.
Örnekler
textutil -info foo.rtf
foo.rtf hakkında bilgi görüntüler.
textutil -convert html foo.rtf
foo.rtf dosyasını foo.html dosyasına dönüştürür.
textutil -convert rtf -font Times -fontsize 10 foo.txt
yazı tipi olarak Times 10 kullanarak foo.txt dosyasını foo.rtf dosyasına dönüştürür.
textutil -cat html -title "Several Files" -output index.html *.rtf
geçerli dizindeki tüm RTF dosyalarını yükler, içeriklerini birleştirir ve sonucu,
HTML başlığı "Several Files" olarak ayarlanmış şekilde index.html olarak yazar.
Tanılama
textutil komutu başarı durumunda 0, başarısızlık durumunda 1 değeriyle çıkış yapar.
Uyarılar
Bazı seçenekler pencere sunucusuna (window server) bağlantı gerektirebilir.
Geçmiş
textutil komutu ilk olarak Mac OS X 10.4 sürümünde görünmüştür.