stx2any - Bulutta Çevrimiçi

Program:

ADI

stx2any - yapılandırılmış metinden çoklu formatlara dönüştürücü

SİNOPSİS

stx2any [ -T biçim ] [ stx ve m4 seçenekleri ] [ dosya dosya ... ]

AÇIKLAMA

stx2any, yapılandırılmış metin (Stx) formatındaki dosyaları diğer formatlara dönüştürür. Formatlar
şu anda uygulananlar HTML, man, ham metin, PostScript, LaTeX, XHTML ve DocBook XML'dir.

Kaynak formatı olan yapılandırılmış metin, standart işaretlemeye sahip bir tür düz metin formatıdır.
başlıkları, listeleri, vurguyu vb. temsil etmek için. İşaretlemenin hem yazılması daha hızlı hem de daha hızlıdır.
hatırlanması geleneksel etiket tabanlı işaretleme dillerine göre daha kolaydır ve güzel bir şekilde
kaynak biçiminde de okunabilir. Stx işaretlemesi şurada daha iyi açıklanmıştır: Stx şipşak rehberlik, Hangi
örnekler dizininde mevcuttur.

Dönüşümün çoğu m4'te gerçekleşir ve kendi makrolarınızı ve diğer öğelerinizi tanımlayabilirsiniz.
Belgelerinize yapı kazandırmak için. stx2any, LaTeX benzeri bir genişletilebilirlik sağlar
çevre sistemi ve girdiyi yeniden düzenlemek için bir yönlendirme sistemi. (Tårta på tårta, onlar gibi
İsveççe diyelim.)

Stx2any girdi üzerinde herhangi bir türde alıntı yapmadığından, işaretleme bu şekilde yapılmaz.
mevcut olan metinler doğrudan hedef dilde yazılabilir (dönüştürülebilirliği kaybolur)
birden fazla dil). Bu şekilde, yalnızca bir çıktı biçimiyle ilgileniyorsanız (örn.
LaTeX), Stx'i en yaygın yapılar için kısaltma formatı olarak kullanabilirsiniz.

Bazı biçimlendirmeler kısaltma olarak değil, m4 makroları çağrılarak kullanılabilir. ihtiyacın var
makrolar nispeten nadiren bulunur: örneğin, yüzer (ortalıkta "yüzebilen" malzeme)
belge) makrolar tarafından oluşturulur.

SEÇENEKLER

stx2any, m4'ün tüm komut satırı seçeneklerini kabul eder ve bunları doğrudan aktarır. Bunlardan,
-D argümanı burada ayrıca değinilecek kadar önemlidir.

-DNAME=DEĞER
NAME makrosunu VALUE genişletmesine sahip olacak şekilde tanımlayın. Bu geçmenizi sağlar
bilgileri komut satırından belgeye aktarabilirsiniz.

-T biçim
Çıkış formatını ayarlar. Varsayılan format html'dir. biçim şunlardan biri olmalıdır:

html, temel HTML (köprü metni biçimlendirme dili) çıktısı üretir.

man, man makro çıktısı üretir. Bu çıktı doğrudan kılavuz sayfası olarak kullanılabilir
(aşağıdaki MAN SAYFALARININ YAZILMASI konusuna bakın) veya troff / groff'a beslenebilir
örneğin postscript'e biçimlendirme.

lateks, LaTeX belge hazırlama dili çıktısı üretir. Lateksi çalıştırabilirsiniz
sonuç, örneğin yüksek kaliteli pdf'ler üretmektir.

text, HTML çıktısını w3m ile sonradan işleyerek ham metin çıktısı üretir.
ortaya çıkan çıktı, çoğu Stx işaretlemesinin kaldırılması gibi çok basittir; Eğer sen
Daha formatlanmış bir çıktı istiyorsanız, man çıktısını nroff -man'a aktarmayı düşünün.

ps, man çıktısını groff ile son işleme tabi tutarak basit postscript çıktısı üretir.
Gerçek yayıncılık yapmak istiyorsanız bunun yerine LaTeX biçimini düşünün.

xhtml, HTML çıktısını W3C düzenli olarak sonradan işleyerek XHTML çıktısı üretir. Tarafından
yol, kontrol et http://hixie.ch/advocacy/xhtml HTML hakkında tartışmak için ve
XHTML.

belge-xml
ilkel DocBook XML çıktısı üretir. Daha fazla tartışma için aşağıdaki HATALAR'a bakın
bunun hakkında.

