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

Question

Me he dado cuenta de que hay pocos tutoriales de programación en mi idioma nativo (Letón). Y uno de los mejores parece haber estado permanentemente fuera de línea 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 algo de wiki. De esta manera, otros entusiastas interesados ​​(ya sé 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, voy a enumerar aquí:

• Completo soporte Unicode, ya que Letonia tiene algunos caracteres no estándar en ella;
• Control de revisión;
• Control de acceso (con acceso anónimo compatible);
• Color de sintaxis de código, preferiblemente extensible para que se puedan hacer tutoriales para diferentes lenguajes de programación;
• La generación automática de TOC de todas las páginas sería agradable (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 cargas de imágenes);
• La capacidad de proporcionar una versión "imprimible" para páginas sería agradable, 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 se puede organizar también 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 ya una localización en Letonia. Me decantarí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 si no es un poco demasiado funcional para un proyecto tan pequeño. ¿Algún comentario sobre esto?

Answer 1

El software king kong de wiki es MediaWiki. Es compatible con todas las características que especifique, entre ellos:

• Unicode (Mediawiki es utilizado por la Wikipedia, a través de cientos de diferentes países e idiomas)
• Control de revisión (incluyendo reversión, ver las diferencias entre las revisiones, etc.)
• de control de acceso (diferentes niveles de usuario, lectura anónima/escritura, etc.)
• el resaltado de sintaxis a través de una generación TOC extension
• si tiene más de 3 encabezados en su página
• diagramas y fórmulas a través de marcado LaTex
• impresión de estilos CSS, la opción de imprimir la página

Además el software que 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

Suena como el trabajo ideal para Dokuwiki.

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

• Dokuwiki debería ejecutarse en casi cualquier tipo de hardware. Rara vez he visto una instalación que no se sienta rápido y funcione bien. Es difícil decir lo mismo sobre Mediawiki.
• Instalar Dokuwiki es fácil. Deberías estar en funcionamiento en 30 minutos.
• Asistencia. No tengo idea de cómo es esto con Mediawiki, pero las personas en la lista de correo dokuwiki son muy serviciales y amigables.

PS: Me biased? ¡Tremendamente así!

Answer 3

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

Answer 4

DokuWiki cumple con muchos de sus requisitos.

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

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

EDITAR - hay complementos para generar PDF y otros formatos de documento de sus páginas, por lo que una posibilidad sería unir elementos mediante un rastreador web.

Answer 5

Tengo buena experiencia con Wordpress pero necesita algunos complementos.

• Google-Código plug-in para el código de aspecto agradable de fragmentos de conmutación
• lenguaje plugin que puede escribir en diferentes idiomas fácil con la especificación de las etiquetas de idioma en su blog como [lang_ES] idioma Inglés aquí [/ lang_ES] [lang_de] deutsche sprache hier [/ lang_de]
• control de revisión

Su comparación con otros sistemas no muy duros para expandir o escribir algo propio plug-in si necesitas algo de 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 se exponen en los artículos que está escribiendo en letón.De esta manera, sus lectores obtendrán todo el contenido disponible en letón, pero aún podrán encontrar el contenido no letón que también está disponible.

Answer 7

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

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

Answer 8

Lamentablemente, no creo que haya una Wiki especialmente adecuada para artículos pesados ​​en el código fuente.

Sin embargo, es posible que desee dirigirse al Literate Programs Wiki. La Programación alfabetizada es una forma muy útil de enseñar la programación , y la Wiki de Programas Literate combina el software Wiki de MediaWiki con el sistema de programación Literate noweb.

Quizás pueda pedirles que lo ayuden a configurar su propia versión. O tal vez solo puede usar su Wiki, después de todo, MediaWiki es compatible con varios idiomas.

Answer 9

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

Answer 10

Cualquier comentario a TWiki? Dokuwiki parece simple y fácil de usar, mientras que Twiki obtener un alto rango en el motor de búsqueda y se ve más característica, además, Confluence mencionado anteriormente es realmente bueno!