Ipython: MarkdownセルでPython変数への参照を許可する

それで、これは死んでいますか？ 前のスレッドが指摘したようにそれは素晴らしいでしょうか？ 実装するスキルがあればいいのに（私はしません）、申し訳ありませんが、私は確かに使用します...

死んでいない、最初にいくつかのことを成し遂げる必要があるだけです。

SOでこことここからの二重の複製であることがわかり

私の2cはそれだろう

• Jinja構文は素晴らしいでしょう
• 簡単に見ては実際には「純粋な」ものがないようですが、十分に確立された実装（：octocat：githubが良いものです）からのすべてのフォーマット規則に従っている場合、インジェクションメソッドを追加することはできません実際にはマークダウンの問題です。
• エラーはユーザーが構成できるものでしょうか？ [非表示（何も起こらない）、単語error 、またはダーティな素晴らしいスタックトレース]のオプション
• テキスト応答である限り、マークダウンレンダラーに渡される前に挿入できるため、htmlまたはさらに多くのマークダウンを挿入できます。

特定の構文を推奨するわけではありませんが（{{}}は問題ないと思います）、Rの同等の設計は次のとおりです。http ：

ルナマークは

：+1：

：+1：、これは非常に便利な機能です！

http://blog.rstudio.org/2014/06/18/r-markdown-v2/と同じ構文があると本当にいいでしょう

Rスタイルの区切り文字、つまりそれぞれシングルバックティックとトリプルバックティックを使用すると、コードを表示するだけ（ some code snippet/example ）と、コードを_評価_して結果を表示する（）のどちらかを選択できなかったようです。例： my_var ）-これはあまり実用的ではないと思います（正しく理解している場合）。

ユースケースは、「_ 2014年のモーガン郡の平均失業率は8.4％で、2009年の10.3％から減少しました。_」などの計算値が埋め込まれたノートブックの散文を作成しています。データ。

より広いユースケースは「スマートドキュメント」であり、データからテキストとグラフィックスが自動的に（再）生成されます（おそらく読みやすさのためにコードが非表示になります）。

便利な機能だと思います。

私はrstudioの「knitr」モデルが本当に好きです（1つのマークダウンドキュメント、コードブロックが解釈され、値はマークダウンで利用可能です-> PDF / html /に変換されます...ジャーナル記事として公開できます。ノートブックとは異なりますノートブックは複数のセルに基づいており、出力が表示されるかどうかに影響を与える方法がわかりません）。

値がテキストにどのように含まれているかは気にしませんが、R（knitr / rstudioを使用）とipythonの両方が同じものを使用するのがいいと思います。

または、rubyやbashに似たもので、＃{varnameまたはstatement}は次のようになります。
文字列内で混合。

1. 2014年6月20：27skrev "Jan Schulz" [email protected]ølgende ：

私はrstudioの「knitr」モデルが本当に好きです（1つのマークダウンドキュメント、コード
ブロックが解釈され、値はマークダウンで利用可能になります->変換されます
PDF / html / ...に投稿します。ジャーナル記事として公開できます。 とは異なります
ノートブックは複数のセルに基づいているため、どのようにすればよいかわかりません。
出力が表示されるかどうかに影響します）。

値がテキストにどのように含まれているかは気にしませんが、私はそれを見つけるでしょう
R（knitr / rstudioを使用）とipythonの両方が同じものを使用する場合は便利です。

—
このメールに直接返信するか、GitHubで表示してください
https://github.com/ipython/ipython/issues/2958#issuecomment-46875435 。

私はもちろんの解釈コードのユースケースを実現し、私はちょうど私たちは、（それを評価/解釈せずに）「ただ」の表示コードに値下げの能力を失うことを懸念していますlike this （すなわちバッククォート、もしR構文を）が選ばれました。

knitr / Rマークダウンでは、コードを表示するか（適切にハイライトなど）、出力のみを表示するか（プロット、テーブルなど）を指定できると思います。

私は経済学のバックグラウンドを持っており、論文にコードを表示したくないので、これは（私の意見では）コードを披露する最適化されたユースケースとは少し異なります。

@bilderbuchi申し訳ありませんが、「これは役に立たないと思います」というコメントのコンテキストを誤解しました。

そして私は同意します：実装されたものは何でも既存の値下げを壊してはなりません。

これは素晴らしいことであり、IPythonにニットランチを食べさせます。

