ReST barré

J’ai vérifié les documents, comme suggéré par Ville Säävuori, et j’ai décidé d’append le barré comme ceci:

 .. role:: ssortingke :class: ssortingke 

Dans le document, cela peut être appliqué comme suit:

 :ssortingke:`This text is crossed out` 

Puis dans mon fichier css j’ai une entrée:

 .ssortingke { text-decoration: line-through; } 

Il y a au moins trois façons de le faire:

 .. role:: ssortingke An example of :ssortingke:`ssortingke through text`. .. container:: ssortingke Here the full block of test is ssortingked through. An undecorated paragraph. .. class:: ssortingke This paragraph too is is ssortingked through. .. admonition:: cancelled :class: ssortingke I ssortingke through cancelled text. 

Après avoir appliqué rst2html vous obtenez:

 
An example of ssortingke through text.
 
 Here the full block of test is ssortingked through.
 
An undecorated paragraph.
 
This paragraph too is is ssortingked through.
 
 
cancelled
 
I ssortingke through cancelled text. 

Vous les utilisez avec un style

 .ssortingke { text-decoration: line-through; } 

Ici, j’ai pris la directive d’ admonition comme exemple, mais toute directive autorisant l’option :class: ferait l’affaire.

Comme elle génère un span la directive role est la seule qui permet d’appliquer votre style à une partie d’un paragraphe.

Il est redondant d’append une ssortingke classe à une directive appelée aussi ssortingke , comme le suggère Gozzilli, car le nom de la directive est la classe par défaut pour la sortie html.

J’ai vérifié ces syntaxes à la fois avec rest2html et Sphinx . Mais alors que tout fonctionne comme prévu avec rest2html la directive de class échoue avec Sphinx . Vous devez le remplacer par

 .. rst-class:: ssortingke This paragraph too is is ssortingked through. 

Ceci n’est indiqué que dans une petite note de bas de page du Sphinx ReSt Primer .

Selon les spécifications officielles, il n’y a pas de directive pour le balisage barré dans ReST.

Cependant, si l’environnement permet: raw: role ou si vous pouvez écrire vos propres rôles, vous pouvez écrire un plug-in personnalisé pour cela.

J’ai trouvé les autres réponses très utiles. Je ne connais pas très bien Sphinx mais je l’utilise pour un projet. Moi aussi je voulais la capacité de grève et je l’ai fait fonctionner sur la base des réponses précédentes. Pour être clair, j’ai ajouté mon rôle barré comme mentionné par gozzilli, mais je l’ai enregistré dans mon fichier conf.py en utilisant la variable rst_prolog comme indiqué dans le thread de débordement de stack ici . Cela signifie que ce rôle est disponible pour tous vos fichiers de repos.

J’ai ensuite étendu le modèle HTML de base comme décrit ci-dessus en créant layout.html dans _templates intérieur de mon répertoire source. Le contenu de ce fichier est le suivant:

 {% extends "!layout.html" %} {% set css_files = css_files + ["_static/myStyle.css"] %} 

Cela inclut essentiellement un fichier css personnalisé à tous vos documents HTML construits par défaut.

Enfin, dans mon répertoire _static dans mon répertoire source, j’ai inclus le fichier myStyle.css qui contient:

 .ssortingke { text-decoration: line-through; } 

Ce que les autres réponses ont déjà fourni.

J’écris simplement cette réponse car cela ne me semblait pas évident avec mon expérience limitée de Sphinx sur les fichiers à éditer.