[Umfrage] Format für Tutorials

[Luckie]

Bisher habe ich meine Tutorials immer im PDF Format veröffentlicht. Zum einen, weil es sehr weit verbreitet ist und zum anderen weil man PDFs relativ einfach mit OpenOffice erzeugen kann. Jetzt habe ich aber auch mal ein Tutorial als HTML Datei veröffentlicht. Weil ich dachte, dass es nicht so umfangreich wird und ein PDF etwas overkill wäre. Der Vorteil ist natürlich, dass man es mal eben online angucken kann und man mehr oder weniger gut darin navigieren kann, was bei den von OpenOffice erzeugten PDFs leider noch nicht möglich ist. Nur leider ist das mit dem Ausdrucken von HTML Dateien immer so eine Sache. Einmal ausgedruckt ist die Navigation flöten und ein Inhaltsverzeichnis mit Seitenangeben macht keinen Sinn. Zum offline lesen ausgedruckt, ist da wiederum eine PDF Datei im Vorteil.

Also was meint ihr: Wie hättet ihr gerne eure Tutorials?

[Delphi_Fanatic]

ich bevorzuge HTML

Hat zwar den Nachteil, dass die Ausdrucke etwas unvorteilhaft sind... aber was soll's...
ich bin ohnehin gegen diesen ganzen Papierkram und beware ungern irgendwelche Ausdrucke auf wenn
man das ganze doch auch in elektronischer Form speichern kann.

pdf ist mir persönlich zu schwer fällig, beim ersten Aufruf braucht der Reader selbst bei
schnellen, modernen Kisten endlos lange, bis er alle Initialisierungen durchgeführt und dll's geladen
und sonst was erledigt hat...
Text-Suche (nach bestimmten Stichworten) ist in HTML-Dokumenten einfacher und schneller als bei pdfs.

Und die wirklich interessanten Sachen kann man sich ja auch abspeichern (IE Datei / Speichern unter), so
dass man auch HTML-Sachen offline lesen kann.
Wobei diese Sache mit dem offline lesen seit dem Aufkommen von Flatrates auch nicht mehr wirklich das
schlagende Argument ist.

[alcaeus]

Hallo Luckie,

primär würde ich HTML sagen, nachdem ich einer dieser verwöhnten Flatrate-User bin. Allerdings finde ich auch CHMs sehr fein, und wie bereits von dir erwähnt ein PDF zum Speichern auf der Festplatte bzw. Ausdrucken. Mir passiert es immer wieder dass ich mit dem Laptop unterwegs bin und eine Seite nicht offline angezeigt werden kann. Allerdings könntest du ja 2 Stylesheets machen: eines welches Formatierungen usw. beinhaltet, für die normale Ansicht, und eines ohne viel Schnickschnack für eine druckerfreundliche Ansicht. Wer will kann sich immer noch die druckerfreundliche Ansicht auf einem PDF-Drucker als PDF erzeugen lassen.
Ich hab mir jetzt aber mal dein HTML-Tutorial angesehn, und muss sagen dass es eigentlich sehr druckerfreundlich ist (keine Frames, nicht viele Grafiken, nicht zu viele Farben, usw.) Die Hyperlinks stören aber auf Papier, aber das ist eine allgemeine Sache.
Und um zum Punkt zu kommen: primär HTML, evtl. CHM. Ums PDF soll sich jeder selbst kümmern (evtl. findet sich auch jemand der das HTML-Tut in ein schönes PDF umwandelt und es dir dann zukommen lässt ;))

Zitat:

Wobei diese Sache mit dem offline lesen seit dem Aufkommen von Flatrates auch nicht mehr wirklich das
schlagende Argument ist.

Sag mir das sobald ich mit meinem Laptop im Zug unterwegs bin ;)

Greetz
alcaeus

[opfer.der.genauigkeit]

Zitat:

Zitat von Luckie

Also was meint ihr: Wie hättet ihr gerne eure Tutorials?

Mit nem guten Glas Wein und ner Zigarette. :stupid:

Du könntest prinzipiell ja auch ein Zwischenformat nehmen, aus dem du dann beides generieren kannst.
IMHO ist das problemlos mit Latex möglich.

Ansonsten find ich PDF irgendwie übersichtlicher aber frag mich nicht warum.

[Jasocul]

