Ipython: 노트북의 방정식 번호.

+1
이것은 모든 종류의 수학 문서에서 다소 중요한 기능입니다.
MathJax에는 이미 다음과 같은 기능이 있습니다.

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

참조에 관한 한, LaTeX 방정식(및 LaTeX 백엔드)에만 국한된 것이 아니라 통합 구문을 사용하여 일반 상호 참조 시스템을 개발하는 것이 중요하다고 생각합니다.

나는 일반적인 상호 참조 시스템이 있어야 한다는 데 동의하지만 파이썬 코드와 인터페이스할 수도 있어야 한다고 덧붙입니다. 이렇게 하면 마크다운의 라텍스가 코드에서 생성된 그림을 참조할 수 있습니다.

이것은 아마도 유사한 시스템을 사용할 것이기 때문에 마크다운 셀에서 파이썬 변수에 접근하기 위한 시스템을 사용할 수 있을 때까지 기다려야 할 것입니다.

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 노트북을 사용하여 대학 3학년 수준의 전자기학 과정의 교재를 보완하고 있으며 학부 커리큘럼 전반에 걸쳐 광범위한 ipython 노트북 구현을 추진할지 여부에 대한 테스트 케이스로 사용하고 있습니다. 전자 필기장 또는 전자 필기장의 섹션 내에서 일관된 등식 번호 매기기의 부족은 텍스트에서 등식 번호를 참조하는 기능과 함께 심각한 제한입니다. 나는 노트북의 LaTeX 부분에 특정한 번호를 부여하는 것이 좋습니다. 특히 더 일반적인 접근 방식을 시도하는 것이 이 기능을 얻기 위해 더 오래 기다려야 한다는 것을 의미하는 경우에 그렇습니다.

+1.
마찬가지로 여기에서 ipython을 사용하여 Numerical Calculus 과정에 대한 메모를 작성하고 있으며 참조 번호 매기기가 실제로 누락되었습니다.

+1

이것이 내가 iPython Notebook을 주요 문서 작성 도구로 사용하는 것을 막는 유일한 것입니다(실시간 협업이 부족하다는 점을 제외하고는 중요하지 않습니다). 대신 여기에서 대략적인 초안을 작성한 다음 LaTeX 편집기로 이식해야 합니다.

+1 :+1: 우리는 이것을 사용하여 강의를 하고 있는데 이 기능은 절대적으로 필요합니다!

좋아, 마침내 Mathjaxutils.js를 수정하는 이 게시물 에 설명된 "해결책"을 시도했습니다. 라텍스가 포함된 마크다운 셀을 변경한 후 ipython 노트북 웹 페이지를 새로 고치기만 하면 방정식 번호가 표시되고 올바른 순서로 수행됩니다. 페이지를 새로 고치면 레이블이 수정되어 레이블이 정의된 셀이 다시 실행될 때(즉, 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 구문이 있습니다.
Jupyter 노트북 예제의 수동 MathJax 수식 태그 . 동일한 제한 사항(브라우저를 새로 고치지 않으면 Markdown 셀을 다시 실행하면 MathJaX가 중단됨)이 있지만 최소한 이를 수행하기 위해 노트북을 재구성할 필요는 없습니다.

@ahmadia 감사합니다! 셀 깨기를 다시 실행하는 것은 확실히 약간 실망 스럽습니다. 그러나 이것은 레이블이없는 \begin{equation} 에서 엄청난 발전입니다!

@ahmadia 방정식 참조가 링크나 라이브 노트북(새로 고침 후에도)에서 해결되지 않을 것으로 예상됩니까?

새로 고침을 시도한 다음 모든 셀을 실행하십시오. 링크가 GitHub에서 작동하지 않는다고 생각합니다.
GH가 URL을 제거하기 때문입니다.

2015년 10월 3일 토요일에 Jack Poulson [email protected] 은 다음과 같이 썼습니다.

@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" } }
});

자바 스크립트 확장에서 또는 노트북의 자바 스크립트 출력에서도 자동 방정식 번호 매기기가 켜집니다. 기본적으로 Mathjax 방정식 번호가 페이지의 위치가 아니라 렌더링 시간에 따라 정렬되므로 첫 번째 페이지 로드 시에만 번호 매기기가 정확하다는 점에서 기본적으로 수행할 수 없도록 하는 모든 문제가 있습니다.