https://github.com/ipython-contrib/IPython-notebook-extensions/wiki/python-markdown

私はこのアプローチが本当に好きです。セルを取り、それを有効なマークダウンに前処理するので、マークダウンプロセッサに変更を加える必要はありません。

とても素敵です...すぐに使用します

14:18の日、2014年8月17日には、ジャン・シュルツ[email protected]
書きました：

https://github.com/ipython-contrib/IPython-notebook-extensions/wiki/python-markdown

—
このメールに直接返信するか、GitHubで表示してください
https://github.com/ipython/ipython/issues/2958#issuecomment-52431760 。

トム・ブランダー
http： //tombrander.com-不動産
http： //oswco.com-オープンソフトウェア
3763ウェストジャクソンブルバード
アラバマ州バーミンガム35213
電話205-267-1089
@dartdog

：+1：エレガント。 私も使います。

@JanSchulz 、ありがとう！ python-markdownを試すのを本当に楽しみにしています。

これをメインのipython（ jupyter ）に組み込む可能性はありますか？

これをメインのipython（jupyter）に組み込む可能性はありますか？

おそらくすぐには。 これを機能させるには、バックグラウンドで多くの設計を行う必要があります。
特に、新しいものを発明するだけでなく、マークダウン構文を拡張する公式の方法が必要になります。

実際、これ（およびknitr / rmarkdown AFAIK）は、2段階の変換を行うことで機能します。最初にコードブロックをコードの出力に置き換え、残りを標準のマークダウンとして変換します。 したがって、これはマークダウンの拡張ではなく、セルのプリプロセッサです。

難しい問題は、マークダウンセル内から実行される任意の非表示のPythonコードをどのように処理するかだと思います。 便利な実装では、コードの実行を制限できるとは思いません。

それが積極的にインストールしてアクティブ化する必要がある別個の拡張機能である限り、これは別の問題です。 また、Pythonコードは、ノートブックが信頼されている場合にのみ実行されます。

マークダウンセルでPythonコードの出力にカーソルを合わせると、ソースコードを示すツールチップを追加する予定です。これにより、これがどこから来たのかを確認できます。

実際、これ（およびknitr / rmarkdown AFAIK）は、2段階の変換を行うことで機能します。最初にコードブロックをコードの出力に置き換え、残りを標準のマークダウンとして変換します。 したがって、これはマークダウンの拡張ではなく、セルのプリプロセッサです。

これはカスタムマークダウンです。 それはすでにmathjaxで私たちが持っているものです。 私たちは明らかに保存する必要があります
ノートブックを再実行する場合はマークダウンの前処理を解除するため、マークダウンを使用するツールはすべてカスタム前処理を処理する必要があります。
プリプロセッサまたはポストプロセッサでは、独自の構文を発明します。これは、人々がやりたいことと競合する場合としない場合があります。

難しい問題は、マークダウンセル内から実行される任意の非表示のPythonコードをどのように処理するかだと思います。 便利な実装では、コードの実行を制限できるとは思いません。

それが積極的にインストールしてアクティブ化する必要がある別個の拡張機能である限り、これは別の問題です。 また、Pythonコードは、ノートブックが信頼されている場合にのみ実行されます。

マークダウンセルでPythonコードの出力にカーソルを合わせると、ソースコードを示すツールチップを追加する予定です。これにより、これがどこから来たのかを確認できます。

そうすれば、user_variableに制限できます。つまり、 user_nsキーの値を返します。 それはほとんどの実行を妨げるはずです。

そうすれば、user_variableに制限できます。つまり、user_nsキーの値を返します。 それはほとんどの実行を妨げるはずです。

また、関数の呼び出しを許可することもできます。 些細なケースは、出力をフォーマットするか、カスタム_repr_を呼び出すことです。

このようなものが実装されるのを見たいです。 最も簡単な解決策は、MDセルをJinjaフィルターに通すことです。 これは以前に行われたことがあります。 たとえば、 dexiを参照してください。

一方、すべてのセルでこれをデフォルトで有効にする必要はないと思います。 Jinjaはマークアップの複雑さを大幅に増し、Jinja + MarkdownはおそらくプレーンMDとは異なる強調表示モードを使用する必要があります。 これを別のセルタイプとして実装してみませんか？

現在マークダウンで行われているのと同じように、コードからコードセルを非表示/置換することが可能であれば、この問題はなくなる可能性があると思います。

