Re: [sphinx-users] New PDF builder: Sphinx-SimplePDF

[Renato Pontefice]

Mac osx 12.5.1
Let me know.

Thank you

Renato

> Il giorno 26 ago 2022, alle ore 12:54, Daniel Woste 
>  ha scritto:
> 
> Hi Renato,
> 
> thanks for the fast feedback.
> 
> This looks like a bug, so I created a bug issue: 
> https://github.com/useblocks/sphinx-simplepdf/issues/6 
> 
> 
> As I have currently no idea for a solution, I only have one question: What 
> operating system are you using?
> 
> I will try to solve this in the next days.
> 
> Thanks for testing it!
>   Daniel
> 
> 
> -- 
> 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 view this discussion on the web visit 
> https://groups.google.com/d/msgid/sphinx-users/257e2d0d6ecfd7c9034bd2f5a6959c819538d70f.camel%40useblocks.com
>  
> .

-- 
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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/F13A6E43-4C77-4B1C-81E6-F7A9D94555EE%40gmail.com.

Re: [sphinx-users] New PDF builder: Sphinx-SimplePDF

[Renato Pontefice]

Hi all,
I’ve typed the command tp install simplepdf and the make simplepdf.
This is the result:
make simplepdf
Sto eseguendo Sphinx v5.1.1
sto creando la cartella di output... fatto
loading pickled environment... fatto
Setting theme to sphinx_simplepdf
Generating css files from scss-templates
building [mo]: targets for 0 po files that are out of date
building [simplepdf]: all documents
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
preparing documents... fatto
assembling single document... fatto
writing... fatto
writing additional files... fatto
copying static files... fatto
copying extra files... fatto
dumping object inventory... fatto
Traceback (most recent call last):
  File "/usr/local/bin/weasyprint", line 5, in 
from weasyprint.__main__ import main
  File "/usr/local/lib/python3.10/site-packages/weasyprint/__init__.py", line 
336, in 
from .css import preprocess_stylesheet  # noqa isort:skip
  File "/usr/local/lib/python3.10/site-packages/weasyprint/css/__init__.py", 
line 25, in 
from . import computed_values, counters, media_queries
  File 
"/usr/local/lib/python3.10/site-packages/weasyprint/css/computed_values.py", 
line 9, in 
from ..text.ffi import ffi, pango, units_to_double
  File "/usr/local/lib/python3.10/site-packages/weasyprint/text/ffi.py", line 
401, in 
pango = _dlopen(
  File "/usr/local/lib/python3.10/site-packages/weasyprint/text/ffi.py", line 
385, in _dlopen
return ffi.dlopen(names[0])  # pragma: no cover
  File "/usr/local/lib/python3.10/site-packages/cffi/api.py", line 150, in 
dlopen
lib, function_cache = _make_ffi_library(self, name, flags)
  File "/usr/local/lib/python3.10/site-packages/cffi/api.py", line 832, in 
_make_ffi_library
backendlib = _load_backend_lib(backend, libname, flags)
  File "/usr/local/lib/python3.10/site-packages/cffi/api.py", line 827, in 
_load_backend_lib
raise OSError(msg)
OSError: cannot load library 'pango-1.0-0': dlopen(pango-1.0-0, 0x0002): tried: 
'/usr/local/lib/pango-1.0-0' (no such file), 'pango-1.0-0' (no such file), 
'/usr/local/lib/pango-1.0-0' (no such file), '/usr/lib/pango-1.0-0' (no such 
file), '/Users/renatopontefice/sphinx/docs/pango-1.0-0' (no such file).  
Additionally, ctypes.util.find_library() did not manage to locate a library 
called 'pango-1.0-0'
build succeeded.

The HTML page is in build/simplepdf.

But (as the log show) in simplepdf folder I found just an index.html and 
objects.inv
No .pdf file
Looks like the installation did not go well

Can you help me? I’me not aware of python.

Thank you

Renato
>  Files. Il giorno 26 ago 2022, alle ore 10:34, Daniel Woste 
>  ha scritto:
> 
> Hi all,
> 
> just wanted to let you know that a new PDF builder is available, which 
> hopefully makes some stuff easier regarding PDF generation: Sphinx-SimplePDF.
> 
> Docs HTML : https://sphinx-simplepdf.readthedocs.io/
> 
> Only 2 commands are needed to get a PDF out of your existing docs:
> 1) pip install sphinx-simplepdf
> 2) make simplepdf
> 
> Sphinx-SimplePDF provides already a nice-looking, modern theme (incl. front 
> and back cover).  See following link as example.
> 
> Docs PDF: 
> https://sphinx-simplepdf.readthedocs.io/en/latest/_static/Sphinx-SimplePDF.pdf
> 
> Theming is done via HTML and CSS, so no Latex is involved.
> (Backend is based on weasyprint)
> As it is based on HTML, all extensions should be supported out of the box.
> 
> Main colors and images can be configured inside your conf.py file. 
> So no CSS knowledge is needed for generic changes.
> 
> I hope you like it and that it is useful for your project.
> Happy to get some feedback :)
> 
> Have a great day,
>   Daniel
> 
> -- 
> 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 view this discussion on the web visit 
> https://groups.google.com/d/msgid/sphinx-users/e106d88e-4fb6-4891-8ec9-ecf7ea36f605n%40googlegroups.com
>  
> .

