[sphinx-users] Re: Execute something like autodoc without run the code is posible?

Hi, Technically, it is possible to generate docs without execution. But sphinx.ext.autodoc does not support the feature. It might work combination of doxygen and breathe extension (but I'd never used them...) Thanks, Takeshi KOMIYA 2016年6月4日土曜日 20時54分32秒 UTC+9 Juan Antonio Fernández Sánchez:

[sphinx-users] Sphinx-1.4.3 released

Hi all, I'm delighted to announce the release of Sphinx 1.4.3, now available on the Python package index at . It includes about 1 packaging bug and 10 bug fixes for the 1.4.2 release series, among them a incompatibility and a packaging error. For the full

[sphinx-users] Sphinx-1.4.4 released

Hi all, I'm delighted to announce the release of Sphinx 1.4.4, now available on the Python package index at . It includes about 10 bug fixes for the 1.4.3 release series, among them a incompatibility and a packaging error. For the full changelog, go to <

[sphinx-users] Sphinx 1.4.2 released

Hi all, I'm delighted to announce the release of Sphinx 1.4.2, now available on the Python package index at . It includes about 4 features and 44 bug fixes for the 1.4.1 release series, among them a incompatibility and a packaging error. For the full

Re: [sphinx-users] Sphinx 1.4.2 released

I > use, that points to a remote URL: > > .. image:: > > http://demo.mapserver.org/cgi-bin/mapserv?map=/osgeo/mapserver/tutorial/htdocs/example1-1.map=states=map > > > This works fine in 1.4.1 and all past Sphinx versions. > > What changed with 1.4.2 regarding thi

Re: [sphinx-users] Sphinx in Laravel

Hi, Unfortunately, this is not a list for sphinx-search. this is for sphinx; the documentation tool. http://www.sphinx-doc.org/en/stable/ Please ask your question at more suitable list. Thanks, Takeshi KOMIYA 2016-05-31 17:06 GMT+09:00 Sandeep kaur : > Greetings, > I

[sphinx-users] Re: Unknown interpreted text role "kbd"

Hi, The `kdb` role is not a part of standard reStructuredText. It is additional role. So it works under Sphinx only. Thanks, Takeshi KOMIYA 2016年6月17日金曜日 9時10分52秒 UTC+9 Vladan Divljak: > > Hi, > > I'm starting with Sphinx and rst, and thought to try with `kbd` directive > as shown in

[sphinx-users] Re: Is it possible to use reference inside rubric?

Hi, Do you want to change the "AUTHOR1" in first paragraph downloadable? If true, you can use hyperlink target syntax. ex: Following AUTHOR1_ blablabla .. _AUTHOR1: _static/author1.pdf Thanks, Takeshi KOMIYA 2016年6月25日土曜日 7時54分15秒 UTC+9 Lauro: > > *Example:* > > Following [AUTHOR1]_

[sphinx-users] Re: Problem in generating TOC

Hi, The filename is not important. I meant is there sub toctree like following is in your sub directories. .. toctree:: :glob: * It seems your situation is similar to the case of sub toctrees. Is the way you suggested the right way to do the index? I don't know my approach is right

[sphinx-users] Re: sphinx 1.3.4 latex gives no toc

Hi, Sorry for inconvinience. It's bug of 1.3.4 And will fixed at 1.3.5. Please use 1.3.3 until next version is released (may be this weekend). Thank you for reporting Takeshi KOMIYA 2016年1月21日木曜日 8時17分39秒 UTC+9 repriville: > > > I upgraded to sphinx 1.3.4 in a python 2.7.8 virtual

[sphinx-users] Re: Sphinx 1.4-alpha1 released

Hi Viktor, This difficulty seems to still be there with the 1.4b1 release. > > In my particular case, I'm getting the errors associated with a domain > extension contrib package that has gone asleep by maintainers, and I tried > to modify a bit to use Python 3. I have gone over my adjustments

[sphinx-users] Re: Sphinx 1.4-alpha1 released

Hi, I'm glad to hear that. If you find any other issues, please tell me them :-) Thanks, 2016年3月8日火曜日 22時42分35秒 UTC+9 Viktor Haag: > > > On Tuesday, 8 March 2016 07:28:06 UTC-5, Komiya Takeshi wrote: >> >> Oh, sorry. We do not intend to make the 3rd party domains incom

Re: [sphinx-users] Re: 1.3.5 problem with latex tocdepth

{1}". However, what we need is a "master" setting >> in the conf.py file, to set the "tocdepth" counter for latex. >> >> Can you please explain how to set the tocdepth in the conf.py file? >> >> Sorry for my questions. >> >> Thanks, &g

[sphinx-users] Re: Conditional bullet list items

Hi, The "only" directive is not a preprocessor. Actually, it works as post-processor. In your situation, the input reST is recognized like following: New glunkifier for fribulating text. (eight more entries here) Zoodler has been enhanced. Numbulator now handles XQT48.

[sphinx-users] Re: AttributeError: module 'distutils.config' has no attribute 'ConfigParser'

Hi, It seems the exception comes from your configuration file. Could you check line 48 of your conf.py? > File "conf.py", line 48, in >AttributeError: module 'distutils.config' has no attribute 'ConfigParser' Thanks, Takeshi KOMIYA 2016年7月28日木曜日 6時25分10秒 UTC+9 Lian Tao: > > Hello, > > >

[sphinx-users] Re: html_last_updated not working?

Hi, What theme are you using? Unfortunately, the default theme of Sphinx; alabaster does not support the configuration. We need to report that to alabaster project. Note: I confirmed it works with the "classic" theme. Thanks, Takeshi KOMIYA 2016年7月28日木曜日 6時25分13秒 UTC+9 EMK: > > *Note:* I'm

Re: [sphinx-users] Re: Figure caption problem with numfig

Hi, Do you use sphinxtr/numfig.py? It appends "Figure n:" automatically. https://github.com/jterrace/sphinxtr/blob/master/extensions/numfig.py#L124 Please tell me what extensions you are using. Thanks, Takeshi KOMIYA 2016年8月12日金曜日 5時27分45秒 UTC+9 Warren Block: > > On Thu, 11 Aug 2016, Peter

[sphinx-users] Re: logo problem with alabaster theme

Hi, Hmm... it might be a bug of alabaster theme. The configuration is ignored in my environment too. http://alabaster.readthedocs.io/en/latest/customization.html BTW, html_logo works fine for me. http://www.sphinx-doc.org/en/stable/config.html#confval-html_logo Please use it instead. Thanks,

[sphinx-users] Re: Is there any way to format a Sphinx reference?

ction use boldface terms in a bullet list. > > On Monday, August 8, 2016 at 8:34:23 PM UTC-7, Komiya Takeshi wrote: >> >> Hi, >> >> "Naming Convention" is surrounded by . >> So you can change the style of the references using CSS. >> >>

[sphinx-users] Re: Getting generated HTML for a node and its children

Hi, How about sphinx.builders.html.StandaloneHTMLBuilder.render_partial()? It will generate HTML for specific node and its children. Thanks, Takeshi KOMIYA 2016年8月10日水曜日 8時48分41秒 UTC+9 Brad Miller: > > Hi, > > I've written a custom directive, which may contain other directives. All > is being

[sphinx-users] Re: overriding without changing templates?

Hi, Unfortunately, there is no way to replace doctype. Because sphinx does not support HTML5. At this moment, using HTMl5 themes (ex. sphinx-bootstrap-theme) is a simple way to do that. Thanks, Takeshi KOMIYA 2016年8月12日金曜日 1時13分32秒 UTC+9 Jason S: > > Is there a way to override to without

[sphinx-users] Re: Custom role in extension for latex vs html build

Hi, To registeri custom node is a standard way to do that. If added, you can add handlers for each builders:: from docutils import node class sidenote(nodes.Inline): pass def sidenote_role(...): """ Generate sidenote node from role definition """ role = sidenote() role['tag']

[sphinx-users] Re: how to get a superscript registered trademark (R) symbol?

Hi, The substitution does not work inside roles and directives. So you should use :sup:`®` . Thanks, Takeshi KOMIYA 2016年8月13日土曜日 6時34分30秒 UTC+9 Jason S: > > How can I superscript the ® symbol in Sphinx/RestructuredText? > > > The following does not work, I get a superscripted |reg| instead. >

Re: [sphinx-users] Re: Figure caption problem with numfig

Since Sphinx-1.3, Sphinx provides numfig feature as a built-in. So no extensions are needed now. It will go well if you remove the sphinx-numfig extension. Thanks, Takeshi KOMIYA 2016年8月12日金曜日 12時25分05秒 UTC+9 Warren Block: > > On Thu, 11 Aug 2016, Komiya Takeshi wrote: > > >

[sphinx-users] Re: Inline replacement of directive with another directive

ib-pylint/commit/a2fc984a6bdab3927031a589d23cb0017629636b > ). > Thanks a lot. > > Am Donnerstag, 7. Juli 2016 11:36:19 UTC+2 schrieb Florian: >> >> I will give it a try... Thanks. >> >> Am Mittwoch, 6. Juli 2016 18:52:09 UTC+2 schrieb Komiya Takeshi: >>>

