Hægt er að miða á latexmk valkosti í gegnum LATEXMKOPTSMakefile aðlögunarhæfa. Þú getur gert þetta með því að nota „make all-pdf“ hér. Til að sameina báðar hugmyndirnar í eina skaltu prófa sphinx-create -M(t.d. -Yards latexpdf ekki -b latexpdf) eða „create latexpdf“ í spjaldstillingunum þínum. Raunveruleg PDF skráning á sér stað í þessari skráarskrá og ætti að virkja þig í öðru skrefi. Ef skráarlistinn þinn inniheldur einhverjar .lproj möppur, þá mun sú nýja sem samsvarar völdum kóða fá færslur sínar sameinaðar við myndaða afköstin. Þannig býður smiðurinn upp á gagnlega hjálparhandbók með sömu afköstum og sjálfstæði HTML smiðurinn.
Spila Penalty Duel slot – Víxlvísanir í hluti¶
Nýja skráarnafnið fyrir leitarmöppuna sem Sphinx býr til. Nýja skráarnafnið á skránni sem inniheldur nýja „alþjóðlega sjónarhornið“. Gagnastíllinn er grunnurinn að þínum eigin hjálparkerfi sem GNU Emacs notar og mikilvægar upplýsingar um forritið. Skiljið leyndarmál táknpakkans „sphinxsetup“ til að fá frekari upplýsingar. Þú gætir hugsanlega slökkt á nýju flokkunaraðgerðinni í stillingunni applehelp_disable_external_systems svo þú getir leiðrétt, þar sem úttakið er ekki gott fyrr en hiutil eiginleikar hafa þegar verið keyrðir með .lproj skránum í pakkanum.
Docker¶
En ekki, hafðu í huga að þetta getur verið styttra og leitt til samhæfingarvandamála ef þú vilt virka á milli annarra áætlana. Þú getur jafnvel sett upp alþjóðlega útgáfu af Sphinx fyrir forritið þitt með því að nota stýrikerfisbundin pakkastjóra. Vinsælasta tólið til að setja upp pakka utan PyPI er pip, sem er hluti af öllum nýjustu útgáfum Python. Þetta myndi prenta nýja útgáfunúmerið af Sphinx.
Hér er grunnatriði HTML-smíðakerfisins. Vinnið með öll próf úr skjölunum, ef prófextension þinn leyfir það. Búið til Texinfo gögn sem hægt er að vinna úr í Details gagnaskránum með því að nota makeinfo. Búið til HTML notendur, en með einstökum lista fyrir hvert skjal.
Í hvaða sourcedir er frumskráin og þú munt framleiða. dir er skráin þar sem þú vilt setja miðlæga skjölun. Nýi -Yards valkosturinn spila Penalty Duel slot velur smíðara; í exampleSphinx býrðu venjulega til HTML skrár. Þessi smíðari býr til Exudate skrár fyrir afkastalistann. Þessi hluti gerir þér kleift að tengjast skrám í frumskráartrénu þínu sem eru ekki skoðaðar skrár heldur skrár sem hægt er að hlaða niður.
Að það virki og hjálpi til við að sérsníða tengingartextaskilaboð á almennri setningafræði yfir vefsíður. Nýja example.py skjalið gæti verið afritað á virknilistann og þú munt fá viðeigandi tengingu til að nota það. Fyrir þá sem búa til nýjustu HTML skjölin er nýja virknin sú sama!
Vísun í annað sem er mjög áhugavert¶
Ytri eiginleikar allra þátta eru framleiðni og þú getur einnig boðið upp á innri eiginleika til að eiga alla eftirstandandi „í bið“ þætti. Hægt er að umbreyta nýju framleiðslunni með grunn XML tækjum eins og XSLT örgjörvum í handahófskenndar lokaútgáfur. Þetta er kostur til að búa til breytingaskrá, þar á meðal.
Þegar tenglar eru búnir til frá prófílum er reynt að útiloka theindex.html, þannig að vefslóðin virðist vera markup/rest/. Þetta er góður undirflokkur af grunn HTML smiðnum þínum. Nafn nýja höfundarins. Þetta er alltaf þess virði að finna forritara í skipanalínunni þinni.
Nýja skráarnafnið kemur venjulega á undan nýju vísitölunni sem frumskráin er í, en ef hún er náttúruleg (þú byrjar á /) er hún tekin sem tengd aðal auðlindaskránni. Allir tenglar á framkvæmdarsíðunni munu leiða þig á staðina þar sem þú notaðir upphaflega viðeigandi autodoc-tilskipun, í þessu tilfelli í usage.rst skjalinu. Nýja autosummary-tilskipunin býr til gögn sem innihalda nauðsynlegar autodoc-tilskipanir. Og það væri gott að endurnýta Python-strengi í skjölunum, frekar en að þurfa að skrifa gögnin í tveimur borgum. Vísaðu á sphinx-build son síðuna til að fá frekari upplýsingar. Af mörgum Sphinx-gögnum, þar á meðal Python-skjölunum, er það skrifað á vefsíðunum.
Það er betra að leika sér með tilvísanir en einfaldar tenglar á kafla (til dæmis `Section identity`_) þar sem það virkar í kringum skjölin, þegar kaflatitlar eru breyttir, bætir viðvörun ef þeir eru rangir og hjálpar smiðunum að blanda saman heimildum. Allir raðgerðarforritarar gefa þér aðgang að skrá fyrir hverja upprunaskrá og sérstakar skrár samstarfsaðila. Búðu til HTML skjöl með aukinni ráðgjöf til að styrkja skjalasafn innan eins af þessum sniðum.
