Latex3: "패키지" 메시지라고 주장되는 클래스 메시지

하지만 \g_msg_module_type_prop 파일 유형을 추가하여 명시적으로 알려야 합니다.

\prop_gput:Nnn \g_msg_module_type_prop { myclass } { Class }

선택적으로 이름을 \g_msg_module_name_prop .

\prop_gput:Nnn \g_msg_module_name_prop { myclass } { My~Nice~Class }

그러면 다음과 같은 경고가 표시됩니다.

Class My Nice Class Warning: Bar

어쩌면 l3msg 수 자동 채우기 경우 유형을 \ProvidesExpl<Thing> 사용되었다 ...

MWE:

\begin{filecontents*}[overwrite]{myclass.cls}
\ProvidesExplClass
  {myclass}
  {2021/04/26}
  {0.1}
  {
    My Nice Class
  }
\NeedsTeXFormat{LaTeX2e}
\LoadClass { article }
%
\prop_gput:Nnn \g_msg_module_type_prop { myclass } { Class }
\prop_gput:Nnn \g_msg_module_name_prop { myclass } { My~Nice~Class }
\msg_new:nnn {myclass} {Foo} {Bar}
\msg_warning:nn {myclass} {Foo}
\end{filecontents*}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass{myclass}
\begin{document}
\end{document}

\ProvidesExpl<Thing> 가 사용된 경우 l3msg 이 유형을 자동으로 채울 수 있습니다...

좋은 것! :웃다:

\ProvidesExpl... 와 코드에 사용되는 모듈 접두사 사이에는 특별한 관계가 없습니다. 수동으로 해야 하는 일이라고 생각합니다.

그것은 전체 '실제로 클래스는 expl3 구문을 사용해서는 안 된다'라는 문제가 있기 전입니다. 그것은 제대로 작동하지 않는 아이디어였습니다. (클래스는 여전히 더 많은 작업이 필요하지만 패키지에 속하는 프로그래밍을 해서는 안 됩니다.)

\ProvidesExpl... 와 코드에 사용되는 모듈 접두사 사이에는 특별한 관계가 없습니다. 수동으로 해야 하는 일이라고 생각합니다.

왜 그런지 모르겠다.

그것은 전체 '실제로 클래스는 expl3 구문을 사용해서는 안 된다'라는 문제가 있기 전입니다. 그것은 제대로 작동하지 않는 아이디어였습니다. (클래스는 여전히 더 많은 작업이 필요하지만 패키지에 속하는 프로그래밍을 해서는 안 됩니다.)

나는 잘 작동하지 않는 아이디어가 무엇인지 이해하지 못합니다.

\ProvidesExpl... 와 코드에 사용되는 모듈 접두사 사이에는 특별한 관계가 없습니다. 수동으로 해야 하는 일이라고 생각합니다.

왜 그런지 모르겠다.

\ProvidesExplClass 에서 클래스 이름은 코드에서 사용하는 접두사와 일치할 필요가 없습니다. 또는 코드는 패키지와 클래스 모두에서 사용할 수 있으므로( achemso LaTeX2e 용어로 사용) 링크가 명확하지 않습니다.

그것은 전체 '실제로 클래스는 expl3 구문을 사용해서는 안 된다'라는 문제가 있기 전입니다. 그것은 제대로 작동하지 않는 아이디어였습니다. (클래스는 여전히 더 많은 작업이 필요하지만 패키지에 속하는 프로그래밍을 해서는 안 됩니다.)

나는 잘 작동하지 않는 아이디어가 무엇인지 이해하지 못합니다.

클래스는 기능이 아니라 형식화/스타일/등에 관한 것이어야 합니다. 후자는 패키지에 의해 추가되어야 하며 이상적으로는 패키지와 함께 사용되는 클래스와 독립적입니다. 현재 상황은 이상적이지 않으며 초기에 \ProvidesExpl... 세트가 LaTeX2e 커널에서 \Provides... 를 단순히 미러링하기 위해 제공되었습니다. 그러나 돌이켜 보면 잘못된 접근 방식입니다. _packages_는 expl3 코드를 사용해야 하고 _classes_는 expl3 에서 구현될 _수도 있는 문서 수준 또는 디자인 수준 인터페이스를 사용해야 합니다.

클래스는 기능이 아니라 형식화/스타일/등에 관한 것이어야 합니다.

내가 현재 작업하고 있는 클래스는 문서의 첫 번째 페이지에 그래픽을 삽입해야 합니다... 이 그래픽이 발견되고 그렇지 않으면 경고(로그 파일의 경고와 함께)를 표시해야 합니다. 디자인인가 기능인가?

l3msg 문서의 앞부분에서 \g_msg_module_name_prop 및 \g_msg_module_type_prop 문서를 이동하여 당면한 문제를 해결했습니다.

