Providing an "online link" in the page footer

14 views
Skip to first unread message

Luc Saffre

unread,
Aug 18, 2020, 11:01:37 AM8/18/20
to sphinx...@googlegroups.com
Hello,

in my footer template I usually have something like this::

  <a href="https://www.lino-framework.org/{{ pagename|e }}.html">Online link</a>

It's practical for me because usually I watch the generated output in my local build, but sometimes I want to see the published version of it.

The trick works perfectly for me, except on sites where I use the dirhtml builder. On such a site a can remove the ".html" in the href::

  <a href="https://www.lino-framework.org/{{ pagename|e }}">Online link</a>

which works for most pages, but *not* for the index.rst page of a directory. Any thoughts on this?

Luc

Matt from Documatt

unread,
Aug 21, 2020, 7:58:00 AM8/21/20
to sphinx...@googlegroups.com
Hello Luc,
I use the following to "am I on the master page?" (usually file index.rst).

Somewhere near to the top of template I define (in action):

{%- set ismasterdoc = pagename == master_doc -%}

Later:

{% if ismasterdoc %}
  <a href="https://www.lino-framework.org/">Online link</a>
{% else %}
  <a href="https://www.lino-framework.org/{{ pagename|e }}/">Online link</a>
{% endif %}

Matt

--
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 view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/85e0e0a5-5334-fae1-db3c-c9ad2046fc70%40gmail.com.

Luc Saffre

unread,
Aug 24, 2020, 9:41:17 PM8/24/20
to sphinx...@googlegroups.com, Matt from Documatt
Thanks, Matt.  I got inspired by your idea and now use this::

  {%- set url = "https://www.example.com/" + (pagename[:-5] if pagename.endswith('index') else pagename +"/") -%}
  Online link: <a href="{{url}}">{{url}}</a>.

Your example worked on the master page but not on the lower level directories.

Luc
Reply all
Reply to author
Forward
0 new messages