Meine "Tutorials" sind im HTML-Format.
Meine Doku zu den Downloads ist im PDF-Format. Die Historie im TXT-Format.

[Kedariodakon]

Also ich finde PDF's am besten, eine datei und gut ist...

Bei HMTL muß man wieder zipen oder ähnliches...
Und wenn man smal drucken will, brauch man ewig und der DAU wird das nich mal schaffen, außer DU denkst mit :zwinker:


Bye

[alcaeus]

Zitat:

Zitat von Kedariodakon

Bei HMTL muß man wieder zipen oder ähnliches...

HTML...zippen? Wie das denn? Dann kann man sich HTML ja gleich sparen. Der Vorteil von HTML ist ja dass es ohne größeren Aufwand angezeigt werden kann (z.B. hasse ich es wenn mein Acrobat Writer 6 auf dem Centrino mit 600 MHz [Stromsparmodus] startet, der wird nicht mehr fertig :roll:)

Greetz
alcaeus

[Steve]

Hi,

ich kann da nicht wirklich abstimmen, weil ich sowohl PDF als auch HTML "bevorzuge" - je nach Situation.
Wenn ich nur fix was nachschlagen will und Querverweise etc. vorhanden/benötigt/sionnvoll sind, empfiehlt sich HTML.
Handelt es sich um ein längeres Tutorial, das ich Schritt für Schritt durcharbeiten möchte/muss/soll, ist mir PDF lieber - einmal ausgedruckt und schon hab ich was Handfestes. (Ist auch gesünder für die Augen :stupid: )

Imho gibt's kein generelles besser/schlechter. Würde also auch ein Zwischenformat empfehlen, um sowohl PDF, HTML, CHM etc. erstellen zu können. Dürfte kein allzu großer Aufwand sein und alle sind glücklich bis an ihr Lebensende... oder so... :stupid:


Gruß
Stephan :dance:

[Kedariodakon]

Zitat:

Zitat von alcaeus

Zitat:

Zitat von Kedariodakon

Bei HMTL muß man wieder zipen oder ähnliches...

HTML...zippen? Wie das denn? Dann kann man sich HTML ja gleich sparen. Der Vorteil von HTML ist ja dass es ohne größeren Aufwand angezeigt werden kann (z.B. hasse ich es wenn mein Acrobat Writer 6 auf dem Centrino mit 600 MHz [Stromsparmodus] startet, der wird nicht mehr fertig :roll:)

Greetz
alcaeus

Naja irgendwie will ich sie herrunterladen und speichern, um z.B. damit auch ohne I-Net arbeiten zu können...
Und zum lesen brauch man IMHO nur den Reader, oder schießt du auch mit Kanonen auf Spatzen? :zwinker:
Naja und einfach anzeigen... immerhin brauch man dafür einen Browser :thumb:

BYe

[alcaeus]

Zitat:

Zitat von Kedariodakon

Naja irgendwie will ich sie herrunterladen und speichern, um z.B. damit auch ohne I-Net arbeiten zu können...

Deshalb ja mein Vorschlag dass du das Ding durch den PDF-Drucker schickst.

Zitat:

Und zum lesen brauch man IMHO nur den Reader, oder schießt du auch mit Kanonen auf Spatzen? :zwinker:

Ja, mach ich eigentlich recht gern :mrgreen: Im Ernst, ich weiß nicht warum ich zusätzlich zum Writer (brauche ich relativ oft) auch noch den Reader installieren soll :gruebel:

Zitat:

Naja und einfach anzeigen... immerhin brauch man dafür einen Browser :thumb:

IE ist doch bei Windows dabei :zwinker: :mrgreen: Und außerdem, wie willst du denn das PDF ohne Browser runterladen? :roll:

Die Diskussion wird aber OT, Luckie soll am Ende für sich selbst entscheiden, welche Formate er zur Verfügung stellt...

Greetz
alcaeus

[Kedariodakon]

Zitat:

Zitat von alcaeus

Deshalb ja mein Vorschlag dass du das Ding durch den PDF-Drucker schickst.

Also HTML-Seiten Drucken kann man vergessen, wenn der ersteller es nicht darauf ausgelegt hat...

Zitat:

Zitat von alcaeus

Ja, mach ich eigentlich recht gern :mrgreen: Im Ernst, ich weiß nicht warum ich zusätzlich zum Writer (brauche ich relativ oft) auch noch den Reader installieren soll :gruebel:

Damit man sich PDF's schnell anschauen kann :zwinker:

Zitat:

Zitat von alcaeus

IE ist doch bei Windows dabei :zwinker: :mrgreen: Und außerdem, wie willst du denn das PDF ohne Browser runterladen? :roll:

hmm Luckie bringt sie mir auf Diskette :gruebel:


Also ich gebe mich zufrieden wenn es ein PDF gibt, die anderen könen ja HTML lesen wenn sie wollen :duck:

Bye

[alcaeus]

Zitat:

Zitat von Kedariodakon

Zitat:

Zitat von alcaeus

Deshalb ja mein Vorschlag dass du das Ding durch den PDF-Drucker schickst.

Also HTML-Seiten Drucken kann man vergessen, wenn der ersteller es nicht darauf ausgelegt hat...

Zitat:

Zitat von alcaeus

Allerdings könntest du ja 2 Stylesheets machen: eines welches Formatierungen usw. beinhaltet, für die normale Ansicht, und eines ohne viel Schnickschnack für eine druckerfreundliche Ansicht. Wer will kann sich immer noch die druckerfreundliche Ansicht auf einem PDF-Drucker als PDF erzeugen lassen.

No comment. ;)

Und jetzt Luckie zuliebe wieder OT (On-Topic) ;)

Greetz
alcaeus

[r_kerber]

Also ich bevorzuge hier eindeutig PDF.

Zum Thema Starten von Acrobat: Schon mal etwas von Acrobat Reader Speedup gehört?http://www.tnk-bootblock.co.uk/prods/misc/

[Treffnix]

Prinzipiell finde ich PDF schöner. Allerdings geht mir auch diese ewige Initialisierung vom Acrobat Reader auf die Nerven. Wenn das Tut >10 Seiten hat und ich mir die komplett durchlesen will, ist das vertretbar, aber wenn ich beispielsweise nur eben was nachschlagen will macht mich das wahnsinnig.

[MathiasSimmack]

Das kommt ganz einfach auf den Anwendungszweck an. Einige meiner Dokumentationen sind ja PDFs. Dagegen bietet bzw. bot es sich bei den API-Tutorials von Luckie geradezu an, die auch als Hilfedatei (für Delphi 2005 auch im neuen Format) zu machen, weil man sie dann vor Ort hat und beim Programmieren gleich mal nachschlagen kann.


Warum mache ich mir z.B. zurzeit die Mühe und programmiere das Help 2.0 für SharpDevelop? Wg. der Anerkennung? Nein! Weil ich faul bin und beim Programmieren im Inhaltsverzeichnis bzw. im Index blättern will, wenn ich was suche, und weil ich dann die SharpDevelop-UI nicht mehr verlassen muss. :stupid:

[Sharky]

Ich mag auch am liebsten PDFs.
Wenn es vertretbar ist kann man sich ja auch für 40 USD einen Koverter von Pdf2Html kaufen.

[Robert_G]

HxS! :firejump:
die kann ich mir einfach in die Doku irgendeiner modernen IDE einklinken.(mit Mathias' Engagement sogar bald in #d :) )
Chm ist einfach nur alt und unflexibel. ;)
PDF ist nicht so alt aber dafür noch viel unflexibler.

Zitat:

Hat zwar den Nachteil, dass die Ausdrucke etwas unvorteilhaft sind... aber was soll's...
ich bin ohnehin gegen diesen ganzen Papierkram und beware ungern irgendwelche Ausdrucke auf wenn
man das ganze doch auch in elektronischer Form speichern kann.

Genau deshalb. Papier ist so ziemlich das dämlichste Medium zum Nachschlagen. ;)

[Kedariodakon]

Zitat:

Zitat von Robert_G

Papier ist so ziemlich das dämlichste Medium zum Nachschlagen. ;)

Ja aber das Vertrauteste und damit Beste zum lernen...
Und Tutorials sind meinermeinung zum lernen und nicht zum Nachschlagen da...

Bye

[MathiasSimmack]

Zitat:

Zitat von Robert_G

HxS! :firejump:
die kann ich mir einfach in die Doku irgendeiner modernen IDE einklinken.(mit Mathias' Engagement sogar bald in #d :) )

Ich bin ja fertig. 8) Nur die blöde Navigation für die Browserseiten macht mir Kopfzerbrechen.