Was ist eine gute Wiki-Software-Tutorials für die Programmierung? [geschlossen]

StackOverflow https://stackoverflow.com/questions/630184

  •  08-07-2019
  •  | 
  •  

Frage

Ich habe bemerkt, dass es awvully paar Programmierung Tutorials in meiner Muttersprache (Latvian) ist. Und eine der besten scheint permanent offline vor kurzem gegangen zu sein. Als solche bin ich immer mehr geneigt, meine eigene Programmierung Tutorial zu schreiben zu beginnen.

Da ich keinen Schriftsteller und Freizeit knapp ist, dachte ich, das zur Herstellung einer Wiki-Sache. Auf diese Weise andere interessierte Enthusiasten (ich schon ein paar kennen) könnte auch leicht mitmachen.

Die Frage ist - die Wiki-Software gibt für eine solche Aufgabe am besten geeignet ist Ich habe ein paar wichtige Funktionen daran, dass wäre schön zu haben, ich werde sie führen hier?:

  • Volle Unicode-Unterstützung, da lettische einige Nicht-Standard-Zeichen hat;
  • Revisionsverwaltung;
  • Zugangskontrolle (mit dem anonymen Zugriff unterstützt);
  • Code-Syntax-Einfärbung, vorzugsweise erweiterbar, so dass Tutorials für verschiedene Programmiersprachen können gemacht werden;
  • Automatische TOC Generation von allen Seiten wäre schön (kann aber von Hand zu erfolgen);
  • Unterstützung für Diagramme und mathematische Formeln wäre schön (kann aber auch mit Bild-Uploads erfolgen);
  • Die Fähigkeit, eine „Druckvorschau“ -Version für Seiten wäre schön zu schaffen, nicht eine Möglichkeit zu erwähnen, das Ganze in einem herunterladbaren E-Book zu erstellen.

Der Server, ich habe hat Linux drauf, also vorzugsweise keine ASP / ASP.NET - aber das kann auch angeordnet werden, wenn wirklich nötig

.

am: Nun, es scheint, dass es wirklich nur zwei gute Kandidaten sind - DokuWiki und MediaWiki. Beide haben die große Eigenschaft bereits eine lettische Lokalisierung haben. Ich würde für MediaWiki gehen, da es zumindest einen großen Vorteil zu haben scheint - Versionierung von Anlagen. (Plus-zweifellos das besten getestete Wiki-System in der Welt) aber ich habe Angst, wenn es nicht ein bisschen zu über Feature-ful für so ein kleines Projekt. Anmerkungen zu dieser?

War es hilfreich?

Lösung

Der King Kong von Wiki-Software ist MediaWiki . Es unterstützt alle Funktionen, die Sie angeben, einschließlich:

  • Unicode (Mediawiki von Wikipedia verwendet wird, über Hunderte von verschiedenen Ländern und Sprachen)
  • Revisionsverwaltung (einschließlich Rollbacks sehen Unterschiede zwischen den Versionen, usw.).
  • Zugangskontrolle (verschiedene Benutzerebenen, anonymen Lese- / Schreib-usw.)
  • Syntaxhervorhebung über eine Erweiterung
  • TOC Generation, wenn Sie mehr als 3 Überschriften in Ihrer Seite
  • Diagramme und Formeln über LaTeX Markup
  • Drucken CSS Stil, Seite drucken Option

Darüber hinaus wird die Software auf Linux über Wikipedia laufen wie ich glaube, so wurde es auf der Linux-Plattform vollständig getestet. Es ist nicht allzu schwierig zu installieren, aber vielleicht hat das Risiko von zu vielen Funktionen.

Andere Tipps

DokuWiki erfüllt viele Ihrer Anforderungen.

  • Unicode
  • Revision History
  • anonymer und authentifizierten Zugriff
  • Syntaxhervorhebung für viele Sprachen, über Geshi
  • automatische TOC
  • Diagramme und Formeln (via Plugins)
  • PHP, so läuft es überall

