¿Qué es un buen software wiki para programar tutoriales? [cerrado]

Question

He notado que hay muy pocos tutoriales de programación en mi idioma nativo (letón). Y uno de los mejores parece haberse desconectado permanentemente recientemente. Como tal, estoy cada vez más inclinado a comenzar a escribir mi propio tutorial de programación.

Como no soy escritor y el tiempo libre es escaso, pensé en hacer de esto un wiki. De esta manera, otros entusiastas interesados ??(ya conozco algunos) también podrían unirse fácilmente.

La pregunta es: ¿qué software wiki es el más adecuado para tal tarea? Tengo algunas características clave en mente que sería bueno tener, las enumeraré aquí:

• Soporte completo de Unicode, ya que el letón tiene algunos caracteres no estándar;
• Control de revisión;
• Control de acceso (con acceso anónimo admitido);
• Código de color de sintaxis, preferiblemente extensible para que se puedan hacer tutoriales para diferentes lenguajes de programación;
• La generación automática de TOC desde todas las páginas sería buena (pero también se puede hacer a mano);
• El soporte para diagramas y fórmulas matemáticas sería bueno (pero también se puede hacer con la carga de imágenes);
• La capacidad de proporcionar un "imprimible" La versión para páginas sería buena, sin mencionar la posibilidad de compilar todo en un libro electrónico descargable.

El servidor que tengo tiene Linux, por lo que preferiblemente no tiene ASP / ASP.NET, pero eso también se puede organizar si es realmente necesario.

Agregado: Bueno, parece que en realidad solo hay dos buenos candidatos: DokuWiki y MediaWiki. Ambos tienen la gran característica de tener una localización letona. Optaría por MediaWiki, ya que parece tener al menos una ventaja importante: el control de versiones de los archivos adjuntos. (Además, sin duda, el sistema wiki mejor probado del mundo). Sin embargo, me temo que no es demasiado excesivo para un proyecto tan pequeño. ¿Algún comentario sobre esto?

Answer 1

El rey kong del software wiki es MediaWiki . Admite todas las funciones que especifique, incluidas:

• Unicode (Mediawiki es utilizado por Wikipedia, en cientos de países e idiomas diferentes)
• Control de revisión (incluyendo retroceso, diferencias de visualización entre revisiones, etc.)
• Control de acceso (diferentes niveles de usuario, lectura / escritura anónima, etc.)
• Resaltado de sintaxis a través de una extensión
• Generación de TOC si tiene más de 3 encabezados en su página
• Diagramas y fórmulas a través de marcado LaTex
• Imprimir estilo CSS, opción de imprimir página

Además, el software se ejecuta en Linux a través de Wikipedia, creo, por lo que se ha probado completamente en la plataforma Linux. No es demasiado difícil de instalar, pero quizás tenga el riesgo de tener demasiadas características.

Answer 2

DokuWiki cumple con muchos de sus requisitos.

• Unicode
• Historial de revisiones
• acceso anónimo y autenticado
• Resaltado de sintaxis para muchos idiomas, a través de Geshi
• TOC automático
• diagramas y fórmulas (a través de complementos)
• PHP, por lo que se ejecuta en cualquier lugar

Originalmente fue pensado como un wiki de documentación de código. No estoy seguro de compilar automáticamente todo en un libro electrónico. Sin embargo, los complementos son bastante fáciles de escribir.

EDITAR: existen complementos para generar PDF y otros formatos de documentos desde sus páginas, por lo que una posibilidad sería unir las cosas usando un rastreador web.

Answer 3

Suena como el trabajo ideal para Dokuwiki .

Actualización: si se pregunta a sí mismo (o a nosotros) si Mediawiki no es demasiado grande para su proyecto, tal vez debería simplemente considerar los otros factores involucrados.

• Dokuwiki debería ejecutarse en casi cualquier tipo de hardware. Raramente he visto una instalación que no se siente rápida y con buen rendimiento. Es difícil decir lo mismo sobre Mediawiki.
• Instalar Dokuwiki es muy sencillo. Debería estar funcionando en 30 minutos.
• Soporte. No tengo idea de cómo es esto con Mediawiki, pero las personas en la lista de correo de dokuwiki son muy útiles y amigables.

PD: ¿Soy parcial? ¡Tremendamente así!

Answer 4

MoinMoin es muy agradable y tiene capacidades de presentación de diapositivas.

Answer 5

Tengo buena experiencia con Wordpress pero necesita algunos complementos.

• Complemento de Google-Code para fragmentos de código atractivos
• plugin de cambio de idioma puede escribir en diferentes idiomas fácilmente con la especificación de etiquetas de idioma en su blog como [lang_en] idioma inglés aquí [/ lang_en] [lang_de] deutsche sprache hier [/ lang_de]
• control de revisión

Se compara con otros sistemas no muy difíciles de expandir o escribir algún complemento propio si necesita algo especial.

Answer 6

Gracias por hacer esto. Creo que necesitamos más recursos en otros idiomas además del inglés.

Sin embargo, mientras lo hace, también debe proporcionar enlaces a artículos escritos en inglés u otros idiomas, que expongan los artículos que está escribiendo en letón. De esa manera, sus lectores obtendrán todo el contenido disponible en letón, pero aún podrán localizar el contenido no letón que también está disponible.

Answer 7

Desafortunadamente, no creo que haya una Wiki que sea particularmente adecuada para artículos con mucho código fuente.

Sin embargo, es posible que desee dirigirse a la Wiki de programas literarios . Literate Programming es una excelente forma de enseñar programación, y Literate Programs Wiki combina el software MediaWiki Wiki con el sistema noweb Literate Programming.

Quizás puedas pedirles que te ayuden a configurar tu propia versión. O tal vez solo pueda usar su Wiki, después de todo, MediaWiki admite varios idiomas.

Answer 8

para Soporte de fórmulas matemáticas, MoinMoin hace latex (el sitio se ejecuta moinmoin con un tema personalizado).

Answer 9

¿Algún comentario para TWiki ? Dokuwiki parece simple y fácil de usar, mientras que Twiki obtiene un alto rango en el motor de búsqueda y las apariencias tienen más funciones, en Además, ¡La confluencia mencionada anteriormente es realmente buena!

Answer 10

puedes usar zoho wiki. http://wiki.zoho.com

lo usamos para nuestros documentos de desarrollo interno. tiene todo lo que quieres https://zohowikihelp.wiki.zoho.com/