[Python] Sphinx sotto progetti

Giulio Calacoci giulio.calacoci a 2ndquadrant.it
Lun 9 Dic 2013 13:16:12 CET


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
>
> 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."/
>
> Instagram 
> <http://s.wisestamp.com/links?url=http%3A%2F%2Finstagram.com%2Fg_mikele&sn=Zy5taWtlbGVAZ21haWwuY29t> 
> Flickr 
> <http://s.wisestamp.com/links?url=http%3A%2F%2Fwww.flickr.com%2Fphotos%2Fgmikele%2F&sn=Zy5taWtlbGVAZ21haWwuY29t> 
> LinkedIn 
> <http://s.wisestamp.com/links?url=http%3A%2F%2Fit.linkedin.com%2Fin%2Fmichelegatti&sn=Zy5taWtlbGVAZ21haWwuY29t> 
> 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 
> <mailto: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
>>
>>
>>     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."/
>>
>>     Instagram
>>     <http://s.wisestamp.com/links?url=http%3A%2F%2Finstagram.com%2Fg_mikele&sn=Zy5taWtlbGVAZ21haWwuY29t>
>>     Flickr
>>     <http://s.wisestamp.com/links?url=http%3A%2F%2Fwww.flickr.com%2Fphotos%2Fgmikele%2F&sn=Zy5taWtlbGVAZ21haWwuY29t>
>>     LinkedIn
>>     <http://s.wisestamp.com/links?url=http%3A%2F%2Fit.linkedin.com%2Fin%2Fmichelegatti&sn=Zy5taWtlbGVAZ21haWwuY29t>
>>     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 list
>>     Python a lists.python.it  <mailto:Python a lists.python.it>
>>     http://lists.python.it/mailman/listinfo/python
>
>
>     -- 
>       Giulio Calacoci - 2ndQuadrant Italia
>       PostgreSQL Training, Services and Support
>       giulio.calacoci a 2ndQuadrant.it  <mailto:giulio.calacoci a 2ndQuadrant.it>  |www.2ndQuadrant.it  <http://www.2ndQuadrant.it>  
>
>
>     _______________________________________________
>     Python mailing list
>     Python a lists.python.it <mailto:Python a lists.python.it>
>     http://lists.python.it/mailman/listinfo/python
>
>
>
>
> -- 
>
> Michele Gatti
>
> MG Soluzioni Informatiche
>
>
> _______________________________________________
> Python mailing list
> Python a lists.python.it
> http://lists.python.it/mailman/listinfo/python


-- 
  Giulio Calacoci - 2ndQuadrant Italia
  PostgreSQL Training, Services and Support
  giulio.calacoci a 2ndQuadrant.it | www.2ndQuadrant.it

-------------- parte successiva --------------
Un allegato HTML è stato rimosso...
URL: <http://lists.python.it/pipermail/python/attachments/20131209/5c5e6ac7/attachment.html>


Maggiori informazioni sulla lista Python