Software zum Formatieren / Veröffentlichen von Tutorials, technische Artikel

448
gojira

Ich möchte einige meiner eigenen technischen Texte im Web veröffentlichen: Tutorials, Anleitungen, konzeptionelle Artikel zum Programmieren usw. Ich schreibe meistens für mich selbst, aber ich denke, andere können davon profitieren, also möchte ich es online stellen, und ich Ich habe auch Pläne, alles kohärenter zu gestalten und in ein Buch zu verwandeln.

Meine Artikel sind nicht als Blog gedacht, sondern lediglich als eine Sammlung von Tutorials und Anleitungen. Ich denke jedoch, dass eine Blogsoftware wahrscheinlich die am besten geeignete Art ist, diese Art von Format zu formatieren.

Im Moment verwende ich die Blog-Funktion von cite u like, die sehr wenig technisch ist und wirklich etwas Besseres brauche. Auf meiner Wunschliste steht unter anderem:

  • Codeausschnitte in scrollbaren Boxen
  • Syntaxhervorhebung für Quellcodeausschnitte
  • Artikel mit grafischen Symbolen nach Themen kennzeichnen, wie in slashdot
  • Natürlich sollten Benutzer (dh Leser) Artikel kommentieren können
  • Auch mehr Optionen als ein sehr einfacher Blog
  • sollte glatt aussehen! sollte nicht wie Wikipedia aussehen

Gibt es eine Software, die Sie für diesen Zweck empfehlen können?

0
Würdest du es selbst hosten? Daniel Andersson vor 12 Jahren 0
@ Daniel Andersson: Ja. Ich möchte keine "Software als Dienstleistung" oder etwas, über das ich keine vollständige Kontrolle habe. Am besten wäre es Open Source. gojira vor 12 Jahren 0

3 Antworten auf die Frage

1
Daniel Andersson

Es ist nicht die beliebteste Wahl, aber ich mag ikiwiki (von Joey Hess von Debian). Es ist ein in Perl geschriebenes System, das Markdown- Seiten standardmäßig in statische HTML-Dateien kompiliert . Seine "Blog" -Vorlagen funktionieren für das, was Sie tun möchten.

In erster Linie ist dieses System sehr flexibel und in der Lage, alles zu tun, was man von seinem Design her wünscht. Mit Basis-Perl können Sie auch benutzerdefinierte Plugins mit Leichtigkeit und Zeit erstellen.

Das gesamte System basiert auf Versionskontrollsystemen, z. B. Git. Die Site wird neu erstellt (na ja, relevante Teile), wenn Inhalte festgelegt werden, wodurch die Versionskontrolle als integrierte Funktion bereitgestellt wird.

Sie erhalten ein Kommentarsystem, das OpenID zur Identifikation verwendet. Sie können den Code leicht mit der Quellhervorhebung inline einbetten, indem Sie (vorzugsweise) die Perl-Bibliothek zur Hervorhebung verwenden . Code wird in scrollbaren Kästchen abgelegt und kann auch gefaltet werden (ich verwende diese Funktion).

In seiner Standardkonfiguration sieht es meiner Meinung nach nicht besonders gut aus, aber jeder Aspekt ist mit einer lokalen CSS-Datei ansprechbar.

Zumindest bin ich sehr zufrieden damit. Dass es eng mit Git / Mercurial / was auch immer ist eine Killer-Funktion für mich ist, und da jeder Aspekt der Website selbst durch Vorlagen geändert werden kann, ist es mehr oder weniger unendlich flexibel.

1
Samuel

Sie können Octopress in Betracht ziehen, das Syntaxhervorhebung und Codeblöcke mit Markdown enthält. Es hat Tagging und Kommentare über Disqus mit etwas Konfiguration.

Dies wäre ein sehr einfaches Blog - wenn Sie mehr Funktionen wünschen, ist WordPress eine Option.

-1
ℝaphink

Wie wäre es beispielsweise mit http://sphinx.pocoo.org/ für technische Online-Dokumentation ?