실제로 수식 번호 매기기를 재설정하고 전자 필기장에서 수식을 다시 렌더링할 수 있습니다.

이 작업을 수행하는 간단한 노트북 확장 프로그램을 만들었습니다.
https://github.com/ipython-contrib/IPython-notebook-extensions/pull/335

@juhasch 대단해! 대부분의 상황에서 방정식 숫자에 대한 매우 열악한 경험을 감안할 때 기본값을 해제하는 것이 최선의 선택이라고 생각합니다. 그러나 이것을 프론트엔드 구성 옵션과 번호 다시 매기기 작업으로 만드는 것이 좋습니다.

나는 노트북을 만들 때 re-render/re-number를 자주 사용한다고 상상하기 때문에 도구 모음 버튼에 투표하거나 메뉴에 들어갈 경우 최소한 일반 모드 단축키에 투표할 것입니다.

@lucasb-eyer @juhasch 가 제공한 것과 같은 확장에 대해 수행하는 것이 좋은 일이라고 생각하지만 기본 키보드 단축키와 도구 모음 공간이 모두 매우 소중하기 때문에 기본적으로 수행하지 않을 것입니다. 그러나 custom.js 또는 nbextension을 통해 둘 중 하나 또는 둘 다를 추가하는 것이 가능합니다.

@minrk : nbextensions 서버 확장을 사용하여 확장을 쉽게 활성화/비활성화하고 다시 렌더링을 켜고 끌 수 있습니다.

를 누르면 도구 모음 버튼, 방정식 번호 매기기가 재설정/다시 렌더링됩니다.

@juhasch 작업 감사합니다! 이것은 큰 진전입니다.

@minrk 귀하의 경험에 따르면 방정식 번호 매기기에 대한 장기적인 적절한 솔루션으로 무엇을 제안하시겠습니까? @juhasch 의 확장은 현재로서는 해결 방법일 뿐입니다. 구현을 요구하는 것이 아니라 솔루션이 무엇인지 간략하게 설명하십시오. 나는 이것에 대해 진정으로 괴로워하는 사람들이 많이 있다고 생각하며, 우리가 앞으로 나아갈 방향이 무엇인지 안다면 시도해 볼 수 있습니다.

방정식 번호 매기기에 대한 장기적인 적절한 솔루션으로 무엇을 제안하시겠습니까?

당신은 그것을 가질 수 없습니다. MathJax는 방정식 번호 매기기를 수행할 때 전체 페이지에 액세스할 수 있다고 가정하고 IPython은 셀 단위로 Markdown을 렌더링합니다. 노트북이 아닌 MathJax 측면에서 작업/구현이 필요합니다.

대부분의 사람들(저 포함)은 방정식 번호 매기기를 원합니다. 나는 그것이 기술적으로 어떻게 구현되는지에 대해 그다지 신경 쓰지 않는다고 생각합니다. 예를 들어 노트북이 전체 페이지에 액세스하지 않고도 방정식 번호를 알려줄 수 있도록 MathJax에 몇 가지 패치를 추가하거나 다른 솔루션은 MathJax를 사용하여 숫자 없이 방정식을 렌더링하는 것과 같이 앞으로 여러 가지 가능한 방법을 볼 수 있습니다. , 그런 다음 노트북 자체로 숫자를 렌더링합니다. 더 많은 옵션이 있을 수 있습니다. 그러나 나는 내부에 대해 잘 알지 못하기 때문에 방법이 최고라는 공식적 축복을 받고 싶습니다.

방정식 번호 매기기에 대한 장기적인 적절한 솔루션으로 무엇을 제안하시겠습니까?

지금은 기본적으로 @juhasch 가 확장 기능으로 수행한 작업을 수행하고 마스터에 병합되면 다음 변경 사항이 적용됩니다.

1. 기본적으로 해제
2. 프론트엔드 구성에 토글을 저장하므로 한 번만 켜면 됩니다.
3. 번호 다시 매기기 작업을 추가하여 키보드 단축키에 바인딩할 수 있습니다.
4. 도구 모음 대신 메뉴에 번호 다시 매기기를 위한 기본 UI 배치

기본적으로, 이것이 우선순위인 사람들을 위한 확장보다 약간 더 나쁘게 만들 것입니다. 왜냐하면 그것은 기본값으로 이해되지 않기 때문입니다. 그러나 작업을 사용할 수 있게 되면 바로 가기 및 도구 모음 버튼과 같은 항목을 추가하는 것이 우선 순위가 다른 사람들을 위한 간단한 사용자 지정이 됩니다.

