Mathjax: siunitxの拡張

いくつかの一般的な意見。 私はこの拡張機能に精通していませんが、一見すると（98ページのマニュアルで...）、基本的に難しいことは何もありません。たとえば、画像環境はありません（とにかくテキストマクロを無視します）。 。

したがって、私が何も見逃していなかった場合、答えは「はい、可能です」ですが、バックログにはありません（まあ、今はそうです）。

バックログがクリアされるのを待つ代わりに、他の誰かが拡張機能を作成するのを手伝ってくれることをとてもうれしく思います。 少なくともsiunitxコマンドの基本セットについては、これはそれほど難しいことではありません（sinuitxに関する非常に優れた知識を除いて）。

私はそのような拡張機能を試してみ始めました。これは私のフォークで利用できます。 しかし、学ぶことに熱心であることを除いて、私はこれを行うのに特に悪い立場にあります。

• カジュアルなJSコーダーです
• MathJaxの内部をまったく知らない
• MathMLについてあまり知らない
• siunitxのカジュアルユーザーです
• siunitxの内部を知らない
• LaTeXにはある程度熟練していますが、パッケージの内部を読むのはとにかく難しいです

したがって、私はおそらくさまざまな面であなたの入力が必要になります。
これまでのところ、2つのコマンド\siと\SIの_非常に_基本的な解析があります。
さて、ここに私の最初の2つの質問があります：

• MathJaxをパックするにはどうすればよいですか？
• 単位を記述するためのMathML / Jaxの適切な要素は何ですか？

2014年9月14日15：23、 YvesDelleynotifications @ github.comは次のように書いています。

• 単位を記述するためのMathML / Jaxの適切な要素は何ですか？

ほとんどの場合、私たち（Math WG）はこのテーマについてのメモを持っています：

http://www.w3.org/TR/mathml-units/

ポインタをありがとう！

@burnpanck最初に：参加してくれてありがとう-素晴らしい！ あなたの自己記述は実際にはとても良い音だと思います-いわば「手荷物なし」の完璧な組み合わせ;-)。

最初の質問として、 MathJaxサードパーティ拡張リポジトリを利用することをお勧めします。 そうすれば、好きなようにパックでき（ dev-toolsを使用しますが、好みはありません）、MathJax CDNに入れて、より多くのユーザーに提供しながら、現在の状態でこれをプッシュできます。 （テスターを募集するために、関連するユーザーグループの投稿にも投稿します）。

physics.SEには、OPからのリンクを繰り返すために喜んで支援してくれるユーザーもいる可能性があります：http： //meta.physics.stackexchange.com/questions/4220/siunitx-latex-package

2014年9月15日21：00、Peter [email protected]
書きました：

physics.SEには、喜んで支援してくれるユーザーがいる可能性もあります。
OPからのリンクを繰り返します。
http://meta.physics.stackexchange.com/questions/4220/siunitx-latex-package

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

ジョセフ（siunitxの作者）は、MathJaxが
言及....

http://www.texdev.net/2014/09/18/reworking-and-exposed-siunitx-internals/

これは、パッケージの内部について尋ねているときに、私が自分の努力について電子メールで彼に話したという事実によるものかもしれません:-)

@pkra ：サードパーティの拡張機能リポジトリに切り替えました。 ただし、テストがさらに難しくなりました。標準の場所からMathJaxをロードする簡単な方法はありますが、別の場所でサードパーティの拡張機能を探すように指示しますか？

@burnpanck

これは、パッケージの内部について尋ねているときに、私が自分の努力について電子メールで彼に話したという事実によるものかもしれません:-)

驚くばかり！

標準の場所からMathJaxをロードする簡単な方法はありますが、別の場所でサードパーティの拡張機能を探すように指示しますか？

はい、あります-http：//docs.mathjax.org/en/latest/options/ThirdParty.htmlを参照してください

siunitxプラグインの開発が停滞しています。
現在のステータスへのリンクを投稿したかっただけです。
https://github.com/burnpanck/MathJax-third-party-extensions/tree/add-siunitx-tex-extension
どういうわけか、 MathJax-third-party-extensionsに切り替えた後、そのリンクを投稿したことはありません。

siunitxドキュメントにあるほとんどすべてのテストケースに使用可能な可視出力を提供することを付け加えておきます。 現在も正しく機能しないのは

