xmlcatalog(1) · macOS Kılavuz Sayfası

XML veya SGML katalog dosyalarını ayrıştırmak (parse) ve bunlar üzerinde işlem yapmak için komut satırı aracı.

Özet

       xmlcatalog [--sgml | --shell | --create | --del VALUE(S) |
		  [ --add TYPE ORIG REPLACE  | --add FILENAME] | --noout | --no-super-update |
		  [-v | --verbose]] {CATALOGFILE} {ENTITIES...}

Açıklama

xmlcatalog, kullanıcıların XML ve SGML kataloglarını izlemelerine ve bunlar üzerinde işlem yapmalarına olanak tanıyan bir komut satırı uygulamasıdır. libxml(3) kütüphanesine dahildir.

Fonksiyonları komut satırından tek bir komutla çağrılabileceği gibi, etkileşimli modda birden fazla fonksiyonu da yerine getirebilir. Hem XML hem de SGML dosyaları üzerinde çalışabilir.

Seçenekler

xmlcatalog aşağıdaki seçenekleri kabul eder (alfabetik sırayla):

--add TYPE ORIG REPLACE CATALOGFILE dosyasına bir girdi ekler. TYPE, girdinin türünü belirtir. Olası türler: public, system, uri, rewriteSystem, rewriteURI, delegatePublic, delegateSystem, delegateURI, nextCatalog. ORIG, değiştirilecek orijinal referanstır ve REPLACE, kullanılacak yeni varlığın (replacement entity) URI'sidir. --noout seçeneği kullanılmadığı sürece --add seçeneği CATALOGFILE dosyasının üzerine yazmaz, çıktıyı standart çıktıya (stdout) verir. Bazı XML kataloğu yapıları yalnızca tek bir argümana sahip olsa bile, --add her zaman üç parametre alır.

--add FILENAME Eğer --add seçeneği --sgml seçeneğinden sonra kullanılırsa, yalnızca tek bir argüman, bir FILENAME (dosya adı) kullanılır. Bu, bir SGML süper kataloğuna (diğer dahil edilen SGML katalog dosyalarına referanslar içeren bir dosya) bir katalog dosyasının adını eklemek için kullanılır.

--create Yeni bir XML kataloğu oluşturur. --noout seçeneği kullanılmadığı sürece dosya adını yok sayarak çıktıyı standart çıktıya (stdout) verir; bu seçenek kullanıldığında ise belirtilen filename adıyla yeni bir katalog dosyası oluşturur.

--del DEĞER(LER) CATALOGFILE içinden DEĞER(LER) ile eşleşen girdileri kaldırır. --noout seçeneği kullanılmadığı sürece --del seçeneği CATALOGFILE dosyasının üzerine yazmaz, çıktıyı standart çıktıya (stdout) verir.

--noout Çıktıyı standart çıktıya (stdout) vermek yerine belirtilen dosyaya kaydeder.

--no-super-update SGML süper kataloğunu güncellemez.

--shell CATALOGFILE katalog dosyası üzerinde etkileşimli sorgulara izin veren bir kabuk (shell) çalıştırır. Kullanılabilir komut kümesi için “KABUK KOMUTLARI” adlı bölüme bakın.

--sgml --add ve --del seçenekleri için SGML süper kataloglarını kullanır.

-v, --verbose Hata ayıklama bilgilerini yazdırır.

xmlcatalog'un belirlenmiş bir eylem (örneğin --add seçeneği gibi) olmadan etkileşimsiz olarak çağrılması, CATALOGFILE ile belirtilen katalogdaki ENTITIES için katalog girdisinin aranmasıyla sonuçlanacaktır. Karşılık gelen girdiler komut satırına çıktı olarak verilecektir. Bu çalışma modu; --shell modu ve değişiklik yapmayan (yani --noout içermeyen) doğrudan eylemlerle birlikte, varsayılan sistem kataloğunu atayan boş CATALOGFILE tanımlaması (kabuk ortamında muhtemelen "" olarak ifade edilir) için özel bir kısayol sağlar. Bu durum, kataloğun tam konumunun önemsiz olduğu ancak ilgili yerleşik (built-in) kataloğa yine de başvurulması gerektiği durumlarda işlemi kolaylaştırır.

