Modifier la coloration syntaxique dans la documentation RST-Sphinx

Question

J'écris de la documentation dans RST et génère du code HTML avec Sphinx.

Dans les exemples de code, la commande que nous souhaitons que l'utilisateur entre en italique par défaut - est-il possible de mettre ce code en gras?

Par exemple ::

ACOS# this is some text that is currently italics but i would like it to be bold 

Answer 1

Le caractère # provoque le texte après qu'il soit interprété comme un commentaire. Il est rendu en italique par défaut. La règle CSS est pygments.css (situé dans _static dans le répertoire de sortie):

.highlight .c { color: #408090; font-style: italic } /* Comment */ 

Si vous voulez changer cela en gras, la règle devrait être:

.highlight .c { color: #408090; font-weight: bold } /* Comment */ 

Pour ce faire , vous pouvez le faire comme suit:

1. Copiez le fichier pygments.css par défaut dans le dossier _static dans votre projet Sphinx.

2. Modifiez la règle CSS comme ci-dessus.

3. Régénère la sortie du projet. Votre pygments.css personnalisé sera maintenant utilisé à la place de celui par défaut.

---

Voici une autre façon de le faire qui fonctionne avec-thème-sphynx Rtd.

1. Créer un fichier appelé mystyle.css et le mettre dans le répertoire _static de votre projet.

2. Ajouter cette ligne à conf.py (voir http://www.sphinx-doc.org/en/stable/config.html#confval-html_style):

   html_style = 'mystyle.css' 
   

3. Ajouter ce qui suit à mystyle.css:

   @import "css/theme.css"; 
   
   .highlight .c { font-weight: bold; font-style: normal } /* Comment */