Code - Orakel v1.5.0

[RWarnecke]

Hallo zusammen,

ich möchte euch mein neustes Projekt Code - Orakel vorstellen. Dieses Programm soll dazu dienen, sich eine Wissensdatenbank von Sourceode Beispielen aufzubauen. Es baut auf einer Firebird 2.5.1 Embedded Datenbank auf und kann lokal, einem USB-Stick oder einem anderen externen Massenspeichergerät genutzt werden. Die Liste der Programmier-/Script Sprachen umfasst :

• Assembler
• Batch-Script
• C#
• C/C++
• CSS
• Delphi
• Delphi.NET / Prism
• HTML
• INI
• Inno-Setup
• Java
• JavaScript
• PHP
• Perl
• Python
• Ruby
• SQL
• UNIX Shell Script
• VBScript
• Visual Basic .NET
• Visual Basic 5/6
• XML

Zu den einzelnen Beispielen kann eine ausführliche Beschreibung und sonstige Notizen hinzugefügt werden. Der Sourcecode wird dementsprechend gehighlighted. Desweiteren kann der Sourcecode in eine HTML-Datei oder in ein HTML Code Fragment exportiert werden. Beim Export gibt es auch noch eine Vorschau im Standard Webbrowser. Beim Export als HTML-Datei oder HTML Code Fragment ist das Highlighting ebenfalls vorhanden.Hinzu kommt noch ein Export in das RTF-Format. Dabei wird der offene Sourcecode in ein RTF-Format exportiert und im verknüpften Programm für RTF-Dateien angezeigt (z.B. Microsoft Word).
Desweiteren verfügt das Programm über eine WebUpdate-Funktion und über eine Online-Hilfe. In der Favoritenliste können einzelne Code-Beispiele oder auch Kategorien hinterlegt werden. Diese können durch einen Doppelklick auf den Eintrag geöffnet werden. Verschiedene Einstellungen des Fensters, der Datenbank oder der Memos können konfiguriert und abgespeichert werden.

Download-Link :
Das selbstextrahierendes Archiv von der Homepage mit leerer Datenbank (ca. 4MB) in der Version 1.5.0.

Für das PlugIn - System gibt es unter diesem Download (ca. 60KB) auch noch eine Anleitung und ein Beispiel.

Produktbeschreibung mit Screenshots und Changelog

Changelog:

Version 1.5.0: (28.10.2012)
[+] Die Hints der Buttons und der Menüpunkte werden im zweiten Panel der Statusleiste angezeigt.
[+] Lesenden Zugriff auf die Code-Orakel Online Datenbank eingerichtet
[+] Mehrsprachigkeit hinzugefügt / Unterstützte Sprachen Deutsch und Englisch
[*] Die Webupdate Funktion überarbeitet.
[*] Performance beim Auslesen der Kategorien über das Netzwerk verbessert.
[-] Letzter Suchbegriff wird gelöscht und das Highlighting wird aufgehoben, sobald das Suchergebnisfenster geschlossen wird.
[-] Problem beim Drag & Drop im Treeview behoben, wenn eine Unterkategorie in den Hauptbereich gezogen wird.
[-] Problem mit gleichen Überschriften bei Codebeispielen in unterschiedlichen Kategorien behoben.
[-] Verbindungsfehler zur Firebird Datenbank behoben, nach Abspeichern der Einstellungen.
[i] Im Download ist der Firebird 2.5.1 Client enthalten. Beim Webupdate bleibt der Firebird-Client 2.1.1 erhalten.
[i] Mehrere kleine Bugs behoben

Version 1.4.5: (05.05.2010)
[+] Automatischer Reconnect zur Datenbank, wenn die Verbindung mal unterbrochen wurde
[+] Beim Auftreten eines Fehlers kann jetzt der Fehlerreport versendet werden.
[+] Beim Webupdate wird das ChangeLog der letzten veröffentlichten Version und der aktuellen Version angezeigt.
[+] Es kann ausgewählt werden, was gedruckt werden soll (Quelltext, Beschreibung, Notizen)
[+] Es kann jetzt auch in nur einer ausgewählten Hauptkategorie gesucht werden
[+] Suchergebnisse können nach Kategorie oder Überschrift aufsteigend oder absteigend sortiert werden.
[*] Die Buttons für den Seitenwechsel in der Druckvorschau werden entsprechend aktiviert oder dekativiert.
[*] Wenn das Suchergebnis keinen Treffer hat, wird nur eine Meldung ausgegeben
[-] Automatisches Löschen der PlugIns in der INI-Datei, wenn die dazugehörige PLG-Datei nicht mehr vorhanden ist, beim Programmstart.
[i] Verschiedene kleine Änderungen

