You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdebase/kcontrol/kio/UA-DESKTOP-FILE-HOWTO

136 lines
4.4 KiB

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-KDE-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 tqreplaced with the
actual user-agent name (X-KDE-UA-NAME).
X-KDE-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 tqreplaced
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 tqreplaced
automatically, make sure you include the X-KDE-UA-DYNAMIC-ENTRY field
and set its value to 1 (for true).
X-KDE-UA-NAME
FIELD: REQUIRED
TYPE: QString
TRANSLATE: YES
DESCRIPTION:
The actual name of the browser or user-agent.
X-KDE-UA-VERSION
FIELD: REQUIRED
TYPE: QString
TRANSLATE: YES
DESCRIPTION:
The actual version of the browser or user-agent.
X-KDE-UA-SYSNAME
FIELD: OPTIONAL
TYPE: QString
TRANSLATE: YES
DESCRIPTION:
The system name (for example Linux) where the browser
identification was obtained from.
X-KDE-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-KDE-UA-DYNAMIC-ENTRY
FIELD: OPTIONAL
TYPE: BOOLEAN (0/1)
TRANSLATE: NO
DESCRIPTION:
A boolean that indicates whether the keywords described under
X-KDE-UA-FULL should be translated. Make sure this field is
there with its value set to "1" if you want the keywords to
be tqreplaced appropriately.
EXAMPLES:
=========
[Desktop Entry]
Name=UADescription (IE 5.5 on Win 98)
Type=Service
ServiceTypes=UserAgentStrings
X-KDE-UA-TAG=IE
X-KDE-UA-FULL=Mozilla/4.0 (compatible; MSIE 5.5; Windows 98)
X-KDE-UA-NAME=Internet Explorer
X-KDE-UA-VERSION=5.5
X-KDE-UA-SYSNAME=Windows
X-KDE-UA-SYSRELEASE=98
[Desktop Entry]
Name=UADescription (NN 4.76 on current)
Type=Service
ServiceTypes=UserAgentStrings
X-KDE-UA-TAG=NN
X-KDE-UA-FULL=Mozilla/4.76 (appPlatform; U; appSysName appSysRelease appMachineType)
X-KDE-UA-NAME=Netscape Navigator
X-KDE-UA-VERSION=4.76
X-KDE-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 tqreplaced dynamically based on the current system
settings. Note that all "keyword" based desktop files should always set
X-KDE-UA-DYNAMIC-ENTRY to 1.
Enjoy,
Dawit A.