-> %%pymarkdownマジックを追加します。これは、 text/markdownメッセージを出力し、ソースを非表示にするか、出力で置き換える必要があることを示します。 魔法は、入力内で単純にs＆rを実行します。

[編集：わかりました。構文が強調表示されていない、qtconsoleで意味がないなど、さまざまな問題があります...]

関連：Mathematica 10は「レポート」のサポートを追加しました。http ： ください。

私は（まだ）詳細に遊んでいませんが、ノートブックをテンプレートとして使用し、変数への参照と計算された出力をノートブックのテキストに埋め込むことができるようです。

同じ変数への複数のMDセルに複数の参照があるとします。 値が変更されたときに、どのセルを再度レンダリングする必要がありますか？

@Pipeliner何をしているのか

人々が使用しているこの問題の回避策はありますか？ 私はipython / jupyterノートブックが大好きですが、マークダウンで{{pythonvariable}}を実行できれば素晴らしいと思います。 小さなサンプルデータセットを使用してノートブックを準備していて、後でフルセットでスワップしてすべてを更新する場合に非常に便利です。

PlaceProxyウィジェットを使用して、ページ上の任意のhtmlセレクターでウィジェットをレンダリングできます。 マークダウンで<span id="myid">placeholder</span>埋め込み、後でコードでx=HTML('widget value'), PlaceProxy(child=x, selector='#myid')ようなものを使用します。 その後、 x.value='something'を設定すると、更新はマークダウンに表示されるウィジェットに反映されます。 PlaceProxyの定義については、 https：//github.com/ipython/ipywidgets/blob/1e407cef864363c66a23781b8d560a6ac18b3370/ipywidgets/widgets/widget_box.py#L70を参照して

もちろん、注意点はたくさんあります。 マークダウンを編集すると、ウィジェットが消えます。 ノートブックを開くと、ウィジェットが作成されていないために表示されないなどの可能性があります。ただし、マークダウンセル内の出力をプログラムで制御できます。

別のオプションは、文字列を作成し、マークダウンをマークダウンセルとしてではなく出力として表示することです。 動的に更新されることはありませんが、セルを評価するたびにマークダウンが更新されます。

このノートブック拡張機能を試すことができます：
https://github.com/ipython-contrib/IPython-notebook-extensions/wiki/python-markdown_v3

文字列を作成したくなかったので、大きなhtml文字列を使用すると非常に面倒になるため、出力として出力されます。ただし、それは考えもしませんでした。 しかし、トリックを実行するいくつかの良い解決策が確かにあります-ありがとう！

この機能は、Rmarkdownから来た人にとって非常に重要だと思います。 Rは、優れたレポートを作成する上ではるかに優れた仕事をしました。

この問題の重複がノートブックで見られました。 これは、コードセルでIPython.display.Markdownを使用してすでに可能です。

from IPython.display import Markdown

one = 1
two = 2
three = one + two

Markdown("# Title")
Markdown("""
# Math
## Addition
Here is a simple addition example: {one} + {two} = {three}
""".format(one=one, two=two, three=three))

良い！ ユーティリティ（または%% markdownマジック）を書くのも簡単でしょう
カーネルの名前空間から変数を自動的にプルするので、
NS：

%%markdown

## Subsection

Here is {one} and {two}

18:35の水曜日、2017年4月26日には、グラント・ネスター[email protected]
書きました：

この問題の重複がノートブックで見られました。 これはすでに可能です
コードセルでIPython.display.Markdownを使用する：

【画像：画像】
https://cloud.githubusercontent.com/assets/512354/25464012/f434c52c-2aae-11e7-9171-541fb0f6601e.png

IPython.displayからインポートマークダウン

1 = 1
2 = 2
3 = 1 + 2

Markdown（ "＃Title"）
Markdown（ "" "＃Math ## AdditionHereは簡単な加算例です：{one} + {two} = {three}" ""。format（one = one、two = two、three = three））

—
あなたが割り当てられたので、あなたはこれを受け取っています。
このメールに直接返信し、GitHubで表示してください
https://github.com/ipython/ipython/issues/2958#issuecomment-297586914 、
またはスレッドをミュートします
https://github.com/notifications/unsubscribe-auth/AABr0CIHhxwNwQF6MiHHy2M612zRnf5Wks5rz_D4gaJpZM4AchzX
。