• 物理量のリスト（単位が適切に繰り返されていない）
• 角度のレンダリング
• リテラル単位の入力が正しく解析されない場合があります。
• \sisetup{...}コマンド
• 多分他のいくつかの小さな問題

さらに、生成されたMathMLが意味的に正しいかどうかはわかりません。

自分で判断したい場合は、
http://rawgit.com/burnpanck/MathJax-third-party-extensions/add-siunitx-tex-extension/siunitx/sample-siunitx.html

@burnpanck 、これに取り組んでくれてありがとう！

それが壊れていなければ（不完全なだけです）、私たちの観点からは、あなたの作業をサードパーティの拡張リポジトリにマージすることは完全に問題ありません。

あなたの仕事に貢献したい人のために何か提案はありますか？

私の手順は、例を見て、機能を1つずつ修正することでした。
まだいくつかの壊れた（つまり間違った出力）ケースがありますが、少なくともそれらは代わりにエラーメッセージで失敗するようにする必要があります。 また、エラー処理は、JS例外が発生するという点でユーザーフレンドリーではない可能性があります。

これは比較的複雑な拡張機能であるため、MathJaxテストなどの自動テスト手順を組み込むことで、一歩前進できると思います。 特に、見落とされがちなオプションやコーナーケースがたくさんあるので。

最後に、生成されたMathMLを調べて、誤植や意味の正しさを確認するとよいでしょう。

実際、今日は先延ばしが切実に必要だったので、リスト、角度、リテラル単位の入力を修正しました。 これにより、壊れていることがわかっている機能は残りません。 ただし、生成された出力はまだ最適に見えません。 確かに、私はそこで助けていただければ幸いです。 MathJaxのMMLクラスがどのように機能するのか、MathMLをよく知っているのか、試行錯誤しているだけなのかわかりません。 特に、間隔が正しくなく、FirefoxのHTML-CSSとMathMLの出力が異なります。

@burnpanck yay for procrastination :-)たぶん、私たちはいつかチャットのために集まるべきですか？ あなたのコードは本当に面白そうです。私たちは物事がどこにあるのか、そして私たちがどのように役立つのかをよりよく理解したいと思っています。 興味があれば、peterで私にpingしてください。 [email protected]。

+ 1、mathjaxにユニットを含めることは必須です!!!
@burnpanckあなたの仕事に感謝します！
エンジニアがラテックスを使用する理由の1つは、数と単位の間に常に完全なスペースがあり、途切れることがない、すべての数に見栄えのする単位があることです。
そしてエンジニアは彼らのウェブサイトにもこれを持っていることを崇拝するでしょう:-)

@ hpvd @ burnpanckはヘルパーを探していると思います。 MathJaxのTeX入力の内部動作やその他の質問についてサポートできる場合は、お知らせください。

注として：
プライベートdokuwikiインスタンスとmathjaxプラグインで@burnpanckの拡張機能を使用しています。
そのページ（下）のFAQでセットアップについて簡単に説明しました。 ファイルへの直接リンクを配置するすべての人（特に@burnpanck）にとって問題がないことを願っていますか？

これまでのところ問題なく動作します（ \SI 、 \si 、 \num使用）。 私が見逃しているのは、出力を微調整するための\sisetupだけです。 時間があればハックしますが、今まではこの欠陥に耐えることができます。バグに遭遇して修正したり、最終的には新機能をハックしたりする可能性があります。 その場合は、ここに報告します。

@RafiKueng
詳細な説明をありがとう！

@burnpanckリポジトリからサードパーティのリポジトリへのPRを作成した場合、異議はありますか？ その後、CDNに配置され、人々はそれを使用/テストするのが簡単になります。

異議はありません、どうぞどうぞ！ しばらく前のビデオチャットで、残りの問題のいくつかに対処することに同意しました。残念ながら、冬の終わりまでほとんど時間がありません。 でも、現状でも便利な方もいらっしゃると思います！

異議はありません、どうぞどうぞ！

すごい！ 私は最初のPRをしました。 サードパーティのリポジトリのテストフォルダを削除しても大丈夫かどうか疑問に思っています。テストはおそらく今のところ自分で行う必要がありますか？ それでよければ、PRを少しクリーンアップします。

残りの問題のいくつかに対処しますが、残念ながら、私は冬の終わりまでほとんど時間がありません

心配はいりません。これまでに行ったことは素晴らしいことです。