[sphinx-users] Re: document IronPython

Hi, I don't know that. but sphinx does not have a special restriction to running environment. So it might work. Please try it and report the result! Thanks, 2016年7月4日月曜日 15時05分34秒 UTC+9 Ilan: > > Hi, > Is it possible to document IronPython code with sphinx > Thanks, > Ilan > -- You received

[sphinx-users] Re: sphinx xmlpipe2 - increase 2 MB limit

Hi, This is a list for sphinx; the documentation tool. not for sphinx search. http://www.sphinx-doc.org/en/stable/ Thanks, Takeshi KOMIYA 2016年7月9日土曜日 9時12分02秒 UTC+9 Юрий Кудряшов: > > Hi, everybody. > > I see in documentation (http://sphinxsearch.com/docs/current/xmlpipe2.html > ). > > fields

[sphinx-users] Re: TypeError: 'type' object does not support indexing error message when importing pymel.core module

Hi, This comes from bug of autodoc_mock_imports. I just fixed it at master branch. https://github.com/sphinx-doc/sphinx/commit/e15216c568015a713e26afd647b830b87781a164 Thanks, Takeshi KOMIYA 2016年7月27日水曜日 22時21分18秒 UTC+9 Abhilash Gupta: > > Hi Tomek, > > I am currently facing this same issue.

