在 sphinx 中创建一个与“make latexpdf”一起使用的角色（字体颜色）

Question

我习惯写 Rest 文档，但我从不使用 LaTex。

我想做的是创建一些字体颜色角色，我可以添加内嵌文本（例如：red:this text is red），这些文本既适用于 html 也适用于 latexpdf 编译。 p>

我发现了一个类似的问题here，但我无法重现它。

我认为 magic 将完成更改 conf.py 文件，但我不知道如何。

另外，在latexpdf编译的过程中，_build/latex目录下有一个sphinx.sty文件，里面包含了很多东西，用于定制最终的pdf文件。

如果我想更改最终 pdf 文件的某些参数，我是否要编辑这个文件，把它放在某个地方并告诉 sphinx 采用这个样式文件？

对不起，我有点困惑..

谢谢！

Answer 1

只需添加：

1. 一个'source/_templates/layout.html'文件

   {% extends "!layout.html" %}
   
   {% block extrahead %}
   <link rel="stylesheet" type="text/css" 
        href="{{ pathto('_static/custom.css', 1) }}" /> 
   
   {% endblock %}
   

2. 一个'source/_static/custom.css'文件

   @import url("default.css");
   
   .red {
     color: red;
   }
   

您现在可以在您的 rst 文件中使用 :red: 角色。不要忘记 html 或 css 版本后的反勾号和干净的目标：

A :red:`red`text

$> make clean html

全局树：

test-sphinx
├── Makefile
├── build
└── source
    ├── _static
    │   └── custom.css
    ├── _templates
    │   └── layout.html
    ├── conf.py
    └── index.rst

一个 index.rst 示例：

TS test!
========

.. role:: red

This is :red:`just` a test …

希望对您有所帮助，

安东尼