Ipython: ノートブックの方程式番号。

+1
これは、あらゆる種類の数学文書にとってかなり重要な機能です。
MathJaxにはすでにこの機能があると思います。

http://docs.mathjax.org/en/latest/tex.html#automatic -equation-numbering

参照に関しては、LaTeX方程式（およびLaTeXバックエンド）に固有のものではなく、統一された構文を持つ一般的な相互参照システムを開発することが重要だと思います。

ジェネリック相互参照システムが必要であることに同意しますが、Pythonコードとのインターフェースも可能である必要があると付け加えます。 これにより、マークダウン内のラテックスがコードで生成された図を参照できるようになります。

これはおそらく、マークダウンセルからPython変数にアクセスするためのシステムが利用可能になるまで待たなければならないでしょう。おそらく、同様のシステムを使用するからです。

https://github.com/ipython/ipython/pull/2517#issuecomment -9884544を参照して、コメントしてください。

これはまた、問題をより完全に解決するようですhttp://stackoverflow.com/questions/18823779/ipython-notebook-and-mathjax-labeled-equations

@ahmadia方程式にデフォルトで番号を付けることができない理由は何ですか？ 方程式に番号を付けて参照できないことは、現在非常に厄介なことです。

+1。 ＃5921を実装すると、これが簡単に可能になるようです。

+1。 これがすぐに実装されることを願っています

+1

+1。
私はipythonノートブックを使用して、大学のジュニアレベルの電磁コースのコース資料を補足しています。これは、学部のカリキュラム全体でipythonノートブックの幅広い実装を推進するかどうかのテストケースとして使用しています。 ノートブックまたはノートブックのセクション内で一貫した方程式番号がないことは、テキスト内の方程式番号を参照する機能とともに、深刻な制限です。 このような番号付けはノートブックのLaTeX部分に固有であり、特に、より一般的なアプローチを試みると、この機能が得られるまでの待ち時間が長くなる場合は問題ありません。

+1。
ここでも同じですが、ipythonを使用して数値微積分コースのメモを書いていますが、参照番号が実際に欠落しています。

+1

これが、iPython Notebookをメインのドキュメント作成ツールとして使用することを妨げる唯一の理由です（リアルタイムコラボレーションの欠如を除けば、それはそれほど重要ではありません）。 代わりに、ここでラフドラフトを作成してから、LaTeXエディターに移植する必要があります。

+1：+1：これを使って講義をしていますが、この機能は絶対に必要です！

さて、私はついに、mathjaxutils.jsを変更するこの投稿で説明されている「解決策」を試しました。 ラテックスを含むマークダウンセルに変更を加えた後、ipythonノートブックのWebページを更新する限り、数式番号が表示され、適切な順序で更新されます。 ページを更新すると、ラベルも修正されます。ラベルが定義されているセルが再実行されると（つまり、Shift-Enter）、ラベルが解決されなくなります。 ただし、ノートブックがnbviewer.ipython.orgでレンダリングされると、方程式の番号が完全に失われ、ラベルが解決されないため、「???」に置き換えられます。 マークダウンテキストセルで参照されている場所。 肝心なのは、これはほとんどのユースケースの解決策ではないということですが、元の投稿者が質問をして、これを理解してくれてうれしいです。

ここで言及：
https://github.com/jupyter/nbviewer/pull/459

コードセルによって返される方程式に番号を付けたいと思いました。
それが私が使用したものです：http： //nbviewer.ipython.org/github/MalteJin/Manual-equation-numbering/blob/branch/Manual%20equation%20numbering.ipynb

^これは現在推奨されている解決策ですか？

バンプ。 コースノートにJupyterノートブックを使用していますが、これは深刻な問題です。 方程式に手動で番号を付けるための便利な構文は、まともな妥協案でしょうか？

方程式に手動で番号を付けるための便利な構文は、まともな妥協案でしょうか？