-- 
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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/66C412AE-52C3-4929-BD56-A7877963D870%40gmail.com.

[sphinx-users] what is the wiki to collect documentation source

[Renato Pontefice]

Hi,
I'm wondering witch is the wiki used to collect documentation that the I 
can elaborate with sphinx to obtain different output format

Thank you

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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/c24f8569-fae6-4724-a8e6-777cd4f086een%40googlegroups.com.

[sphinx-users] Ho w to create socument

[Renato Pontefice]

Hi, I’ve few prob on creating doc.
I’ve installe sphin 3.5.4 and, I’re ran sphinx-quickstart, so, it creates my 
tree and tell me to run make builder
But make is not find (I think a prob of PATH), Where do I have to search this 
command? And how can I insert a file name to link from index? I mean the 
correct syntax, can someone show me a link of index.rst?

TIA

-- 
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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/0E9128A0-8EE9-403F-A9A0-F4A7833D1575%40gmail.com.

[sphinx-users] please help me to obtain PDF (or HTML)...

[Renato Pontefice]

Hi,
some years ago, I written a documentation using markdown. I do not remember
how I wrote it (it past about 4 or 5 years) but I remember I've used
ReadTheDoc to obtain a PDF.

Now, I would need again of the PDF, but I cannot made it with RTD.
I've asked to RTD support and they told me to ask to sphinx support,
because the only way to obtain PDF from my file is to use it by Sphinx.
Now, Ive installed python and sphinx on my Mac OSX 11 and generate the tree
of documentation with the sphinx-quickstart macro, but no more that this...
Can someone drive me  to obtain this PDF (or HTML)?
Because I've read some documentation but I'm still unable to obtain my goal!

I need someone that tells me:"put this document here, run this macro..."and
so on

I can send you my full tree, with the files I already have...

Can you help me?

Thank you

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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/CAF83ECAqNTat_mt43CZpw-ZMnU45_Wbf8q2xRZWx%2B-BBoUfbmw%40mail.gmail.com.

[sphinx-users] probleem to install sphinx on Mac osx 11.2.3 Big Sur

[Renato Pontefice]

Hi,
I think I have some problem...
I've installed with  brew install sphinx-doc
and it seems everything's goes well.
But when I run 

sphinx-quickstart

I receive an error message

command not found


I think it could be a problem of PATH


I'veinstalle python 3.9.4  but by default just python 2.7 run


How can I insert in PATH Sphinx?


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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/971fe695-5ab3-4a7f-9630-8ae9b2d0417fn%40googlegroups.com.

[sphinx-users] best wiki to produce documentation

[Renato Pontefice]

hi,
I would use sphinx-doc to obtain documentation (sw documentation)
The doc. should be wrote from more people (the sw developer)
then I could translate in HTML or PDF
So, I need a wiki to collect this documentation.
I'm wondering if sphinx-doc can accept just text files as input or also a
SQL file (e.g. the Tra wiki, store rst doc in a DB)
If yes, can someone sudgest me a wiki to do that?

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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/CAF83ECAhUN9XhDnpVg4JYdqWLgWOPitre3tGhO2t7MJXXo6W6Q%40mail.gmail.com.

[sphinx-users] wiki to collect documentatio

[Renato Pontefice]

Hi,
ca someone show me a god wiki to collect rst documentation in my factory?

Thank you

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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/f7e01e08-9589-43d5-955f-ca780c99cd2e%40googlegroups.com.

Re: [sphinx-users] how can I obtain pdf

[Renato Pontefice]

thank you.
I've updated all the file producecd by the make command
and all goes well

Renato