Version 1.4.0: (27.09.2010)
[+] Scrollbalken werden in der Beschreibung und in den Notizen angezeigt.
[+] Suchwörter werden im Sourcecode farblich hinterlegt.
[+] WebUpdate funktioniert auch über eine direkte Verbindung oder über einen Proxy
[*] Beim zweiten Mal starten der Anwendung, erhält die aktuelle Instanz des Programms den Focus.
[*] Mehrere kleine grafische Korrekturen durchgeführt.
[-] Die Aktualisierung der Cursorposition in Statuszeile korrigiert
[-] Es können keine doppelten Namen mehr in einer Ebene vergeben werden.
[-] Fehler in der Herstellung der Größe und Position des Programmfensters behoben.

ChangeLog erstellt durch DevProject Manager

Screenshots findet Ihr wie immer hier im Anhang.

Testen ist natürlich erwünscht, aber das Feedback noch umso mehr. Schreibt mir ruhig viel Lob, Kritik, Bugs und auch Verbesserungsvorschläge.

[RWarnecke]

Zitat von juergen:

Hallo Rolf,

Zitat von RWarnecke:

[*] Das Suchwort aus der Suche wird hervorgehoben[*] Das Fenster für das Ergebnis der Suche wird offen gelassen.

Mir ist die Suche ja ziemlich wichtig und so freue ich mich über diese nützliche Erweiterungen!
Leider sehe ich die Worthervorhebung nicht.

Das hätte ich noch dazu schreiben sollen, was ich auch gleich nachhole. Ich habe es noch nicht für den Sourcecode umgesetzt. Es wird lediglich nur der Suchebrgriff hervorgehoben in der Beschreibung und in den Notizen. Bei dem SynEdit fehlt mir ehrlich gesagt noch so die richtige Idee, da ich nicht die Code-Formatierung kaputt machen möchte.

Zitat von juergen:

Gelungen finde ich auch die Umsetzung für die Suchergebnisse!

Danke.

Edit : Werde es aber für das SynEdit (den Sourcecode) noch nachholen, wenn ich für mich eine zufriedenstellende Lösung gefunden habe. Wenn jemand eine Idee oder Vorschlag hat, der nicht die Code-Formatierung kaputt macht, dann her damit.

[rollstuhlfahrer]

HI,

ich hab mal 3 Videos gemacht, weil ch mir dachte, dass wir hier etwas aneinander vorbei reden (weil der Fehler nur bei mir auftritt etc.). Ich hab jetzt ein Update gemacht und nun scheint der Fehler wohl auch weg zu sein. Zu den Videos:

a) Startvorgang von Code-Orakel (u.A. mit den Standartwerten)
b) der Range Check Error
c) mehrere Startvorgänge mit (fast) zufälligem Ergebnis)

Die Auflösung ist leider auf 640x480 beschränkt, also musste ich mit dem Rahmen etwas rumfahren, was ich auch net immer gemacht hab. Das wichtigste (find ich) ist zu sehen.

Bernhard

[guidok]

Hallo Rolf,

danke für das nützliche Programm. Ich habe es nun endlich auch bei mir installiert und finde es sehr hilfreich, obwohl ich leider sagen muss, dass auch ich den "Range Check Error" beim Starten habe und in der Regel zwei oder dreimal starten muss, bis es dann auch läuft...

Ich muss dazusagen, dass ich die Version 1.2.0 von deiner Homepage habe, da hier in unserer Firma das Webupdate geblockt wird, werde ich auch warten müssen, bis die aktuelle Version zum Download verfügbar ist.

Ein paar kleine Anmerkungen, die vielleicht auch in der aktuellen Version bereits behoben sind:

1. Beim Updateversuch bekomme ich die Meldung "Allgemeiner Fehler bei der Verbindung zum Internet", allerdings öffnet sich nach dem Wegklicken trotzdem das Fenster für das Update, nur ohne Funktion.

2. Die Suche ist anscheinend casesensitiv: Suche ich nach "dienst" finde ich nichts, "Dienst" findet er dann. Vielleicht könnte man dies einstellbar gestalten.

3. Wenn ich auf eine Kategorie mit rechts Klicke öffnet sich ein Kontextmenü mit dem Punkt "Codebeispiel hinzufügen", korrekt soweit. Ist nun allerdings ein Codebeispiel markiert und ich Klicke mit rechts auf die Kategorie, dann ist der Punkt ausgegraut. Schön wäre es hier, wenn die Markierung auf das mit rechts angeklickte Beispiel/Kategorie wechselt und das entsprechende Kontextmenü öffnet.

Gruß,

Guido

[RWarnecke]

Zitat von guidok:

Hallo Rolf,

danke für das nützliche Programm. Ich habe es nun endlich auch bei mir installiert und finde es sehr hilfreich, obwohl ich leider sagen muss, dass auch ich den "Range Check Error" beim Starten habe und in der Regel zwei oder dreimal starten muss, bis es dann auch läuft...

Ich glaube, dass Problem mit dem Range Check Error kommt daher, dass ich die Unit Sharemem nutze. Ist auf den Rechner, wo der Fehler auftritt Delphi installiert ?

Zitat von guidok:

Ich muss dazusagen, dass ich die Version 1.2.0 von deiner Homepage habe, da hier in unserer Firma das Webupdate geblockt wird, werde ich auch warten müssen, bis die aktuelle Version zum Download verfügbar ist.

Ein paar kleine Anmerkungen, die vielleicht auch in der aktuellen Version bereits behoben sind:

1. Beim Updateversuch bekomme ich die Meldung "Allgemeiner Fehler bei der Verbindung zum Internet", allerdings öffnet sich nach dem Wegklicken trotzdem das Fenster für das Update, nur ohne Funktion.

Habt Ihr in der Firma einen Proxy, worüber eure Rechner ins Internet gehen ?

Zitat von guidok:

2. Die Suche ist anscheinend casesensitiv: Suche ich nach "dienst" finde ich nichts, "Dienst" findet er dann. Vielleicht könnte man dies einstellbar gestalten.

Ist in der Version 1.3.0 behoben. Grund dafür war, dass ich mit LIKE den SQL-Suchbefehl aufgebaut habe.

Zitat von guidok:

3. Wenn ich auf eine Kategorie mit rechts Klicke öffnet sich ein Kontextmenü mit dem Punkt "Codebeispiel hinzufügen", korrekt soweit. Ist nun allerdings ein Codebeispiel markiert und ich Klicke mit rechts auf die Kategorie, dann ist der Punkt ausgegraut. Schön wäre es hier, wenn die Markierung auf das mit rechts angeklickte Beispiel/Kategorie wechselt und das entsprechende Kontextmenü öffnet.

Du klickst mit der rechten Maustaste auf eine Kategorie, die nicht makiert ist, habe ich das so richtig verstanden ?

[rollstuhlfahrer]

Zitat von RWarnecke:

Ich glaube, dass Problem mit dem Range Check Error kommt daher, dass ich die Unit Sharemem nutze. Ist auf den Rechner, wo der Fehler auftritt Delphi installiert ?

Bei mir ist das immer der Fall, da auch in der Schule auf allen Rechnern Delphi installiert ist und zu Hause auch (ich nutze es ja).

Bernhard

[RWarnecke]

Wenn Du die Datei BORLNDMM.DLL mit ins Programmverzeichnis kopierst, geht es dann ?

[guidok]

Zitat:

Ich glaube, dass Problem mit dem Range Check Error kommt daher, dass ich die Unit Sharemem nutze. Ist auf den Rechner, wo der Fehler auftritt Delphi installiert ?

Ja.

Zitat:

Beim Updateversuch bekomme ich die Meldung "Allgemeiner Fehler bei der Verbindung zum Internet", allerdings öffnet sich nach dem Wegklicken trotzdem das Fenster für das Update, nur ohne Funktion.

Habt Ihr in der Firma einen Proxy, worüber eure Rechner ins Internet gehen ?

Die Firma hat 10000 Mitarbeiter, ich habe keine Ahnung, was unsere IT so macht. Das ist grundsätzlich auch nicht das Problem, ich finde nur, wenn schon festgestellt wird, dass kein Internet verfügbar ist, dann sollte auch der zweite Dialog nicht kommen. Schöner wäre es natürlich es würde funktionieren...

Zitat:

3. Wenn ich auf eine Kategorie mit rechts Klicke öffnet sich ein Kontextmenü mit dem Punkt "Codebeispiel hinzufügen", korrekt soweit. Ist nun allerdings ein Codebeispiel markiert und ich Klicke mit rechts auf die Kategorie, dann ist der Punkt ausgegraut. Schön wäre es hier, wenn die Markierung auf das mit rechts angeklickte Beispiel/Kategorie wechselt und das entsprechende Kontextmenü öffnet.

Du klickst mit der rechten Maustaste auf eine Kategorie, die nicht makiert ist, habe ich das so richtig verstanden ?

Genau. Typisches Ersparen unnötiger Klickerei: Codebeispiel einfügen, editieren, mit rechts auf die Kategorie klicken, um gleich das nächste Beispiel einzufügen.

Das hat auch noch einen anderen Aspekt: Nehmen wir an es gibt mehrere Codebeispiele von denen eines markiert ist. Jetzt möchte ich eines davon löschen (natürlich ein nicht markiertes) und klicke mit rechts darauf, das Kontextmenü öffnet sich und schwupp ist der falsche Eintrag gelöscht. Meiner Meinung nach sollte auf jeden Fall, ob nun mit links oder rechts geklickt wird, der Fokus wechseln.

Edit:

Ich hätte da noch einen Verbesserungsvorschlag...

Es gibt ja die drei Reiter "Quelltext", "Beschreibung", "Notizen". Damit man nun nicht immer umschalten muss, um zu gucken, ob eine Notiz vorhanden ist, nur um anschließend festzustellen, dass doch keine da war, könnte man den Reiter doch irgendwie markieren (Farbe, Image, o.ä.), sobald eine Notiz vorhanden ist.

Edit:

Und noch was...

Bei der Einstellung zur Datenbank wäre es nett, wenn man auch bei "Lokal" den Datenbankpfad einstellen könnten, um die DB ggf. in einem anderen Verzeichnis abzulegen. Könnte in meinem Fall sinnvoll sein, um die DB auf einem Netzlaufwerk zu platzieren.

Und noch was...

Ich programmiere ja in der Hauptsache Maschinensteuerungen in der Sprache Step7. Das ist natürlich sinnvoll nur in AWL (Es gibt bei Step7 auch grafische Programmiermöglichkeiten) umzusetzen, aber vielleicht könnte man dafür auch eine Sparte schaffen?

[rollstuhlfahrer]

Zitat von guidok:

Es gibt ja die drei Reiter "Quelltext", "Beschreibung", "Notizen". Damit man nun nicht immer umschalten muss, um zu gucken, ob eine Notiz vorhanden ist, nur um anschließend festzustellen, dass doch keine da war, könnte man den Reiter doch irgendwie markieren (Farbe, Image, o.ä.), sobald eine Notiz vorhanden ist.

Warum denn farbloch hervorheben? Wäre es nich besser noch einen horizontalen Splitter einzubauen und dann oben den Quelltext anzeigen und unten Notizen/Beschreibung?

Bernhard

[RWarnecke]

Zitat von guidok:

Zitat:

Beim Updateversuch bekomme ich die Meldung "Allgemeiner Fehler bei der Verbindung zum Internet", allerdings öffnet sich nach dem Wegklicken trotzdem das Fenster für das Update, nur ohne Funktion.

Habt Ihr in der Firma einen Proxy, worüber eure Rechner ins Internet gehen ?

Die Firma hat 10000 Mitarbeiter, ich habe keine Ahnung, was unsere IT so macht. Das ist grundsätzlich auch nicht das Problem, ich finde nur, wenn schon festgestellt wird, dass kein Internet verfügbar ist, dann sollte auch der zweite Dialog nicht kommen. Schöner wäre es natürlich es würde funktionieren...

Ok, habe ich in meine ToDo-Liste mit aufgenommen, werde es korrigieren.

Zitat von guidok:

Zitat:

3. Wenn ich auf eine Kategorie mit rechts Klicke öffnet sich ein Kontextmenü mit dem Punkt "Codebeispiel hinzufügen", korrekt soweit. Ist nun allerdings ein Codebeispiel markiert und ich Klicke mit rechts auf die Kategorie, dann ist der Punkt ausgegraut. Schön wäre es hier, wenn die Markierung auf das mit rechts angeklickte Beispiel/Kategorie wechselt und das entsprechende Kontextmenü öffnet.

Du klickst mit der rechten Maustaste auf eine Kategorie, die nicht makiert ist, habe ich das so richtig verstanden ?

Genau. Typisches Ersparen unnötiger Klickerei: Codebeispiel einfügen, editieren, mit rechts auf die Kategorie klicken, um gleich das nächste Beispiel einzufügen.

Das hat auch noch einen anderen Aspekt: Nehmen wir an es gibt mehrere Codebeispiele von denen eines markiert ist. Jetzt möchte ich eines davon löschen (natürlich ein nicht markiertes) und klicke mit rechts darauf, das Kontextmenü öffnet sich und schwupp ist der falsche Eintrag gelöscht. Meiner Meinung nach sollte auf jeden Fall, ob nun mit links oder rechts geklickt wird, der Fokus wechseln.