これは@poulsonの良いアイデアであり、MathJaXにはこれをサポートする\tag構文があります。
JupyterNotebookの例の手動MathJax方程式タグ。 同じ制限があります（ブラウザを更新しないと、Markdownセルを再実行すると、MathJaXが壊れます）が、少なくとも、それを行うためにノートブックを再構成する必要はありません。

@ahmadiaありがとう！ セルの破壊を再実行することは確かに少しイライラしますが、これはラベル付けされていない\begin{equation}からの大きな進歩です！

@ahmadia方程式の参照がリンクまたはライブノートブックで解決されないことが予想されますか（更新した後でも）？

更新してから、すべてのセルを実行してください。 リンクがGitHubで機能するとは思わない
GHがURLを削除するためです。

2015年10月3日土曜日、 JackPoulsonnotifications @ github.comは次のように書いています。

@ahmadia https://github.com/ahmadia方程式は、
リンクまたはライブノートブックで参照が解決されない（後でさえ）
さわやか）？

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

それは私にはうまくいきませんでしたが、すべてがハードコーディングされているので、 \refの使用を主張する理由はありません。 したがって、私は参照用の方程式番号をハードコーディングし、ここで見ることができる最終製品を作成しました： http ：//web.stanford.edu/class/math53/notebooks/Week2.html

これをプッシュしてくれてありがとう@poulson 。 私は何度もこれに見舞われ、方程式の数値をハードコーディングするのはかなり悪いですが、何ができるのでしょうか... IPythonはこれをネイティブでサポートする必要があります。

これまでのところ最高の回避策、みんなありがとう！

コードを含める場合：

MathJax.Hub.Config({
  TeX: { equationNumbers: { autoNumber: "AMS" } }
});

javascript拡張機能、またはノートブックのjavascript出力でも、自動方程式番号付けがオンになります。 これには、デフォルトで実行できないすべての問題があります。主に、mathjaxの数式番号は、ページ上の場所ではなくレンダリング時間で並べ替えられるため、番号付けは最初のページの読み込み時にのみ正しくなります。

実際には、方程式の番号をリセットして、ノートブックで方程式を再レンダリングできます。

これを行う簡単なノートブック拡張機能を作成しました。
https://github.com/ipython-contrib/IPython-notebook-extensions/pull/335

@juhasch素晴らしい！ ほとんどの状況で方程式番号の経験が非常に乏しいことを考えると、デフォルトでオフにするのが最良の選択だと思います。 ただし、これを再番号付けするアクションを使用してフロントエンド構成オプションにするのは素晴らしいことです（ツールバーボタンはおそらくそれに専念するにはあまりにも貴重なスペースですが、メニューアクションは問題ありません）。

ノートブックを作成するときに再レンダリング/再番号付けを頻繁に使用することを想像しているので、ツールバーボタン、またはメニューに表示される場合は少なくとも通常モードのホットキーに投票します。

@ lucasb- eyer @juhaschが提供しているような拡張機能に対してはこれで問題ないと思いますが、デフォルトのキーボードショートカットとツールバースペースの両方が非常に貴重であるため、デフォルトではおそらく実行しません。 ただし、custom.jsまたはnbextensionを介していずれかまたは両方を追加することは可能です。

@minrk ：nbextensionsサーバー拡張機能を使用して、拡張機能を簡単にアクティブ化/非アクティブ化し、再レンダリングしてオン/オフを切り替えることができます。

を押すとツールバーボタン、方程式の番号付けがリセット/再レンダリングされます。

@juhaschあなたの仕事に感謝します！ これは大きな前進です。

@minrkの経験では、方程式の番号付けに対する長期的な適切な解決策として何を提案しますか？ @juhaschの拡張機能は、現時点では単なる回避策です。 私はあなたにそれを実装するように求めているのではなく、解決策がどうあるべきかを概説するだけです。 これに本当に悩む人はたくさんいると思いますが、正しい方向性がわかれば試してみることができます。

方程式の番号付けに対する長期的な適切な解決策として何を提案しますか？

