Niðurstaða vefsíðunnar sem autosummary framleiddi¶ Og þú munt enn og aftur, eftir að hafa keyrt „create html“, vera ný afköst eins og áður. Í fyrri https://i24slot.org/is/app/ hluta kennslunnar skráðir þú handvirkt gott Python eyðublað í Sphinx. Þó ekki, þá er conf.py einnig í öðrum lista, listanum yfir nýjustu stillingar. Sphinx.ext.intersphinx fyrir ítarlega lýsingu á eiginleikum intersphinx.
Keyrsla á nýju myndvinnslunni¶
Toctree er í raun frábær reStructuredText skipun, mjög sveigjanleg markup skipun. Þegar þú ert búinn hér geturðu farið í uppsetningarleiðbeiningarnar og síðan í nýjustu kynninguna til að hjálpa þér að sjá sjálfgefna markup skipunina sem Sphinx notar, reStructuredText. Önnur tungumál eru studd innfædd í Sphinx til að eiga handbókarkóðaskráningu, en þau þurfa viðbætur til að eiga sjálfvirka kóðaskráningu, til dæmis Breathe. Til að sýna Sphinx möguleika á að eiga lykilorðsskrár geturðu notað Python, sem einnig styður sjálfvirka skjalagerð. Þú getur framkvæmt frábæra skáldskaparhugbúnaðarsöfnun til að búa til handahófskennda matarmynstur sem mun hjálpa sem leiðarvísir í gegnum ferlið, með það að markmiði að skrá það á öruggan hátt. Verkefnið mun innihalda frásagnir, handskrifaðar skrár og sjálfvirkt myndaðar API skrár.
Vísun í aðra áhugaverða hluti¶
Finndu upplýsingar um raðgreiningarforritið til að fá upplýsingar um nýjustu framleiðniuppbygginguna. Hann eyðir einum hluta í að tækja nýja Python raðgreiningarforritið (pickle, simplejson, phpserialize, þó sum) til að fjarlægja HTML skjölin sem mynduð eru. Þú verður að tilgreina að þessi skjöl eigi að vera innifalin í Texinfo skjölunum með gildinu texinfo_documentsconfiguration. Hann býr til Texinfo skrár sem makeinfo forritið getur unnið úr í gagnaskrárnar þínar. Hann býður upp á sömu framleiðni og sjálfstæði HTML hugbúnaðurinn, en býr einnig til epub skráarskrá.
Fyrir hverja og eina tilskipun ákveður hvort hún geti haft rök, og hversu mörg. Mótmæli eru gefin persónulega eftir tvöfalda endaþarminn sem fylgir nafni tilskipunarinnar. Megintilgangurinn með rótarskjalinu ætti að vera góð velkomin vefsíða og að vernda rót „töflu úr greinartré“ (annars „tré“). Markmið skjalsins er að láta þig fljótt skilja hvað Sphinx er í raun og veru og hvernig þú getur notað það.
Lénsheiti er safn af hluttegundum sem tilheyra henni, fyllt með merkingu til að búa til og þú getur vísað í lýsingar á þessum hlutum. Build latexpdf keyrir nýja Latex hugbúnaðinn og ræsir auðveldlega nýja pdfTeXtoolchain fyrir þig. Þó ekki, þá býður sphinx-quickstart handritið upp á frábært Makefile og þú getur líka notað amake.bat sem gerir lífið enn auðveldara fyrir þig.
Þetta gæti búið til HTML skjöl í make möppunni sem þú valdir. Þetta gæti verið gert með því að keyra `build` á nafn höfundarins. (Þau gætu innihaldið `trenndar` leiðbeiningar sjálf, þú getur búið til djúpt innfelldar stigveldi ef þörf krefur.)
Fyrsta stilling¶
Hver tilskipun finnur hvort tryggja eigi að það séu greinar og í hvaða átt á að fara innan hennar. Greinar koma á eftir valkostunum, annars koma athugasemdir á eftir auðu svæði. Hámarksdýptin er í raun valkostur við toctree tilskipunina.
Vísitalan inniheldur einnig nýja Sphinxstillingarskjalið conf.py, þar sem þú getur raðað öllum þáttum þess hvernig Sphinx les eigin skrá og framleitt skrárnar. Hins vegar afrita þeir nýju reStructuredText skrárnar í nýja _skráarlistann í skráarlistanum. Höfundurinn býður upp á textaskrá fyrir hverja reStructuredText skrá. Þetta er næstum því eins og nýja reStructuredText skráin, en með flestum nýju merkingunum fjarlægðum til að auka lesanleika. Finndu exudate_files og hlutastillingarnar fyrir Exudate framleiðni fyrir tiltæka valkosti.
Hvaða smiður býður upp á sambærilega framleiðslu og sjálfstæður HTML smiður, en býr einnig til GNOME Devhelp stuðningsskjal sem gerir nýjum GNOME Devhelp notendum kleift að skoða það. Til dæmis, nýjasta skjalið markup/people.rst getur ekki virkjað framleiðni skjalið markup/rest.html, en markup/rest/directory.html. Framleiðni leitar að möppu með HTML skrám, þar sem hvert skjal er kallað list.html og sett í undirmöppu sem ber nafnið list.html og síðuauðkenni þeirra. „Nafn“ nýja smiðsins verður að gefa nýjasta -Meters annars -b skipanalínuvalkostir sphinx-generate til að velja smið.