明らかに展開する短いハック.ドキュメントを読むのJSプレゼンテーション


これは明らかにサーブを紹介します.スライドショーRead the docs .

抄録


エディットconf.py ターゲットビルダーをオーバーライドする.
def override_builder(app, config):
    # Change for your RTD settings. Please set it in your RTD prject
    app.registry.builders["singlehtml"] = app.registry.builders["revealjs"]

def setup(app):
    app.connect("config-inited", override_builder)
コンテンツやソースを見ることができます.
  • https://github.com/attakei-sandbox/sphinx-rtd-revealjs
  • https://sphinx-rtd-revealjs.readthedocs.io/en/latest/
  • 接近


    Sphinxサーバへの定期的な使用のための問題点


    ドキュメントを読むスフィンクスをサポートするドキュメントプラットフォームです.
    あなたが実行すると同じようにSphinxドキュメントからHTMLファイルを提供することができますmake html ローカルで.
    スフィンクスReplaljsはSphinx拡張機能を生成するビルダーを提供することです.スタイルHTML .前払いmake revealjs )
    RTDサポートhtml , dirhtml and singlehtml HTMLビルディング.
    だから、サーバーを明らかにすることは困難です.スフィンクスのRealaljsのJSプレゼンテーション.

    スフィンクスはビルダーオブジェクトをオーバーライドできます


    スフィンクスは、いくつかのイベントにプロシージャを注入するアプリケーションAPIを提供します.config-inited ターゲットビルダーオブジェクトを作成する前に、すべての設定を読み込みます.
    このイベントのハンドラーでBuilderクラスを変更することができ、RTD内の任意のビルダーを使用できます.
    (例: abstractを参照ください).

    注意


    正規名ビルドには使えません


    このハックはビルダーを切り替えます、そして、あなたはレギュラービルダーを使用することができません.
    どんなビルダーを呼び出したいか気をつけなければならない.

    RTDウィジェットは動作しません


    RTDはversioningとi 18 nのウィジェットを提供します.
    しかし明らかに.JSコンテンツはWayetをレンダリングしません.
    あなただけのシングルバージョンプレゼンテーションを提供することができます!

    このハックはきれいではない


    これは汚れたハックです.
    RTDはバックエンドでこのハックを受け入れないかもしれません.