r3wp [groups: 83 posts: 189283]
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r3wp

[Script Library] REBOL.org: Script library and Mailing list archive

Sunanda
1-May-2007
[527]
Gabriel -- Thanks....A word list sounds a good way to go.
***

Jean-Francois -- a hover-over on kewords is certainly do-able and 
could look fun for the first couple of minutes on colorised scripts. 
Though it has drawbacks:
** it'd just about double the size of the page

** I think I'd be serious annoyed by it after 30 seconds -- though 
that may just be me

** lots of hidden-by-css styles (that's the way I'd do it, usng some 
of Eric Meyer's clevernesses) could create confusion for anyone using 
an elderly web browser or screen reader.


A good step in the right direction would be better styles for the 
code as we display it now.....So anyone experimenting with that is 
doing us all a great service ... Amd it would pave the way by creating 
a better foundation for higher cleverness.
Jean-François
1-May-2007
[528]
Gabriele, That is great !

I hadn't noticed the extra info poping up. Just that simple extra 
info is very helpful when inspecting/reading code (well for me anyway). 
Thank you.

The fact I hadn't noticed it might be a counter argument to Sunanda's 
fear of being annoyed by it. You really have to leave your pointer 
on it.


Any new language (natural or artificial) feels like "Scriptio continua" 
( http://en.wikipedia.org/wiki/Scriptio_continua) 

at first and all these visual cues are very helpfull in building 
the program's tree in your mind.


Imagine yourself a beginner at german reading a text that would have 
been colorized to accentuate its different elements. Hovering over 
a colored word would give you a translation or even maybe just a 
picture to prevent you from thinking in your first language.
Geomol
29-May-2007
[529x2]
I got some time to look at the CSS style sheet for displaying script 
code, Jean-Franois asked for. Where is the CSS located?
Is it the look of the code in this document: http://www.colellachiara.com/soft/PDFM2/pdf-maker.html
that is asked for?
Sunanda
29-May-2007
[531]
The personalised CSS feature starts here:
http://www.rebol.org/cgi-bin/cgiwrap/rebol/css-available.r

Use the menu bar to explore the options [Preview page · Update · 
View system CSS · Switch to system CSS · CSS help]
Have fun!
Geomol
29-May-2007
[532x2]
Does anyone have an opinion on what colors to use in syntax highlighting? 
The color-code.r script by Carl produce these colors: http://home.tiscali.dk/john.niclasen/rebol/color-test.html
This is how vim color REBOL code: http://home.tiscali.dk/john.niclasen/rebol/color-test-vim.html
Gregg
29-May-2007
[534]
Can't seem to hit those John.
Jean-François
30-May-2007
[535]
That's great Geomol.
Yes the pdf-maker docs are a good example.
I would stick with gabriele's color for a start.
Geomol
30-May-2007
[536x2]
Gregg, the Tiscali server (or network) was a bit slow last night. 
Try the links again, if you had trouble.
You guys can also think about, how many different colors are needed 
(preferred), when displaying REBOL source. A color for comments, 
values, datatypes, words, etc. Should values be split into numeric 
values, series and others with each their color. Other things?
ICarii
30-May-2007
[538]
personally id go for minimalist hilighting with colouring only for 
comments and strings - any more than that and it starts to look like 
a fairground -)
Geomol
30-May-2007
[539]
I programmed in COBOL for many years without coloring. Then I started 
using vim, and I found, it looked weird with all those colors. After 
a while, I started to really like it, because it's so much easier 
to read the code. Colors make our brains look and distinguish components 
much better than words. I'm for colors. But they have to be balanced, 
so it doesn't hurt the eyes too much.
Sunanda
30-May-2007
[540]
So did !
The color styles used right now are here:
http://www.rebol.org/cgi-bin/cgiwrap/rebol/css-view-system.r
(search for colorizer)

We already (in effect) collapse some into the same color: like file! 
and email!  Perhaps url! should be the same color too.
btiffin
30-May-2007
[541]
One of my heroes, Chuck Moore found colour important enough to use 
it for

'meaning'.  He got rid of colons in ColorForth by using bluespace 
and redspace and
greenspace instead of just whitespace.
Sunanda
30-May-2007
[542]
Trouble with colour is that some people are colour blind.

For some of them (and therefore all of us) using [red/green] to mean 
[danger/safe] or [stop/go] is dangerous.

Which is why (at least where I live) green traffic lights have been 
slowly migrating towards bluey-green over the past couple of decades.
btiffin
30-May-2007
[543]
Good points.  And Charles had some trouble with 'printouts'.  :) 
 I stopped following
the progress quite a few years ago.
Volker
30-May-2007
[544]
can be diferent fonts too. IIRC he used 4 colors or so. or if nothing 
else helps some markup.
Gregg
30-May-2007
[545x2]
I prefer the color-code scheme over the VIM scheme (don't like the 
pink), but as long as it isn't too bright most anything should be 
OK. 


It would be interesting to do some research on using different rendering 
schemes for code, based on activity. For example, when writing and 
maintaining code, I like comments in gray, so they "fade out" a bit; 
but if you're reading code, in a Literate Programming sense, you 
probably want the prose to stand out and the code to be subordinate.
Or if you're looking for specific datatypes, have a hot-key that, 
when pressed, highlights them.
btiffin
30-May-2007
[547x5]
Weirdo
:)
I've thought that same thing a few times.  A "gork" button.
gork = grok
Sorry for clogging the channel...It must be the Hare Krishna rock 
band I've got playing

