[sphinx-users] citation using Sphinx
Hi, I am trying to include some bibliography in my docs. I have used sphinxcontrib-bibtex, but now I am exploring the possibility to only use simple Sphinx/docutils. For my purposes, the standard docutils machinery works ok. I can generate a rst file with all citations and include in a toctree. Then I can use the proper syntax to refer to the entries. It seems to work. My question is: is there any way to tell sphinx to only show the citation that are only referenced somewhere in the docs? -- 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 http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
Re: [sphinx-users] navigation bar has disappeared
On 2015-09-24 6:40 PM, Luc Saffre wrote:
Hi,
I noticed that Sphinx no longer seems to generate the navigation bar
(with parent and previous|next links). I noticed this after moving to a
new machine, so there are a lot of details that might have possibly
changed. But I cannot find the reason.
The problem is visible for example on this page:
http://www.lino-framework.org/dev/index.html
There is no navigation bar.
All source files of this doctree can be browsed here:
https://github.com/lsaffre/lino/tree/master/docs
I am using Takayuki's trick of adding a custom css rule:
div.related { display: block; }
I tried with 1.3.1 and 1.3.0 (the current development version failed for
some complex reason), and versions <1.3 are no candidates since it
hasbgeen working with 1.3 some weeks ago.
It seems that the relbar() nmacro defined in `themes/basic/layout.html`
gets never executed.
I am stuck, and it is a bit sad because my mentioned document is
difficult to read without the navigation bar.
Any idea or hint?
Luc
Hi Luc,
Did you solve this? I am facing the exact same issue as you (on
http://mapserver.org), missing navigation bar, with 1.3.1
I am not sure why it doesn't show.
-jeff
--
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 http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
Re: [sphinx-users] navigation bar has disappeared
Hey cool! Thanks for sharing this! I can confirm this behaviour. I added
these lines to my layout.html templates:
{% block relbar1 %}
{{relbar() }}
{{ super() }}
{% endblock %}
{% block relbar2 %}
{{relbar() }}
{{ super() }}
{% endblock %}
Looks indeed as if the relbar() macro no longer gets called by the
default relbarN blocks.
I don't see that duplicate navigation bar (probably because before I had
no bar at all on all my doctrees).
I am using Sphinx 1.3.1 and Jinja2 version 2.8. Please verify your Jinja
versions (the problem might be there).
My problem is fixed (though not in an elegant way).
Luc
On 20/10/15 20:26, Jeff McKenna wrote:
> I just discovered that adding relbar() will cause duplicate navigation
> bars on my local machine, and one on the remote server (why??). I've
> also never had to use that function call before (why??). Also, with
> that addition we can now see a navigation bar for the default navigation
> page, but not for any of our sphinx-translated pages in other languages
> (how to get that bar on those other pages?). This is very confusing.
> Here is the ugly new layout.html
>
> {% extends "!layout.html" %}
>
> {% block relbar1 %}
> {{relbar() }}
> {{ super() }}
> {% endblock %}
>
> {{ super() }}
> {% endblock %}
>
>
> -jeff
>
>
>
> On 2015-10-20 1:00 PM, Jeff McKenna wrote:
>> I have even cleaned it so it my layout.html file is bare bones, and the
>> relbar still doesn't show on that machine:
>>
>> {% extends "!layout.html" %}
>>
>>{% block relbar1 %}
>> {{ super() }}
>>{% endblock %}
>>
>>{{ super() }}
>> {% endblock %}
>>
>> -jeff
>>
>>
>>
>>
>> On 2015-10-20 12:42 PM, Jeff McKenna wrote:
>>> Here is my layout,html contents (I don't see why relbar would be left
>>> out on some machines):
>>>
>>>{% extends "!layout.html" %}
>>>
>>>{% block relbar1 %}
>>>
>>> (some stuff)
>>>
>>>{{ super() }}
>>>{% endblock %}
>>>
>>>
>>> -jeff
>>>
>>>
>>>
>>>
>>> On Tuesday, October 20, 2015 at 12:06:48 PM UTC-3, Luc Saffre wrote:
>>>
>>> Hi Jeff,
>>>
>>> thanks for asking. No, unfortunately I did not yet find a solution
>>> for
>>> this problem. Did you also use Takayuki's trick of adding a custom
>>> css
>>> rule? As the problem is just irritating and not fatal, I am still
>>> hoping
>>> for an idea or hint from this group before diving back into it.
>>>
>>> Luc
>>>
>>> On 20/10/15 17:48, Jeff McKenna wrote:
>>> > On 2015-09-24 6:40 PM, Luc Saffre wrote:
>>> >> Hi,
>>> >>
>>> >> I noticed that Sphinx no longer seems to generate the navigation
>>> bar
>>> >> (with parent and previous|next links). I noticed this after
>>> moving to a
>>> >> new machine, so there are a lot of details that might have
>>> possibly
>>> >> changed. But I cannot find the reason.
>>> >>
>>> >> The problem is visible for example on this page:
>>> >>
>>> >> http://www.lino-framework.org/dev/index.html
>>>
>>> >>
>>> >> There is no navigation bar.
>>> >>
>>> >> All source files of this doctree can be browsed here:
>>> >>
>>> >> https://github.com/lsaffre/lino/tree/master/docs
>>>
>>> >>
>>> >> I am using Takayuki's trick of adding a custom css rule:
>>> >>
>>> >>div.related { display: block; }
>>> >>
>>> >> I tried with 1.3.1 and 1.3.0 (the current development version
>>> failed for
>>> >> some complex reason), and versions <1.3 are no candidates
>>> since it
>>> >> hasbgeen working with 1.3 some weeks ago.
>>> >>
>>> >> It seems that the relbar() nmacro defined in
>>> `themes/basic/layout.html`
>>> >> gets never executed.
>>> >>
>>> >> I am stuck, and it is a bit sad because my mentioned document is
>>> >> difficult to read without the navigation bar.
>>> >>
>>> >> Any idea or hint?
>>> >>
>>> >> Luc
>>> >>
>>> >
>>> > Hi Luc,
>>> >
>>> > Did you solve this? I am facing the exact same issue as you (on
>>> > http://mapserver.org), missing navigation bar, with 1.3.1
>>> >
>>> > I am not sure why it doesn't show.
>>> >
>>> > -jeff
>>> >
>>> >
>>> >
>>>
>>> --
>>> 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 http://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
Re: [sphinx-users] navigation bar has disappeared
Glad my hack worked for you (I can see it at the top of your page now).
But in my case, it only appears for the default page, English
(http://www.mapserver.org/). By chance, your site doesn't use
translations, right? For some reason, my relbar() call is only being
applied to the default language (if I click German for example, it
disappears http://www.mapserver.org/de/index.html).
Boy this is tricky,
-jeff
On Tuesday, October 20, 2015 at 2:59:26 PM UTC-3, Luc Saffre wrote:
>
> Hey cool! Thanks for sharing this! I can confirm this behaviour. I added
> these lines to my layout.html templates:
>
> {% block relbar1 %}
> {{relbar() }}
> {{ super() }}
> {% endblock %}
>
> {% block relbar2 %}
> {{relbar() }}
> {{ super() }}
> {% endblock %}
>
> Looks indeed as if the relbar() macro no longer gets called by the
> default relbarN blocks.
> I don't see that duplicate navigation bar (probably because before I had
> no bar at all on all my doctrees).
>
> I am using Sphinx 1.3.1 and Jinja2 version 2.8. Please verify your Jinja
> versions (the problem might be there).
>
> My problem is fixed (though not in an elegant way).
>
> Luc
>
>
> On 20/10/15 20:26, Jeff McKenna wrote:
> > I just discovered that adding relbar() will cause duplicate navigation
> > bars on my local machine, and one on the remote server (why??). I've
> > also never had to use that function call before (why??). Also, with
> > that addition we can now see a navigation bar for the default navigation
> > page, but not for any of our sphinx-translated pages in other languages
> > (how to get that bar on those other pages?). This is very confusing.
> > Here is the ugly new layout.html
> >
> > {% extends "!layout.html" %}
> >
> > {% block relbar1 %}
> > {{relbar() }}
> > {{ super() }}
> > {% endblock %}
> >
> > {{ super() }}
> > {% endblock %}
> >
> >
> > -jeff
> >
> >
> >
> > On 2015-10-20 1:00 PM, Jeff McKenna wrote:
> >> I have even cleaned it so it my layout.html file is bare bones, and the
> >> relbar still doesn't show on that machine:
> >>
> >> {% extends "!layout.html" %}
> >>
> >>{% block relbar1 %}
> >> {{ super() }}
> >>{% endblock %}
> >>
> >>{{ super() }}
> >> {% endblock %}
> >>
> >> -jeff
> >>
> >>
> >>
> >>
> >> On 2015-10-20 12:42 PM, Jeff McKenna wrote:
> >>> Here is my layout,html contents (I don't see why relbar would be left
> >>> out on some machines):
> >>>
> >>>{% extends "!layout.html" %}
> >>>
> >>>{% block relbar1 %}
> >>>
> >>> (some stuff)
> >>>
> >>>{{ super() }}
> >>>{% endblock %}
> >>>
> >>>
> >>> -jeff
> >>>
> >>>
> >>>
> >>>
> >>> On Tuesday, October 20, 2015 at 12:06:48 PM UTC-3, Luc Saffre wrote:
> >>>
> >>> Hi Jeff,
> >>>
> >>> thanks for asking. No, unfortunately I did not yet find a solution
> >>> for
> >>> this problem. Did you also use Takayuki's trick of adding a custom
> >>> css
> >>> rule? As the problem is just irritating and not fatal, I am still
> >>> hoping
> >>> for an idea or hint from this group before diving back into it.
> >>>
> >>> Luc
> >>>
> >>> On 20/10/15 17:48, Jeff McKenna wrote:
> >>> > On 2015-09-24 6:40 PM, Luc Saffre wrote:
> >>> >> Hi,
> >>> >>
> >>> >> I noticed that Sphinx no longer seems to generate the
> navigation
> >>> bar
> >>> >> (with parent and previous|next links). I noticed this after
> >>> moving to a
> >>> >> new machine, so there are a lot of details that might have
> >>> possibly
> >>> >> changed. But I cannot find the reason.
> >>> >>
> >>> >> The problem is visible for example on this page:
> >>> >>
> >>> >> http://www.lino-framework.org/dev/index.html
> >>>
> >>> >>
> >>> >> There is no navigation bar.
> >>> >>
> >>> >> All source files of this doctree can be browsed here:
> >>> >>
> >>> >> https://github.com/lsaffre/lino/tree/master/docs
> >>>
> >>> >>
> >>> >> I am using Takayuki's trick of adding a custom css rule:
> >>> >>
> >>> >>div.related { display: block; }
> >>> >>
> >>> >> I tried with 1.3.1 and 1.3.0 (the current development version
> >>> failed for
> >>> >> some complex reason), and versions <1.3 are no candidates
> >>> since it
> >>> >> hasbgeen working with 1.3 some weeks ago.
> >>> >>
> >>> >> It seems that the relbar() nmacro defined in
> >>> `themes/basic/layout.html`
> >>> >> gets never executed.
> >>> >>
> >>> >> I am stuck, and it is a bit sad because my mentioned document
> is
> >>> >> difficult to read without the navigation bar.
> >>> >>
> >>> >> Any idea or hint?
> >>> >>
> >>> >> Luc
> >>> >>
> >>>
Re: [sphinx-users] navigation bar has disappeared
Yes, my site doesn't use translations. Yes, this is tricky. Did you try
changing your `site-packages/sphinx/themes/basic/layout.html` file for
debugging?
Luc
On 21/10/15 01:18, Jeff McKenna wrote:
> Glad my hack worked for you (I can see it at the top of your page now).
> But in my case, it only appears for the default page, English
> (http://www.mapserver.org/). By chance, your site doesn't use
> translations, right? For some reason, my relbar() call is only being
> applied to the default language (if I click German for example, it
> disappears http://www.mapserver.org/de/index.html).
>
> Boy this is tricky,
>
> -jeff
>
>
> On Tuesday, October 20, 2015 at 2:59:26 PM UTC-3, Luc Saffre wrote:
>
> Hey cool! Thanks for sharing this! I can confirm this behaviour. I
> added
> these lines to my layout.html templates:
>
> {% block relbar1 %}
> {{relbar() }}
> {{ super() }}
> {% endblock %}
>
> {% block relbar2 %}
> {{relbar() }}
> {{ super() }}
> {% endblock %}
>
> Looks indeed as if the relbar() macro no longer gets called by the
> default relbarN blocks.
> I don't see that duplicate navigation bar (probably because before I
> had
> no bar at all on all my doctrees).
>
> I am using Sphinx 1.3.1 and Jinja2 version 2.8. Please verify your
> Jinja
> versions (the problem might be there).
>
> My problem is fixed (though not in an elegant way).
>
> Luc
>
>
> On 20/10/15 20:26, Jeff McKenna wrote:
> > I just discovered that adding relbar() will cause duplicate
> navigation
> > bars on my local machine, and one on the remote server (why??). I've
> > also never had to use that function call before (why??). Also, with
> > that addition we can now see a navigation bar for the default
> navigation
> > page, but not for any of our sphinx-translated pages in other
> languages
> > (how to get that bar on those other pages?). This is very
> confusing.
> > Here is the ugly new layout.html
> >
> > {% extends "!layout.html" %}
> >
> > {% block relbar1 %}
> > {{relbar() }}
> > {{ super() }}
> > {% endblock %}
> >
> > {{ super() }}
> > {% endblock %}
> >
> >
> > -jeff
> >
> >
> >
> > On 2015-10-20 1:00 PM, Jeff McKenna wrote:
> >> I have even cleaned it so it my layout.html file is bare bones,
> and the
> >> relbar still doesn't show on that machine:
> >>
> >> {% extends "!layout.html" %}
> >>
> >>{% block relbar1 %}
> >> {{ super() }}
> >>{% endblock %}
> >>
> >>{{ super() }}
> >> {% endblock %}
> >>
> >> -jeff
> >>
> >>
> >>
> >>
> >> On 2015-10-20 12:42 PM, Jeff McKenna wrote:
> >>> Here is my layout,html contents (I don't see why relbar would be
> left
> >>> out on some machines):
> >>>
> >>>{% extends "!layout.html" %}
> >>>
> >>>{% block relbar1 %}
> >>>
> >>> (some stuff)
> >>>
> >>>{{ super() }}
> >>>{% endblock %}
> >>>
> >>>
> >>> -jeff
> >>>
> >>>
> >>>
> >>>
> >>> On Tuesday, October 20, 2015 at 12:06:48 PM UTC-3, Luc Saffre
> wrote:
> >>>
> >>> Hi Jeff,
> >>>
> >>> thanks for asking. No, unfortunately I did not yet find a
> solution
> >>> for
> >>> this problem. Did you also use Takayuki's trick of adding a
> custom
> >>> css
> >>> rule? As the problem is just irritating and not fatal, I am
> still
> >>> hoping
> >>> for an idea or hint from this group before diving back into it.
> >>>
> >>> Luc
> >>>
> >>> On 20/10/15 17:48, Jeff McKenna wrote:
> >>> > On 2015-09-24 6:40 PM, Luc Saffre wrote:
> >>> >> Hi,
> >>> >>
> >>> >> I noticed that Sphinx no longer seems to generate the
> navigation
> >>> bar
> >>> >> (with parent and previous|next links). I noticed this after
> >>> moving to a
> >>> >> new machine, so there are a lot of details that might have
> >>> possibly
> >>> >> changed. But I cannot find the reason.
> >>> >>
> >>> >> The problem is visible for example on this page:
> >>> >>
> >>> >> http://www.lino-framework.org/dev/index.html
>
> >>> >
> >>> >>
> >>> >> There is no navigation bar.
> >>> >>
> >>> >> All source files of this doctree can be browsed here:
> >>> >>
> >>> >> https://github.com/lsaffre/lino/tree/master/docs
>
> >>>