Il giorno ven 19 apr 2019 alle ore 13:17 George Feng  ha
scritto:

> Hi Renato,
>
> Please check out this repo:
> https://runawayhorse001.github.io/SphinxGithub/
>
> It may help.
>
> Best Wishes
>
> Wenqiang
>
> On Fri, Apr 19, 2019 at 6:11 AM Renato Pontefice <
> renato.pontef...@gmail.com> wrote:
>
>> Hi,
>> I continue to experiment all sphinx possibilities,
>> I made my html format, compiling the .rst document (make html) and it
>> work well.
>>
>> Now, I would try the latex version
>>
>> I've made "make latex" and I obtained a .tex file that >I've tried to
>> compile with overleaf . But I'm not sure that this is the right way.
>> I mean: Do I have to compile the .tex or the command "make latex" does
>> everithings... or, if I have to compile the .tex how do I can do that?
>>
>> Because my overleaf compilation does not goes well.
>>
>> Can someone show me some documentation link?
>>
>> 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.
>

-- 
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] how can I obtain pdf

[Renato Pontefice]

Hi,
I continue to experiment all sphinx possibilities,
I made my html format, compiling the .rst document (make html) and it work
well.

Now, I would try the latex version

I've made "make latex" and I obtained a .tex file that >I've tried to
compile with overleaf . But I'm not sure that this is the right way.
I mean: Do I have to compile the .tex or the command "make latex" does
everithings... or, if I have to compile the .tex how do I can do that?

Because my overleaf compilation does not goes well.

Can someone show me some documentation link?

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.

Re: [sphinx-users] How to collect material

[Renato Pontefice]

Hi Stefano,
Not really that.
This is the correct toolchain to produce file. I’m looking for something (a 
wiki?) to collect the documentation. 
I mean something that can output a .rst where more people contribute.

Renato

> Il giorno 16 apr 2019, alle ore 16:55, Stefano David  ha 
> scritto:
> 
> Hi,
> 
> On Monday, 15 April 2019 12:25:44 UTC+2, Renato Pontefice wrote:
> Hi,
> I'm still looking for the best tool to made what I'm looking for
> Any sudgestion?
> If I understand your question correctly, 
> http://www.sphinx-doc.org/en/stable/usage/quickstart.html is the best place 
> where to find this kind of information. In a nutshell: 
> 
> 1. Run sphinx-quickstart, answer the questions (leave the default answers if 
> unsure).
> 2. Put your .rst files under the project's source/ directory.
> 3. Edit the file indes.rst, add a toctree:: with all the rst files.
> 4. Issue the command make html.
> 
> HTH,
> Stefano
> 
> 
> -- 
> 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 
> <mailto:sphinx-users+unsubscr...@googlegroups.com>.
> To post to this group, send email to sphinx-users@googlegroups.com 
> <mailto:sphinx-users@googlegroups.com>.
> Visit this group at https://groups.google.com/group/sphinx-users 
> <https://groups.google.com/group/sphinx-users>.
> For more options, visit https://groups.google.com/d/optout 
> <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.

[sphinx-users] Re: How to collect material

[Renato Pontefice]

Il giorno venerdì 4 gennaio 2019 12:09:33 UTC+1, Renato Pontefice ha 
scritto:
>
> Hi, 
> Now (after time and time try to understand wich is the best tool) I’,m 
> sure that my tool, for inside and outside documentation, will be: 
> - rst doc 
> - sphinx 
>
> But I still have a question: 
> How can I collect the documentation? 
> I mean: is there a way (I think a wiki could be the best way) that can 
> assist people that are able to collect documentation to do this? 
>
> 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.

Re: [sphinx-users] How to collect material

[Renato Pontefice]

Hi,
I'm still looking for the best tool to made what I'm looking for
Any sudgestion?

Thank you

Renato