[sphinx-users] Re: html_last_updated not working?

Hi, I got the result by following steps: $ virtualenv test $ cd test $ . bin/activate $ pip install Sphinx $ hash -r $ sphinx-quickstart doc (snip) $ cd doc $ echo "html_last_updated_fmt = '%B %d, %Y'" >> conf.py $ echo "html_theme = 'classic'" >> conf.py $ make html The screenshot of the

[sphinx-users] Re: working with REVTeX

Hi, Unfortunately, current Sphinx could not change the order of the \author definition. So you have to modify LaTeX writer directly as a ad-hoc way. I want to improve this in next major version. At master branch, I introduced a template file for LaTeX code.

[sphinx-users] Re: How to change the name "Table of Contents" in HTML sidebars

baltoc (same thing but with {{ > toctree() }} at the bottom), but I am worried that I will omit important > parts of the original globaltoc if _templates/globaltoc.html overwrites the > built-in globaltoc. > > > On Friday, June 24, 2016 at 11:31:10 AM UTC-4, Komiya Takeshi wrot

[sphinx-users] Re: How to change the name "Table of Contents" in HTML sidebars

baltoc (same thing but with {{ > toctree() }} at the bottom), but I am worried that I will omit important > parts of the original globaltoc if _templates/globaltoc.html overwrites the > built-in globaltoc. > > > On Friday, June 24, 2016 at 11:31:10 AM UTC-4, Komiya Takeshi wrot

Re: [sphinx-users] How to modify text on the HTML search page?

The page is generated by templating feature. So please add user template named "search.html". refs: http://www.sphinx-doc.org/en/stable/templating.html Thanks, Takeshi KOMIYA 2017-02-02 1:19 GMT+09:00 'E. Kelly' via sphinx-users < sphinx-users@googlegroups.com>: > I want to change the default

Re: [sphinx-users] Re: sphinx 1.3.4 latex gives no toc

t; Franck > > > > Le mardi 31 janvier 2017 11:01:16 UTC-4, Komiya Takeshi a écrit : >> >> Hi Franck, >> >> I'd like to know how did you lost TOC. >> If it's also a bug, I will fix it in nearly release. >> Could you show me your project or small pro

Re: [sphinx-users] Re: How to use multiple paths for python modules documentation in different directories using sphinx autodoc?

It seems your case is simply python's problem, not sphinx's. How about this? sys.path.insert(0, os.path.abspath("..")) Thanks, Takeshi KOMIYA 2017-02-18 9:33 GMT+09:00 nshea : > The way my modules are structured, there is an __init__.py in both the > python_modules_A and the

Re: [sphinx-users] reducing duplication with multiple builders?

