diff options
Diffstat (limited to 'kcontrol/kio/UA-DESKTOP-FILE-HOWTO')
-rw-r--r-- | kcontrol/kio/UA-DESKTOP-FILE-HOWTO | 135 |
1 files changed, 0 insertions, 135 deletions
diff --git a/kcontrol/kio/UA-DESKTOP-FILE-HOWTO b/kcontrol/kio/UA-DESKTOP-FILE-HOWTO deleted file mode 100644 index a592d4b57..000000000 --- a/kcontrol/kio/UA-DESKTOP-FILE-HOWTO +++ /dev/null @@ -1,135 +0,0 @@ -Mini HOWTO create a "User-Agent" description file for KDE -========================================================= - -This mini HOWTO describes the procedure for creating a new user-agent -description file to extend the ones that come pre-packaged with KDE. -The purpose of a user agent description file is to fake or spoof sites -that refuse to render pages with the default KDE user-agent identification. - -In order to create new user-agent description files, simply follow the -normal desktop file specifications set by the "DESKTOP ENTRY STANDARD" -augmented with the following requirements: - -REQUIREMENTS: -============= -The following properties as defined by the DESKTOP ENTRY STANDARD -must be set as shown below: - -Name=UADescription (XXXX) -Type=Service -ServiceTypes=UserAgentStrings - -Though the (XXXX) value shown above can be any text, it is a good idea -to make it a short identification of the browser being emulated. However, -there is NO requirement on what the text should be. It can even be left -out. It is only meant to give people a quick idea which browser is being -emulated by your desktop file. - -NEW PROPERTIES: -=============== -X-TDE-UA-TAG -FIELD: REQUIRED -TYPE: QString -TRANSLATE: NO -DESCRIPTION: -An abbreviation of the actual browser-brand and is used -to group the entries whenever necessary. Currently there are 5 -approximations: IE, NN, MOZ, OP, MISC. These represent Internet -Explorer, Netscape Navigator, Mozilla, Opera and Miscellaneous -respectively. NOTE: you can enter any value here as it is just -a place holder that would be automatically replaced with the -actual user-agent name (X-TDE-UA-NAME). - -X-TDE-UA-FULL -FIELD: REQUIRED -TYPE: QString -TRANSLATE: NO -DESCRIPTION: -The full user-agent description that will be sent to the remote -site. It can contain the following keywords that would be replaced -with the appropriate value as defined by "uname": - -appSysName the name of the operating system (ex: Linux). -appPlatform the name of the platform. Currently hardcoded to "X11". -appLanguage the language values as set in the control panel (ex: en, en-US). -appSysRelease the version of the operating system (ex: 2.2.18). -appKDERelease the current release number as set by KDE (ex: 2.1.9 >=20010310). -appMachineType the processor or machine type (ex: i686). - -NOTE: if you use any of these values and want them to be replaced -automatically, make sure you include the X-TDE-UA-DYNAMIC-ENTRY field -and set its value to 1 (for true). - -X-TDE-UA-NAME -FIELD: REQUIRED -TYPE: QString -TRANSLATE: YES -DESCRIPTION: -The actual name of the browser or user-agent. - -X-TDE-UA-VERSION -FIELD: REQUIRED -TYPE: QString -TRANSLATE: YES -DESCRIPTION: -The actual version of the browser or user-agent. - -X-TDE-UA-SYSNAME -FIELD: OPTIONAL -TYPE: QString -TRANSLATE: YES -DESCRIPTION: -The system name (for example Linux) where the browser -identification was obtained from. - -X-TDE-UA-SYSRELEASE -FIELD: OPTIONAL -TYPE: QString -TRANSLATE: YES -DESCRIPTION: -The system version (for example 2.4.1) where the browser -identification was obtained from. - -X-TDE-UA-DYNAMIC-ENTRY -FIELD: OPTIONAL -TYPE: BOOLEAN (0/1) -TRANSLATE: NO -DESCRIPTION: -A boolean that indicates whether the keywords described under -X-TDE-UA-FULL should be translated. Make sure this field is -there with its value set to "1" if you want the keywords to -be replaced appropriately. - - -EXAMPLES: -========= -[Desktop Entry] -Name=UADescription (IE 5.5 on Win 98) -Type=Service -ServiceTypes=UserAgentStrings -X-TDE-UA-TAG=IE -X-TDE-UA-FULL=Mozilla/4.0 (compatible; MSIE 5.5; Windows 98) -X-TDE-UA-NAME=Internet Explorer -X-TDE-UA-VERSION=5.5 -X-TDE-UA-SYSNAME=Windows -X-TDE-UA-SYSRELEASE=98 - -[Desktop Entry] -Name=UADescription (NN 4.76 on current) -Type=Service -ServiceTypes=UserAgentStrings -X-TDE-UA-TAG=NN -X-TDE-UA-FULL=Mozilla/4.76 (appPlatform; U; appSysName appSysRelease appMachineType) -X-TDE-UA-NAME=Netscape Navigator -X-TDE-UA-VERSION=4.76 -X-TDE-UA-DYNAMIC-ENTRY=1 - -The first entry is a description file for Internet Explorer running on -a Windows 98 machine while the second one is an example of a description -file for Netscape browser using the "keyword" based approach to describe -the fields that should be replaced dynamically based on the current system -settings. Note that all "keyword" based desktop files should always set -X-TDE-UA-DYNAMIC-ENTRY to 1. - -Enjoy, -Dawit A. |