@dbitouze 디자인 대 코드에 대해 좋은 질문을 하고

완료 .

l3msg 문서의 앞부분에서 \g_msg_module_name_prop 및 \g_msg_module_type_prop 문서를 이동하여 당면한 문제를 해결했습니다.

AFAICS, OP의 MCE는 여전히 다음과 같이 씁니다.

패키지 myclass 경고: 바

심지어 pdflatex-dev . 다음은 터미널의 출력(파일 목록 포함)입니다.

This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021) (preloaded format=pdflatex-dev)
 restricted \write18 enabled.
entering extended mode
(./test.tex
LaTeX2e <2021-12-01> pre-release-0 (develop 2021-6-6 branch)
L3 programming layer <2021-06-01>

LaTeX Warning: Writing or overwriting file `./myclass.cls'.


(./myclass.cls
Document Class: myclass 2021/04/26 v0.1  My Nice Class 
(/usr/local/texlive/2021/texmf-dist/tex/latex-dev/base/article.cls
Document Class: article 2021/02/12 v1.4n Standard LaTeX document class
(/usr/local/texlive/2021/texmf-dist/tex/latex-dev/base/size10.clo))

Package myclass Warning: Bar

) (/usr/local/texlive/2021/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def)
 (./test.aux) (./test.aux)

 *File List*
 myclass.cls    2021/04/26 v0.1  My Nice Class 
 article.cls    2021/02/12 v1.4n Standard LaTeX document class
  size10.clo    2021/02/12 v1.4n Standard LaTeX file (size option)
l3backend-pdftex.def    2021-05-07 L3 backend support: PDF output (pdfTeX)
 ***********

 )
No pages of output.
Transcript written on test.log.

@dbitouze 신청

\prop_gput:Nnn \g_msg_module_type_prop { myclass } { Class }

Bruno의 메시지에서 "수정됨"은 문서를 더 일찍 이동하여 해당 라인이 더 이상 필요하지 않다는 것이 아니라 추가해야 한다는 것을 분명히 하는 것이었습니다.

@dbitouze 신청

\prop_gput:Nnn \g_msg_module_type_prop { myclass } { Class }

흠, 아니, 오해해서 죄송합니다.

Bruno의 메시지에서 "수정됨"은 문서를 더 일찍 이동하여 해당 라인이 더 이상 필요하지 않다는 것이 아니라 추가해야 한다는 것을 분명히 하는 것이었습니다.

너무 나쁨: 수정이 더 이상 수업 작성자의 조치가 필요하지 않다고 생각했습니다(그리고 희망했습니다).

@josephwright가 설명했듯이 사용된 접두사와 클래스 또는 패키지 이름 사이에는 자동으로 감지 가능한 연결이 없습니다. 이것은 \ClassWarning 를 명시적으로 말한 다음 이름을 지정하는 이전의 2 방법과 실제로 다르지 않습니다. 이제 연결을 한 번만 정의하면 됩니다. \Class... 명령을 실행 하고 클래스 이름을 지정합니다.

따라서 "myclass"를 사용하는 것은 msg 시스템에 전달된 문자열일 뿐이고 우리 인간은 이름에서 "class"를 보는 것이 msg 시스템이 해당 추론을 할 수 없는 클래스라는 것을 의미한다고 생각할 수 있지만(어쨌든 틀릴 수 있음). 이것이 클래스 작성자의 조치가 필요한 이유이며 과거에 \ClassWarning{<classname>} 를 작성한 곳에서 필요했습니다. 클래스 이름이 \ProvidesExplClass 로 알려져 있다고 해서 msg에 사용된 문자열이 해당 이름을 사용한다는 의미는 아닙니다. 예를 들어 대부분의 패키지 이름은 길지만 내가 사용하는 접두사는 상당히 짧습니다. 따라서 특정 문자열이 클래스임을 msg 시스템에 알려야 합니다.

\ProvidesExplClass가 호출되고
\g_msg_module_type_prop이 시작과 끝 사이에 수정되지 않았습니다.
파일(\msg_new:nnnn이 호출된 경우에만 경고).

너무 추하게 들리지 않으며 이 쉬운 실수를 피할 수 있습니다.

우리는 할 수 있지만 오류는 잘못된(그러나 무해한) 출력으로 나타나며 한 번에 쉽게 수정되는 클래스 오류인 동안 모든 문서에 대한 런타임 비용입니다. 따라서 저는 런타임 검사로 처리 속도를 늦추는 것을 선호하지 않습니다. 모든 경우 확인 옵션으로 이동해야 합니다. 나는 이 런타임 비용이 그 자체로는 모두 작지만 전체적으로 합산된다는 것을 알고 있습니다.