Tutorialschreiber-Checkliste

Ich hab kurzerhand mal mein [post="tutorials-schreiben" text="Tutorials-Tutorial"] ein bisschen erweitert. Die größte Veränderung ist eine Checkliste am Ende, die nochmal das Wichtigste zusammenfasst.

Tutorials schreiben

Download: Tutorials schreiben (Größe: 257.41 KB; bisher 315 mal heruntergeladen)

Überblick

Es ist jetzt mittlerweile fast drei Jahre her, dass ich angefangen habe, Tutorials zu schreiben. Seit dem habe ich einiges gelernt. Insbesondere auch dadurch, dass ich mittlerweile fast schon regelmäßig fremde Tutorials korrekturlese. Dabei sind mir einige Dinge aufgefallen, die ich nun hier zusammenfassen möchte. Auch wenn ich meine eigenen bisherigen Tutorials wieder lese, so fällt mir einiges auf, das ich mittlerweile anders machen würde und bei so mancher Formulierung muss ich heute über meine damaligen Texte schmunzeln. Wer Lust hat, kann ja mal nach der Lektüre dieses Tutorials meine bisherigen Texte nach Fehlern und Verbesserungsmöglichkeiten durchsuchen. Es finden sich da so einige…

Ich kann nicht behaupten, dass ich eine besondere Qualifikation für so ein Tutorial vorweisen kann. Ich habe weder etwas dahingehendes studiert, noch Sekundärliteratur zum Thema gelesen. Das, was ich hier beschreibe, stützt sich ausschließlich auf meine “Erfahrungen” mit eigenen und fremden Tutorials und ich denke, ich hätte den ein oder anderen Fehler nicht begangen, wenn mir jemand gesagt hatte, was man besser nicht macht. Nichtsdestotrotz bleibt es natürlich jedem selbst überlassen, was er von meinen Tipps hält. Kommentare jeglicher Art sind herzlich willkommen.

Dieses Tutorial richtet sich somit an alle, die gerne selbst mal ein Tutorial schreiben möchten. Hauptsächlich geht es hier um Programmier-Tutorials, jedoch gilt vieles von dem hier vorgestellten für jegliche Art Tutorial.
weiter lesen »

Nun, dann eben doch ein Blog…

Eigentlich wollte ich ja gar keinen Blog. Es interessiert niemanden, welche Schuhgröße ich hab oder wie groß die Kartoffeln im Garten sind. Außerdem habe ich den Eindruck, dass Blogs tendentiell unübersichtlich sind. Die interessaten Artikel findet man einfach nicht so schnell wie bei gut aufgeräumten “normalen” Websites. Und nun… joa… ist hier trotzdem n Blog. Das hat mehrere Gründe:

Ich hab bisher ja hauptsächlich Tutorials und Artikel von ähnlichem Umfang veröffentlicht. Daneben natürlich noch diverse Forenposts. Es gibt vieles über das ich eigentlich noch Tutorials schreiben wollte. Nun sind Tutorials aber sehr aufwändig zu schreiben. Insbesondere, wenn man dabei so perfektionistisch ist, wie ich und so sitze ich an einem Tutorial mehrere Wochen bis ich damit fertig und zufrieden bin. Zudem eignen sich manche Themen beispielsweise aufgrund des begrenzten Umfangs nicht für ein Tutorial. Auf der anderen Seite geht viel Interessantes wohl in den Forenposts unter. Manche finde ich selbst nicht mehr wieder bzw. muss ne Weile suchen, bis ich einen bestimmten Post gefunden habe. Bei diesem Blog hab ich die Hoffnung, gewissermaßen meine eigenen Perfektionismus etwas austricksen zu können.

Das heißt jetzt natürlich nicht, dass es die Tutorials gar nicht mehr geben wird. Nur, wird es zusätzlich ein paar Blogposts geben, in denen ich all das ansprechen werde, was aus diversen Gründen nicht seinen Weg in ein Tutorial findet.

