2

私は個人的な「ハウツー」ガイドを手がかりにしています。RSTのコードブロックにコピーボタンを追加する方法/ドキュメントを読む

私はこの長さのコードに遭遇したときに、ページ全体を強調表示せずにブロックを強調表示しようと常に不満を募らせていました。

だから、私の質問は、rst(reStructuredTextの).. code-block::年代のために、ユーザのクリップボードにテキストを追加する自動ハイライトのために、または自動的に、アドオンやcopyボタンを追加する方法はありますか?または、これはビルドに含める必要があり、コードブロックで参照するよりhtml-literal型のコードですか?もしそうなら、そのようなものはどんなものでしょうか?

答えて

1

Sphinxプロジェクトでは、HTMLページの表示はテンプレート言語(デフォルトではJinja2)を使用して制御されます。そのため、HTMLテンプレートファイルにJavascriptを追加することでページをよりインタラクティブにすることができ、Sphinxがその特定のテンプレートファイルを使用してページをレンダリングするときに挿入されます。

あなたconf.py

神社テンプレートは、互いを拡張することができますので、あなたはおそらく{% extends "basic/layout.html" %}で始まるファイルを望んでtemplates_pathを検索することで、テンプレートのディレクトリを検索します。

、あなたの変更をしたい拡張子の順序で、あなたが結合する必要がある場所を追跡したら:

  • あなたはこれを有効にするページ(通常はメインブロック)のセクション
  • コードブロックのクラスを持つCSS(例えば、私のものはclass=highlightです)。ボタンを作成し、クリップボード(例えば。https://clipboardjs.com/

次への書き込み、ローカルSphinxのプロジェクトをビルドするためにはJavaScriptスニペット.CSSファイルがうまくドキュメントにあるかもしれない/ソース/ _static/

  • A(make html)あなたがそれをダイヤルインして読み込みを行うまでインポートします。

  • 関連する問題