小编mzj*_*zjn的帖子

我的index.rst中有一个toctree看起来像这样:

.. toctree::
   :maxdepth: 2

   cat
   dog
   moose

我希望使用'api documentation' 来嵌套我的toctree的内容,类似于这里的内容:

所以最终做出类似的事情:

.. toctree::
   :maxdepth: 2
   :dropdown Animals
     cat
     dog
     moose

但我似乎无法在文档中找到任何可以做到这一点的内容.

我正在按照 numpy 文档字符串指南编写文档字符串。然后我使用 sphinx 的 autodoc 生成我的文档。在一些文档字符串中，我使用 LaTeX 公式（sphinx.ext.mathjax）。似乎这\r意味着一些特殊的事情，比如一条新线。如果我有以下命令：

"""
This :math:`\langle a, b\rangle` denotes the dot product of a and b
"""

它无法正确渲染。它将类似角度放入新行并给我一个错误：内联解释文本或短语引用起始字符串没有结束字符串 如果我用 \langle 替换 \rangle 一切正常。我怎样才能解决这个问题？

我在使用BeautifulSoup 抓取电子商务网站时遇到问题。我做了一些谷歌搜索，但仍然无法解决问题。

请参考图片：

1个 Chrome F12：

2 结果：

这是我尝试抓取的网站：“ https://shopee.com.my/search?keyword=h370m ”

问题：

1. 当我尝试在Google Chrome（F12）上打开Inspect Element时，可以看到产品名称，价格等信息。但是，当我运行python程序时，在python结果中无法获得相同的代码和标记。经过一番谷歌搜索后，我发现该网站使用AJAX查询来获取数据。

2. 任何人都可以通过抓取AJAX网站来帮助我找到获取这些产品数据的最佳方法吗？我想以表格形式显示数据。

我的代码：

import requests
from bs4 import BeautifulSoup
source = requests.get('https://shopee.com.my/search?keyword=h370m')
soup = BeautifulSoup(source.text, 'html.parser')
print(soup)

我发现.. include::指令对于文本重用非常有用：相同的部分可以插入到不同的文档中。

但是标题级别存在问题。

例如，如果我有part.rst二级标题

part.rst

Header level 2
----------------

My text to be included

并将其包含在具有各种标题级别的不同文档中

doc 1

Header level 1
================

.. include::  part.rst

doc2

Header level 2
----------------

.. include::  part.rst

doc 3

Header level 3
~~~~~~~~~~~~~~~~~

.. include::  part.rst

永远都是2级。控制不了。

我读过关于sphinx.ext.ifconfig – Include content based on configuration，我可以用

part.rst

.. ifconfig:: hide_part_rst_title

    Header level 2
    ----------------

My text to be included

但是看起来在许多零件文件的情况下创建了许多变量。

可能有更优雅的方式吗？

如何包含.rst没有原始标题的文件？如果我裁剪这个，我可以像这样在每个地方添加一个标题

.. doc 1
Header level 1
================ …

我试图根据 Web 应用程序的要求隐藏 fo:table 行或列线，所以我曾经设置border-style="none"为fo:table-column或fo:table-row根据需要，但是当我尝试它时，它要么在行中创建黑线（如果我隐藏列线）或在列中创建黑线（如果我隐藏行线）。

如果列行被隐藏：

如果行行被隐藏：

我的 XSL：

<?xml version="1.0" encoding="UTF-8"?>
    <xsl:stylesheet version="1.0"
        xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
        xmlns:fo="http://www.w3.org/1999/XSL/Format">
        <xsl:template match="pages">
            <fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
                <fo:layout-master-set>
                    <fo:simple-page-master master-name="simple"
                        page-height="8.5in" page-width="11in" margin-top=".5in"
                        margin-bottom=".5in" margin-left=".5in" margin-right=".5in">
                        <fo:region-body margin-top="2cm" margin-bottom="2cm" />
                        <fo:region-before extent="2cm" overflow="hidden" />
                        <fo:region-after extent="1cm" overflow="hidden" />
                    </fo:simple-page-master>
                </fo:layout-master-set>
                <fo:page-sequence master-reference="simple"
                    initial-page-number="1">
                    <fo:static-content flow-name="xsl-region-before">
                        <fo:block font-size="13.0pt" font-family="serif"
                            padding-after="2.0pt" space-before="4.0pt" text-align="center"
                            border-bottom-style="solid" border-bottom-width="1.0pt">
                            <fo:block>IF COLUMN LINES HIDED</fo:block>
                        </fo:block>
                    </fo:static-content>
                    <fo:static-content flow-name="xsl-region-after">
                        <fo:block font-size="12.0pt" font-family="sans-serif"
                            padding-after="2.0pt" space-before="2.0pt" text-align="center"
                            border-top-style="solid" border-bottom-width="1.0pt">
                            <xsl:text>Page</xsl:text>
                            <fo:page-number …