ISAAC ist ein weiterer Grund, warum hier mittlerweile ein Blog ist. Ich hatte ja eigentlich vor, ein eigenes kleines CMS unter dem Namen ISAAC zu entwickeln. Das ist auch schon relativ weit fortgeschritten gewesen, lag jedoch teilweise aus Zeitgründen auf Eis. Joa… und mittlerweile – so wie das eben ist – hab ich wieder ne ganze Menge gelernt, sodass ich mit meinem damaligen Entwurf nicht mehr ganz so zufrieden bin. Und hier kommt dann mal wieder mein Perfektionismus in Spiel. Ich bin damit nicht mehr so zufrieden, also werde ich das Ganze umschreiben und verbessern. Nur braucht das alles wieder Zeit und da ich mit meiner bisherigen Website technisch noch weniger zufrieden war, musst zumindest mal eine Übergangslösung her. ISAAC wird weiter trotzdem entwickelt und vielleicht auch den Blog hier wieder ersetzen. Das ist aber noch nicht sicher, wird ne Zeit lang dauern und auch nur dann passieren, wenn ISAAC entsprechend weit entwickelt ist. Zumindest mittelfristig bleibt also erstmal der Blog.

Zum Einsatz kommt WordPress mit ein paar Plugins. Als Theme kommt eine leicht modifizierte Version des Themes “MagicBlue” zum Einsatz. 100% zufrieden bin ich mit WordPress nicht (aber zumindest zu 95%). Insbesondere fehlt mir die Abstraktion bei der Syntax. WYSIWYG kann ich eh nicht leiden, aber das kann man zum Glück abschalten. Die “manuelle” Eingabe ist aber stark HTML-lastig. Eine eindeutige Abstraktion wie BB-Code bei diversen Foren-Systemen fehlt leider. Ebenso ist es mit der Validität etwas schwieriger, da ich nicht mehr so viel Kontrolle über den HTML-Output habe. Hinweise auf Validitätsfehler willkommen. Im Allgemeinen ist dieser leider etwas unübersichtlicher, als bisher, aber man kann halt nicht alles haben. Im Allgemeinen bin ich von WordPress aber eher positiv überrascht.

BTW: Wer sich fragt, wo ich die Blog-Buttons da am rechten rand hab, dem kann geholfen werden: Die sind von microbuttons.wordpress.com

Im Zuge der Umstellung, hat sich auch inhaltlich ein bisschen was geändert. So sind manche Programme und Codes verschwunden, mit denen ich nicht mehr zufrieden war bzw. bin. Vielleicht mach ich mal n Gruselkabinett auf und stell das ein oder andere da wieder rein. Nichts ist so schlecht um nicht zumindest als Nagativbeispiel herhalten zu können.

Um die Übersicht etwas zu wahren, habe ich versucht Kategorien und Tags möglichst gut einzusetzen und hab außerdem eine separate Übersichtsseite erstellt. Ich hoffe mal, dass man sich damit etwas weniger verläuft.

Nun gut. Stellen wir fest: Das ist ein Blog. Viel Spaß beim Lesen und Kommentieren.

Nichts rührt sich…

Ziemlich still geworden, nicht? Seit Mitte Oktober bin ich wieder voll im Semetser. Eigentlich wollte ich in den Semesterferien ja wenigstens ne Alpha-Version von ISAAC fertig haben und außerdem noch zwei Tutorials schreiben. Eigentlich. Will heißen: Ich habs nicht ganz geschafft. ISAAC is immer noch Pre-Alpha und ich hab nur n dreiviertelses Tutorial.

Hier also der kurze Hinweis: Nichts ist vergessen, aber da die Uni momentan doch recht viel Arbeit macht, liegt vorerst so einiges auf Eis. Vielleicht kann ich in den Weihnachtsferien wieder was machen. Mal sehen. Momentan is aber die Uni eindeutig wichtiger, als ISAAC, Tutorials und alles andere, was ich mir für meine Freizeit vorgenommen hab…