but it still looks like (haven't set up > the CI component here yet) this overhead will cost tens of seconds of time > per CI run. It's not a huge problem for us--just making sure I wasn't > overlooking some simple way to trim the wasted time. > > On Thursday, February 23, 2017 at 9:38:

Re: [sphinx-users] Getting extension directive data into JSONHTMLBuilder output

Hi, It seems JSON builder generates HTML using HTML builder and put it into JSON file. So you might put the status through html visitor method. Thanks, Takeshi KOMIYA 2017-02-25 5:00 GMT+09:00 Paul Everitt : > Hi, hopefully this is an easy question. Let's say I'm making

Re: [sphinx-users] custom css class to toctree

Hi, You're right. All directives should have :class: option. But toctree does not have it. Could you file that as a issue of Sphinx? I'll work it later. Thank you for reporting Takeshi KOMIYA 2017-02-24 8:57 GMT+09:00 Aladdin Mhaimeed : > Hi, > I use sphinx with

Re: [sphinx-users] Re: Sidebar alphabetical?

Hi, There are no way to sort the entries on sidebar in Sphinx itself. As Kelly said, Sphinx lists them in order of toctree. Of course, you can do that with your own extension. Thanks, Takeshi KOMIYA 2017-02-23 7:27 GMT+09:00 'E. Kelly' via sphinx-users : > I

Re: [sphinx-users] reducing duplication with multiple builders?

Hi Travis, >1. For performance reasons it'd be nice to reduce duplication across all of >these builds, but it doesn't look like Sphinx supports multiple builders in a >single run. What did you mean "duplication"? Surely Sphinx does not support to invoke multiple builders in a single run. But

[sphinx-users] Re: Best way to cross-reference in RST to a generated index page?

Hi, You can refer the general index and python-module index using :ref: role (:ref:`genindex` and :ref:`modindex`). But we can not refer other index pages using the role. AFAIK there are no way to make links to them. BTW the index pages are not a "document". so you can use :doc: role to refer

[sphinx-users] Re: Align html_logo?

Hi, You can do it with custom stylesheet: https://groups.google.com/d/msg/sphinx-users/x57bVbsmwTM/O0ICZ-ANDwAJ Thanks, Takeshi KOMIYA 2017年2月9日木曜日 11時43分01秒 UTC+9 imans314: > > Is there a way to set the html_logo to the centre of the sidebar? > > > -- You received this message because you

[sphinx-users] Re: html_last_updated not working?

Hi, I don't know regular way to change the format of dates for each document. As a ad-hoc way, you can do that with python codes. The following code modifies the format of dates at runtime. from datetime import date def change_today_fmt(app, docname, source): if docname == 'foo':

[sphinx-users] Sphinx-1.4.6 released

Hi all, I'm delighted to announce the release of Sphinx 1.4.6, now available on the Python package index at . It includes about 1 incompatible change and 12 bug fixes for the 1.4.5 release series. For the full changelog, go to <

[sphinx-users] Re: Use toctree to display sibling pages?

Hi, It seems there are no special template variable to show a toctree for a specific document. The following code might help you:: def on_html_page_context(app, pagename, tempaltename, context, docname): # get ToC for "a" document toc_for_a = self.env.get_toc_for('a', self) # set up

[sphinx-users] Sphinx-1.5.3 has been released

Hi all, I'm delighted to announce the release of Sphinx 1.5.3, now available on the Python package index at . It includes about 3 new feature and 16 bug fixes for the 1.5.2 release series. For the full changelog, go to

Re: [sphinx-users] existing project documentation won't build with 1.5.1 or 1.5.3: the linkcheck problem

Hi Pete, Yes, please. We, sphinx-dev recognizes the problems are resolved. So please report it if you still got error. I'd like to know your stacktrace, environment info (OS, packages and pip list) Thanks, Takeshi KOMIYA 2017-03-02 8:33 GMT+09:00 Pete : > This is a problem

[sphinx-users] Re: Numbered start/offset for multiple toctrees?

Hi, You can give section number to :numbered: option of toctree directive. .. toctree:: :caption: Part I :numbered: 1 foo bar .. toctree:: :caption: Part II :numbered: 1 baz qux But unfortunately, this feature is imcomplete. This effects to only HTML builder. Other

[sphinx-users] Re: Role functions have an inliner, how do I get it from within a Directive?

Hi, You can use self.state.nested_parse() instead at Directive.run(). Thanks, Takeshi KOMIYA 2016年9月7日水曜日 3時45分06秒 UTC+9 Jason S: > > Custom role functions have an inliner: > > def myrole(role, rawtext, text, lineno, inliner, options={}, content=[]): > > ... > > > But what about a

[sphinx-users] Re: Is there any way to format an index entry in monospace?

Hi, Please use stylesheet to change the looks of HTMLs. Thanks, Takeshi KOMIYA 2016年9月3日土曜日 7時58分56秒 UTC+9 Jason S: > > I want to format certain index entries in monospace, because they are > program identifiers (instead of index terms). > > How can I do this? > -- You received this message

Re: [sphinx-users] Re: xrefs to equations - not working

Yes, removing nowrap option is a ad-hoc way. Thanks, Takeshi KOMIYA 2016年9月1日木曜日 6時19分17秒 UTC+9 Fiona Hanington: > > Does this mean my xref will work if I remove nowrap? > > Thanks > > On Wed, Aug 31, 2016 at 10:17 AM, Komiya Takeshi <i.tk...@gmail.com > > wrote: >

[sphinx-users] Re: xrefs to equations - not working

. And thank you for good report. Thanks, Takeshi KOMIYA 2016年8月31日水曜日 10時18分54秒 UTC+9 Komiya Takeshi: > > Hi, > > Yes, please :-) > > Takeshi KOMIYA > > 2016年8月31日水曜日 8時27分55秒 UTC+9 Fiona Hanington: >> >> Hi >> I am having trouble posting a zip

