[Python] Sphinx sotto progetti

Michele Gatti mgsoluzioni a gmail.com
Lun 9 Dic 2013 14:03:43 CET


Il giorno 09 dicembre 2013 13:16, Giulio Calacoci <
giulio.calacoci a 2ndquadrant.it> ha scritto:

>  Onestamente credo di non aver capito in pieno il tuo scopo.
> Perche' avere un progetto sphinx padre con N sottofigli?
>
> faccio un esempio base:
>
> * doc progetto 1
> ** file conf progetto 1
> *** directory _build
>
> * doc progetto 2
> ** file conf progetto 2
> *** directory _build
>
> * doc progetto 3
> ** file conf progetto 3
> *** directory _build
>
> Ogni cartella di documentazione ha il suo file di configurazione, indi
> ogni cartella e' un "progetto" indipendente dagli altri.
>
> Trovo molto piu' semplice lanciare uno script bash che lanci make html in
> ogni sottocartella, piuttosto che un progettone sphinx
> con dei sottoprogetti...
>
> Sia chiaro che probabilmente non ho capito il tuo obiettivo finale o la
> struttura che vuoi ottenere...
>
> Saluti.
>
>
> Il 09/12/2013 12:34, Michele Gatti ha scritto:
>
> Attualmente ho un file di index solo e un unico file di configurazione,
> quindi ho una vista schiacciata dell'albero che mi sono dato come
> documentazione.
> quello che mi piacerebbe è avere per ogni sotto directory di
> documentazione il suo index.html in modo che si navigabile
>
>
>   [image: logo]
>  *Michele Gatti*
> *"Per imparare un nuovo linguaggio di programmazione ci vuole un sacco di
> lavoro, e le persone non imparano Python perché questo permetterà loro di
> avere un lavoro, ma perché amano genuinamente programmare e non sono
> soddisfatte con i linguaggi che già conoscono."*
>    [image: Instagram]<http://s.wisestamp.com/links?url=http%3A%2F%2Finstagram.com%2Fg_mikele&sn=Zy5taWtlbGVAZ21haWwuY29t> [image:
> Flickr]<http://s.wisestamp.com/links?url=http%3A%2F%2Fwww.flickr.com%2Fphotos%2Fgmikele%2F&sn=Zy5taWtlbGVAZ21haWwuY29t> [image:
> LinkedIn]<http://s.wisestamp.com/links?url=http%3A%2F%2Fit.linkedin.com%2Fin%2Fmichelegatti&sn=Zy5taWtlbGVAZ21haWwuY29t> [image:
> Tumblr]<http://s.wisestamp.com/links?url=http%3A%2F%2Ftryexcept.tumblr.com%2F&sn=Zy5taWtlbGVAZ21haWwuY29t>
>  Get a signature like this:
> <http://s.wisestamp.com/links?url=http%3A%2F%2Fr1.wisestamp.com%2Fr%2Flanding%3Fpromo%3D29%26dest%3Dhttp%253A%252F%252Fwww.wisestamp.com%252Femail-install%253Futm_source%253Dextension%2526utm_medium%253Demail%2526utm_campaign%253Dpromo_29&sn=Zy5taWtlbGVAZ21haWwuY29t> Click
> here!<http://s.wisestamp.com/links?url=http%3A%2F%2Fr1.wisestamp.com%2Fr%2Flanding%3Fpromo%3D29%26amp%3Bdest%3Dhttp%253A%252F%252Fwww.wisestamp.com%252Femail-install%253Futm_source%253Dextension%2526utm_medium%253Demail%2526utm_campaign%253Dpromo_29&sn=Zy5taWtlbGVAZ21haWwuY29t>
>
>
>  Il giorno 09 dicembre 2013 11:52, Giulio Calacoci <
> giulio.calacoci a 2ndquadrant.it> ha scritto:
>
>>  Puoi essere un po' piu' specifico?
>> Come è organizzato il codice al momento?
>> cosa vorresti ottenere?
>>
>> Saluti.
>>
>> Il 09/12/2013 11:21, Michele Gatti ha scritto:
>>
>>  Ciao a tutti è da poco che uso sphinx ed è fantastico, ma volevo
>> chiedervi se è possibile creare in un unico progetto di sphinx tanti sotto
>> progetti correlati.
>> Volevo creare un progetto documentazione con all'interno delle aree
>> diverse come:
>>
>>    - Processi
>>    - Analisi
>>    - ecc.
>>
>>  In modo che ogni sotto progetto abbia lo stesso stile.
>>
>>  --
>>
>>  Michele Gatti
>>
>>  MG Soluzioni Informatiche
>>
>>
>>
>>   [image: logo]
>>  *Michele Gatti*
>> *"Per imparare un nuovo linguaggio di programmazione ci vuole un sacco di
>> lavoro, e le persone non imparano Python perché questo permetterà loro di
>> avere un lavoro, ma perché amano genuinamente programmare e non sono
>> soddisfatte con i linguaggi che già conoscono."*
>>    [image: Instagram]<http://s.wisestamp.com/links?url=http%3A%2F%2Finstagram.com%2Fg_mikele&sn=Zy5taWtlbGVAZ21haWwuY29t> [image:
>> Flickr]<http://s.wisestamp.com/links?url=http%3A%2F%2Fwww.flickr.com%2Fphotos%2Fgmikele%2F&sn=Zy5taWtlbGVAZ21haWwuY29t> [image:
>> LinkedIn]<http://s.wisestamp.com/links?url=http%3A%2F%2Fit.linkedin.com%2Fin%2Fmichelegatti&sn=Zy5taWtlbGVAZ21haWwuY29t> [image:
>> Tumblr]<http://s.wisestamp.com/links?url=http%3A%2F%2Ftryexcept.tumblr.com%2F&sn=Zy5taWtlbGVAZ21haWwuY29t>
>>  Get a signature like this:
>> <http://s.wisestamp.com/links?url=http%3A%2F%2Fr1.wisestamp.com%2Fr%2Flanding%3Fpromo%3D29%26dest%3Dhttp%253A%252F%252Fwww.wisestamp.com%252Femail-install%253Futm_source%253Dextension%2526utm_medium%253Demail%2526utm_campaign%253Dpromo_29&sn=Zy5taWtlbGVAZ21haWwuY29t> Click
>> here!<http://s.wisestamp.com/links?url=http%3A%2F%2Fr1.wisestamp.com%2Fr%2Flanding%3Fpromo%3D29%26amp%3Bdest%3Dhttp%253A%252F%252Fwww.wisestamp.com%252Femail-install%253Futm_source%253Dextension%2526utm_medium%253Demail%2526utm_campaign%253Dpromo_29&sn=Zy5taWtlbGVAZ21haWwuY29t>
>>
>>
>>  _______________________________________________
>> Python mailing listPython a lists.python.ithttp://lists.python.it/mailman/listinfo/python
>>
>>
>>
>> --
>>  Giulio Calacoci - 2ndQuadrant Italia
>>  PostgreSQL Training, Services and Support
>>  giulio.calacoci a 2ndQuadrant.it | www.2ndQuadrant.it
>>
>>
>> _______________________________________________
>> Python mailing list
>> Python a lists.python.it
>> http://lists.python.it/mailman/listinfo/python
>>
>>
>
>
>  --
>
>  Michele Gatti
>
>  MG Soluzioni Informatiche
>
>
> _______________________________________________
> Python mailing listPython a lists.python.ithttp://lists.python.it/mailman/listinfo/python
>
>
>
> --
>  Giulio Calacoci - 2ndQuadrant Italia
>  PostgreSQL Training, Services and Support
>  giulio.calacoci a 2ndQuadrant.it | www.2ndQuadrant.it
>
>
> _______________________________________________
> Python mailing list
> Python a lists.python.it
> http://lists.python.it/mailman/listinfo/python
>
>


Io avevo in mente una roba così:
* Progetto Main
** Modulo 1
*** Procedura 1
*** Procedura 2

** Modulo 2
*** Procedura 1

** Modulo 3

Però io non ho codice python da documentare ma tanti file rst
-- 

Michele Gatti

MG Soluzioni Informatiche
-------------- parte successiva --------------
Un allegato HTML è stato rimosso...
URL: <http://lists.python.it/pipermail/python/attachments/20131209/0a2b9a6f/attachment-0001.html>


Maggiori informazioni sulla lista Python