Mathjax: 方程式\labelおよび\ref

追加するもののリストにありますが、1.1リリースのパフォーマンスとバグ修正に集中しています。 私はそれを忘れていません、そしてそれはバージョン1.1に続いて追加されるべきものの1つです。

ダビデ

MathJaxのフォークのissue71ブランチに、\labelマクロと\refマクロとともに自動方程式番号付けの実装を投稿しました。 これには、MathJaxのコアルーチンにいくつかの重要な変更が必要でした。これらの変更は非常に新しく、コアの他の部分のようなシェイクダウンがないため、これを使用するときは注意が必要です。 それらは大丈夫だと私は確信していますが、彼らがより多くの使用を見るにつれて、私たちが見つける微妙な点があるかもしれません。

方程式の番号付けを制御する新しい構成パラメーター（config / defaults.jsファイルを参照）があります。 特に、TeX.equationNumbers.autoNumber構成パラメーターは、MathJaxが自動番号付けを処理する方法を制御します。 デフォルトでは、自動番号付けは行われません（したがって、デフォルトは現在のMathJaxの動作と同じです）。 しかし、あなたは設定することができます

MathJax.Hub.Config({
  TeX: { 
     equationNumbers: {  autoNumber: "AMS"  },
     extensions: ["AMSmath.js"]
  }
});

AMS環境（方程式、整列、収集、マルチラインなど）の番号を取得し、スター付きの環境では番号を抑制します。 \ tagを使用して独自の方程式番号を指定し、\labelと\refを使用してページのテキスト内の方程式番号にアクセスできます。 （\ refコマンドは、数学モードの内外で認識されるようになりました。）

autoNumberを"all"に設定すると、表示されるすべての方程式に自動的に番号が付けられます。

注意すべき問題：方程式番号は、Firefox（バージョン3でも4でもない）によって実装されていないmlabeledtr MathML要素を使用して処理されるため、NativeMMLレンダラーを使用する場合、方程式番号は表示されません。 たとえば、「HTMLorMML」を含む結合された構成ファイルは、FirefoxのNativeMML出力を選択することに注意してください。 これは、指定することでオーバーライドできます

<script type="text/x-mathjax-config">
MathJax.Hub.Config({
  MMLorHTML: { prefer: { Firefox: "HTML" } }
});
</script>

FirefoxにNativeMMLレンダラーではなくHTML-CSS出力レンダラーを使用させるためにMathJax.jsをロードする前（IE / MathPlayerがMathMLを使用できるようにします）。

私はまだこのブランチに取り組んでいるので、変更はまだ行われています。 前方参照の処理に使用される方法に満足しておらず、その動作を変更している可能性があります（ただし、これは内部的なものであり、作成者やユーザーに表示される方法は変更されません）。

ダビデ

それは絶対に素晴らしいです、どうもありがとう！

ただし、1つのバグとして、数学モードで\text{(see \eqref{cs})}と入力すると、2番目の閉じ括弧が使用されているように見えます。 完全に機能する前にスペースを追加します。

OK、チェックインします。 参照がテキストから削除されているときは、1だけずれているインデックスが必要です。

\eqrefに続く文字が削除される原因となっていた誤ったインデックスを修正しました。 issue71ブランチのコピーを更新して、修正を取得できます。

ダビデ

注：AMSmath拡張機能を明示的に要求する必要がないように更新しました。 自動番号付けをオンにすると、自動的に読み込まれるようになります。

ダビデ

==>この機能をカバーするために単体テストを追加する予定なので、テストケースへの設定が必要でした。

ここでは、テストすることがたくさんあります。 前方参照、後方参照、存在しないラベルへの参照、自動番号付けをオーバーライドするための\tagの使用、番号付けを防ぐための\notagおよび\nonumberの使用、番号付けさまざまなAMS環境、 autoNumberのさまざまな設定など。 大変です、申し訳ありません。

はい、私はそれを知っています。 そのため、テストケースの必要に応じて問題にタグを付け、これらのテストの作成を延期します。
ただし、一部の寄稿者がさまざまなユースケースをリストし、テストのアイデアを提供するのに十分親切である場合（おそらくそれらを書くことさえ）、それは本当に役に立ちます。

このためにいくつかのテストを用意しました。