Il giorno lunedì 7 gennaio 2019 19:15:49 UTC+1, Renato Pontefice ha scritto:
>
> No, 
> I mean: I need Sphinx, to produce good manual, (technical documentation) 
> but I’m wondering how can I collect the documentationthat all programmer 
> can/have to write. 
> I know that I need to collect all the doc and format it in rest 
> But I’m wondering if does it exist a wiki (I know moinmoin that seem to be 
> not updated) that made this work (I mean: WHO can WRITE WHAT and so on 
>
> Renato 
>
> > Il giorno 7 gen 2019, alle ore 16:16, Komiya Takeshi <
> i.tkom...@gmail.com> ha scritto: 
> > 
> > Hi, 
> > 
> > What do you mean "collect documentation"? If you mean collect 
> > knowledge for Sphinx, it would be nice to update official document of 
> > Sphinx. 
> > 
> > Thanks, 
> > Takeshi KOMIYA 
> > 
> > 2019年1月4日(金) 20:09 Renato Pontefice : 
> >> 
> >> Hi, 
> >> Now (after time and time try to understand wich is the best tool) I’,m 
> sure that my tool, for inside and outside documentation, will be: 
> >> - rst doc 
> >> - sphinx 
> >> 
> >> But I still have a question: 
> >> How can I collect the documentation? 
> >> I mean: is there a way (I think a wiki could be the best way) that can 
> assist people that are able to collect documentation to do this? 
> >> 
> >> 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. 
>
>

-- 
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] How to collect material

[Renato Pontefice]

No,
I mean: I need Sphinx, to produce good manual, (technical documentation) but 
I’m wondering how can I collect the documentationthat all programmer can/have 
to write.
I know that I need to collect all the doc and format it in rest
But I’m wondering if does it exist a wiki (I know moinmoin that seem to be not 
updated) that made this work (I mean: WHO can WRITE WHAT and so on

Renato

> Il giorno 7 gen 2019, alle ore 16:16, Komiya Takeshi  ha 
> scritto:
> 
> Hi,
> 
> What do you mean "collect documentation"? If you mean collect
> knowledge for Sphinx, it would be nice to update official document of
> Sphinx.
> 
> Thanks,
> Takeshi KOMIYA
> 
> 2019年1月4日(金) 20:09 Renato Pontefice :
>> 
>> Hi,
>> Now (after time and time try to understand wich is the best tool) I’,m sure 
>> that my tool, for inside and outside documentation, will be:
>> - rst doc
>> - sphinx
>> 
>> But I still have a question:
>> How can I collect the documentation?
>> I mean: is there a way (I think a wiki could be the best way) that can 
>> assist people that are able to collect documentation to do this?
>> 
>> 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.

-- 
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] How to collect material

[Renato Pontefice]

Hi,
Now (after time and time try to understand wich is the best tool) I’,m sure 
that my tool, for inside and outside documentation, will be:
- rst doc
- sphinx

But I still have a question:
How can I collect the documentation?
I mean: is there a way (I think a wiki could be the best way) that can assist 
people that are able to collect documentation to do this?

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.

[sphinx-users] where can I see some examle of source code documentation?

[Renato Pontefice]

Hi,
today I've spoke about Sphinx and RST to document the program source.

Because I work on a software house, it could be a very nice feature.

Can someone send me some link where I can find some example?

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.

Re: [sphinx-users] Using pipe instead of hyphens in browser tab

[Renato Pontefice]

Hi Barbara,
I don’t understand your message.
I drove to signal Fix, but I do not understund what you have to do with it.

What do you have to do with signal fix?

Renato

> Il giorno 07 lug 2018, alle ore 01:14, Barbara Snyder  
> ha scritto:
> 
> Hello --
> 
> My SEO folks have asked me to change our implementation at docs.signalfx.com 
> so the browser tabs show pipes | instead of hyphens.
> 
> So instead of a tab looking like this:
> 
>  
> 
> 
> It would look like this:
> 
> Concepts | SignalFx 1.0 etc
> 
> I can't find where the styling and content for the tab is specified. Any help 
> would be appreciated.
> 
> Thanks -- Barbara
> 
> 
> -- 
> 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.

[sphinx-users] can I convert markdown documentation?

[Renato Pontefice]

Hi
I've build a little manual (about 25 pages) using the markdown language.
All the doc are in a repository (GitHub)
I'm wondering if is it possible to import it and use it with sphinx because 
I want to leave markdown and start rst with sphinx.

Any sudgestion?

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.

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

