Für Menschen · Seien Sie begeistert und Sie werden begeistern !

CSSDOC ist ein gemeinschaftliches Projekt und im aktuellen Adventskalender der Webkrauts ist der wunderbarere Artikel „Stylesheets kommentieren mit CSSDOC“ des Mitbegründers und YAML Erfinders Dirk Jesse veröffentlicht.
Die Idee von CSSDoc gefällt und da ich grundlegend im UltraEdit, meinem liebsten Editor, arbeite, habe ich mir die Tags in einer Tag-Liste hinterlegt, so dass ich schnell und einfach alle derzeit möglichen Tags zur Hand habe.

Leider ist UltraEdit kein Open Source Projekt und alternativ kann man unter anderem Notepad++ und jEdit empfehlen. Beide sind auch erweiterbar und eventuell kann man dann die folgende Tagliste mit wenigen Veränderungen übernehmen. Zugreifen und CSSDOC im nächsten Projekt nutzen.
Nun fehlt mir nur noch die Integration im Parser CSSTidy, den ich auch in meinem Editor integriert habe, dann wäre das Validieren in meinem Editor auch für CSSDOC möglich.
[Tag Group - CSSDoc]
0="/**"
1="*"
2="*/"
3="Author :UEDS:* @author (file)"
4="Copyright :UEDS:* @copyright (file)"
5="Date :UEDS:* @date (file)"
6="Version :UEDS:* @version (file)"
7="Revision :UEDS:* @revision (file)"
8="Since :UEDS:* @since (file, section)"
9="License :UEDS:* @license (file)"
10="Link :UEDS:* @link (file)"
11="Lastmodified :UEDS:* @lastmodified (file)"
12="Media :UEDS:* @media (file, section)"
13="Site :UEDS:* @site (file)"
14="Style :UEDS:* @style (file)"
15="Appdef :UEDS:* @appdef (file)"
16="App :UEDS:* @app- (file; section)"
17="Colordef :UEDS:* @colordef (file; section)"
18="Note :UEDS:* @note (file, section, comment)"
19="Ref :UEDS:* @ref (section)"
20="Section :UEDS:* @section (section)"
21="See :UEDS:* @see (file, section)"
22="Tested :UEDS:* @tested (file, section, comment)"
23="ToDo :UEDS:* @todo (file, section, comment)"
24="Workaround :UEDS:* @workaround (section, comment)"
25="Bugfix :UEDS:* @bugfix (section, comment)"
26="Affected :UEDS:* @affected (section)"
27="CSS-for :UEDS:* @css-for (section)"
28="Valid :UEDS:* @valid (section)"
29=
bueltge.de [by:ltge.de] wird von Frank Bültge geführt, administriert und gestaltet. Alle Inhalte sind persönlich von mir ausgewählt und erstellt, nach bestem Gewissen und Können, was die Möglichkeit von Fehlern nicht ausschließt.
Das Weblog wird angetrieben von WordPress und aktuell gibt es 980 Beiträge, 18728 Kommentare in 14 Kategorien und 464 Tags.
Das Blog wird liebevoll mit xHTML & CSS in Handarbeit gestaltet. Erstellt mit ♥ zum Befüllen und Erhalten.
Design und Code ist unter Copyright
© 2001 - 2012 bueltge.de [by:ltge.de]
6. Dezember 2007 um 13:11
6. Dezember 2007 um 15:20
Hallo Frank,
tolles Feedback zu CSSDOC. Vielen Dank dafür.
Beste Grüße
Dirk
6. Dezember 2007 um 15:27
Ich habe zu danken.
Es wissen nicht viele Leute die Arbeit zu schätzen, vor allem wenn sie, wie bei dir und auch mir, ausschließlich in der Freizeit entsteht, neben Nicht-WWW-Hobbys und Familie.
Alles Gute
Frank
6. Dezember 2007 um 22:56
Interessantes Thema. Ich habe vor einigen Wochen den Technikwürze-Podcast zu diesem Thema schon sehr interessiert verfolgt. Ich denke, damit werde ich mich künftig auch mal etwas näher befassen.
7. Juli 2010 um 09:17
Ein wirklich schöner Beitrag. Und danke für das Template. Ich nutze zwar auch UltraEdit, fahre aber seit geraumer Zeit mit dem phpDesigner weit mehr und effizienter. Ich werde mir nunmehr eine Lösung suchen, das von Dir eingebrachte Template in meine IDE zu integrieren. CSSDOC nutze ich seit einiger Zeit. Früher hatte ich mal Aptana genutzt und dort vom highresolution Blog die CSSDOC-Snippets integriert. Aber mit Aptana werde ich mittlerweile einfach nicht mehr warm. Daher brauche ich eine adäquate Lösung für die von mir genutzte IDE.
Und CSSDOC sollte zum Standard werden. Gibt es doch seit einer Ewigkeit die Möglichkeit automatisiert Kommentare, respektive Dokumentationen von Java- (JavaDoc) und php-Projekten (phpDoc) zu erstellen. Ich hoffe, es gibt diese Möglichkeit eines Tages und ich hoffe, dass das automatisierte Verarbeiten der CSS Kommentare mit CSSTidy machbar wird.
Danke und Grüße aus Braunschweig