Script Manager / AHK Help Style Template

[BNOLI]

Moin, heute mal zwei Fragen:

Nach Suche, finden sich für AHK lediglich 3 Script-Manager die jedoch bereits > 10y alt sind (sofern überhaupt verfügbar).
a) benutzt jmd von Euch aktuell einen AHK-Script-Manager? Wenn ja, welchen?? Erfahrung mit weiteren?? ...

Die AHK-Hilfe benutzt ein spezielles Style-sheet/theme (mkdocs.org ?).
b) ist bekannt welches? Gibt es sowas wie einen "Hilfeseiten"-(Online)-Generator?

Danke fürs Zuhören

[just me]

Moin BNOLI,

zu a) kann ich nichts sagen. Zu b) frag mal @Ragnar (absoluter AHK-Hilfe-Experte).

[Ragnar]

Die AHK-Hilfe benutzt weder ein fremdes Style-sheet/theme noch wurde sie mit einem "Hilfeseiten"-(Online)-Generator erstellt. Alles in Eigenregie entstanden. CSS stammt hauptsächlich von Chris/Lexikos/mir, das Theme basiert auf das Standard-Theme des Forums und die ganzen zusätzlichen Features drumherum wie Navileiste, Toolleiste usw. ist zu 90% mein Werk (außer die Suchfunktion).

Ja, es gibt Hilfeseiten-Generatoren. Für AHK-Code gibt es hauseigene Varianten wie GenDocs oder DocGen (einfach via Google nach "document generator autohotkey" suchen). Für Programme und Sonstiges zum Beispiel FAR HTML 5.

[BNOLI]

Hab ich schonmal angemerkt, das all Jenen, die sich um die AHK-Hilfe verdient gamacht haben mein immerwährender Dank gehört?
Nicht?? Dann isses jetzt soweit:

[Ehrengarde] DANKE [/Ehrengarde]

[BNOLI]

... Frage a) ist offensichtlich auf geringes Interesse gestossen
Nun, meine Überlegung war wie folgt: praktisch jede von AHK-Mitgliedern bereitgestellte Funktion (oder ein Script) wird mit einem Header verkommentiert, welcher z.B. Informationen zum Developer/Credits/Anleitungen/Verlinkungen etc. enthalten kann. Legt man sich nun ein Archiv solcher Funktionen an, geht, sofern die Dateinamen nicht 'sprechend' sind, irgendwann die Übersicht verloren was den so "an Lager" ist. Ein einfacher Parser/Verwalter würde die jeweils genannte Datei im Header auf Schlüsselbegriffe ('description,author,...), oder fixe Zeilen durchgehen und diese retournieren, als Liste/Index in einer Datei, oder einer GUI retournieren. Mir schwebte etwas in Richtung Verschlagwortung/tags vor ... DatenBank | SQL | function | just me | ...

Etwas Aktuelles in der Richtung habe ich für AHK nicht gefunden. Bei der Recherche nach einem SAP-Thema wurde heftigst auf AutoIT verwiesen, und mir ist aufgefallen, das dort scheints 'genormte' header für UDF's verwendet werden, was ein Erfassen wie oben beschrieben sicher vereinfacht. Solche vereinbarten Standards gibts für AHK nicht, oder??

[just me]

Moin,

vielleicht kannst DU ja etwas von Ixiko's collections of functions and libraries für Deine Zwecke abzweigen.

Das Thema 'Styleguide' kannst Du für AHK vergessen. Es gibt schlichtweg kein Interesse daran. Jeder schreibt seine 'UDF's, wie es ihm gerade in den Sinn kommt, und stellt sie dann ohne neutrale Qualitätskontrolle ins Forum. Und zumindest solange es keine 'offiziellen' UDFs gibt, die Bestandteil der AHK-Distrbution sind, wird sich daran auch nichts ändern.

[BNOLI]

Merci

[BNOLI]

Das Thema 'Styleguide' kannst Du für AHK vergessen. Es gibt schlichtweg kein Interesse daran. Jeder schreibt seine 'UDF's, wie es ihm gerade in den Sinn kommt, und stellt sie dann ohne neutrale Qualitätskontrolle ins Forum. Und zumindest solange es keine 'offiziellen' UDFs gibt, die Bestandteil der AHK-Distrbution sind, wird sich daran auch nichts ändern.

Offensichtlich gab es dazu schon einmal ernsthafte Bemühungen!!?
https://github.com/ahkscript/ASPDM/blob/master/Specifications/Guidelines.md
http://aspdm.ahkscript.org/#afc

Vielleicht ist ein solch "verwaltungstechnischer" Ansatz etwas 'to much' AKA 'overkill' für den average/gemeinen User?

[hoppfrosch]

Lange Geschichte - kurzes Summary: Es gab schon einige Versuche ein vereinheitliches System für UDFs für Autohotkey zu schaffen. Das passierte auf unterschiedlichen Komplexitätsebenen (angefangen von Vorschlägen zu standardisierten Dokumentationsheadern bis hin zu ausgewachsenen Paketverwalungssystemen (http://aspdm.ahkscript.org/#afc)). Alle sind bisher glorreich gescheitert - zu wenig Interesse, zu wenig Konsens, zu wenig Kooperation, zu viel Egoismus ...

Z.B.:
* https://www.autohotkey.com/boards/viewtopic.php?f=76&t=132
* https://www.autohotkey.com/boards/viewtopic.php?f=13&t=55617 -
* https://autohotkey.com/board/topic/71751-gendocs-v30-alpha002-create-stdlib-documentation-easily/

usw. usf. --- das sind nur ein paar Threads von vielen, in denen sowas diskutiert wurde. Die meisten komplexen Lösungen beinhalten meines Erachtens auch Standardisierung der Dokumentation.

Aktuell sehe ich die AHK-Community weiter als je zuvor von einem so ehrgeizigen Ziel entfernt. Ich wünsch dir viel Erfolg (ernsthaft), sowas erfolgreich zu initieren und zu realisieren.

[BNOLI]

IMHO sind Egos der hinderlichste Grund, nicht nur in diesem Kontext. Selbst kleinste Projekte scheitern am "sich nicht mehr Einlassen wollen", weil bereits ab zwei Personen einer denkt, er wäre fremdbestimmt. IMHO sind da die Freunde von AutoIt einfach professioneller unterwegs, denn da zählt(e) in Stylingfragen offensichtlich die Sache.