我可以使用“import xml.etree.ElementTree as et”读取 xml 文件。但我的问题是读取数据文件中给出的注释文本，如何读取：例如在下面的 xml 中，我想读取BaseVehicle是1997 Cadillac Catera

<App action="A" id="1">
    <BaseVehicle id="8559"/>
    <!--  1997 Cadillac Catera  -->
    <Qty>1</Qty>
    <PartType id="4472"/>
    <!--  Electrical/Headlight/Switch  -->
    <Part>SW1406</Part>
</App>

我在向 Sphinx .html 文件添加自定义页脚时遇到一些问题。我正在使用sphinx_rtd_theme。我已经检查了这篇文章并尝试了它（以及评论中的一些建议）但无济于事。我不确定我错过了什么。如果我没有在这里发布足够的内容来实际指出导致问题的原因，我深表歉意。任何帮助或建议表示赞赏！

我的 css 主题文件已被我自己（很差地）修改过（我不是 HTML/CSS 人员！），但我认为这并不重要？我唯一能想到的另一件事是，当我重新编译输出文件时，也许我必须做一些特别的事情。我只是使用：

make clean html && make html

我的conf.py位于：root/source/conf.py。以下是我的conf.py文件的一些摘录：

import sphinx_rtd_theme

project = 'Project Name'
copyright = '2021, My Company'
author = 'My Name, Coworker Name'
master_doc = 'Home'
extensions = ["sphinx_rtd_theme", "sphinx.ext.todo"]
todo_include_todos = True
templates_path = ['_templates']
source_suffix = ['.rst']
html4_writer = True
html_theme = 'sphinx_rtd_theme'
# html_theme_path = ['_static']
html_static_path = ['_static']
# html_extra_path = []
html_show_sphinx = True
html_show_copyright …

我正在第一次使用 Sphinx 进行一个项目，并想创建一个方法（我不确定这是否是它的名字，但类似于编程方法，只是执行特定任务的文本正文）来更改我的 Sphinx 项目中的字体。我发现了一个有用的问题，可以让我在这里更改文本的颜色。

下面用于更改颜色的代码。

.. raw:: html

    <style> .red {color:red} </style>

之后，我简单地添加了

.. role:: red

对于我的 .rst 文件，允许我通过简单地使用来调用此方法

:red:`Text here is red.`

同样，我试图这样做是为了在需要时更改文本的字体，而不是整个项目的字体。这是我的调整版本。

.. raw:: html

    <p style="font-family:'Courier New'"> .font </p>

.. role:: font

这有效，有点......在我使用“make html”编译后，我的html页面只会显示新字体中的“.font”，当我尝试调用

:font:`new font here`

和以前一样，它不会改变文本。

任何有关如何使其正常工作的建议将不胜感激。谢谢。

当使用 Github 页面托管 Sphinx 文档时，可能需要为代码的不同分支或标签托管同一文档的多个版本。但是，两者sphinxcontrib-multiversion都sphinxcontrib-versioning没有得到积极维护，并且不能与最新版本的 Sphinx 一起使用。

如果不想使用 ReadTheDocs，并且想坚持 Alabaster 主题，那么正确的解决方案是什么？

win32上的Python 2.7.2(默认,2011年6月12日,14:24:46)[MSC v.1500 64位(AMD64)].

>>> locale.getdefaultlocale()
('ru_RU', 'cp1251')  #ok, Russian locale is set, as per user settings
>>> a  = datetime.date.today()
>>> a.strftime("%B %d")
March 22' #ouch, that's not Russian.
>>> locale.setlocale(locale.LC_ALL, 'russian_russia')
'Russian_Russia.1251'
>>> a.strftime("%B %d")
'???? 22' #now it's ok

那么......为什么不重置默认语言环境不行呢？它与操作系统有关吗？有办法做某事locale.setlocale(convert_it_somehow(locale.getdefaultlocale()))吗？我想要做的就是根据用户的偏好显示日期.谢谢!