라텍스의 일부 패키지를 사용하고 싶은데 해당 패키지에 대한 설명서를 찾았습니다. 그러나 나는 이 모든 매뉴얼이 명시적인 예나 표시된 결과 없이 순전히 코드와 설명이라는 것을 알았습니다. 저는 컴퓨터 과학자가 아닙니다. 이 패키지를 사용하는 방법을 이해하기 위해 모든 일반 텍스트를 읽는 것은 상당히 지루하고 비효율적입니다. 저 같은 아마추어를 위한 모든 패키지의 매뉴얼을 찾을 수 있는 곳이 있나요? 나는 이 매뉴얼/노트(패키지 작성자가 반드시 작성한 것은 아님)가 다음과 같은 속성을 갖기를 원합니다.
프레임워크를 소개하기 위해 몇 가지 쉬운 예를 선택하는 것처럼 너무 대략적이지는 않습니다. 나는 그것이 포괄적이고 해당 패키지의 모든 함수, 메소드 또는 매개변수에 대한 모든 세부사항을 알려줄 수 있기를 원합니다.
나에게 가장 중요한 것은 모든 함수/메소드/매개변수에 명시적인 예제와 표시된 결과가 있어야 한다는 것입니다. 따라서 표시된 결과를 빠르게 탐색할 수 있으며 아하, 이것이 제가 원하는 모습입니다.
추신: 저는 LaTeX가 유료 소프트웨어가 아니라는 것을 확실히 알고 있습니다. 패키지 작성자는 원하는 대로 작성할 권리가 있습니다. 딱딱한 원본 매뉴얼을 잘 소화하고, 겉만 긁지 않고 친근하게 아마추어들에게 먹이를 주는 좋은 강사들이 있는지 궁금합니다. 내가 원하는 것의 좋은 예는 다음과 같습니다.Wolfram Mathematica의 문서 센터.
답변1
아니요, 그러한 사이트는 존재하지 않으며 단지 매뉴얼이 지루하다고 해서 누구도 귀하를 위해 사이트를 만들어주지 않을 것입니다.
Mathematica는 독점 애플리케이션이며 패키지 문서화 방법을 제어할 수 있습니다. Python은 오픈 소스이지만 "이를 수행하는 데는 하나의 방법, 가급적이면 단 하나의 방법이 있어야 한다"는 데 거의 모두가 동의하는 강력한 커뮤니티 윤리가 있습니다. 따라서 좋은 문서화는 문화의 일부입니다. LaTeX는 그런 것이 아닙니다.
나는 일부 패키지 문서가 꽤 훌륭하다는 논평자들의 의견에 동의합니다. tikz제가 pgfplots가장 좋아하는 것 중 하나예요. 그리고 대부분의 문서는 그렇지 않습니다.나쁜; 그것은 당신이 그것으로 하고 싶은 모든 가능한 일을 설명하지 못할 수도 있습니다.
그러나 다양한 LaTeX(및 ConTeXt, 핵심 TeX) 사용 사례에 대한 답변이 있는 방대한 리소스를 찾고 있다면 이미 찾았을 수도 있습니다. TeX.SE의 질문에는 사용된 패키지별로 태그가 지정되므로 많은 예제를 찾아보고 검색할 수 있습니다. TeX.SE의 페이지는 찾기가 쉽습니다. 보통 나는 "라텍스(내가 하고 싶은 것)"를 구글에 검색하면 대개 이 사이트의 페이지가 가장 높은 결과로 나옵니다. 원하는 것을 찾지 못했다면 물어보세요!
답변2
죄송하지만 귀하의 요청이 너무 야심찬 것 같습니다. 그러나 저자들은LaTeX 동반자시리즈 (LaTeX 동반자,LaTeX 그래픽 동반자그리고LaTeX 웹 도우미, 모두 Addison Wesley 출판)은 귀하의 요청을 충족시키기 위해 먼 길을 걸어왔습니다. 개별 패키지/클래스의 경우 중요하다고 생각하는 문서를 제공하는 것은 개발자/작성자에게 달려 있습니다. 대부분의 경우 그들과 나는 독자들이 LaTeX에 대한 특정 지식을 갖고 있으며 기본 요소를 반복할 필요가 없을 것이라고 가정했습니다.
memoir나는 ( ) 클래스 의 원 개발자로서 > texdoc memoir약 540페이지에 달하는 매뉴얼을 읽었다. 여기에는 클래스 내의 모든 매크로에 대한 40페이지 색인이 포함되어 있으며, 모든 매크로는 매뉴얼 본문에 어느 정도 설명되어 있습니다. 주요 결과를 사용한 결과의 예가 제공됩니다. 수업 시간에 모든 매크로를 사용하는 예제는 매뉴얼 크기의 3배가 될 것으로 추정됩니다. 누가 그걸 읽을까요? 그리고 나는 그것을 쓰지 않을 것입니다.
무엇을 보고 싶은지에 대한 아이디어가 있으므로 이해하게 된 패키지에 대해 아마추어 수준의 문서를 작성하고 일반 배포를 위해 CTAN에 제출하시겠습니까?
곰