Tutorial/manual abrangente para LaTeX/pacotes com exemplo explícito e resultados mostrados em vez de códigos puros como o centro de documentos do mathematica

Tutorial/manual abrangente para LaTeX/pacotes com exemplo explícito e resultados mostrados em vez de códigos puros como o centro de documentos do mathematica

Quero usar alguns pacotes em látex, então encontro o manual desse pacote. No entanto, acho que todos esses manuais são puramente códigos e explicações, sem exemplos explícitos e resultados mostrados. Eu não sou um cientista da computação. É bastante chato e ineficiente ler todos os textos simples para entender como usar este pacote. Existe algum lugar onde eu possa encontrar o manual de cada pacote para amadores como eu? Quero que este manual/nota (certamente não necessariamente escrito pelos autores dos pacotes) tenha as seguintes propriedades:

  1. Não é muito superficial, como apenas escolher alguns exemplos fáceis para apresentar a estrutura. Quero que seja abrangente e possa me fornecer todos os detalhes de cada função, método ou parâmetro desse pacote.

  2. O mais importante para mim é que cada função/método/parâmetro tenha exemplos explícitos e resultados mostrados. Portanto, posso explorar rapidamente os resultados mostrados e aha, é assim que eu quero que seja.

PS: Eu certamente entendo que o LaTeX não é um software pago. Os autores dos pacotes têm o direito de escrever como quiserem. Eu me pergunto se existem bons instrutores que digerem o manual seco original e alimentam amadores que não querem apenas arranhar a superfície de maneira amigável. Um bom exemplo do que eu quero é comocentro de documentos do Wolfram Mathematica.

Responder1

Não, esse site não existe e ninguém vai criá-lo para você só porque você acha o manual chato.

O Mathematica é um aplicativo proprietário e é capaz de controlar como seus pacotes são documentados. Python é de código aberto, mas tem uma forte ética comunitária onde praticamente todos concordam que “deve haver uma – e de preferência apenas uma – maneira de fazer isso”. Portanto, uma boa documentação faz parte da cultura. LaTeX não é nenhuma dessas coisas.

Concordo com os comentaristas que alguma documentação do pacote é muito boa. tikze pgfplotsestão entre os meus favoritos. E a maior parte da documentação não éruim; simplesmente pode não explicar todas as coisas possíveis que você pode querer fazer com ele.

Mas se você está procurando um vasto recurso de perguntas respondidas para vários casos de uso do LaTeX (e do ConTeXt e do núcleo do TeX), talvez você já o tenha encontrado. As perguntas no TeX.SE são marcadas por pacotes usados ​​para que você possa navegar e pesquisar muitos exemplos. As páginas no TeX.SE são altamente encontráveis. Normalmente eu apenas procuro no Google "látex (coisa que eu quero fazer)" e o resultado principal geralmente é uma página deste site. E se você não encontrar o que deseja, pergunte!

Responder2

Sinto muito, mas acho que você está sendo muito ambicioso em seu pedido. Contudo os autores doCompanheiro LaTeXSeries (Companheiro LaTeX,Companheiro de gráficos LaTeXeCompanheiro LaTeX Web, todos publicados por Addison Wesley) percorreram um longo caminho para atender ao seu pedido. Quanto a pacotes/classes individuais, cabe aos desenvolvedores/autores fornecer a documentação que consideram importante. Acho que na maioria dos casos eles, e certamente eu, presumimos que os leitores teriam um certo conhecimento de LaTeX e não teriam que repetir nenhum elemento básico.

Fui o desenvolvedor original da memoirclasse ( > texdoc memoir) para ler o manual que consiste em cerca de 540 páginas. Incluído neles está um índice de 40 páginas de todas as macros da classe, todas descritas em maior ou menor grau no corpo do manual. São dados exemplos dos resultados do uso dos principais. Estimo que exemplos de cada uso de cada macro da classe triplicariam o tamanho do manual. Quem leria isso? E eu certamente não escreveria isso.

Como você tem uma ideia do que deseja ver, você estaria disposto a escrever uma documentação de nível amador dos pacotes que você entendeu e enviá-los ao CTAN para distribuição geral?

GOM

informação relacionada