Die Win32-API Tutorials als PDF

[Luckie]

Hier mal eine Demo. Die Quellcodes habe ich jetzt alle zusammen an das Ende gehange. Jetzt kann man sie beim Drucken einfach weglassen. Demo im Anhang.

[Assarbad]

@Aya: Nein, du bist nicht gemeint

@Luckie: Klaro geht das:

Zitat:

Dieses Tutorial darf ausdrücklich inhaltlich und layouttechnisch ungeändert in Form der Orginal-PDF-Datei zusammen mit den anderen
im Archiv enthaltenen Dateien (Quelltexte) weitergegeben, sowie in elektronischer (z.B. Internet) und physischer Form (z.B. Papierdruck)
verbreitet werden, solange die Kosten für das physische Medium seitens des Konsumenten den Wert von ? 10,- (entsprechend dem
Euro-Goldkurs vom 2002-10-22) nicht übersteigen. Im Internet hat die Weitergabe kostenlos zu erfolgen. Ein Downloadangebot hat
immer in Form der Orginal-PDF-Datei zu erfolgen, nicht in einer umformatierten Variante.

Zitat:

Explizit erteile ich folgenden Personen die Erlaubnis das Layout und Format (auch Dateiformat) dieses Tutorials für eine
Onlineveröffentlichung auf ihren Homepages bzw. Community-Seiten sowie Tutorialsammlungen anzupassen:
Philipp Frenzel (www.delphi-treff.de),
Michael Puff (www.luckie-online.de),
Mathias Simmack (www.simmack.de),
Martin Strohal & Johannes Tränkle (www.delphi-source.de),
Ronny Purmann (www.faqsen.de)

Als HTML wirst du es von mir nicht mehr bekommen. HTML ist an dieser Stelle für mich kein Thema mehr ... du kannst es aber gern konvertieren. Erlaubnis hast du ja, siehe oben.
Übrigens, du mußt sie nicht einbauen, aber es würde sich mglw gut ergänzen ... da ich ja nur bestimmte Themen, die aber dann um so ausführlicher, behandele paßt es vielleicht garnicht sie direkt einzufügen ... da mag Mathias ganz recht haben.

[Luckie]

Ach Mmist, warum ist mir das nie aufgefallen.

[MathiasSimmack]

Zitat von Assarbad:

Als HTML wirst du es von mir nicht mehr bekommen. HTML ist an dieser Stelle für mich kein Thema mehr ... du kannst es aber gern konvertieren. Erlaubnis hast du ja, siehe oben.
Übrigens, du mußt sie nicht einbauen, aber es würde sich mglw gut ergänzen ... da ich ja nur bestimmte Themen, die aber dann um so ausführlicher, behandele paßt es vielleicht garnicht sie direkt einzufügen ... da mag Mathias ganz recht haben.

Ich habe das übrigens mal probiert, Assa. Ich habe hier ein (Java)Skript, mit dem man die PDF-Datei direkt aus der CHM hätte aufrufen und quasi im Hilfefenster hätte anzeigen lassen können. Das Problem war nur, dass sich das mit dem Inhaltsverzeichnis der CHM beißt. Sprich: das CHM-Inhaltsverzeichnis links, dann deins noch mal daneben.

Deswegen dachte ich, ich lasse es in der nächsten CHM-Version ganz raus. Und da passt es ganz gut, dass Luckie eine PDF-Version der Tutorials plant.


Übrigens noch mal hier die Frage: Ich persönlich bin dafür, die Beispielprogramme aus den Hilfedateien raus zu nehmen. Nicht verwechseln! Ich spreche nicht von den Sourcen, sondern von den in den CHMs enthaltenen Quellcodes ("Das XY-Beispielprogramm", etwa). Da manche Programme doch aus mehr als nur der DPR bestehen, aber eben meist nur diese abgedruckt ist, bringt´s IMHO nichts.
Zumal die relevanten Punkte (wie macht man dies? wie jenes?) im Tutorial selbst abgehandelt werden. Wer wirklich mehr wissen will, wird sowieso die Beispielsourcen installieren und starten.

