If you haven't tried it, you might want to look at the sphinx-autobuild 
extension.  It seems to work pretty well, it will start up its own 
webserver and issue an html rebuild anytime a file is modified.

I have noticed though if you use the sphinx-jinja extension, changing the 
source of the context will trigger a rebuild, but won't necessarily rebuild 
the affected content.  You can make one small tweak to the plugin, change 
'html' in the setup function to say 'env', then it works as expected.

If you don't have too many people, you may be able to use that as a wiki.

On Monday, May 9, 2016 at 3:26:53 PM UTC-7, Chris Barker - NOAA Federal 
wrote:
>
> No, Sphinx is not a wiki system.
>
> The defining feature of a wiki is that users can edit the pages on the fly 
> in the same web app that is presenting the pages. Sphinx generates static 
> content, and does not provide an interface for editing it.
>
> That being said, it may be useful for your use-case.
>
> If you put your Sphinx content in a gitHub repo, you can serve up the 
> rendered html with gitHub pages, and your users/contributors can edit the 
> content with gitHub's interface, OR by cloning the repo and doing the usual 
> PR dance that is used for code.
>
> If your contributors are fairly sophisticated or used to the gitHub 
> workflow, this can work well.
>
> Alternatively, there may well be a wiki system that allows RST as the 
> markup language -- maybe even gitHub's wiki.
>
> -CHB
>
> On May 9, 2016, at 7:54 AM, Renato Pontefice <[email protected] 
> <javascript:>> wrote:
>
> Hi,
> I would start to use a wiki to write documentation on my softwarehouse.
> My Idea is to use restructuredtex, because is most useful (I can translate 
> it on pdf, word etc...)
>
> So my wiki reference is moinmoin. 
> I saw that moinmoin is quite at release 2, but still release 1.9.x
>
> My question is:
> Could Sphinx be a wiki?
> Or, it is lust a "trasformation" software?
>
> I hope I was clear
>
> TIA
>
> Renato
>
> -- 
> You received this message because you are subscribed to the Google Groups 
> "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an 
> email to [email protected] <javascript:>.
> To post to this group, send email to [email protected] 
> <javascript:>.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>
>

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to