diff --git a/doc/config.html b/doc/config.html index 179ddf2d..20eb4f2d 100755 --- a/doc/config.html +++ b/doc/config.html @@ -94,7 +94,7 @@ via the '-p' command line flag. Specifies the root directory for ELOG resources like help files, themes, icons and user HTML files. Can be overwritten with the -s flag when starting elogd. If not specified, use the directory where the configuration file elogd.cfg resides. -Changing this option requires a restart of the elogd server. +Changing this option requires a restart of the elogd server.

  • Logbook dir = <directory> @@ -103,7 +103,7 @@ Specifies the root directory for logbooks. Can be overwritten with the starting elogd. If not specified, use the directory where the configuration file elogd.cfg resides. Each logbook data is stored in a separate directory under this root directory specified by the Subdir option. -Changing this option requires a restart of the elogd server. +Changing this option requires a restart of the elogd server.

  • Language = <name> @@ -241,7 +241,7 @@ The logbook tabs would then look like this:

    Where the selected group or logbook becomes blue. The lower groups/logbooks change according to the selected upper group. Please note that a logbook can be contained in more than one group, but then it should not be the first logbook in those groups. The colors of the tabs -and the title bar can be specified in the theme file.

    +and the title bar can be specified in the CSS file.

      Individual logbook options  
    @@ -300,13 +300,20 @@ It contains all files for that theme. The format of these files is described und the Themes section.

    -

  • Title BGColor = <color> -
  • Title Fontcolor = <color> +
  • CSS = <filename>
    -Determines the font and background colors of the title bar. Colors are specified -in the usual HTML format, like white, black, or #808080 for hexadecimal -RGB values. See here for more -examples. The title colors are also used for the currently selected logbook tab.

    +A given theme can contain several Cascading Style Sheets (CSS). This can be usefule +if several logbooks use the same images and icons, but differnt colors. By default, +the CSS default.css is used. This can be overwritten by this statement. +

    + +

  • Title image URL = <URL> +
    +The ELOG icon at the right upper corner usually points to the ELOG home page. This +URL can be changed to point to a corporate page for example with this option. The +icon can be changed by replacing the elog.gif icon in the +theme directory. +

  • Date format = <string>
    @@ -686,7 +693,7 @@ A typical example would be
  • Thread icon = <attribute>
    If a logbook uses some icons for an attribute, these icons can be displayed -in the search result page instead of the default icons defined in the themes.cfg file. +in the search result page instead of the default icons contained in the themes directory.

  • Subst <attribute> = <string> @@ -1084,19 +1091,30 @@ The default is 1.
      Themes  

    -Themes are layout and color schemes which determine the look and feel of a logbook. -Each theme resides in a separate subdirectory and is specified with the -theme = <dir> option in the configuration file. The directory -contains the file theme.cfg and a few images, which are used -for the title banner and the browse buttons. A default theme is contained in the -distribution. If new themes are developed by users, they can be sent back to the author, -to be included in future releases. +Themes are layout and color schemes which determine the look and feel of a logbook +(sometimes called "skins"). A theme +consists of a set of images, which are used for the title banner and browse buttons, and +a Cascading Style Scheet (CSS), which defines the colors, fonts and spacing of the ELOG pages.

    -Most of the options in the theme.cfg are self-explanatory. The colors -are coded as #RRGGBB, where RR is a 8-bit hexadecimal value for the red part, GG for the -green and BB for the blue part, repectively. Since theme configuration files are re-read -at each access, the elogd daemon does not have to be restarted after a change in the -theme configuration file. + +Each theme resides in a separate subdirectory and is specified with the +theme = <dir> option in the configuration file. Each theme can +contain several CSSs, which can be selected with the CSS = <filename> +option. +

    + +A default theme is contained in the distribution. If new themes are developed by users, +they can be sent back to the author, to be included in future releases. +

    + +To change colors and fonts, the source of a ELOG page can be examined. All elements use +CSS classes which are specified in the class="<name>" statements. +These classes can be found in the .../themes/default/default.css +file and changed accordingly. For a description of all options, please consult for example the +W3C consortium.

    + +If the CSS file is edited, most browsers require a "reload" to refresh the modified file. +The elogd daemon does not have to be restarted after a change in the DSS file.

    These two images display the same logbook entry using different themes: