IE SourcecodePublisher

Was ist das?  

Der IE SourcecodePublisher ist ein von Tobias Rebele entwickeltes Add-In für den Microsoft Internet Explorer. Mit diesem Werkzeug kann Quellcode schnell und einfach mit einer benutzerfreundlichen Oberfläche in HTML-Code konvertiert und im Forum von ActiveVB gepostet werden. Somit gehört die Verwendung anderer Werkzeuge, die meist in Form einer separaten Anwendung oder einer Webschnittstelle zugänglich waren, der Vergangenheit an.

Neuigkeiten  

Im Folgenden werden die wichtigsten Änderungen dokumentiert. Hier können Sie feststellen, ob Sie die aktuelle Version verwenden bzw. ob Aktualisierungen verfügbar sind:

• 5. März 2002: Veröffentlichung eines einfachen Installationsprogramms.
• 21. Februar 2002: Wer jetzt wirklich mitmacht, sollte sich melden.
• 12. Januar 2002: Version 0.41.2002 Beta von IE SourcecodePublisher verfügbar.
• 4. Januar 2002: Version 0.40 Beta verfügbar, Start des Projekts.

Was habe ich zu beachten?  

Die derzeit vorliegende Version ist erst eine Testversion, daher gibt es noch kein Installationsprogramm. Die Installation muss manuell nach den folgenden Schritten durchgeführt werden. Bitte beachten Sie auch die unter „Wichtiger Hinweis zur Benutzung“ angeführten Hinweis!

DLLs und Zubehörprogramme (ieScpub_0.41Beta_binary.zip, ca. 248 KB) 

Quellcode und Zubehörprogramme (ieScpub_0.41Beta_source.zip, ca. 157 KB) 

DLLs, Quellcode und Zubehörprogramme (ieScpub_0.41Beta_komplett.zip, ca. 305 KB) 

Diese Version wurde unter Windows 98, Windows 2000 und Windows XP erfolgreich getestet. Es wird nicht gewährleistet, dass das Programm auf jedem Rechner fehlerfrei funktioniert. Es kann vorkommen, dass sich Rechner nicht mehr starten lassen, nachdem dieses Softwareprodukt darauf installiert wurde. Installieren Sie das Programm bitte nur, wenn Sie dieses Risiko eingehen wollen.

Installation  

Wie bereits angeführt, liegt noch kein Installationsprogramm vor. Daher müssen Sie bereits über ein gewisses Grundwissen verfügen, um die notwendigen Dateien im System installieren zu können. Am Einfachsten geht das, indem Sie den folgenden Schritten folgen:

Schritt 1: Allgemeines

• Stellen Sie fest, welche Betriebssystemversion Sie verwenden und wählen Sie die entsprechenden Dateien. Für Windows 95/98 verwenden Sie die Dateien aus dem Ordner win9x, für Windows 2000 und Windows XP die aus dem Ordner win2000.

• Kopieren Sie diese Dateien in den Zielordner.

• Im Ordner guidgen ist ein Programm zum Erstellen von GUIDs enthalten. Das Programm ist ein Tool der VS-CDs.

• Im Ordner neededfiles ist die Datei Vbshell.tlb zu finden. Diese sollte ins Systemverzeichnis kopiert werden, damit sie in der PATH-Angabe von Windows enthalten ist. Bei Tests unter Windows XP funktionierte das Programm aber auch, wenn die Datei im Programmordner abgelegt war.

• Möglicherweise muss diese Datei noch registriert werden. Allerdings ist das von Betriebssystemversion zu Betriebssystemversion unterschiedlich. Unter Windows XP war das Registrieren nicht erforderlich.

• Die passende REG-Datei für die DLL muss vor der Implementierung noch angepasst werden (Schritt 3).

Schritt 2: Registrierung der DLL

• Die DLL wird mit RegSvr32.exe in der Systemregistrierung eintragen. Das kann über den „Ausführen“-Dialog von Windows geschehen.

• Anschliessend im Registrierungseditor nach „ieScpub.publisher“ suchen. Den zugehörigen GUID merken, da er in der REG-Datei ieScpub.reg eingetragen werden muss.

• Mit dem Programm GUIDGEN.EXE eine explizite GUID erstellen, und kopieren.

Schritt 3: REG-Datei anpassen

• [HKEY_LOCAL_MACHINE\Software\Microsoft\Internet Explorer\Extensions\{44E55C1C-A2A0-4a34-97FA-EBBE2BE78636}]. Hier GUID durch den generierten aus dem Programm GUIDGEN.EXE ersetzen (GUID muss einmalig sein).

• "BandCLSID"="579F34B8-D31B-43CA-979D-FE026095DE7C}". Hier GUID der DLL eintragen.

• "ButtonText"="SourcecodePublisher". Text für die Schaltfläche in der Werkzeugleiste.

• Icon"="D:\WINNT\system32\ieScpub\ieScpub.ico", HotIcon"="D:\WINNT\system32\ieScpub\ieScpub.ico". Pfade für die Symbole der Werkzeugleiste (am besten im Ordner der DLL gespeichert).

• [HKEY_CLASSES_ROOT\CLSID\{579F34B8-D31B-43CA-979D-FE026095DE7C}]. Hier GUID der DLL eintragen.

• @="SourcecodePublisher". Der Standardeintrag wird als Name für den Menüeintrag benötigt. Deshalb wird er in einen aussagekräftigeren Ausdruck geändert.

• [HKEY_CLASSES_ROOT\CLSID\{579F34B8-D31B-43CA-979D-FE026095DE7C}\Implemented Categories\{00021493-0000-0000-C000-000000000046}]. Ersten GUID durch den der DLL ersetzen. Den zweiten identifiziert die DLL im Internet Explorer als „Explorer Band“.

Schritt 4: Installation

• REG-Datei in die Systemregistrierung einfügen.

• Internet Explorer starten und unter „Ansicht“ -> „Explorer-Leiste“ den Eintrag „SourcecodePublisher“ auswählen (möglicherweise erst nach einem Neustart verfügbar).

Verwendung  

Die Benutzeroberfläche von IE SourcecodePublisher ist intuitiv und leicht verständlich, sodass hier auf eine Beschreibung und Erklärung verzichtet wird.

Deinstallation  

Eine Deinstallation ist nicht vorgesehen. Durch Entfernen der DLL-Registrierung, dem Löschen aller bei der Installation erstellten Dateien und der neuen Registrierungseinträge, lässt sie sich jedoch manuell durchführen.

Wie kann ich mitarbeiten?  

IE SourcecodePublisher muss leider derzeit manuell installiert werden. Wir hoffen aber, dass es gemeinschaftlich möglich ist, ein Installationsprogramm zu schreiben. Dieses Programm muss nach den Schritten oben vorgehen und sollte jedenfalls unter Windows 2000 und Windows XP funktionieren.

Ihre Mitarbeit

Ziel ist es, in einer kleinen Projektgruppe oder individuell ein Installationsprogramm für den IE SourcecodePublisher zu entwickeln. Es dürfen keine Komponenten anderer Hersteller als Microsoft verwendet werden. Weiters wird davon ausgegangen, dass die ZIP-Datei, in der das Programm distribuiert wird, gleich aufgebaut ist, wie die hier zum Herunterladen angebotene Datei. Der Benutzer soll die Datei extrahieren und dann eine Datei install.exe aufrufen können, die die Installation durchführt. Auch das Entfernen soll unterstützt werden, das ist aber erst einmal optional. Diese Datei soll nicht den Namen setup.exe tragen. Fertige Projekte können per E-Mail an uns übermittelt werden. Bei Einsendungen ist darauf zu achten, dass der richtige Name angegeben wird. Es wird darum gebeten, Quellcode und feritges Kompilat zu schicken. Nach Möglichkeit sollte Basisfunktionalität wie Zugriff auf die Systemregistrierung in Klassen gekapselt werden.

Holger Martiker hat ein einfaches Installationsprogramm entwickelt. Der Quellcode kann in einer überarbeiteten Version heruntergeladen werden:

Einfaches Installationsprogramm von Holger Martiker (IEScPub.zip, ca. 364 KB) 

Zusätzliche Erweiterungen

Um das Programm noch zu Erweitern, ist jede Hilfe willkommen. Folgende Funktionen sollen noch implementiert werden:

• Syntaxhervorhebung im Editor in Echtzeit
• Direkte Übernahme des konvertierten Code in das Webformular des Forums
• Implementieren einer Plug-In-Funktion
• Automatische Aktualisierung über das Internet

Bekannte Fehler

Wenn Sie sich zum Testen dieses Add-Ins entschlossen haben und Fehler im diesem Programm feststellen, dann wenden Sie sich bitte an den Autor von IE SourcecodePublisher. Fragen können allerdings auch auch direkt im Forum von ActiveVB gestellt werden.

Diese Fehlerliste soll dabei helfen, jedem zu zeigen, welche Fehler bekannt sind und noch entfernt werden müssen. Ein Blick in die Liste kann einen außerdem eine Menge Zeit sparen. Bekannte Fehler:

• Fehler bei ereignisgesteuerter Abfrage des Zwischenspeichers
• Die Backspace-Taste ist ohne Funktion
• Bei leeren Zeilen wird ein Leerzeichen eingesetzt

Was wir zur Verfügung stellen

• Wir stellen bei Bedarf eine Klasse zum Erstellen von GUIDs zur Verfügung.

• Die Registrierung bzw. Deregsitrierung der DLL kann über einen Aufruf von RegSvr32.exe erfolgen. Im folgenden Beispielcode wird die DLL registriert und anschliessend wird die Registrierung wieder aufgehoben:

  ' Registrieren.
  Call Shell("RegSvr32.exe C:\ieScPub\win2000\ieScPub.dll")
  
  ' Registrierung aufheben.
  Call Shell("RegSvr32.exe -u C:\ieScPub\win2000\ieScPub.dll")

Was wir anbieten

Wir sehen diese Arbeit als ehrenamtliche Tätigkeit für ActiveVB an und können daher nicht eine Bezahlung für die Teilnahme am Projekt aussetzen. Wird aber eine gute Lösung präsentiert, dann nimmt derjenige, von dem sie stammt, automatisch am nächsten Gewinnspiel teil.

Ausblick  

Es ist zwar geplant, dass im Forum von ActiveVB in Zukunft eventuell durch das Markieren von Quellcode durch eigens zu diesem Zwecke vorgesehene Marken eine automatische Konvertierung in entsprechendes HTML erfolgt, trotzdem stellt dieses Projekt ein interessantes Beispiel zur Erweiterung von Internet Explorer dar.