NetBeans IDE의 phpdocumentor의 특수 HTML 문자

StackOverflow https://stackoverflow.com/questions/2247082

문제

아시다시피 NetBeans IDE는 PHPDocumentor Syntax를 기반으로 PHP 소스에서 문서를 인라인 문서화 할 것입니다.

내가 찾은 것은 Phpdocumentor 문서에서 특수 HTML 문자를 사용할 때 NetBeans에서 HTML로 취급되지만 phpdocumentor에서 생성 한 HTML 문서의 텍스트로 취급된다는 것입니다.

예를 들어:

/**
 * Add a new <link> to the <head> of the document.
 */

phpdocumentor에 의해 생성 된 HTML에서 다음과 같이 표시됩니다.

Add a new <link> to the <head> of the document.

그러나 NetBeans IDE에서는 다음과 같이 표시됩니다.

Add a new <link> to the <head> of the document.

어느 것이 맞습니까? phpdocumentor 댓글에 특수 HTML 문자를 포함시키는 올바른 방법은 무엇입니까?

도움이 되었습니까?

해결책 3

일부 재설정 후 Phpdocumentor/Netbeans는 해석해야합니다. 약간태그. Wikipedia에서 볼 수 있듯이 여기, 다음 태그 만 HTML로 해석해야합니다.

  • 비
  • 암호
  • Br
  • 나
  • KBD
  • 리
  • ol
  • 피
  • 사전
  • 샘
  • ul
  • var

다른 모든 태그는 일반 텍스트로 표시되어야합니다. 현재 NetBeans 해석 모두 태그. phpdocumentor docbuilder는 일부 태그 만 해석하므로 버그 IMO입니다.

나는 문제를 열었다 (180636) NetBeans 웹 사이트에서.

바라건대 곧 고정 될 것입니다 ...

다른 팁

PHPDocumentor가 정의상 옳다고 생각했을 것입니까? 결국 그것은 그들의 형식입니다.

이 단계에서 HTML-Decode를 수행하는 것은 바람직하지 않은 것 같습니다. 이와 같은 텍스트 마크 업 시스템의 전체 아이디어는 엔티티 참조 이스케이프와 같은 HTML 세부 사항을 피하는 것입니다. 당신이 넣은 문자 그대로의 HTML은 어떤 일이 일어나고 있는지, Netbeans는 그것을 렌더링하려고합니까?

특수 캐릭터를 처리하는 것과 관련하여 무엇이든하는 올바른 방법은 원하는 실제 문자를 사용하고 필요한 순간에 변환하는 것입니다.

따라서 올바른 방법은 귀하의 의견에 실제 <> 문자를 사용하는 것이며 PHPDOC 애드온은 .html 파일의 HTML 인코딩 버전으로 변환해야합니다. 그들이하거나 말하는 것.

라이센스 : CC-BY-SA ~와 함께 속성
제휴하지 않습니다 StackOverflow
scroll top