docbook-2-pdf - Bulutta Çevrimiçi

Program:

ADI

sgml2x — DSSSL stil sayfalarını kullanarak SGML/XML belgelerini kolayca biçimlendirir

SİNOPSİS

sgml2x [seçenekleri] [sgml dosyası | xml dosyası ]

belge sınıfı-2-hedef biçimi [seçenekleri] [sgml dosyası | xml dosyası ]

Açıklama

sgml2x DSSSL stil sayfalarını kullanarak bir SGML veya XML belgesini kolayca biçimlendirmeye olanak tanır ve
aşağıdaki özellikleri sağlar:

· Belge sınıfı başına birden çok olası stil sayfası

· Parametre desteği ile takma adlar kullanarak stil sayfalarının kolay belirtilmesi
miras

· Basit bir yeni tanım dosyası ekleyerek yeni stil sayfalarının kolay entegrasyonu
yapılandırma dizini

· Arayan, varsayılan olarak
sistem genelinde, kullanıcı başına ve proje başına yapılandırma dizinleri

· Kullanılacak varsayılan stil sayfasının atananlara göre otomatik seçimi
öncelikleri

· İsteğe bağlı seçenekleri iletin yeşim taşı(1)

Stil sayfalarını aramak için kullanılan belge sınıfı ve çıktı formatı şimdilik
sadece programın çağrıldığı addan türetilmiştir, bu yüzden bunu çağırmak isteyeceksiniz
gibi sembolik bağlantılar aracılığıyla programlayın belge-2-pdf.

sgml2x etrafında bir kabuk sarmalayıcı olarak uygulanır yeşim taşı(1) (veya tercihen, açık yeşim(1),
genel adını kullanmamıza rağmen yeşim taşı bu dokümantasyon boyunca), jadeteks(1) ve diğeri
araç sağlar.

Eğer yok ise jadetex.cfg belgenin yanındaki dosya, varsayılan bir kopyalanır, bu da etkinleştirir
PDF yer imlerinin üretimi.

Opsiyonlar

-c|--katalog katalog
Sistem varsayılanı yerine belirtilen SGML kataloğunu kullanın.

-C|--confdir'ler yön listesi
Yapılandırma dizinlerinin (boşlukla ayrılmış) listesini kullanın. Bu seçenek
kümülatif, yani birkaç tane kullanabilirsiniz -C seçenekler ve listeler
birleştirilmiş.

Liste öğeleri en genel konfigürasyondan (örn. sistem genelinde) sıralanmalıdır.
en spesifik olana kadar (örneğin proje çapında).

Bu seçenek aracılığıyla herhangi bir dizin sağlanırsa, varsayılan dizin listesi
görmezden geldi.

-D|--dssslproc dsssl işlemci
kullanım dsssl işlemci varsayılan yerine stil sayfasını uygulamak için. Bu
işlemci desteklemeli yeşim taşı-gibi seçenekler gibi -V.

Bu seçenek mevcut olmadığında, ilk bulunan dsslproc confdirs'den gelen dosyalar
alınmış. Görmek "Dosyalar" daha fazla ayrıntı için.

-h|--yardım et Bir yardım mesajı görüntüleyin ve çıkın.

-j|--yeşim dsssl işlemci
eskimiş eş anlamlısı --dssslproc.

--jadetexfiltre perl filtresi
Bir perl filtresi kullanarak jadetex çıktısını son işlemden geçirin.

Bu, stil sayfasının üstesinden gelmek için bazı belirli yerlerde sayfa sonlarını zorlamak için yararlı olabilir
sorunları veya TeX'in yeterli desene sahip olmadığı durumlarda tirelemeleri zorlamak veya
aklınıza gelebilecek diğer akıllı dönüşüm.

Bak örnekler/komut satırları olası kullanımlar için dosya.

-n|--hareketsiz
Komutları çalıştırmak yerine yazdırın. Daha düşük seviye hakkında bilgi edinmek için kullanışlıdır
araçlar ve komut satırında hata ayıklamak için.

-o|--açık yeşim
Bu seçenek is eski. açık yeşim artık kullanılabilir olduğunda varsayılandır. Kullanmak
--dssslproc ya da dsslproc Belirli bir işlemciyi zorlamak için yapılandırma dosyası.

Bu seçenek kullanılır açık yeşim(1) yerine bir DSSSL işlemcisi olarak yeşim taşı(1).

-O|-- jadeopts yeşim seçenekleri
Geçmek için ek seçenekler yeşim taşı(1). Bu seçenek birikimlidir, şunları yapabilirsiniz:
bunlardan birkaçını belirtin, sağlanan seçenekler birleştirilecektir.

-q|--sessizlik
Ayrıntıyı şuna ayarla: sessiz