あなたはそれを持つことはできません。 MathJaxは、方程式の番号付けを実行するときにページ全体にアクセスできると想定し、IPythonはセルごとにMarkdownをレンダリングします。これは、大きなノートブックでそれを行う唯一の正しい方法です。 ノートブックではなく、MathJax側での作業/実装が必要になります。

ほとんどの人（私を含む）は、方程式の番号付けを望んでいます。 技術的にどのように実装されているかはあまり気にしないと思います。 したがって、いくつかの可能な方法を見ることができます。たとえば、ノートブックがページ全体にアクセスせずに方程式番号を通知できるようにするパッチをMathJaxに追加するか、MathJaxを使用して数値なしで方程式をレンダリングするという別の解決策があります。 、次にノートブック自体で番号をレンダリングします。 より多くのオプションがあるかもしれません。 しかし、私は内部に精通していないので、どちらの方法が最善であるかについて、いくつかの公式の祝福を持ちたいと思います。

方程式の番号付けに対する長期的な適切な解決策として何を提案しますか？

今のところ、私は基本的に@juhaschが彼の拡張機能で行ったことを実行しますが、masterにマージされた場合は次の変更が加えられます。

1. デフォルトでオフにします
2. トグルをfrontend-configに保存するので、一度だけオンにする必要があります
3. キーボードショートカットにバインドできるように、番号の付け直しアクションを追加します
4. ツールバーの代わりに、番号を付け直すためのデフォルトのUIをメニューに配置します

基本的に、これが優先される人のための拡張よりも少し悪くします。これはデフォルトとして意味がないからです。 ただし、アクションが利用可能になると、ショートカットやツールバーボタンなどを追加することで、優先順位の異なるユーザー向けの簡単なカスタマイズになります。

マークダウンセルまたはHTML出力の_any_レンダリングでは、番号付けをリセットする必要があり、_all_マークダウンセルとHTML出力を再レンダリングする必要があるため、常に正しい番号付けがどれほど実行可能かはわかりません。毎回。

ドキュメントを考えると、それはユーザーとしての私にとって合理的な計画のように思えます。 ：+1：

@minrk ：ユーザーとして、私もこれが有用な解決策だと思います。 すべてのマークダウンとHTML出力を再レンダリングするのはどれほど面倒ですか？

@gregnordinはノートブックのサイズに依存し、ノートブックのサイズに制限なく成長します。 つまり、マークダウンセルを編集するたびに、最初にノートブックを開いたときにノートブック全体をロードするのと同じくらいの時間がレンダリングにかかる​​可能性があります。 デフォルトの動作には間違いなく問題はありませんが、拡張機能がそれを突き刺そうとしたい場合は、試してみることを歓迎します。

+1

この機能の+1。 私は学生のために物理学の講義を準備しています、そして方程式の番号付けは不可欠です。

すべてを再レンダリングせずに方程式番号を更新できるようにする別のオプションは、HTML出力で方程式または参照を含む要素を検索し、それらのテキストを適切な値に置き換えるjavascriptです。

これを完全に機能させるには、MathJaxでいくつかの変更を行い、更新する必要のある要素に追加の属性を設定して、スクリプトがそれらを認識できるようにする必要があります。

現時点ではサポートはありませんが、次の回避策でうまくいきます

• \tag{labelname}を使用して方程式番号を作成します。 ここでタグはラベルであることに注意してください
• 生のhtmlコード<span class=reference data-target=labelname></span>を使用してマークダウンで参照します。これは、\ refまたは\ eqrefのHTML出力にラベル名が含まれていないために必要です。

例えば

$$
\begin{equation}
  A = 1 \tag{eq:sample}
\end{equation}
$$

The amazing result in <span class=reference data-target="eq:sample"></span> can ...blah..blah