[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 <pbur...@gmail.com > 
> 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 <renato.p...@gmail.com> 
>>> 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.

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

[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.

Re: [sphinx-users] convert .doc to .rst

[Renato Pontefice]

Great! I've done all the chain that Michael describe in his tutorial. I've
just two prob:
One image inside a table is not shown,  and another "in line" with text..
Do I have to check the .rst? I mean: the prob could be in the conversion?
or what?

Thanks

Renato

Il giorno mer 2 mar 2016 alle ore 01:24 ChrisD <cd34...@intielectronics.com>
ha scritto:

> I posted this previously but it doesn't appear to have made it out to the
> group. I'll try again...
>
>
> I have no problems using pandoc to convert docx to html or rst.. I'm using
> the latest pandoc version 1.16.0.2.
>
> Chris
>
>
>  Original Message 
> Subject: Re: [sphinx-users] convert .doc to .rst
> From: Renato Pontefice <renato.pontef...@gmail.com>
> <renato.pontef...@gmail.com>
> To: sphinx-users@googlegroups.com
> Date: 3/1/2016 6:58 AM
>
> with pandoc I do not find the way to convert docx to rst (just rst to
> docx) :-(
>
> Il giorno mar 1 mar 2016 alle ore 14:40 ChrisD <
> cd34...@intielectronics.com> ha scritto:
>
>>
>>
>>
>> I need to convert a bunch of .doc (MS word) made by MS word, to .rst.
>>
>> Pandoc ( <http://pandoc.org/>http://pandoc.org/) can convert docx to
>> rst. I do not know of a tool to convert the older doc files to rst, but
>> there are a number of tools for converting doc to docx, and then you could
>> use Pandoc to convert to rst.
>>
>> I haven't done this myself so don't know how good the conversion would
>> be...
>>
>> Chris
>>
>>
>>
>
> --
> 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] convert .doc to .rst

[Renato Pontefice]

with pandoc I do not find the way to convert docx to rst (just rst to docx)
:-(

Il giorno mar 1 mar 2016 alle ore 14:40 ChrisD 
ha scritto:

>
>
>
> I need to convert a bunch of .doc (MS word) made by MS word, to .rst.
>
> Pandoc (http://pandoc.org/) can convert docx to rst. I do not know of a
> tool to convert the older doc files to rst, but there are a number of tools
> for converting doc to docx, and then you could use Pandoc to convert to rst.
>
> I haven't done this myself so don't know how good the conversion would
> be...
>
> Chris
>
> --
> 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.

[sphinx-users] convert .doc to .rst

[Renato Pontefice]

Hi, I'm a very new user of sphinx. 
I need to convert a bunch of .doc (MS word) made by MS word, to .rst.
This is, to start using sphinx (and a wiki) to create user doc to our 
procedure sw.

I do not find the way to do that. Isw it possible?

TIA

-- 
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] Re: new to sphinx

[Renato Pontefice]

Hi, yes this answer help me a lot. 
They let me understand, that spinx is not the solution :-)

So, what I can look about a solution for my prob?
I mean:
- build a centralized store of doc (it could be a wiki,but any sudgestion 
are welcome) with privilege access
- writing doc in RST format
- export the same base of doc in different format  (i.e. one format to use 
as a book, one format to use as a wiki ...)

are that info enought?

Renato


Il giorno venerdì 18 dicembre 2015 16:24:49 UTC+1, David H ha scritto:
>
> Answers to your questions:
>
> 1. Yes, Sphinx is open source software. It's source code is available on 
> Github here: https://github.com/sphinx-doc/sphinx
> 2. No, Sphinx does not create wiki output. It creates static HTML output, 
> that can be easily published to a website.
> 3. No, once Sphinx creates the HTML output, it doesn't give you the 
> ability to create access control lists with privileges.
>
> Sphinx and Wikis are two different, opposing ways to manage content on a 
> website. WIth a wiki someone can log in and edit the page in their web 
> browser. With Sphinx, you edit the source text files of the web site using 
> a text editor, then run a Sphinx command to re-build the HTML files, then 
> you copy those files to your website. You can do collaborative editing of 
> the files in the same way you would edit code, using source control tools 
> such as git or mercurial, etc.
>
> I hope this helps -
> David H
>
> On Friday, December 18, 2015 at 5:27:59 AM UTC-5, Renato Pontefice wrote:
>>
>> Hi,
>> I need to find a solution, for the documentation on my company.
>> We develop and distribuite a java sw
>> is a big project. We need to unify the doc and give a centralized repo of 
>> it.
>> I have been instructed to find a solution.
>> I think, I've found it in sphinx.
>> I'd like to post some question, before start to use it:
>> 1 - is it Open source sw? This, because we release our sw under that 
>> license
>> 2 - I've understand that I can create my doc, using rst syntax, and then 
>> render it in the format i prefer. Can I deliver it on a web plattform as 
>> wiki? (I'm thinking at moin moin wiki, but also the sphinx web site seem to 
>> have the same requirement.)
>> 3 - if answer of letter 2 is "yes", can I create more user access with 
>> different privilege ?
>>
>> That info are enought for me to start using it.
>> eventualy, later, I will ask for more info.
>>
>> 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.