[sphinx-users] Re: xrefs to equations - not working

Hi, Did you try to reference equations between different document? If true, current release does not support it. Please wait next major release. Otherwise it's strange. Could you share any example of your docs? It seems the code you pasted here includes needless spaces. I want to see actually

[sphinx-users] Re: xrefs to equations - not working

Hi, Yes, please :-) Takeshi KOMIYA 2016年8月31日水曜日 8時27分55秒 UTC+9 Fiona Hanington: > > Hi > I am having trouble posting a zip file. Can I send to you directly? > Fiona > > On Monday, 29 August 2016 19:30:40 UTC-7, Komiya Takeshi wrote: >> >> Hi, >> >>

[sphinx-users] Re: call Sphinx from Python3

Hi, Unfortunately, there are no way to reset them. Note: It is reported as https://github.com/sphinx-doc/sphinx/issues/2687 Thanks, Takeshi KOMIYA 2016年9月7日水曜日 17時33分17秒 UTC+9 Andrea Cassioli: > > Hi, > I am trying to call Sphinx directly from Python3. That would simplify my > workflow, as I

[sphinx-users] Re: newby - trying to install numsec.py extension so I can reference section numbers

Hi, I've never used the extension, but it might work with following steps: 1. copy numsec.py into your project 2. rewrite your conf.py to add current directory into sys.path:: sys.path.insert(0, os.path.abspath('.')) 3. add "numsec" (without .py suffix) into extensions list extensions

[sphinx-users] Re: Safe to run untrusted Sphinx code?

Hi, As far as I know, building sphinx-doc is basically safety operation. But conf.py is recognized python script, so it is danger if conf.py is placed under untrusted directory. BTW, I've never use tikz extension. so I don't know about it. Thanks, Takeshi KOMIYA 2016年9月10日土曜日 7時31分24秒 UTC+9

[sphinx-users] Re: Accessing the build directory in conf.py?

Hi, As far as I know, there are no proper way to obtain build directory in conf.py. But, as a adhoc way, you con obtain it through environment variables. in Makefile: BUILDDIR = _build export BUILDDIR in conf.py: builddir = os.environ['BUILDDIR'] jinja_contexts = {

[sphinx-users] Re: PDF version shows one huge chapter? Table of contents issues with latexpdf

Hi, 1) All my contents go in one chapter, everything from all the toctrees > ends up as Chapter 1 for some reason. > Please check your index.rst. Is there "Contents" heading before toctree definition? If true, Sphinx recognized the heading is a top level chapter. > 2) Even though I have

[sphinx-users] Re: Custom JSON output?

is present in signature) > - Return type and :returns: description string. > - All examples provided in the docstring. > > If I could access this information, I think it would be enough to get > started. > > Would it be best to access this information in a Sphinx Writer class? &

[sphinx-users] Re: newby - trying to install numsec.py extension so I can reference section numbers

he titles not the section > numbers. Anyone on this list use the extension? > > On Monday, 12 September 2016 08:24:24 UTC-7, Komiya Takeshi wrote: >> >> Hi, >> >> I've never used the extension, but it might work with following steps: >> >> 1. copy numsec.

[sphinx-users] Re: How do I include a standard symbol with Caution and Warning directives

