Development/Guidelines: Difference between revisions

From KDE TechBase
No edit summary
(Move old HIG guideline links to their own section)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar|Development/Guidelines}}
{{Template:I18n/Language Navigation Bar|Development/Guidelines}}
This section contains information about the industry and de facto standards KDE uses. The industry standards are ones that are used or implemented by KDE (for instance, we use the XML standard to write XML documents, and we implement the Window Manager Hint standard with KWin). KDE standards are the guidelines used internally, related to UI design and consistency. The section about [[Policies|policies]] also contains standards-like documents that relate to developer activity.
KDE standards are the guidelines used internally, related to UI design and consistency. The section about [[Policies|policies]] also contains standards-like documents that relate to developer activity.
 
== KDE Standards ==
; [http://wiki.openusability.org/guidelines/index.php/Main_Page KDE4 Human Interface Guidelines (KDE4 HIG)]
: The new KDE Human (was: User) Interface Guidelines for KDE 4.x. These guidelines are under construction, but should be your first reference (followed by checking the KDE3 User Interface Guidelines or asking questions on the usability mailinglist: [email protected]).
 
; [http://developer.kde.org/documentation/standards/kde/style/basics/index.html KDE3 User Interface Guidelines]
: The KDE User Interface Guidelines for 3.x.
 
; [http://developer.kde.org/documentation/design/ui/index.html KDE2 User Interface Guidelines]
: The KDE User Interface Guidelines for 2.x.


== Human Interface Guidelines ==
; [[Development/Guidelines/HCI/Checklists|Accessibility and Usability Checklists]]
; [[Development/Guidelines/HCI/Checklists|Accessibility and Usability Checklists]]
: Test your application for accessibility/usability along these checklists
: Test your application for accessibility/usability along these checklists
Line 20: Line 11:
; [[Projects/Plasma/PIG|Plasma Interface Guidelines (PIG)]]
; [[Projects/Plasma/PIG|Plasma Interface Guidelines (PIG)]]
: This document is a place to collect all the "do"s, "don't"s and "how to"s for interface elements in Plasma, particularly applets and plasmoids.
: This document is a place to collect all the "do"s, "don't"s and "how to"s for interface elements in Plasma, particularly applets and plasmoids.
=== Old Guidelines ===
The following links contain information that has not yet been been copied into the Human Interface Guidelines.
; [http://wiki.openusability.org/guidelines/index.php/Main_Page Draft: KDE4 Human Interface Guidelines (HIG)]
: A draft for KDE Human (was: User) Interface Guidelines for KDE 4.x. These guidelines are under construction, but should be your first reference (followed by checking the KDE3 User Interface Guidelines or asking questions on the usability mailinglist: [email protected]).
; [http://developer.kde.org/documentation/standards/kde/style/basics/index.html KDE3 User Interface Guidelines]
: The KDE User Interface Guidelines for 3.x.
; [http://developer.kde.org/documentation/design/ui/index.html KDE2 User Interface Guidelines]
: The KDE User Interface Guidelines for 2.x.


; [http://developer.kde.org/documentation/standards/kde/kcontrol_style/index.html KDE KControl Module Guidelines]
; [http://developer.kde.org/documentation/standards/kde/kcontrol_style/index.html KDE KControl Module Guidelines]
: Styleguide standards for KConfig Modules used in combination with KControl.
: Styleguide standards for KConfig Modules used in combination with KControl.


== External Standards ==
== Supported Standards ==
This section contains information about the industry and de facto standards used or implemented by KDE (for instance, we use the XML standard to write XML documents, and we implement the Window Manager Hint standard with KWin).
 
; [http://www.w3.org/XML XML]
; [http://www.w3.org/XML XML]
: The Extensible Markup language. KOffice's document formats are applications of this. It is also used as configuration file format by an increasing number of KDE programs.
: The Extensible Markup language. KOffice's document formats are applications of this. It is also used as configuration file format by an increasing number of KDE programs.

Revision as of 11:15, 12 August 2008


Development/Guidelines

KDE standards are the guidelines used internally, related to UI design and consistency. The section about policies also contains standards-like documents that relate to developer activity.

Human Interface Guidelines

Accessibility and Usability Checklists
Test your application for accessibility/usability along these checklists
Community Identity Guidelines (CIG)
Definitions and recommendations which help the KDE Project to establish a unique, characteristic, and appealing design.
Plasma Interface Guidelines (PIG)
This document is a place to collect all the "do"s, "don't"s and "how to"s for interface elements in Plasma, particularly applets and plasmoids.

Old Guidelines

The following links contain information that has not yet been been copied into the Human Interface Guidelines.

Draft: KDE4 Human Interface Guidelines (HIG)
A draft for KDE Human (was: User) Interface Guidelines for KDE 4.x. These guidelines are under construction, but should be your first reference (followed by checking the KDE3 User Interface Guidelines or asking questions on the usability mailinglist: [email protected]).
KDE3 User Interface Guidelines
The KDE User Interface Guidelines for 3.x.
KDE2 User Interface Guidelines
The KDE User Interface Guidelines for 2.x.
KDE KControl Module Guidelines
Styleguide standards for KConfig Modules used in combination with KControl.

Supported Standards

This section contains information about the industry and de facto standards used or implemented by KDE (for instance, we use the XML standard to write XML documents, and we implement the Window Manager Hint standard with KWin).

XML
The Extensible Markup language. KOffice's document formats are applications of this. It is also used as configuration file format by an increasing number of KDE programs.
DOM
The Document Object Model as defined by the W3C. Qt's QDom*classes are modeled after this.
XDND
The specification for the inter-application drag and drop protocol used by Qt and Gtk. Meanwhile, several other applications use it.
Extended Window Manager Hint Standard
Also called NETWM or EWMH, the protocol for window manager interaction, supported by many window manager authors.
Desktop Entry Specification
The format of .desktop files, supported by KDE.
Icon Naming Standard
The Freedesktop naming standard for icons, supported by KDE.
MIME types
Files types (as used to show appropriate icons in the file manager and to categorize data in drag & drop and clipboard operations) follow the convention known as MIME. Here you can find a list of registered content types.
URL
Uniform resource locators, defined by RFC 1738.
SM
The X11R6.4 session management protocol. This is the backend protocol for KMainWindow's high-level session management features.
iCalendar
RFC 2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). This is used to store KOrganizer and KTimeTracker (KArm in KDE < 4) data.