항상 정확한 번호 매기기가 얼마나 실현 가능한지 모르겠습니다. 왜냐하면 이는 마크다운 셀 또는 HTML 출력의 _모든_ 렌더링에서 번호 매기기를 재설정해야 하고 _모든_ 마크다운 셀과 HTML 출력을 다시 렌더링해야 함을 의미하기 때문입니다. 매번.

문서가 주어지면 사용자로서 합리적인 계획처럼 들립니다. :+1:

@minrk : 사용자로서 저도 이것이 유용한 솔루션이라고 생각합니다. 모든 마크다운 및 HTML 출력을 다시 렌더링하는 것은 얼마나 번거로운 일입니까?

@gregnordin 은 노트북의 크기에 따라 달라지며 노트북의 크기에 따라 무한하게 커집니다. 이는 마크다운 셀을 편집할 때마다 처음 열 때 전체 노트북을 로드하는 것과 비슷한 시간이 걸릴 수 있음을 의미합니다. 기본 동작에는 확실히 좋지 않지만 확장 프로그램이 이를 시도하려는 경우 시도할 수 있습니다.

+1

이 기능에 대해 +1입니다. 저는 학생들을 위한 물리학 강의를 준비 중이며 방정식 번호 매기기는 필수적입니다.

모든 것을 다시 렌더링하지 않고 방정식 번호를 업데이트할 수 있는 또 다른 옵션은 HTML 출력에서 ​​방정식이나 참조가 있는 요소를 검색하고 해당 텍스트를 적절한 값으로 바꾸는 자바스크립트입니다.

완전히 작동하려면 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가 Latex 인용을 처리하기 위해 유사한 접근 방식을 사용한다는 것을 발견했습니다. http://nbconvert.readthedocs.io/en/latest/latex_citations.html

현재 MathJax는 렌더링 후 참조를 확인하기에 충분한 속성을 HTML 출력에 추가하지 않습니다. 이것이 내가 필요한 HTML 출력을 얻기 위해 이러한 해킹 레이블과 참조를 사용하는 이유입니다. 이 레이블을 사용하면 Latex -> pdf로의 일반적인 변환이 중단됩니다.

이제 HTML 속성을 일반 레이블 및 참조에 추가하는 쉬운 방법이 있는지 알아보기 위해 MathJax 소스 코드에 익숙해지고 있습니다.

다음 단계는 이미 인용과 마찬가지로 이러한 HTML 속성을 인식하도록 nbconvert에 지원을 추가하는 것입니다. nbconvert가 이러한 속성을 사용하여 HTML에 대한 코드 섹션의 출력을 스캔할 수도 있는 경우 HTML 캡션/레이블을 코드 생성 그림에 추가할 수 있고 nbconvert
올바른 Latex 출력을 생성할 수 있습니다. 그러면 마크업 셀에서 그림을 참조할 수 있습니다.

ipython 노트북에서 참조를 완벽하게 지원하기 위한 접근 방식의 개요일 뿐입니다. 그것은 나에게 실현 가능한 것처럼 보이지만 지금 이미 쇼호퍼를 본 사람이 있다면 알려주세요. 나는 ipython 노트북의 내부에 대해 거의 알지 못합니다. 이것은 더 많은 것을 배울 수 있는 재미있는 프로젝트처럼 보이지만 지금은 모든 의미를 감독할 수 없습니다.

방금 이 (긴) 스레드를 찾았습니다...

이것이 흥미로울 수 있습니다. 저는 문서 전체에서 방정식과 환경 모두의 _자동 번호 지정 및 업데이트_를 포함하여 LaTeX 환경의 렌더링을 지원하기 위해 무언가를 시도했습니다.
새로 고침 버튼을 사용했지만 지금은 위에서 @basvandertol 이 언급한 것과 유사한 아이디어를 사용합니다.

물론 이 모든 것이 약간의 과부하를 추가하지만, 이것은 상당히 긴 문서의 경우에도 대체로 수용 가능합니다. 노트북을 html 및 LaTeX 문서로 내보낼 수 있습니다.

여기 또는 Pypi 에서 확장 기능을 볼 수 있습니다. 최상의.

제안된 솔루션의 일부 버전을 마스터에 통합하기 위해 +1.

이것은 이미 해결되었거나 +1해야 합니까?