-r|--Uyarılar
Belgedeki belge açıklamalarının içeriğini oluştur (düşünce içindeki elemanlar
BelgeKitap 4, yorum Yap DocBook 3)'teki öğeler, üretilen çıktıyı bir
sadece dahili kullanım belge, kapağa kalın bir uyarı yazdırın.

Bu, belge sınıfına ve stil sayfasına özgü bir özelliktir ve tüm stil sayfalarında kullanılmaz.
bu.

-s|--stil stil
(Sonunda belgeden türetilen) varsayılanı geçersiz kılmak için bir çıktı stili seçin.

Belirli bir belge sınıfı ve her çıktı biçimi için şu anda kullanılabilen stiller şunlardır:
konfigürasyon dizinlerinin içeriğine bağlıdır ve
--yardım et seçeneği.

Bu seçeneği bir derleme prosedüründe belirtmenin iyi bir uygulama olduğunu unutmayın;
mevcut stil sayfalarından bağımsız olarak tekrarlanabilir sonuçlar.

-v|--ayrıntılı
Ayrıntıyı artırın. Bu seçenek birden çok kez belirtilebilir.

--ayrıntılılık N
Ayrıntıyı şuna ayarla: N. Ayrıntı seviyeleri aşağıdaki gibi tanımlanır:

sessiz Yalnızca yazdırma hataları

varsayılan Yalnızca hataları ve uyarıları yazdırın

gereksiz sözlerle dolu Ayrıca bildirimleri yazdırın

iz Ayrıca önemli komutları çalıştırıldıkça yazdırın ( --hareketsiz ) Yapar.

ayıklamak Ayrıca hata ayıklama mesajlarını yazdır

-V|--versiyon
Program sürümünü yazdırın ve çıkın.

yapılandırma

sgml2x bir yapılandırma dosyası yerine bir yapılandırma dizini ağacı kullanır, böylece
mevcut bir kurulumu bozma riski düşük olan diğer paketlerin takılması kolaydır.

Stil hiyerarşileri adlı dizinlerde bulunur. stilleri her konfigürasyonda
dizin. Bu programın eski sürümleri, bu hiyerarşileri doğrudan
yapılandırma dizinleri.

Bir yapılandırma dizini, bilinen her belge sınıfı için şu şekilde adlandırılmış bir dizin içerir:
bir belge sınıfı takma adı (örn. belge kitabı). Bu docclass dizinleri bir alt-
çıktı formatının her sınıfı için dizin (şu anda yalnızca html ve baskı Desteklenmektedir).

Şu anda, uygulama sorunları, belge sınıfları için takma adlara bir sınırlama getiriyor
ve stil sayfaları: yalnızca alfasayısal ve alt çizgi karakterlerini içerebilirler. Bu
gelecekteki bir sürümde sınırlama kaldırılabilir, ancak bu bundan önce olmayacak
komut dosyası başka bir dilde yeniden yazılır.

Bu dizinlerin her biri, mevcut stil başına bir dosya içerir. Bu dosyaların adları
yalnızca alfanümerik karakterler içerebilir ve stiller için takma ad olarak kullanılır. Bu
dosya ile satırlar içeriyor anahtar: değer desen, şu anda aşağıdaki tuşlar
desteklenen:

Id Stil sayfası için genel tanımlayıcı

azalan Yardım mesajında ​​görüntülenecek stillerin kısa bir açıklaması

pdfGeçersiz kıl, psGeçersiz kıl,
rtfGeçersiz Kılma, mifGeçersiz Kılma" 10 Ayarlanacak baskı stil sayfasından bir dsssl sembolü
için #t (Ya da sembol=değer çifti, argüman olarak uygun yeşim taşı's -V seçenek),
verilen baskı formatı için kullanılacaktır.

Geçersiz kılma satırı başına yalnızca bir sembole izin verilir. Birkaç sembolün değerlerini tanımlamak için şunu kullanın:
birkaç satır.

Devralır Gereksiz yere düşmemek için bunun miras aldığı bir stil sayfasının takma adı
stil tanımlarının çoğaltılması.

Şu anda, bu yalnızca *geçersiz kıl parametreleri.

öncelik Yapılamadığında varsayılan stili seçmeye yardımcı olacak pozitif bir tam sayı
belgeden türetilmiştir. Daha yüksek değerler olarak alınma şansı daha yüksek olur
varsayılan. Hiper-uzmanlaşmış stiller için düşük öncelikler kullanmaya özen gösterin.
genel belge türü, böylece yanlışlıkla kullanılmaz.

Örneğin, DocBook stil sayfaları için şu anda önerilen politika aşağıdakilerden türetilmiştir:
Norman Walsh'ın durumu aşağıdaki gibidir (ve deneyim yetersiz olduğunu kanıtlarsa değişebilir).

