Tutorial/Manual completo para LaTeX/Paquetes con ejemplos explícitos y resultados mostrados en lugar de códigos puros como el centro de documentos de Mathematica.

Tutorial/Manual completo para LaTeX/Paquetes con ejemplos explícitos y resultados mostrados en lugar de códigos puros como el centro de documentos de Mathematica.

Quiero usar algunos paquetes en látex, luego encuentro el manual de ese paquete. Sin embargo, encuentro que todos estos manuales son puramente códigos y explicaciones sin ejemplos explícitos ni resultados mostrados. No soy un informático. Para mí es bastante aburrido e ineficaz leer todos los textos sin formato para entender cómo utilizar este paquete. ¿Existe algún lugar donde pueda encontrar el manual de cada paquete para aficionados como yo? Quiero que este manual/nota (ciertamente no necesariamente escrito por los autores de los paquetes) tenga las siguientes propiedades:

  1. No demasiado incompleto como simplemente elegir algunos ejemplos sencillos para presentar el marco. Quiero que sea completo y pueda contarme todos los detalles de cada función, método o parámetro en ese paquete.

  2. Lo más importante para mí es que cada función/método/parámetro debe tener ejemplos explícitos y resultados mostrados. Por lo tanto, puedo explorar rápidamente los resultados mostrados y, ajá, así es como quiero que se vea.

PD: Ciertamente entiendo que LaTeX no es un software pago. Los autores de los paquetes tienen derecho a escribir como quieran. Me pregunto si hay algunos buenos instructores que digieran el manual seco original y alimenten a los aficionados que no quieran simplemente arañar la superficie de una manera amigable. Un buen ejemplo de lo que quiero es comocentro de documentos de Wolfram Mathematica.

Respuesta1

No, un sitio así no existe y nadie lo creará solo porque el manual le resulta aburrido.

Mathematica es una aplicación propietaria y pueden controlar cómo se documentan sus paquetes. Python es de código abierto, pero tiene una fuerte ética comunitaria en la que casi todos están de acuerdo en que "debería haber una, y preferiblemente solo una, forma de hacerlo". Por eso una buena documentación es parte de la cultura. LaTeX no es ninguna de esas cosas.

Estoy de acuerdo con los comentaristas en que parte de la documentación del paquete es bastante buena. tikzy pgfplotsestán entre mis favoritos. Y la mayoría de la documentación no lo es.malo; Es posible que no explique en detalle todas las cosas posibles que desee hacer con él.

Pero si está buscando un amplio recurso de preguntas respondidas para varios casos de uso de LaTeX (y ConTeXt y TeX principal), es posible que ya lo haya encontrado. Las preguntas en TeX.SE están etiquetadas por paquetes utilizados para que pueda explorar y buscar muchos ejemplos. Las páginas en TeX.SE son fáciles de encontrar. Por lo general, simplemente busco en Google "látex (cosa que quiero hacer)" y el resultado principal suele ser una página de este sitio. Y si no encuentra lo que busca, ¡pregunte!

Respuesta2

Lo siento pero creo que estás siendo demasiado ambicioso en tu petición. Sin embargo los autores delCompañero de látexserie (Compañero de látex,Compañero de gráficos LaTeXyCompañero web de LaTeX, todos publicados por Addison Wesley) han contribuido en gran medida a satisfacer su solicitud. En cuanto a los paquetes/clases individuales, depende de los desarrolladores/autores proporcionar la documentación que consideren importante. Supongo que en la mayoría de los casos ellos, y ciertamente yo, asumimos que los lectores tendrían cierto conocimiento de LaTeX y no tendrían que repetir ningún elemento básico.

Fui el desarrollador original de la memoirclase ( > texdoc memoir) para leer el manual que consta de aproximadamente 540 páginas. En estos se incluye un índice de 40 páginas de todas las macros dentro de la clase, todas las cuales se describen en mayor o menor medida en el cuerpo del manual. Se dan ejemplos de los resultados del uso de los principales. Calculo que los ejemplos de cada uso de cada macro en la clase triplicarían el tamaño del manual. ¿Quién leería eso? Y ciertamente no lo escribiría.

Si tiene una idea de lo que quiere ver, ¿estaría dispuesto a escribir documentación de nivel amateur de los paquetes que ha llegado a comprender y enviarlos a CTAN para su distribución general?

GOM

información relacionada