styles/.dir.info
author Claus Gittinger <cg@exept.de>
Tue, 08 Sep 1998 12:04:14 +0200
changeset 2306 a7e674281291
parent 309 8cc4d0e7b41b
child 2567 08de56108ad5
permissions -rw-r--r--
*** empty log message ***
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     1
You may think this is too heavy ... 
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     2
... but I love those styles ;-)
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     3
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     4
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     5
This directory contains various style sheets which are read
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     6
and used when the view style is changed (via View>>defaultStyle:).
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     7
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     8
Look into generic.style, to see which parameters can be changed
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
     9
and how they are named.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    10
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    11
There are still some places in the system, where style information is
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    12
programmed into (instead of controlled via the StyleSheet) - but these
2306
a7e674281291 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 309
diff changeset
    13
will be removed over time (these are historical leftovers).
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    14
So be prepared, that some things are not fully working.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    15
2306
a7e674281291 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 309
diff changeset
    16
Do not modify the original style files - but instead create your own.
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    17
Styles are read using the same path mechanism as all other file accesses,
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    18
so you can put your private style-files into your private directories,
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    19
even in case a public file exists with the same name.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    20
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    21
You can inherit other styles via a #include - see 'motifXXX.style' as
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    22
an example.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    23
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    24
To get your new style, perform the following steps:
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    25
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    26
	1. create a styleSheet, say 'foo.style'
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    27
	   (take any existing to start with and see 'generic.style'
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    28
	    for more comments)
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    29
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    30
	2. make sure its accessable under any 'resources' directory
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    31
	   of your systemPath.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    32
	   (for the development environment, there is a rule 'make styles'
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    33
	    in the 'projects/smalltalk/Makefile', which symlinks all styles
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    34
	    to the local directory).
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    35
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    36
	3. check it by evaluating: 'View defaultStyle:#foo' in
309
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    37
	   a workspace (or change the style setting in the Launcher)
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    38
	 . Try some NEW views 
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    39
	   (the new style will affect only new views).
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    40
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    41
	   Notice, that the styleSheet is only re-read if the style
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    42
	   has changed (the contents is cached to avoid reading the style
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    43
	   files over and over again). Thus, to get an updated styleSheet to be 
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    44
	   used, either switch temporary to another style and back, or
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    45
	   use 'View updateAllStyleCaches' to force rereading of the current 
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    46
	   style.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    47
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    48
	4. if your style is ok and you want it to become your default at startup,
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    49
	   add the above line (View defaultStyle:#foo) to your 'private.rc' file.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    50
	   It will then be automatically installed at startup time.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    51
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    52
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    53
A note on the existing styles:
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    54
309
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    55
    Most are included as demo and to give you a starting point.
2306
a7e674281291 *** empty log message ***
Claus Gittinger <cg@exept.de>
parents: 309
diff changeset
    56
    Many are not really usable for ergonomic reasons.
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    57
    You may want to try your own, by combining features from different styles.
309
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    58
    For example, if you think the #st80-style may look good combined with green-background
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    59
    text-selection hilighting; go ahead and create your own.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    60
309
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    61
Disclaimer:
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    62
    It is neither intended, nor do I claim, that these styleSheets mimic the 
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    63
    originals exactly, they are included for fun and to make your ST/X views
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    64
    integrate better into whatever your environment may look like.
309
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    65
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    66
    You may improve them and send me back your updated files ....
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    67
    ... that way, the next release will have more and/ore better styleSheets.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    68
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    69
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    70
    No, I do not intent to extent this mechanism the Xt way, where every
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    71
    individual component can be specified ... (actually, I do not like it).
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    72
    It could be easily done, by reading the Xresource files (a naming hierarchy
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    73
    is already present in the views). But it either tends to make
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    74
    your display look very ugly and colorful, or it is not used by serious
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    75
    users. So what ?
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    76
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    77
    Most users prefer simple (unspectacular) styles; the most attractive being
309
8cc4d0e7b41b germanism
Claus Gittinger <cg@exept.de>
parents: 204
diff changeset
    78
    the iris, motif, os2 and normal (for monochrome displays) styles.
204
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    79
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    80
TODO:
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    81
    The new ViewStyle supports entries of the form:
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    82
	className.styleVariable ...
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    83
    which makes the whole style definition easier to understand,
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    84
    and allows the style-code to be simplified.
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    85
    The style sheets will be changed till the next version to reflect
c19f4be7f2ca Initial revision
Claus Gittinger <cg@exept.de>
parents:
diff changeset
    86
    this. Be prepared for this.