Werde ich auch noch korrigieren, habe ich in meine ToDo-Liste mit aufgenommen.

Zitat von guidok:

Edit:

Ich hätte da noch einen Verbesserungsvorschlag...

Es gibt ja die drei Reiter "Quelltext", "Beschreibung", "Notizen". Damit man nun nicht immer umschalten muss, um zu gucken, ob eine Notiz vorhanden ist, nur um anschließend festzustellen, dass doch keine da war, könnte man den Reiter doch irgendwie markieren (Farbe, Image, o.ä.), sobald eine Notiz vorhanden ist.

Das halte ich für nicht so gut. Mein Vorschlag wäre da, den Reiter Notizen und Beschreibungen ein- bzw. auszublenden, wenn etwas drinsteht oder nicht.

Zitat von guidok:

Edit:

Und noch was...

Bei der Einstellung zur Datenbank wäre es nett, wenn man auch bei "Lokal" den Datenbankpfad einstellen könnten, um die DB ggf. in einem anderen Verzeichnis abzulegen. Könnte in meinem Fall sinnvoll sein, um die DB auf einem Netzlaufwerk zu platzieren.

Die Datenbank auf ein Netzlaufwerk zu legen wird glaube ich nicht so einfach funktionieren. Denn es muss die Datei firebird.conf dann noch zusätzlich konfiguriert werden. Installiere liber dazu einen Rechner, wo ein Firebird-Server drauf läuft, dann hast Du es einfacher.

Zitat von guidok:

Und noch was...

Ich programmiere ja in der Hauptsache Maschinensteuerungen in der Sprache Step7. Das ist natürlich sinnvoll nur in AWL (Es gibt bei Step7 auch grafische Programmiermöglichkeiten) umzusetzen, aber vielleicht könnte man dafür auch eine Sparte schaffen?

hast Du mir Informationsmaterial zu der Sprache Step7, damit ich weiß wie die Sprache aufgebaut ist.

Zitat von rollstuhlfahrer:

Warum denn farbloch hervorheben? Wäre es nich besser noch einen horizontalen Splitter einzubauen und dann oben den Quelltext anzeigen und unten Notizen/Beschreibung?

Da bin ich schon am überlegen und am Planen. Mein Vorhaben ist, dass ich im ersten Schritt verschiedene Layouts zur Verfügung Stelle, die man auswählen kann. Der zweite Schritt wäre dann, dass sich der User das ganze selber zusammenstellen kann. Aber das wird wohl noch einige Zeit in Anspruch nehmen, da ich soetwas noch nie realisiert habe.

[guidok]

Zitat:

Es gibt ja die drei Reiter "Quelltext", "Beschreibung", "Notizen". Damit man nun nicht immer umschalten muss, um zu gucken, ob eine Notiz vorhanden ist, nur um anschließend festzustellen, dass doch keine da war, könnte man den Reiter doch irgendwie markieren (Farbe, Image, o.ä.), sobald eine Notiz vorhanden ist.

Das halte ich für nicht so gut. Mein Vorschlag wäre da, den Reiter Notizen und Beschreibungen ein- bzw. auszublenden, wenn etwas drinsteht oder nicht.

Das ist ungünstig, da beim Anlegen einer neuen Beispiels garantiert noch nichts drinsteht und ich ja vielleicht etwas hineinschreiben möchte... Nach meiner persönlichen Meinung wäre ein kleines Icon im Reiter das Ideale (kleiner Notizzettel oder so) und völlig ausreichend.

Zitat von rollstuhlfahrer:

Warum denn farbloch hervorheben? Wäre es nich besser noch einen horizontalen Splitter einzubauen und dann oben den Quelltext anzeigen und unten Notizen/Beschreibung?

Finde ich persönlich nicht so toll, da dann der Fensterinhalt für den Code kleiner wird. Da ist man dann immer am Scrollen.


Zu Step7 versuche ich etwas zu finden...

Edit:

Siemens Handbuch zu AWL

Das eigentlich interessante wäre AWL-Quellen, aber leider habe ich dazu noch nichts...


Edit:

Noch eine Kleinigkeit, die mir gerade aufgefallen ist:

1. Der erste Toolbutton "Neue Kategorie" zeigt keine Hint an.
2. Der zweite Toolbutton hat als Hint "Einen neuen Sourcecode anlegen", während das Popupmenü als Eintrag "Codebeispiel" anzeigt. Dies sollte vereinheitlicht werden (Sourcecode oder Quellcode, wir sind ja hier in Deutschland)