--link-kısaltmalar
Bağlantı kısaltma sözdizimini kullanın. Bağlantı kısaltması nedeniyle bunu unutmayın
İşleme iki aşamada gerçekleşir, girdi geldiğinde tamamen çalışmaz.
standart girişten (örneğin stx2any'yi bir girişin orta kısmı olarak kullanırsanız)
boru hattı).

--alıntı
Karakterlerin (alt çizgi ve dolar işaretleri dışında) alıntılanmasını isteyin
istenen çıktı formatında bir şekilde büyülü. Bu onu oldukça rahatlatacak
Çıkış formatındaki işaretlemeyi doğrudan belgenize koymak zordur, ancak
belgenizin doğru olma olasılığını büyük ölçüde artırır (ör.
çıktı formatında sözdizimi hataları yok).

--alıntı-bana-daha sert
Alt çizgi ve dolar işaretlerinden alıntı yapılmasını isteyin. Bu biraz LaTeX yapabilir
belgeler çalışır ancak alt çizgilerin kullanıldığı bazı belgeler bozulabilir
makro tanımlarında makro adları veya dolar işaretleri.

--numaralandırma { açık | kapalı }
Bölüm başlıklarının numaralandırılmasını isteyin. Varsayılan, çıktı formatına göre değişir:
bölüm numaralandırma varsayılan olarak HTML, DocBook XML ve man için kapalıdır, LaTeX için açıktır.

--içindekiler-tablosu { on | kapalı }
Başlıklardan içindekiler tablosu oluşturulmasını isteyin. Varsayılan şudur:
numaralandırma açıkken bir TOC üretir. DocBook XML için uygulanmadı.

--make-title { açık | kapalı }
Bir “başlık sayfası” isteyin. Varsayılan "açık"tır. Bu ayarın herhangi bir özelliği yok
bazı formatlarda efekt. HTML'de, başında büyük bir başlık oluşturur.
döküman. LaTeX'te kanonik maketitle'ı üretir.

--şablon yok
Hiçbir şekilde belge şablonu oluşturmayın, yalnızca biçimlendirilmiş giriş metnini oluşturun. Sen
belgeniz daha büyük bir belgenin parçası olarak eklenecekse muhtemelen buna ihtiyacınız olacaktır.
belge. Ancak bu daha büyük belge tamamen Stx ile yazılmışsa,
tüm kaynak dosyalarını doğrudan stx2any'ye argüman olarak vermek daha temiz olacaktır.
daha sonra sonuçları birleştirmek yerine.

--simetrik-çapraz referanslar
Bağlamayı destekleyen belge formatlarında (HTML, DocBook), ters bağlantılar oluşturun
etiketlerden yönlendirenlere ve yönlendirenlerden etiketlere olan bağlantılara kadar.

--lateks-paramlar params
LaTeX belgeleri için belge sınıfı parametrelerini ayarlayın. Varsayılan etkilenir
sistem kağıt boyutuna göre; örneğin, bir Avrupa sisteminde tipik olarak
a4paper,başlık sayfası yok. (Aşağıdaki “ÇEVRE” bölümüne bakın.)

--html-params params
HTML belgeleri için gövde etiketi parametrelerini ayarlayın. Varsayılan hiçbir parametre değildir.

--resim-son eki sonek
Satır içi görseller sonek içeren dosyalara atıfta bulunur sonek. Varsayılan, png'dir
HTML ve DocBook, LaTeX ve insan için eps.

--emdash-ayrı yok
Çıktıda, uzun tireleri bitişik metinden boşluklarla ayırmayın. Bu
Geleneksel İngiliz tipografisine uygun olarak (eğer doğru anladıysam), ancak
ana dilim olan Fince de dahil olmak üzere diğer birçok dilde standart değildir.

--daha güvenli
M4'ün bazı güvenli olmayan özelliklerini devre dışı bırakın ve bazı komut satırı argümanlarını kontrol edin.
sorunlu karakterler için kabuğa aktarılır. Bu arzu edilebilirse
Belgeyi başka bir yerden aldınız ve almayacağından emin olmak istiyorsunuz.
dönüştürüldüğünde kötü amaçlı herhangi bir şey yapın. Şu anda bu, kabuğun yürütülmesini reddediyor
kaçar.

Açıkça hiçbir m4 uygulamasının güvenlikle tasarlanmadığını unutmayın.
akıl. Sonuç olarak, bu seçenek potansiyel olarak zararlı olan her şeyi engelleyemez.
şey. İçeriğinin dahil olduğunu bildiğim, engellenmeyen şeyler
çıktıda rastgele dosyalar ve meşgul döngüleri yazma (böylece dönüşüm
sonlandırılana kadar alabileceği tüm işlemci süresini kullanacaktır).