Hi, About HTML, please create a CSS to customize the warning box. On the other hands, about LaTeX, current release does not support customization. Unreleased v1.5 will support it using custom LaTeX macros. ref: https://github.com/sphinx-doc/sphinx/issues/2674 Thanks, Takeshi KOMIYA

[sphinx-users] Re: Excluding particular base classes from autodoc inherited-members

Hi Jake, As far as I know, there are no option to do that. Thanks, 2016年9月16日金曜日 0時41分01秒 UTC+9 Jake: > > Hi all, > I hope to use autodoc for a project I'm working on. Most of my classes > inherit from some very low-level base classes, whose methods I don't want > in the documentation. > >

[sphinx-users] Re: Numbered start/offset for multiple toctrees?

ep > the "parts" and not have to remove them. > > Thanks again, > Mike > > > On Tuesday, September 6, 2016 at 9:26:52 PM UTC-7, Komiya Takeshi wrote: > -- You received this message because you are subscribed to the Google Groups "sphinx-users" gro

[sphinx-users] Re: Is there any way to automatically add section titles to the genindex?

Hi, To my knowlege, Sphinx does not have such a feature. And I don't know such an extension too. To do that, you might need to make new extension. Thanks, Takeshi KOMIYA 2016年8月27日土曜日 1時24分06秒 UTC+9 Jason S: > > I'm relatively new to Sphinx and I am not using it for Python. I went to > the

[sphinx-users] Re: Sphinx Pygment Style Jellybeans does not show right background

und color style in Sphinx-Doc? > > > > On Wednesday, August 24, 2016 at 10:05:50 PM UTC-5, Komiya Takeshi wrote: >> >> Hi, >> >> It seems the jellybeans theme sets the background color of tokens to >> #151515 (nearly black). >> >> https://githu

[sphinx-users] Re: numref with number and caption

Hi, It's good idea. Please post your proposal to github issues. I will implement it in future (maybe in 1.5 or 1.6). Thanks, Takeshi KOMIYA 2016年8月26日金曜日 6時17分02秒 UTC+9 Warren Block: > > I would like a numref-like role that inserts both a table or figure > number *and* the the linked object's

[sphinx-users] Re: Numbered start/offset for multiple toctrees?

Hi, Thank you for proposal. Of course we always welcome your PR! But, personally, I can't determine that is common feature or not. So I need some advices or votes from other people. BTW, we have some issues about toctree (preface, appendix and so on). So we have to improve toctree feature. So

[sphinx-users] Re: formatting rst file

Hi, It seems a bug of alabaster theme. It looks fine with classic theme. Could you file it to their project? Thanks, Takeshi KOMIYA 2016年9月28日水曜日 6時23分13秒 UTC+9 Luka Rahne: > > > I am trying to create nested and well formatted rst file like this: > > > > .. function:: level1 > > ..

[sphinx-users] Sphinx-1.5b1 has been released

Hi all, We just released 1.5b1. It includes much of improvements. I believe it will help you. Please let me us if you got errors with your docs. Thanks, Takeshi KOMIYA -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this

[sphinx-users] Re: :guilabel: is italic in PDF but bold in HTML

Hi, At Sphinx-1.4, Sphinx uses \sphinxmenuselection macro to represent guilabel and menuselection items. So you can override the macro to customize its style. What version do you use? BTW, the style difference between HTML and LaTeX is not good, indeed. Please file the problem to our tracker?

[sphinx-users] Re: ReadTheDocs colour customization

Hi, AFAIK, there are no options to modify colors: https://github.com/snide/sphinx_rtd_theme#configuration So additional CSS is needed to customize them. Thanks, Takeshi KOMIYA 2016年10月20日木曜日 8時02分52秒 UTC+9 Paolo Cavallini: > > Hi all, > I'm testing the RTD theme, and I'm finding it

[sphinx-users] Re: how do I add revision history table?

Hi, You can override the LaTeX macros in your conf.py: latx_elements = { 'preamble': """ \renewcommand{\maketitle}{% ... } """ } Anyway, you have to learn about LaTeX macros to customize LaTeX output. Thanks, Takeshi KOMIYA 2016年10月20日木曜日 8時03分01秒 UTC+9 E. Kelly: > > I'm having a similar

Re: [sphinx-users] Sphinx-1.4.9 has been released

? or it is going on? > thanks. > > -- > gilberto dos santos alves > +55(11)9-8646-5049 > sao paulo - sp - brasil > > > > > > 2016-11-23 12:45 GMT-02:00 Komiya Takeshi <i.tk...@gmail.com > >: > >> Hi all, >> >> I'm delighted to announce the