Kabuk Komutları

xmlcatalog'u --shell CATALOGFILE seçeneğiyle çağırmak, CATALOGFILE ile tanımlanan katalog dosyasına etkileşimli erişim sağlayan bir komut satırı kabuğu açar. Kabuğun çağrılması, ardından aşağıdaki komutların (alfabetik sırayla açıklanmıştır) girilebileceği bir komut satırı istemi (prompt) sağlar.

add TYPE ORIG REPLACE Katalog dosyasına bir girdi ekler. TYPE, girdinin türünü belirtir. Olası türler: public, system, uri, rewriteSystem, rewriteURI, delegatePublic, delegateSystem, delegateURI, nextCatalog. ORIG, değiştirilecek orijinal referanstır ve REPLACE, kullanılacak yeni varlığın (replacement entity) URI'sidir. --noout seçeneği kullanılmadığı sürece --add seçeneği CATALOGFILE dosyasının üzerine yazmaz, çıktıyı standart çıktıya (stdout) verir. Bazı XML kataloğu yapıları yalnızca tek bir argümana sahip olsa bile, --add her zaman üç parametre alır.

debug xmlcatalog'un yürüttüğü adımları gösteren hata ayıklama ifadelerini yazdırır.

del DEĞER(LER) DEĞER(LER) ile eşleşen katalog girdisini kaldırır.

dump Mevcut kataloğu yazdırır.

exit Kabuktan çıkar.

public PUBLIC-ID PUBLIC-ID için katalog girdisinin Formal Public Identifier aramasını gerçekleştirir. Karşılık gelen girdi komut satırına çıktı olarak verilecektir.

quiet Hata ayıklama ifadelerinin yazdırılmasını durdurur.

system SYSTEM-ID SYSTEM-ID için katalog girdisinin Formal Public Identifier aramasını gerçekleştirir. Karşılık gelen girdi komut satırına çıktı olarak verilecektir.

Ortam Değişkenleri

XML_CATALOG_FILES XML katalog davranışı, sorgular kullanıcının kendi katalog kümesine yönlendirilerek değiştirilebilir. Bu, XML_CATALOG_FILES ortam değişkeni boşlukla ayrılmış bir katalog listesine ayarlanarak yapılabilir. Boşlukları veya diğer karakterleri etkisizleştirmek (escape) için yüzde kodlaması (percent-encoding) kullanın. Boş bir değişken, varsayılan /etc/xml/catalog kataloğunun yüklenmesini devre dışı bırakmalıdır.

Teşhis

xmlcatalog dönüş kodları, betiklerden çağrıldığında kullanılabilecek bilgiler sağlar.

0 Hata yok

1 Katalogdan bir girdi kaldırılamadı

2 Kataloğa kaydedilemedi, dosya izinlerini kontrol edin

3 Kataloğa bir girdi eklenemedi

4 Katalogda bir girdi aranamadı

Ayrıca Bakınız

libxml(3)

Daha fazla bilgi şu adreslerde bulunabilir:

• libxml(3) web sayfası https://gitlab.gnome.org/GNOME/libxml2

• libxml(3) katalog desteği web sayfası: https://gitlab.gnome.org/GNOME/libxml2/-/wikis/Catalog-support

• James Clark'ın SGML katalog sayfası http://www.jclark.com/sp/catalog.htm

• OASIS XML katalog belirtimi http://www.oasis-open.org/committees/entity/spec.html

Yazar

John Fleck jfleck@inkstain.net Yazar.

Telif Hakkı

libxml2 19/02/2022 XMLCATALOG(1)