Automaattisten asiakirjojen ikäryhmä pois Gonzos Quest peliautomaatti salasanasta

Seuraavaksi, jatka omaa viestiäsi.. Tutoriaalin viimeisessä osiossa ilmoitit käsin loistavasta Python-lomakkeesta Sphinxissä. Aiemmin sinua käytetään Sphinxin helppoon käyttöön ja toiseksi, sinua käytetään pääasiassa PDF-tiedostojen luomiseen Latexin kanssa. Huomaa kuitenkin, että tämä on vähemmän joustavaa ja sinun on keskityttävä yhteensopivuusongelmiin, jos haluat sen toimivan muiden pakettien kanssa. Voit myös luoda erillisen Sphinx-muodon järjestelmässä, jossa on käyttöjärjestelmäkohtaisia ​​pakettiasiantuntijoita.

GitLab¶ – Gonzos Quest peliautomaatti

Sanakirja kaikista tiedostojen otsikoista, koska ne ovat HTML-merkkijonoja. Käytetyn luojan termi, kun on kyse suolakurkuista, tämä on yleensä 'suolakurkku'. Nykyisen tiedoston uusi tiedostonimi. Tiedoston uusi taulukko, joka on renderöity alkuperäisen HTML-koodin perusteella. Uusi HTML-"runko" (eli uusi HTML, joka muodostaa lähdetiedoston), kuten uusi HTML-kääntäjä sen renderöi.

Intersfinksi¶

autosummaryn luoma johtopäätössivu¶ Ja jälleen kerran, heti generate html:n suorittamisen jälkeen, uusin toiminto on sama kuin ennen. Etuna on se, että se luodaan itse salasanassa. Sphinx otti uuden reStructuredTextin dokumenttijonosta ja voit integroida sen sekä mainostaa oikeanlaisia ​​​​suosituksia.

Jokaisen toimitusdokumentin uudet datatiedostot sisältävät out_suffix-päätteen, ja ne luodaan hakemistoihin samalla tavalla kuin toimitusdokumentit. Sen rakentaja ei tarjoa toiminnallisuutta. Lue lisää Gonzos Quest peliautomaatti kansainvälistämisen dokumentaatiosta. Etsi sarjoittelun luojan tiedot saadaksesi tietoa uudesta tuotantoformaatista. Uusi Texinfo-formaatti on GNU-yritysten käyttämä sertifioitu tiedostojärjestelmä. Latexmk-ominaisuuksiin voi viitata LATEXMKOPTSMakefile-tiedoston kautta.

Liite: Sphinx-investoinnin käyttöönotto verkossa¶

Sphinx ylpeilee sphinx-quickstart-nimisellä skriptillä, jonka avulla voit määrittää lähdekoodihakemiston ja luoda vakiomuotoisen conf.py-tiedoston hyödyllisillä määritysperiaatteilla ilman, että sinun tarvitsee vastata muutamaan ennalta määritettyyn kysymykseen. Hyvän Sphinx-tyyppisen tekstiviestitiedoston taustalla olevaa luetteloa kutsutaan syyluetteloksi. Heillä on useita muita ominaisuuksia, kuten versioidut asiakirjat, liikenne- ja hakutilastot, yksilölliset verkkotunnukset, käyttäjän määrittämät uudelleenohjaukset ja paljon muuta. Seuraavissa osioissa määritellään joitakin tapoja ottaa käyttöön verkkoasiakirjasi ja annetaan erityisiä asiakirjoja koskevia ohjeita.

Conda-paketti¶

Jokainen toteutussivun linkki vie sinut paikkoihin, joissa alun perin käytit kyseistä autodoc-direktiiviä, tässä tapauksessa tiedostossa usage.rst. Voit jopa luoda tiedostoja automaattisesti muista kohteista. Lisäksi voisi olla hyödyllistä auttaa sinua käyttämään uudelleen Python-dokumentaatiomerkkijonoja tiedostoissa sen sijaan, että sinun tarvitsisi kirjoittaa ehdotuksia kahdessa kaupungissa. Toinen murre on natiivisti saatavilla Sphinxissä manuaalisen koodidokumentaation hallintaan, mutta ne vaativat laajennuksia automaattisen koodidokumentaation hallintaan, kuten Hengitys.

Juuritiedoston päätarkoitus olisi toimia erinomaisena kutsuttuna verkkosivuna ja suojata "ruokapöytä sisältömetsästä" (eli toctree). Nämä vinkit eivät käytä uutta komentoriviä, muuten käynnistät mitään lisäohjelmistoa. Useimmat näistä vaihtoehdoista ovat ilmaisia, joten voit ostaa lisää ominaisuuksia.