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 * 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 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