summaryrefslogtreecommitdiffstats
path: root/src/doc
diff options
context:
space:
mode:
Diffstat (limited to 'src/doc')
-rw-r--r--src/doc/README-fr87
-rw-r--r--src/doc/THEMEOPTIONS100
2 files changed, 148 insertions, 39 deletions
diff --git a/src/doc/README-fr b/src/doc/README-fr
new file mode 100644
index 0000000..e5f0041
--- /dev/null
+++ b/src/doc/README-fr
@@ -0,0 +1,87 @@
+Va chercher bonheur ici:
+
+- https://dawidlinux.pagesperso-orange.fr/libres_fichiers/tuto-ksplash.html
+
+
+Un "ksplash" est un écran de démarrage pour KDE.
+Pour charger un ksplash, on utilise tout simplement le panneau de
+configuration de KDE : kcontrol (voir la figure ci-contre).
+
+
+Les "ksplashes" se présentent sous la forme d'une archive tgz contenant:
+
+
+les fichiers
+============
+
+- Preview.png : une prévisualisation de l'écran KDE.
+ C'est cette image qui apparaît dans la rubrique de
+ kcontrol et qui permet de faire son choix.
+
+- splash_active_bar.png et splash_inactive_bar.png : des barres d'icônes
+ qui apparaissent en bas de l'image principale.
+
+- splash_top.png : l'image principale.
+
+- splash_bottom.png : une petite bande qui apparaît en bas du ksplash.
+
+- Theme.rc : un fichier texte de configuration du ksplash.
+
+Pour créer un ksplash, il suffit de reproduire cette structure.
+
+
+les images
+==========
+
+Il n'y a pas de contrainte particulière pour l'image Preview.png.
+
+L'image splash_top.png doit avoir une largeur de 400 pixels. Sa hauteur
+est libre.
+
+L'image splash_active_bar.png se compose d'une bande de 7 icônes,
+d'une longueur totale de 400 pixels (ce qui donne ~ 57 pixels par icône).
+
+On obtient l'image splash_inactive_bar.png en modifiant l'image
+précédente avec Gimp.
+
+Il n'y a pas de contrainte sur l'image splash_bottom.png à part sa
+largeur qui doit être de 400 pixels.
+
+
+fichier de configuration: Theme.rc
+==================================
+
+- fratales : c'est le nom du ksplash. Il faut obligatoirement que
+ l'archive tgz porte le même nom.
+
+- Engine : Avec l'option « Default », on crée un ksplash tel que défini
+ plus haut. Les autres options sont « Redmond » et « Standard ».
+
+- Icons Flashing : réglé à « true » améliore l'animation.
+
+NB: Il est possible de faire apparaître un messages.
+
+
+Exemple : Theme.rc
+==================
+
+[KSplash Theme: fractales]
+Name = Fratal theme
+Description = Fratales KDE theme realise avec les logiciels libres Xaos et Gimp.
+Version = 1.0
+Author = Dawid
+Homepage = http://perso.wanadoo.fr/dawidlinux/libre.html
+
+# Theme behavior settings.
+Engine = Default
+
+# Should icons blink ala KDE, or not?
+Icons Flashing = true
+
+# Configurable Messages. You may specify messages in as many
+# languages as you prefer. Messages may be copied verbatim from
+# this file, if you wish to maintain the default settings.
+Message1 = Pas mal non ?
+#Message1[es] = Por favor espere, iniciando KDE...
+#Message2 = Loading...
+#Message2[es] = Cargando..
diff --git a/src/doc/THEMEOPTIONS b/src/doc/THEMEOPTIONS
index 2ca2309..cde54d9 100644
--- a/src/doc/THEMEOPTIONS
+++ b/src/doc/THEMEOPTIONS
@@ -5,42 +5,64 @@ Theme.rc Options Type Default
X ^= Number from 1 to 8 (Labels are limited by "Labels" option)
-- General
-Background <filename> Search order: <given>.png, Background-<width>x<height>.png, Background.png
-UsersBackground <boolean> false (use the wallpaper of the current desktop)
-BaseResolution <width,height> 1280x1024 (the resolution was designed in -> NECCESSARY for auto scaling)
-SplashRect <x,y,w,h> screen size (sullscreen)
-
-- Labels
-Labels <num> 0
-LabelX <text> X = No. (Use ML: as prefix for magiclabels, i.e.: ML:loginname (case insensetive))
-LabelColorX <color> ffffff
-LabelFontX <font> Trebuchet MS (i.e.: Arial,14,-1,0,5,50,0)
-LabelCoordsX <x,y> centered
-StatusMessageX <text> passed by ksplash
-StatusColor <color> ffffff (White)
-StatusFont <font> Trebuchet MS
-StatusPosition <x,y> 50,50
-LabelShadow <boolean> true
-LabelShadowColor <color> 6d6d6d (dark gray)
-LabelShadowOffset <x,y> 2,2
-ShowStatusText <boolean> true
-Translate <boolean> true (i18n i.e.: Welcome (en) -> Willkommen (de))
-
-- Images
-AnimationLength <number> 30 (fading steps)
-AnimationDelay <number> 30 (delay between steps in milliseconds)
-BeginOpacity <number> 0.2 (value between 0 an 1)
-UseIconSet <boolean> true (use current icon set instead of 1.png, 2.png, ... (see below))
-IconSetSize <number> 48 (size of icons)
-ImageX <filename> if UseIconSet is true, you can override single icons (or all) by just giving
- their name. they need not to be in the theme directory!
- if UseIconSet is false, the engine searches for 1.png to 8.png by default
- but you can also override the image names
-
-- Image Arrangement (currently a little hard to explain, just play :))
-AppendX <boolean> true => horizontal (follow direction type) X is not a number here!
-ImageSpacer <number> if UseIconSet its IconSetSize otherwise 0 (used for auto arrangement with AppendX and -1 values)
-ImageCoordsX <x,y> -1,-1 (center vert. and horiz.)
-ImageOffset <x,y> 0,0 (move images i.e. if they have unknown positions (have a look at MoodinKDE)
-LineUpImages <boolean> false (if true, icons are aligned center (See MoodinKDE))
+General
+=======
+
+- Background <filename> Search order: <given>.png, Background-<width>x<height>.png, Background.png
+- UsersBackground <boolean> false (use the wallpaper of the current desktop)
+- BaseResolution <width,height> 1280x1024 (the resolution was designed in -> NECCESSARY for auto scaling)
+- SplashRect <x,y,w,h> screen size (sullscreen)
+
+
+Labels
+======
+
+- Labels <num> 0
+- LabelX <text> X = No. (Use ML: as prefix for magiclabels, i.e.: ML:loginname (case insensetive))
+- LabelColorX <color> ffffff
+- LabelFontX <font> Trebuchet MS (i.e.: Arial,14,-1,0,5,50,0)
+- LabelCoordsX <x,y> centered
+- StatusMessageX <text> passed by ksplash
+- StatusColor <color> ffffff (White)
+- StatusFont <font> Trebuchet MS
+- StatusPosition <x,y> 50,50
+- LabelShadow <boolean> true
+- LabelShadowColor <color> 6d6d6d (dark gray)
+- LabelShadowOffset <x,y> 2,2
+- ShowStatusText <boolean> true
+- Translate <boolean> true (i18n i.e.: Welcome (en) -> Willkommen (de))
+
+
+Images
+======
+
+- AnimationLength <number> 30 (fading steps)
+- AnimationDelay <number> 30 (delay between steps in milliseconds)
+- BeginOpacity <number> 0.2 (value between 0 an 1)
+- UseIconSet <boolean> true (use current icon set instead of 1.png, 2.png, ... (see below))
+- IconSetSize <number> 48 (size of icons)
+- ImageX <filename> if UseIconSet is true, you can override single icons (or all) by just giving
+ their name. they need not to be in the theme directory!
+ if UseIconSet is false, the engine searches for 1.png to 8.png by default
+ but you can also override the image names
+- ImageWidth <number> 100 (width of each icon/image)
+- ImageHeight <number> 100 (height of each icon/image)
+
+
+Image Arrangement (currently a little hard to explain, just play)
+=================
+
+- AppendX <boolean> true => horizontal (follow direction type) X is not a number here!
+- ImageSpacer <number> if UseIconSet its IconSetSize otherwise 0 (used for auto arrangement with AppendX and -1 values)
+- ImageCoordsX <x,y> -1,-1 (center vert. and horiz.)
+- ImageOffset <x,y> 0,0 (move images i.e. if they have unknown positions (have a look at MoodinKDE)
+- LineUpImages <boolean> false (if true, icons are aligned center (See MoodinKDE))
+
+
+Text
+====
+
+- WelcomeText <text> EG: i18n("Welcome")
+- WelcomeFont <font> EG: Trebuchet MS
+- StatusFont <font> EG: Trebuchet MS
+- TextColor <color> EG: ffffff (White)