Configuration / tex2jax / processRefs-1.html
Configuration / TeX / equationNumbers / autoNumber-1.html
Configuration / TeX / equationNumbers / autoNumber-2.html
Configuration / TeX / equationNumbers / autoNumber-3.html
Configuration / TeX / equationNumbers / autoNumber-4.html
Configuration / TeX / equationNumbers / formatID-1.html
Configuration / TeX / equationNumbers / formatNumber-1.html
Configuration / TeX / equationNumbers / formatTag-1.html
Configuration / TeX / equationNumbers / formatURL-1.html
LaTeXToMathML / references / eqref-1.html
LaTeXToMathML / reference / label-1.html
LaTeXToMathML / references / ref-1a.html
LaTeXToMathML / references / ref-1b.html
LaTeXToMathML / references / ref-2.html
LaTeXToMathML / references / ref-3.html
LaTeXToMathML / references / tag-1.html
LaTeXToMathML / references / tag-2.html
LaTeXToMathML / references / notag-1.html

==>テストスイート

tex2jax.jsの181行目に余分なコンマがあり、IEがクラッシュします。

ネイティブMathMLを有効にすると、Firefoxでmlabeledtrが消えるようです。 たとえば、次のことを考慮してください。

http://devel.mathjax.org/testing/testsuite/Configuration/TeX/equationNumbers/formatTag-1.html?mathJaxPath=http://devel.mathjax.org/testing/mathjax/dpvc/issue71/

試験結果：
http://devel.mathjax.org/testing/web/results/issueReviews/issue71/

tex2jax.jsの181行目に余分なコンマがあり、IEがクラッシュします。

はい、私はすでにそれを見つけて、 v2.0-candidateブランチで修正しました（すべての個別のブランチをマージしたので、それらを個別に変更することはもうありません）。

ネイティブMathMLを有効にすると、Firefoxでmlabeledtrが消えるようです。

これは、Firefoxが<mlabeledtr>を実装しておらず、そのような行を削除するためです。そのため、MathJaxは、数学を非表示にするのではなく、プレーンな<mtr>に変更し、妥協案としてラベルを削除します。 （Firefoxの問題のリストにまだ含まれていない場合は、これが含まれているはずです。自動番号付けがMathJaxの一部になったことで、これはFirefoxのネイティブMathMLにとってより深刻な制限になり、v2の理由の1つになります。 0は、FirefoxのNativeMMLではなくHTML-CSSを優先するようにデフォルトを変更する可能性があります。）

Firefoxの場合、なぜラベルを削除するのですか？ うまく配置されていなくても、そのままにしておくことができますか？

ラベルは$＃$ <mlabeledtr> $＃$の最初の<mtd>であるため、 <mlabeledtr>を<mtr>に置き換えるだけで、列が破棄されます。 戻ってテーブルの他のすべての（ラベルのない）行に空白のエントリを挿入するか、ラベルを行の最後に移動して、ラベルがテーブルの他の行で使用される右側の列。 これらは両方とも、私がやりたかったよりも複雑でした。 NativeMML出力jaxでの期待は、絶対に必要な以上にMathMLを変更しないことでした。私は、数学を完全に失うことを避けるために、これだけを行いました。 すべてのブラウザのレンダラーですべてのネイティブMathMLバグを回避しようとするのは賢明ではないと思います。 私の当初の望みは、Firefoxが最終的に不足している機能を実装し、ラベルの削除が一時的なものになることでしたが、これはすぐには開始されないようです。

ダビデ

mlabeledtrの変更はFirefox9を対象としていることに注意してください。
https://bugzilla.mozilla.org/show_bug.cgi?id=356870

mlabeledtrのコンテンツは、デフォルトで非表示になっているラベルを除いて、通常の行として表示されるようになりました（これは、CSSルールを使用してオーバーライドできます）。

mlabeledtrを実装するためのバグについては、を参照してください。
https://bugzilla.mozilla.org/show_bug.cgi?id=689641

Firefox 9がリリースされ、mlabeledtrの回避策が含まれているため、MathJaxはそのバージョンでそれ自体を実行する必要はありません。

\labelを取得して（場合によってはオプションで）方程式のid属性を予測可能で、ラベルから派生したものに設定する可能性はありますか？ これにより、他のドキュメントから特定の方程式への参照が可能になります。