-
ブライアンE.グレンジャー
物理学およびデータサイエンスの准教授
カリフォルニア州立大学サンルイスオビスポ校
TwitterとGitHubの@ellisonbg
[email protected]および[email protected]

@ellisonbgそれは素晴らしいことであり、これが正しい方法だと思います（Pythonからマーク@Carreauこのようなものに興味がありますか？

さらに、これをノートブックの新しいセルタグ機能（ノートブック5.0のリリース投稿を参照）と組み合わせると、nbconvertを使用して（たとえばnbconvert-hideタグを使用して）ノートブックを変換するときに入力セルを非表示にできるはずです。 @takluyver nbconvert-hideタグは現在nbconvertで機能しますか？

まだそうは思わないが、nbconvertタグをいくつか追加する必要があると思う。

このすべてに+1！ また、現在、入力/出力の非表示に取り組んでいます
JupyterLabは、その状態をnbconvertに保持できるようになります
メタデータ。

7:33の木、2017年4月27日には、グラント・ネスター[email protected]
書きました：

@ellisonbg https://github.com/ellisonbgそれはいいことだと思うし、
これはそれを行う正しい方法です（Python対からマークダウンをレンダリングします。
マークされた機械や他のマークダウン機械をおそらくそれができる方法で拡張する
拡張しないでください）。 @Carreau https://github.com/Carreau Any
このようなものに興味がありますか？

さらに、これをノートブックの新しいセルタグ機能と組み合わせる
（ノートブック5.0のリリース投稿を参照してください
http://blog.jupyter.org/2017/04/04/jupyter-notebook-5-0/ ）、あなたはすべきです
nbconvertを使用してノートブックを変換するときに入力セルを非表示にできる
（例：nbconvert-hideタグを使用）。 @takluyver https://github.com/takluyver
nbconvert-hideタグは現在nbconvertで機能しますか？

—
あなたが言及されたのであなたはこれを受け取っています。
このメールに直接返信し、GitHubで表示してください
https://github.com/ipython/ipython/issues/2958#issuecomment-297731409 、
またはスレッドをミュートします
https://github.com/notifications/unsubscribe-auth/AABr0BNgLTtlzwbrIjqBquzsE9lhLXchks5r0KdAgaJpZM4AchzX
。

-
ブライアンE.グレンジャー
物理学およびデータサイエンスの准教授
カリフォルニア州立大学サンルイスオビスポ校
TwitterとGitHubの@ellisonbg
[email protected]および[email protected]

@Carreauこのようなものに興味がありますか？

このやり方は2013年にすでに議論されており、AFAICTは次のように眉をひそめました。

• すべての言語で%% markdownを再実装する必要があります
• テキストを表示するには、カーネル側で計算する必要があります
• マークダウンをレンダリングする意味を変更します。
• nbconvert --to markdownとnbconvert --to scriptを台無しにする
• ねじ込み式ノートブックはフックをインポートします。

「マークダウン」セルのテキストはカーネルの状態に依存するため、これはノートブック（IMHO）のセマンティクスを破っています。 それで、それがかわいい間、私はこの考えに反対票を投じるつもりです。

また、 %%markdown 、 %%latex 、 %%javascript ...などの魔法は、私たちがこの議論をしているときに書かれました。

同様の魔法がかなり前から存在していて、 %%markdownを使用するよりもはるかに高度な機能が存在することに注意してください。このアイデアに遭遇したことがないので、終了したので急いではいけません。

私の考え方は時間とともに進化し、 @ gnestorのアイデアが好き

定義上、ユーザーがマークダウンセルのカーネルから変数を必要とする場合、
そのマークダウンセルはカーネルに依存します。 「それは壊れます
notebokのセマンティクス」は、コードセルを許可すべきではないと言っているようなものです。
それらはカーネル上で実行され、出力を返すためです。 主な目的の1つ
ノートブックドキュメントのは、カーネルが何をするかの記録として機能することです。
豊富な出力をサポートするカーネルへの実装は簡単で、
これはダウンストリーム（nbconvert、インポートフック）を壊し、次にそれらのものを壊します
バグがあります（マークダウン出力はすでに問題です）。

しかし、私はこれをipythonカーネルの外で行っても問題ありません...

2017年4月27日木曜日午前10時29分、Matthias Bussonnier <
[email protected]>は次のように書いています：

@Carreau https://github.com/Carreauこのようなものに興味がありますか？

このやり方は2013年にすでに議論されていました
AFAICTは次のように眉をひそめました：