[sphinx-users] Sphinx-1.4.9 has been released

Hi all, I'm delighted to announce the release of Sphinx 1.4.9, now available on the Python package index at . It includes about 11 bug fixes for the 1.4.8 release series. For the full changelog, go to < http://www.sphinx-doc.org/en/stable/changes.html>.

Re: [sphinx-users] Call for translation updates

Hi gilberto, Sorry for late response. Now what we want to translate at this moment is the "Sphinx" project on transifex instead sphinx-doc-1.x. https://www.transifex.com/sphinx-doc/sphinx-1/dashboard/ It is used for the messages of Sphinx itself (for example, online help, warning messages and

[sphinx-users] Re: Sphinx-1.5a1 has been released

Hi, Originally, TocTree class is defined at sphinx.directives.other. so it is not moved. It is only imported at sphinx.directives. At 1.5a1, the imports are removed once. But I recovered it at current HEAD. Please wait 1.5a2. Thank you for reporting. Takeshi KOMIYA 2016年10月7日金曜日 9時24分39秒

[sphinx-users] Re: PDF version shows one huge chapter? Table of contents issues with latexpdf

> Can you give an example of how to use the orphan metadata tag? > Here: :orphan: Title of document == blah blah blah... > >- Where do I put the tag, in the file that is causing the build >warning or in the TOC file? > > The top of each files which are not listed

Re: [sphinx-users] Sphinx-1.4.7 released

st to verify: the latest stable release is now 1.4.8 correct? > (sphinx-doc.org states the current version is 1.4.9 which I believe is > an error) > > -jeff > > > > On 2016-10-01 11:05 AM, Komiya Takeshi wrote: > > Hi all, > > > > I'm delighted

[sphinx-users] Re: Table of Contents bar on the left is not correct.

Hi, I think globaltoc helps you. Please add following settings to your conf.py: html_sidebars = { '**': ['globaltoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html'], } In detail, please see the document: http://www.sphinx-doc.org/en/stable/config.html#confval-html_sidebars

[sphinx-users] Re: Is there any way to automatically add section titles to the genindex?

the source code of Sphinx, especially around index manager. Thanks, Takeshi KOMIYA 2016年10月11日火曜日 18時40分37秒 UTC+9 Minkai Li: > > if I want to do it ，what is the extension could I do？ > > 在 2016年8月27日星期六 UTC+8下午10:28:48，Komiya Takeshi写道： >> >> Hi, >> >>

[sphinx-users] Re: Text doesn't fit in simple table column - Latex-PDF export

Hi, That might come from the behavior of LaTeX engine. As a adhoc way, you can give a hint to LaTeX engine with following notation: .. tabularcolumns:: |p{1.0cm}|p{1.0cm}|L| = === Tag Required Description =

[sphinx-users] Re: PDF version shows one huge chapter? Table of contents issues with latexpdf

Bg/t7DTOBb7DX0Qfxq1iXewowx5A5Yut056QCLcB/s1600/Screen%2BShot%2B2016-10-12%2Bat%2B2.05.30%2BPM.png> > > > On Wednesday, October 12, 2016 at 1:20:29 PM UTC-4, Komiya Takeshi wrote: >> >> >> Can you give an example of how to use the orphan metadata tag? >>&g

[sphinx-users] Re: Text doesn't fit in simple table column - Latex-PDF export

Note: I filed this as following issues: https://github.com/sphinx-doc/sphinx/issues/3042 https://github.com/sphinx-doc/sphinx/issues/3043 2016年10月13日木曜日 11時47分19秒 UTC+9 Komiya Takeshi: > > Hi, > > That might come from the behavior of LaTeX engine. > As a adhoc way, you can give

[sphinx-users] Sphinx-1.5a2 has been released

Hi all, We just released 1.5a1. It includes much of improvements. I believe it will help you. Please let me us if you got errors with your docs. Thanks, Takeshi KOMIYA -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this

Re: [sphinx-users] Actual, working example of latex-pdf cover page?

