home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Linux / Enlightenment / enl_BETA-0.13.src.tar.gz / enl_BETA-0.13.src.tar / enl-0.13 / CONFIGURATION < prev    next >
Text File  |  1997-10-29  |  5KB  |  123 lines
  1. Now to all those who can't put 2 and 2 together from the readme.. here is a
  2. big speel about how E is configured via themeballs, and what exactly a
  3. themeball is. E comed out of the box wiht 2 themeballs in
  4. /usr/local/enlightenment/themes. you can shose any theme by:
  5. enlightenment -theme theme_ball_file
  6. by default if E is given NO theme to use.. it looks for a themeball called
  7. DEFAULT in /usr/local/enlightenment/themes (or wherever you installed
  8. Enlightenment)
  9.  
  10. A "themeball" can be on of 3 formats:
  11. a .tar.gz file
  12. a .tar file
  13. a directory containing the contents of the theme.. 
  14. so the tarball has the following contents:
  15.  
  16. if its a tar.gz themeball:
  17.  
  18. > tar ztf /usr/local/enlightenment/DEFAULT
  19. MAIN
  20. buttons
  21. cursors
  22. exec
  23. fx
  24. icons
  25. infobox
  26. menus
  27. pix/
  28. pix/icon_term_2.ppm
  29. pix/icon_term_1.ppm
  30. pix/icon_term_3.ppm
  31. etc.....
  32.  
  33. if its a vanilla tar themeball:
  34.  
  35. > tar tf /usr/local/enlightenment/DEFAULT
  36. MAIN
  37. buttons
  38. cursors
  39. exec
  40. fx
  41. icons
  42. infobox
  43. menus
  44. pix/
  45. pix/icon_term_2.ppm
  46. pix/icon_term_1.ppm
  47. pix/icon_term_3.ppm
  48. pix/iconbox_arrow1_1.ppm
  49. pix/iconbox_arrow2_1.ppm
  50. pix/iconbox_bg.ppm
  51. etc.
  52.  
  53. if it is a directoy themeball:
  54.  
  55. > ls
  56. /usr/local/enlightenment/themes/DEFAULTtotal 69
  57. 1 ./      1 cursors  2 infobox  2 status
  58. 1 ../     1 exec    27 menus    1 text
  59. 3 MAIN    1 fx       2 pix/    15 windowstyles
  60. 7 buttons 4 icons    1 root
  61.  
  62. its as simlpe as that! you can keep the themeball unzipped, but tarred
  63. for neatness, or keep it untarred in a directry.. or tarred and gzipped. Its 
  64. your choice. I distribute themeballs tarred & gzipped. If you ever make a 
  65. theme and want to release it.. the advantage is you can just release your 
  66. themeball as-is (tar & gzip up the direcoty, or just gzip yer theme tar.. or 
  67. just upload the .tar.gz themeball as is if u work on it in that fashion as i 
  68. do)... its that simple. E by default if not told to use a theme will first
  69. look for the DEFAULT themeball mentions above.. and the it looks for config 
  70. files in .enlightenemnt. the config files or data files in here should
  71. correspond to the equivalents in the theme (eg MAIN, buttons, or files like
  72. pix.button.ppm etc.). These override any of the corresponding files in the
  73. theme.. so a user can select hsi favorite theme stored on hsimachine.. and
  74. copy just the fiels he wishes to change from the default to his
  75. .enlightenment dir and edit them.. if he doesn like an icon.. just make a
  76. replacement in the same position in .enlightnement (like
  77. .enlightnement/pix/button.ppm will override the image pix/button.ppm in the
  78. theme). If E cant find a themeball it it tries 
  79. /usr/local/enlightenent/system_config as it did before for config files.. 
  80. these are not interpreted as themeball files.. but require full paths to 
  81. images.. these are last-resort config files setup by system admin if
  82. all-else fails.. if this fails.. E bails out and wont load.
  83.  
  84. Now I hope that clears it all up once and for all. I have given you all
  85. you need to make thngs like theme managers that run before E runs that
  86. can choose and manage installed and user owned themeballs.. and to
  87. select them etc. Thsi isnt E's task. the hooks are there. Use
  88. them. If a theme manager doesnt appear in the near future.. i prolly will write
  89. one myself.... this is where phase 2 for themeballs comes in:
  90.  
  91. a theme manager would, (liek E). look inside themeballs for lets say a
  92. certain file (called lets say for now THEME)... This is a text file that 
  93. maybe looks like this:
  94.  
  95. TITLE: Default Enlgihtenment Theme 
  96. RELEASE: Sat Jun 28 00:38:40 1997
  97. AUTHOR: The Rasterman
  98. LICENCE: COPYRIGHT 1997, GPL License
  99. DESCRIPTION: This is the default theme
  100. provided with Enlightenment. It
  101. isn't as fast or efficient as could be, but is designed to
  102. show off as many features of Enlightenment as possible.
  103. E-VERSION: Required Minimum - Enlightenment 1.0 Thebes DR-0.10
  104. BANNER: info/banner.ppm
  105. THUMBNAIL: info/thumbnail.ppm
  106.  
  107. that would be a sample file.. the theme manager would read and interpret. It 
  108. could provide a list of themes form a directory.. or a config file.. and from 
  109. this THEME info file display the title, author, description etc. in a gui... 
  110. and then also show a scaled down image fo a screenshot of the theme running 
  111. (the thumbanil) to give people an idea of what it looks like, and a banner 
  112. image to use as a title icon/banner/marker for the theme.
  113.  
  114. these files are created byt he theme maker basically to provide more info, 
  115. and to advertise themselves. This is my current idea.. but this isnt part of 
  116. Enlightenment directly. This would be the tast of a "helper" app.. like a 
  117. theme manager. Any of you buddign coders out there who knoe a decent amount 
  118. on how to code for X.. and maybe use imlib (you would need to to load up the 
  119. thumbnails and banner images at any rate..).. this could be a small good 
  120. project to start. :)
  121.  
  122. Now happy Playing with your new environment!
  123.