Wie seht ihr das? Kann ich die ganzen "*-xmpl.htm"-Dateien löschen?

Grüße.

[Alexander]

mhm also ich würde sie drinne lassen, ich fand das eigentlich recht gut...

[MathiasSimmack]

Hm, ich sehe die Nützlichkeit nicht (mehr). Wenn du bspw. wissen willst, wie ein Tree-View (was auch immer) erzeugt wird, dann wird dir das ja im Tutorialtext mit Codeauszügen erklärt. Logisch, denn dazu wurde es ja geschrieben.

Was das Beispielprogramm darüber hinaus noch anstellt, spielt im Zusammenhang mit dem erklärten Control keine große Rolle. Wenn es wichtig scheint (etwa die Anzeige der System-Ordnersymboleim TV), dann wird es ja wieder in einem Kapitel erwähnt.

Und weil die einige Programme ihrerseits auf externe Sachen zurückgreifen (Dialoge, Funktionen in Includes, ...), bringt das Herauskopieren des abgedruckten DPR-Quelltextes aus der Hilfedatei IMHO auch nicht viel. Deswegen würde ich gern darauf verzichten. Und es hätte den Nebeneffekt, dass die Hilfedateien schlanker werden.

Eigentlich könnte ich (in meiner Eigenschaft als technischer Diktat ... äh, Direktor für Hilfedateienkompilation und Setup) euch doch vor vollendete Tatsachen stellen.

[Marco Haffner]

Zitat von MathiasSimmack:

Wie seht ihr das? Kann ich die ganzen "*-xmpl.htm"-Dateien löschen?

Nimm sie raus, die wichtigen Sachen liegen ja eh als Source noch dabei.
Und sollte es dann doch noch einmal Probleme geben, wir wissen ja wo die Fragen gestellt werden können.

[Luckie]

Gut. Ich bin auch dafür sie rauszunehmen. Dem PDF lege ich noch ein Zip-Archiv mit den Quellcodes bei, wie es Assarbad macht. Das PDF wird ungepackt auf der HP veröffentlicht, so dass man es sich mit links KJlick online ankucken kann und mit rechts klick "Ziel speichern unter" runterladen kann.

Die online Version der Tutorials wird es weiterhingeben. Eventuell nehme ich die Sourcecodes da auch raus und biete sie als Zip separat auf der entsprechenden Seite an. Wollt ihr sie alle zusammen haben als Downnload auf der Übersichtsseite der Tutorials oder jedes Demo einzeln am Ende jedes Tutorials?

Oh Gott, ich glaube, ich habe mir da recht viel Arbeit aufgehalst. Da müßte ich den Tutorialberaich der HP komplett umgestallten.

[MathiasSimmack]

Mit den Tutorials von Assarbad solltest du das lieber nicht vergleichen, denn er konzentriert sich pro Tutorial auf ein Thema. Stell dir vor, du würdest das auch so machen, dann gäb´s eine PDF für Fenster, eine für Buttons, eine für ...

Ich weiß nicht ob´s so gut wäre, die Demos aufzuteilen. Angenommen, du aktualisierst eine einzelne auf deiner HP, vergisst aber die Version in der Komplettsammlung ... uih ...

[Luckie]

Ja, ich lasse sie auch zusammen. Ich werde nur das online Angebot mit der CHM Version abgleichen, so dass man online das gleiche lesen kann, wie in den CHM's. Und dann wird die Seite immer parallel mit deiner CHM-Version upgedatet, dann gibt es nichts mehr vorraus zum online lesen. So denke ich kann man die Konsistenz der CHM-Version, der PDF-Version und dem online Angebot gewährleisten.
Das wären jetzt meine Vorstellungen. Ratschläge, Idee könne auch gerne von euch eingebracht werden, die müssen nicht nur von Mathis kommen. Ihr seit ja meine Zielgruppe. Allerdings behalte ich mir als Autor das letzte Wort vor.