Çapraz referanslar

LaTeXMKOPTSMakefile dosyasını kullanarak LaTeXMK seçeneklerine erişim sağlayabilirsiniz. Bunu, `make all-pdf` komutuyla yapabilirsiniz. İki işlemi tek bir işlemde birleştirmek için, panel kaynaklarınızda `sphinx-build -M` (örneğin `-M latexpdf`, `-b latexpdf` değil) veya `make latexpdf` komutunu kullanın. PDF dosyaları bu çıktı dizininde oluşturulur ve başka bir işlemde tetiklenmeniz gerekir. Kaynak dizininizde `.lproj` klasörleri varsa, seçilen dile karşılık gelen yeni klasör, oluşturulan çıktıyla bilgilerini birleştirir. Bu oluşturucu, bağımsız HTML oluşturucuyla aynı verimlilikte bir PDF dosyası sağlar.

Çapraz referanslama

Sphinx'in arama listesinde oluşturduğu yeni dosya adı. Yepyeni "uluslararası bağlam"ı içeren belgedeki yeni dosya adı. Veri formatı, GNU Emacs ve terminale bağımlı program bilgileri tarafından kullanılan aralık destek sisteminin temelini oluşturur. Daha fazla bilgi için 'sphinxsetup' simge paketi anahtarına bakın. Yeni indeksleme işlemini, size yardımcı olması için applehelp_disable_external_devices ayarıyla devre dışı bırakabilirsiniz; bu durumda, hiutil paket içindeki .lproj dosyaları kullanılarak çalıştırılmaya başlanana kadar çıktı iyi olmayacaktır.

Liman işçisi¶

Her ne kadar öyle olmasa da, bunun gerçekten daha kısa ve çok yönlü olduğunu ve diğer fikirlerle çalışmak isterseniz uyumsuzluk sorunlarıyla karşılaşabileceğinizi unutmayın. Ayrıca, işletim sistemine özgü paket profesyonellerini kullanarak Sphinx'in küresel bir sürümünü sisteme kurabilirsiniz. PyPI paketlerini kurmak için en çok kullanılan araç, Python'ın modern sürümlerinde bulunan pip'tir. Bu, yeni Sphinx sürüm numarasını yazdırmalıdır.

Bu basit bir HTML oluşturucudur. Belge test uzantınız etkinleştirilmişse, evraklarla ilgili tüm belge testleri üzerinde çalışın. megahamster.net/tr web sayfası Makeinfo kullanarak Gerçekler belgeleri için işlenebilecek Texinfo belgeleri oluşturun. Her belge için ayrı bir dizin içeren HTML sayfaları oluşturun.

Burada `sourcedir` kaynak dizin, `outputdir` ise bulunan kayıtları yerleştirmeniz gereken dizindir. En yeni `-Yards` seçeneği bir oluşturucu seçer; bu örnekte Sphinx HTML veri dosyaları oluşturma eğilimindedir. Oluşturucu, üretim dizininden Exudate kaynak dosyaları sağlar. Bu bölüm, kaynak ağacınızdaki dosyalara bağlantı vermenizi sağlar; bunlar genellikle görüntülenen `reStructuredText` dosyalarıdır, ancak yüklenen dosyalar da olabilir.

Bu özellik, genel siteler arası söz diziminde kişiselleştirilmiş bağlantı metin mesajlarına yardımcı olur. Yeni analogy.py dosyası üretim listenize kopyalanacak ve bunları kullanabilmeniz için uygun bir kanca oluşturulacaktır. Eğer bugün en yeni HTML kayıtlarını oluşturuyorsanız, yeni üretim aynı olacaktır!

Büyük ilgi uyandıran diğer konularla çapraz referanslama¶

Her bir unsur için harici özellikler aslında üretimdir ve kalan "bekleyen" unsurlar için dahili hizmetler de sağlanmaktadır. En yeni verimlilik, örneğin XSLT işlemcileri gibi standart XML aygıtlarına sahip olan ve keyfi son sürümlerde kullanılan bir dönüşümdür. Bu, bir değişiklik günlüğü dosyası oluşturmak için faydalıdır.

Kullanıcılar arasında herhangi bir yerde geri bağlantı oluşturulurken index.html dosyası atlanır, bu nedenle URL'ler markup/rest/ gibi görünür. Bu, standart HTML oluşturucunun harika bir alt sınıfıdır. Yeni oluşturucunun etiketi. Bu, temelde tasarımcıların sipariş satırı için kullandığı değerdir.

En yeni dosya adı genellikle mevcut kaynak dosyasının bulunduğu yeni dizine göre belirlenir; ancak, eğer dosya adı boşsa (/ ile başlıyorsa), büyük kaynak listesine göre alınır. Gerçekleştirme sayfasındaki her bağlantı sizi, ilgili autodoc yönergesini ilk kullandığınız yere, bu örnekte usage.rst dosyasına götürür. En yeni autosummary yönergesi, gerekli autodoc yönergelerini içeren dosyalar oluşturur. Ayrıca, bilgileri iki yerde yazmak yerine, belgelerle ilgili Python docstring'lerini yeniden kullanmak da faydalı olabilir. Daha fazla bilgi için thesphinx-make alt sayfasına bakın. Python dosyaları gibi birçok Sphinx veri dosyası Web Sitelerinde yayınlanmaktadır.

Bölümlere basit reStructuredText web sitesi bağlantıları (örneğin `Bölüm etiketi`) yerine ref kullanılması önerilir çünkü bu, veri dosyaları etrafında çalışır, bölüm başlıkları değiştirildiğinde yanlış olması durumunda uyarıları iyileştirme eğilimindedir ve tasarımcılar için kaynaklar arası bir çözüm sunar. Tüm serileştirme geliştiricileri, kaynak belge başına bir belge ve bir çift özel dosya üretir. Bu formlardan birinde harika bir dokümantasyon koleksiyonunu güçlendirmek için ek önerilerle HTML veri dosyaları oluşturun.