たとえば、現時点では、

\begin{align}
F &= m a \label{NewtonsLaw}
\end{align}

これが最初の方程式の場合、ID mjx-eqn-1が生成されます。 \eqref{NewtonsLaw}はmjx-eqn-1へのリンクを生成するため、これはドキュメント内で機能します。

ただし、方程式の番号がわからないと、別のHTMLドキュメントから方程式を参照することはできません。 つまり、 http： //www.mywebsite.com/mypage.html#mjx-eqn-NewtonsLawへの外部リンクを作成できません

@grahamdennis-良い考えです。 v2.0-candidateブランチを変更して、それを実現するために必要な変更を含めました。 必要な変更は小さいため、AMSmath.jsファイルとTeX/config.jsファイルの独自のコピーを編集してそれらを含めることができます。

ダビデ

ありがとう@dpvc！

最新の変更を考慮してテストを更新しようとしています。

Firefox 9がリリースされ、mlabeledtrの回避策が含まれているため、MathJaxはそのバージョンでそれ自体を実行する必要はありません。

Davide、MathJax 2.0でこのコメントを考慮しましたか？ MathJaxの回避策を削除すると、Firefoxユーザーは、単純なCSSルールmlabeledtr > mtd:first-child { display: table-cell; }を使用して、必要に応じてラベルを表示できるようになります。

はい、 <mlabeledtr>の回避策は条件付きで適用され、FF9以降では使用されません。 NativeMMLjax.jsファイルの492行目を参照してください。

OK、素晴らしい！ ありがとう。

\ labelが追加された場合にのみ、数値方程式に設定できますか？ \labelと\refはあまり使用しません。

LaTeXで方程式*環境を使用できることは知っていますが、残念ながら、私はMarkdownを使用しており、*はマークダウン構文用に予約されています。

ありがとう。

@emptymalei 、探しているものの設定はありませんが、番号付きの方程式が必要な場合は、明示的な\tag{}マクロを使用できます。 これには、自分で番号付けを行う必要がありますが、参照がいくつか必要な場合は、それでうまくいく可能性があります。 したがって、 \label{}と\tag{}を一緒に使用して方程式に番号を付け、後で参照するためのラベルを提供します。

@dpvcありがとうございます。 \tag{}を試してみます。

やあ、

素晴らしいプロジェクトとこの素晴らしい機能をありがとうございました。 ここで私は小さな問題を抱えています。 内部に\labelを含む数学を変更する場合、ラベルは複数定義されます（これを再現するには、MathJaxライブデモで\labelを使用して数式を編集してみてください）。

HTML要素を置き換えるときにMathJaxのラベル定義を削除することで修正できると思います。 しかし、この削除を通知するインターフェイスや、ページを更新せずに定義をクリアできるコードは見つかりませんでした。

私に何ができるか考えている人はいますか？

前もって感謝します。

スレッドを再利用しないでください。

方程式番号のリセットに関するドキュメントを読むことをお勧めします。

バグというよりは不完全な機能だと思いました。 新しい号を始めます。

方程式番号はリセットできますが、ラベルはリセットできません。

ラベルもresetEquationNumbers()によってリセットされますが、ドキュメントではそれについてより明確になる可能性があります。

どうもありがとうございました！ それは失敗につながる私の間違った使用法であるに違いありません。 ありがとうございました。 迷惑をかけてごめんなさい。

MathJax.InputJax.TeX.resetEquationNumbers()は2.xコンストラクトだったようです：http：//docs.mathjax.org/en/v2.7-latest/advanced/typeset.html#reset-automatic-equation-numbering
オプションの引数は文書化されていませんが、https：//github.com/mathjax/MathJax/issues/1705#issuecomment-282743204でDavideによって説明されています。ありがとうございます。
3.xではMathJax.texReset()に置き換えられましたhttp://docs.mathjax.org/en/v3.0-latest/web/typeset.html#tex-reset
[もちろん、3.0では多くのことが変更されました。 これは主に、私がまだ2.xを使用しているので、将来私がこれを再び見つけるのを助けるためです;-)少し残念なことに、「最新/」の場合、多くの2.xドキュメントリンクが壊れています...]