in the background while doing LibDesk2 design thinking...  I think 
LD2 might be
pretty cool.
Gregg
30-May-2007
[552]
Ooooh, a grok button. I like that.
Geomol
30-May-2007
[553x4]
Some syntax colors: http://www.fys.ku.dk/~niclasen/rebol/syntax-color.html

This is work in progress! First is colors for comments and values 
(as I suggest). Then colors from Carl's script color-code.r, then 
some named colors from REBOL, and last some JavaScript syntax colors, 
I found on the net.


Syntax colors for many languages seem to use green for comments. 
I prefer blue, so comments better stick out, also for people having 
trouble with red and green. Values being red seem to be widely used. 
I'll try to make an example of REBOL code with colors...
First example with test of colors: http://www.fys.ku.dk/~niclasen/rebol/example.html

My idea is to build an example, that satisfies the need. Then I look 
at implementation for the Library, so sources in the library can 
be viewed this way.


Maybe refinements shouldn't be that yellow!? Should background be 
a little gray like this? #f9f9f9 Or should it be white? The purple 
and blue might be a bit too bright compared to the red and green? 
Or should the red and green be brighter?
Also try select the text in the browser. What color does the different 
browsers and OSs use for highlighting text? Can the colored text 
still be seen, when it's selected?
OS X has a default palette of rather bright colors for highlighting 
to choose from, suggesting the text colors to be dark, so the text 
still can be read when selected.
Sunanda
30-May-2007
[557]
Nice set of subtle colours!

On my Win-based machine,  all selected text is the same colour....white 
text on dark blue (though that is configurable)
***

A thought: if instead of FONT tags  you could switch to CSS. Then 
your experiments could use the same class names as the Library. Implementing 
that as your personal CSS on REBOL.org would be trivial
Geomol
30-May-2007
[558]
Ok, I'll look at the Library class names. Thanks!
[unknown: 9]
30-May-2007
[559x2]
Very cool stuff John...
I have to say that comments should be light gray, a web common practice.
Geomol
30-May-2007
[561]
Yes, I'm trying that out with gray comments. A good idea. Should 
known words (the words REBOL deliver in system/words as default) 
be green or blue, now comments aint blue?
[unknown: 9]
30-May-2007
[562x3]
I find when I have to correlate something to colours or  patterns 
it is better to start with the patterns first.


Since there are really only a few colours people can distinguish 
against white (or black) we can just like them hour:

Black = Structure, brackets, etc.
Gray = Comments
Dark blue 
Light blue
Red 
Pink
Purple
Dark green
Light green
Brown
Orange
Yellow (perhaps)

More subtle colours cause confusion.  

You also have Bold and Italics to consider.

I would use these to show "new" items (bold).
Also, you can do white on colour (BG).
like them hour
 should have been "list them here" (yes, I'm insane!)
In general you want to have it such that if everything is good, there 
is little colour distinction.  

For example most everything is black, gray, and dark blue.


The stranger the colour, the stranger of something you are trying 
to pull off in code.  Red should mean the parser is totally confused 
for example.  Or that the code is not actually code, but something 
that looks like code but is actually data.  That type of things.
Geomol
30-May-2007
[565]
Comments could be italic. We're used to, that we can skip italics 
in text, I think.
Gregg
30-May-2007
[566x2]
In ConText, I use bold+blue for for branching and a few other important 
funcs (if, either, all, etc.), navy for other funcs, green for datatypes, 
red for numbers, dark red for strings, gray for comments; brackets 
are dark gray, but go black to show matching pairs when you're on 
one.
My thinking behind the bold+blue was driven by the concept of cyclomatic 
complexity (McCabe), and making things jump out that indicate complexity 
in code. I know if I see a lot of bold+blue stuff on the screen, 
I either need to think real hard, or rewrite it. :-)
Tomc
31-May-2007
[568x2]
the color scheme I use  has red for native/action/op blue for mezz 
/functions green for comments and more muted colors for other types
I  auto generate the  words so when a new rebol comes out I can notice 
if a word I happen to use already has a builtin purpose
Sunanda
31-May-2007
[570]
I see geomol has updated his personal CSS at the Library.....You 
can now look at any script using his set of colours and font effects...Much 
better than the system default!!
Example:

http://www.rebol.org/cgi-bin/cgiwrap/rebol/view-script.r?color=yes&script=acgiss.r&css=geomol

(just add css=geomol to *any* Library URL. Or set your CSS preference).

And anyone can play the game -- devise and publish your own CSS for 
script coloring or any other aspect of the Library:

http://www.rebol.org/cgi-bin/cgiwrap/rebol/boiler.r?display=css-help.html
Gregg
31-May-2007
[571]
Cool. I'll switch to John's CSS and post any thoughts.
Sunanda
2-Jun-2007
[572x2]
REBOL.org looks like it is down right now -- the whole ISP who host 
it seem dead too. (they've not been as reliable since they merged 
with another ISP).
Apolgies!

This has no effect on  REBOL.com or REBOL.net .... they are completely 
separate.
We're back!
Sorry, No idea why the outage.
Geomol
3-Jun-2007
[574]
Regarding my css "Suggested standard" in the Libarary, I think, the 
red for values is a bit too dark. Also the orange for refinements 
seem a bit too light.
btiffin
5-Jun-2007
[575]
Rebolek posted the 800th script to rebol.org...
Congratulations Boleslav.
Rebolek
5-Jun-2007
[576]
I said I was aiming for 800th one... ;)
So I had to quickly upload something ;)