Re: [sphinx-users] can I use sphinx as wiki?

2016-06-10 Thread Peter Burdine 
sphinx-autobuild is at https://github.com/GaretJax/sphinx-autobuild

I haven't looked at those wiki's, but it would be wise to check if you are 
using sphinx specific tags that are not part of reST or if you are using 
any extensions.  Those may not work if you are using a reST based wiki.

On Thursday, June 9, 2016 at 6:48:15 PM UTC-7, gsavix wrote:
>
> hhuumm!! good information. please have one url for all of us see more 
> details? regards.
>
> 2016-06-09 15:56 GMT-03:00 Peter Burdine 
> :
>
>> 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  
>>> 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 sphinx-users...@googlegroups.com.
>>> To post to this group, send email to sphinx...@googlegroups.com.
>>> 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 sphinx-users...@googlegroups.com .
>> To post to this group, send email to sphinx...@googlegroups.com 
>> .
>> Visit this group at https://groups.google.com/group/sphinx-users.
>> For more options, visit https://groups.google.com/d/optout.
>>
>
>
>
> -- 
> gilberto dos santos alves
> +55(11)9-8646-5049
> sao paulo - sp - brasil
>
>
>
>
>

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Re: [sphinx-users] can I use sphinx as wiki?

2016-06-10 Thread Renato Pontefice 
What is the differene between this wiki and moinmoikn?

Renato

Il giorno venerdì 10 giugno 2016 08:45:28 UTC+2, derek ha scritto:
>
> https://github.com/phiggins42/rstwiki  works with reStructuredText and 
> there seems to be support in moinmoin for it as well - 
> https://moinmo.in/HelpOnParsers/ReStructuredText 
>
> On 9 June 2016 at 20:56, Peter Burdine  
> wrote:
>
>> 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  
>>> 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 sphinx-users...@googlegroups.com.
>>> To post to this group, send email to sphinx...@googlegroups.com.
>>> 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 sphinx-users...@googlegroups.com .
>> To post to this group, send email to sphinx...@googlegroups.com 
>> .
>> 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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Re: [sphinx-users] can I use sphinx as wiki?

2016-06-09 Thread gilberto dos santos alves 
hhuumm!! good information. please have one url for all of us see more
details? regards.

2016-06-09 15:56 GMT-03:00 Peter Burdine :

> 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 
>> 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 sphinx-users...@googlegroups.com.
>> To post to this group, send email to sphinx...@googlegroups.com.
>> 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 sphinx-users+unsubscr...@googlegroups.com.
> To post to this group, send email to sphinx-users@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>



-- 
gilberto dos santos alves
+55(11)9-8646-5049
sao paulo - sp - brasil

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Re: [sphinx-users] can I use sphinx as wiki?

2016-06-09 Thread Peter Burdine 
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  > 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 sphinx-users...@googlegroups.com .
> To post to this group, send email to sphinx...@googlegroups.com 
> .
> 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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Re: [sphinx-users] can I use sphinx as wiki?

2016-05-10 Thread gilberto dos santos alves 
using sphinx to rendering rst (app docs, samples, etc) and wiki for  make
things easy.

2016-05-09 17:22 GMT-03:00 Chris Barker :

>
>
> On Mon, May 9, 2016 at 1:05 PM, gilberto dos santos alves <
> gsa...@gmail.com> wrote:
>
>> yes. see [1]
>>
>> [1] http://adessowiki.fee.unicamp.br/adesso/
>>
>
> nice! Is that using Sphinx under the hood? Or just RST with its own
> rendering engine?
>
> -CHB
>
>
>
>>
>> 2016-05-09 7:38 GMT-03:00 Renato Pontefice :
>>
>>> 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 sphinx-users+unsubscr...@googlegroups.com.
>>> To post to this group, send email to sphinx-users@googlegroups.com.
>>> Visit this group at https://groups.google.com/group/sphinx-users.
>>> For more options, visit https://groups.google.com/d/optout.
>>>
>>
>>
>>
>> --
>> gilberto dos santos alves
>> +55(11)9-8646-5049
>> sao paulo - sp - brasil
>>
>>
>>
>>
>> --
>> 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 sphinx-users+unsubscr...@googlegroups.com.
>> To post to this group, send email to sphinx-users@googlegroups.com.
>> Visit this group at https://groups.google.com/group/sphinx-users.
>> For more options, visit https://groups.google.com/d/optout.
>>
>
>
>
> --
>
> Christopher Barker, Ph.D.
> Oceanographer
>
> Emergency Response Division
> NOAA/NOS/OR(206) 526-6959   voice
> 7600 Sand Point Way NE   (206) 526-6329   fax
> Seattle, WA  98115   (206) 526-6317   main reception
>
> chris.bar...@noaa.gov
>
> --
> 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 sphinx-users+unsubscr...@googlegroups.com.
> To post to this group, send email to sphinx-users@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>



-- 
gilberto dos santos alves
+55(11)9-8646-5049
sao paulo - sp - brasil

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Re: [sphinx-users] can I use sphinx as wiki?

2016-05-09 Thread Chris Barker - NOAA Federal 
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 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Re: [sphinx-users] can I use sphinx as wiki?

2016-05-09 Thread gilberto dos santos alves 
yes. see [1]

[1] http://adessowiki.fee.unicamp.br/adesso/

2016-05-09 7:38 GMT-03:00 Renato Pontefice :

> 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 sphinx-users+unsubscr...@googlegroups.com.
> To post to this group, send email to sphinx-users@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>



-- 
gilberto dos santos alves
+55(11)9-8646-5049
sao paulo - sp - brasil

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

[sphinx-users] can I use sphinx as wiki?

2016-05-09 Thread Renato Pontefice 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.