明らかに展開する短いハック.ドキュメントを読むのJSプレゼンテーション
2775 ワード
これは明らかにサーブを紹介します.スライドショーRead the docs .
エディット
https://github.com/attakei-sandbox/sphinx-rtd-revealjs https://sphinx-rtd-revealjs.readthedocs.io/en/latest/
ドキュメントを読むスフィンクスをサポートするドキュメントプラットフォームです.
あなたが実行すると同じようにSphinxドキュメントからHTMLファイルを提供することができます
スフィンクスReplaljsはSphinx拡張機能を生成するビルダーを提供することです.スタイルHTML .前払い
RTDサポート
だから、サーバーを明らかにすることは困難です.スフィンクスのRealaljsのJSプレゼンテーション.
スフィンクスは、いくつかのイベントにプロシージャを注入するアプリケーションAPIを提供します.
このイベントのハンドラーでBuilderクラスを変更することができ、RTD内の任意のビルダーを使用できます.
(例: abstractを参照ください).
このハックはビルダーを切り替えます、そして、あなたはレギュラービルダーを使用することができません.
どんなビルダーを呼び出したいか気をつけなければならない.
RTDはversioningとi 18 nのウィジェットを提供します.
しかし明らかに.JSコンテンツはWayetをレンダリングしません.
あなただけのシングルバージョンプレゼンテーションを提供することができます!
これは汚れたハックです.
RTDはバックエンドでこのハックを受け入れないかもしれません.
抄録
エディット
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)
コンテンツやソースを見ることができます.接近
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はバックエンドでこのハックを受け入れないかもしれません.
Reference
この問題について(明らかに展開する短いハック.ドキュメントを読むのJSプレゼンテーション), 我々は、より多くの情報をここで見つけました https://dev.to/attakei/a-short-hack-to-deploy-revealjs-presentation-on-read-the-docs-292bテキストは自由に共有またはコピーできます。ただし、このドキュメントのURLは参考URLとして残しておいてください。
Collection and Share based on the CC Protocol