どこかにやることリストはありますか？ 潜在的な貢献者が簡単な（または難しい）作業項目のリストを持っていると、おそらく役立つでしょう。 チャットからもメモを掘り下げることができるかどうかを確認します。

@burnpanckの拡張機能のコピーをサードパーティのリポジトリとCDNにプッシュしました。 ライブデモについては、 http：//codepen.io/pkra/pen/meLxzWを参照してください。

このデモは素晴らしいです-のような複雑なものでさえ
$$ \ SI [per-mode = symbol] {123,44e-3} {\ kilogram \ metre \ perampere \ per \ second} $$
正常に動作しています！

現時点では機能していないと思われる比較的重要なことの1つは、小数点以下の桁を「、」（コンマ）に切り替えることです。
siunitxドキュメント28ページからこのためのコードは次のようになります
\ num [output-decimal-marker = {、}] {1.23}
デモにはまだ「。」が表示されます （ドット）

そのような発見をどのように扱うべきでしょうか？ /どこに報告しますか？

そのような発見をどのように扱うべきでしょうか？ /どこに報告しますか？

ええと、それは@burnpanckのコードです。 たぶんhttps://github.com/burnpanck/MathJax-third-party-extensions/ （これは私がPRを指示した場所です）。

私たち（MathJaxチーム）は喜んでサポートとアドバイスを提供しますが、サードパーティの拡張機能はまさにそのサードパーティのコードであるため、あまり多くのリソースをそれらに捧げることはできません。

この場所では、問題を開く可能性が無効になっているようです。 たぶん私たちはまだ@burnpanckのコメントを待っています...

君たちは速い！ 問題が有効になりました。重要と思われるものを自由に追加してください。 すぐに対処する時間がない場合でも、問題を収集するのに適した場所です。

@pkra ：ファイルsiunitx/ImplementationDetails.mdがあります。このファイルには、改善できる領域を示す短いリストが含まれています。 チャットの直前にそのリストを書きました。

@burnpanck戻ってきて、問題を有効にしてくれてありがとう。 最初のものを開いたばかりです;-)

@pkra 1つの一般的な質問：デモが常に最新のコードを使用する自動のようなものはありますか？ =>では、これはテストに適した場所ですか？

@pkra 1つの一般的な質問：デモが常に最新のコードを使用する自動のようなものはありますか？

これは個別に設定する必要があります（実際には少し注意が必要です）。 最も簡単な方法は、拡張機能のコードを直接codepenまたはjsbinページ（ http://codepen.io/pkra/pen/OyZqqxなど）にコピーして貼り付けることです。 あなたはそれをフォークしてあなたの喜びにハックして、あなたが望むように更新することができます。

codepenを使用したことはありませんが、通常のMathJaxセットアップを使用してMathJax.Ajax.config.path['Contrib'] = 'http://rawgit.com/burnpanck/MathJax-third-party-extensions/add-siunitx-tex-extension'を実行することはできませんか？
rawgitを使用したsiunitxのドキュメントの（非対話型）参照レンダリングがあることに注意してください。 インタラクティブなテストページもあります。 rawgitリンクは、常にブランチadd-siunitx-tex-extensionの先頭を指します。

通常のMathJaxセットアップを使用することはできません

もちろん。 コードをハックするためのライブデモを考えていました。

私はhttp://codepen.io/pkra/pen/meLxzWを更新して、rawgit経由でリポジトリを使用しました。

これはまだ取り組んでいますか？
..（cocalc.comで）これに遭遇したばかりで、

%md
$n_{out} = 60\mathrm{~min^{-1}}$

これはまだ取り組んでいますか？

siunitxにはサードパーティの拡張機能があり、そのリポジトリはhttps://github.com/burnpanck/MathJax-siunitxにあります。

https://rawgit.com/burnpanck/MathJax-siunitx/master/examples/siunitx.dtx.html

だから基本的に今は死んでいる。 悲しい。 それを復活させるチャンスはありますか？

これは決してsiunitxに代わるものではありませんが、MathJaxで単純な単位を入力したいだけのユーザーは、mhchemの\puコマンドを見ることができます。 \pu{\pu{123 kJ*mol-1}}マニュアル、一番下までスクロールします。 （このコマンドはStackExchangeで数年間使用されています。したがって、これを恥知らずな宣伝ではなく、わかりやすいポインタとして表示してください。）