some pages have no "next" and "prev" buttons

17 views
Skip to first unread message

驿窗

unread,
Jul 19, 2024, 12:57:31 AM (4 days ago) Jul 19
to sphinx...@googlegroups.com
Hi,

I have a project build with sphinx+rst+rtd.

But, today I found that some pages have next and prev buttons and some pages don't have those two buttons.
Page with next and prev buttons: https://www.ycproject.cn/gimp/toolsbox/1tools-move.html
Page without next and prev buttons: https://www.ycproject.cn/inkscape/inkscape-tools.html#inkscape-tools
 
What I  want is that all the page shoud show the two buttons.

Where should I look for the cause?

Rafael Fontenelle

unread,
Jul 19, 2024, 1:33:27 AM (4 days ago) Jul 19
to sphinx...@googlegroups.com

Hi,

Did you add a toctree to your Inkscape landing page?

toctree directive should tell Sphinx what's is the order (prev, next) to the docs. See https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#table-of-contents (there is also translated in zh-cn if you want)


--
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/5b6ea28f.441c.190c95a0a74.Coremail.classenu%40163.com.

驿窗

unread,
Jul 19, 2024, 5:14:20 AM (3 days ago) Jul 19
to sphinx...@googlegroups.com

Hi,


Following your tips, I found the cause of the problem.

There is a toctree in the Inkscape landing page.
But, I made a custom toc style and delete the default referenced docs which is used for link. So, there is only a toctree in the landing page, nothing else.

I added the default referenced docs back and run make clean html. Now the buttons appeared on my local. I will update my website next time.


Thanks a lot.


驿窗

unread,
Jul 19, 2024, 5:43:34 AM (3 days ago) Jul 19
to sphinx...@googlegroups.com

Hi,

This is for "

>>>Chinese speakers, I need feedback for you

>>>Rafael Fontenelle's profile photo

>>>Rafael Fontenelle

>>>unread,Jul 3, 2024, 5:23:29 AM
>>>Hello,

>>>Running sphinx-lint in the Simplified Chinese (zh_CN) translation files of Sphinx's own documentation reported some missing spaces between roles in the paragraphs, and I wonder whether >>>the locale requires to NOT have spaces (case which escaping would be a way out) or spaces can be added.

>>>For instance, for Sphinx FAQ in zh_CN, the translation file faq.po has (NOTE: a proper font might need to be installed see the translation):

>>>#: ../../sphinx/doc/faq.rst:19
>>>msgid ""
>>>"They are automatic in LaTeX output; for HTML, give a ``:numbered:`` option "
>>>"to the :rst:dir:`toctree` directive where you want to start numbering."
>>>msgstr ""
>>>"它们在LaTeX输出中是自动的;对于HTML,为:rst:方向:`toctree`指令,从中开始编"
>>>"号。"

>>>Notice how there is no space between ":rst:dir:`toctree`" (besides some wrong characters between).

"


I can not reply directly at the moment., so I write the reply here.


The problem should be that the Chinese translation may be machine translated, resulting in unrecognized sphinx+rst syntax.
The correct Chinese translation should not translate  :rst:dir:`toctree`.

I think the correct Chinese translation should be as follows:


msgstr ""

"它们在LaTeX输出中是自动的;对于HTML,在开始编号的位置"
"给:rst:dir:`toctree`指令一个 ``:numbered:`` 选项。"




--
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.
Reply all
Reply to author
Forward
0 new messages