Hi, At preamble part, The "@" sign is not expanded. Please use \makeatletter before that like following: 'preamble': r''' \makeatletter \renewcommand{\maketitle}{ \begin{titlepage} \noindent \Huge \@date \par \end{titlepage} }

[sphinx-users] Sphinx-1.5.1 has been released

Hi all, I'm delighted to announce the release of Sphinx 1.5.1, now available on the Python package index at . It includes about 1 new feature and 11 bug fixes for the 1.5 release series. For the full changelog, go to <

[sphinx-users] Re: Search bar shows the RST instead of HTML page

Hi, The `html_copy_source` will help you. http://www.sphinx-doc.org/en/1.4.9/config.html#confval-html_copy_source Thanks, Takeshi KOMIYA 2016年12月2日金曜日 7時33分41秒 UTC+9 E. Kelly: > > Two new comments - > > 1) I found another workaround, from the Sphinx GitHub site ( >

[sphinx-users] Re: var vs cvar vs ivar... What's the diff?

Hi, Unfortunately, there is no difference in these variables. I don't know the background of them. Anyway, I added the note to describe that. Thanks, Takeshi KOMIYA 2016年12月9日金曜日 15時50分32秒 UTC+9 Russell Weber: > > I noticed that there are several ways to document variables. > ivar > cvar > and

Re: [sphinx-users] Generating latex in index

Hi, AFAIK, there are no way to do that. The index directive does not support inline mark up. Thanks, Takeshi KOMIYA 2017-03-25 1:10 GMT+09:00 vibebusiness3 : > I am trying to include math in an index entry with: > > .. index:: :math:`f_n(x)` > > however sphinx puts the

Re: [sphinx-users] Strange behavior with include directive

Hi, The warnings come from that sphinx processed foo.rst twice. So please rename it to non .rst file or add it to exclude_patterns. Thanks, Takeshi KOMIYA 2017-03-18 7:46 GMT+09:00 vibebusiness3 : > Hello, > > I have a file called "chapter.rst" which is included in my

Re: [sphinx-users] Why does this warn? ":ref:" inside ".. only::"

Hi, Unfortunately, the "only" blocks are processed regardless of builders once. And be suppressed them in later process. So please use "suppress_warnings" configration to suppress it. Thanks, 2017-03-15 2:18 GMT+09:00 Pete : > I only want to include the text with

Re: [sphinx-users] How to handle 'display name' for add_object_type?

Hi, Sphinx.add_object_type() uses `sphinx.domains.std.GenericObject` for an implementation of the directives. It does not make entries unique. As a quick look, you should use your own directive class. Thanks, 2017-04-06 2:03 GMT+09:00 : > I am using Sphinx's

Re: [sphinx-users] Question about replace directive

Hi, How about this? .. |newpage| raw:: latex \newpage Thanks, 2017-04-06 0:22 GMT+09:00 vibebusiness3 : > Hello, I am trying to make a shortcut command to make pagebreaks in latex > output. I am doing this: > > .. |newpage| replace:: > >.. raw:: latex > >

Re: [sphinx-users] Parsing inline literals

Hi, Unfortunately, nested inline markup is not allowed in reST spec. http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#inline-markup Thanks, Takeshi KOMIYA 2017-04-14 23:32 GMT+09:00 Mark Peters : > Hi, > > Is it possible to parse an inline literal to

Re: [sphinx-users] How to put references at end of each chapter with Sphinx

Hi, AFAIK there are no way to do that. You might customize LaTeX builder as an extension. As a quick look, refsection environment makes "per chapter" bibliography in LaTeX. So it might be easily to make the extension.

Re: [sphinx-users] How to document my_package/__init__.py

Hi, 1) :members: option will help you 2) There are no way to do that Thanks, Takeshi KOMIYA 2017-03-01 22:56 GMT+09:00 andre seame : > Hello, > > > This is my code. > > > my_package (that contains __init__.py and fct1.py) > > __init__.py > > """ > .. automodule::

Re: [sphinx-users] How to make new directives

Hi, Did you see the tutorial? I hope it will help your development. http://www.sphinx-doc.org/en/stable/extdev/tutorial.html Thanks, Takeshi KOMIYA 2017-03-11 1:42 GMT+09:00 vibebusiness3 : > I'm looking for an efficient way to display math equations correctly in both >

Re: [sphinx-users] sphinx-build Segmentation fault (core dumped)

Hi, You can use -vvv or -P option for debugging. If you feel this is bug of Sphinx-core, please report to github issues. Thanks, 2017-03-11 6:05 GMT+09:00 Anh Nguyen : > Anybody run into this or know how to debug the source of the core dump? I'm > using sphinx 1.5.3 and

Re: [sphinx-users] Re: Relative paths - File not readable

Hi, Sphinx expects the project directory contains all documents and related files. So there are no proper way to access the images outside of the project. Please move it to under project directory. Thanks, Takeshi KOMIYA 2017-03-07 3:37 GMT+09:00 sajan mushini : > hey >

  1   2   3   4   5   6   >