10 Genellikle özelleştirilmesi gereken temel stil sayfaları.

0 Aşırı özel bir amaç için yazılmış herhangi bir stil sayfası (örn.
pazarlama ürün sayfası).

1000 Bir kuruluş tarafından üretilen tüm belgeler için varsayılan bir stil. Genellikle bir
hafif özelleştirme, düzen tercihlerini içeren, kuruluşun
logo veya benzeri şeyler.

10-100 Temel stil sayfalarının çeşitli genel özelleştirmeleri.

Öncelikli bir stil sayfasının geliştirilmiş bir sürümünü yazdığınızda n, Sen
genellikle daha yüksek bir öncelik seçmek ister.

dosyalar

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Yapılandırma dosyalarının bulunduğu varsayılan yapılandırma dizinleri
arandı. için belgelere bakın --confdir'ler daha fazla ayrıntı için.

onay/stil/
Kullanılabilir stilleri tanımlayan hiyerarşi. Görmek "Yapılandırma" Daha fazla bilgi için
detaylar.

onay/dssslproc
Aranacak dsssl işlemcilerinin sıralı bir listesini içeren, ile ayrılmış bir dosya
yeni satırlar ve/veya boşluk. a ile başlayan satırlar # karakter olarak kabul edilir
yorumlar Ortak değerler şunları içerir: açık yeşim ve yeşim taşı.

Burada belirtilen DSSSL işlemcileri aşağıdakileri kabul etmelidir: -V ve -D yeşim uyumlu
komut satırı seçenekleri.

Yapılandırma dizinleri, en spesifik olandan başlayarak aranır.
bir, böylece varsayılan confdirs ile proje ayarları kullanıcıyı geçersiz kılabilir
ayarlar, bu da sistem ayarlarını geçersiz kılabilir.

özel değer yanlış aramayı durdurmak ve içine bakmayı önlemek için kullanılabilir
daha genel dizinler. Örneğin, bir proje kullanmak zorundaysa
openjade-1.4devel komut ve başka değil, belirtebilir openjade-1.4devel yanlış
onun içinde dsslproc dosyası.

Uyarılar

Kullanırken openjade-1.4devel DSSSL işlemcisi olarak, en üstte bir şikayet göreceksiniz-
tarafından oluşturulan seviye akış nesnesi doctype.dslve belgenin otomatik olarak belirlenmesi-
türü başarısız olur. Bu hata aksi takdirde zararsızdır. Bununla nasıl başa çıkılacağına dair fikirler veya
doğrulama openjade-1.4devel çok katı, takdir edilecektir :)

The gelecek

Gelecekteki sürümler için planlanan özellikler şunları içerir:

· İndeks oluşturucunun entegrasyonu

· Kod örnekleri için güzel bir baskı motorunun entegrasyonu

· Zincirleme yapılacak dönüşümlerin belirtilmesi

· Stilin herhangi bir belge sınıfıyla kullanılmasına izin vermek için alt küme belge sınıflarının beyanı-
üst küme belge sınıfları için geçerli olan sayfalar.

· Çalışma dizinini kirletmemek için geçici bir yerde çalışın.
geçici dosyalar. Bu göründüğü kadar kolay değil çünkü bir belgeyi bozuyor
göreli yolları kullanan görüntü dosyalarını ifade eder. Bu bir yeşim böceği olarak görülebilir,
Ancak.

Tüm YAPILACAKLAR listesine göz atın ve bize daha fazla fikir gönderin!

telif hakkı

Telif Hakkı © 2001-2003 Alcove & Yann Dirson.

sgml2x GNU Genel Kamu Lisansı, sürüm 2 altında lisanslanmıştır.

Bu belge, GNU Özgür Belgeleme Lisansı, sürüm 1 kapsamında lisanslanmıştır.

İletişim us

sgml2x parçasıdır Oyuk Kitap proje (bağlantı için URL http://www.alcove-
labs.org/en/software/alcovebook/) . Lütfen kullanın Oyuk Kitap postalama listeler (bağlantı için URL
https://savannah.gnu.org/mail/?group_id=533) geliştiriciler ve kullanıcılar ile iletişim kurmak için.

Hataların ve özellik isteklerinin listesi mevcuttur içinden a ağ arayüzey (bağlantı için URL
https://savannah.gnu.org/support/?group_id=533) . Lütfen sorunları göndermek için kullanın ve
fikirler.

Yerimizi Ayrıca

açık yeşim(1), yeşim taşı(1), jadeteks(1), harmanlamaindex.pl(1).

sgml2x(1)

Onworks.net hizmetlerini kullanarak docbook-2-pdf'yi çevrimiçi kullanın