--sed-önişlemci komut dosyası adı
Sed betiğini çalıştır komut dosyası adı tüm girişler için. Bu, özel eklemenizi sağlar
kısaltma işaretlemeleri. Sed ile girişin ön işlenmesiyle hemen hemen aynıdır,
daha sonra onu stx2any'ye aktarır, ancak --link-abbrevs ile daha iyi etkileşime girer (bkz.
ayrıntılar için açıklama).

--versiyon, -V
Sadece sürüm bilgilerini göster ve çık.

--Yardım, -?
Sadece kısa bir yardım mesajı gösterin ve çıkın.

YAZI MAN SAYFALAR

Temel olarak man sayfaları man makro formatındaki dosyalardır. Ancak bazıları var
Kılavuz sayfalarının bazı bölümlerinin belirli bir biçimde olmasını gerektiren programlar (öncelikle mandb)
biçimindedir ve man sayfaları genellikle standart bölümleme ve forma uygun olmalıdır (bkz.
(1) ve ayrıntılar için lexgrog (1).

Bir man sayfası yazarken sayfanın başlığı (w_title) şu şekilde olmalıdır:
program/dosya/format/yardımcı program adını ve bölümü (w_section) tanımlamanız gerekir. Yapmak
mandb ayrıştırmaya uygun sayfa, sayfayı bir veya daha fazla çağrıyla başlatmalısınız.
w_man_desc. Bu sizin için uygun bir “NAME” bölümü oluşturacaktır. (Gerçi yazabilirsiniz
tek başına.)

TANI

stx2any, örneğin hatalı biçimlendirilmiş bir girişte (bir makro) m4'ün verebileceği herhangi bir hata mesajı verebilir.
kapanış parantezinin eksik olduğu çağrı vb.). Ayrıca aşağıdaki kendi hatası var
mesajları:

bilinmeyen çıktı formatı: “X”
Desteklenmeyen çıktı biçimi talep ettiniz X -T seçeneğiyle.

bilinmeyen makro “X” çağrıldı
stx2any w_ ile başlayan bir makroyla karşılaştı ancak bunun tanımını bilmiyor.
Bu bir hata değil, bir uyarıdır; rahatsız edici makro ve onun argümanları
çıktıdan çıkarıldı.

N katmanında “Y” tarafından kapatılan “X” ortamı
Stx2any'deki ortamlar düzgün bir şekilde iç içe yerleştirilmelidir. stx2any w_end ile karşılaştı(Y)
w_end'i beklerken(X). Bu genellikle unutulmuş bir w_end('in işaretidir)X).

If N (katman) 0'dan farklı bir değerse sorun muhtemelen sizdedir
ortam tanımları, stx2any'nin işlediği noktada değil
hatayla karşılaştı.

bilinmeyen ortam “X”
Adı stx2any tarafından bilinmeyen bir ortam başlatılmaya çalışıldı,
yani böyle bir ortam tanımlanmamıştır.

"X" yönlendirmesi "Y" tarafından kapatıldı

bilinmeyen yönlendirme “X”
Yukarıdakiyle aynı, ancak yönlendirmeler için (w_begdiv ve w_enddiv).

Güvenli ortamda “X” kullanmaya çalışın
--more-secure ile güvenli işlem talebinde bulundunuz ve belgede bir
“güvensiz” makro. Bu bir hata değil, bir uyarı mesajıdır; buna neden olan makro
metinde aynen bırakılmıştır.

“X”e bilinmeyen çapraz bağlantı
Belgeye çapraz bağlantı vardı X, ancak stx2any'nin böyle bir şeyden haberi yok
belge. Muhtemelen /X/'in verilerini toplama_stx_titles ile toplamadınız ya da
belge referansını yanlış yazmışsınız. Bu bir hata değil, bir uyarıdır;
referans herhangi bir bağlantı olmadan çıktıda aynen bırakılır.

Başarı durumunda stx2any'nin dönüş değeri sıfırdır, bir sorun varsa birdir.

ÇEVRE

KAĞITKONF

KAĞIT BOYUTU
LaTeX belgeleri için varsayılan kağıt boyutunu belirlemek için kullanılır.

Onworks.net hizmetlerini kullanarak stx2any'yi çevrimiçi kullanın