Postitused
Autosummary loodud teostusleht¶ Ja pärast make html käivitamist on uusim jõudlus jällegi sama, mis eelmisel. Õpetuse viimases osas märkisite ise Sphinxis suurepärast Pythoni seadistust. Aga mitte, conf.py saab reaalajas luua ka teises kataloogis, uusimas seadistuskataloogis. Sphinx.ext.intersphinx pakub intersphinxi populaarsete funktsioonide täielikku kirjeldust.
Uusima loomise käivitamine¶
Toctree on reStructuredText direktiiv, äärmiselt mitmekülgne märgistusviis. Kui olete siin kohal, saate külastada installiraamatut, millele järgneb uus sissejuhatus, et saaksite kasutada Sphinxi poolt kasutatavat vaikemärgistusstiili reStructuredText. Teised keeled on Sphinxis natiivselt saadaval koodi dokumenteerimiseks, kuid nad vajavad automaatse koodi dokumenteerimise laiendusi, näiteks Breathe. Seega saate programmeerida Sphinxi funktsioone paroolifailide haldamiseks, kasutades Pythoni, mis aitab ka automaatset failide genereerimist. Võite luua suurepärase fiktiivse tarkvarapaketi juhuslike õhtusöökide loomiseks, mis toimivad kogu protsessi vältel hea juhisena, et neid turvaliselt dokumenteerida. Projekt peaks sisaldama narratiivset, käsitsi kirjutatud dokumentatsiooni ja automaatselt genereeritud API-faile.
Ristviitamine teistele huvipakkuvatele teemadele¶
Leidke serialiseerimise looja fakte, et saada teavet uusima jõudlusvormingu kohta. Milline koostaja kasutab moodulit 1, et rakendada uusimat Pythoni serialiseerimise API-t (pickle, simplejson, phpserialize ja teised), et vabaneda genereeritud HTML-dokumentidest? Texinfo_documentsconfiguration abil peate määrama andmed, mis lisatakse Texinfo andmetesse. See koostaja pakub Texinfo dokumente, mis on makeinfo programmi abil andmefailidesse salvestatud. See koostaja pakub sama kujundust kui iseseisev HTML-koostaja, aga loob ka nutika epub-faili e-raamatute lugejatele.
Iga direktiivi puhul määratakse, kas sellel võib olla vastuväiteid ja kui palju. Argumente esitatakse isiklikult, järgides direktiivi nimele järgnevat https://24casinowin.com/et-ee/login/ kahte pärakut. Selle aluseks oleva faili peamine eesmärk on toimida hea kutsutud lehena ja sisaldada „sisu metsa söögilaua” (ehk toctree) juurt. Selle faili eesmärk on anda teile kiire valik, mida Sphinx proovib ja kuidas seda kasutada.

Domeeninimi on kokkukuuluvate objektitüüpide kogum, mis sisaldab tehtavaid märgistusi ja nende üksuste kirjeldusi. Generate latexpdf kasutab uusimat Latexi koostajat ja käivitab teie vajaduste jaoks hõlpsalt uusima pdfTeX tööriistaketi. Kuid mitte, sphinx-quickstart skript pakub head Makefile'i ja saate amake.bat faili, mis muudab teie elu veelgi lihtsamaks.
See loob HTML-dokumendid teie valitud ehituskataloogi. Need võidakse teha, käivitades oma ehitaja nime jaoks käsu "build". (Neil võivad olla omaette "toctree" direktiivid, nii et vajadusel saate tekitada tõsiselt pesastatud hierarhiaid.)
Kõige esimene seadistus¶
Iga direktiiv määrab, kas lubada postituste tegemist või mitte ja mis suunas selles liikuda. „Blogid” tuleb valikute või vastuväidete järel kohe pärast tühja vahemikku. „Maksimaalne sügavus” on valik toctree direktiivis.
See loend sisaldab ka uusimat Sphinxi konfiguratsioonidokumenti conf.py, kus saate korraldada kõik aspektid alates sellest, kuidas Sphinx teie pakkumist kontrollib ja dokumendid koostab. Sellegipoolest dubleerivad nad uued reStructuredText ressursifailid tootlikkuse kataloogi uusimasse _source indeksisse. Selle looja pakub iga reStructuredText dokumendi jaoks raamatufaili. See on peaaegu nagu uus reStructuredText ressurss, kuid parema loetavuse huvides on palju uut märgistust eemaldatud. Saadaval olevate alternatiivide jaoks leiate exudate_data failid ja jaotise Valikud Latexi jõudluse jaoks.

Seega pakub see looja identset väljundit eraldiseisva HTML-i koostajaga, aga loob ka GNOME Devhelp tugidokumendi, mis võimaldab uuel GNOME Devhelp vaatajal neile juurde pääseda. Näiteks uusim documentmarkup/other.rst ei saa väljundiks olla dokument markup/people.html, vaid pigem markup/rest/directory.html. Selle väljundiks on HTML-andmetega kataloog, kus iga dokumendi kohta on olemas index.html ja see on loetletud alamkataloogis, mis kannab vastavat lehe nime. Uue koostaja "nimi" tuleb anda sphinx-generate'i uutele käsureavalikutele -M või -b, et valida koostaja.