• すべての言語で%% markdownを再実装する必要があります
• テキストを表示するには、カーネル側で計算する必要があります
• マークダウンをレンダリングする意味を変更します。
• ねじ込みnbconvert--toマークダウンおよびnbconvert--toスクリプト
• ねじ込み式ノートブックはフックをインポートします。

それはノートブック（IMHO）のセマンティクスを破っています。
「マークダウン」セルはカーネルの状態によって異なります。 可愛いうちに行きます
この考えに反対票を投じる。

また、%% markdown、%% latex、%% javascript ...などの魔法はで書かれました
私たちがこの議論をしていた時。

同様の魔法がかなり前から存在していることに注意します
https://gist.github.com/bj0/5343292およびより高度な機能
%% markdownを使用しているだけなので、次のように終了したので急いではいけません
あなたはこれまでこのアイデアに出会ったことがありません。

—
あなたが言及されたのであなたはこれを受け取っています。
このメールに直接返信し、GitHubで表示してください
https://github.com/ipython/ipython/issues/2958#issuecomment-297784026 、
またはスレッドをミュートします
https://github.com/notifications/unsubscribe-auth/AABr0HU-Gb3ENSidykbte53geYqPpy-sks5r0NCAgaJpZM4AchzX
。

-
ブライアンE.グレンジャー
物理学およびデータサイエンスの准教授
カリフォルニア州立大学サンルイスオビスポ校
TwitterとGitHubの@ellisonbg
[email protected]および[email protected]

リファレンス実装（クラシックノートブック拡張機能）： https ：

これが正しい方法だと思います（Pythonからマークダウンをレンダリングする

私が最初にあなたのステートメントを間違って読んだので、明確にするだけです-これは、マークダウンをhtmlにレンダリングするのではなく、カーネルを使用してマークダウンを（マークダウンmimetypeとして）表示しています。 htmlへの実際のレンダリングマークダウンは、クライアント側、nbconvertなどでまだ実行されています。

私はこのアプローチが好きです。 カーネルの状態を含む簡単なマークダウンが必要な場合は、カーネルを使用してそのマークダウンを表示します。 そのマークダウンをライブで更新する場合は、ウィジェットを使用します（OutputWidgetを使用することも、HTMLWidgetと同様のMarkdownWidgetを作成することもできます）。 これは、入力と出力を表示/非表示にする簡単な方法を伴って、私には非常に理にかなっています。

このチケットに出くわしたばかりで、 SoSも前述のアプローチ、つまりカーネルからのマークダウンのレンダリングを採用したことを述べたいと思います。 基本的に、sosは%renderマジックを実装して、MD（デフォルト）、HTMLなどでセルのstdoutをレンダリングします。また、sosはさまざまな言語をサポートしているため、開始するサブカーネルからの出力もレンダリングします。

簡単な修正は次のとおりです： https ：

何が起こってもRMarkdownと互換性があるといいですね。 それは使用します

 xの値は `rx`です。

ここで、 xはRの変数です。

https://github.com/vatlab/markdown-kernelは必ずしも必要なものではありませんが、Jupyter環境でRmarkdownセルをサポートします。

TL; DR：このスレッドはまだ最新ですか？ JupyterLabには直接的な解決策はありませんが、Notebookにはありますか？ （2020）

だから...このスレッドを読んで、提案されたさまざまなハックを試してみてください... 2020年の時点で、JupyterLab（メインサイトが数年前から人々に使用を促している）では、この機能はまだ不可能/欠落しているようです、 SoSを使用しない限り（他のすべての回避策はノートブックのみ、つまり最新のインストールではレガシー/役に立たないようです...またはJupyterの「コード+マークダウン」コア機能を使用する便利さのほとんどを捨てる必要があります）。

私が見逃したものはありますか？ メインのJupyterLab（注：ノートブックではなく、正常に動作します。ノートブックが明らかにはるかにうまく機能しているときに、メインプロジェクトがラボを非常に強く押していることは少し裏切られています）は、基本的にマークダウンをサポートしていないようです。些細な非分析の例以外のドキュメント-修辞的に言えば：データをフォーマットで出力できない場合、データ分析製品にフォーマットシステムを含めることのポイントは何ですか？

これはとても間違っているように思われるので、私は基本的な何かを見逃したに違いないと思います。 「SoS + markdown-kernel」は、クルミを割るハンマーのように感じますが、機能するので...