狮身人面像: shields.io标记呈现，但在输出html中显示错误/不正确的信息，但是当从浏览器打开时URL是正确的。

Question

我对sphinx呈现shields.io徽章有这个问题。我用的是狮身人面像和读文档模板。

我想在我的index.rst文件中添加一系列徽章。这些URL在我的README.md - found 这里中正确工作--以标记形式编写，并在浏览器中打开它们时显示正确的徽章。

但是，当我在rst文件中使用相同的链接时，输出html似乎在从shields.io获取信息时遇到了一些问题。徽章确实显示，但要么根本不获取信息(如GitHubActions构建和CodeCov覆盖徽章)，要么获取正确的信息，但不按要求呈现(例如。pypi版本是橙色而不是蓝色)

这是我的徽章在index.html中的渲染方式：

​

​

我的rst如下(从shields.io网站的徽章编辑器复制粘贴条目)：

.. image:: https://img.shields.io/pypi/pyversions/mplStrater   :alt: PyPI - Python Version 

.. image:: https://img.shields.io/pypi/v/mplStrater?makecolor=blue :alt: PyPI - Version



.. image:: https://img.shields.io/github/release-date/giocaizzi/mplStrater :alt: GitHub Release Date

.. image:: https://img.shields.io/github/workflow/status/giocaizzi/mplStrater/mplStrater/main :alt: GitHub Workflow Status (branch)

.. image:: https://img.shields.io/codecov/c/github/giocaizzi/mplStrater :alt: Codecov

.. image:: https://requires.io/github/giocaizzi/mplStrater/requirements.svg?branch=main 
    :target: https://requires.io/github/giocaizzi/mplStrater/requirements/?branch=main
    :alt: Requirements Status

.. image:: https://img.shields.io/github/license/giocaizzi/mplStrater :alt: license

.. image:: https://img.shields.io/github/issues/giocaizzi/mplStrater :alt: issues

编辑

只是为了增加一些上下文。我还运行了make linkcheck命令，所有URL都在传递。

(           index: line   24) ok        https://img.shields.io/github/issues/giocaizzi/mplStrater:alt:issues
(           index: line   11) ok        https://img.shields.io/github/release-date/giocaizzi/mplStrater:alt:GitHubReleaseDate
(           index: line   21) ok        https://img.shields.io/github/license/giocaizzi/mplStrater:alt:license
(           index: line   15) ok        https://img.shields.io/codecov/c/github/giocaizzi/mplStrater:alt:Codecov
(           index: line    2) ok        https://requires.io/github/giocaizzi/mplStrater/requirements.svg?branch=main
(           index: line    9) ok        https://img.shields.io/pypi/v/mplStrater?makecolor=blue:alt:PyPI-Version
(           index: line   46) ok        https://github.com/giocaizzi
(           index: line   13) ok        https://img.shields.io/github/workflow/status/giocaizzi/mplStrater/mplStrater/main:alt:GitHubWorkflowStatus(branch)
(           index: line    5) ok        https://img.shields.io/pypi/pyversions/mplStrater:alt:PyPI-PythonVersion
(           index: line    2) ok        https://requires.io/github/giocaizzi/mplStrater/requirements/?branch=main

我所使用的用于处理项目和编写文档的环境如下。对文档文档包的唯一严格要求是docutils=0.16，因为read-the-docs模板中的公告没有解决一个错误(据我所调查)。

name: geo
channels:
  - defaults
  - conda-forge
dependencies:
  - python=3.7
  - geopandas
  - matplotlib
  - numpy>=1.17
  - pandas
  - rasterio
  - rio-color
  - ipython
  - ipykernel
  - pytest
  - pytest-cov
  - sphinx
  - sphinx_rtd_theme
  - myst-parser
  - nbsphinx
  - docutils=0.16

Answer 1

正如@Steve piercy所建议的，您编写图像标记的方式不尊重.rst指令格式：

.. directive:: main_arg
   :option1: value1
   :option2: value2

在您的例子中，原始的.md徽章如下所示：

[![Requirements Status](https://requires.io/github/giocaizzi/mplStrater/requirements.svg?branch=main)](https://requires.io/github/giocaizzi/mplStrater/requirements/?branch=main)

有3项资料：

• 图片：https://requires.io/github/giocaizzi/mplStrater/requirements.svg?branch=main
• alt值:需求状态
• 链接的目标：https://requires.io/github/giocaizzi/mplStrater/requirements/?branch=main

可以很容易地在.rst中设置：

.. image:: https://requires.io/github/giocaizzi/mplStrater/requirements.svg?branch=main
   :alt: Requirements Status
   :target: https://requires.io/github/giocaizzi/mplStrater/requirements/?branch=main