Skip to content

Commit

Permalink
updated
Browse files Browse the repository at this point in the history
  • Loading branch information
dslmeinte committed Nov 8, 2011
1 parent 14a3d66 commit 5534277
Showing 1 changed file with 30 additions and 24 deletions.
54 changes: 30 additions & 24 deletions README
Original file line number Diff line number Diff line change
@@ -1,39 +1,45 @@
Two Eclipse plug-ins which provide editors for CSS3 and Less (http://lesscss.org/).

Requirements (i.e., developed on, not tested on anything else):
- Eclipse 3.7 (build ID: I20110613-1736)
- Xtext 2.0.1 (SR1) with ANTLR stuff
- Eclipse 3.7.1
- master: Xtext 2.0.1 (SR1) with ANTLR stuff
Xtext2_1: Xtext 2.1 with ANTLR

You'll find a ZIP with the Eclipse plug-in JARs in the Downloads section. Drop the
JARs into the 'dropins' (or 'plugins', if that doesn't work) directory in your
Eclipse installation directory and (re-)start your Eclipse.

Note that these are very much a work-in-progress. I aim to provide full implementations
for CSS3 and Less. Most work is in the CSS part as Less extends CSS but not by much...
which isn't to say those extensions aren't really useful - they are! In the end, I
also intend to implement the mapping of Less -> CSS. This is not particularly difficult,
just tedious in the face of all the details of CSS.
Main development branch is actually Xtext2_1, but I'll merge that one
to master from time to time. I just like to work with Xtext 2.1
better, mainly because of the Xtend2 version which has nicer closures.

Currently, the CSS3 plug-in doesn't really know all that much about CSS3 beyond some
core syntax, so don't expect it to know about specific HTML elements/types and CSS
properties, m'kay? By extension, the same goes for Less. I hope the syntax checking,
highlighting and minimal validation already provides some convenience.

If you're interested in helping to further develop this, fork at will. I have some specific
ideas on how to go from here, so don't expect me to always accept a pull request verbatim.
To give an idea, here's a rough TODO list:
You'll find ZIPs with the Eclipse plug-in JARs for both Xtext 2.0.1
and Xtext2.1 in the Downloads section. Drop the JARs into the
'dropins' (or 'plugins', if that doesn't work) directory in your
Eclipse installation directory and (re-)start your Eclipse.

- having unit tests would be a good idea ;-)
Note that these are very much a work-in-progress. I aim to provide
full implementations for CSS3 and Less. Most work is in the CSS part
as Less extends CSS but not by much... which isn't to say those
extensions aren't really useful - they are! In the end, I also intend
to implement the mapping of Less -> CSS. This is not particularly
difficult, just tedious in the face of all the details of CSS.

Currently, the CSS3 plug-in doesn't really know all that much about
CSS3 beyond some core syntax, so don't expect it to know about
specific HTML elements/types and CSS properties, m'kay? By extension,
the same goes for Less. I hope the syntax checking, highlighting and
minimal validation already provides some convenience.

If you're interested in helping to further develop this, fork at
will. I have some specific ideas on how to go from here, so don't
expect me to always accept a pull request verbatim. To give an idea,
here's a rough TODO list:

- having more unit tests would be a good idea ;-)
- full compliance with CSS3 lexical scanning
- full implementation of CSS3 validation (e.g., validating RGB literals)
- full implementation of CSS3 selector syntax
- full implementation of CSS3 validation (e.g., validating RGB literals) - mostly done, methinks
- full implementation of CSS3 property syntax, using single-shot DSL and generation of part of the grammar
- full implementation of remaining CSS3 stuff, e.g. namespaces, URI literals
- type system implementation for Less
- implementation of Less imports
- nicer syntax highlighting for both CSS and Less
- nice formatting for CSS (and Less)
- migration to Xtext 2.1 (after release)
- evaluation engine for Less (expressions)
- mapping of Less -> CSS (model-2-model transformation)
- builder integration of Less -> CSS, using serialization
Expand Down

0 comments on commit 5534277

Please sign in to comment.