[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    www/areas/usability/hig
From:       Frans Englich <frans.englich () telia ! com>
Date:       2004-08-19 1:15:37
Message-ID: 20040819011537.6AA3916AF5 () office ! kde ! org
[Download RAW message or body]

CVS commit by englich: 


Initial commit:  The revitalization of the KDE Human Interface Guidelines

This is the previous usability guidelines,
http://developer.kde.org/documentation/standards/kde/style/basics/

converted to Docbook XML 4.3, combined with a move to usability.kde.org. More \
detailed, this is what I'v done:

* Finished the Docbook'ing Lauri started. Since it seemed to be a html2docbook \
conversion, it was endless tables(with keycuts!) and typical abuse of <emphasis> 

* Forward ported changes from 2003-03-01, according to the logs

* Did not do any semantical changes. The closest I got was renaming titles in order \
to make it fit into the new structure, which is rebuilt(assuming there was one \
before) 

* Switched to XInclude instead of system entities

* Integrated it with KDE: Uses the PHP framework and hence the stylesheets. KDE icons \
were used for navigation and admonitions 


What is the purpose of this?

* Make it readable and attractive. The HIG will now have a proper layout and be one \
click away, instead of being a little monster stuffed away behind a menu 4-6(?) \
hierarchy

* The usual advantages of docbook: a breeze to maintain, accessibility support, \
proper PDF generation(not yet implemented) and markup power(footnotes, references \
etc). The Makefile and customization layer combined with sensible filenames and idS \
should further ease maintainance and lower the contribution treshold 


Problems?

The previous guide used heavily styled HTML tables to emulate the look of window \
menus. This is tricky to do, especially since the Docbook+PHP doesn't allow CSS. The \
real solution is to use screenshots.  For the GNOME HIG they have a fancy app that \
generates screenshots from Glade files. Considering the HIG could use an efficient \
way for producing screenshots(especially since we have a habit of changing style \
every minor), and that the i18n people generates screenshots for each language, \
someone should write a cool in-house app..


What remains to be done?

Next commit will be an readability edit(don't touch it until that's done), followed \
by a indent/polish.


CCMAIL: kde-usability@kde.org
CCMAIL: Lauri Watts <lauri@kde.org>
CCMAIL: kde-www@kde.org


Status:

Vendor Tag:	englich
Release Tags:	start
		
N www/areas/usability/hig/menu.inc
N www/areas/usability/hig/TODO
N www/areas/usability/hig/Makefile
N www/areas/usability/hig/README
N www/areas/usability/hig/index.php
N www/areas/usability/hig/helping_out.php
N www/areas/usability/hig/hig.inc
N www/areas/usability/hig/.cvsignore
N www/areas/usability/hig/src/kdehig.xml
N www/areas/usability/hig/src/menus.xml
N www/areas/usability/hig/src/dnd.xml
N www/areas/usability/hig/src/widgets.xml
N www/areas/usability/hig/src/principles.xml
N www/areas/usability/hig/src/system.xml
N www/areas/usability/hig/src/introduction.xml
N www/areas/usability/hig/src/input.xml
N www/areas/usability/hig/src/windows.xml
N www/areas/usability/hig/src/GUIDELINES
N www/areas/usability/hig/src/visual.xml
N www/areas/usability/hig/src/images/warning.png
N www/areas/usability/hig/src/images/dnd-overview.png
N www/areas/usability/hig/src/images/menus-standard-file-docoriented.png
N www/areas/usability/hig/src/images/note.png
N www/areas/usability/hig/src/images/introduction-conventions-knotes.png
N www/areas/usability/hig/src/images/windows-dialogs-simple-yesno.png
N www/areas/usability/hig/src/images/menus-widget.png
N www/areas/usability/hig/src/images/windows-dialogs-simple-save.png
N www/areas/usability/hig/src/images/windows-parts-content-msfind.png
N www/areas/usability/hig/src/images/important.png
N www/areas/usability/hig/src/images/tip.png
N www/areas/usability/hig/src/images/home.png
N www/areas/usability/hig/src/images/windows-dialogs-simple-delete.png
N www/areas/usability/hig/src/images/windows-sdi-usesdi-overview.png
N www/areas/usability/hig/src/images/windows-dialogs-simple-plain.png
N www/areas/usability/hig/src/images/windows-dialogs-simple-cancel.png
N www/areas/usability/hig/src/images/prev.png
N www/areas/usability/hig/src/images/up.png
N www/areas/usability/hig/src/images/next.png
N www/areas/usability/hig/src/images/caution.png
N www/areas/usability/hig/src/images/windows-parts-content-doccentric.png
N www/areas/usability/hig/src/images/windows-dialogs-simple-stop.png
N www/areas/usability/hig/current/windows-parts.php
N www/areas/usability/hig/current/menus-standard.php
N www/areas/usability/hig/current/menus.php
N www/areas/usability/hig/current/dnd.php
N www/areas/usability/hig/current/widgets-systray.php
N www/areas/usability/hig/current/windows-sdi.php
N www/areas/usability/hig/current/input-mouse.php
N www/areas/usability/hig/current/widgets.php
N www/areas/usability/hig/current/windows-dialogs.php
N www/areas/usability/hig/current/principles.php
N www/areas/usability/hig/current/visual-text.php
N www/areas/usability/hig/current/system.php
N www/areas/usability/hig/current/system-settings.php
N www/areas/usability/hig/current/input-keyboard.php
N www/areas/usability/hig/current/introduction.php
N www/areas/usability/hig/current/input.php
N www/areas/usability/hig/current/index.php
N www/areas/usability/hig/current/windows.php
N www/areas/usability/hig/current/ln-legalnotice.php
N www/areas/usability/hig/current/windows-size.php
N www/areas/usability/hig/current/dnd-drag.php
N www/areas/usability/hig/current/system-processes.php
N www/areas/usability/hig/current/introduction-conventions.php
N www/areas/usability/hig/current/menus-menubar.php
N www/areas/usability/hig/current/dnd-drop.php
N www/areas/usability/hig/current/visual.php
N www/areas/usability/hig/current/images/warning.png
N www/areas/usability/hig/current/images/dnd-overview.png
N www/areas/usability/hig/current/images/menus-standard-file-docoriented.png
N www/areas/usability/hig/current/images/note.png
N www/areas/usability/hig/current/images/introduction-conventions-knotes.png
N www/areas/usability/hig/current/images/windows-dialogs-simple-yesno.png
N www/areas/usability/hig/current/images/menus-widget.png
N www/areas/usability/hig/current/images/windows-dialogs-simple-save.png
N www/areas/usability/hig/current/images/windows-parts-content-msfind.png
N www/areas/usability/hig/current/images/important.png
N www/areas/usability/hig/current/images/tip.png
N www/areas/usability/hig/current/images/home.png
N www/areas/usability/hig/current/images/windows-dialogs-simple-delete.png
N www/areas/usability/hig/current/images/windows-sdi-usesdi-overview.png
N www/areas/usability/hig/current/images/windows-dialogs-simple-plain.png
N www/areas/usability/hig/current/images/windows-dialogs-simple-cancel.png
N www/areas/usability/hig/current/images/prev.png
N www/areas/usability/hig/current/images/up.png
N www/areas/usability/hig/current/images/next.png
N www/areas/usability/hig/current/images/caution.png
N www/areas/usability/hig/current/images/windows-parts-content-doccentric.png
N www/areas/usability/hig/current/images/windows-dialogs-simple-stop.png
N www/areas/usability/hig/stylesheets/xhtml.xsl
N www/areas/usability/hig/stylesheets/pdf.xsl
N www/areas/usability/hig/stylesheets/common.xsl

No conflicts created by this import


[prev in list] [next in list] [prev in thread] [next in thread]