ISAAC macht Pause

Da ich momentan von der Uni her recht viel zu tun habe, muss ISAAC erstmal hinten anstehen. In den Semesterferien(==> August) gehts weiter…

weiter mit ISAAC

Die Semesterferien haben angefangen und jetzt kanns auch so langsam mit ISAAC weiter gehen. Ich habe im vergangenen Semester einiges gelernt (ja das kommt vor ), was Auswirkungen auf ISAAC haben wird. Zumindest werde ich manches nochmal überdenken und ggf. nochmals umplanen. Jedenfalls gehts jetzt weiter…

Parallel dazu werde ich wohl noch ein paar Tutorials schreiben. Langweilig wird mir also nicht…

Delphi-Tage 2008 in Günzburg

Die diesjährigen Delphi-Tage – das Community-Treffen im Delphi-Bereich – das von den drei großen Delphi-Foren(Delphi-Treff, Delphi-PRAXiS und Entwickler-Ecke) zusammen mit Borland bzw. CodeGear verarstaltet wird. Als Moderator im Delphi-Treff gehöre ich gewissermaßen mit zu den Veranstaltern und habe demach auch vor zu kommen. Wer sich über die Veranstaltung informieren will, schaut am besten auf der Website der Delphi-Tage vorbei: http://www.delphi-tage.de

ISAAC

So… so langsam schreitet die Entwicklung voran und so kann ich auch noch ein bisschen über ISAAC berichten. Ja ISAAC – ISAAC is simple and almost a CMS – wird das Ganze wohl letztendlich heißen. Große Teile stehen schon. Bis zu einem ersten Release wird es wohl aber noch etwas dauern. Folgendes kann ich aber schonmal verraten:
weiter lesen »

Statusbericht… ;-)

Schon eine ganze Weile ist es hier wieder ruhig und still. Der letzte News-Eintrag liegt schon wieder über drei Monate zurück und so will ich wenigstens mal kurz andeuten, dass ich mal wieder an etwas Größeren herumschreibe.

Die ganze Website hier bedarf dringender Überholung: Inhaltlich und technisch; und und auch das Design ist wohl nicht gerade vom Hocker reißend. Insbesondere erinnert die große R2-Grafik auf der Startseite wohl eher an den örtlichen StarWars-Fanclub als an die Website eines Informatik-Studenten…

Deshalb bastele ich schon seit einiger Zeit an einer Art “Mini-CMS”. Letztendlich soll die bisherige Frickellösung etwas Solidem weichen. Einige hundert Codezeilen sind schon geschrieben, aber es wird wohl noch einige Zeit dauern, bis das alles fertig wird.

Das Forum wird wohl erstmal mehr oder weniger ersatzlos gestrichen. Mittelfristig soll wohl eine Web 2.0-mäßige Kommentarfunktion an dessen Stelle treten. Ein Blog wird wohl trotzdem nicht draus werden.

Vielleicht werde ich in nächster Zeit geauere Infos darüber liefern, was ich mir vorstelle. Mal sehen…

neue Website ist online

Ab sofort ist die neue auf PHP basierte Website online.

War ne menge Arbeit, aber jetzt ist es endlich geschfft. Das Design wurde vollständig überarbeitet, ebenso der Inhalt. Wurden bisher ausschließlich UniversalEditor und LernIt vorgestellt, so finden sich nun auch meine anderen Programme, sowie einige Codeschnipsel hier. Auch meine Facharbeit, die ich Anfang 2006 geschrieben habe, hat hier nun ihren Platz gefunden.

Im neu eingerichteten Forum gibts nun auch Support für meine Programme.

Auch technisch hat sich einiges geändert: neben der Umstellung auf PHP, sind nun alle Seiten(bis auf das Forum) Valid XHTML 1.1.

So wünsche ich noch viel Spaß bein Durchstöbern meiner Website…