Es wurde ursprünglich als ein Code-Dokumentations-Wiki soll. Ich bin mir nicht sicher automatisch die ganze Sache in ein E-Book zu kompilieren. Allerdings Plugins sind ziemlich einfach zu schreiben.

EDIT - es gibt Plugins für PDF und andere Dokumentformate von Ihren Seiten zu erzeugen, so eine Möglichkeit zu Stück Dinge sein würde zusammen einen Web-Crawler mit

.

Klingt wie der ideale Job für Dokuwiki .

Update: Wenn Sie sich fragen (oder uns), ob Mediawiki für Ihr Projekt nicht ein bisschen zu groß, vielleicht sollten Sie einfach die anderen Faktoren berücksichtigen, beteiligt.

  • Dokuwiki sollte fast jede Art von Hardware laufen. Ich habe selten eine Installation zu sehen, dass nicht schnell fühlen und gut durchführen. Es ist schwer, das gleiche über Mediawiki zu sagen.
  • Dokuwiki Installation ist ein Kinderspiel. Sie sollten und läuft innerhalb von 30 Minuten.
  • Unterstützung. Ich habe keine Ahnung, wie das mit Mediawiki ist, aber die Leute auf der dokuwiki Mailing-Liste sind sehr hilfsbereit und freundlich.

PS: Me voreingenommen? Ungemein so!

Moinmoin so schön und hat Dia-Show-Funktionen.

Ich habe gute Erfahrungen mit Wordpress, aber es braucht einige Plugins.

  • Google-Kodex-Plugin für gut aussehenden Code-Schnipsel
  • Sprachumschalter Plugin Sie in verschiedenen Sprachen leicht mit Angabe Sprach-Tags in Ihrem Blog wie [lang_en] Englisch Sprache hier schreiben kann [/ lang_en] [lang_de] englische Sprache hier [/ lang_de]
  • Revisionskontrolle

Die im Vergleich zu anderen Systemen nicht sehr schwer zu erweitern oder ein eigenes Plugin zu schreiben, wenn Sie einige spezielle benötigen.

Danke, dies zu tun. Ich glaube, dass wir mehr Ressourcen in anderen Sprachen als Englisch benötigen.

Doch während Sie gerade dabei sind, sollten Sie auch in Englisch oder anderen Sprachen geschrieben Links zu Artikeln bereitzustellen, die in lettischer Sprache Sie schreiben auf den Artikel auslegen. Auf diese Weise Ihre Leser werden alle verfügbaren Inhalte in lettischer Sprache, aber noch in der Lage sein, der nicht-lettischen Inhalte zu finden, die auch verfügbar ist.

Leider glaube ich nicht, dass es ein Wiki, das für Quelltext-schwere Gegenstände besonders gut geeignet ist.

Allerdings möchten Sie vielleicht auf die Literate Programme Wiki Kopf auf mehr als. Literate Programming ist eine groß Art des Unterrichtens Programmierung und die Literate Programme Wiki kombiniert die MediaWiki Wiki-Software mit dem noweb Literate Programming System.

Vielleicht können Sie sie bitten, Ihnen Ihre eigene Version einrichten zu können. Oder vielleicht können Sie nur nutzen, um ihre Wiki, nachdem alle, MediaWiki mehrere Sprachen unterstützt.

für Unterstützung von mathematischen Formeln, Moinmoin Latex tut (die Website läuft Moinmoin mit einem persönlichen Thema).

Jede Kommentare zu TWiki ? Dokuwiki sieht einfach und leicht zu bedienen, während Twiki einen hohen Rang in der Suchmaschine erhalten und sieht mehr Funktion hat, in Außerdem Confluence oben erwähnt ist wirklich gut!

Sie können zoho Wiki verwenden. http://wiki.zoho.com

wir es für unsere internen Entwicklungsdokumente verwenden. es hat alles, was Sie für wollen. https://zohowikihelp.wiki.zoho.com/

Lizenziert unter: CC-BY-SA mit Zuschreibung
Nicht verbunden mit StackOverflow
scroll top