次のスクリプトは、方程式の番号を更新します。 新しい方程式番号または参照がレンダリングされた後に実行する必要があります。 今のところ、スクリプトを別のセルに配置し、必要に応じて手動で実行できます。 完全なソリューションには、適切なタイミングで再実行をトリガーするための何らかのメカニズムが必要です。

%%javascript

// find all equation numbers (tags) that have no data-label attribute and set
// it to the tag text
$("span.mtd[id|='mjx-eqn']").not("[data-label]").each(
    function (index)
    {
        $(this).attr("data-label", $(this).text().slice(1,-1));
    }
);

// loop over all equation numbers and set the text 
$("span.mtd[id|='mjx-eqn']").each(
    function (index)
    {
        $(this).text("(" + (index+1) + ")");
    }
);

// loop over all references and resolve them by finding the
// equation number with a matching data-label attribute
$("span.reference").each(
    function (index)
    {
        var target = $(this).attr("data-target");
        var eqn = $("span.mtd[id|='mjx-eqn'][data-label='" + target + "']").text()
        $(this).text(eqn)
    }
);

スクリプトは数値のみを更新し、すべてのレイアウトをそのままにしておくことに注意してください。 MathJaxにすべてを再レンダリングさせるよりもはるかに効率的です。

@basvandertolサンプルをありがとうございますが、結果は現在の画面にのみ表示されるため、これがどのように役立つかわかりません。保存、印刷、nbviewerでの表示、表示はできません。どの出力（PDF、HTMLなど）でも、これが回避策であるとは思いません。 私はあなたを誤解しましたか？ それとも、これはソリューションの一部にすぎませんか？

フィードバック@dsblankをありがとう。 これは確かに部分的な解決策にすぎません。具体的には、すべてを再レンダリングせずにノートブックを編集しているときに方程式番号を更新するという問題に対するものです。 これを実現するために、HTMLデータ属性を試していました。 私は後で、nbconvertがラテックスの引用を処理するために同様のアプローチを使用していることを発見しました。 http://nbconvert.readthedocs.io/en/latest/latex_citations.html

現時点では、MathJaxはレンダリング後に参照を解決するのに十分な属性をHTML出力に追加していません。 そのため、これらのハックなラベルと参照を使用して、必要なHTML出力を取得します。 これらのラベルを使用すると、LaTeX-> pdfへの通常の変換が失敗します。

私は今、MathJaxソースコードに精通しており、通常のラベルと参照にHTML属性を追加する簡単な方法があるかどうかを確認しています。

次のステップは、引用ですでに行っているように、これらのHTML属性を認識するためにnbconvertにサポートを追加することです。 nbconvertがこれらの属性を持つHTMLのコードセクションの出力もスキャンできる場合は、HTMLキャプション/ラベルをコードで生成された図に追加してnbconvertを使用できます。
正しいラテックス出力を生成できます。 マークアップセルで図を参照できます。

これは、ipythonノートブックでの参照を完全にサポートするためのアプローチの概要にすぎません。 それは私には実行可能に思えますが、誰かがすでにショーショッパーを見ている場合は、私に知らせてください。 ipythonノートブックの内部についてはほとんど知りません。 これはもっと学ぶための楽しいプロジェクトのように思えますが、今のところ私はすべての影響を監視することはできません。

この（長い）スレッドを見つけました...

これは興味深いかもしれません。私は、LaTeX環境のレンダリングをサポートするために何かを試みました。これには、ドキュメント全体で、方程式と環境の両方の_自動ナンバリングと更新_が含まれます。
更新用のボタンを使用していましたが、上記の@basvandertolで説明したものと同様のアイデアを使用しています。

もちろん、これはいくらかの過負荷を追加しますが、これは非常に長いドキュメントであっても、私にとってはほとんど受け入れられます。 ノートブックのhtmlおよびLaTeXドキュメントへのエクスポートが可能です。

ここまたはPypiで拡張機能を確認できます。 一番。

提案されたソリューションのいくつかのバージョンをマスターに統合するための+1。

これはすでに解決されていますか、それとも+1する必要がありますか？