From 8362bf63dea22bbf6736609b0f49c152f975eb63 Mon Sep 17 00:00:00 2001 From: tpearson Date: Wed, 20 Jan 2010 01:29:50 +0000 Subject: Added old abandoned KDE3 version of koffice git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/koffice@1077364 283d02a7-25f6-0310-bc7c-ecb5cbfe19da --- doc/.directory | 4 + doc/CookBook.odt | Bin 0 -> 19525 bytes doc/Makefile.am | 7 + doc/TODO | 2 + doc/api/Doxyfile.am | 153 ++ doc/api/Doxyfile.koffice | 191 ++ doc/api/doxyndex.sh | 60 + doc/api/header.html | 70 + doc/api/kfontdialog.png | Bin 0 -> 4909 bytes doc/api/mainheader.html | 71 + doc/karbon/Makefile.am | 4 + doc/karbon/index.docbook | 67 + doc/kchart/Makefile.am | 4 + doc/kchart/cr22-action-chart_line.png | Bin 0 -> 1310 bytes doc/kchart/cr22-action-data.png | Bin 0 -> 1328 bytes doc/kchart/cr22-action-options.png | Bin 0 -> 1348 bytes doc/kchart/cr22-action-wizard.png | Bin 0 -> 1216 bytes doc/kchart/file-toolbar.png | Bin 0 -> 2413 bytes doc/kchart/file-toolbar2.png | Bin 0 -> 2740 bytes doc/kchart/frame_chart.png | Bin 0 -> 1249 bytes doc/kchart/index.docbook | 1375 ++++++++++ doc/kchart/kchart-config1.png | Bin 0 -> 6879 bytes doc/kchart/kchart-config2.png | Bin 0 -> 10779 bytes doc/kchart/kchart-config3.png | Bin 0 -> 7417 bytes doc/kchart/kchart-config4.png | Bin 0 -> 12388 bytes doc/kchart/kchart-config5.png | Bin 0 -> 9827 bytes doc/kchart/kchart-config6.png | Bin 0 -> 8674 bytes doc/kchart/kchart-config7.png | Bin 0 -> 7291 bytes doc/kchart/kchart-config8.png | Bin 0 -> 9545 bytes doc/kchart/kchart-dataeditor.png | Bin 0 -> 7096 bytes doc/kchart/kchart-default.png | Bin 0 -> 13711 bytes doc/kchart/kchart-example1-1.png | Bin 0 -> 8638 bytes doc/kchart/kchart-example1-2.png | Bin 0 -> 8805 bytes doc/kchart/kchart-example1-3.png | Bin 0 -> 7418 bytes doc/kchart/kchart-example1-4.png | Bin 0 -> 10943 bytes doc/kchart/kchart-example1-5.png | Bin 0 -> 8262 bytes doc/kchart/kchart-example1-6.png | Bin 0 -> 7376 bytes doc/kchart/kchart-example1-7.png | Bin 0 -> 11137 bytes doc/kchart/kchart-example1-8.png | Bin 0 -> 8169 bytes doc/kchart/kchart-example1-9.png | Bin 0 -> 13167 bytes doc/kchart/kchart-kspread-bar.png | Bin 0 -> 4681 bytes doc/kchart/kchart-kspread.png | Bin 0 -> 5242 bytes doc/kchart/kchart-startupdialog.png | Bin 0 -> 12477 bytes doc/kchart/kchart-wizard0.png | Bin 0 -> 6671 bytes doc/kchart/kchart-wizard1.png | Bin 0 -> 9392 bytes doc/kchart/kchart-wizard2.png | Bin 0 -> 5494 bytes doc/kchart/kchart-wizard3.png | Bin 0 -> 5401 bytes doc/kchart/kchart-wizard4.png | Bin 0 -> 6828 bytes doc/kchart/shortcut.png | Bin 0 -> 17045 bytes doc/kchart/toolbars.png | Bin 0 -> 13879 bytes doc/kexi/Makefile.am | 4 + doc/kexi/basics.docbook | 504 ++++ doc/kexi/building.docbook | 248 ++ doc/kexi/comparing.docbook | 98 + doc/kexi/configuration.docbook | 230 ++ doc/kexi/contact-example.png | Bin 0 -> 2392 bytes doc/kexi/credits.docbook | 63 + doc/kexi/database.docbook | 649 +++++ doc/kexi/designingforms.docbook | 1480 +++++++++++ doc/kexi/enteringdataintotables.docbook | 130 + doc/kexi/enteringdatausingforms.docbook | 33 + doc/kexi/index.docbook | 122 + doc/kexi/intro.docbook | 78 + doc/kexi/menus.docbook | 701 ++++++ doc/kexi/querydesigning.docbook | 109 + doc/kformula/Makefile.am | 4 + doc/kformula/ambiguous-string.png | Bin 0 -> 8692 bytes doc/kformula/correct_index_location.png | Bin 0 -> 1185 bytes doc/kformula/definite_integral.png | Bin 0 -> 1930 bytes doc/kformula/file-toolbar.png | Bin 0 -> 2365 bytes doc/kformula/file-toolbar2.png | Bin 0 -> 2704 bytes doc/kformula/green1.png | Bin 0 -> 9799 bytes doc/kformula/green2.png | Bin 0 -> 6119 bytes doc/kformula/greens.png | Bin 0 -> 2112 bytes doc/kformula/incorrect_index_location.png | Bin 0 -> 1244 bytes doc/kformula/index.docbook | 1246 ++++++++++ doc/kformula/index_smear.png | Bin 0 -> 1173 bytes doc/kformula/kfontinst1.png | Bin 0 -> 19070 bytes doc/kformula/kfontinst2.png | Bin 0 -> 25568 bytes doc/kformula/kfontinst3.png | Bin 0 -> 10377 bytes doc/kformula/kfontinst4.png | Bin 0 -> 10380 bytes doc/kformula/kfontinst5.png | Bin 0 -> 5000 bytes doc/kformula/kfontinst6.png | Bin 0 -> 6514 bytes doc/kformula/lower-index.png | Bin 0 -> 1182 bytes doc/kformula/matrix-view.png | Bin 0 -> 1340 bytes doc/kformula/matrix.png | Bin 0 -> 187 bytes doc/kformula/negative_thin_space.png | Bin 0 -> 874 bytes doc/kformula/path-integral.png | Bin 0 -> 279 bytes doc/kformula/rk-edit0.png | Bin 0 -> 3135 bytes doc/kformula/rk-edit1.png | Bin 0 -> 3070 bytes doc/kformula/rk-edit2.png | Bin 0 -> 9581 bytes doc/kformula/scilab-edit.png | Bin 0 -> 3410 bytes doc/kformula/scilab.png | Bin 0 -> 6012 bytes doc/kformula/shortcut0.png | Bin 0 -> 6901 bytes doc/kformula/shortcut1.png | Bin 0 -> 3881 bytes doc/kformula/sin.png | Bin 0 -> 1989 bytes doc/kformula/toolbars.png | Bin 0 -> 9201 bytes doc/kformula/upper-index.png | Bin 0 -> 1216 bytes doc/kivio/Makefile.am | 4 + doc/kivio/credits.docbook | 64 + doc/kivio/index.docbook | 64 + doc/kivio/introduction.docbook | 33 + doc/kivio/usage.docbook | 203 ++ doc/kivio/working.docbook | 212 ++ doc/koffice.desktop | 8 + doc/koffice/Makefile.am | 4 + doc/koffice/index.docbook | 855 +++++++ doc/koshell/Makefile.am | 4 + doc/koshell/index.docbook | 507 ++++ doc/koshell/koshell1.png | Bin 0 -> 16939 bytes doc/koshell/main-view.png | Bin 0 -> 36377 bytes doc/koshell/new-dialog.png | Bin 0 -> 11507 bytes doc/koshell/side-pane.png | Bin 0 -> 10422 bytes doc/kplato/Makefile.am | 4 + doc/kplato/commands.docbook | 566 +++++ doc/kplato/configure-wbs.png | Bin 0 -> 4234 bytes doc/kplato/configure1.png | Bin 0 -> 6109 bytes doc/kplato/configure2.1.png | Bin 0 -> 3405 bytes doc/kplato/configure2.png | Bin 0 -> 6887 bytes doc/kplato/definitions.docbook | 228 ++ doc/kplato/edit-accounts.png | Bin 0 -> 4069 bytes doc/kplato/edit-accounts1.png | Bin 0 -> 4340 bytes doc/kplato/edit-calendar.png | Bin 0 -> 7933 bytes doc/kplato/edit-calendar1.png | Bin 0 -> 8609 bytes doc/kplato/edit-calendar2.png | Bin 0 -> 8913 bytes doc/kplato/edit-resources.png | Bin 0 -> 4233 bytes doc/kplato/edit-resources1.png | Bin 0 -> 5484 bytes doc/kplato/edit-worktime.png | Bin 0 -> 3272 bytes doc/kplato/index.docbook | 131 + doc/kplato/mainwindow.docbook | 53 + doc/kplato/mainwindow1.png | Bin 0 -> 16866 bytes doc/kplato/options.docbook | 366 +++ doc/kplato/project-settings.png | Bin 0 -> 5462 bytes doc/kplato/wbs.docbook | 139 ++ doc/kplato/wbs.png | Bin 0 -> 3804 bytes doc/kplato/wbs1.png | Bin 0 -> 8790 bytes doc/kplato/wbs2.png | Bin 0 -> 2897 bytes doc/kplato/wbs3.png | Bin 0 -> 5113 bytes doc/kpresenter/Makefile.am | 4 + doc/kpresenter/a11y.docbook | 321 +++ doc/kpresenter/autocorrection1.png | Bin 0 -> 12095 bytes doc/kpresenter/autocorrection2.png | Bin 0 -> 6483 bytes doc/kpresenter/autocorrection3.png | Bin 0 -> 10964 bytes doc/kpresenter/autocorrection4.png | Bin 0 -> 9229 bytes doc/kpresenter/barstyle1.png | Bin 0 -> 9674 bytes doc/kpresenter/barstyle3.png | Bin 0 -> 14522 bytes doc/kpresenter/barstyle4.png | Bin 0 -> 12620 bytes doc/kpresenter/barstyle5.png | Bin 0 -> 9889 bytes doc/kpresenter/barstyle6.png | Bin 0 -> 2936 bytes doc/kpresenter/barstyle7.png | Bin 0 -> 9007 bytes doc/kpresenter/break.png | Bin 0 -> 1227 bytes doc/kpresenter/changeformat.png | Bin 0 -> 8917 bytes doc/kpresenter/completion.png | Bin 0 -> 9987 bytes doc/kpresenter/configure1.png | Bin 0 -> 11508 bytes doc/kpresenter/configure2.png | Bin 0 -> 10415 bytes doc/kpresenter/configure3.png | Bin 0 -> 12892 bytes doc/kpresenter/configure4.png | Bin 0 -> 12907 bytes doc/kpresenter/configure4a.png | Bin 0 -> 1546 bytes doc/kpresenter/configure4a1.png | Bin 0 -> 1550 bytes doc/kpresenter/configure4b.png | Bin 0 -> 1658 bytes doc/kpresenter/configure4c.png | Bin 0 -> 1192 bytes doc/kpresenter/configure5.png | Bin 0 -> 15006 bytes doc/kpresenter/configure6.png | Bin 0 -> 13365 bytes doc/kpresenter/configure6b.png | Bin 0 -> 12737 bytes doc/kpresenter/configure6c.png | Bin 0 -> 12571 bytes doc/kpresenter/configure6d.png | Bin 0 -> 13328 bytes doc/kpresenter/configure6e.png | Bin 0 -> 13291 bytes doc/kpresenter/configure7.png | Bin 0 -> 11349 bytes doc/kpresenter/faq.docbook | 53 + doc/kpresenter/great-presentations.docbook | 145 ++ doc/kpresenter/guides.docbook | 556 +++++ doc/kpresenter/htmlshow1.png | Bin 0 -> 9349 bytes doc/kpresenter/htmlshow2.png | Bin 0 -> 5558 bytes doc/kpresenter/htmlshow3.png | Bin 0 -> 11504 bytes doc/kpresenter/htmlshow4.png | Bin 0 -> 11614 bytes doc/kpresenter/htmlshow5.png | Bin 0 -> 9935 bytes doc/kpresenter/htmlshow6.png | Bin 0 -> 12053 bytes doc/kpresenter/htmlshow7.png | Bin 0 -> 12413 bytes doc/kpresenter/htmlshow8.png | Bin 0 -> 6594 bytes doc/kpresenter/htmlshow9.png | Bin 0 -> 2972 bytes doc/kpresenter/index.docbook | 267 ++ doc/kpresenter/kbd-focus-ext.png | Bin 0 -> 5939 bytes doc/kpresenter/link.png | Bin 0 -> 1006 bytes doc/kpresenter/menus.docbook | 2066 +++++++++++++++ doc/kpresenter/mousenav.png | Bin 0 -> 3673 bytes doc/kpresenter/msexport1.png | Bin 0 -> 9403 bytes doc/kpresenter/msexport2.png | Bin 0 -> 6614 bytes doc/kpresenter/msexport2b.png | Bin 0 -> 3558 bytes doc/kpresenter/msexport3.png | Bin 0 -> 4938 bytes doc/kpresenter/msexport4.png | Bin 0 -> 6644 bytes doc/kpresenter/options.docbook | 1032 ++++++++ doc/kpresenter/properties.png | Bin 0 -> 6779 bytes doc/kpresenter/screen.docbook | 44 + doc/kpresenter/settings01.png | Bin 0 -> 3775 bytes doc/kpresenter/settings03.png | Bin 0 -> 13350 bytes doc/kpresenter/settings04.png | Bin 0 -> 14897 bytes doc/kpresenter/template02.png | Bin 0 -> 8916 bytes doc/kpresenter/template03.png | Bin 0 -> 8764 bytes doc/kpresenter/template04.png | Bin 0 -> 3502 bytes doc/kpresenter/template05.png | Bin 0 -> 8981 bytes doc/kpresenter/template06.png | Bin 0 -> 10383 bytes doc/kpresenter/template07.png | Bin 0 -> 16993 bytes doc/kpresenter/textmenu1.png | Bin 0 -> 13193 bytes doc/kpresenter/textmenu2.png | Bin 0 -> 23527 bytes doc/kpresenter/toolsmenu01.png | Bin 0 -> 4098 bytes doc/kpresenter/tts.png | Bin 0 -> 18511 bytes doc/kpresenter/tut01.png | Bin 0 -> 14666 bytes doc/kpresenter/tut02.png | Bin 0 -> 17840 bytes doc/kpresenter/tut03.png | Bin 0 -> 19283 bytes doc/kpresenter/tut04.png | Bin 0 -> 21576 bytes doc/kpresenter/tut05.png | Bin 0 -> 22147 bytes doc/kpresenter/tut06.png | Bin 0 -> 5380 bytes doc/kpresenter/tut07.png | Bin 0 -> 10706 bytes doc/kpresenter/tut08.png | Bin 0 -> 21905 bytes doc/kpresenter/tut09.png | Bin 0 -> 20327 bytes doc/kpresenter/tut10.png | Bin 0 -> 25654 bytes doc/kpresenter/tut11.png | Bin 0 -> 21941 bytes doc/kpresenter/tut12.png | Bin 0 -> 25558 bytes doc/kpresenter/tut13.png | Bin 0 -> 35617 bytes doc/kpresenter/tut14.png | Bin 0 -> 42541 bytes doc/kpresenter/tut15.png | Bin 0 -> 28314 bytes doc/kpresenter/tut16.png | Bin 0 -> 5864 bytes doc/kpresenter/tut17.png | Bin 0 -> 6112 bytes doc/kpresenter/tut18.png | Bin 0 -> 30038 bytes doc/kpresenter/tut19.png | Bin 0 -> 31037 bytes doc/kpresenter/tut20.png | Bin 0 -> 26499 bytes doc/kpresenter/tut21.png | Bin 0 -> 30885 bytes doc/kpresenter/tut22.png | Bin 0 -> 40281 bytes doc/kpresenter/tut23.png | Bin 0 -> 13593 bytes doc/kpresenter/tut24.png | Bin 0 -> 11811 bytes doc/kpresenter/tut25.png | Bin 0 -> 432 bytes doc/kpresenter/tut26.png | Bin 0 -> 25978 bytes doc/kpresenter/tutorial.docbook | 510 ++++ doc/kpresenter/zoomfactor.png | Bin 0 -> 1302 bytes doc/krita/Makefile.am | 4 + doc/krita/README.SCREENSHOTS | 7 + doc/krita/commands-dialogs.docbook | 1411 +++++++++++ doc/krita/commands-menus.docbook | 2158 ++++++++++++++++ doc/krita/commands-palettes.docbook | 769 ++++++ doc/krita/commands-toolbars.docbook | 752 ++++++ doc/krita/commands.docbook | 14 + doc/krita/createdocument.png | Bin 0 -> 27558 bytes doc/krita/credits.docbook | 63 + doc/krita/crocusses-autocontrast.png | Bin 0 -> 499562 bytes doc/krita/crocusses-blur.png | Bin 0 -> 468953 bytes doc/krita/crocusses-brightnesscontrast.png | Bin 0 -> 546358 bytes doc/krita/crocusses-bumpmap.png | Bin 0 -> 571353 bytes doc/krita/crocusses-coloradjustment.png | Bin 0 -> 528830 bytes doc/krita/crocusses-colortoalpha.png | Bin 0 -> 415299 bytes doc/krita/crocusses-colortransfer.png | Bin 0 -> 555351 bytes doc/krita/crocusses-customconvolution.png | Bin 0 -> 554016 bytes doc/krita/crocusses-desaturate.png | Bin 0 -> 406990 bytes doc/krita/crocusses-edgebottom.png | Bin 0 -> 559654 bytes doc/krita/crocusses-edgeleft.png | Bin 0 -> 571224 bytes doc/krita/crocusses-edgeright.png | Bin 0 -> 571078 bytes doc/krita/crocusses-embossall.png | Bin 0 -> 510968 bytes doc/krita/crocusses-embosshorvert.png | Bin 0 -> 458926 bytes doc/krita/crocusses-embossvariable.png | Bin 0 -> 422049 bytes doc/krita/crocusses-gaussianblur.png | Bin 0 -> 530121 bytes doc/krita/crocusses-gaussiannoise.png | Bin 0 -> 286294 bytes doc/krita/crocusses-invert.png | Bin 0 -> 539218 bytes doc/krita/crocusses-lenscorrection.png | Bin 0 -> 508837 bytes doc/krita/crocusses-maximizechannel.png | Bin 0 -> 459660 bytes doc/krita/crocusses-meanremoval.png | Bin 0 -> 567170 bytes doc/krita/crocusses-minimizechannel.png | Bin 0 -> 425660 bytes doc/krita/crocusses-oilpaint.png | Bin 0 -> 495449 bytes doc/krita/crocusses-pixelize.png | Bin 0 -> 478581 bytes doc/krita/crocusses-raindrops.png | Bin 0 -> 534746 bytes doc/krita/crocusses-randomnoise.png | Bin 0 -> 564979 bytes doc/krita/crocusses-randompick.png | Bin 0 -> 519583 bytes doc/krita/crocusses-roundcorners.png | Bin 0 -> 539409 bytes doc/krita/crocusses-sharpen.png | Bin 0 -> 553916 bytes doc/krita/crocusses-smalltiles.png | Bin 0 -> 361990 bytes doc/krita/crocusses-sobel.png | Bin 0 -> 471358 bytes doc/krita/crocusses-topedge.png | Bin 0 -> 559859 bytes doc/krita/crocusses-unsharpmask.png | Bin 0 -> 428069 bytes doc/krita/crocusses-wave.png | Bin 0 -> 523430 bytes doc/krita/crocusses-waveletnoise.png | Bin 0 -> 529833 bytes doc/krita/crocusses.png | Bin 0 -> 793760 bytes doc/krita/developers-plugins.docbook | 1553 ++++++++++++ doc/krita/developers-scripting.docbook | 534 ++++ doc/krita/developers.docbook | 13 + doc/krita/dialogs-addpalette.png | Bin 0 -> 4550 bytes doc/krita/dialogs-blur.png | Bin 0 -> 48396 bytes doc/krita/dialogs-brightnesscontrast.png | Bin 0 -> 49052 bytes doc/krita/dialogs-bumpmap.png | Bin 0 -> 67764 bytes doc/krita/dialogs-coloradjustment.png | Bin 0 -> 51959 bytes doc/krita/dialogs-colorrange.png | Bin 0 -> 15921 bytes doc/krita/dialogs-colortoalpha.png | Bin 0 -> 87705 bytes doc/krita/dialogs-colortransfer.png | Bin 0 -> 95722 bytes doc/krita/dialogs-convertimagetype.png | Bin 0 -> 20430 bytes doc/krita/dialogs-convertlayertype.png | Bin 0 -> 20120 bytes doc/krita/dialogs-cubism.png | Bin 0 -> 24274 bytes doc/krita/dialogs-customconvolution.png | Bin 0 -> 56961 bytes doc/krita/dialogs-documentinformation.png | Bin 0 -> 15468 bytes doc/krita/dialogs-dropshadow.png | Bin 0 -> 7697 bytes doc/krita/dialogs-emboss.png | Bin 0 -> 43740 bytes doc/krita/dialogs-filtersgallery.png | Bin 0 -> 96047 bytes doc/krita/dialogs-gaussiannoise.png | Bin 0 -> 90250 bytes doc/krita/dialogs-histogram.png | Bin 0 -> 16400 bytes doc/krita/dialogs-imageproperties.png | Bin 0 -> 7707 bytes doc/krita/dialogs-imagerestoration.png | Bin 0 -> 50997 bytes doc/krita/dialogs-imagesize.png | Bin 0 -> 16603 bytes doc/krita/dialogs-layerproperties.png | Bin 0 -> 14491 bytes doc/krita/dialogs-layersize.png | Bin 0 -> 13465 bytes doc/krita/dialogs-lenscorrection.png | Bin 0 -> 94887 bytes doc/krita/dialogs-newadjustmentlayer.png | Bin 0 -> 93985 bytes doc/krita/dialogs-newlayer.png | Bin 0 -> 5867 bytes doc/krita/dialogs-oilpaint.png | Bin 0 -> 37141 bytes doc/krita/dialogs-pixelize.png | Bin 0 -> 16145 bytes doc/krita/dialogs-raindrops.png | Bin 0 -> 45472 bytes doc/krita/dialogs-randomnoise.png | Bin 0 -> 139391 bytes doc/krita/dialogs-randompick.png | Bin 0 -> 91942 bytes doc/krita/dialogs-rotateimage.png | Bin 0 -> 16182 bytes doc/krita/dialogs-rotatelayer.png | Bin 0 -> 20299 bytes doc/krita/dialogs-roundcorners.png | Bin 0 -> 46183 bytes doc/krita/dialogs-separateimage.png | Bin 0 -> 7935 bytes doc/krita/dialogs-shearimage.png | Bin 0 -> 9516 bytes doc/krita/dialogs-shearlayer.png | Bin 0 -> 7940 bytes doc/krita/dialogs-smalltiles.png | Bin 0 -> 32126 bytes doc/krita/dialogs-sobel.png | Bin 0 -> 83672 bytes doc/krita/dialogs-substrate.png | Bin 0 -> 22651 bytes doc/krita/dialogs-unsharpmask.png | Bin 0 -> 93323 bytes doc/krita/dialogs-wave.png | Bin 0 -> 99300 bytes doc/krita/dialogs-waveletnoise.png | Bin 0 -> 77062 bytes doc/krita/faq.docbook | 51 + doc/krita/index.docbook | 137 + doc/krita/installation.docbook | 73 + doc/krita/introduction.docbook | 153 ++ doc/krita/mainscreen.png | Bin 0 -> 79114 bytes doc/krita/mountains-burn.png | Bin 0 -> 160956 bytes doc/krita/mountains-color.png | Bin 0 -> 192279 bytes doc/krita/mountains-darken.png | Bin 0 -> 159109 bytes doc/krita/mountains-divide.png | Bin 0 -> 173187 bytes doc/krita/mountains-dodge.png | Bin 0 -> 173303 bytes doc/krita/mountains-hue.png | Bin 0 -> 234143 bytes doc/krita/mountains-lighten.png | Bin 0 -> 149116 bytes doc/krita/mountains-multiply.png | Bin 0 -> 172588 bytes doc/krita/mountains-normal.png | Bin 0 -> 3513 bytes doc/krita/mountains-original.png | Bin 0 -> 238426 bytes doc/krita/mountains-overlay.png | Bin 0 -> 249214 bytes doc/krita/mountains-saturation.png | Bin 0 -> 231769 bytes doc/krita/mountains-screen.png | Bin 0 -> 172226 bytes doc/krita/mountains-value.png | Bin 0 -> 218818 bytes doc/krita/mountains.png | Bin 0 -> 975922 bytes doc/krita/newimage.png | Bin 0 -> 29882 bytes doc/krita/palettes-colors-gray.png | Bin 0 -> 1425 bytes doc/krita/palettes-colors-hsv.png | Bin 0 -> 10418 bytes doc/krita/palettes-colors-palettes.png | Bin 0 -> 3355 bytes doc/krita/palettes-colors-rgb.png | Bin 0 -> 1840 bytes doc/krita/palettes-colors-watercolors.png | Bin 0 -> 3030 bytes doc/krita/palettes-controlbox-bezier.png | Bin 0 -> 2960 bytes doc/krita/palettes-controlbox-brush.png | Bin 0 -> 3643 bytes doc/krita/palettes-controlbox-colorpicker.png | Bin 0 -> 7577 bytes doc/krita/palettes-controlbox-contiguousfill.png | Bin 0 -> 5641 bytes doc/krita/palettes-controlbox-crop.png | Bin 0 -> 4122 bytes doc/krita/palettes-controlbox-duplicate.png | Bin 0 -> 5856 bytes doc/krita/palettes-controlbox-ellipse.png | Bin 0 -> 3443 bytes doc/krita/palettes-controlbox-fill.png | Bin 0 -> 5467 bytes doc/krita/palettes-controlbox-gradient.png | Bin 0 -> 6694 bytes doc/krita/palettes-controlbox-histogram.png | Bin 0 -> 1596 bytes doc/krita/palettes-controlbox-line.png | Bin 0 -> 3812 bytes doc/krita/palettes-controlbox-overview.png | Bin 0 -> 20948 bytes doc/krita/palettes-controlbox-paintwithfilters.png | Bin 0 -> 7825 bytes doc/krita/palettes-controlbox-polygon.png | Bin 0 -> 4285 bytes doc/krita/palettes-controlbox-polyline.png | Bin 0 -> 3812 bytes doc/krita/palettes-controlbox-rectangle.png | Bin 0 -> 3443 bytes doc/krita/palettes-controlbox-select.png | Bin 0 -> 1537 bytes doc/krita/palettes-controlbox-selectcontiguous.png | Bin 0 -> 3524 bytes doc/krita/palettes-controlbox-selectmagnetic.png | Bin 0 -> 3764 bytes doc/krita/palettes-controlbox-selectsimilar.png | Bin 0 -> 2805 bytes doc/krita/palettes-controlbox-star.png | Bin 0 -> 5077 bytes doc/krita/palettes-controlbox-text.png | Bin 0 -> 4119 bytes doc/krita/palettes-controlbox-transform.png | Bin 0 -> 1528 bytes doc/krita/palettes-layers-layers.png | Bin 0 -> 2824 bytes doc/krita/palettes-layers-scriptsmanager.png | Bin 0 -> 10081 bytes doc/krita/preferences-color.png | Bin 0 -> 9180 bytes doc/krita/preferences-display.png | Bin 0 -> 2052 bytes doc/krita/preferences-general.png | Bin 0 -> 4015 bytes doc/krita/preferences-grid.png | Bin 0 -> 4553 bytes doc/krita/preferences-performance.png | Bin 0 -> 2845 bytes doc/krita/preferences-sidebar.png | Bin 0 -> 8952 bytes doc/krita/preferences-tablet.png | Bin 0 -> 3390 bytes doc/krita/settings.docbook | 229 ++ doc/krita/tool-bezier-example.png | Bin 0 -> 3299 bytes doc/krita/tool-bezier-example2.png | Bin 0 -> 3587 bytes doc/krita/tool-bezier-example3.png | Bin 0 -> 8636 bytes doc/krita/tool-bezier.png | Bin 0 -> 861 bytes doc/krita/tool-brush.png | Bin 0 -> 758 bytes doc/krita/tool-colorpicker.png | Bin 0 -> 820 bytes doc/krita/tool-contiguousfill.png | Bin 0 -> 1196 bytes doc/krita/tool-crop.png | Bin 0 -> 901 bytes doc/krita/tool-duplicate.png | Bin 0 -> 1234 bytes doc/krita/tool-ellipse.png | Bin 0 -> 884 bytes doc/krita/tool-eraseselection.png | Bin 0 -> 1177 bytes doc/krita/tool-gradient.png | Bin 0 -> 480 bytes doc/krita/tool-line.png | Bin 0 -> 573 bytes doc/krita/tool-move.png | Bin 0 -> 882 bytes doc/krita/tool-paintselection.png | Bin 0 -> 1072 bytes doc/krita/tool-paintwithfilters-example.png | Bin 0 -> 236138 bytes doc/krita/tool-paintwithfilters.png | Bin 0 -> 881 bytes doc/krita/tool-pan.png | Bin 0 -> 912 bytes doc/krita/tool-perspectivegrid.png | Bin 0 -> 1043 bytes doc/krita/tool-perspectivetransform.png | Bin 0 -> 882 bytes doc/krita/tool-polygon.png | Bin 0 -> 897 bytes doc/krita/tool-polyline.png | Bin 0 -> 707 bytes doc/krita/tool-rectangle.png | Bin 0 -> 538 bytes doc/krita/tool-selectbezier.png | Bin 0 -> 796 bytes doc/krita/tool-selectcontiguous.png | Bin 0 -> 875 bytes doc/krita/tool-selectelliptical.png | Bin 0 -> 774 bytes doc/krita/tool-selectmagnetic.png | Bin 0 -> 1122 bytes doc/krita/tool-selectoutline.png | Bin 0 -> 926 bytes doc/krita/tool-selectpolygonal.png | Bin 0 -> 938 bytes doc/krita/tool-selectrectangular.png | Bin 0 -> 636 bytes doc/krita/tool-selectsimilar.png | Bin 0 -> 834 bytes doc/krita/tool-star.png | Bin 0 -> 1041 bytes doc/krita/tool-text.png | Bin 0 -> 1007 bytes doc/krita/tool-transform.png | Bin 0 -> 615 bytes doc/krita/tool-zoom.png | Bin 0 -> 980 bytes .../toolbar-brushes-brushshapes-autobrush.png | Bin 0 -> 6980 bytes .../toolbar-brushes-brushshapes-custombrush.png | Bin 0 -> 24319 bytes .../toolbar-brushes-brushshapes-predefined.png | Bin 0 -> 5755 bytes doc/krita/toolbar-brushes-gradients.png | Bin 0 -> 12137 bytes .../toolbar-brushes-patterns-custompattern.png | Bin 0 -> 18844 bytes doc/krita/toolbar-brushes-patterns.png | Bin 0 -> 37516 bytes doc/krita/toolbar-brushesandstuff.png | Bin 0 -> 4513 bytes doc/krita/toolbar-edit.png | Bin 0 -> 1851 bytes doc/krita/toolbar-file.png | Bin 0 -> 3616 bytes doc/krita/toolbar-krita.png | Bin 0 -> 21660 bytes doc/krita/toolbar-navigation.png | Bin 0 -> 1195 bytes doc/krita/toolbar-transformationtools.png | Bin 0 -> 2338 bytes doc/krita/toolbars-button-zoomin.png | Bin 0 -> 1078 bytes doc/krita/toolbars-button-zoomout.png | Bin 0 -> 1039 bytes doc/krita/tutorial-quick-starts.docbook | 183 ++ doc/krita/tutorial-quick-starts1.png | Bin 0 -> 517476 bytes doc/krita/tutorial-quick-starts10.png | Bin 0 -> 5260 bytes doc/krita/tutorial-quick-starts11.png | Bin 0 -> 15271 bytes doc/krita/tutorial-quick-starts12.png | Bin 0 -> 64869 bytes doc/krita/tutorial-quick-starts2.png | Bin 0 -> 13702 bytes doc/krita/tutorial-quick-starts3.png | Bin 0 -> 376207 bytes doc/krita/tutorial-quick-starts4.png | Bin 0 -> 5867 bytes doc/krita/tutorial-quick-starts5.png | Bin 0 -> 251713 bytes doc/krita/tutorial-quick-starts6.png | Bin 0 -> 45703 bytes doc/krita/tutorial-quick-starts7.png | Bin 0 -> 73294 bytes doc/krita/tutorial-quick-starts8.png | Bin 0 -> 3635 bytes doc/krita/tutorial-quick-starts9.png | Bin 0 -> 7114 bytes doc/krita/tutorial-select-layer-1.png | Bin 0 -> 99972 bytes doc/krita/tutorial-select-layer-10.png | Bin 0 -> 21979 bytes doc/krita/tutorial-select-layer-11.png | Bin 0 -> 28346 bytes doc/krita/tutorial-select-layer-12.png | Bin 0 -> 2907 bytes doc/krita/tutorial-select-layer-13.png | Bin 0 -> 5911 bytes doc/krita/tutorial-select-layer-2.png | Bin 0 -> 7972 bytes doc/krita/tutorial-select-layer-3.png | Bin 0 -> 17498 bytes doc/krita/tutorial-select-layer-4.png | Bin 0 -> 3851 bytes doc/krita/tutorial-select-layer-5.png | Bin 0 -> 5554 bytes doc/krita/tutorial-select-layer-6.png | Bin 0 -> 14352 bytes doc/krita/tutorial-select-layer-7.png | Bin 0 -> 5172 bytes doc/krita/tutorial-select-layer-8.png | Bin 0 -> 6461 bytes doc/krita/tutorial-select-layer-9.png | Bin 0 -> 21071 bytes doc/krita/tutorial-select-layer-sample.png | Bin 0 -> 5904 bytes doc/krita/tutorial-select-layer.docbook | 263 ++ doc/krita/tutorial-starting.docbook | 117 + doc/krita/tutorial-tablet-1.png | Bin 0 -> 99767 bytes doc/krita/tutorial-tablet-2.png | Bin 0 -> 27895 bytes doc/krita/tutorial-tablet-3.png | Bin 0 -> 33491 bytes doc/krita/tutorial-tablet.docbook | 141 ++ doc/krita/tutorial.docbook | 14 + doc/krita/using-colorspaces.docbook | 149 ++ doc/krita/using-filters.docbook | 923 +++++++ doc/krita/using-images.docbook | 66 + doc/krita/using-layers.docbook | 620 +++++ doc/krita/using-selections-1.png | Bin 0 -> 115985 bytes doc/krita/using-selections-2.png | Bin 0 -> 128191 bytes doc/krita/using-selections-3.png | Bin 0 -> 131768 bytes doc/krita/using-selections-4.png | Bin 0 -> 29985 bytes doc/krita/using-selections-5.png | Bin 0 -> 24733 bytes doc/krita/using-selections-6.png | Bin 0 -> 194315 bytes doc/krita/using-selections.docbook | 200 ++ doc/krita/using-views.docbook | 167 ++ doc/kspread/Makefile.am | 4 + doc/kspread/a11y.docbook | 320 +++ doc/kspread/advanced.docbook | 815 ++++++ doc/kspread/basics.docbook | 637 +++++ doc/kspread/cellformat0.png | Bin 0 -> 6925 bytes doc/kspread/cellformat1.png | Bin 0 -> 9948 bytes doc/kspread/cellformat2.png | Bin 0 -> 12133 bytes doc/kspread/cellformat3.png | Bin 0 -> 12308 bytes doc/kspread/cellformat4.png | Bin 0 -> 9813 bytes doc/kspread/cellformat5.png | Bin 0 -> 7634 bytes doc/kspread/cellformat6.png | Bin 0 -> 7048 bytes doc/kspread/cellformat7.png | Bin 0 -> 1831 bytes doc/kspread/cellprotection1.png | Bin 0 -> 6591 bytes doc/kspread/cellprotection2.png | Bin 0 -> 5189 bytes doc/kspread/chart1.png | Bin 0 -> 5447 bytes doc/kspread/commands.docbook | 1540 ++++++++++++ doc/kspread/config.docbook | 145 ++ doc/kspread/configdialog.docbook | 377 +++ doc/kspread/configure1.png | Bin 0 -> 35860 bytes doc/kspread/configure2.png | Bin 0 -> 44409 bytes doc/kspread/configure3.png | Bin 0 -> 37037 bytes doc/kspread/configure4.png | Bin 0 -> 27384 bytes doc/kspread/configure5.png | Bin 0 -> 32763 bytes doc/kspread/configure6.png | Bin 0 -> 38047 bytes doc/kspread/copy1.png | Bin 0 -> 4863 bytes doc/kspread/currency.png | Bin 0 -> 1366 bytes doc/kspread/decreasedecimal.png | Bin 0 -> 1299 bytes doc/kspread/faq.docbook | 45 + doc/kspread/format.docbook | 693 ++++++ doc/kspread/hideformula1.png | Bin 0 -> 2590 bytes doc/kspread/hideformula2.png | Bin 0 -> 2460 bytes doc/kspread/hideformula3.png | Bin 0 -> 2367 bytes doc/kspread/hideformula4.png | Bin 0 -> 2383 bytes doc/kspread/hideformula5.png | Bin 0 -> 2518 bytes doc/kspread/importexport.docbook | 105 + doc/kspread/increasedecimal.png | Bin 0 -> 1162 bytes doc/kspread/index.docbook | 207 ++ doc/kspread/kbd-focus-ext.png | Bin 0 -> 7097 bytes doc/kspread/mousenav.png | Bin 0 -> 3673 bytes doc/kspread/newdocument.png | Bin 0 -> 14253 bytes doc/kspread/percent.png | Bin 0 -> 1039 bytes doc/kspread/sheetproperties.png | Bin 0 -> 7446 bytes doc/kspread/shortcut1.png | Bin 0 -> 11011 bytes doc/kspread/shortcut2.png | Bin 0 -> 4078 bytes doc/kspread/shortcut3.png | Bin 0 -> 5379 bytes doc/kspread/sort1.png | Bin 0 -> 5301 bytes doc/kspread/starting1.png | Bin 0 -> 6107 bytes doc/kspread/tts.png | Bin 0 -> 17345 bytes doc/kugar/Makefile.am | 3 + doc/kugar/add_detail.png | Bin 0 -> 2005 bytes doc/kugar/add_detail_footer.png | Bin 0 -> 2041 bytes doc/kugar/add_detail_header.png | Bin 0 -> 2025 bytes doc/kugar/datadtd.docbook | 46 + doc/kugar/dataref.docbook | 130 + doc/kugar/designer.docbook | 364 +++ doc/kugar/file_new.png | Bin 0 -> 3097 bytes doc/kugar/index.docbook | 156 ++ doc/kugar/kugar.png | Bin 0 -> 7315 bytes doc/kugar/progguide.docbook | 544 ++++ doc/kugar/props.png | Bin 0 -> 4621 bytes doc/kugar/starting.docbook | 60 + doc/kugar/template-elements.docbook | 2493 +++++++++++++++++++ doc/kugar/template.docbook | 357 +++ doc/kugar/templatedtd.docbook | 188 ++ doc/kugar/tut_edit_height.png | Bin 0 -> 2931 bytes doc/kugar/tut_empty_report.png | Bin 0 -> 10727 bytes doc/kugar/tut_file_new.png | Bin 0 -> 3172 bytes doc/kugar/tut_rep_complete.png | Bin 0 -> 12842 bytes doc/kugar/tut_rep_generated.png | Bin 0 -> 9918 bytes doc/kugar/tut_rep_look1.png | Bin 0 -> 11250 bytes doc/kugar/tut_rep_look2.png | Bin 0 -> 11073 bytes doc/kugar/tut_set_level.png | Bin 0 -> 2024 bytes doc/kugar/tutorial.docbook | 313 +++ doc/kword/ChooseTempDia.png | Bin 0 -> 21339 bytes doc/kword/Makefile.am | 4 + doc/kword/Tut1.png | Bin 0 -> 22139 bytes doc/kword/Tut11a.png | Bin 0 -> 18860 bytes doc/kword/Tut11b.png | Bin 0 -> 14478 bytes doc/kword/Tut13.png | Bin 0 -> 15069 bytes doc/kword/Tut13a.png | Bin 0 -> 14665 bytes doc/kword/Tut14.png | Bin 0 -> 13547 bytes doc/kword/Tut14a.png | Bin 0 -> 16464 bytes doc/kword/Tut14b.png | Bin 0 -> 16413 bytes doc/kword/Tut15.png | Bin 0 -> 8301 bytes doc/kword/Tut15b.png | Bin 0 -> 8298 bytes doc/kword/Tut16.png | Bin 0 -> 8596 bytes doc/kword/Tut18.png | Bin 0 -> 16413 bytes doc/kword/Tut19.png | Bin 0 -> 17570 bytes doc/kword/Tut2.png | Bin 0 -> 17157 bytes doc/kword/Tut21.png | Bin 0 -> 23243 bytes doc/kword/Tut22.png | Bin 0 -> 16270 bytes doc/kword/Tut3.png | Bin 0 -> 17924 bytes doc/kword/Tut4.png | Bin 0 -> 17047 bytes doc/kword/Tut7.png | Bin 0 -> 14112 bytes doc/kword/Tut8.png | Bin 0 -> 15044 bytes doc/kword/a11y.docbook | 365 +++ doc/kword/addentry.png | Bin 0 -> 1148 bytes doc/kword/addrecord.png | Bin 0 -> 1165 bytes doc/kword/alignBlock.png | Bin 0 -> 1145 bytes doc/kword/alignCenter.png | Bin 0 -> 1155 bytes doc/kword/alignLeft.png | Bin 0 -> 1164 bytes doc/kword/alignRight.png | Bin 0 -> 1104 bytes doc/kword/auto1.png | Bin 0 -> 14889 bytes doc/kword/auto2.png | Bin 0 -> 14226 bytes doc/kword/auto3.png | Bin 0 -> 12954 bytes doc/kword/auto4.png | Bin 0 -> 10205 bytes doc/kword/autocompdlg.png | Bin 0 -> 8703 bytes doc/kword/back.png | Bin 0 -> 1539 bytes doc/kword/basic.png | Bin 0 -> 2303 bytes doc/kword/basics.docbook | 194 ++ doc/kword/bbord.png | Bin 0 -> 171 bytes doc/kword/bdcolorbut.png | Bin 0 -> 1393 bytes doc/kword/bdselbut.png | Bin 0 -> 1558 bytes doc/kword/bdsizebut.png | Bin 0 -> 1628 bytes doc/kword/beginning.png | Bin 0 -> 1241 bytes doc/kword/bkgdcolorbut.png | Bin 0 -> 1218 bytes doc/kword/bold.png | Bin 0 -> 1249 bytes doc/kword/bookmarks.docbook | 69 + doc/kword/borbutB.png | Bin 0 -> 201 bytes doc/kword/borbutL.png | Bin 0 -> 205 bytes doc/kword/borbutR.png | Bin 0 -> 213 bytes doc/kword/borbutT.png | Bin 0 -> 201 bytes doc/kword/bord.png | Bin 0 -> 1127 bytes doc/kword/bordtb.png | Bin 0 -> 2687 bytes doc/kword/bullist.png | Bin 0 -> 1329 bytes doc/kword/cftb.png | Bin 0 -> 3392 bytes doc/kword/chapnumb.docbook | 15 + doc/kword/chcase.png | Bin 0 -> 1118 bytes doc/kword/chcolorbut.png | Bin 0 -> 1172 bytes doc/kword/chfontbut.png | Bin 0 -> 1776 bytes doc/kword/chsizebut.png | Bin 0 -> 1673 bytes doc/kword/chstylebut.png | Bin 0 -> 1770 bytes doc/kword/clearright.png | Bin 0 -> 1129 bytes doc/kword/colin.png | Bin 0 -> 1238 bytes doc/kword/colorseldlg.png | Bin 0 -> 24482 bytes doc/kword/colout.png | Bin 0 -> 1180 bytes doc/kword/columns.docbook | 56 + doc/kword/ctab.png | Bin 0 -> 97 bytes doc/kword/ctab2.png | Bin 0 -> 360 bytes doc/kword/decindbut.png | Bin 0 -> 1325 bytes doc/kword/delentry.png | Bin 0 -> 1142 bytes doc/kword/delrecord.png | Bin 0 -> 1167 bytes doc/kword/doccomments.docbook | 69 + doc/kword/doclinks.docbook | 81 + doc/kword/docstruct.docbook | 148 ++ doc/kword/docstruct.png | Bin 0 -> 7217 bytes doc/kword/docvariables.docbook | 486 ++++ doc/kword/dtab.png | Bin 0 -> 1022 bytes doc/kword/dtab2.png | Bin 0 -> 369 bytes doc/kword/dtpfmtpg1.png | Bin 0 -> 9549 bytes doc/kword/editcopy.png | Bin 0 -> 1233 bytes doc/kword/editcut.png | Bin 0 -> 1357 bytes doc/kword/editing.docbook | 1903 ++++++++++++++ doc/kword/editpaste.png | Bin 0 -> 1248 bytes doc/kword/edittb.png | Bin 0 -> 3599 bytes doc/kword/end.png | Bin 0 -> 1226 bytes doc/kword/enumlist.png | Bin 0 -> 1302 bytes doc/kword/exoffset.png | Bin 0 -> 1588 bytes doc/kword/expression.png | Bin 0 -> 6381 bytes doc/kword/expressions.docbook | 93 + doc/kword/exst.png | Bin 0 -> 2450 bytes doc/kword/exul.png | Bin 0 -> 3294 bytes doc/kword/fchardlg.png | Bin 0 -> 9671 bytes doc/kword/fchardlg2.png | Bin 0 -> 8038 bytes doc/kword/fchardlg3.png | Bin 0 -> 7851 bytes doc/kword/fchardlg4.png | Bin 0 -> 7621 bytes doc/kword/fchardlg5.png | Bin 0 -> 5379 bytes doc/kword/filefloppy.png | Bin 0 -> 1301 bytes doc/kword/filenew2.png | Bin 0 -> 1199 bytes doc/kword/fileopen.png | Bin 0 -> 1380 bytes doc/kword/fileprint.png | Bin 0 -> 1322 bytes doc/kword/fileprint2.png | Bin 0 -> 1430 bytes doc/kword/filetb.png | Bin 0 -> 2277 bytes doc/kword/find.png | Bin 0 -> 1370 bytes doc/kword/finddlg.png | Bin 0 -> 7862 bytes doc/kword/finddlg2.png | Bin 0 -> 11464 bytes doc/kword/footcfg1.png | Bin 0 -> 8576 bytes doc/kword/footcfg2.png | Bin 0 -> 9109 bytes doc/kword/footcfg3.png | Bin 0 -> 7603 bytes doc/kword/footend.png | Bin 0 -> 3278 bytes doc/kword/footendnotes.docbook | 200 ++ doc/kword/formabs.png | Bin 0 -> 1107 bytes doc/kword/formatchar.docbook | 319 +++ doc/kword/formatframes.docbook | 503 ++++ doc/kword/formatpara.docbook | 388 +++ doc/kword/formbrac.png | Bin 0 -> 1269 bytes doc/kword/formcbrac.png | Bin 0 -> 1267 bytes doc/kword/formfrac.png | Bin 0 -> 1186 bytes doc/kword/formframe1.png | Bin 0 -> 10913 bytes doc/kword/formframe2.png | Bin 0 -> 27447 bytes doc/kword/formframe3.png | Bin 0 -> 9380 bytes doc/kword/formframe4.png | Bin 0 -> 19816 bytes doc/kword/formframe5.png | Bin 0 -> 11739 bytes doc/kword/formframe6.png | Bin 0 -> 12385 bytes doc/kword/forminteg.png | Bin 0 -> 777 bytes doc/kword/formllind.png | Bin 0 -> 812 bytes doc/kword/formlrind.png | Bin 0 -> 782 bytes doc/kword/formmat.png | Bin 0 -> 906 bytes doc/kword/formover.png | Bin 0 -> 1190 bytes doc/kword/formprod.png | Bin 0 -> 1061 bytes doc/kword/formsbrac.png | Bin 0 -> 1275 bytes doc/kword/formspecchar.png | Bin 0 -> 2170 bytes doc/kword/formsqrt.png | Bin 0 -> 828 bytes doc/kword/formsum.png | Bin 0 -> 1292 bytes doc/kword/formtb.png | Bin 0 -> 4191 bytes doc/kword/formulas.docbook | 69 + doc/kword/formulind.png | Bin 0 -> 876 bytes doc/kword/formunder.png | Bin 0 -> 1106 bytes doc/kword/formurind.png | Bin 0 -> 1138 bytes doc/kword/forward.png | Bin 0 -> 1555 bytes doc/kword/fpara1.png | Bin 0 -> 9106 bytes doc/kword/fpara2.png | Bin 0 -> 8653 bytes doc/kword/fpara3.png | Bin 0 -> 8807 bytes doc/kword/fpara4.png | Bin 0 -> 12253 bytes doc/kword/fpara5.png | Bin 0 -> 10136 bytes doc/kword/fpicture.png | Bin 0 -> 1275 bytes doc/kword/framers.png | Bin 0 -> 4782 bytes doc/kword/frames.docbook | 435 ++++ doc/kword/framestylist.png | Bin 0 -> 9758 bytes doc/kword/fundimentals.docbook | 178 ++ doc/kword/graphics.docbook | 238 ++ doc/kword/headerfooter.docbook | 57 + doc/kword/incindbut.png | Bin 0 -> 1293 bytes doc/kword/index.docbook | 1852 ++++++++++++++ doc/kword/inscoldlg.png | Bin 0 -> 2766 bytes doc/kword/insdate.png | Bin 0 -> 5666 bytes doc/kword/insertfile.docbook | 22 + doc/kword/insgrph1.png | Bin 0 -> 11842 bytes doc/kword/insgrph2.png | Bin 0 -> 6034 bytes doc/kword/insrowdlg.png | Bin 0 -> 2651 bytes doc/kword/instab1.png | Bin 0 -> 4537 bytes doc/kword/instb.png | Bin 0 -> 1879 bytes doc/kword/instime.png | Bin 0 -> 5107 bytes doc/kword/intro1.png | Bin 0 -> 500 bytes doc/kword/intro2.png | Bin 0 -> 1203 bytes doc/kword/intro3.png | Bin 0 -> 1707 bytes doc/kword/ital.png | Bin 0 -> 1235 bytes doc/kword/joincell.png | Bin 0 -> 240 bytes doc/kword/kbd-focus-ext.png | Bin 0 -> 11485 bytes doc/kword/kformappcol.png | Bin 0 -> 843 bytes doc/kword/kformapprow.png | Bin 0 -> 868 bytes doc/kword/kforminscol.png | Bin 0 -> 867 bytes doc/kword/kforminsrow.png | Bin 0 -> 249 bytes doc/kword/kformremcol.png | Bin 0 -> 926 bytes doc/kword/kformremrow.png | Bin 0 -> 929 bytes doc/kword/kpart.png | Bin 0 -> 1192 bytes doc/kword/kparts.docbook | 56 + doc/kword/landscape.png | Bin 0 -> 178 bytes doc/kword/larrow.png | Bin 0 -> 1359 bytes doc/kword/lbord.png | Bin 0 -> 177 bytes doc/kword/linkdlg.png | Bin 0 -> 6417 bytes doc/kword/listdepth1.png | Bin 0 -> 1099 bytes doc/kword/listdepth2.png | Bin 0 -> 970 bytes doc/kword/listdepth3.png | Bin 0 -> 1146 bytes doc/kword/lists.docbook | 165 ++ doc/kword/ltab.png | Bin 0 -> 985 bytes doc/kword/ltab2.png | Bin 0 -> 364 bytes doc/kword/mailmerge.docbook | 475 ++++ doc/kword/mbtb.docbook | 2628 ++++++++++++++++++++ doc/kword/migrating.docbook | 15 + doc/kword/mmerge1.png | Bin 0 -> 4388 bytes doc/kword/mmerge1a.png | Bin 0 -> 7827 bytes doc/kword/mmerge2.png | Bin 0 -> 4036 bytes doc/kword/mmergeab1.png | Bin 0 -> 8489 bytes doc/kword/mmergekspread1.png | Bin 0 -> 3941 bytes doc/kword/mmergesql1.png | Bin 0 -> 5799 bytes doc/kword/mmergesql2.png | Bin 0 -> 7423 bytes doc/kword/mousenav.png | Bin 0 -> 3673 bytes doc/kword/numtxtbut.png | Bin 0 -> 1317 bytes doc/kword/opendlg.png | Bin 0 -> 12232 bytes doc/kword/opt.docbook | 654 +++++ doc/kword/opt1.png | Bin 0 -> 31203 bytes doc/kword/opt2.png | Bin 0 -> 38682 bytes doc/kword/opt3.png | Bin 0 -> 36111 bytes doc/kword/opt4.png | Bin 0 -> 39648 bytes doc/kword/opt5.png | Bin 0 -> 36815 bytes doc/kword/opt6.png | Bin 0 -> 26865 bytes doc/kword/optkb.png | Bin 0 -> 14917 bytes doc/kword/optkb2.png | Bin 0 -> 4930 bytes doc/kword/opttb.png | Bin 0 -> 13539 bytes doc/kword/pageformat.docbook | 253 ++ doc/kword/paratb.png | Bin 0 -> 3521 bytes doc/kword/part-kformula.png | Bin 0 -> 1199 bytes doc/kword/part-kspread.png | Bin 0 -> 1204 bytes doc/kword/picture.png | Bin 0 -> 1280 bytes doc/kword/pntdlg.png | Bin 0 -> 10169 bytes doc/kword/pntdlg1.png | Bin 0 -> 16423 bytes doc/kword/portrait.png | Bin 0 -> 1001 bytes doc/kword/rarrow.png | Bin 0 -> 1294 bytes doc/kword/rbord.png | Bin 0 -> 157 bytes doc/kword/redo.png | Bin 0 -> 1235 bytes doc/kword/repldlg.png | Bin 0 -> 12032 bytes doc/kword/rowin.png | Bin 0 -> 1220 bytes doc/kword/rowout.png | Bin 0 -> 1215 bytes doc/kword/rtab.png | Bin 0 -> 1099 bytes doc/kword/rtab2.png | Bin 0 -> 390 bytes doc/kword/ruler.png | Bin 0 -> 6832 bytes doc/kword/saturation.png | Bin 0 -> 1098 bytes doc/kword/saved1.png | Bin 0 -> 3115 bytes doc/kword/saved2.png | Bin 0 -> 3367 bytes doc/kword/savedlg.png | Bin 0 -> 14342 bytes doc/kword/savetmpl1.png | Bin 0 -> 6423 bytes doc/kword/scan.png | Bin 0 -> 22656 bytes doc/kword/scan2.png | Bin 0 -> 7530 bytes doc/kword/screen.png | Bin 0 -> 24244 bytes doc/kword/select1.png | Bin 0 -> 1682 bytes doc/kword/spell.png | Bin 0 -> 1285 bytes doc/kword/spelldlg.png | Bin 0 -> 10057 bytes doc/kword/stkout.png | Bin 0 -> 1271 bytes doc/kword/storeprint.docbook | 476 ++++ doc/kword/styldlg1.png | Bin 0 -> 12491 bytes doc/kword/styleimport.png | Bin 0 -> 4327 bytes doc/kword/styles.docbook | 351 +++ doc/kword/subscbut.png | Bin 0 -> 1266 bytes doc/kword/sum.png | Bin 0 -> 960 bytes doc/kword/supscbut.png | Bin 0 -> 1328 bytes doc/kword/table.docbook | 653 +++++ doc/kword/tableprop1.png | Bin 0 -> 4773 bytes doc/kword/tableprop2.png | Bin 0 -> 8035 bytes doc/kword/tablestylist.png | Bin 0 -> 8806 bytes doc/kword/tabstops.docbook | 324 +++ doc/kword/tb1.png | Bin 0 -> 2278 bytes doc/kword/tb2.png | Bin 0 -> 1613 bytes doc/kword/tb3.png | Bin 0 -> 2999 bytes doc/kword/tb4.png | Bin 0 -> 3127 bytes doc/kword/tblsty.png | Bin 0 -> 1794 bytes doc/kword/tbord.png | Bin 0 -> 232 bytes doc/kword/techinfo.docbook | 246 ++ doc/kword/tedittb.png | Bin 0 -> 2335 bytes doc/kword/templatecreation.docbook | 115 + doc/kword/textstyex.png | Bin 0 -> 4264 bytes doc/kword/tfcreatebut.png | Bin 0 -> 1200 bytes doc/kword/thesaurus.png | Bin 0 -> 12273 bytes doc/kword/toc.docbook | 67 + doc/kword/tts.png | Bin 0 -> 17370 bytes doc/kword/tutorial.docbook | 356 +++ doc/kword/undl.png | Bin 0 -> 1217 bytes doc/kword/undo.png | Bin 0 -> 1198 bytes doc/kword/value.png | Bin 0 -> 1110 bytes doc/kword/viewsize.png | Bin 0 -> 8161 bytes doc/kword/wbw.png | Bin 0 -> 823 bytes doc/kword/wpfmtpg1.png | Bin 0 -> 10510 bytes doc/kword/wpfmtpg2.png | Bin 0 -> 4880 bytes doc/kword/wpfmtpg3.png | Bin 0 -> 10441 bytes doc/kword/zoom.png | Bin 0 -> 1682 bytes doc/thesaurus/Makefile.am | 4 + doc/thesaurus/index.docbook | 150 ++ 826 files changed, 51188 insertions(+) create mode 100644 doc/.directory create mode 100644 doc/CookBook.odt create mode 100644 doc/Makefile.am create mode 100644 doc/TODO create mode 100644 doc/api/Doxyfile.am create mode 100644 doc/api/Doxyfile.koffice create mode 100644 doc/api/doxyndex.sh create mode 100644 doc/api/header.html create mode 100644 doc/api/kfontdialog.png create mode 100644 doc/api/mainheader.html create mode 100644 doc/karbon/Makefile.am create mode 100644 doc/karbon/index.docbook create mode 100644 doc/kchart/Makefile.am create mode 100644 doc/kchart/cr22-action-chart_line.png create mode 100644 doc/kchart/cr22-action-data.png create mode 100644 doc/kchart/cr22-action-options.png create mode 100644 doc/kchart/cr22-action-wizard.png create mode 100644 doc/kchart/file-toolbar.png create mode 100644 doc/kchart/file-toolbar2.png create mode 100644 doc/kchart/frame_chart.png create mode 100644 doc/kchart/index.docbook create mode 100644 doc/kchart/kchart-config1.png create mode 100644 doc/kchart/kchart-config2.png create mode 100644 doc/kchart/kchart-config3.png create mode 100644 doc/kchart/kchart-config4.png create mode 100644 doc/kchart/kchart-config5.png create mode 100644 doc/kchart/kchart-config6.png create mode 100644 doc/kchart/kchart-config7.png create mode 100644 doc/kchart/kchart-config8.png create mode 100644 doc/kchart/kchart-dataeditor.png create mode 100644 doc/kchart/kchart-default.png create mode 100644 doc/kchart/kchart-example1-1.png create mode 100644 doc/kchart/kchart-example1-2.png create mode 100644 doc/kchart/kchart-example1-3.png create mode 100644 doc/kchart/kchart-example1-4.png create mode 100644 doc/kchart/kchart-example1-5.png create mode 100644 doc/kchart/kchart-example1-6.png create mode 100644 doc/kchart/kchart-example1-7.png create mode 100644 doc/kchart/kchart-example1-8.png create mode 100644 doc/kchart/kchart-example1-9.png create mode 100644 doc/kchart/kchart-kspread-bar.png create mode 100644 doc/kchart/kchart-kspread.png create mode 100644 doc/kchart/kchart-startupdialog.png create mode 100644 doc/kchart/kchart-wizard0.png create mode 100644 doc/kchart/kchart-wizard1.png create mode 100644 doc/kchart/kchart-wizard2.png create mode 100644 doc/kchart/kchart-wizard3.png create mode 100644 doc/kchart/kchart-wizard4.png create mode 100644 doc/kchart/shortcut.png create mode 100644 doc/kchart/toolbars.png create mode 100644 doc/kexi/Makefile.am create mode 100644 doc/kexi/basics.docbook create mode 100644 doc/kexi/building.docbook create mode 100644 doc/kexi/comparing.docbook create mode 100644 doc/kexi/configuration.docbook create mode 100644 doc/kexi/contact-example.png create mode 100644 doc/kexi/credits.docbook create mode 100644 doc/kexi/database.docbook create mode 100644 doc/kexi/designingforms.docbook create mode 100644 doc/kexi/enteringdataintotables.docbook create mode 100644 doc/kexi/enteringdatausingforms.docbook create mode 100644 doc/kexi/index.docbook create mode 100644 doc/kexi/intro.docbook create mode 100644 doc/kexi/menus.docbook create mode 100644 doc/kexi/querydesigning.docbook create mode 100644 doc/kformula/Makefile.am create mode 100644 doc/kformula/ambiguous-string.png create mode 100644 doc/kformula/correct_index_location.png create mode 100644 doc/kformula/definite_integral.png create mode 100644 doc/kformula/file-toolbar.png create mode 100644 doc/kformula/file-toolbar2.png create mode 100644 doc/kformula/green1.png create mode 100644 doc/kformula/green2.png create mode 100644 doc/kformula/greens.png create mode 100644 doc/kformula/incorrect_index_location.png create mode 100644 doc/kformula/index.docbook create mode 100644 doc/kformula/index_smear.png create mode 100644 doc/kformula/kfontinst1.png create mode 100644 doc/kformula/kfontinst2.png create mode 100644 doc/kformula/kfontinst3.png create mode 100644 doc/kformula/kfontinst4.png create mode 100644 doc/kformula/kfontinst5.png create mode 100644 doc/kformula/kfontinst6.png create mode 100644 doc/kformula/lower-index.png create mode 100644 doc/kformula/matrix-view.png create mode 100644 doc/kformula/matrix.png create mode 100644 doc/kformula/negative_thin_space.png create mode 100644 doc/kformula/path-integral.png create mode 100644 doc/kformula/rk-edit0.png create mode 100644 doc/kformula/rk-edit1.png create mode 100644 doc/kformula/rk-edit2.png create mode 100644 doc/kformula/scilab-edit.png create mode 100644 doc/kformula/scilab.png create mode 100644 doc/kformula/shortcut0.png create mode 100644 doc/kformula/shortcut1.png create mode 100644 doc/kformula/sin.png create mode 100644 doc/kformula/toolbars.png create mode 100644 doc/kformula/upper-index.png create mode 100644 doc/kivio/Makefile.am create mode 100644 doc/kivio/credits.docbook create mode 100644 doc/kivio/index.docbook create mode 100644 doc/kivio/introduction.docbook create mode 100644 doc/kivio/usage.docbook create mode 100644 doc/kivio/working.docbook create mode 100644 doc/koffice.desktop create mode 100644 doc/koffice/Makefile.am create mode 100644 doc/koffice/index.docbook create mode 100644 doc/koshell/Makefile.am create mode 100644 doc/koshell/index.docbook create mode 100644 doc/koshell/koshell1.png create mode 100644 doc/koshell/main-view.png create mode 100644 doc/koshell/new-dialog.png create mode 100644 doc/koshell/side-pane.png create mode 100644 doc/kplato/Makefile.am create mode 100644 doc/kplato/commands.docbook create mode 100644 doc/kplato/configure-wbs.png create mode 100644 doc/kplato/configure1.png create mode 100644 doc/kplato/configure2.1.png create mode 100644 doc/kplato/configure2.png create mode 100644 doc/kplato/definitions.docbook create mode 100644 doc/kplato/edit-accounts.png create mode 100644 doc/kplato/edit-accounts1.png create mode 100644 doc/kplato/edit-calendar.png create mode 100644 doc/kplato/edit-calendar1.png create mode 100644 doc/kplato/edit-calendar2.png create mode 100644 doc/kplato/edit-resources.png create mode 100644 doc/kplato/edit-resources1.png create mode 100644 doc/kplato/edit-worktime.png create mode 100644 doc/kplato/index.docbook create mode 100644 doc/kplato/mainwindow.docbook create mode 100644 doc/kplato/mainwindow1.png create mode 100644 doc/kplato/options.docbook create mode 100644 doc/kplato/project-settings.png create mode 100644 doc/kplato/wbs.docbook create mode 100644 doc/kplato/wbs.png create mode 100644 doc/kplato/wbs1.png create mode 100644 doc/kplato/wbs2.png create mode 100644 doc/kplato/wbs3.png create mode 100644 doc/kpresenter/Makefile.am create mode 100644 doc/kpresenter/a11y.docbook create mode 100644 doc/kpresenter/autocorrection1.png create mode 100644 doc/kpresenter/autocorrection2.png create mode 100644 doc/kpresenter/autocorrection3.png create mode 100644 doc/kpresenter/autocorrection4.png create mode 100644 doc/kpresenter/barstyle1.png create mode 100644 doc/kpresenter/barstyle3.png create mode 100644 doc/kpresenter/barstyle4.png create mode 100644 doc/kpresenter/barstyle5.png create mode 100644 doc/kpresenter/barstyle6.png create mode 100644 doc/kpresenter/barstyle7.png create mode 100644 doc/kpresenter/break.png create mode 100644 doc/kpresenter/changeformat.png create mode 100644 doc/kpresenter/completion.png create mode 100644 doc/kpresenter/configure1.png create mode 100644 doc/kpresenter/configure2.png create mode 100644 doc/kpresenter/configure3.png create mode 100644 doc/kpresenter/configure4.png create mode 100644 doc/kpresenter/configure4a.png create mode 100644 doc/kpresenter/configure4a1.png create mode 100644 doc/kpresenter/configure4b.png create mode 100644 doc/kpresenter/configure4c.png create mode 100644 doc/kpresenter/configure5.png create mode 100644 doc/kpresenter/configure6.png create mode 100644 doc/kpresenter/configure6b.png create mode 100644 doc/kpresenter/configure6c.png create mode 100644 doc/kpresenter/configure6d.png create mode 100644 doc/kpresenter/configure6e.png create mode 100644 doc/kpresenter/configure7.png create mode 100644 doc/kpresenter/faq.docbook create mode 100644 doc/kpresenter/great-presentations.docbook create mode 100644 doc/kpresenter/guides.docbook create mode 100644 doc/kpresenter/htmlshow1.png create mode 100644 doc/kpresenter/htmlshow2.png create mode 100644 doc/kpresenter/htmlshow3.png create mode 100644 doc/kpresenter/htmlshow4.png create mode 100644 doc/kpresenter/htmlshow5.png create mode 100644 doc/kpresenter/htmlshow6.png create mode 100644 doc/kpresenter/htmlshow7.png create mode 100644 doc/kpresenter/htmlshow8.png create mode 100644 doc/kpresenter/htmlshow9.png create mode 100644 doc/kpresenter/index.docbook create mode 100644 doc/kpresenter/kbd-focus-ext.png create mode 100644 doc/kpresenter/link.png create mode 100644 doc/kpresenter/menus.docbook create mode 100644 doc/kpresenter/mousenav.png create mode 100644 doc/kpresenter/msexport1.png create mode 100644 doc/kpresenter/msexport2.png create mode 100644 doc/kpresenter/msexport2b.png create mode 100644 doc/kpresenter/msexport3.png create mode 100644 doc/kpresenter/msexport4.png create mode 100644 doc/kpresenter/options.docbook create mode 100644 doc/kpresenter/properties.png create mode 100644 doc/kpresenter/screen.docbook create mode 100644 doc/kpresenter/settings01.png create mode 100644 doc/kpresenter/settings03.png create mode 100644 doc/kpresenter/settings04.png create mode 100644 doc/kpresenter/template02.png create mode 100644 doc/kpresenter/template03.png create mode 100644 doc/kpresenter/template04.png create mode 100644 doc/kpresenter/template05.png create mode 100644 doc/kpresenter/template06.png create mode 100644 doc/kpresenter/template07.png create mode 100644 doc/kpresenter/textmenu1.png create mode 100644 doc/kpresenter/textmenu2.png create mode 100644 doc/kpresenter/toolsmenu01.png create mode 100644 doc/kpresenter/tts.png create mode 100644 doc/kpresenter/tut01.png create mode 100644 doc/kpresenter/tut02.png create mode 100644 doc/kpresenter/tut03.png create mode 100644 doc/kpresenter/tut04.png create mode 100644 doc/kpresenter/tut05.png create mode 100644 doc/kpresenter/tut06.png create mode 100644 doc/kpresenter/tut07.png create mode 100644 doc/kpresenter/tut08.png create mode 100644 doc/kpresenter/tut09.png create mode 100644 doc/kpresenter/tut10.png create mode 100644 doc/kpresenter/tut11.png create mode 100644 doc/kpresenter/tut12.png create mode 100644 doc/kpresenter/tut13.png create mode 100644 doc/kpresenter/tut14.png create mode 100644 doc/kpresenter/tut15.png create mode 100644 doc/kpresenter/tut16.png create mode 100644 doc/kpresenter/tut17.png create mode 100644 doc/kpresenter/tut18.png create mode 100644 doc/kpresenter/tut19.png create mode 100644 doc/kpresenter/tut20.png create mode 100644 doc/kpresenter/tut21.png create mode 100644 doc/kpresenter/tut22.png create mode 100644 doc/kpresenter/tut23.png create mode 100644 doc/kpresenter/tut24.png create mode 100644 doc/kpresenter/tut25.png create mode 100644 doc/kpresenter/tut26.png create mode 100644 doc/kpresenter/tutorial.docbook create mode 100644 doc/kpresenter/zoomfactor.png create mode 100644 doc/krita/Makefile.am create mode 100644 doc/krita/README.SCREENSHOTS create mode 100644 doc/krita/commands-dialogs.docbook create mode 100644 doc/krita/commands-menus.docbook create mode 100644 doc/krita/commands-palettes.docbook create mode 100644 doc/krita/commands-toolbars.docbook create mode 100644 doc/krita/commands.docbook create mode 100644 doc/krita/createdocument.png create mode 100644 doc/krita/credits.docbook create mode 100644 doc/krita/crocusses-autocontrast.png create mode 100644 doc/krita/crocusses-blur.png create mode 100644 doc/krita/crocusses-brightnesscontrast.png create mode 100644 doc/krita/crocusses-bumpmap.png create mode 100644 doc/krita/crocusses-coloradjustment.png create mode 100644 doc/krita/crocusses-colortoalpha.png create mode 100644 doc/krita/crocusses-colortransfer.png create mode 100644 doc/krita/crocusses-customconvolution.png create mode 100644 doc/krita/crocusses-desaturate.png create mode 100644 doc/krita/crocusses-edgebottom.png create mode 100644 doc/krita/crocusses-edgeleft.png create mode 100644 doc/krita/crocusses-edgeright.png create mode 100644 doc/krita/crocusses-embossall.png create mode 100644 doc/krita/crocusses-embosshorvert.png create mode 100644 doc/krita/crocusses-embossvariable.png create mode 100644 doc/krita/crocusses-gaussianblur.png create mode 100644 doc/krita/crocusses-gaussiannoise.png create mode 100644 doc/krita/crocusses-invert.png create mode 100644 doc/krita/crocusses-lenscorrection.png create mode 100644 doc/krita/crocusses-maximizechannel.png create mode 100644 doc/krita/crocusses-meanremoval.png create mode 100644 doc/krita/crocusses-minimizechannel.png create mode 100644 doc/krita/crocusses-oilpaint.png create mode 100644 doc/krita/crocusses-pixelize.png create mode 100644 doc/krita/crocusses-raindrops.png create mode 100644 doc/krita/crocusses-randomnoise.png create mode 100644 doc/krita/crocusses-randompick.png create mode 100644 doc/krita/crocusses-roundcorners.png create mode 100644 doc/krita/crocusses-sharpen.png create mode 100644 doc/krita/crocusses-smalltiles.png create mode 100644 doc/krita/crocusses-sobel.png create mode 100644 doc/krita/crocusses-topedge.png create mode 100644 doc/krita/crocusses-unsharpmask.png create mode 100644 doc/krita/crocusses-wave.png create mode 100644 doc/krita/crocusses-waveletnoise.png create mode 100644 doc/krita/crocusses.png create mode 100644 doc/krita/developers-plugins.docbook create mode 100644 doc/krita/developers-scripting.docbook create mode 100644 doc/krita/developers.docbook create mode 100644 doc/krita/dialogs-addpalette.png create mode 100644 doc/krita/dialogs-blur.png create mode 100644 doc/krita/dialogs-brightnesscontrast.png create mode 100644 doc/krita/dialogs-bumpmap.png create mode 100644 doc/krita/dialogs-coloradjustment.png create mode 100644 doc/krita/dialogs-colorrange.png create mode 100644 doc/krita/dialogs-colortoalpha.png create mode 100644 doc/krita/dialogs-colortransfer.png create mode 100644 doc/krita/dialogs-convertimagetype.png create mode 100644 doc/krita/dialogs-convertlayertype.png create mode 100644 doc/krita/dialogs-cubism.png create mode 100644 doc/krita/dialogs-customconvolution.png create mode 100644 doc/krita/dialogs-documentinformation.png create mode 100644 doc/krita/dialogs-dropshadow.png create mode 100644 doc/krita/dialogs-emboss.png create mode 100644 doc/krita/dialogs-filtersgallery.png create mode 100644 doc/krita/dialogs-gaussiannoise.png create mode 100644 doc/krita/dialogs-histogram.png create mode 100644 doc/krita/dialogs-imageproperties.png create mode 100644 doc/krita/dialogs-imagerestoration.png create mode 100644 doc/krita/dialogs-imagesize.png create mode 100644 doc/krita/dialogs-layerproperties.png create mode 100644 doc/krita/dialogs-layersize.png create mode 100644 doc/krita/dialogs-lenscorrection.png create mode 100644 doc/krita/dialogs-newadjustmentlayer.png create mode 100644 doc/krita/dialogs-newlayer.png create mode 100644 doc/krita/dialogs-oilpaint.png create mode 100644 doc/krita/dialogs-pixelize.png create mode 100644 doc/krita/dialogs-raindrops.png create mode 100644 doc/krita/dialogs-randomnoise.png create mode 100644 doc/krita/dialogs-randompick.png create mode 100644 doc/krita/dialogs-rotateimage.png create mode 100644 doc/krita/dialogs-rotatelayer.png create mode 100644 doc/krita/dialogs-roundcorners.png create mode 100644 doc/krita/dialogs-separateimage.png create mode 100644 doc/krita/dialogs-shearimage.png create mode 100644 doc/krita/dialogs-shearlayer.png create mode 100644 doc/krita/dialogs-smalltiles.png create mode 100644 doc/krita/dialogs-sobel.png create mode 100644 doc/krita/dialogs-substrate.png create mode 100644 doc/krita/dialogs-unsharpmask.png create mode 100644 doc/krita/dialogs-wave.png create mode 100644 doc/krita/dialogs-waveletnoise.png create mode 100644 doc/krita/faq.docbook create mode 100644 doc/krita/index.docbook create mode 100644 doc/krita/installation.docbook create mode 100644 doc/krita/introduction.docbook create mode 100644 doc/krita/mainscreen.png create mode 100644 doc/krita/mountains-burn.png create mode 100644 doc/krita/mountains-color.png create mode 100644 doc/krita/mountains-darken.png create mode 100644 doc/krita/mountains-divide.png create mode 100644 doc/krita/mountains-dodge.png create mode 100644 doc/krita/mountains-hue.png create mode 100644 doc/krita/mountains-lighten.png create mode 100644 doc/krita/mountains-multiply.png create mode 100644 doc/krita/mountains-normal.png create mode 100644 doc/krita/mountains-original.png create mode 100644 doc/krita/mountains-overlay.png create mode 100644 doc/krita/mountains-saturation.png create mode 100644 doc/krita/mountains-screen.png create mode 100644 doc/krita/mountains-value.png create mode 100644 doc/krita/mountains.png create mode 100644 doc/krita/newimage.png create mode 100644 doc/krita/palettes-colors-gray.png create mode 100644 doc/krita/palettes-colors-hsv.png create mode 100644 doc/krita/palettes-colors-palettes.png create mode 100644 doc/krita/palettes-colors-rgb.png create mode 100644 doc/krita/palettes-colors-watercolors.png create mode 100644 doc/krita/palettes-controlbox-bezier.png create mode 100644 doc/krita/palettes-controlbox-brush.png create mode 100644 doc/krita/palettes-controlbox-colorpicker.png create mode 100644 doc/krita/palettes-controlbox-contiguousfill.png create mode 100644 doc/krita/palettes-controlbox-crop.png create mode 100644 doc/krita/palettes-controlbox-duplicate.png create mode 100644 doc/krita/palettes-controlbox-ellipse.png create mode 100644 doc/krita/palettes-controlbox-fill.png create mode 100644 doc/krita/palettes-controlbox-gradient.png create mode 100644 doc/krita/palettes-controlbox-histogram.png create mode 100644 doc/krita/palettes-controlbox-line.png create mode 100644 doc/krita/palettes-controlbox-overview.png create mode 100644 doc/krita/palettes-controlbox-paintwithfilters.png create mode 100644 doc/krita/palettes-controlbox-polygon.png create mode 100644 doc/krita/palettes-controlbox-polyline.png create mode 100644 doc/krita/palettes-controlbox-rectangle.png create mode 100644 doc/krita/palettes-controlbox-select.png create mode 100644 doc/krita/palettes-controlbox-selectcontiguous.png create mode 100644 doc/krita/palettes-controlbox-selectmagnetic.png create mode 100644 doc/krita/palettes-controlbox-selectsimilar.png create mode 100644 doc/krita/palettes-controlbox-star.png create mode 100644 doc/krita/palettes-controlbox-text.png create mode 100644 doc/krita/palettes-controlbox-transform.png create mode 100644 doc/krita/palettes-layers-layers.png create mode 100644 doc/krita/palettes-layers-scriptsmanager.png create mode 100644 doc/krita/preferences-color.png create mode 100644 doc/krita/preferences-display.png create mode 100644 doc/krita/preferences-general.png create mode 100644 doc/krita/preferences-grid.png create mode 100644 doc/krita/preferences-performance.png create mode 100644 doc/krita/preferences-sidebar.png create mode 100644 doc/krita/preferences-tablet.png create mode 100644 doc/krita/settings.docbook create mode 100644 doc/krita/tool-bezier-example.png create mode 100644 doc/krita/tool-bezier-example2.png create mode 100644 doc/krita/tool-bezier-example3.png create mode 100644 doc/krita/tool-bezier.png create mode 100644 doc/krita/tool-brush.png create mode 100644 doc/krita/tool-colorpicker.png create mode 100644 doc/krita/tool-contiguousfill.png create mode 100644 doc/krita/tool-crop.png create mode 100644 doc/krita/tool-duplicate.png create mode 100644 doc/krita/tool-ellipse.png create mode 100644 doc/krita/tool-eraseselection.png create mode 100644 doc/krita/tool-gradient.png create mode 100644 doc/krita/tool-line.png create mode 100644 doc/krita/tool-move.png create mode 100644 doc/krita/tool-paintselection.png create mode 100644 doc/krita/tool-paintwithfilters-example.png create mode 100644 doc/krita/tool-paintwithfilters.png create mode 100644 doc/krita/tool-pan.png create mode 100644 doc/krita/tool-perspectivegrid.png create mode 100644 doc/krita/tool-perspectivetransform.png create mode 100644 doc/krita/tool-polygon.png create mode 100644 doc/krita/tool-polyline.png create mode 100644 doc/krita/tool-rectangle.png create mode 100644 doc/krita/tool-selectbezier.png create mode 100644 doc/krita/tool-selectcontiguous.png create mode 100644 doc/krita/tool-selectelliptical.png create mode 100644 doc/krita/tool-selectmagnetic.png create mode 100644 doc/krita/tool-selectoutline.png create mode 100644 doc/krita/tool-selectpolygonal.png create mode 100644 doc/krita/tool-selectrectangular.png create mode 100644 doc/krita/tool-selectsimilar.png create mode 100644 doc/krita/tool-star.png create mode 100644 doc/krita/tool-text.png create mode 100644 doc/krita/tool-transform.png create mode 100644 doc/krita/tool-zoom.png create mode 100644 doc/krita/toolbar-brushes-brushshapes-autobrush.png create mode 100644 doc/krita/toolbar-brushes-brushshapes-custombrush.png create mode 100644 doc/krita/toolbar-brushes-brushshapes-predefined.png create mode 100644 doc/krita/toolbar-brushes-gradients.png create mode 100644 doc/krita/toolbar-brushes-patterns-custompattern.png create mode 100644 doc/krita/toolbar-brushes-patterns.png create mode 100644 doc/krita/toolbar-brushesandstuff.png create mode 100644 doc/krita/toolbar-edit.png create mode 100644 doc/krita/toolbar-file.png create mode 100644 doc/krita/toolbar-krita.png create mode 100644 doc/krita/toolbar-navigation.png create mode 100644 doc/krita/toolbar-transformationtools.png create mode 100644 doc/krita/toolbars-button-zoomin.png create mode 100644 doc/krita/toolbars-button-zoomout.png create mode 100644 doc/krita/tutorial-quick-starts.docbook create mode 100644 doc/krita/tutorial-quick-starts1.png create mode 100644 doc/krita/tutorial-quick-starts10.png create mode 100644 doc/krita/tutorial-quick-starts11.png create mode 100644 doc/krita/tutorial-quick-starts12.png create mode 100644 doc/krita/tutorial-quick-starts2.png create mode 100644 doc/krita/tutorial-quick-starts3.png create mode 100644 doc/krita/tutorial-quick-starts4.png create mode 100644 doc/krita/tutorial-quick-starts5.png create mode 100644 doc/krita/tutorial-quick-starts6.png create mode 100644 doc/krita/tutorial-quick-starts7.png create mode 100644 doc/krita/tutorial-quick-starts8.png create mode 100644 doc/krita/tutorial-quick-starts9.png create mode 100644 doc/krita/tutorial-select-layer-1.png create mode 100644 doc/krita/tutorial-select-layer-10.png create mode 100644 doc/krita/tutorial-select-layer-11.png create mode 100644 doc/krita/tutorial-select-layer-12.png create mode 100644 doc/krita/tutorial-select-layer-13.png create mode 100644 doc/krita/tutorial-select-layer-2.png create mode 100644 doc/krita/tutorial-select-layer-3.png create mode 100644 doc/krita/tutorial-select-layer-4.png create mode 100644 doc/krita/tutorial-select-layer-5.png create mode 100644 doc/krita/tutorial-select-layer-6.png create mode 100644 doc/krita/tutorial-select-layer-7.png create mode 100644 doc/krita/tutorial-select-layer-8.png create mode 100644 doc/krita/tutorial-select-layer-9.png create mode 100644 doc/krita/tutorial-select-layer-sample.png create mode 100644 doc/krita/tutorial-select-layer.docbook create mode 100644 doc/krita/tutorial-starting.docbook create mode 100644 doc/krita/tutorial-tablet-1.png create mode 100644 doc/krita/tutorial-tablet-2.png create mode 100644 doc/krita/tutorial-tablet-3.png create mode 100644 doc/krita/tutorial-tablet.docbook create mode 100644 doc/krita/tutorial.docbook create mode 100644 doc/krita/using-colorspaces.docbook create mode 100644 doc/krita/using-filters.docbook create mode 100644 doc/krita/using-images.docbook create mode 100644 doc/krita/using-layers.docbook create mode 100644 doc/krita/using-selections-1.png create mode 100644 doc/krita/using-selections-2.png create mode 100644 doc/krita/using-selections-3.png create mode 100644 doc/krita/using-selections-4.png create mode 100644 doc/krita/using-selections-5.png create mode 100644 doc/krita/using-selections-6.png create mode 100644 doc/krita/using-selections.docbook create mode 100644 doc/krita/using-views.docbook create mode 100644 doc/kspread/Makefile.am create mode 100644 doc/kspread/a11y.docbook create mode 100644 doc/kspread/advanced.docbook create mode 100644 doc/kspread/basics.docbook create mode 100644 doc/kspread/cellformat0.png create mode 100644 doc/kspread/cellformat1.png create mode 100644 doc/kspread/cellformat2.png create mode 100644 doc/kspread/cellformat3.png create mode 100644 doc/kspread/cellformat4.png create mode 100644 doc/kspread/cellformat5.png create mode 100644 doc/kspread/cellformat6.png create mode 100644 doc/kspread/cellformat7.png create mode 100644 doc/kspread/cellprotection1.png create mode 100644 doc/kspread/cellprotection2.png create mode 100644 doc/kspread/chart1.png create mode 100644 doc/kspread/commands.docbook create mode 100644 doc/kspread/config.docbook create mode 100644 doc/kspread/configdialog.docbook create mode 100644 doc/kspread/configure1.png create mode 100644 doc/kspread/configure2.png create mode 100644 doc/kspread/configure3.png create mode 100644 doc/kspread/configure4.png create mode 100644 doc/kspread/configure5.png create mode 100644 doc/kspread/configure6.png create mode 100644 doc/kspread/copy1.png create mode 100644 doc/kspread/currency.png create mode 100644 doc/kspread/decreasedecimal.png create mode 100644 doc/kspread/faq.docbook create mode 100644 doc/kspread/format.docbook create mode 100644 doc/kspread/hideformula1.png create mode 100644 doc/kspread/hideformula2.png create mode 100644 doc/kspread/hideformula3.png create mode 100644 doc/kspread/hideformula4.png create mode 100644 doc/kspread/hideformula5.png create mode 100644 doc/kspread/importexport.docbook create mode 100644 doc/kspread/increasedecimal.png create mode 100644 doc/kspread/index.docbook create mode 100644 doc/kspread/kbd-focus-ext.png create mode 100644 doc/kspread/mousenav.png create mode 100644 doc/kspread/newdocument.png create mode 100644 doc/kspread/percent.png create mode 100644 doc/kspread/sheetproperties.png create mode 100644 doc/kspread/shortcut1.png create mode 100644 doc/kspread/shortcut2.png create mode 100644 doc/kspread/shortcut3.png create mode 100644 doc/kspread/sort1.png create mode 100644 doc/kspread/starting1.png create mode 100644 doc/kspread/tts.png create mode 100644 doc/kugar/Makefile.am create mode 100644 doc/kugar/add_detail.png create mode 100644 doc/kugar/add_detail_footer.png create mode 100644 doc/kugar/add_detail_header.png create mode 100644 doc/kugar/datadtd.docbook create mode 100644 doc/kugar/dataref.docbook create mode 100644 doc/kugar/designer.docbook create mode 100644 doc/kugar/file_new.png create mode 100644 doc/kugar/index.docbook create mode 100644 doc/kugar/kugar.png create mode 100644 doc/kugar/progguide.docbook create mode 100644 doc/kugar/props.png create mode 100644 doc/kugar/starting.docbook create mode 100644 doc/kugar/template-elements.docbook create mode 100644 doc/kugar/template.docbook create mode 100644 doc/kugar/templatedtd.docbook create mode 100644 doc/kugar/tut_edit_height.png create mode 100644 doc/kugar/tut_empty_report.png create mode 100644 doc/kugar/tut_file_new.png create mode 100644 doc/kugar/tut_rep_complete.png create mode 100644 doc/kugar/tut_rep_generated.png create mode 100644 doc/kugar/tut_rep_look1.png create mode 100644 doc/kugar/tut_rep_look2.png create mode 100644 doc/kugar/tut_set_level.png create mode 100644 doc/kugar/tutorial.docbook create mode 100644 doc/kword/ChooseTempDia.png create mode 100644 doc/kword/Makefile.am create mode 100644 doc/kword/Tut1.png create mode 100644 doc/kword/Tut11a.png create mode 100644 doc/kword/Tut11b.png create mode 100644 doc/kword/Tut13.png create mode 100644 doc/kword/Tut13a.png create mode 100644 doc/kword/Tut14.png create mode 100644 doc/kword/Tut14a.png create mode 100644 doc/kword/Tut14b.png create mode 100644 doc/kword/Tut15.png create mode 100644 doc/kword/Tut15b.png create mode 100644 doc/kword/Tut16.png create mode 100644 doc/kword/Tut18.png create mode 100644 doc/kword/Tut19.png create mode 100644 doc/kword/Tut2.png create mode 100644 doc/kword/Tut21.png create mode 100644 doc/kword/Tut22.png create mode 100644 doc/kword/Tut3.png create mode 100644 doc/kword/Tut4.png create mode 100644 doc/kword/Tut7.png create mode 100644 doc/kword/Tut8.png create mode 100644 doc/kword/a11y.docbook create mode 100644 doc/kword/addentry.png create mode 100644 doc/kword/addrecord.png create mode 100644 doc/kword/alignBlock.png create mode 100644 doc/kword/alignCenter.png create mode 100644 doc/kword/alignLeft.png create mode 100644 doc/kword/alignRight.png create mode 100644 doc/kword/auto1.png create mode 100644 doc/kword/auto2.png create mode 100644 doc/kword/auto3.png create mode 100644 doc/kword/auto4.png create mode 100644 doc/kword/autocompdlg.png create mode 100644 doc/kword/back.png create mode 100644 doc/kword/basic.png create mode 100644 doc/kword/basics.docbook create mode 100644 doc/kword/bbord.png create mode 100644 doc/kword/bdcolorbut.png create mode 100644 doc/kword/bdselbut.png create mode 100644 doc/kword/bdsizebut.png create mode 100644 doc/kword/beginning.png create mode 100644 doc/kword/bkgdcolorbut.png create mode 100644 doc/kword/bold.png create mode 100644 doc/kword/bookmarks.docbook create mode 100644 doc/kword/borbutB.png create mode 100644 doc/kword/borbutL.png create mode 100644 doc/kword/borbutR.png create mode 100644 doc/kword/borbutT.png create mode 100644 doc/kword/bord.png create mode 100644 doc/kword/bordtb.png create mode 100644 doc/kword/bullist.png create mode 100644 doc/kword/cftb.png create mode 100644 doc/kword/chapnumb.docbook create mode 100644 doc/kword/chcase.png create mode 100644 doc/kword/chcolorbut.png create mode 100644 doc/kword/chfontbut.png create mode 100644 doc/kword/chsizebut.png create mode 100644 doc/kword/chstylebut.png create mode 100644 doc/kword/clearright.png create mode 100644 doc/kword/colin.png create mode 100644 doc/kword/colorseldlg.png create mode 100644 doc/kword/colout.png create mode 100644 doc/kword/columns.docbook create mode 100644 doc/kword/ctab.png create mode 100644 doc/kword/ctab2.png create mode 100644 doc/kword/decindbut.png create mode 100644 doc/kword/delentry.png create mode 100644 doc/kword/delrecord.png create mode 100644 doc/kword/doccomments.docbook create mode 100644 doc/kword/doclinks.docbook create mode 100644 doc/kword/docstruct.docbook create mode 100644 doc/kword/docstruct.png create mode 100644 doc/kword/docvariables.docbook create mode 100644 doc/kword/dtab.png create mode 100644 doc/kword/dtab2.png create mode 100644 doc/kword/dtpfmtpg1.png create mode 100644 doc/kword/editcopy.png create mode 100644 doc/kword/editcut.png create mode 100644 doc/kword/editing.docbook create mode 100644 doc/kword/editpaste.png create mode 100644 doc/kword/edittb.png create mode 100644 doc/kword/end.png create mode 100644 doc/kword/enumlist.png create mode 100644 doc/kword/exoffset.png create mode 100644 doc/kword/expression.png create mode 100644 doc/kword/expressions.docbook create mode 100644 doc/kword/exst.png create mode 100644 doc/kword/exul.png create mode 100644 doc/kword/fchardlg.png create mode 100644 doc/kword/fchardlg2.png create mode 100644 doc/kword/fchardlg3.png create mode 100644 doc/kword/fchardlg4.png create mode 100644 doc/kword/fchardlg5.png create mode 100644 doc/kword/filefloppy.png create mode 100644 doc/kword/filenew2.png create mode 100644 doc/kword/fileopen.png create mode 100644 doc/kword/fileprint.png create mode 100644 doc/kword/fileprint2.png create mode 100644 doc/kword/filetb.png create mode 100644 doc/kword/find.png create mode 100644 doc/kword/finddlg.png create mode 100644 doc/kword/finddlg2.png create mode 100644 doc/kword/footcfg1.png create mode 100644 doc/kword/footcfg2.png create mode 100644 doc/kword/footcfg3.png create mode 100644 doc/kword/footend.png create mode 100644 doc/kword/footendnotes.docbook create mode 100644 doc/kword/formabs.png create mode 100644 doc/kword/formatchar.docbook create mode 100644 doc/kword/formatframes.docbook create mode 100644 doc/kword/formatpara.docbook create mode 100644 doc/kword/formbrac.png create mode 100644 doc/kword/formcbrac.png create mode 100644 doc/kword/formfrac.png create mode 100644 doc/kword/formframe1.png create mode 100644 doc/kword/formframe2.png create mode 100644 doc/kword/formframe3.png create mode 100644 doc/kword/formframe4.png create mode 100644 doc/kword/formframe5.png create mode 100644 doc/kword/formframe6.png create mode 100644 doc/kword/forminteg.png create mode 100644 doc/kword/formllind.png create mode 100644 doc/kword/formlrind.png create mode 100644 doc/kword/formmat.png create mode 100644 doc/kword/formover.png create mode 100644 doc/kword/formprod.png create mode 100644 doc/kword/formsbrac.png create mode 100644 doc/kword/formspecchar.png create mode 100644 doc/kword/formsqrt.png create mode 100644 doc/kword/formsum.png create mode 100644 doc/kword/formtb.png create mode 100644 doc/kword/formulas.docbook create mode 100644 doc/kword/formulind.png create mode 100644 doc/kword/formunder.png create mode 100644 doc/kword/formurind.png create mode 100644 doc/kword/forward.png create mode 100644 doc/kword/fpara1.png create mode 100644 doc/kword/fpara2.png create mode 100644 doc/kword/fpara3.png create mode 100644 doc/kword/fpara4.png create mode 100644 doc/kword/fpara5.png create mode 100644 doc/kword/fpicture.png create mode 100644 doc/kword/framers.png create mode 100644 doc/kword/frames.docbook create mode 100644 doc/kword/framestylist.png create mode 100644 doc/kword/fundimentals.docbook create mode 100644 doc/kword/graphics.docbook create mode 100644 doc/kword/headerfooter.docbook create mode 100644 doc/kword/incindbut.png create mode 100644 doc/kword/index.docbook create mode 100644 doc/kword/inscoldlg.png create mode 100644 doc/kword/insdate.png create mode 100644 doc/kword/insertfile.docbook create mode 100644 doc/kword/insgrph1.png create mode 100644 doc/kword/insgrph2.png create mode 100644 doc/kword/insrowdlg.png create mode 100644 doc/kword/instab1.png create mode 100644 doc/kword/instb.png create mode 100644 doc/kword/instime.png create mode 100644 doc/kword/intro1.png create mode 100644 doc/kword/intro2.png create mode 100644 doc/kword/intro3.png create mode 100644 doc/kword/ital.png create mode 100644 doc/kword/joincell.png create mode 100644 doc/kword/kbd-focus-ext.png create mode 100644 doc/kword/kformappcol.png create mode 100644 doc/kword/kformapprow.png create mode 100644 doc/kword/kforminscol.png create mode 100644 doc/kword/kforminsrow.png create mode 100644 doc/kword/kformremcol.png create mode 100644 doc/kword/kformremrow.png create mode 100644 doc/kword/kpart.png create mode 100644 doc/kword/kparts.docbook create mode 100644 doc/kword/landscape.png create mode 100644 doc/kword/larrow.png create mode 100644 doc/kword/lbord.png create mode 100644 doc/kword/linkdlg.png create mode 100644 doc/kword/listdepth1.png create mode 100644 doc/kword/listdepth2.png create mode 100644 doc/kword/listdepth3.png create mode 100644 doc/kword/lists.docbook create mode 100644 doc/kword/ltab.png create mode 100644 doc/kword/ltab2.png create mode 100644 doc/kword/mailmerge.docbook create mode 100644 doc/kword/mbtb.docbook create mode 100644 doc/kword/migrating.docbook create mode 100644 doc/kword/mmerge1.png create mode 100644 doc/kword/mmerge1a.png create mode 100644 doc/kword/mmerge2.png create mode 100644 doc/kword/mmergeab1.png create mode 100644 doc/kword/mmergekspread1.png create mode 100644 doc/kword/mmergesql1.png create mode 100644 doc/kword/mmergesql2.png create mode 100644 doc/kword/mousenav.png create mode 100644 doc/kword/numtxtbut.png create mode 100644 doc/kword/opendlg.png create mode 100644 doc/kword/opt.docbook create mode 100644 doc/kword/opt1.png create mode 100644 doc/kword/opt2.png create mode 100644 doc/kword/opt3.png create mode 100644 doc/kword/opt4.png create mode 100644 doc/kword/opt5.png create mode 100644 doc/kword/opt6.png create mode 100644 doc/kword/optkb.png create mode 100644 doc/kword/optkb2.png create mode 100644 doc/kword/opttb.png create mode 100644 doc/kword/pageformat.docbook create mode 100644 doc/kword/paratb.png create mode 100644 doc/kword/part-kformula.png create mode 100644 doc/kword/part-kspread.png create mode 100644 doc/kword/picture.png create mode 100644 doc/kword/pntdlg.png create mode 100644 doc/kword/pntdlg1.png create mode 100644 doc/kword/portrait.png create mode 100644 doc/kword/rarrow.png create mode 100644 doc/kword/rbord.png create mode 100644 doc/kword/redo.png create mode 100644 doc/kword/repldlg.png create mode 100644 doc/kword/rowin.png create mode 100644 doc/kword/rowout.png create mode 100644 doc/kword/rtab.png create mode 100644 doc/kword/rtab2.png create mode 100644 doc/kword/ruler.png create mode 100644 doc/kword/saturation.png create mode 100644 doc/kword/saved1.png create mode 100644 doc/kword/saved2.png create mode 100644 doc/kword/savedlg.png create mode 100644 doc/kword/savetmpl1.png create mode 100644 doc/kword/scan.png create mode 100644 doc/kword/scan2.png create mode 100644 doc/kword/screen.png create mode 100644 doc/kword/select1.png create mode 100644 doc/kword/spell.png create mode 100644 doc/kword/spelldlg.png create mode 100644 doc/kword/stkout.png create mode 100644 doc/kword/storeprint.docbook create mode 100644 doc/kword/styldlg1.png create mode 100644 doc/kword/styleimport.png create mode 100644 doc/kword/styles.docbook create mode 100644 doc/kword/subscbut.png create mode 100644 doc/kword/sum.png create mode 100644 doc/kword/supscbut.png create mode 100644 doc/kword/table.docbook create mode 100644 doc/kword/tableprop1.png create mode 100644 doc/kword/tableprop2.png create mode 100644 doc/kword/tablestylist.png create mode 100644 doc/kword/tabstops.docbook create mode 100644 doc/kword/tb1.png create mode 100644 doc/kword/tb2.png create mode 100644 doc/kword/tb3.png create mode 100644 doc/kword/tb4.png create mode 100644 doc/kword/tblsty.png create mode 100644 doc/kword/tbord.png create mode 100644 doc/kword/techinfo.docbook create mode 100644 doc/kword/tedittb.png create mode 100644 doc/kword/templatecreation.docbook create mode 100644 doc/kword/textstyex.png create mode 100644 doc/kword/tfcreatebut.png create mode 100644 doc/kword/thesaurus.png create mode 100644 doc/kword/toc.docbook create mode 100644 doc/kword/tts.png create mode 100644 doc/kword/tutorial.docbook create mode 100644 doc/kword/undl.png create mode 100644 doc/kword/undo.png create mode 100644 doc/kword/value.png create mode 100644 doc/kword/viewsize.png create mode 100644 doc/kword/wbw.png create mode 100644 doc/kword/wpfmtpg1.png create mode 100644 doc/kword/wpfmtpg2.png create mode 100644 doc/kword/wpfmtpg3.png create mode 100644 doc/kword/zoom.png create mode 100644 doc/thesaurus/Makefile.am create mode 100644 doc/thesaurus/index.docbook (limited to 'doc') diff --git a/doc/.directory b/doc/.directory new file mode 100644 index 00000000..6aa9870a --- /dev/null +++ b/doc/.directory @@ -0,0 +1,4 @@ +# KDE Config File +[KDE Desktop Entry] +BgImage= +Icon= diff --git a/doc/CookBook.odt b/doc/CookBook.odt new file mode 100644 index 00000000..7e950e34 Binary files /dev/null and b/doc/CookBook.odt differ diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 00000000..8016c150 --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1,7 @@ + + +KDE_LANG = en +KDE_DOCS = koffice +SUBDIRS = $(AUTODIRS) + +xdg_apps_DATA = koffice.desktop diff --git a/doc/TODO b/doc/TODO new file mode 100644 index 00000000..a3bd38ba --- /dev/null +++ b/doc/TODO @@ -0,0 +1,2 @@ +You can find status information and TODO items for KOffice +documentation in the CookBook.odt diff --git a/doc/api/Doxyfile.am b/doc/api/Doxyfile.am new file mode 100644 index 00000000..05aa7591 --- /dev/null +++ b/doc/api/Doxyfile.am @@ -0,0 +1,153 @@ +## generate API documentation with doxygen +apidox-am-yes: + @if test "$(subdir)" != "."; then \ + $(mkinstalldirs) $(top_builddir)/apidocs/$(subdir) ;\ + cp $(top_srcdir)/doc/api/Doxyfile.pim Doxyfile; \ + echo "PROJECT_NAME = \"$(subdir)\"" >> Doxyfile; \ + echo "PROJECT_NUMBER = \"Version $(VERSION)\"" >> Doxyfile; \ + echo "INPUT = $(srcdir)" >> Doxyfile; \ + echo "IMAGE_PATH = $(top_srcdir)/doc/api" >> Doxyfile ;\ + echo "OUTPUT_DIRECTORY = $(top_builddir)/apidocs" >> Doxyfile; \ + echo "HTML_OUTPUT = $(subdir)/html" >> Doxyfile; \ + echo "HTML_HEADER = $(top_srcdir)/doc/api/header.html" >> Doxyfile; \ + echo "HTML_FOOTER = $(top_srcdir)/doc/api/footer.html" >> Doxyfile; \ + echo "HTML_STYLESHEET = $(top_builddir)/apidocs/doxygen.css" >> Doxyfile; \ + echo "LATEX_OUTPUT = $(subdir)/latex" >> Doxyfile; \ + echo "RTF_OUTPUT = $(subdir)/rtf" >> Doxyfile; \ + echo "MAN_OUTPUT = $(subdir)/man" >> Doxyfile; \ + $(DOXYGEN) Doxyfile ;\ + sh $(top_srcdir)/doc/api/doxyndex.sh $(top_builddir)/apidocs $(subdir)/html ; \ + fi + +apidox-am-no: + +install-data-local: install-apidox + +## install API documentation +install-apidox: + @if test "$(subdir)" != "."; then \ + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html ; \ + if test -f $(top_builddir)/apidocs/$(subdir)/$(subdir).tag; then \ + echo $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/$(subdir).tag $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \ + $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/$(subdir).tag $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \ + fi; \ + if test -d $(top_builddir)/apidocs/$(subdir)/html; then \ + list=`ls $(top_builddir)/apidocs/$(subdir)/html`; \ + echo "installing $(top_builddir)/apidocs/$(subdir)/html" ;\ + for file in $$list; do \ + $(INSTALL_DATA) $(top_builddir)/apidocs/$(subdir)/html/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir)/html; \ + done; \ + fi; \ + rm -f $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/common; \ + $(LN_S) $(kde_libs_htmldir)/en/common $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/common; \ + else\ + if test -d $(top_builddir)/apidocs; then \ + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs ;\ + list=`cd $(top_builddir)/apidocs && ls -1`; \ + echo "installing $(top_builddir)/apidocs/$$file" ;\ + for file in $$list; do \ + if test -f $(top_builddir)/apidocs/$$file; then \ + $(INSTALL_DATA) $(top_builddir)/apidocs/$$file $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \ + fi; \ + done ; fi; \ + fi + +uninstall-local: uninstall-apidox + +## uninstall API documentation +uninstall-apidox: + @if test "$(subdir)" != "."; then \ + if test -d $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); then \ + rm -rfv $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs/$(subdir); \ + fi\ + else\ + if test -d $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; then \ + rm -rfv $(DESTDIR)$(kde_htmldir)/en/$(PACKAGE)-apidocs; \ + fi\ + fi + +apidox: + @if test "$(subdir)" != "."; then \ + $(MAKE) apidox-am-@KDE_HAS_DOXYGEN@ ;\ + else \ + $(MAKE) apidox-am-toplevel-@KDE_HAS_DOXYGEN@ ;\ + fi + @set fnord $(MAKEFLAGS); amf=$$2; if test -n '$(SUBDIRS)'; then \ + list='$(SUBDIRS)'; \ + for subdir in $$list; do \ + if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am > /dev/null ; then \ + echo "Making apidox in $$subdir"; \ + if test "$$subdir" != "."; then \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=no apidox) || exit 1; \ + fi ; fi ;\ + done; \ + for subdir in $$list; do \ + if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am > /dev/null ; then \ + echo "Making apidox in $$subdir"; \ + if test "$$subdir" != "."; then \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) GENERATE_FLAG=yes apidox) || exit 1; \ + fi ; fi ;\ + done; \ + fi + +apidox-am-toplevel-no: +apidox-am-toplevel-yes: + @echo "*** Creating API documentation main page"; \ + cp $(top_srcdir)/admin/Doxyfile.global Doxyfile; \ + echo "PROJECT_NAME = \"$(DOXYGEN_PROJECT_NAME)\"" >> Doxyfile ; \ + echo "PROJECT_NUMBER = \"$(DOXYGEN_PROJECT_NUMBER)\"" >> Doxyfile ; \ + echo "INPUT = $(top_srcdir)" >> Doxyfile ; \ + echo "OUTPUT_DIRECTORY = $(top_builddir)/apidocs" >> Doxyfile ; \ + echo "FILE_PATTERNS = *.dox" >> Doxyfile ; \ + echo "RECURSIVE = NO" >> Doxyfile ; \ + echo "SOURCE_BROWSER = NO" >> Doxyfile ; \ + echo "ALPHABETICAL_INDEX = NO" >> Doxyfile ; \ + echo "HTML_OUTPUT = ." >> Doxyfile ; \ + echo "HTML_HEADER = $(top_srcdir)/doc/api/mainheader.html" >> Doxyfile ; \ + echo "HTML_FOOTER = $(top_srcdir)/doc/api/mainfooter.html" >> Doxyfile ; \ + echo "HTML_STYLESHEET = $(top_builddir)/apidocs/common/doxygen.css" >> Doxyfile ; \ + echo "GENERATE_LATEX = NO" >> Doxyfile ; \ + echo "GENERATE_RTF = NO" >> Doxyfile ; \ + echo "GENERATE_MAN = NO" >> Doxyfile ; \ + echo "GENERATE_XML = NO" >> Doxyfile ; \ + echo "GENERATE_AUTOGEN_DEF = NO" >> Doxyfile ; \ + echo "ENABLE_PREPROCESSING = NO" >> Doxyfile ; \ + echo "CLASS_DIAGRAMS = NO" >> Doxyfile ; \ + echo "HAVE_DOT = NO" >> Doxyfile ; \ + echo "GENERATE_HTML = YES" >> Doxyfile ;\ + $(mkinstalldirs) $(top_builddir)/apidocs ; \ + rm -f $(top_builddir)/apidocs/common ; \ + if test -d $(top_srcdir)/doc/common; then \ + common_dir=`cd $(top_srcdir)/doc/common && pwd` ;\ + else \ + common_dir=$(kde_libs_htmldir)/en/common ;\ + fi ;\ + $(LN_S) $$common_dir $(top_builddir)/apidocs/common ;\ + doxygen Doxyfile; \ + rm -f Doxyfile + @true > $(top_builddir)/apidocs/subdirs + @$(MAKE) apidox-am-tree PARENT="" PARENTINDENT="" + @sort $(top_builddir)/apidocs/subdirs | sed -e 's+++' > $(top_builddir)/apidocs/subdirs_ && mv $(top_builddir)/apidocs/subdirs_ $(top_builddir)/apidocs/subdirs + @sh $(top_srcdir)/doc/api/doxyndex.sh $(top_builddir)/apidocs . + + +apidox-am-tree: + @if test -n '$(SUBDIRS)' ; then \ + list='$(SUBDIRS)' ; \ + for subdir in $$list ; do \ + if test "x$$subdir" != "x."; then \ + if grep '^include .*Doxyfile.am' $(srcdir)/$$subdir/Makefile.am > /dev/null ; then \ + echo "Making apidox index in $$subdir"; \ + echo "
  • $(PARENTINDENT)$$subdir
    • " >> $(top_builddir)/apidocs/subdirs ; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) apidox-am-tree PARENT="$(PARENT)/$$subdir" PARENTINDENT='\ \ $(PARENTINDENT)' ) || exit 1; \ + fi ; \ + fi ; \ + done ; \ + fi + +.PHONY: apidox-am-yes apidox-am-no install-data-local install-apidox install-apidox uninstall-local uninstall-apidox uninstall-apidox apidox apidox-am-toplevel-no apidox-am-toplevel-yes apidox-am-tree + + +# Local Variables: +# mode: makefile +# End: diff --git a/doc/api/Doxyfile.koffice b/doc/api/Doxyfile.koffice new file mode 100644 index 00000000..76049d36 --- /dev/null +++ b/doc/api/Doxyfile.koffice @@ -0,0 +1,191 @@ +PROJECT_NAME = +PROJECT_NUMBER = +OUTPUT_DIRECTORY = ../apidocs/ +OUTPUT_LANGUAGE = English +USE_WINDOWS_ENCODING = NO +BRIEF_MEMBER_DESC = NO +REPEAT_BRIEF = YES +ABBREVIATE_BRIEF = +ALWAYS_DETAILED_SEC = YES +INLINE_INHERITED_MEMB = NO +FULL_PATH_NAMES = NO +STRIP_FROM_PATH = +SHORT_NAMES = NO +JAVADOC_AUTOBRIEF = YES +MULTILINE_CPP_IS_BRIEF = NO +DETAILS_AT_TOP = NO +INHERIT_DOCS = YES +DISTRIBUTE_GROUP_DOC = NO +TAB_SIZE = 4 +ALIASES = obsolete=@deprecated +OPTIMIZE_OUTPUT_FOR_C = NO +OPTIMIZE_OUTPUT_JAVA = NO +SUBGROUPING = YES +EXTRACT_ALL = NO +EXTRACT_PRIVATE = NO +EXTRACT_STATIC = YES +EXTRACT_LOCAL_CLASSES = NO +HIDE_UNDOC_MEMBERS = NO +HIDE_UNDOC_CLASSES = YES +HIDE_FRIEND_COMPOUNDS = NO +HIDE_IN_BODY_DOCS = NO +INTERNAL_DOCS = NO +CASE_SENSE_NAMES = YES +HIDE_SCOPE_NAMES = NO +SHOW_INCLUDE_FILES = YES +INLINE_INFO = YES +SORT_MEMBER_DOCS = NO +SORT_BRIEF_DOCS = NO +SORT_BY_SCOPE_NAME = NO +GENERATE_TODOLIST = NO +GENERATE_TESTLIST = NO +GENERATE_BUGLIST = YES +GENERATE_DEPRECATEDLIST= YES +ENABLED_SECTIONS = +MAX_INITIALIZER_LINES = 30 +SHOW_USED_FILES = YES +QUIET = YES +WARNINGS = NO +WARN_IF_UNDOCUMENTED = NO +WARN_IF_DOC_ERROR = YES +WARN_FORMAT = +WARN_LOGFILE = +INPUT = +FILE_PATTERNS = *.h \ + *.cpp \ + *.cc \ + *.hpp \ + *.dox \ + *.c++ \ + *.cxx \ + *.h++ \ + *.hh +RECURSIVE = YES +EXCLUDE = +EXCLUDE_SYMLINKS = NO +EXCLUDE_PATTERNS = *.moc.* \ + moc* \ + *.all_cpp.* \ + *unload.* \ + */test/* \ + */tests/* \ + *_p.h +EXAMPLE_PATH = +EXAMPLE_PATTERNS = +EXAMPLE_RECURSIVE = NO +IMAGE_PATH = +INPUT_FILTER = +FILTER_SOURCE_FILES = NO +SOURCE_BROWSER = YES +INLINE_SOURCES = NO +STRIP_CODE_COMMENTS = YES +REFERENCED_BY_RELATION = YES +REFERENCES_RELATION = YES +VERBATIM_HEADERS = YES +ALPHABETICAL_INDEX = YES +COLS_IN_ALPHA_INDEX = 3 +IGNORE_PREFIX = K +GENERATE_HTML = NO +HTML_OUTPUT = +HTML_FILE_EXTENSION = .html +HTML_ALIGN_MEMBERS = YES +GENERATE_HTMLHELP = NO +CHM_FILE = +HHC_LOCATION = +GENERATE_CHI = NO +BINARY_TOC = NO +TOC_EXPAND = NO +DISABLE_INDEX = YES +ENUM_VALUES_PER_LINE = 4 +GENERATE_TREEVIEW = NO +TREEVIEW_WIDTH = 250 +GENERATE_LATEX = NO +LATEX_OUTPUT = +LATEX_CMD_NAME = latex +MAKEINDEX_CMD_NAME = makeindex +COMPACT_LATEX = NO +PAPER_TYPE = a4wide +EXTRA_PACKAGES = +LATEX_HEADER = +PDF_HYPERLINKS = NO +USE_PDFLATEX = NO +LATEX_BATCHMODE = NO +LATEX_HIDE_INDICES = NO +GENERATE_RTF = NO +RTF_OUTPUT = +COMPACT_RTF = NO +RTF_HYPERLINKS = NO +RTF_STYLESHEET_FILE = +RTF_EXTENSIONS_FILE = +GENERATE_MAN = NO +MAN_OUTPUT = +MAN_EXTENSION = .kde3 +MAN_LINKS = YES +GENERATE_XML = NO +XML_OUTPUT = xml +XML_SCHEMA = +XML_DTD = +XML_PROGRAMLISTING = NO +GENERATE_AUTOGEN_DEF = NO +GENERATE_PERLMOD = NO +PERLMOD_LATEX = NO +PERLMOD_PRETTY = YES +PERLMOD_MAKEVAR_PREFIX = +ENABLE_PREPROCESSING = YES +MACRO_EXPANSION = NO +EXPAND_ONLY_PREDEF = NO +SEARCH_INCLUDES = YES +INCLUDE_PATH = +INCLUDE_FILE_PATTERNS = +PREDEFINED = QT_VERSION=320 \ + __cplusplus \ + Q_WS_X11 +EXPAND_AS_DEFINED = +SKIP_FUNCTION_MACROS = YES +TAGFILES = +GENERATE_TAGFILE = +ALLEXTERNALS = NO +EXTERNAL_GROUPS = NO +PERL_PATH = +CLASS_DIAGRAMS = YES +HIDE_UNDOC_RELATIONS = NO +HAVE_DOT = NO +CLASS_GRAPH = YES +COLLABORATION_GRAPH = YES +UML_LOOK = NO +TEMPLATE_RELATIONS = YES +INCLUDE_GRAPH = YES +INCLUDED_BY_GRAPH = YES +CALL_GRAPH = NO +GRAPHICAL_HIERARCHY = YES +DOT_IMAGE_FORMAT = png +DOT_PATH = +DOTFILE_DIRS = +MAX_DOT_GRAPH_WIDTH = 800 +MAX_DOT_GRAPH_HEIGHT = 1024 +MAX_DOT_GRAPH_DEPTH = 0 +GENERATE_LEGEND = YES +DOT_CLEANUP = YES +SEARCHENGINE = NO + +#----------------------------------------------------------------------- +# KOffice Settings +#----------------------------------------------------------------------- + +HTML_ALIGN_MEMBERS = NO +REFERENCED_BY_RELATION = NO +REFERENCES_RELATION = NO +VERBATIM_HEADERS = NO +GENERATE_LATEX = NO +GENERATE_RTF = NO +GENERATE_MAN = NO +GENERATE_XML = NO +GENERATE_HTML = YES +SOURCE_BROWSER = NO +GENERATE_AUTOGEN_DEF = NO +ENABLE_PREPROCESSING = NO +CLASS_DIAGRAMS = NO +HAVE_DOT = NO +IGNORE_PREFIX = K +EXTRACT_ALL = NO + diff --git a/doc/api/doxyndex.sh b/doc/api/doxyndex.sh new file mode 100644 index 00000000..a310c8e9 --- /dev/null +++ b/doc/api/doxyndex.sh @@ -0,0 +1,60 @@ +#! /bin/sh +# +# A shell script to post-process doxy-generated files; the purpose +# is to make the menu on the left in the file match the actually +# generated files (ie. leave out namespaces if there are none). +# +# Usage: doxyndex.sh +# +# Typically, this means $(top_builddir)/apidocs and something like +# libfoo/html for the output. For the top-level dig, set relative-html +# to "." . In non-top directories, both and +# are calculated and replaced. Top directories get an empty +# if any. + +WRKDIR="$1/$2" +TOPDIR=`echo "$2" | sed -e 's+[^/][^/]*/+../+g' -e 's+html$+..+'` +echo "Postprocessing files in $WRKDIR ($TOPDIR)" + +# Special case top-level to have an empty MENU. +if test "x$2" = "x." ; then +MENU="" +else +MENU="
      " + +# This is a list of pairs, with / separators so we can use basename +# and dirname (a crude shell hack) to split them into parts. For +# each, if the file part exists (as a html file) tack it onto the +# MENU variable as a
    • with link. +for i in "Main Page/index" \ + "Modules/modules" \ + "Namespace List/namespaces" \ + "Class Hierarchy/hierarchy" \ + "Alphabetical List/classes" \ + "Class List/annotated" \ + "File List/files" \ + "Namespace Members/namespacemembers" \ + "Class Members/functions" \ + "Related Pages/pages" +do + NAME=`dirname "$i"` + FILE=`basename "$i"` + test -f "$WRKDIR/$FILE.html" && MENU="$MENU
    • $NAME
      • " +done + +MENU="$MENU
    " +fi + + +# Get the list of global Menu entries. +GMENU=`cat "$1"/subdirs | tr -d '\n'` + +PMENU=`grep '++' | awk '{ c=split($0,a,"/"); for (j=1; j<=c; j++) { printf " / %s\n" , a[j]; } }' | tr -d '\n'` + +# Now substitute in the MENU in every file. This depends +# on HTML_HEADER (ie. header.html) containing the comment. +for i in "$WRKDIR"/*.html +do + sed -e "s++$MENU+" -e "s++$GMENU+" -e "s++$PMENU+" < "$i" | sed -e "s+@topdir@+$TOPDIR+g" > "$i.new" && mv "$i.new" "$i" +done + diff --git a/doc/api/header.html b/doc/api/header.html new file mode 100644 index 00000000..b6b7b877 --- /dev/null +++ b/doc/api/header.html @@ -0,0 +1,70 @@ + + + + + + $title ($projectname) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    +
    +

    $projectname

    + + diff --git a/doc/api/kfontdialog.png b/doc/api/kfontdialog.png new file mode 100644 index 00000000..8d834d46 Binary files /dev/null and b/doc/api/kfontdialog.png differ diff --git a/doc/api/mainheader.html b/doc/api/mainheader.html new file mode 100644 index 00000000..780ae3d7 --- /dev/null +++ b/doc/api/mainheader.html @@ -0,0 +1,71 @@ + + + + + + $title ($projectname) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Name +Tel No. + + +Joan +699 23 43 12 + + +Adam +711 19 77 21 + + + + + + +Terms and definitions: +A single data which constitutes a part of a greater collection can be called a +row or more professionally a +record. +The collection is normally called a table. +Moreover, the most natural name for the table is one describing the data it +offers/stores which is Contacts. +Furthermore, each row in the table consists of columns +often also called fields. In the table +Contacts there are two columns (fields): +Name and Tel No.. + + +For simple uses a single table can make up a database. +Many people consider these two equivalent. +As you will see, for real databases we usually need more than one table. + + +To sum up, you have already got a simple database with one table +Contacts. + + + + + +Database and Spreadsheet + +It is very likely that you have already used spreadsheet applications like +KSpread, OpenOffice.org Calc or Microsoft Excel. If so, you will probably +wonder: since both spreadsheets and databases have tables, why should I use +the latter? + + +While comparing spreadsheets and databases you may encounter the following issues which you will later see in greater detail: + + +Referential +data integrity +Data redundancy + +Data integrity +and validity +Limiting data view +Performance and +capacity +Convenient data entry +Reports +Programming +Multiuse +Security + + + +How Is a Database Different From a Spreadsheet? + + +Gradually exceeding the capacity of a mobile phone, expand your table +Contacts adding a column (field) +Address. Add more telephone numbers +(office, home) for each person and add surnames to names. +To make it simpler we assume the following: + + +the table is limited to two people (obviously, +there could be hundreds and thousands of them in a real +database) +there are no two persons with the same name and surname + + +Contacts table + + + + +Name and surname +Tel +Address + + +Joan Smith +699 23 43 12 +Western Gate 1, Warsaw + + +Adam Willson +711 19 77 21 +London, Frogs Drive 5 + + +Joan Smith +110 98 98 00 +Western Gate 1 + + +Smith Joan +312 43 42 22 +Warsaw, Western Gate 1 + + +ADAM Willson +231 83 02 04 +Frogs Drive 5, London + + + + + + +Such a table can be made both in a spreadsheet and in a database. +Using a spreadsheet is very easy, of couse. What problems do we +encounter at this stage? + + + +Referential data integrity + +Suppose you are using a spreadsheet and you need to change the address of at +least one person. You have a small problem: you often have to change the +address in many rows. For example, Joan takes three rows. A real problem +will arise if you forget to change one of the rows - the address asigned +to this person will be ambiguous, hence +your data loses integrity. + + +Moreover there is no simple way of deleting a chosen person from the table +since you have to remember about deleting all rows releted to him or her. + + + + + +Data redundancy + +This is directly connected to the previous problem. In fields +Name and surname and Address +the same data is entered many times. This is typical of a spreadsheets' +ineffective way of storing data because the database grows unnecessarily, +thus requiring more computer resources (larger size of data and slower access). + + +How can you solve these problems with a database? You can split information +into smaller chunks by creating an additional table Persons +with only two columns: Name and surname +and Address: + + +Persons table + + + + +Name and surname +Address + + +Joan Smith +Western Gate 1, Warsaw + + +Adam Willson +Frogs Drive 5, London + + + + + + +Each row in the table Persons corresponds to a +single person. Table Contacts +is from now on a relation to the table Persons +. + + + + + +Data integrity and validity + +Note the way data is entered in the fields Name and surname +and Address. People entering data can be fallible, +sometimes even negligent. In our sample data we have both different sequence +of entering name and surname (Joan Smith and Smith Joan; Adam and ADAM) and +many more ways of entering the same address. Surely you can think of many +other ways. + + +The above problem shows that ⪚ when searching the telephone number of a +person whose address is "Western Gate 1, Warsaw" you will not get a full +result. You will get only one row instead of three. Moreover You will also +not find all the telephone numbers searching for the value "Joan Smith" in +the field Name and surname, because "Smith Joan" will +not fit to "Joan Smith". + + +How can you solve these problems using a database? You can do this by changing the design of the table Persons by: + + + +Dividing data in the field Name and +surname into two separate fields: Name +and Surname. + + +Dividing data in the field Address +into three separate fields: Street, House +number and City. + + +Guaranteeing data correctness: by ensuring that no fields +are empty, ⪚ you must always enter house number. + + + + +A modified table looks something like this: + + +Persons table + + + + + + + + + +Name +Surname +Street +House number +City + + +Joan +Smith +Western Gate +1 +Warsaw + + +Adam +Willson +Frogs Drive +5 +London + + +Conditions + + +required field +required field +required field +required field +required field + + + + + + +Thanks to introducing the condition required field we can +be sure that the entered data is complete. In case of other tables you may +of course allow omitting certain fields while entering data. + + + + + +Limiting data view + +A spreadsheet displays all rows and columns of the table which is bothersome +in case of very large data sheets. You may of course filter and sort rows +in spreadsheets, however you must be extra careful while doing so. Spreadsheet +users are in risk of forgetting that their data view has been filtered what +can lead to mistakes. For example, while calculating sums you may think you +have 100 rows of data while in fact there are 20 rows more hidden. + + +If you want to work on a small subset of data, ⪚ to send it for others to edit, you can copy and paste it to another spreadsheet and after editing paste the changed data back to the main spreadsheet. Such "manual" editing may cause data loss or incorect calculations. + + +To limit the data view database applications offer +queries, forms +and reports. + + +A very practical way of limitting is the following extended version of +the previously described table Persons: + + +Persons table + + + + +Name +Surname +Street +House number +City +Income + + +Joan +Smith +Western Gate +1 +Warsaw +2300 + + +Adam +Willson +Frogs Drive +5 +London +1900 + + + + + + +Let's assume that the newly introduced column Income +contains confidential data. How can you share ⪚ contact details of the +persons with your coworkers but without revealing their +income? It is possible if you share only a query and +not the whole table. The query could select all columns except +for the column Income. In database world such a query +is often known as a view. + + + + + +Performance and capacity + +Your computer is probably quite fast, however you will easily see that it +doesn't help with slow, large spreadsheets. Their low efficiency is first +of all due to lack of indexes accelertaing the process of data search +(databases do offer them). Moreover if you use things like system clipboard, +even copying data may become troublesome with time. + + +Spreadsheets containing large data sets may take ages to open. A spreadsheet +loads lots of data to the computer's memory while opening. Most of the data +loaded are probably useless/unneccessary for you at the moment. Databases +unlike spreadsheets load data from computer storage only when needed. + + +In most cases you will not have to worry how the database stores its data. +This means that unlike spreadsheets, databases do not care about: + + + +The sequence of rows since you can order the rows according to your needs. +Moreover, you can view the same data in many views with different orders. + + +The same goes for columns (fields) of the table. + + + + +Together with Limiting data view +described in the previous paragraph these qualities constitute the +advantage of databases. + + + + + +Data entry + +The latest editions of applications for creating spreadsheets enable you +to design data-entry forms. Such forms are most useful if your data cannot +be conveniently displayed in tabular view, ⪚ if the text occupies +too many rows or if all the columns do not fit on the screen. + + +In this case the very way the spreadsheet works is problematic. +Fields for data entry are placed loosely within the spreadsheet +and very often are not secure against the user's (intentional +or accidental) intervention. + + + + +Reports + +Databases enable grouping, limiting and summing up data in a form of a +report. Spreadsheets are usually printed in a form +of small tables without fully automatic control over page divisions and +the layout of fields. + + + + +Programming + +Applications for creating databases often contain full programming languages. +Newer spreadsheets have this capability too, however calculations come down +to modifying the spreadsheet's fields and simple data copying, regardless of +the relevance and integrity rules mentioned in previous paragraphs. + + +Data processing within a spreadsheet is usually done via a graphical user's +interface which may slow down the data processing speed. Databases are +capable of working in background, outside of graphical interfaces. + + + + +Multiuse + +It is hard to imagine a multiuse of one spreadsheet. Even if it is technically +possible in the case of the latest applications, it requires a lot of +discipline, attention and knowledge from the users, and these cannot +be guaranteed. + + +A classical way to sharing data saved in a spreadsheet with other person is +to send a file as a whole (usually using e-mail) or providing a spreadsheet +file in a computer network. This way of work is ineffective for larger +groups of people - data that could be needed in a particular time may +be currently locked by another person. + + +On the other hand, databases have been designed mainly with multiuser +access in mind. Even for the simplest version locking at a particular table +row's level is possible, which enables easy sharing of table data. + + + + +Security + +Securing a spreadsheet or its particular sections with a password is only +symbolic activity. After providing a spreadsheet file in a computer network, +every person being able to copy the file can try to break the password. +It is sometimes not so hard as the password is stored in the same file +as the spreadsheet. + + +Features for edit locking or copy locking of a spreadsheet (or its part) +is equally easy to break. + + +Databases (except these saved in a file instead of a server) do not need +to be available in a single file. You're accessing them using a computer +network, usually by providing a user name and a password. You are gaining +access only to these areas (tables, forms or even selected rows and columns) +which were assigned to you by setting appropriate access rights. + + +Access rights can affect ability of data editing or only data reading. +If any data is not avaliable to you, it will not be even sent to your +computer, so there is no possibility of making a copy of the data in such +easy way as in case of spreadsheet files. + + + + + + + +Database Design + +Database design needs careful planning. Note that Contacts +table redesign proposed in section 1.2 can generate problems when the +table is filled with data. For example, renaming a field is a simple task, +but splitting the Address field into separate fields +requires careful and tedious work. + + +To avoid such situations, rethink your database project +before you create it in your computer, and before you and others will start +to use it. Thus, by investing some time initially, you will most probably +save your time on everyday use. + + + + +Who Needs a Database? + +Stick to spreadsheets if: + +Your needs are limited and your data will never grow to +large volumes (can you actually forecast that now?) + + +You are unable to acquire the methodology of database construction. +You may however consider either outsourcing this task to someone else +or using simpler tools. + + +You use complicated spreadsheets and you lack time or money to switch +to databases. Think or ask someone whether this does not lead down a +blind alley. Don't count on magical tools that would change your +spreadsheet (regardless how well made) into a database. + + + + +Consider using databases if: +Your data collection expands every week. + +You often create new spreadsheets, copy within these and you feel +that this work is getting more and more tedious. In this case the +effort of switching to databases easily pays off. + + +You create reports and statements for which the table view of +a spreadsheet is not suitable. You can then consider switch +to using a database with form views. + + + + + +Database Creation Software + +So far you have learnt the general characteristics of databases without +going into much detail about specific applications for designing them. + + +The first databases were built together with large mainframe computers +in the 60s, ⪚ IBM System/360. Those were not the days of PCs, +therefore these databases required a highly specialized personnel. +Although the old computers' hardware was unreliable, they were immeasurably +slower and had less storage capacity, one feature of databases still remains +most attractive: the data access by many users through a network. + + +In the 70s scientists formed the theory of relational databases +(terms like: table, record, +column (field) and relationality +and many others). +On the basis of this theory IBM DB2 and Oracle databases were created, +which have been developed and used till today. In the late 70s the first +PCs were constructed. Their users could (gradually) utilize many types of +applications, including those for database construction. + +When it comes to large databases in companies, the situation +hasn't changed: +they still require powerful computers or computer complexes called +clusters. This goes, however, beyond the topic +of this manual. + + +In the area of "accessible" databases with graphic user interface +for PCs you can choose from the following: + + + + +DBase +- a tool for databases operation for DOS popular in the 80s. Files in DBase format +are still used in some specific cases due to their simplicity. + + +FoxPro +- an application similar to DBase (early 90s). After being taken over by +Microsoft, graphic user interfaces were introduced and therefore it is +used for creating databases on PCs. This product is still offered, though +seems a bit obsolete. + + +Microsoft Access +- an application for databases (data and graphic interface design) with many +simplifications, therefore suitable for beginners, designed in the late 80s, +based on 16-Bit Architecture. This product is offered and widely used till today, especially +by small companies, where efficiency and multiuser requirements are not very demanding. + + +FileMaker +- popular application similar to MS Access in simplicity, operating on Windows +and Macintosh platforms, offered since 1985. + + +&kexi; +- a multiplatform application (Unix/Linux, Windows, Mac OS X) designed in 2003, +developed according to OpenSource principles, part of the global +K Desktop Environment project, +&ie; graphic environment for Unix/Linux systems. A significant contributor +to &kexi;'s development is the OpenOffice Poland company. + + + + + + diff --git a/doc/kexi/designingforms.docbook b/doc/kexi/designingforms.docbook new file mode 100644 index 00000000..b205fe71 --- /dev/null +++ b/doc/kexi/designingforms.docbook @@ -0,0 +1,1480 @@ + + + + Designing Forms + + + Most important terms + + + Form + + + A window provided for easy data entry and presentation on the + computer screen. + + + + + Form's data source + + + Database table or query providing data displayed in the + form. The data source is needed because forms itself are only + tools for displaying and entering data, + while tables and queries are the source of data. New, empty + forms have no data source assigned, so they are not displaying + any data from your database unless you assign a data source + to them. + + + + + Form field + + + Direct equivalent of a column in a table or query. Most frequently + used are fields for displaying text and numbers. Entering a new + value or changing the existing value of such a field causes a change + in the bound table or query column (after accepting the change). + + + + + Form design + + + Tasks you are performing to define the appearance and functions of + the form. To do this, you need to provide + data source, + insert form fields + of various types and place them at the appropriate location. + + + + + Form widget + + Form's element. Main widget types are: + + + + Widgets displaying information, ⪚ a text box or an image box. Each + widget of this type can be bound to a data + source field (a table or a query column). Therefore, such widgets + are called in short form fields. + + + + + Widgets able to perform a specified action, ⪚ a push button + that can close the current form. Within other applications this + widget type is sometimes called form control + because it can perform previously defined action of + controlling your database application's + behavior. + + + + + Other widgets allowing to enrich a form's appearance, ⪚ + a line widget can visually separate two form + areas. + + + + + + + Container widget + + + A widget that can contain other widgets within + its area. For example, frame widget or tab widget are containers. + The form's surface itself is a container as well. A command button cannot + be called as container because it is not possible to insert a widget + inside it. In more complex cases, container widgets can be inserted + inside a container, so nesting is possible. + + + + + + + + + Forms versus tables + + In chapter + 5.2 you learned about how to enter data directly into tables using their + data sheet view. However, in many cases forms are better suited for data + entry: + + + + + A table can contain too many columns to display them on your + screen. A form can display such a data using multiple rows. + + + + + A form allows to visually split data fields + into logical groups, thus increasing readability. Labels with + additional information can be inserted to give users more hints + on how to use the form or what given data fields mean. + + + + + Command buttons can be used within forms for commonly used commands + so users can use forms in a similar way as a standalone applications they + know. + + + + In data sheet view displaying multi-row data text + fields or images + is as easy as within forms. + + + + + + + Working with form design + As with table or query design, you are able to use Data View + and Design View. Form designing is performed in + Design View. We will often refer to the form design window as to + Form Designer. + + + + To create a new empty form, select + Insert + Form + from the Menubar. Optionally, you can use + + New Form + command from drop-down button on the Project Navigator's + toolbar or Create Object: Form command from the context menu. + + + + A new frame will appear, you can resize the form by moving the + borders. The form is covered with a grid which simplifies + accurate positioning of the widgets. + + + + + As with table design, Form Designer provides + Property pane. To save some space on the screen, + the pane has three tabs related to the currently + selected form: + + + + The Properties tab + + Contains a list of properties for the currently selected widget. + + + + + + The Data source tab + + + + Contains properties related specifically to the data source + of the currently selected widget or the form itself. + + + + + + + The Widgets tab + + + + Contains a hierarchy of all widgets of the form. The list simplifies + widgets lookup by name and navigation between them. + + + + + + There is information about currently selected widget's name and type displayed + on the first and second tab. + + Additional toolbars are also available: + + + + The Widgets toolbar used for inserting new widgets + into the form + + + + + The Format toolbar used to format form's elements (⪚ + adjusting widget's size, grouping). Formatting commands are also available + in the Format menu. More about these commands can be found + in . + + + + + + + + Using the <guilabel>Widgets</guilabel> tab + + The Widgets tab in the Property pane provides + a list of form widgets and their hierarchy. Each widget is presented + within the hierarchy beside other widgets being on the same level + (the same parent container). Child widgets (inside containers) are + presented using indented names. + + + + Each widget has displayed its name and type. The type has also an icon + displayed - the same as the one displayed on the toolbar used while + form designing is performed. + + + + + + Changing the current selection on the list causes appropriate selection + on the designed form. This allows for easier widget lookup by name and + easier navigation. For example, it is possible to select a widget by + name, and then switch to the Properties tab to change the + widget's properties. + + + + Keeping the Ctrl key pressed while an item on the + widgets list is being selected allows to select multiple widgets at a time. + Keeping the Shift key pressed allows to select entire lists + of widgets. + + + + + + Giving widgets reasonable names can be useful but is not mandatory. Note + that widget's name is a property that is not visible to the user of your form. + Users will only see a widget text, provided by Text property + or similar. + + + + + Inserting widgets - text fields + + Let's create a form providing information about persons, i.e. a form connected + it with Persons table. + + + If the form being designed should present data obtained from the database, + you need to place appropriate fields + on it. To do this, use the buttons on the Widgets toolbar. Each button corresponds to a single widget type. + + + + + Click + Text Box button on the Widgets toolbar. + + + + + Click on the form surface with the left mouse + button. A new text box widget will be placed in the point where you clicked. + Before you release you can drag your mouse to specify a desired size for the widget. + + + + + If needed, move the inserted widget using drag & drop to a desired + position. You can resize the widget afterwards by dragging one of the + small boxes appearing near its corners. Note that the boxes are only + visible when the widget is selected. If you select another widget or the + form surface, the boxes disappear. + + + + Click the Text Box toolbar button again and click + on the form surface to insert another widget. Repeat this action once + again until you get three text boxes inserted in your form. For sake of + simplicity we will limit ourselves to three data + fields. + + + + + + + + There is a context menu available in form's design mode, activated by a + right mouse button click the desired widget + or the form's surface. The menu offers commands like + Cut, + Copy, + Paste, + Delete + and other, more complex. Many of the commands are also provided in the + Menubar, usually Edit. + Keyboard shortcuts are also available for these commands. Some of the + commands are only available for certain types of widgets. + + + + + The commands + Cut, + Copy and + Paste + makes it possible to move or copy widgets between forms, even between separate + database projects. + + + + + Holding the Ctrl key down while clicking a widget allows to select + multiple widgets. + + + + + Instead of using + Copy + and + Paste + commands, to duplicate a widget within the same form you can hold down the + Ctrl key while moving the widget. After the Ctrl + key is released, the dragged widget will not be moved but copied in the new location. + + + + + + + + Assigning data sources + + The fields you inserted + have no data source assigned yet, + so these are not able to display information from the database. To assign data + source, use the + Data Source tab of the Property pane. + + + The very first step is to specify the form's data source, + i.e. a place the displayed data will be fetched from. As mentioned above, you + will use table persons as a + data source + for your new form. + + + + Click on the form's surface, as you will alter its properties. + + + + Switch to the + Data Source tab and enter persons + table name in the Form's data source drop down list. + Alternatively, you can select this name from the drop down list. + + + + + + You have assigned form's data source. Now you need to do specify + widget's data source. + + + + Click the first text field widget at the top of the form. + + + + In the Data Source + tab of the property pane enter field name name in the + Widget's data source drop down list. Alternatively, you can select + this name from the drop down list. + + + + + Click on next text field widget and enter surname as the data source. + + + + Enter data sources for street, house_number + and city text fields + in a similar way. + + + + + You can now save the form's design (this is not mandatory to test the + form in action). To save, click the + + Save object changes toolbar button or use the + CtrlS + File + Save + menu command. Upon saving you will be asked for entering the form's name. Enter + Persons as caption and click the OK + button. The form's name will be filled automatically. + + + This is the right moment for testing your form. Click the + Switch to data view toolbar button. Unless you made a + mistake while entering data sources, you should see + form's fields filled + with data from the persons table. + + + + + + + If you want to remove widget's data source + assignment for a form widget, you can use + Clear widget's data source button near + the Widet's data source drop down list. Similarly, you can use the + + Clear form's data source button near the + Form's data source drop down list. + + + + + Use the + Go to selected form's data source button to select + appropriate table or query in the Project Navigator, + so you can quickly open a table or query being the + data source + of the form. + + + + + + + + + Inserting text labels + + To make it easier for the form's user to identify the meaning of every field + widget, these should have added text labels with appropriate titles. To + create text labels the + Label widget is used. + + + Insert three text label widgets onto the form, placing them on the left + side of the text fields (or on the right hand if your operating system + uses right-to-left layout). On inserting a new label, a text cursor + appears at the location where you can enter the desired title. Enter consecutively: + Name, Surname and Street. Additionally, + on the top of the form insert another label displaying name of the form, + i.e. Persons. Enlarge this label's size and and increase the font size using + + FormatFont... + + menu command. + + + + + + Actions + + An Action is a single activity isolated in the application, + available for the user to execute. It can also be executed automatically as a + reaction for a given event (⪚ after opening a form). + + + + Assigning actions to form buttons + + Many actions can be assigned to form button. The assigned action is executed + after button is clicked. + + To assign action: + + + Switch to form's Design view if you have not done yet. + + + + Select the existing button widget by clicking on it or put a new button + widget onto the form. If you inserted a new button, enter its title and + press Enter key. + + + + + Click the button widget with the right mouse + button to display the context menu. + + + + + From the context menu select + + Assign action... command. + + + + + An Assigning Action to Command Button dialog window + will appear presenting a list of available actions. One of the actions + is selected if the widget already has action assigned. Otherwise the + Action type drop down list has the No type + item selected. + + + + + From the Action type drop down list select + Application item. Available application-wide actions + will be listed. + + + + Select one of the actions on the list (⪚ Delete Row). + + + + Click the OK button or press + the Enter key to + accept your selection. + + + + + + After switching to the form's data view you can try + whether the action works. For example, if you assigned Delete Row + action, clicking the button, the current database row will be deleted, similarly + to executing CtrlDeleteEditDelete Row + menu command (depending on your settings you may be asked to confirm the removal). + + + + + + + To remove an action assignment, select No type item from + the Action type drop down list of the + Assigning Action to Command Button dialog window. + + + + + Actions only work in the form's data view. Not every + action's assignment is reasonable. For example, the + Font... action is available in data view, but + only if you have a widget selected in the Design view. If you + make changes to the font settings the changes are applied to the text + of that selected widget. + + + + + + + + + Widget layouts + + In most cases form widgets should be conveniently arranged and aligned. + Positioning, aligning and resizing widgets by hand is not easy and these + parameters are not adjusted when the user resizes the form. In fact the + situation is even worse because you cannot assume a given form requires + a given space because users have different font sizes and display resolutions. + + + + Using special tool called widget layouts can help to automatically lay + out the form widgets. Widget layout is an action of grouping two or more + widgets so these are well positioned and have appropriate sizes. + + + Using layout in a form improves alignment. Moreover, its space is + better used. Text fields are closer to each other, spacing is constant. + + + There are two methods to create widget layout. + + + + Select two or more widgets that should be placed in a common layout, + and select one of the layout types from the context menu item + + Layout Widgets + . + + + + + Click a container widget (or a form surface itself), where widgets are + inserted and select one of the layout types from the context menu item + Layout Widgets + . + All widgets existing within the container or within the + form, being on the same level will be put into a single common layout. + + + + + In each of these cases you can also use + FormatLayout Widgets + menu. + + + + Widget layout is presented in the design view using a blue, green or + red box drawn with a broken line. This line is displayed only in the + form's design view. + + + Besides the grid type, there are other widget layout types. + + + vertical + + Vertical widget layout + + + + + horizontal + + Horizontal widget layout + + + + + + + + Springs in widget layouts + + A spring in widget layouts is a special, invisible element allowing + to adjust widget's position and size within layouts. Such a spring + stretches or squeezes a widget on the right, top, bottom or left hand, + so it can have desired size and position. + + To use a spring: + + + + Select spring icon on the + Widgets toolbar. + + + + Click on a selected point of the form to insert the spring. + + + + + To make springs work you need to create a global widget layout, i.e. a + layout for the form itself. Then, springs can use edges of the form as + a boundary for expanding. + + + + + + Removing widget layouts + + To remove widget layout without removing widgets, perform one of + these actions: + + + + + Click with the right mouse button on + the layout's border and select Break Layout + command from the context menu. + + + + + Click with the left mouse button on + the layout's border and select + FormatBreak Layout + menu command. + + + + + + Removing widget layout using the Break Layout + command will not remove widgets contained in the layout. If you want to + remove the widgets as well, just select the layout by clicking on its + border and press Delete key or use + Edit + Delete + menu command or context menu command. + + + + + + Size policies for widgets within a layout + + Instead of setting a fixed size for your widgets, in &kexi; you can + choose between various widget's size policies. A size policy + is a flexible strategy for controlling how a widget is stretched (or shrunk) + depending on other neighbouring widgets and space available within the form. + + + After putting widgets into a layout, typically each widget + gets a proportional (Preferred) size policy. These widgets + will be automatically resized with preferred settings, depending on their + type and size of the entire layout itself. For example, three buttons put + into the horizontal layout will be resized to fit their visible text. + + For each widget inserted into the form, there are settings for size policy + available in the Property Editor. The settings are presented + as a group of properties called Size Policy. + + + This group of properties contains: + + + Horizontal Size Policy + + defining horizontal size of the widget, + + + + Vertical Size Policy + + defining vertical size of the widget, + + + + Horizontal Stretch + + + defining strength of activity of the + Horizontal Size Policy, + + + + + Vertical Stretch + + + defining strength of activity of the + Vertical Size Policy + + + + + + + Values of size policies + + The following values are available in the drop down list for + Horizontal Size Policy and + Vertical Size Policy properties visible + in the Property Editor: + + + + Fixed + + + this value means that the widget cannot be automatically resized; it + should maintain the constant size defined at design time (width or height), + + + + + Minimum + + + this value means that the original size of the widget is set as minimal + allowed, it is sufficient and there is no need for expanding the widget, + but the widget will be expanded if needed. This type of policy can be used + to force the widget to be expanded to the whole width or height, especially + if you set a stretch value greater than 0. + + + + + + Maximum + + + this value means that the original size of the widget is set as maximum + allowed and can be decreased without breaking the widget's usability + and readability if other widgets need more space, + + + + + Preferred + + + this value means that the original size of the widget is the best and + preferred; the widget can be shrunk or expanded however and it + will stay readable, + + + + + + Expanding + + + this value means that the original size of the widget is reasonable but + the widget can be also shrunk; it can be expanded as well to take + as much space as possible, + + + + + Minimum Expanding + + + this value means that the original size of the widget is allowed; it + can be expanded to take as much space as possible, + + + + + Ignored + + + this value means that the original size of the widget is ignored; the + widget can be expanded to take as much space as possible but other + widgets usually will not allow for that + + + + + + Different widget types have various default size policies; for example, + button widgets have default size policy set to Minimum (in both directions), + while text field widgets have vertical size policy set to Fixed. + + + The most frequently used size policies are Preferred, + Minimum and Maximum. + + + + + Vertical and horizontal stretch + + The Vertical Stretch and Horizontal Stretch + properties accept integer values greater than or equal to 0. These properties allow to fine-tune the + behavior of size policies. The default value for the properties is 0. + A higher value of the stretch means that the widget will be expanded + more than widgets for which a lower stretch value is set. + + + + + + + + Setting widgets size and position by hand + In case when your form has no main layout set for auto-positioning and + auto-resizing its widgets, you will probably want to modify the position and size of widgets so the form can look cleaner and be easier to use. The &kexi; form + designer simplifies this task by offering the following groups of commands: + + + + + Adjusting sizes of selected widgets. The commands are available in the + FormatAdjust Widgets Size + submenu of the menubar and in the + Adjust Widgets Size + submenu of the context menu. The toolbar's drop down + button Adjust Widgets Size + is also available. + + + + To Fit + + + The size of the selected widgets will be altered so each widget will be + resized to its preferred size and its contents; for example, a text + label's size will be changed to fit its text. The position of the widgets + will not be changed. + + + + + To Grid + + + The size of the selected widgets will be altered so each widget's corner + will be placed on the form's (or other container's) grid point. + The widget's position can be slightly altered. + + + + + To Shortest + + + The height of the selected widgets will be altered so that each of them + will have the same height as the shortest one. The position of the widgets + will not be changed. + + + + + To Tallest + + + The height of the selected widgets will be altered so that each of them + will have the same height as the tallest one. The position of the widgets + will not be changed. + + + + + To Narrowest + + + The width of the selected widgets will be altered so that each of them + will have the same height as the narrowest one. The position of the + widgets will not be changed. + + + + + To Widest + + + The width of the selected widgets will be altered so that each of them + will have the same height as the widest one. The position of the widgets + will not be changed. + + + + + + + + Aligning positions of the selected widgets. The commands are available + in the + FormatAlign Widgets Position + submenu of the menubar and in the + Align Widgets Position + submenu of the context menu. The toolbar's drop + down button + Align Widgets Position is also available. + + + + To Left + + + All the selected widgets' left positions will be moved to the + position of the leftmost widget's left edge. + + + + + To Right + + + All the selected widgets' right positions will be moved to the + position of the rightmost widget's right edge. + + + + + To Top + + + All the selected widgets' top positions will be moved to the + position of the uppermost widget's upper edge. + + + + + To Bottom + + + All the selected widgets' bottom positions will be moved to the + position of the bottommost widget's bottom edge. + + + + + To Grid + + + All the selected widgets' top-left corners will be moved so that + they are positioned in the nearest grid point. + + + + + None of the above commands resizes the widgets. + + + + There are also additional commands available: + Bring Widget to Front + (i.e. above all other widgets) and + Send Widget to Back (i.e. below all + other widgets). These two commands are rarely used, as it is not + common to place one widget on top of an other (except when a + container widget contains other widget inside). Also note that clicking + a widget with a mouse button is enough to bring the widget to front. + + + + + Setting the tab order + + A widget's focus determines that widget's activity available using keyboard. + Focus is related to widgets displayed in the form's data view. Exactly one + form widget can have focus at the same time. The most frequent use of focus + is text entry (when a given text field is active, i.e. it is focused). + An other example is a button widget - when focused, it is possible to + press it using the Enter + or Space key instead of a mouse button. + + + There are a few methods of making the widgets active (moving the focus + to the widget): clicking with a mouse button, rotating the mouse wheel + over the widget, or using the Tab + key. The latter method is often used because of its speed and convenience + for users. Availability of the focusing methods is controlled by + Focus Policy property of a given widget. + + + There is a relationship between focusing (activating) widgets using Tab + key and tab order setting of a form. After pressing the Tab key, the + next widget should be focused, so the form should know about the tab order. + + To alter tab order for a form's widget: + + + Switch to design view of the form. + + + + Execute EditEdit Tab Order... + menu command. The Edit Tab Order dialog will appear with settings for this form. + + + + The window contains a list with two columns: the first column displays + widget names, the second - types of the widgets. To make it easier to + recognize meaning of the names and types for the user, icons related + to the types are also displayed. The list contains only widgets having + focus policy allowing to use the Tab key. The window + allows you to change the tab order or set the automatic tab order. + + + + To change tab order, either: + + + + Click a selected widget name in the widgets list and drag it + to a desired position (up or down) using the mouse. + + + + + Click a selected widget name on the widgets list and use + Move Up or Move Down + buttons, to move the widgets to a desired position. + + + + + Click the Handle tab order automatically check box to set the + automatic tab order for the form. If this option has been switched + on, any changes made to the list of widgets by hand are not taken + into account - &kexi; will be handling the tab orders on its own. + The automatic ordering means that the top-left widget will be focused + first (or the top-right if your operating system uses right-to-left + layout), and the order comes from the left to right (from the right + to left, respectively) and from the top to bottom. + + + + + + + + Click the OK button to accept the changes or Cancel button to dismiss + the changes. + + + + + diff --git a/doc/kexi/enteringdataintotables.docbook b/doc/kexi/enteringdataintotables.docbook new file mode 100644 index 00000000..d65c17d3 --- /dev/null +++ b/doc/kexi/enteringdataintotables.docbook @@ -0,0 +1,130 @@ + + + + Entering Data Into Tables + + You have designed the two tables Persons and + phone_numbers. None of them contain any data yet. You can + enter some, and in this chapter you will learn how to do this fast and effectively. + + + + + Start with the persons table. Open it in Data View using the Project Navigtor's context menu. + The current cell is marked with + (usually black) thicker border, a cell cursor. The contents + of the cell, if present, are highlighted with a different color. The current + row, i.e. the one you have placed your rectangular cursor in, is marked + on the left hand with an arrow symbol. + + + + You can navigate through table cells using the arrow keys, Page Down, + Page Down, Home, End keys; you can also + click with the mouse in a cell to select it. + + + Initially, after opening the table Persons, the cursor is placed in + the id column. The column has autonumber property defined, + marked with blue (autonumber) text in the last row. It + means you do not have to enter values there by hand when entering data for a new + row because the cell will be filled automatically with successive numbers. + + + + + + Inserting new rows and entering data for them in &kexi; is different from + the way of doing this in spreadsheets. To enter data for a new row, you need + to use the arrow keys or mouse, to move your cursor to the special empty last + row marked with a plus + sign. Place your cursor in the (second) name column and enter a + person's name. Also enter surname, street, house number and city. When + done, move the cell cursor to the last empty row either by using the + Arrow Down key or by clicking in the last + row with the mouse to append a new row. + + + Details About Actions Available While Entering Data Into Tables + + + + As soon as you enter the first character, the current row is being edited. A pencil symbol appears on the left side of the data table. + + + + + Double clicking a cell with the &LMB; or pressing Enter or the F2 key also starts + editing of the current row. + + + + + Pressing the Esc key when the contents of a cell is edited + cancels changes made to this cell. However, the pencil + + symbol will not disappear because you can still move to a different cell + of the edited row to change its contents. To + cancel changes made to the entire edited row, press the + Esc key again. + + + + + Instead of pressing the Esc key, you can click the + Cancel + toolbar button or select + DataCancel Row Changes + from the menubar. + + + + + Click the ShiftEnter + keys to accept changes made to all cells in the currently edited row. You can also click + OK toolbar + button or select DataSave Row + from the menubar. + + + + + + + + Fill the phone_numbers table with data. In the persons column you + need to provide a number of the person existing in the persons + table. + + + + + diff --git a/doc/kexi/enteringdatausingforms.docbook b/doc/kexi/enteringdatausingforms.docbook new file mode 100644 index 00000000..08fcb627 --- /dev/null +++ b/doc/kexi/enteringdatausingforms.docbook @@ -0,0 +1,33 @@ + + + + Entering Data Using Forms + + Data entering and editing is usually the task of the user of the database application. The designer of the database should check the form in terms of valid + data entry, and see whether the form works as expected. + + + To test your form, switch to its data view. A single database row (record) + of data will be displayed and a text cursor will be set inside the first + data field. You can move between fields using the &LMB; or the Tab and + ShiftTab + keys. While editing, there will be a + + pencil icon visible near the record navigator. After entering the row's (record) + data you can press the + ShiftEnter + keys or click the + OK + toolbar button to accept changes made to the current row. Clicking the + Cancel + toolbar button discards changes made to the current row and restores the contents of + the data fields. You can use the + record navigator's button to move to a new row. All the navigator's functions are + also available in a similar way as in the data table view + . + + + diff --git a/doc/kexi/index.docbook b/doc/kexi/index.docbook new file mode 100644 index 00000000..04692e4c --- /dev/null +++ b/doc/kexi/index.docbook @@ -0,0 +1,122 @@ + + + + + + + + + + + + + + + + + + + + +]> + + + + + + The &kexi; Handbook + + + + + + Martin + A. + Ellis + + martin.ellis@kdemail.net + + + + Jaroslaw + Staniek + + js@iidea.pl + + + + + + 2004 + 2005 + 2006 + Jaroslaw Staniek + Martin Ellis + + + + +&FDLNotice; + + + +2006-09-07 +1.6 + + + + + &kexi; is the application for creating databases and for data management + in the &koffice; productivity suite. + + + + + + KDE + KOffice + Kexi + database + + + + + + +&intro; +&basics; +&building; +&configuration; +&menus; +&credits; +&database; +&comparing; + +&documentation.index; + + + diff --git a/doc/kexi/intro.docbook b/doc/kexi/intro.docbook new file mode 100644 index 00000000..dc62ba00 --- /dev/null +++ b/doc/kexi/intro.docbook @@ -0,0 +1,78 @@ + + + +Introduction + + + + + &kexi; is a database management application. It can be used for + creating databases, inserting data, performing queries, and processing + data. Forms can be created to provide a custom interface to your + data. All database objects - tables, queries and forms - are stored in + the database, making it easy to share data and design. + + + + &kexi; is part of the &koffice; productivity suite for the K Desktop + Environment. + + + + In addition to storing your &kexi; databases in files, &kexi; can also + store your data on a database server. Using + a database server allows you to share your database with other + people, and also allows more than one person to use the database at + one time. The following database servers are supported by &kexi;: + + + + MySQL (See http://www.mysql.com/) + + + + + PostgreSQL (See http://www.postgresql.org/) + + + + + + + More information about &kexi; can be found at the &kexi; page on the + &koffice; website + at http://www.koffice.org/kexi/, + and on the website for &kexi; itself + at http://www.kexi-project.org/about.html. + + + + If you have any questions about &kexi;, there are two mailing lists + you can use. The Kexi user mailing + list can be used to ask questions about using &kexi; or about + the &kexi; project. The Kexi + development mailing list can be used to ask questions about + the development of &kexi;. Further information on how to subscribe + to these lists, together with a few other ways of making contact with + &kexi; developers, can be found at: + + + + http://www.kexi-project.org/support.html + + + + + + diff --git a/doc/kexi/menus.docbook b/doc/kexi/menus.docbook new file mode 100644 index 00000000..8428fcaf --- /dev/null +++ b/doc/kexi/menus.docbook @@ -0,0 +1,701 @@ + + + + + + + Anne-Marie + Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + + + Jarosław + Staniek + + js@iidea.pl + + +     +     + Command Reference + + + The <guimenu>File</guimenu> Menu + + + + + + &Ctrl;N + + File + New... + + Create a new project. Currently opened project is not affected. + + + + + + &Ctrl;O + + File + Open... + + Open an existing project. Currently opened project is not affected. + + + + + + File + Download Example Databases... + + + + Open the KNewStuff dialog which + allows you to download example databases via the + Internet. This is currently not available for MS Windows. + + + + + + + + &Ctrl;S + + File + Save + + + + Saves object changes from the active window. + + + + + + + File + Import + Data Table... + + + + Imports table data from a file in Comma Separated Value (CSV) format. + + + + + + + File + Export + Table or Query as Data Table... + + + + Export data from the active table or query data to a file in Comma Separated Value (CSV) format. + + + + + + +&Ctrl;P + +File +Print... + +Print data from the active (opened) table or query. +Note for KDE: Make sure the proper print system is selected in the +Print system currently used: section. This option can +be seen after clicking on the Options>> button. + + + + +File +Print Preview... + +Show print preview for the active (opened) table or query. + + + + +File +Page Setup... + +Set Font... for the Page title:, +Change... Page Size & Margins and +Add table borders. + + + + + + + &Ctrl;W + + File + Close Project + + + + Close the currently opened project but leave &kexi; running. + + + + + + + + + &Ctrl;Q + + File + Quit + + + + Quit &kexi;. + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + + +&Ctrl;Z + +Edit +Undo + +Undoes an action. You can revert to the state that existed +before your last change. + + + + + +&Ctrl; &Shift; Z + +Edit +Redo + +Undoes an undo. Reverse the action of Undo. This will restore the change +you originally made. + + + + + +&Ctrl;X + +Edit +Cut + +Remove currently selected text and put it on the clipboard. +This command is unavailable if there is no text currently selected. If this action is used +in the Form Designer, currently selected widget or group of widgets are removed and put on the clipboard. + + + + + + +&Ctrl;C + +Edit +Copy + +Copy currently selected text onto the clipboard. +This command is unavailable if there is no text currently selected. If this action is used +in the Form Designer, currently selected widget or group of widgets are copied onto +the clipboard. + + + + + +&Ctrl;V + +Edit +Paste + +Copy of the clipboard contents at the insertion point. +This command is unavailable if the clipboard is empty. If this action is used +in the Form Designer and the clipboard contains copied widgets, they will be inserted +onto the form. + + + + +Edit +Copy Special +Table or Query As Data Table... + +Copy selected table or query data to clipboard. + + + + +Edit +Paste Special +As Data Table... + +Paste clipboard data to a new table within the current project. + + + + + + +&Ctrl;A + +Edit +Select All + +Select all characters in the edited text box or all widgets in the Form Designer. + + + + + +Edit +Delete + +Delete the currently selected object. + + + + + +&Ctrl;Delete + +Edit +Delete Row + +Delete currently selected row from a table. + + + + + + +The <guimenu>View</guimenu> Menu + + + + +F6 +View +Data View + +Switch to Data View. + + + + +F7 +View +Design View + +Switch to Design View. + + + + +F8 +View +Text View + +Switch to Text View. Currently, only available for database queries +and means switching to the SQL View of the Query Designer. + + + + + +&Alt;1 + +View +Project Navigator + +Go to Project Navigator pane. + + + + + +&Alt;2 + +View +Main Area + +Go to the main area. + + + + + +&Alt;3 + +View +Property Editor + +Go to the Property Editor pane. + + + + +View +Show/Hide Properties + +Display or hide the Property Editor pane. + + + + +View +Show/Hide Project Navigator + +Display or hide the Project Navigator pane. + + + + + + +The <guimenu>Insert</guimenu> Menu + + + + +Insert +Table... + +Inserts a new, empty table design without saving it. +The Table Designer window will appear. + + + + +Insert +Query... + +Inserts a new, empty query design without saving it. +The Query Designer window will appear. + + + + +Insert +Form... + +Inserts a new, empty form design without saving it. +The Form Designer window will appear. + + + + +Insert +Script... + +Inserts a new, empty script design without saving it. +The Script Editor window will appear. The command is available only if scripting +is enabled in &kexi;. + + + + + + +The <guimenu>Format</guimenu> Menu + + + + +Format +Font... + +Change font for selected object. +Can be used in the Form Designer to set widget's font. + + + + + + +Format +Snap to Grid + +If this is enabled, when moving widgets on the form surface +the top left corner of the widget will snap or move to the nearest grid point. +This does reduce your freedom to freely position widgets on the form surface, +however it also helps to line up widgets precisely. + + + + +Format +Layout Widgets + +Creates a new layout for widgets. Widgets can be layed out Horizontally, Vertically, In Grid, Horizontally in Splitter, Vertically in Splitter. + + + + +Format +Break Layout + +Breaks the currently selected layout. + + + + +Format +Align Widgets Position + +Align the currently selected widgets' position: +To Left, To Right, To Top, To Bottom, To Grid. + + + + +Format +Align Widgets Size + +Align the currently selected widgets' size: +To Fit, To Grid, To Shortest, To Tallest, To Narrowest, To Widest. + + + + +Format +Bring Widget to Front + +Bring the currently selected widgets to front. + + + + +Format +Send Widget to Back + +Send the currently selected widgets to back. + + + + + + +The <guimenu>Data</guimenu> Menu + + + + + + +&Shift;Return + +Data +Save Row + +Save currently selected table row's data. + + + + +Data +Cancel Row Changes + +Cancel changes made to currently selected table row. + + + + +Data +Sort +Ascending + +Sorts data in ascending order (from A to Z and from 0 to 9). +Data from selected column is used for sorting. + + + + +Data +Sort +Descending + +Sorts data in descending (from Z to A and from 9 to 0). +Data from selected column is used for sorting. + + + + + + +The <guimenu>Tools</guimenu> Menu + + + + +Tools +Import Database... + +Opens the Data Base Importing Wizard +to import an existing database into a &kexi; database. + + + + +Tools +Execute Script File... + +Displays the file dialog +to open an existing script file. + + + + +Tools +Scripts Manager... + +Displays &kexi;'s Scripts Manager +dialog to execute, load, unload, install, unistall or download scripts. + + + + +Tools +Scripts + +Executes an already loaded script. + + + + + + +The <guimenu>Window</guimenu> Menu + + + + + +&Ctrl;W + +Window +Close + +Close the active window. + + + + +Window +Close All + +Close all opened windows. + + + + +Window +MDI Mode +Childframe Mode + +Switch to Childframe user interface mode. + + + + +Window +MDI Mode +IDEAl Mode + +Switch to IDEAl user interface mode. + + + + + +&Alt;Right + +Window +Next Window + +Switch to the next window. + + + + + +&Alt;Left + +Window +Previous Window + +Switch to the previous window. + + + +The last items in this menu show the currently opened window names. + + + + The <guimenu>Settings</guimenu> Menu + + + + + + + Settings + Toolbars + + + + Show or hide one of the toolbars. + + + + + + + Settings + Configure Shortcuts... + + + + Configure the keyboard shortcuts used by &kexi;. + See the section on configuring shortcuts for more + details. + + + + + + + + + The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + +     diff --git a/doc/kexi/querydesigning.docbook b/doc/kexi/querydesigning.docbook new file mode 100644 index 00000000..5114dbd0 --- /dev/null +++ b/doc/kexi/querydesigning.docbook @@ -0,0 +1,109 @@ + + + + Designing Database Queries + + A database's primary purpose is to store and help extract information + you are looking for. Unlike databases written on a paper sheets, &kexi; + database allows you to specify more search criteria. Results + are returend faster even for large data sets. All this is a power of + databases, however to be able to perform efffective queries + in your database, you need to learn how to tell the database what you are + looking for. + + + With database queries you can limit data coming from a table to a predefined + set of rows and columns as well as dynamically join + data coming from multiple tables. + + + To see how queries work in practice you will create a contacts + query joining data from two tables: persons and + phone_numbers (designed in + chapter 3.1i + + and filled with data in + chapter 3.2 + ). + + + + + Create a new empty query by selecting + InsertQuery from + the menubar. The design window will appear. The window is split into two areas: query + relationships at the top and query columns below. + + + + + + Select the table persons in the drop down list Table: + located at the top of the window and click the Add button. A graphical + representation of the table will appear in the relations area. Do the same for the + phone_numbers table to insert it too, as in the figure below. + + + + + + Add query relationship using mouse drag & drop technique: click the field + id in the table persons table, drag it + and drop into the person field of the phone_numbers + table. This will join both fields by creating a new relationship. + + + + + Double-click the name field in the persons + table, to add the field as a query column. In a similar way, + add surname, street, house_number, + city fields from the persons table and + phone from the phone_numbers table. + + + + + Query design is now ready for testing. Click the + Switch to data view button on the toolbar, to switch from + design to viewing the data provided as query results. + + + + + + Save the query design for later use by clicking the + Save button on the toolbar. You can also use + FileSave + from the menubar or press the CtrlS + keys. Because the query design has not been saved yet, you will be asked to + specify a name for it. Enter Contacts text in the + caption field and click the OK button. + + + + diff --git a/doc/kformula/Makefile.am b/doc/kformula/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kformula/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kformula/ambiguous-string.png b/doc/kformula/ambiguous-string.png new file mode 100644 index 00000000..83aafdc5 Binary files /dev/null and b/doc/kformula/ambiguous-string.png differ diff --git a/doc/kformula/correct_index_location.png b/doc/kformula/correct_index_location.png new file mode 100644 index 00000000..65f07d18 Binary files /dev/null and b/doc/kformula/correct_index_location.png differ diff --git a/doc/kformula/definite_integral.png b/doc/kformula/definite_integral.png new file mode 100644 index 00000000..16af377e Binary files /dev/null and b/doc/kformula/definite_integral.png differ diff --git a/doc/kformula/file-toolbar.png b/doc/kformula/file-toolbar.png new file mode 100644 index 00000000..39ea201d Binary files /dev/null and b/doc/kformula/file-toolbar.png differ diff --git a/doc/kformula/file-toolbar2.png b/doc/kformula/file-toolbar2.png new file mode 100644 index 00000000..3c2f94d3 Binary files /dev/null and b/doc/kformula/file-toolbar2.png differ diff --git a/doc/kformula/green1.png b/doc/kformula/green1.png new file mode 100644 index 00000000..880f5768 Binary files /dev/null and b/doc/kformula/green1.png differ diff --git a/doc/kformula/green2.png b/doc/kformula/green2.png new file mode 100644 index 00000000..132cfb9f Binary files /dev/null and b/doc/kformula/green2.png differ diff --git a/doc/kformula/greens.png b/doc/kformula/greens.png new file mode 100644 index 00000000..8f1abfc3 Binary files /dev/null and b/doc/kformula/greens.png differ diff --git a/doc/kformula/incorrect_index_location.png b/doc/kformula/incorrect_index_location.png new file mode 100644 index 00000000..33b7238b Binary files /dev/null and b/doc/kformula/incorrect_index_location.png differ diff --git a/doc/kformula/index.docbook b/doc/kformula/index.docbook new file mode 100644 index 00000000..f142b689 --- /dev/null +++ b/doc/kformula/index.docbook @@ -0,0 +1,1246 @@ + + + + + +]> + + + + +The &kformula; Handbook + + + + +Jonathan +Drews +
    j.e.drews@att.net
     +     + +Anne-Marie +Mahfouf +
    annma@kde.org
     +     + +Alfredo +Beaumont Sainz +
    alfredo.beaumont@gmail.com
     +     + +Ulrich +Küttler +Developer + + + +     + +2002 +Jonathan Drews + + +2005 +Anne-Marie Mahfouf + + +2006 +Alfredo Beaumont Sainz + +&FDLNotice; + +2006-09-09 +1.5.90 + + + +&kformula; is used to layout formulas. + + + + + +KDE +KOffice +kformula +formula + + +     + + +Introduction +&kformula; is used to write formulas. It doesn't evaluate +anything. All it does is print them. +&kformula; was designed for your editing pleasure. It makes it +delightful to enter Greek letters, fractions and all the stuff that +makes a formula look like a formula. +But most of the time you won't want to use &kformula; itself. +Instead you might choose to use it from within &kword; or any other +&koffice; application. That is &kformula; is not a useful application +on its own but an extension to all the other &koffice; applications +you've fallen in love with. + +Where ever &kformula; gets embedded, it will +behave the same. + + + + +Basics +A new (empty) &kformula; document looks like a small blue square. +This square stands for the central idea of &kformula;. It represents an +empty list. The idea of &kformula; is to have different elements +arranged in lists. An element in this respect might be a single char +or a root symbol or something like that. The lists are put together so +that they form a formula. That is there are lists for indexes, lower +and upper bounds and so on. And of course there is the main +list, which we've already seen. + +Writing a formula means to fill the empty list with letters, +figures and mathematical symbols. That is straightforward: use your +keyboard. As soon as you type something the empty +symbol will vanish and you will see whatever you have inserted +instead. New characters are always put at the current cursor +position. + +There is a toolbar called Add that allows +you to create more complex elements. There are indices, fractions, +roots and matrices to name a few. All these elements +consist of at least one list, you can move the cursor into and insert +new items. + + + + +Using &kformula; + Below is a typical formula entry in &kformula;. To enter the partial +derivatives and Greek letters click on the symbol combo box, on the +right, and select the appropriate symbol. The symbol combo box, in the figure +below, has the word +Cap on it. Click on the return key symbol to the right of it, +to enter a symbol. + +Screenshot of &kformula; + + + + + + Screenshot of &kformula; + + + + + The Greens formula above can be printed to a &PostScript; +file. To do that choose FilePrint + and configure print as shown below: + + +Here's a screenshot of Greens Formula in &kformula; + + + + +Here's a screenshot of Greens Formula in &kformula; + + + + +Here is what the the resulting &PostScript; file should look +like: + + +Here is the &PostScript; output from &kformula; + + + + + + + + +More &kformula; features + +More on formulas +To enter matrices, click on the [ ] and then click +on the matrix symbol + + . +You can move from matrix element to matrix element using the arrow +keys Right arrow, Up arrow, +Down arrow and Left arrow. An example matrix +is shown below. + + +Here is the resulting matrix; + + + + + + + + + + +Command Reference + + +The Main &kformula; Window + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New + +Creates a new &kformula; +document. + + + + + +&Ctrl;O + +File +Open... + +Opens a previously saved +document. + + + + +File +Open Recent + +Displays a selection of recently opened documents. + + + + + +&Ctrl;S + +File +Save + +Saves the document. + + + + +File +Save As... + +Saves the document with a name you provide. + + + + +File +Reload + +Reloads the more recently opened document. + + + + +File +Import + +Imports formulas from other formats. + + + + +File +Export + +Exports the current document in another format. + + + + +File +Mail... + +Invokes &kmail; so you can email the file. +The file is already attached to the email. + + + + + +&Ctrl;P + +File +Print... + +Prints the document. + + + + +File +Print Preview... + +Shows how the printed document will appear. + + + + +File +Document Information + +Provides a dialog box where you can enter your name, +email address and a short description about the document. + + + + + +&Ctrl;W + +File +Close + +Closes the current document. + + + + + +&Ctrl;Q + +File +Quit + +Quits &kformula;. + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + + +&Ctrl;Z + +Edit +Undo + +Undoes an action. You can revert to the state that existed +before your last change. + + + + + +&Ctrl; &Shift; Z + +Edit +Redo + +Undoes an undo. Reverse the action of Undo. This will restore the change +you originally made. + + + + + +&Ctrl;X + +Edit +Cut + +Cuts a highlighted piece of text from the &kformula; screen. + + + + + +&Ctrl;C + +Edit +Copy + +Copies a highlighted piece of text from the &kformula; screen. + + + + + +&Ctrl;V + +Edit +Paste + +Pastes the text you selected with Cut or Copy to the &kformula; screen. + + + + + +&Ctrl;A + +Edit +Select All + +Highlights all the text in the &kformula; screen for +either Cut or Copy. + + + + + +&Ctrl;R + +Edit +Remove Enclosing Element + +Removes enclosing braces, brackets or absolute value bars. +This action takes place on the braces just outside the cursor. + + + + + +&Ctrl;G + +Edit +Convert to Greek + +Converts a Latin character to a Greek symbol. + + + + +Edit +Edit Formula String... + +Brings up an editor where you can edit the existing formula. + + + + +See the Advanced editing +section for details. + + + + +The <guimenu>Element</guimenu> Menu + + + + + +Element +Add +Add Root + +Inserts the square root. + + + + +Element +Add +Add Fraction + +Inserts a fraction. + + + + +Element +Add +Add Bracket + +Inserts a pair of brackets, &ie; ( ). You can also just +type ( to insert a pair of brackets. + + + + +Element +Add +Add Integral + +Inserts the integral sign. + + + + +Element +Add +Add Sum + +Inserts the summation sign. +(sigma). + + + + +Element +Add +Add Product + +Inserts the product sign. + + + + +Element +Add +Add Matrix... + +Inserts a matrix. A dialog box pops up, with the default size being 3x3. +You can specify the number of rows and columns in this box. + + + + +Element +Add +Add 1x2 Matrix + +Inserts a two rowed column vector. + + + + +Element +Add +Add Overline + +Inserts an overline in this box. + + + + +Element +Add +Add Underline + +Inserts an underline in this box. + + + + +Element +Add +Add Multiline + +Inserts a new line each time you type Enter in the square. + + + + + +&Ctrl;U + +Element +Add +Add Upper Index + +Adds an upper index like so: + + . + + + + + +&Ctrl;L + +Element +Add +Add Lower Index + +Adds a lower index: + + . + See the Definite Integrals and +Indices section for details about indices. + + + + + +Element +Add +Add Negative Thin Space + +Inserts a small reduced space, here between the o and the e: + + . + + + + +Element +Add +Add Thin Space + +Inserts a small space. + + + + +Element +Add +Add Medium Space + +Inserts a space that is one and a half times wider. + + + + + +Element +Add +Add Thick Space + +Inserts a double space. + + + + +Element +Add +Add Quad Space + +Inserts a quadruple wide space. + + + + +Element +Matrix +Insert Column + +Inserts a column in an existing matrix. The column is inserted where the cursor is at. + + + + +Element +Matrix +Append Column + +Appends a column to an existing matrix. The column is appended on the right. + + + + +Element +Matrix +Remove Column + +Removes a column from an existing matrix. Removal occurs where the cursor is positioned. + + + + +Element +Matrix +Insert Row + +Inserts a row in an existing matrix. The row is inserted where the cursor is at. + + + + +Element +Matrix +Append Row + +Appends a row to an existing matrix. The row is appended on the bottom. + + + + +Element +Matrix +Remove Row + +Removes a row from an existing matrix. Removal occurs where the cursor is positioned. + + + + +Element +Size + +Allows to set the size of the font (from 6 to 72). + + + + +Element +Left Delimiter + +Allows insertion of various delimiters &ie; (, {, and +[. + + + + +Element +Right Delimiter + +Allows insertion of various delimiters &ie; ), }, and +]. + + + + + +&Ctrl;I + +Element +Insert Symbol + +Inserts the symbol, selected in the symbol +toolbar. + + + + + + +The <guimenu>Settings</guimenu> Menu +Here you can choose how &kformula; is configured. + You can select the toolbars you want displayed or the type of fonts to be +used. + + + + + +Settings +Toolbars +File (KFormula) + +Toggles the toolbar that contains clickable icons for +new, open and save files. +Print and print preview are here also. + + + + +Settings +Toolbars +Edit (KFormula) + +Toggles the edit toolbar. Here are clickable icons for +cut and paste as well as Undo and Redo. + + + + +Settings +Toolbars +Add (KFormula) + +This toolbar contains all the mathematical elements such +as Sum, Integral, Exponent &etc; + + + + +Settings +Toolbars +Font (KFormula) + +This toolbar contains the font settings (size, bold, italic, &etc;). + + + + +Settings +Toolbars +Symbol (KFormula) + +This toggles the combo box that contains Del, the +partial derivative symbol, limit arrows, +boolean operators and other mathematical symbols. + + + + + +Settings +Toolbars +Matrix (KFormula) + +This toggles the matrix toolbar. It contains clickable +icons that pertain to matrix creation and editing. + + + + +Settings +Syntax Highlighting + +Checking this item determines if the numbers will be +displayed in color. + + + + + + + + + +Configuring Shortcuts + +The +SettingsConfigure Shortcuts... +allows you to specify shortcuts. + + +Below is an example of how to configure a shortcut for a +print preview. + + + +Picture of shortcut dialog + + + + + + + + + +Click on Custom. + + + +Next click on the button Advanced >> and then Primary shortcut:. + + + +Do &Ctrl;Space +and the dialog should disappear. The shortcut is now entered. + + + + +Picture of shortcut dialog + + + + + + + +Pressing the keys &Ctrl;Space +now displays the print preview. + + + + + +Configuring Toolbars +The +SettingsConfigure Toolbars... +is used to add additional buttons to the toolbars. + + +Picture of toolbars dialog + + + + + + + + + + + +To add a button to the File toolbar, + + + +Picture of toolbars dialog + + + + + + + + make sure File + <&koffice;> is displayed in the top combo box. + + + +Click on one of the items in the left hand pane. This item will now be +highlighted to show that it has been selected. + + + +Next click on the Right arrow button to place it in +the right pane. + + + +Click on Apply and then +click on OK. + + + + +The new Item should be in the toolbar. + + + + + + + + + + +Configuring &kformula; +The +SettingsConfigure +&kformula;... is where the font sizes and font styles are +selected. + + + +The Formula section allows you to select fonts +and font highlight colors. + + + + + + + +The <guimenu>Help</guimenu> Menu + + + +Help +Tip of the Day + +Opens the Tip of the Day dialog which displays a random tip about &kformula;. + + +&help.menu.documentation; + + + + + + + +Advanced Editing + + +Name insertion + +A special feature is the name insertion. The blue square you +type into is actual a list. Furthermore, that list can contain other +lists. When you type a backslash (\) you get a new +empty list right away. But this one is special. It uses a different +font and is meant to insert things like function names. There is, +however, a second idea here. Your keyboard only has a limited number of keys. +The wealth of mathematical symbols on the other side is overwhelming. To get one +of those you can type its name and press the space bar afterwards. The name you +typed will be replaced by the symbol then. In this context, the +Space bar means get out of here, that +is move the cursor to the containing list. The cursor will be +positioned at the end of what you just entered but will also enclose part of the original +formula, after pressing the space bar. + + +Another thing you might want to insert are spaces. We all know, +printing formulae is all about the right spacing. And you can do just +that using a name list. + +Inside the blue square do: \,SPACE to get a small space. + + +Do: \<Space to get a medium space. + + +Do: \;Space to get a thick space. + + +Do: \ quad Space to get +a quadruple wide space. + + +In the same way, specific mathematical symbols can be inserted. +\ oint Space inserts +the path integral about a closed contour. Below is the result of +\ oint Space: + +Picture of path integral + + + + + + + + + +Editing Formulas + +The +Edit +Edit Formula String + allows the user to edit the ASCII formulas that have been copied from other applications, +such as Scilab, and transform them directly into mathematical type. An example will make this clear. Below is a screenshot of INRIA Scilab. + + + +Scilab picture + + + + + + + Copy and paste the text beginning with x*sin(30*x) into the formula editor as +shown below: + + +Scilab formula edit picture + + + + + + + +If you click on OK, the editor will complain about aborted parsing. It cannot +recognize one of the symbols in the formula. The displayed formula would show that the Pi symbol is +not correctly rendered. This means that the % must be deleted. Do this and &kformula; will +render the mathematical font properly, as shown below. + + +Scilab formula rendered in &kformula; + + + + + + + + The formula editor will accept most C language mathematical expressions, like the formulas from a +Runge-Kutta program below: +void derives(float x, float y[], float dydx[]) +{ + dydx[1] = y[2]; + dydx[2] = -0.8*x*y[2] - sin(x)*y[1]; +} + +Here dydx[1] is the first order derivative and dydx[2] is the second order +derivative. After copying the formula, you will have to edit the derivatives with &kformula;. Here is how it is done. +First copy and paste the bottom expression into the formula editor. + + +Runge-Kutta in editor; + + + + + + + +Next remove the [ ], leaving just y's. + + +Runge-Kutta edited + + + + + + + +Now click OK and place the cursor by a y and delete it. Insert the appropriate symbols as +shown below. + + +Runge-Kutta in &kformula; + + + + + + + +Not every expression that &kformula; is capable of translates into a valid C expression. For example the +superscript expression: + + +Superscript in &kformula; + + + + + + + +is displayed as ()**(), which is not a valid C statement for exponentiation. Similarly the 1 by 2 +matrix displays as ()/(). This is not a valid array in C. + + + + +Definite Integrals and Indices + +Definite Integrals + A definite integral is made by using &Ctrl;U for the upper limit +of integration and &Ctrl;L +for the lower limit of integration. + + + +definite integral + + + + + + +Reposition the cursor in front of the integral after making the +first of the limits. + + + +Positioning Indices + +The upper or lower index can be positioned by highlighting the desired +text. In this example, an arrow is needed above the P, in dP. Using &Ctrl;U places the desired vector +symbol in the wrong place; namely above the d. + + + + + +The problem is solved by + highlighting only the P in + + and then entering &Ctrl;U. Here is the correct + result. + + + + + + + + + + + +Credits and Licenses + +&kformula; Copyright by The KFormula Team + + +&kformula; Developers (Alphabetically) +Alfredo Beaumont Sainz alfredo.beaumont@gmail.com +Ulrich Küttler +Andrea Rizzi + + +Documentation copyright 2002 Jonathan Drews +j.e.drews@att.net + +Documentation copyright 2005 Anne-Marie Mahfouf +annma@kde.org + +Documentation copyright 2006 Alfredo Beaumont Sainz +alfredo.beaumont@gmail.com + +&underFDL; +&underGPL; + + + + +Installation + + +How to obtain &kformula; + +&install.intro.documentation; + + + + +Requirements + + +&kformula; is part of &koffice; +on The &kformula; home +page +You must have &koffice; installed. &kformula; will not work without the rest of +&koffice; + + + + + +Compilation and Installation + + +&install.compile.documentation; + + + + + +&documentation.index; + +     + + + + + + + + diff --git a/doc/kformula/index_smear.png b/doc/kformula/index_smear.png new file mode 100644 index 00000000..b557b7db Binary files /dev/null and b/doc/kformula/index_smear.png differ diff --git a/doc/kformula/kfontinst1.png b/doc/kformula/kfontinst1.png new file mode 100644 index 00000000..a81486bc Binary files /dev/null and b/doc/kformula/kfontinst1.png differ diff --git a/doc/kformula/kfontinst2.png b/doc/kformula/kfontinst2.png new file mode 100644 index 00000000..be40a39f Binary files /dev/null and b/doc/kformula/kfontinst2.png differ diff --git a/doc/kformula/kfontinst3.png b/doc/kformula/kfontinst3.png new file mode 100644 index 00000000..42e64364 Binary files /dev/null and b/doc/kformula/kfontinst3.png differ diff --git a/doc/kformula/kfontinst4.png b/doc/kformula/kfontinst4.png new file mode 100644 index 00000000..6f3c42e7 Binary files /dev/null and b/doc/kformula/kfontinst4.png differ diff --git a/doc/kformula/kfontinst5.png b/doc/kformula/kfontinst5.png new file mode 100644 index 00000000..ec5cb4a5 Binary files /dev/null and b/doc/kformula/kfontinst5.png differ diff --git a/doc/kformula/kfontinst6.png b/doc/kformula/kfontinst6.png new file mode 100644 index 00000000..377d088e Binary files /dev/null and b/doc/kformula/kfontinst6.png differ diff --git a/doc/kformula/lower-index.png b/doc/kformula/lower-index.png new file mode 100644 index 00000000..04ce92f4 Binary files /dev/null and b/doc/kformula/lower-index.png differ diff --git a/doc/kformula/matrix-view.png b/doc/kformula/matrix-view.png new file mode 100644 index 00000000..c1ea56a9 Binary files /dev/null and b/doc/kformula/matrix-view.png differ diff --git a/doc/kformula/matrix.png b/doc/kformula/matrix.png new file mode 100644 index 00000000..58247413 Binary files /dev/null and b/doc/kformula/matrix.png differ diff --git a/doc/kformula/negative_thin_space.png b/doc/kformula/negative_thin_space.png new file mode 100644 index 00000000..765079f8 Binary files /dev/null and b/doc/kformula/negative_thin_space.png differ diff --git a/doc/kformula/path-integral.png b/doc/kformula/path-integral.png new file mode 100644 index 00000000..cc21d087 Binary files /dev/null and b/doc/kformula/path-integral.png differ diff --git a/doc/kformula/rk-edit0.png b/doc/kformula/rk-edit0.png new file mode 100644 index 00000000..5faaf35d Binary files /dev/null and b/doc/kformula/rk-edit0.png differ diff --git a/doc/kformula/rk-edit1.png b/doc/kformula/rk-edit1.png new file mode 100644 index 00000000..e8785d05 Binary files /dev/null and b/doc/kformula/rk-edit1.png differ diff --git a/doc/kformula/rk-edit2.png b/doc/kformula/rk-edit2.png new file mode 100644 index 00000000..9366015a Binary files /dev/null and b/doc/kformula/rk-edit2.png differ diff --git a/doc/kformula/scilab-edit.png b/doc/kformula/scilab-edit.png new file mode 100644 index 00000000..79c5aa69 Binary files /dev/null and b/doc/kformula/scilab-edit.png differ diff --git a/doc/kformula/scilab.png b/doc/kformula/scilab.png new file mode 100644 index 00000000..7bb27190 Binary files /dev/null and b/doc/kformula/scilab.png differ diff --git a/doc/kformula/shortcut0.png b/doc/kformula/shortcut0.png new file mode 100644 index 00000000..f538419e Binary files /dev/null and b/doc/kformula/shortcut0.png differ diff --git a/doc/kformula/shortcut1.png b/doc/kformula/shortcut1.png new file mode 100644 index 00000000..525bc92f Binary files /dev/null and b/doc/kformula/shortcut1.png differ diff --git a/doc/kformula/sin.png b/doc/kformula/sin.png new file mode 100644 index 00000000..b495d874 Binary files /dev/null and b/doc/kformula/sin.png differ diff --git a/doc/kformula/toolbars.png b/doc/kformula/toolbars.png new file mode 100644 index 00000000..7d3f9798 Binary files /dev/null and b/doc/kformula/toolbars.png differ diff --git a/doc/kformula/upper-index.png b/doc/kformula/upper-index.png new file mode 100644 index 00000000..3147a8a2 Binary files /dev/null and b/doc/kformula/upper-index.png differ diff --git a/doc/kivio/Makefile.am b/doc/kivio/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kivio/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kivio/credits.docbook b/doc/kivio/credits.docbook new file mode 100644 index 00000000..1a85a4e6 --- /dev/null +++ b/doc/kivio/credits.docbook @@ -0,0 +1,64 @@ + + + +Ben +Lamb + +
    +kde@zurgy.org +
    +     +     + +     +     + +Credits and License + + +&kivio; + + + +Program copyright 2000-2003 The &kivio; Team + + + +Current maintainer is Peter Simonsonn psn@linux.se. + + + +Contributors + + +Ian Reinhart Geiser geiseri@kde.org + + + +Laurent Montel montel@kde.org + + + +Frauke Oster frauke@frsv.de + + + +Dave Marotti lndshark@verticaladdiction.net + + + +The Kompany.com - "Where Open Source is at Home" info@thekompany.com + + + +Current documentation is maintained by Ben Lamb +kde@zurgy.org + + + + + +&underFDL; +&underGPL; + +     diff --git a/doc/kivio/index.docbook b/doc/kivio/index.docbook new file mode 100644 index 00000000..02300ced --- /dev/null +++ b/doc/kivio/index.docbook @@ -0,0 +1,64 @@ + + + + + + + + + +]> + + + + +The &kivio; Handbook + + + + +Ben +Lamb + +
    +kde@zurgy.org +
    +     +     + + +     + +2006-01-30 +1.5.0 + + +20032000 +Ben Lamb + + + +&FDLNotice; + + +&kivio; is the &koffice; flowchart and diagram creation tool. + + + + +KDE +Kivio +KOffice +Flowchart +Diagram + + +     + +&introduction; +&usage; +&working; +&credits; + +     diff --git a/doc/kivio/introduction.docbook b/doc/kivio/introduction.docbook new file mode 100644 index 00000000..0fac6914 --- /dev/null +++ b/doc/kivio/introduction.docbook @@ -0,0 +1,33 @@ + + + +Ben +Lamb + +
    +kde@zurgy.org +
    +     +     + +     +     +Introduction + + +What is &kivio;? + +&kivio; is the &koffice; flowchart and diagram creation tool. It allows you to create accurate scale diagrams by arranging pre-drawn shapes and stencils on a page. The stencils might represent stages of a process, office furniture or components on an electronic circuit. &kivio; comes with a large collection of different stencils which are grouped into collections, known as stencil sets, by subject area. + + + +About this Document +This document describes the features of &kivio; and how to use them. There are often several ways to perform a particular task. Where possible the appropriate menu option is described as this is the easiest to explain without the aid of screenshots. Users are encouraged to explore the menus and to try right-clicking on stencils to reveal shortcut menus. + + + +Contributing to &kivio; +&kivio; is a volunteer project. Your contributions are welcome. If you find a bug whilst using the software please report it by selecting HelpReport Bug.... +Contributions to the documentation, stencils, translations into other languages and the code itself are welcome. Please see the &koffice; website for more information about how to contribute. + +     diff --git a/doc/kivio/usage.docbook b/doc/kivio/usage.docbook new file mode 100644 index 00000000..7714ef43 --- /dev/null +++ b/doc/kivio/usage.docbook @@ -0,0 +1,203 @@ + + + +Ben +Lamb + +
    +kde@zurgy.org +
    +     +     + +     +     + +Basic Usage + + +Starting &kivio; +Like other &koffice; applications, on startup &kivio; presents a startup dialog. The dialog offers a choice of creating a new document, opening a saved document or choosing a document from a list of recently saved files. +If you're new to &kivio; begin by creating an empty document by double-clicking on the Empty Document template. +&kivio;'s main window contains a view of the current document. The page outline and margins are shown, as is a grid. Surrounding this view are horizontal and vertical rules. By default a tools toolbar is placed on the left-hand side and beneath the document view is a page selector. Beneath that is the status bar which shows the current position of the mouse pointer as a location on the page. +At the top of the window are the two main toolbars. These contain buttons for the most commonly used features of &kivio;. + + + +Using Stencils +Diagrams are created by placing different pre-drawn shapes and stencils on the page. Stencils can represent many different things and &kivio; comes with a wide selection. For ease of reference they are grouped into collections known as stencil sets. To use a stencil set select ToolsAdd Stencil Set. The stencil sets have been sub-divided into several groups; a sub-menu lists these. The shapes in the stencil set are shown on the left-hand side of the document view. +Stencils are grouped into stencil sets for organizational purposes only; it is perfectly okay to add several stencil sets to a document and &kivio; allows you to mix and match stencils from different sets freely. +To place a stencil onto the document simply drag it from the stencil area to the page. + + +Selecting Stencils + +&kivio; identifies the stencil currently being edited by displaying eight green squares on the corners and edges of a square around the stencil. Stencils shown in this manner are described as being selected. The green rectangles are known as handles. +To change the currently selected stencil move the mouse pointer over the stencil you wish to select and press the &LMB;. +To select all the stencils on the current page select EditSelect All. +To deselect all stencils select EditDeselect. + + + + +Moving Stencils + +To move a stencil to another position on the page, select the stencil. Note the pointer will change to a hand icon. Hold down the &LMB; and move the mouse to the new position. Release the mouse button to place the stencil at the new position. + + + +Resizing a Stencil +Select the stencil, and then move the mouse pointer over one of the handles. Note the mouse pointer change. Hold down the &LMB; and move the mouse. The coordinates of the stencil will be adjusted continuously as the mouse is moved. When you are happy with the new size release the mouse button to give the stencil its new final size. + + + +Undoing a Mistake +If at any time you are unhappy with a change you have made to the document you can select EditUndo to revert the change. There is also an icon on the toolbar. +If you undo an action and decide that was a mistake, select EditRedo to restore the change. &kivio; stores multiple actions to undo/redo several changes. + + + +Limitations of the Stencils +Note that stencils cannot currently be rotated. + + + +Labeling Stencils +A lot of stencils in the Flowcharting Collections, Geographic Collections, Hardware Collections, Miscellaneous Collections and UML Collections can contain text to describe their function. To add text to a stencil move the mouse pointer over the stencil and double-click it or open the context menu with the &RMB; and select Edit Text.... A dialog box will appear prompting for some text. Enter some text and click OK. The text should be shown inside the stencil. +The item Edit Text... in the menu is disabled, if a stencil cannot be labeled. +The font, size, alignment and style of the text can be adjusted by selecting FormatText.... Alternatively use the buttons on the Format toolbar. +The adjustments will only affect the currently selected stencil. + + + +Selecting Several Stencils +There are two ways to select multiple stencils in &kivio;. + + +Click once inside the first stencil you wish to select. + Hold down &Ctrl; as you click inside subsequent stencils. + All the stencils will be shown with handles around them. + + +Move the mouse pointer to a blank area of the document near the stencils you want to select. +Hold down the &LMB; and move the mouse to the other side of the stencils you want to select, drawing a rectangle around them. +The rectangle must completely encompass the stencils for them to be selected. + + + + + + +Adjusting the Fill Color and Line Color +Stencils can be filled with a solid color and the color of the outline can be changed. Select a stencil then select FormatStencils & Connectors.... + + + + +Adjusting the Line Thickness +The width of a stencil's border can be adjusted by selecting FormatStencils & Connectors.... The line width can be entered in centimeters or increased/decreased using the arrows of the spin box. Or use the Line Width button on the Format toolbar. Select a width from the drop down box or select Custom... to open enter the width in the spin box. + + + +Connecting Shapes Together +&kivio;'s connector tool allows lines to be drawn between shapes. The lines remain connected to the shapes even when the shapes are moved to new positions on the page. +To draw a connector select ToolsStraight Connector or ToolsPolyline Connector. +The Polyline Connector tool is also available from the Tools toolbar; by default shown on the top side of the window. Click on this tool to begin using it; the mouse pointer will change shape. +Notice that all stencils have little blue crosses around their edges. These crosses mark points where connectors can be attached. +To connect two stencils move to one of the connection points on the first stencil, hold down the &LMB; and drag a line to one of the connection points on the second stencil. The green square at the end of the line will change to red when it is over a connection point indicating that the line is attached to a stencil. +When you have finished using the connector tool, click on the Arrow tool to regain normal selection functionality. +A stencil can have multiple connectors attached to it, even at the same connection point. +Various properties of the connector can be adjusted including line thickness and color, this is done in the same way as for stencils. +Straight Connectors may also be labeled with text. To add text to a straight connector open the context menu with the &RMB; and select Edit Text.... Enter the text in the dialog that appears. The text will be shown with a green handle next to it. Use this to modify the position of the text. +Arrowheads can be added to either end of a connector. Select the connector and then select FormatArrowheads.... +Limitations: Connectors do not currently reroute around stencils, you need to adjust them manually. Text is always displayed horizontally; rotated text is not currently possible. + + + +Grouping Stencils +Several stencils may be semi-permanently grouped together. Once this has been done any changes made to one stencil will affect the others in the group. +To make a group select the stencils and select FormatGroup Selection. +The procedure can be reversed by selecting a group of stencils and select FormatUngroup. + + + +Overlaying Stencils +Stencils can be positioned on top of one another. A stencil drawn on top of another stencil will obscure the stencil underneath it. To adjust the drawing order select one of the stencils and select either FormatBring to Front or FormatSend to Back. +Send to Back will cause the stencil to be obscured by any stencil which overlaps it. Bring to Front will cause the stencil to obscure any stencil which it overlaps. + + + +Locking Stencils +A stencil's properties may be locked to prevent accidental changes. To alter a stencil's protection use the protection palette. This can be displayed by selecting ViewPalettesShow Protection. Select the stencil or stencils you wish to protect and then tick the properties you want to protect on the protection palette. +The protections available are: Width, Height, Aspect ratio, X position, Y position and Deletion. Deletion prevents a stencil from being deleted from the document. + + + +Stencil Geometry +For accurately specifying the dimensions of a stencil use the Geometry palette. To display the palette select ViewPalettesShow Geometry. The palette contains four spin boxes for specifying the horizontal (X:) and vertical (Y:) position of the stencil and the Width: and Height:. + +Although the measurements are displayed in centmeters it is possible to enter other units into the textbox. For example, entering 2.5 mm will be converted into centimeter. Points (pt) and inches (in) are also accepted. + + + + + + +Viewing the Document + + +Zooming In and Out +To adjust the zoom level select ViewZoom Level. This submenu contains a list of percentages from 33% to 500%; selecting one of these magnify the document by that percentage. +There is also a list of zoom levels in a spin box on the Edit toolbar, by default shown at the top of the screen. +A second method of controlling the magnification is to use the zoom tool. This is available on the Tools toolbar. This tool can be used in two ways. Clicking on the document with the zoom tool active will increase the magnification. Holding down the &Shift; key whilst clicking will decrease the magnification, &ie; zoom out. +Alternatively, holding down the &LMB; and dragging out a box then releasing the mouse button will increase the magnification so that that portion of the document fills the available space. + + + +Panning the Document +The Pan Document tool lets you move the document around, adjusting the portion that is visible. This is very useful when working at high magnifications where the entire document is not completely visible. To pan a document select Pan Document from the Tools toolbar or ToolsPan Document in the menu. Once activated the mouse pointer turns into a hand. To move the document move the mouse over the currently visible portion, hold down the &LMB; and drag. + + + +The Overview +The Overview palette provides a quick way of adjusting the zoom level and moving around the document. To enable it select ViewPalettesOverview. +A miniature representation of the document itself is shown underneath. A red rectangle indicates the portion that is currently visible. Clicking anywhere on this representation pans the view to that area. The rectangle can also be dragged. +At the bottom of the palette there is a slider and two buttons to zoom 25% in or out. + + + +Using Palettes +All palettes have a handle on the top side which enables them to be moved around and positioned on any edge of the main view. They can also float anywhere on the screen. To hide or show a palette select it from ViewPalettes. + + + +Multiple Views +It is possible to have multiple views of the same document displayed simultaneously. +Select New View from the View menu and a new &kivio; window showing the same document will appear. This is very useful for multiple monitor setups. +The additional windows can be closed and &kivio; will only prompt you to save the document when the last window is closed. All windows pertaining to a particular document can be closed simultaneously by selecting ViewClose All Views. + + + +Split Views +It is also possible to split the window into two or more portions which can be used to view two areas of a document at once. +To split a window select ViewSplit View. The orientation of the split can be changed from horizontal to vertical using ViewSplitter Orientation. To restore the window to its original state select ViewRemove View. + + + + + +Customizing the Display +The View menu contains options for toggling the display of page margins, rulers, guides and the grid. + + + + +     diff --git a/doc/kivio/working.docbook b/doc/kivio/working.docbook new file mode 100644 index 00000000..809b8aeb --- /dev/null +++ b/doc/kivio/working.docbook @@ -0,0 +1,212 @@ + + + +Ben +Lamb + +
    +kde@zurgy.org +
    +     +     + +     +     + +Working with &kivio; + + +Opening a Document +To open a previously saved document select FileOpen..., a standard &kde; file dialog box will appear. +Recently used documents are listed under FileOpen Recent. + + + +Saving a Document +To save the current document select FileSave or FileSave As... to give an existing file a different name. +It is possible to save the document in a format that can be opened by earlier versions of &kivio;. Select the version you require from the Filter: combo box in the save file dialog. + + + +Printing +The document can be printed by selecting FilePrint.... The standard &kde; printing dialog appears. A preview of the printed output can be obtained by selecting FilePrint Preview.... + + + +Importing/Exporting Documents +The Import... menu option on the File menu currently loads a &kivio; or &XML; document into a new &kivio; application. +The Export... menu option on the File menu currently perform the same functions as File Save As.... These options let you save a document under a different name or into an other format. + + + +Documents with Multiple Pages +A &kivio; document can contain several pages of diagrams. + + +Adding Pages +To add additional pages to a document select PageInsert Page or click with the &RMB; on the page tab and select Insert Page from the context menu. The selector beneath the document view shows tabs for all the pages in the document that have not been hidden. + + + +Removing Pages +Unwanted pages can be removed by selecting PageRemove Page or click with the &RMB; on the page tab and select Remove Page from the context menu. + + + +Renaming Pages +The names given to each page can be adjusted by double-clicking on the page name on the page selector or by clicking with the &RMB; on the page tab and select Rename Page... from the context menu. A dialog box will appear allowing the name to be edited. + + + +Working with Pages +The order of the pages can be adjusted by dragging the tabs on the page selector bar. +The arrow buttons on the page selector bar are for scrolling through the page tabs, they do not cycle through the pages themselves. +If you have a lot of pages in a document and you do not want to see them all on the page selector you can hide pages by selecting PageHide Page. This will remove the currently selected page from the page selector bar. +To reveal a hidden page select PageShow Page... and choose the page you want to see from the list box. + + + + + +Exporting a Page +Individual pages can be exported as bitmap graphics files. To export the current page select File Export... or File Save As.... A standard &kde; file dialog box appears. The export format is determined by the name extension you give the file, it must end with one of the extensions listed below. +The following formats are supported: + + +PNG Image (.png) +JPEG Image (.jpg) +BMP Image (.bmp) +Encapsulated Postscript Image (.eps) +Portable Bitmap (.pbm) +PCX Image (.pcx) +Portable Pixmap Image (.ppm) +SGI Image (RGB) (.rgb) +X PixMap Image (.xpm) +JPEG 2000 Image (.jp2) +Krita Document (.kra) +Adobe Illustrator Document (.ai) +TIFF Image (.tiff) +ILM EXR Image (.exr) +Karbon14 Document (.karbon) +GIMP Native Image Format (.xcf) +Scalable Vector Graphics (.svg) +&Windows; MetaFile (.wmf) + + +You have to confirm the export, because this may result in some loss of formatting. Click the button Save and the Export to Image dialog is displayed. In this dialog you can set some export options: Page: range, the Area to export:, the Custom size (in pixels): and the Margin: of the page. + + + +The Grid +&kivio; displays a regularly spaced grid over the document to aid stencil positioning. The visibility of the grid can be toggled by selecting ViewShow Grid. +Objects edges are snapped to the nearest point on the grid regardless of whether it is visible. To toggle this behavior select ViewSnap Grid. +To customize the grid select SettingsConfigure &kivio;... and click on the Grid on the icon list. +This dialog box will let you adjust the color the grid is drawn in, the horizontal and vertical spacing and the snap distance. +Tip: It is possible to have a non-square grid by specifying different horizontal and vertical spacings. + + + +Freestanding Text +The text tool can be used to add text to a document that is not associated with any object. This is useful for noting general information about a drawing. +To add freestanding text make sure no object is selected by selecting EditDeselect , then activate the text tool by selecting ToolsText Tool. The mouse pointer will change to indicate the text tool is activated. +Drag a box to contain the text. A dialog box will appear prompting for the text, enter some text and click OK. The formatting of the text can be adjusted by selecting FormatText... or by using the toolbars. + + + +Page Layout +The page size, margins and orientation, portrait or landscape, can be adjusted using the Page Size & Margins dialog box. This is accessible by selecting FormatPage Layout.... + + + +Using Guides +Guides are lines used to help you position stencils. Not only can you use guides as a visual reference when aligning items but, optionally, &kivio; will snap stencils to guides. This means that as soon as the edge of a stencil is within a certain distance to a guide it will immediately move to the guide's position. + + +Adding Guides +To add a guide move the mouse pointer over either the horizontal or vertical ruler, depending on the type of guide you require. Hold down the &LMB; and drag the mouse over the document and release the mouse button where you want to position the guide. As you drag the mouse the guide will move accordingly. +Or use ViewAdd Guide Line... to open a dialog to select the Orientation and the Position of the guide. + + + +Repositioning Guides +Once a guide is in place you can reposition it by moving the mouse over it, holding down the &LMB; and dragging. Release the mouse button when the guide is in its new position. + + + +Visibility and Snapping +To hide guides select ViewGuide Lines, this toggles the visibility. +By default stencil edges are snapped to the nearest guide, to toggle this behavior select ViewSnap Grid. + + + + + +Layers +&kivio; allows complex diagrams to be split into multiple layers. The visibility of layers can be turned on and off. This functionality is useful if you have a basic diagram, for example a floorplan, and need to create several versions of it for different audiences. The information for each audience can be placed in a different layer. +Each page of the document has its own set of layers. + + +The Layer Palette +To adjust the current page's layers select ViewPalettesShow Layers . The layer palette allows layers to be created, deleted and renamed. It can also be used to adjust layer visibility, drawing order and select the current layer. +&kivio; has the concept of the currently active layer which is the one affected by any editing actions. By default a page contains only one layer which is the active layer. + + + +Adding Layers +Using the Layers palette you can add new layers by clicking the New Layer button, the first from the left. Layers can be deleted by clicking the second button, Remove Layer. &kivio; numbers the layers consecutively, to rename a layer select it in the list and click Rename Layer. + + + +Layer Settings +Layers are drawn in the order they are listed. The drawing occurs from the top down so objects in the layer at the bottom of the list are drawn on top of objects in all the other layers. The order of the list can be changed by selecting a layer and using the Move Layer Up and Move Layer Down buttons to change its position. +Each layer is listed with four small icons next to its name. From left +to right they represent: + + +Visibility (shown as a small eye) +Clicking on the icon will toggle the layer's visibility. + + + +Printable (shown as a small printer) +Toggles if the layer should be printed with the document or +not. You might use a non-printing layer to keep notes to yourself, or as a +scrapbook to hold images you're not ready to use yet. + + + +Editable (shown as a small pencil) +Toggles if you can edit a layer or not. You might want to +mark some layers non-editable while you work on others, to prevent +inadvertant changes. + + + +Connectable (shown as a small connector) +You can permit connecting of items that lie on different +layers with this icon. + + + + + + + +Arranging Stencils + + +The Align Tool +The Align tool rearranges a group of stencils so that they are aligned on one edge or on an invisible centerline. To use the tool select several stencils, then select FormatAlign & Distribute.... If the stencils are arranged in a horizontal row you the choice of aligning along the top or bottom edges or the centerline. For stencils that are arranged in a vertical row the choice is left or right edge or the centerline. + + + +The Distribute Tool +The Distribute tool arranges a group of stencils so that there is an even amount of spacing between each stencil. +First select the stencils you want to rearrange, then select FormatAlign & Distribute... and click on the Distribute tab in the tabbed window that appears. +You can choose whether the items should be spaced so that there is equal spacing between two edges, for example, the distance between the lefthand edge of each stencil should be the same. Or, whether the gap between each item should be identical. Choose the Spacing option if you desire this. +The second choice is whether the spacing should use the entire extent of the page or just the extent of the selection. If the latter is chosen the stencils will not occupy any more space than they did originally. +The option to use the extent of the page takes the page margins into consideration. + + + +     diff --git a/doc/koffice.desktop b/doc/koffice.desktop new file mode 100644 index 00000000..fcc5f617 --- /dev/null +++ b/doc/koffice.desktop @@ -0,0 +1,8 @@ +[Desktop Entry] +Type=Application +Name=KOffice +Name[sv]=Koffice +Name[tr]=Koffice +NoDisplay=true +DocPath=koffice/index.html +Categories=Qt;KDE;Office; diff --git a/doc/koffice/Makefile.am b/doc/koffice/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/koffice/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/koffice/index.docbook b/doc/koffice/index.docbook new file mode 100644 index 00000000..4c194a7f --- /dev/null +++ b/doc/koffice/index.docbook @@ -0,0 +1,855 @@ + + + + + +]> + + + + + +&koffice; +A General Introduction + + +Raphael +Langerhorst +
    raphael.langerhorst@kdemail.net
     +     + +Jost +Schenck +
    jost@schenck.de
     +     + +     + +2005-10-27 +1.5.0 + + + +&koffice; is an integrated office suite for the K Desktop Environment +(&kde;). + + + + +KDE +KOffice + + +     + + + +Introduction + +&koffice; components + + +&koffice; is an integrated office suite for the K Desktop Environment +(&kde;). &koffice; currently consists of the following components: + + + +&kword; (a frames-based wordprocessor) +&kspread; (a spreadsheet application) +&kpresenter; (screen and slide presentations) +&kivio; (a flowchart application) +Karbon14 (a vector drawing application) +&krita; (a pixel based drawing application) +&kugar; (a tool for generating business quality reports) +Kexi (an integrated environment for managing data) +&kchart; (a charts/graphs generation application) +&kformula; (an editor for mathematical formulae) + + + +Because these components are based on the KParts component model, &koffice; +components are designed to work very well with each other. Any &koffice; +component can be embedded in another &koffice; document. For instance, you +can insert a spreadsheet which you created in &kspread; directly into a &kword; +document. In this way, complex, compound documents can be created using +&koffice;. + + + +A plugin mechanism makes it easy to extend the functionality of +&koffice;. You will find many plugins in some of the components +and can learn how to write plugins yourself. There is also a section +of this manual dedicated to developing plugins that should get you +started. + + + +This manual only covers the general features of &koffice;, those that +are common to most or all components in the suite. For detailed information +about the different components, have a look at the respective manual. + + + + + +Overview of &koffice; features + +Integration + +&koffice; provides a framework that all components build on. Through +this framework high integration is achieved. It is possible to develop +your own component that integrates as well. The technology of this is +described in more depth in the chapter on +KParts. + + + +Lightweight + +Despite offering so many components, &koffice; is very lightweight, fast and +has a rather low memory footprint. This is also achieved because &koffice; builds +on &kde;, which is already a very powerful application development framework. + + +A goal of &koffice; is also to not overload the user interface with features +that are hardly needed. This results in a lean and mean user interface that +lets you do your work efficiently. + + +Being lightweight can at times also mean that that very particular special +functionality you need is not there. In this case you can always add the +functionality yourself by extending &koffice;. &koffice; really doesn't +want to get bloated by adding large chunks of features that only very +few users might need. Such features can always be made available through +additional plugins or scripts, thus keeping &koffice; itself lightweight. + + + +Completeness + +&koffice; offers a wide range of components, covering most of the home +and business office needs. Additional features can always be implemented +through scripts, plugins or even whole components based on the &koffice; +framework. + + + +OASIS OpenDocument Format + +It is a major importance for any office suite to adhere to established +standards. Especially on the file format level to allow seamless document +exchange with other office suites. This also avoids vendor lock-in, which +is especially important for companies and also for individuals. + + +For this reason &koffice; has adapted the OASIS OpenDocument format +as native file format. + + + +KDE Features + +Since &koffice; builds on &kde; all the features you would expect from a +&kde; application are also available in &koffice;. This includes DCOP, KParts, +Desktop Integration, Configurability and so on. All this makes the look and +feel of &koffice; very familiar and really integrates &koffice; into the +desktop environment, thus allowing seamless workflows. + + + + + + + +&koffice; Technology + + +KParts - the building blocks of &koffice; + + + + + +Each &koffice; application is designed to fulfill very specific needs. +For example, &kspread; is a program for manipulating spreadsheets, while +&kword; is a program for word processing. By focusing on a specific +area, each program aims for perfection in exactly this area. However, +depending on what you do with &koffice;, you'll often want to take +advantage of functionality provided by different applications, but in +the same document. + + + +Suppose that you are preparing a document in &kword; and want to +illustrate some point using a table. While &kword; provides its own +functionality for the insertion of tables, this may not be enough for +your needs. For example, you may want to use certain currency data +formats or to do calculations using spreadsheet formulae. Now, some +&kword; programmer certainly could try to implement +this functionality. However, &kword; would never be as good as &kspread; +in this field; and if it tried to implement all the functionality you +might possibly need, it would end up becoming unreasonably complex and +the source code would become impossible to maintain. + + + +The alternative to this is KParts. Its philosophy is simple: let every +application do what it does best. + + + + + +Compound documents with KParts + + +With KParts, your documents can use all +functionality offered by all &koffice; +applications. You can take advantage of this by inserting so-called +parts into your document. Every one of those parts is +essentially another document, that is, a document within a +document. + + + +In the example mentioned above, you would simply insert a &kspread; part +into your &kword; document. Then, whenever you edit your table, +&kspread; would take control in the background. Control would return to +&kword; when you stop working on the table and start working on text +again. The only change you would notice is that the toolbars and menus, +while editing the table, reflect the functionality of &kspread; instead +of that of &kword;. This ability to include the functionality of one +application in another is called embedding. + + + + + + +Using KParts in your document + + +If you have never worked with compound documents, you may find them +confusing at first. The following step-by-step instructions show you +that using KParts is just as easy as working with a single application. + + + +Inserting a &kspread; part into a &kword; application + +Start &kword;. You can do that either from the panel or by typing +kword at the command line. + + + + +Start a new, blank document. You may want to type some sample text. + + + + +Select Insert Object Frame + Spreadsheets. You'll notice that the mouse cursor has +changed to a cross. This form of the cursor indicates that you are supposed +to select an area. + + + + +Press the &LMB; mouse button where you want the upper left corner of +your table to be, hold it and drag it to the lower right corner. Release +the button. Now a dialog appears that gives you the possibility to +insert an existing document or to create a new one. Create a blank worksheet. +That's it--you're done. + + + + + +Easy, isn't it? You should now see a table frame in your &kword; +document. Now, doubleclick inside the table to see what happens. You'll +notice that: + + + + + +Your menubars and toolbars have changed. They now reflect those of +&kspread;. + + + + +Your table frame now contains the elements of a &kspread; view, with +scrollbars, a tab bar for the selection of tables, &etc; + + + + + +Try editing the table. You'll see that it's not different from using +&kspread;. In fact you are using &kspread;. + + + +Now click somewhere into your &kword; document, outside of the table +area. The menubars and toolbars should change back to those of +&kword;, the elements of the &kspread; view should disappear. Your table +stays and still reflects all of the changes you've applied to it. + + + +KParts are easy to use. Try inserting other parts or even parts in +parts. + + + + + + + + + +Configuring &koffice; and Your System + + +While &koffice; should work quite nice out of the box, there may well be +some things to optimize to get the best out of &koffice;. This chapter +shows you what you might want to do to achieve the best results with +your new office suite and make it suite your needs. &koffice; is +highly configurable, even down to detailed toolbar and menu layout. + + + +Optimizing Font Output + +Fonts are a difficult topic on X Windows. In this section we'll cover +some problems that are frequently reported by people using +&koffice;. Some problems are not just &koffice;s fault, but depend on +your system configuration, which is why you may need to modify system +configuration files in order to solve them. If you don't have access to +the root account on your system, please ask your system operator about +this and point him or her to this manual. As the topic of fonts is too +complex to cover all of it here, you may want to consult the Font +HOWTO from which I've taken the following information. You will +find more details there. + + + +How to Get Nicely Scaled Fonts on Screen + + +STUFF + + + + +How to Get Correct Printout + + While &koffice; automatically can handle all X11 fonts +on screen, printout can pose a problem: on most +systems, printing is done via +ghostscript. Now, while &koffice; knows the +font names used by X Windows, it does normally +not know the font names used by +ghostscript. &koffice; tries to guess these +names, which unfortunately doesn't work all of the time. + + +This problem can be solved, although this is not that easy. Actually, +maybe you are using a distribution which has done most work for you +already (so if you have no reason to complain about printout you can +skip this section). What you have to do is to tell +ghostscript how to translate the (guessed) +font names &koffice; uses to its own font names. This can be done by +adding lines to a file called Fontmap. An alias +line in Fontmap looks like the following +example: + + +An alias in the <application>ghostscript</application> Fontmap + +/Algerian-Roman /Algerian ; + + + + +Please note that a space before the ';' is mandatory. In this example, +Algerian-Roman is the name &koffice; uses for Algerian. You'll have to +add such lines for the fonts &koffice; doesn't display correctly. To +make this task easier, Donovan Rebbechi has written a perl script you +can find at http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. +Assuming that you have a fontfile +/usr/share/ghostscript/fonts/fontfile.ttf you'll +enter kwdfont +/usr/share/ghostscript/fonts/fontfile.ttf +to get the appropriate aliases. The script should mork in most cases. As +mentioned, you should have a look at the Font +HOWTO for more accurate and in-depth information. + + + + + + +Customizing the &koffice; &GUI; + + +While &koffice; comes out of the box with a &GUI; (graphical user interface) +that should suit most people's needs, there are good reasons why you may +want to change the way the programs look. + + + +My mother, for example, is a bit afraid of buttons and menu entries she +doesn't understand. To tailor &koffice; to her needs, I reduced the +&GUI; to a bare minimum of functionality. As she only needs to write +letters and use certain templates, there is no need for much more +functionality than saving, loading, printing, &etc; + + + Thanks to the action concept of &Qt; and &kde;, +you can freely customize &koffice; menubars and tool +bars. Unfortunately, at the moment, there are no easy-to-use dialogs +to do this. &koffice; stores its &GUI; configuration in &XML; files +and you'll have to edit those. Hopefully, this situation will change +in the future; for now, you'll need some basic knowledge of how an +&XML; document works (or HTML, which is a subset of +&XML;). [The action concept needs to be discussed in +more detail -- kt.] + + +Normally, each &koffice; application has at least two of those &XML; +files: one describing the &GUI; of the shell (basically, that's what you +see if there is no document open) and one describing the &GUI; of the +respective part (that's what you see normally). For example, for +&kword;, these two &XML; files are named +kword_shell.rc and kword.rc. + + + +Here's a simple example of such an rc-file. + + + +An example of a simple rc-file + +<!DOCTYPE QConfig ><qconfig> +<menubar> +<menu name="Edit"><text>Edit</text> +<action name="edit_cut"/> +<action name="edit_copy"/> +<action name="edit_paste"/> +<separator/> +<action name="edit_find"/> +</menu> +<menu name="Insert"><text>Insert</text> +<action name="insert_picture"/> +<action name="insert_clipart"/> +<menu name="Variable"><text>Variable</text> +<action name="insert_var_datefix"/> +<action name="insert_var_datevar"/> +</menu> +</menu> +</menubar> +<toolbars> +<toolbar name="edit_toolbar" position="right"> +<action name="edit_cut"/> +<action name="edit_copy"/> +<action name="edit_paste"/> +</toolbar> +</toolbars> +</qconfig> + + + + + + + + +How to get more information + + +Other &koffice; manuals + + +For detailed information on the different &koffice; applications, please +consult their respective manuals. + + + + + + + + +Links + + +The following links should be useful if you're looking for more information +about &kde; or &koffice;. + + + + +The &koffice; +homepage. Here you can find information on how to get and +install &koffice;, news about &koffice; development, screenshots &etc; + + + +The KDE Homepage. KDE is the most advanced and +absolutely free desktop environment for unix-like operating systems. +&koffice; makes use of the &kde; libraries. + + +Trolltech. The creators +of the C++-toolkit &Qt;. &kde; and &koffice; make use of &Qt;. + + + + + + + + +Programming &koffice; + + +Introduction + +If you want to do &koffice; development, the following resources might +be of interest: + + + + At http://developer.kde.org you'll +find many documents about programming with &Qt; and &kde;. Here you can find +the online version of the complete &kde; library documentation. + + +In the &koffice; sources you'll find an example application in the +example folder. + + + + + + + + + +Copyright and Licensing + + +&koffice; is the result of the joint effort of many developers. Each source file +of &koffice; is copyrighted by the people who wrote this particular file and +their names can be found at the start of each source file with the license that applies to +that source file. The names of the core developers can be found at + +http://www.koffice.org/people.php. + + + +This manual is copyright by Jost Schenck. It can be distributed +freely, as long as this copyright notice is included. You may change +it as long as you send me the changes or commit them to &kde; +CVS. I'll not be liable for anything resulting +from the use of this manual. + + + +The other &koffice; manuals are copyrighted by their respective authors. + + + +&underFDL; +&underGPL; + + + + +Installation + + +System Requirements + + +In order to install and use &koffice; you must have: + + + + +A functioning &UNIX; system (for example, &Linux; or BSD) +with a configured &X-Window; (for example, XFree86 or X.Org). + + +The &Qt; 3.3 libraries from Trolltech. See +www.trolltech.com +for more information. + + +The K Desktop Environment 3.3 (&kde; 3.3) or newer. &koffice; cannot be compiled +with earlier versions of &kde;. Information on obtaining and installing +&kde; can be found at: &kde-http; + + +Permission to install software on your computer. If you are on a +stand-alone system, this should not be a problem. However, if you are +using a networked computer, check with your administrator first. + + + + +Please note that, while you need the &kde; 3.3 (or newer) libraries +on your system, you can still use &koffice; in a different desktop +environment (for example, XFCE or GNOME). + + + +If you plan on compiling &koffice; from +source code you will also need: + + + + +automake 1.6.1 or later. This can be downloaded from: +ftp://ftp.gnu.org/pub/gnu/automake/ + + +autoconf 2.53 or later. This can be downloaded from: +ftp://ftp.gnu.org/pub/gnu/autoconf/ + + +A C++ compiler which supports exceptions, preferably a recent version of GCC. +(See http://gcc.gnu.org +for info about getting and installing it.) + + +Troll Tech's &Qt; 3.3 development packages. If these packages are not installed on +your system and they are not included in the distribution of your operating +system, you should probably have to compile &Qt; from source. +These sources can be obtained from + +http://www.trolltech.com/download/index.html. + + + + +Once you have determined that your system meets these requirements, +you should decide whether you want to compile the source code +or install from pre-compiled binary packages. + + + +If you want to obtain the most current binary version of &koffice;, +you can find more information by following this link: +Getting Binary Packages. + + + +If pre-compiled binaries are not available for your system, you can download +the source code and compile it yourself. Instructions on where to obtain the +current source code (and what to do with the source code once you have it) +can be found by following this link: +Getting the source code. + + + Please see the &koffice; homepage for further +details. That is where you can always find the most up-to-date +information on both source and binary distributions! + + + + + +Getting Binary Packages + + +You can download the most current binaries from: + + + + +http://koffice.kde.org/releases/1.4.0-release.php + + + +or from one of many mirror sites. The current list of mirror sites +can be found at: + + + +http://www.kde.org/mirrors.html + + + It is important that you use a binary package which is +compatible with your system. If you use the &Linux; operating system +and are unable to find a binary package at the &koffice; web site or +one of its mirrors, you may be able to obtain one from the website of +your distribution. + + + + + +From Binary Packages + + +To install &koffice; from precompiled binaries, you should: + + + + +Ensure your computer has all of the required software installed +and in working condition (excluding &koffice; of course). You can find +the system requirements by following this link: System Requirements. +Download the &koffice; binary (or binaries) into a temporary +folder. +If the filename ends in .rpm (&RedHat; Package Management file), +&koffice; can be installed with the following command: +$rpmfilename + +If the filename ends in .deb (Debian Package file), &koffice; can be installed with the following command: +$ dpkgfilename + +If the filename ends in .tar.gz +or .tgz (a tarball file), +&koffice; can be installed with the following commands: + +$ cd / +$ tar filename + +In these examples filename should be replaced by the +complete name of the package including the full path if +you are not in the directory in which you saved. + + +That's all. &koffice; should now be installed on your system. + + + + If you have a graphical front-end for package management, +such as &kpackage; or GnoRPM, installed on +your system, you may find that more convenient to use than a command +line. Consult the program's documentation to find out how to install +with it. + + + + + +Getting Source Code + + +You can download the current source code from: +http://koffice.kde.org/ +or from one of many mirror sites. The current list of mirror sites +can be found at: + + + +http://www.kde.org/mirrors.html + + + + + + +From Source Code + + +If you want to build &koffice; from source code, you should: + + + + +Ensure your computer has all the required software installed and +in working condition (excluding &koffice; of course). You can find +the system requirements by following this link: +System Requirements. + + +Download the &koffice; source file into a temporary folder. + + +If the filename ends in .src.rpm +(&RedHat; Package Management file), the source code for &koffice; can +be installed with: +$ rpm filename + +If the filename ends in .src.tar.gz or .src.tgz (a tarball file), +the source code for &koffice; can be installed with: +$ tar filename + +The source code for &koffice; should now be installed on +your system. + + + + + + +&documentation.index; +     + diff --git a/doc/koshell/Makefile.am b/doc/koshell/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/koshell/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/koshell/index.docbook b/doc/koshell/index.docbook new file mode 100644 index 00000000..dc43b5d9 --- /dev/null +++ b/doc/koshell/index.docbook @@ -0,0 +1,507 @@ + + + + + +]> + + + + +The &koshell; Handbook + + + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +     + + +2005-2006 +Anne-Marie Mahfouf + + +&FDLNotice; + + + +2006-01-30 +1.5.0 + + + + + +&koshell; is the &koffice; Workspace where you can work with each component of the &koffice; productivity suite at the same time. &koshell; helps you organize your work in a friendly environment. + + + + + +KDE +KOffice +workspace +KWord +KSpread +KPresenter +KChart +KPlato +Kexi +Krita +Kivio +Kugar +KFormula +Karbon14 + + +     + + +Introduction + +&koshell; is a framework in which you can work with several &koffice; applications in the same window. Being based on a true component framework &koshell; provides exactly the +same functionality as the stand-alone applications, and adds more +features, by making available all components in the same window. + + +&koshell; is part of the &koffice; productivity suite for the K Desktop +Environment. Other applications in &koffice; include: + + +&kword; (A full featured WYSIWYG (What You See Is What You Get) +Word-processor/Desktop Publishing Program.) +&kspread; (A spreadsheet application.) +&kpresenter; (A presentation creator.) +Kexi (An integrated environment for databases.) +&kivio; (A flowchart creator.) +Karbon14 (A vector drawing program.) +&krita; (A pixel based drawing program.) +&kchart; (A chart and graph creator.) +&kformula; (A formula editor.) +&kugar; (A report generation tool.) + + +See the individual application manuals for details on how to use them. These manuals apply to +running the applications as components inside &koshell; just as well as running them stand-alone. + + + + + +The &koshell; Main Window + + +General + +&koshell; consists in a friendly workspace to allow you to work on several &koffice; applications at the same time. In the &koshell; main window you can see a side pane on the left showing the icons of the available &koffice; components and the main view on the right which contains the main window of the active component and the usual menubar and toolbar. + + +Here's a screenshot of &koshell; when you start it for the first time + + + + + + &koshell; screenshot + + + + + +Here you can see &koshell; as it is the first time you run it. &koshell; always starts empty. You can then choose different actions. You can use the side pane on the left to open the programs as if they are standalone applications. You can also open any supported document via the FileOpen + menu and the corresponding &koffice; application will open with the document loaded. + + + +You can also import any supported document using the FileImport + menu and as with the Open action, the adequate &koffice; application will be used to load your document. + + + + + +Side Pane + + +&koshell;'s Side Pane + + + +&koshell;'s Side Pane + +     + + + +The side pane allows you to open a new &koffice; component as if it was the stand-alone application. In most components, you are asked what document you want to open, a template, an empty document or an existing document. The main window of the component is then shown and the menubar, toolbars and statusbar in &koshell; are +adapted to reflect the functionality of the active component. + + +You can change the size of the icons in the side pane. +Right-clicking on the side pane will give you the option to use Large, +Normal, or Small icons, as well as the option to use text only +instead of icons. + +If you dislike the sidebar, you can simply hide it by dragging the +splitter to the left. + + + + + +Main View + +The view on the right which takes up most of the area of the &koshell; +main window shows the active component. This exactly corresponds to the main +window the component uses when run as a stand-alone application. + + +&koshell;'s Main View + + + +&koshell;'s Main View + + + + +When a component is loaded, the component own menus are merged with the &koshell; menus and the component toolbars are added on the workspace. + +Each new component is opened in a new tab. Using the &RMB; on each tab title, you can save the document in that tab or close that tab. The small button on the right bottom with a red cross also allows you to close the current tab. + +A special action common to all components is the + FileNew action in &koshell; menubar. It opens the Insert Object dialog which starts the &koffice; component as if it was a stand-alone application. + + +&koshell; Insert Object dialog + + + +&koshell; Insert Object dialog + + + + + + + + + +Command Reference + + +Menus and shortcut keys + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New + +Open the Insert Object dialog which lists all possible new documents you can open. + + + + + +&Ctrl;O + +File +Open... + +Open a supported document by choosing the corresponding &koffice; application. + + + + +File +Open Recent + +Display a selection of recently saved documents you can open. + + + + + +&Ctrl;S + +File +Save + +Save the current document. + + + + +File +Save As... + +Save the current document with a name you provide. + + + + +File +Reload + +Reload the current document. + + + + +File +Import... + +Import a supported document. + + + + +File +Export... + +Export the current document. + + + + +File +Mail... + +Invokes &kmail; so you can email the file. +The file is already attached to the email. + + + + +File +Save All + +Saves all open documents in &koffice; Workspace. + + + + + + +&Ctrl;P + +File +Print... + +Print the current document. + + + + +File +Print Preview... + +View the current document as it will be printed. + + + + + +File +Document Information + +View or enter information about the current document and +author. + + + + + + +&Ctrl;W + +File +Close + +Close the current document but leave &koshell; running. + + + + + + +&Ctrl;Q + +File +Quit + +Quits &koshell;. + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + +Settings +Hide/Show Toolbar + +Toggle the Main Toolbar. + + + + + +Settings +Configure Shortcuts... + +Configure the shortcuts. + + + + + +Settings +Configure Toolbars... + +Configure the items you want to put in the toolbar. + + + + + + + + +The <guimenu>Help</guimenu> Menu +&help.menu.documentation; + + + + + +Under The Hood + +&koshell; makes extensive use of several &kde; key technologies, most +notably KParts and &DCOP;. + +The &GUI; integration of the components is done by plugins +providing KParts versions of the applications. This only needs a thin +additional layer on top of the already existing code of the +stand-alone applications. Because they are based on the KParts component model, &koffice; programs +are designed to work very well with each other. Any &koffice; component +can be embedded in another &koffice; document. + +For communication between the components &DCOP; is used. This +has the nice characteristic that it is completely transparent to +whether the application is run stand-alone or embedded as KPart into +&koshell;. + + + + + +Credits and License + + +&koshell; + + +Program copyright 2001-2005 The &koffice; Workspace Team + + +Original authors: + +Sven Lüppken +sven@kde.org +Torben Weis +weis@kde.org +David Faure +faure@kde.org + + + + +Documentation copyright 2005 Anne-Marie Mahfouf annma@kde.org + + + + +&underFDL; +&underGPL; + + + + +Installation + + +How to obtain &koshell; + +&install.intro.documentation; + + + + +Requirements + + +&koshell; is part of &koffice; +on The &koshell; home +page +You must have &koffice; installed. &koshell; will not work without the rest of +&koffice; + + + + + +Compilation and installation + +&install.compile.documentation; + + + + +&documentation.index; + + + + diff --git a/doc/koshell/koshell1.png b/doc/koshell/koshell1.png new file mode 100644 index 00000000..164b9b5c Binary files /dev/null and b/doc/koshell/koshell1.png differ diff --git a/doc/koshell/main-view.png b/doc/koshell/main-view.png new file mode 100644 index 00000000..19d9e581 Binary files /dev/null and b/doc/koshell/main-view.png differ diff --git a/doc/koshell/new-dialog.png b/doc/koshell/new-dialog.png new file mode 100644 index 00000000..515cb8ba Binary files /dev/null and b/doc/koshell/new-dialog.png differ diff --git a/doc/koshell/side-pane.png b/doc/koshell/side-pane.png new file mode 100644 index 00000000..b196ea8b Binary files /dev/null and b/doc/koshell/side-pane.png differ diff --git a/doc/kplato/Makefile.am b/doc/kplato/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kplato/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kplato/commands.docbook b/doc/kplato/commands.docbook new file mode 100644 index 00000000..94847b1b --- /dev/null +++ b/doc/kplato/commands.docbook @@ -0,0 +1,566 @@ + + + + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +     +     +Command Reference + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New + +Create a new document. + + + + + +&Ctrl;O + +File +Open... + +Open an existing document. + + + + +File +Open Recent + +Open an existing document by selecting it +from a combo box of recently used files. + + + + + +&Ctrl;S + +File +Save + +Save the document. + + + + +File +Save As... + +Save the document with a new name or format. + + + + + +File +Reload + +Reloads the document. + + + + + +File +Import... + +Import other documents. + + + + + +File +Export... + +Save a document to any supported format. +The document does not become the exported file. + + + + + +File +Mail... + +Send the file as an email attachment. + + + + + + +&Ctrl;P + +File +Print... + +Print the document. + + + + +File +Print Preview... + +View the document as it will be printed. + + + + + +File +Document Information + +View or enter information about the document and +author. + + + + + + +&Ctrl;W + +File +Close + +Close the current document but leave &kplato; running. + + + + + + +&Ctrl;Q + +File +Quit + +Quit &kplato;. + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + + + +&Ctrl;Z + +Edit +Undo + +Undo the last action. + + + + + +&Ctrl;&Shift;Z + +Edit +Redo + +Redo the last undone action. + + + + + +Edit +Delete Task + +Delete the currently highlighted task. + + + + + +Edit +Indent Task + +Indent the currently highlighted task. + + + + + +Edit +Unindent Task + +Unindent the currently highlighted task. + + + + + +Edit +Move Up + +Move up the currently highlighted task. + + + + + +Edit +Move Down + +Move down the currently highlighted task. + + + + + + + + +The <guimenu>View</guimenu> Menu + + + + + +View +Expected + + - + + + + + +View +Optimistic + + - + + + + + +View +Pessimistic + + - + + + + + +View +Gantt + +View Gantt + + + + + +View +Resources + +Toggle on and off the resources names in the +Gantt view. + + + + + +View +Task Name + +Toggle on and off the tasks names in the +Gantt view. + + + + + +View +Task Links + +Toggle on and off the task links in the +Gantt view. + + + + + +View +Progress + +Toggle on and off the progress in the +Gantt view. + + + + + +View +Float + + - + + + + + +View +Critical Path + +Highlight the critical path in red. + + + + + +View +Critical Tasks + +Highlight the critical tasks in red. + + + + + +View +Resources + +View the resources instead of the Gantt or +the accounts. + + + + + +View +Accounts + +View the accounts instead of the Gantt or +the resources. + + + + + + + + + +The <guimenu>Insert</guimenu> Menu + + + + + +Insert +Task... + +Display the task settings dialog which allows +to define a new task after the current highlighted task. + + + + + +Insert +Sub-Task... + +Display the task settings dialog which allows +to define and insert a new sub-task of the current highlighted task. + + + + + +Insert +Milestone... + +Display the task settings dialog which allows +to define and insert a new sub-task of the current highlighted task. + + + + + + + + +The <guimenu>Project</guimenu> Menu + + + + +Project +Edit Main Project... + +Display the project settings dialog. + + + + + +Project +Edit Standard Worktime... + +Display the standard worktime dialog. + + + + + +Project +Edit Calendar... + +Display the calendar settings dialog. + + + + + +Project +Edit Accounts... + +Display the accounts settings dialog. + + + + + +Project +Edit Resources... + +Display the resources dialog where you can add +new resources groups and new resources names and properties. + + + + + +Project +Calculate + +Calculate Expected, Optimistic and Pessimistic. + + + + + + + +The <guimenu>Tools</guimenu> Menu + + + + +Tools +Generate WBS Code + + - + + + + + +Tools +Define WBS Pattern... + + - + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + +Settings +Toolbars + +Show or hide the toolbars: File, Report, +View and Project. + + + + + +Settings +Configure Shortcuts... + +Configure the keyboard shortcuts used by &kplato;. + + + + + + +Settings +Configure Toolbars... + +Configure the items you want to put in +the toolbars. + + + + + +Settings +Configure &kplato;... + +Display the &kplato; settings dialog. + + + + + + + + +The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + +     + + diff --git a/doc/kplato/configure-wbs.png b/doc/kplato/configure-wbs.png new file mode 100644 index 00000000..c50b9c0f Binary files /dev/null and b/doc/kplato/configure-wbs.png differ diff --git a/doc/kplato/configure1.png b/doc/kplato/configure1.png new file mode 100644 index 00000000..747847fe Binary files /dev/null and b/doc/kplato/configure1.png differ diff --git a/doc/kplato/configure2.1.png b/doc/kplato/configure2.1.png new file mode 100644 index 00000000..06746519 Binary files /dev/null and b/doc/kplato/configure2.1.png differ diff --git a/doc/kplato/configure2.png b/doc/kplato/configure2.png new file mode 100644 index 00000000..0d693c3d Binary files /dev/null and b/doc/kplato/configure2.png differ diff --git a/doc/kplato/definitions.docbook b/doc/kplato/definitions.docbook new file mode 100644 index 00000000..fb2e2cf7 --- /dev/null +++ b/doc/kplato/definitions.docbook @@ -0,0 +1,228 @@ + + + + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +Raphael +Langerhorst + +
    raphael.langerhorst@kdemail.net
    +     +     + +     +     +Definitions + + +Gantt charts +A Gantt chart is a popular type of bar chart, that aims to show the timing +of tasks or activities as they occur over time. Although the Gantt chart did not +initially indicate the relationships between tasks this has become more +common in current usage as both timing and interdependencies between tasks can +be identified. + + +In project management, a Gantt chart can show when the project terminal elements +start and finish, summary elements (shown) or terminal element dependencies (not +shown). A terminal element is defined as the smallest task tracked as part of +the project effort. The tasks are displayed on a page as bars. The page is laid +out such that time increases as you move across the page. A task's start +time/date is indicated by the point on the page the bar starts, and it's +duration is indicated by the length of the bar. + + +Since the initial introduction of Gantt charts, they have become an industry +standard as a key project management tool for representing the phases, tasks and +activities that are scheduled as part of a project Work Breakdown Structure +(WBS) or timeline of tasks. + + +The initial format of the chart was developed by Henry L. Gantt (1861-1919) in +1910 (see Work, Wages and Profit by H. L. Gantt, published by The +Engineering Magazine, NY, 1910). + + + + +Work Breakdown Structure (WBS) + +In project management, a work breakdown structure (WBS) is an exhaustive, +hierarchical (from general to specific) tree structure of deliverables and tasks +that need to be performed to complete a project. + + +The purpose of a WBS is to identify terminal elements (the actual items to be +done in a project). Therefore, WBS serves as the basis for much of project +planning. + +A useful rule of thumb is that any project can be broken down into +between 10 and 20 tasks. + + +Work breakdown structure is a very common project management tool. Many United +States government statements of work require work breakdown structures. + +See the section to learn how to +configure your WBS. + + + + +Float + +Float in project management is the amount of time that a terminal element in a +project network can be delayed by, without causing a delay to: + +subsequent terminal elements (free float) +project completion date (total float). + +Float is sometimes also called slack. + + + + +Task + +A task is a part of a project that needs to be accomplished within a defined +period of time. Tasks can be linked together to create Dependencies. + + +Tasks take place over a period of time and generally consume resources. + + +A task is termed critical when it has zero or negative float. + + +In &kplato;, each task has a task ID, a name and a responsible person. +The timing, the cost and the assigned resources can also be set +in the Task Settingsdialog. + +A subtask is any node in the WBS tree that has a task as its +parent. + + + + +Resource + +A resource is an item required to complete a task. Resources can be +people, equipment, facilities, funding or anything else needed to perform the +work of a project. Resources can have a limited time availability (&ie; an +employee that works 8 hours a day, 5 days a week). + +The availability is +defined by calendars. + + +In &kplato; resources are either persons (work) or machines/devices (material). + + + + +Calendars + +A calendar defines at what time a resource +is available. + + +Calendars can be either a regular working week or special working times +that can be individually defined for each day. This allows for very subtle +control over the availability of resources. + + +Every resource is usually connected to a +calendar. + + +In &kplato; you can even use hierarchical calendars. + + + + +Milestone + +A milestone is a scheduled event signifying the completion of a major +deliverable or a set of related deliverables (usually marking the end of a +period). A milestone is an activity with zero duration and no effort &ie; there +is no work associated with a milestone. It is a flag in the workplan to signify +some other work has completed. + + +Usually a milestone is used as a project checkpoint to validate how the project +is progressing and revalidate work. Milestones are also used as high-level +snapshots for management to validate the progress of the project. In many cases +there is a decision to be made at a milestone. + + + + +Critical path +A path is a series of connected tasks. In project management, a +critical path is the sequence of project network terminal elements with the +longest overall duration, determining the shortest time to complete the project. + + +The duration of the critical path determines the duration of the entire project. +Any delay of a terminal element on the critical path directly impacts the +planned project completion date (i.e. there is no float on the critical path). +For example, if a task on the critical path is delayed by one day, then the +entire project will be delayed by one day (unless another task on the +critical path can be accelerated by one day). + + +A project can have several, parallel critical paths. An additional parallel path +through the network with the total duration just shorter than the critical path +is called a sub-critical path. + + +Originally, the critical path method considered only logical dependencies among +terminal elements. A related concept is the critical chain, which adds resource +dependencies. + + +The critical path method was invented by the DuPont corporation. + + + + +Scheduling + +Scheduling is the process of creating a project schedule based on the project +data like tasks, +resources and +calendars. The result can be viewed in a chart, +like a gantt chart. &kplato; can also generate +reports for a project. + + +There are usually various scheduling modes, like optimistic, expected and +pessimistic scheduling. When creating a task the additional estimation +percentage +for optimistic and pessimistic scheduling can be set. These settings are then +used for the various scheduling modes. + + +When scheduling a project with &kplato;, you can choose between optimistic, +expected and pessimistic scheduling. + + + +     + + diff --git a/doc/kplato/edit-accounts.png b/doc/kplato/edit-accounts.png new file mode 100644 index 00000000..7de6f367 Binary files /dev/null and b/doc/kplato/edit-accounts.png differ diff --git a/doc/kplato/edit-accounts1.png b/doc/kplato/edit-accounts1.png new file mode 100644 index 00000000..804474d1 Binary files /dev/null and b/doc/kplato/edit-accounts1.png differ diff --git a/doc/kplato/edit-calendar.png b/doc/kplato/edit-calendar.png new file mode 100644 index 00000000..41f37158 Binary files /dev/null and b/doc/kplato/edit-calendar.png differ diff --git a/doc/kplato/edit-calendar1.png b/doc/kplato/edit-calendar1.png new file mode 100644 index 00000000..abe7acaa Binary files /dev/null and b/doc/kplato/edit-calendar1.png differ diff --git a/doc/kplato/edit-calendar2.png b/doc/kplato/edit-calendar2.png new file mode 100644 index 00000000..9c0ed3ab Binary files /dev/null and b/doc/kplato/edit-calendar2.png differ diff --git a/doc/kplato/edit-resources.png b/doc/kplato/edit-resources.png new file mode 100644 index 00000000..e8662dc4 Binary files /dev/null and b/doc/kplato/edit-resources.png differ diff --git a/doc/kplato/edit-resources1.png b/doc/kplato/edit-resources1.png new file mode 100644 index 00000000..c7428ba5 Binary files /dev/null and b/doc/kplato/edit-resources1.png differ diff --git a/doc/kplato/edit-worktime.png b/doc/kplato/edit-worktime.png new file mode 100644 index 00000000..b898cf38 Binary files /dev/null and b/doc/kplato/edit-worktime.png differ diff --git a/doc/kplato/index.docbook b/doc/kplato/index.docbook new file mode 100644 index 00000000..e9204839 --- /dev/null +++ b/doc/kplato/index.docbook @@ -0,0 +1,131 @@ + + + + + + + + + + + +]> + + + + +The &kplato; Handbook + + + +Raphael + +Langerhorst + +
    raphael.langerhorst@kdemail.net
    +     +     + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +     + +&FDLNotice; + + + +2006-02-11 +0.5.0 + + + + + +&kplato; is a project planning and management application for &kde;. + + + + + +KDE +KPlato +Project +Management +gantt + + +     + + Introduction + +&kplato; as included in &koffice; 1.5 is a technology preview +release and it is not advised to use &kplato; in critical +production scenarios. Do so at your own risk. In this first public release we +focus on planning and scheduling of projects. + + +&kplato; is a project management application and a planning tool. +As an integrated component of &koffice;, &kplato; can +be used within larger documents of other &koffice; components. + + + Features + +Features include: +Resource management, +Hierarchical calendars, +Tasks with dependencies and subtasks. + + +Chart for visualization: +Gantt + + + +Project scheduling +Pessimistic, +Expected, +Optimistic. + + +Work breakdown structure (WBS). +Critical path and resources. +Embedding into other KOffice applications. + + + +&definitions; +&mainwindow; +&wbs; +&options; +&commands; + +License + +&underFDL; + + + +&documentation.index; +     + + + diff --git a/doc/kplato/mainwindow.docbook b/doc/kplato/mainwindow.docbook new file mode 100644 index 00000000..7b48ec20 --- /dev/null +++ b/doc/kplato/mainwindow.docbook @@ -0,0 +1,53 @@ + + + + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +     +     +&kplato; Main window + +Here is the default &kplato; main window when you load an existing +project. + + + +Here's a screenshot of &kplato; + + + + + + &kplato; main window + + + + +At the top there is the menubar (1). All &kplato; functions are +available from the menus, which are described in detail in . + +Below the menubar are located the toolbars (2) and (3). You can show or +hide them using the +Settings +Toolbars menu. You can also configure +the toolbars (add or remove actions) using the +Settings +Configure Toolbars... dialog. + +(3) is the view toolbar. It allows you to quickly switch between +different views: Gantt, Resources or Accounts. +(4) is the main view. In the Gantt view currently shown on +the screenshot, you have 2 panes, one with the tasks names and one with +the Gantt chart. +(5) is the resource pane which you can see in the Gantt and Resources +views but not in the Account view. It is not shown per default and you +can drag the separation bar to display it. + +     diff --git a/doc/kplato/mainwindow1.png b/doc/kplato/mainwindow1.png new file mode 100644 index 00000000..99a98a6c Binary files /dev/null and b/doc/kplato/mainwindow1.png differ diff --git a/doc/kplato/options.docbook b/doc/kplato/options.docbook new file mode 100644 index 00000000..86354a2d --- /dev/null +++ b/doc/kplato/options.docbook @@ -0,0 +1,366 @@ + + + + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +     +     +Configuring &kplato; + + +The <guilabel>Project Settings</guilabel> Dialog + +This dialog allows you to set some properties for your current project. +You can access this dialog using the +Project +Edit Main Project... menu. + + +The Project Settings dialog + + + + +The Project Settings dialog + + + + + +ID: +Enter a number. It sets the project +identification and must be unique. + + + + +Name: +Enter the name of your project. + + + +Leader: +Enter the name of the project leader. Clicking +the Choose... button will bring your +contact list from KAddressBook and you can choose a name here. + + + +Scheduling +Here you define when the project will start or +end. Choose either a start date or an end date. + + +Start Date: +If a start date is set, the project is scheduled forward +from this time. When the project has been calculated, end time shows when the +project is planned to end. + + + +End Date: +If a end date is set, the project is scheduled backwards +from this time. When the project has been calculated, start time shows when the +project must start in order to finish in time. + + + + + + +Project notes and summary: +You can write here various notes associated +with the project or/and a project summary. + + + +Clicking the OK button will apply your changes and +close the dialog and clicking the Cancel button will +cancel any change you just made. + + + + +The <guilabel>Standard Worktime</guilabel> Dialog +This dialog allows you to set the worktime in terms of hours. +You can access this dialog using the +Project +Edit Standard Worktime... menu. + + +The Standard Worktime dialog + + + + +The Standard Worktime dialog + + + +These values are used when you estimate the effort needed to +complete a task. Defaults are the numbers of hours worked in a normal +day/week/month and year. + + + +Hours per year: +Set the hours worked per year. + + +Hours per month: +Set the hours worked per month. + + +Hours per week: +Set the hours worked per week. + + +Hours per day: +Set the hours worked per day. + + + +Clicking the OK button will apply your changes and +close the dialog and clicking the Cancel button will +cancel any change you just made. + + + + +The <guilabel>Calendar's Settings</guilabel> Dialog +This dialog allows you to set a calendar for your current project. +You can access this dialog using the +Project +Edit Calendar... menu. + + +The Calendar's Settings dialog + + + + +The Calendar's Settings dialog + + +You can have several calendars for your current project. First add a name +for your first calendar using the Add button. The +calendar view becomes active with the current day marked in a square +when you click on the calendar name. + + +Working with a calendar + + + + +Working with a calendar + + + +You can set Working or Non-working days. Click on the days you want +as Working days for example for your project and choose Working instead +of Undefined. Set then the work interval by choosing the start and end +times and click the Add interval button to add the +working time. Click the Apply button to validate your +choice. + + +Working and non-working days + + + + +Working and non-working days + + + +Here you can see the working days in blue and the non-working day +in red. + +Clicking the OK button will apply your changes and +close the dialog and clicking the Cancel button will +cancel any change you just made. + + + + +The <guilabel>Edit Accounts</guilabel> Dialog +Accounts are used to evaluate the project cost. This dialog allows you to +set up the various accounts used in your current project. +You can access this dialog using the +Project +Edit Accounts... menu. + + +The Edit Accounts dialog + + + + +The Edit Accounts dialog + + + +To create an account, click the New button. +You can then enter the account name which you validate by using the Enter +key. You can add a short description of this account by double-clicking +in the description field. +You can create sub-accounts of your main account or a new account. Remove +any highlighted account using the Remove button. +You can also set a default account by choosing the account name in +the drop-down list. + + +Creating accounts + + + + +Creating accounts + + + +Clicking the OK button will apply your changes and +close the dialog and clicking the Cancel button will +cancel any change you just made. + + + + +The <guilabel>Resources</guilabel> Dialog +This dialog allows you to set the resources for your current project. +You can access this dialog using the +Project +Edit Resources... menu. + + +The Resources dialog + + + + +The Resources dialog + + + +You need first to define a resource group by clicking the +New button in the resource group area. Click on +this group name and add a new resource by clicking the +New button in the resource area. This will display +the Resource Settings dialog. + + +The Resources Settings dialog + + + + +The Resources Settings dialog + + + +Clicking the OK button will apply your changes and +close the dialog and clicking the Cancel button will +cancel any change you just made. + + + + +The <guilabel>Configure &kplato;...</guilabel> Dialog + +This dialog allows you to set default options globally in &kplato;. You +can access this dialog using the +Settings +Configure &kplato;... menu. + +On any widget in this dialog you can get a What's This +help with &Shift;F1 or using the +Help icon. + + + +<guilabel>Task Defaults</guilabel> + +This set the options that will be used per default each time you add a +new task. + + + +Task Defaults + + + + +Task Defaults + + + + + +Responsible: +Insert the name of the person responsible for this task. +This is not limited to persons available in a resource group but can be +anyone. +Clicking the Choose... button will allow you to +insert a person from your address book. + +Addresses + + + + +Addresses + + + + + + +Timing + + + + +Schedule: +Choose the scheduling constraint you would +like as default. Depending on this constraint, the date fields +become available if they need to be filled. These +settings affect the actual scheduling of the task. + + +Estimate: +Estimates the predictions of the quantitative +results. The estimation can be either effort based or duration based. If it is +effort based, the final duration will depend on the resources assigned to the +task. For duration based estimation, the assigned resources don't affect the +fixed duration of the task, but only the costs. + + + + + + + +Note: +Write here a note that you would like to be +displayed as default on each new task. + + + +Clicking the Defaults button will reset the +dialog to its defaults, while clicking Apply will apply +your changes but leave the dialog open. Clicking the OK +button will apply your changes and close the dialog and +Cancel will cancel any change you just made. + + + + +     \ No newline at end of file diff --git a/doc/kplato/project-settings.png b/doc/kplato/project-settings.png new file mode 100644 index 00000000..1beb2a96 Binary files /dev/null and b/doc/kplato/project-settings.png differ diff --git a/doc/kplato/wbs.docbook b/doc/kplato/wbs.docbook new file mode 100644 index 00000000..0581c772 --- /dev/null +++ b/doc/kplato/wbs.docbook @@ -0,0 +1,139 @@ + + + + +Anne-Marie +Mahfouf + +
    annma@kde.org
    +     +     + +     +     +Configuring the Work Breakdown Structure (WBS) + +The Work Breakdown Structure introduces +numbering for all tasks in the +project, according to the task structure. The tasks are numbered in a fashion +that reflects the structure of the project. +The WBS is defined as a tree structure. + + + +The WBS + + + + + + The WBS + + + + +You can configure the way you want the WBS to look in your project. To do +so, you can use the +ToolsDefine WBS Pattern... + menu. This displays the WBS Definition Dialog. + + + +The WBS Definition Dialog + + +WBS Definition Dialog + + + + + + WBS Definition Dialog + + + + + + +Code +Default is Number but you can set the WBS +code to be Roman Numbers or Letters, either upper case or +lower case. + + +Separator +The default separator is a dot and can be set +to anything else you want. The separator defines the way the +tree will look. On the screenshot above, the separator is the +dot. + + + +Instead of having the same code for all levels (for example 3.2.1) +you can define a different code for each level. For this you can check +Use Levels and then you define each level code and +separator. + +For example if you want your tree to be 1:II-B you will set +level 0 to Number and separator :, level 1 will be Roman upper case and +separator - and level 2 will be Letter upper case. + +This is illustrated on the next screenshot. + + +WBS levels definition + + + + + + WBS levels definition + + + + +To set a new level, choose the level number in the box near the +Add Level button then click the Add +Level button. Then choose the Code for the level and the +separator. + + +Add a level + + + + + + Add a level + + + + +To remove a level, choose the level number in the first column of the +list and click on it. The level row is then highlighted and the level number +changes to bold. Then click the Remove button. This is +demonstrated on the screenshot with Level 2. + + +Remove a level + + + + + + Remove a level + + + + + + +<guilabel>Generate WBS Code</guilabel> +The WBS code is auto-generated; simply choose Generate WBS +Code from the Tools menu to generate the +WBS code for the project. +After you changed the WBS definition you will want to generate the +new WBS. + + +     \ No newline at end of file diff --git a/doc/kplato/wbs.png b/doc/kplato/wbs.png new file mode 100644 index 00000000..f597935b Binary files /dev/null and b/doc/kplato/wbs.png differ diff --git a/doc/kplato/wbs1.png b/doc/kplato/wbs1.png new file mode 100644 index 00000000..24503a85 Binary files /dev/null and b/doc/kplato/wbs1.png differ diff --git a/doc/kplato/wbs2.png b/doc/kplato/wbs2.png new file mode 100644 index 00000000..daf13363 Binary files /dev/null and b/doc/kplato/wbs2.png differ diff --git a/doc/kplato/wbs3.png b/doc/kplato/wbs3.png new file mode 100644 index 00000000..7758ab86 Binary files /dev/null and b/doc/kplato/wbs3.png differ diff --git a/doc/kpresenter/Makefile.am b/doc/kpresenter/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kpresenter/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kpresenter/a11y.docbook b/doc/kpresenter/a11y.docbook new file mode 100644 index 00000000..66f687e2 --- /dev/null +++ b/doc/kpresenter/a11y.docbook @@ -0,0 +1,321 @@ + + + + +Gary +Cramblitt + + + + + +For Users with Disabilities +This section of the documentation discusses accessibility features in &kpresenter; +for users with disabilities. Some of these features apply to &kde; as a whole and are controlled from +&kcontrolcenter;. Some apply to all &koffice; applications, +and some are specific to &kpresenter;. + + +Installing the <command>kdeaccessibility</command> Module +kdeaccessibility + +Most of the features described in this chapter are enabled by installing the +kdeaccessibility module. +The kdeaccessibility module is part of the &kde; project +http://www.kde.org. The kdeaccessibility +package can be obtained from &kde-ftp;, the +main ftp site of the &kde; project. + + +Many distributions offer precompiled binaries on their ftp sites. Please check your distribution's web sites for more information. + +More information about &kde; accessibility can be obtained by +visiting http://accessibility.kde.org/. + + + + +Visual Impairments +Visual Impairments + +&kpresenter; is not usable by totally blind users. It is hoped that +a general screen reader for the blind will be available in future versions of &kde;. + + + +Theming +Theming +For low-sighted or light alergic users, several features are available from +K-Button&kcontrolcenter;. +Under Appearance & ThemesTheme Manager +, you may select from several themes. If you are light alergic, the +HighContrastDark or HighContrastLight themes +may be helpful. If you have difficulty reading small fonts or seeing small icons, the +HighContrastDark-Big or HighContrastLight-Big +themes will increase the size of text, buttons, and icons. You may also customize +background, colors, fonts, and icons from the same screen. A set of monochrome icons +is available. + + +If you choose one of the Big themes, you may discover that +some screens are too large to fit your monitor. Purchasing a larger monitor will be helpful. +You can drag the portions of the screen not visible into the visable area by +holding down the &Alt; key and dragging with the mouse anywhere +within the screen. If you have trouble operating a mouse, you can also move screens by pressing +&Alt;F3. In +the dropdown Windows Operations Menu, choose +Move. +Move the screen with the arrow keys and press &Esc;. + + + + + +KMagnifier +magnifier +The kdeaccessibility module includes a screen magnifier +application called KMagnifier. +If it is installed, you may run it from +K-ButtonUtilities +AccessibilityScreen Magnifier. + + + + +Text-to-Speech +Text-to-Speech +TTS +The kdeaccessibility module includes a Text-to-Speech +component called KTTS. If KTTS is installed, you can configure &kpresenter; to +speak the text that is under the mouse pointer or speak the text of each +screen widget as it receives focus. Before using this feature, first configure +KTTS. See The KTTS Handbook for details. +To turn on the TTS feature in &kpresenter;, +select SettingsConfigure +&kpresenter;... from the menubar. +This will display a dialog box. +Clicking TTS will allow you to change +the following. + + + + + + + + + +Speak widget under mouse pointer +When checked, &kpresenter; will speak the text of each widget +as the mouse pointer moves over the widget. + + + +Speak widget with focus +When checked, &kpresenter; will speak the text of each widget +as it receives focus. + + + +Speak tool tips +When checked, &kpresenter; will speak the popup tool tip +for each widget in addition to the text of the widget. + + + +Speak Whats This +When checked, &kpresenter; will speak the Whats This help +for each widget in addition to the text of the widget. + + + +Say whether disabled +When checked, &kpresenter; will speak the word "disabled" +if the widget is currently disabled (grayed). + + + +Speak accelerators +When checked, &kpresenter; will speak the accelerator +of the widget in addition to the text of the widget. +Accelerators are the underlined letters you see in the text of the +widget. For example, in the main menu, the +Quit menu item +has the "Q" underlined. You can choose it by pressing Q. +To speak the accelerator, check this option and enter the +word you want to speak before the accelerator in the +Prefaced by the word box. In this +example shown above, &kpresenter; will speak "Accelerator Q". + + + +Polling interval +This option determines how often &kpresenter; will +check for a change in the widget under the mouse pointer or +a new focused widget. You should leave this option on the +default setting. + + + + + +If the TTS option does not appear +on this screen, you do not have the KTTS component installed +in your system. + + +Not all widgets are spoken. For example, +the items on the main menubar are not spoken. + + + + + + + +Motor Impairments and Mouseless Operation +Motor Impairments +Mouseless Operation + + +KMouseTool +If you can operate a mouse, but have trouble clicking, the +KMouseTool application may help. Run it from +K-ButtonUtilities +KMouseTool (Automatik Mouse Click). + + + + +XAccess Features +XAccess +Sticky Keys +Slow Keys +Bounce Keys + +The &kcontrolcenter; offers several keyboard features collectively called XAccess. +They include: + + +Sticky Keys +This feature permits operation of meta keys, such as +&Alt;, &Ctrl;, and &Shift; without having to hold the keys down. It is useful +when you can only use one finger or one hand to operate the keyboard. +With Sticky Keys on, press and release a &Alt;, &Ctrl;, or &Shift; key, then +press another key. The result is as if you pressed both keys at once. +Press the &Alt;, &Ctrl;, or &Shift; key again to turn off the sticky key. +Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityModifier Keys. + + + +Slow Keys +This feature is useful if you have hand tremors or difficulty +accurately pressing keys. It prevents +inadvertent key presses by requiring that a key be held down for a minimum +time before it is accepted. Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityKeyboard Filters . + + + +Bounce Keys +This feature is also useful if you have hand tremors. It prevents +inadvertent repeated key presses by preventing another keystroke for +a certain amount of time. Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityKeyboard Filters. + + + + + + + +Mouse Emulation +Mouse Emulation +Mouse Emulation permits you to move and click the mouse using the keyboard. +Press &Alt;F12 to activate it. Use the arrow keys +to move the mouse pointer to the desired location, and press spacebar +to "click" the mouse. Unfortunately, you cannot use Mouse Emulation to perform +&RMB; clicks or dragging. + + + + +Mouse Navigation +Mouse Navigation +This feature permits you to emulate the mouse using the numeric keypad +of your keyboard. To activate it, go to +K-Button&kcontrolcenter; +PeripheralsMouse +Mouse Navigation. +Check the Move pointer with keyboard (using the num pad) box. When you do this, the other settings will become enabled, and you can customize the keyboard pointer behavior further, if required. + The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The 5 key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the / key (which makes it &LMB;), +* key (which makes it middle mouse button) and - (which makes it &RMB;). + Using the + emulates a doubleclick to the selected pointer button. You can use the +0 key to emulate holding down the selected pointer button (for easy dragging), +and then use the . to emulate releasing the selected pointer button. + + + + + + + + + + + +Keyboard shortcuts + +Use the Menu key to pop up the context +menu. On most keyboards, the Menu key is on the righthand +side of the keyboard between the &Windows; and &Ctrl; +keys. It has a menu icon on it. + + + + + +Resizing panels + +You can move the sizing bar between the outline panel and the +slide panel, and between the slide panel and the notes panel +by pressing F8. A sizing icon appears +overtop the sizing bar. Pressing F8 again moves from one +sizing bar to the next. After the last sizing bar, pressing F8 +hides the sizing icon. Use the arrow keys to move the bar up or down, or left or right. +Press &Esc; when finished sizing. + + + + + +Setting focus to widgets + +Normally, one can use the and &Shift; +to move focus from one widget to the next in any application. However, when focus is +in the slide panel of &kpresenter;, pressing does not move the focus. +You can set focus to any widget that can receive focus by +pressing &Alt;F8. A small lettered box appears +overtop each widget on the screen that can receive focus. + + + + + + + + +Press the letter to move focus to the corresponding widget. Press +&Alt;F8 again or &Esc; +to abandon moving the focus. + + + + + + + diff --git a/doc/kpresenter/autocorrection1.png b/doc/kpresenter/autocorrection1.png new file mode 100644 index 00000000..8de3dcf9 Binary files /dev/null and b/doc/kpresenter/autocorrection1.png differ diff --git a/doc/kpresenter/autocorrection2.png b/doc/kpresenter/autocorrection2.png new file mode 100644 index 00000000..d8227294 Binary files /dev/null and b/doc/kpresenter/autocorrection2.png differ diff --git a/doc/kpresenter/autocorrection3.png b/doc/kpresenter/autocorrection3.png new file mode 100644 index 00000000..6ea8c51d Binary files /dev/null and b/doc/kpresenter/autocorrection3.png differ diff --git a/doc/kpresenter/autocorrection4.png b/doc/kpresenter/autocorrection4.png new file mode 100644 index 00000000..a9e07fc5 Binary files /dev/null and b/doc/kpresenter/autocorrection4.png differ diff --git a/doc/kpresenter/barstyle1.png b/doc/kpresenter/barstyle1.png new file mode 100644 index 00000000..47747f59 Binary files /dev/null and b/doc/kpresenter/barstyle1.png differ diff --git a/doc/kpresenter/barstyle3.png b/doc/kpresenter/barstyle3.png new file mode 100644 index 00000000..19db5238 Binary files /dev/null and b/doc/kpresenter/barstyle3.png differ diff --git a/doc/kpresenter/barstyle4.png b/doc/kpresenter/barstyle4.png new file mode 100644 index 00000000..53dfacdf Binary files /dev/null and b/doc/kpresenter/barstyle4.png differ diff --git a/doc/kpresenter/barstyle5.png b/doc/kpresenter/barstyle5.png new file mode 100644 index 00000000..d27f23fa Binary files /dev/null and b/doc/kpresenter/barstyle5.png differ diff --git a/doc/kpresenter/barstyle6.png b/doc/kpresenter/barstyle6.png new file mode 100644 index 00000000..11145c3c Binary files /dev/null and b/doc/kpresenter/barstyle6.png differ diff --git a/doc/kpresenter/barstyle7.png b/doc/kpresenter/barstyle7.png new file mode 100644 index 00000000..0f4a9593 Binary files /dev/null and b/doc/kpresenter/barstyle7.png differ diff --git a/doc/kpresenter/break.png b/doc/kpresenter/break.png new file mode 100644 index 00000000..02d88898 Binary files /dev/null and b/doc/kpresenter/break.png differ diff --git a/doc/kpresenter/changeformat.png b/doc/kpresenter/changeformat.png new file mode 100644 index 00000000..074f95e9 Binary files /dev/null and b/doc/kpresenter/changeformat.png differ diff --git a/doc/kpresenter/completion.png b/doc/kpresenter/completion.png new file mode 100644 index 00000000..6d9b7bf3 Binary files /dev/null and b/doc/kpresenter/completion.png differ diff --git a/doc/kpresenter/configure1.png b/doc/kpresenter/configure1.png new file mode 100644 index 00000000..50097708 Binary files /dev/null and b/doc/kpresenter/configure1.png differ diff --git a/doc/kpresenter/configure2.png b/doc/kpresenter/configure2.png new file mode 100644 index 00000000..520282c0 Binary files /dev/null and b/doc/kpresenter/configure2.png differ diff --git a/doc/kpresenter/configure3.png b/doc/kpresenter/configure3.png new file mode 100644 index 00000000..53e74781 Binary files /dev/null and b/doc/kpresenter/configure3.png differ diff --git a/doc/kpresenter/configure4.png b/doc/kpresenter/configure4.png new file mode 100644 index 00000000..21e07ac2 Binary files /dev/null and b/doc/kpresenter/configure4.png differ diff --git a/doc/kpresenter/configure4a.png b/doc/kpresenter/configure4a.png new file mode 100644 index 00000000..01e85f55 Binary files /dev/null and b/doc/kpresenter/configure4a.png differ diff --git a/doc/kpresenter/configure4a1.png b/doc/kpresenter/configure4a1.png new file mode 100644 index 00000000..8c09e4b2 Binary files /dev/null and b/doc/kpresenter/configure4a1.png differ diff --git a/doc/kpresenter/configure4b.png b/doc/kpresenter/configure4b.png new file mode 100644 index 00000000..72bbecc4 Binary files /dev/null and b/doc/kpresenter/configure4b.png differ diff --git a/doc/kpresenter/configure4c.png b/doc/kpresenter/configure4c.png new file mode 100644 index 00000000..eb76fdef Binary files /dev/null and b/doc/kpresenter/configure4c.png differ diff --git a/doc/kpresenter/configure5.png b/doc/kpresenter/configure5.png new file mode 100644 index 00000000..dcc4d93f Binary files /dev/null and b/doc/kpresenter/configure5.png differ diff --git a/doc/kpresenter/configure6.png b/doc/kpresenter/configure6.png new file mode 100644 index 00000000..ccf339f2 Binary files /dev/null and b/doc/kpresenter/configure6.png differ diff --git a/doc/kpresenter/configure6b.png b/doc/kpresenter/configure6b.png new file mode 100644 index 00000000..8d584386 Binary files /dev/null and b/doc/kpresenter/configure6b.png differ diff --git a/doc/kpresenter/configure6c.png b/doc/kpresenter/configure6c.png new file mode 100644 index 00000000..af374508 Binary files /dev/null and b/doc/kpresenter/configure6c.png differ diff --git a/doc/kpresenter/configure6d.png b/doc/kpresenter/configure6d.png new file mode 100644 index 00000000..b843ee13 Binary files /dev/null and b/doc/kpresenter/configure6d.png differ diff --git a/doc/kpresenter/configure6e.png b/doc/kpresenter/configure6e.png new file mode 100644 index 00000000..cf306af8 Binary files /dev/null and b/doc/kpresenter/configure6e.png differ diff --git a/doc/kpresenter/configure7.png b/doc/kpresenter/configure7.png new file mode 100644 index 00000000..178d9ca0 Binary files /dev/null and b/doc/kpresenter/configure7.png differ diff --git a/doc/kpresenter/faq.docbook b/doc/kpresenter/faq.docbook new file mode 100644 index 00000000..29ab9b05 --- /dev/null +++ b/doc/kpresenter/faq.docbook @@ -0,0 +1,53 @@ + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +     +     +Questions and Answers +&kpresenter; 1.6 + +Things you might like but &kpresenter; does not yet do (and what +to do about it) + + + +Powerpoint Files. &kpresenter; does +attempt to import &Microsoft; Powerpoint +files but it does not always work perfectly. It depends on the +Powerpoint file version and what is in the +file. You can always import pictures for the background image and +re-type any text. It's not the ideal solution, re-doing the entire +presentation. However, just bear in mind that +Powerpoint does not even attempt to read +&kpresenter; files. + +Taking notes or minutes. One piece of software allows you to +make notes during the meeting and puts them into a word +processor. If you are speaking, someone else should be taking notes. If +you really must do this sort of thing, take a note pad and pencil. + + + +     diff --git a/doc/kpresenter/great-presentations.docbook b/doc/kpresenter/great-presentations.docbook new file mode 100644 index 00000000..82d4bcdc --- /dev/null +++ b/doc/kpresenter/great-presentations.docbook @@ -0,0 +1,145 @@ + + + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +     +     +General Hints and Tips for Great Presentations + +Okay, you've decided to use &kpresenter; for your +presentation. Before you start making transparencies or animated slide +shows, go and find a piece of paper and sit down at a desk away from +the computer. It doesn't matter whether you are doing a teaching +session or trying to convince the boss that your plan, policy or idea +should be adopted, you need to figure out what you are trying to +say. Write down all the subjects you need to cover, try to get them in +the order you think will make sense. Don't put any details in yet, +just decide on headings and the structure of your talk. + +Under each heading make a note of what facts you need to +cover. You are trying to build a convincing argument. Consider +grouping your facts into things must be included, things that should +be included and things that it would be nice to cover if you had +plenty of time. + +Once you have written down all the things you need to say, +consider the time available to do it in. Ten minutes seems ages when +you start, but it is very difficult to actually get much across in so +short a time. Get your sheet of paper and a clock with a second +hand. Practise your presentation over and over again. This has many +benefits. Firstly, you get the timing right. If someone says you have +ten minutes, never go over the allowed time. Secondly, when you +actually do it in front of a live audience, it will not be the first +time you have done that presentation. Third, you get the words right +in your own head. You will find ways of saying things about the +subject. If you've heard yourself do this presentation several times, +you will know what you are going to say next and how you are going to +say it. + +&kpresenter; does not produce Speaker's Notes at the time of +writing, but I am happy to just use ordinary slides. Produce some +slides for yourself, printed on plain paper, and some for use with the +Overhead Projector. Make the text on your slides nice and big, you +need to be able to read it at a distance. I use 14 or 16 point text, +experiment to find a size that you can read easily. I never write out +a script. + +If you are using an Overhead projector, learn how to use it +beforehand. Make sure that the bulb works, that the spare bulb is +still okay. Clean the lens and display plates. If you are not used to +working with projectors, practice. Ensure that the projection screen +itself is clean. It's probably best, when timing yourself, to allow +for five seconds (count one thousand and one, one thousand and +two....) to change each slide. That way you know you don't +have to rush. If you need to point at something on a slide, you can +use a pointer and point at the display screen, find a laser pointer or +put a pencil on the transparency itself. Be warned, these tend to roll +out of place when you nudge the table. + +Consider where you are going to stand. You cannot stand in +front of your display, so off to one side is probably your best option +if you want your audience to be able to see. I often project a picture +onto a wipeboard and draw over the top of it. If you are using a PC +with a digital projector you can draw over the top of your slides with +&kpresenter;'s pen tool. Remember, drawing freehand with a mouse is a +skill that needs practice. If you are using an Overhead projector, you +can use transparent overlay slides and a pen over the top of your +computer generated ones. + +When you are doing the presentation do not accidently look into +the light, it's easy to do. If you are not going to use the machine +for a few minutes, turn it off. Practise to get where you are going +to stand sorted out. Check the room you intend to use for electrical +sockets and learn how the blinds work and where the light switches +are. Good preparation not only makes you less likely to make mistakes +(inanimate things can be a nightmare in front of an audience) but also +gives you confidence. Always have a Plan B ready if +something refuses to work. Have a paper copy of your slides with +you. You can photocopy and distribute these to your audience if the +equipment fails. + +I have not said much about the content yet. At present all you +have is a piece of paper with everything you want to say on it. Before +you make anything, ask youself if their understanding of what you are +saying is going to improved by showing them a picture. Bad +presentations consist of a series of slides full of text. The +presenter then reads the slide to the audience (who have already read +it as they can read faster than someone can say it aloud). Try to +avoid writing anything on the slide, except a title and a number. Draw +a picture of what you need to say, then explain the picture to +them. That way they do not get ahead of you (they can read faster than +you can speak, remember?) and you look like you know it. You do not +know it, you are using the picture as a series of prompts. A slide +should support what you are saying, not duplicate it. A slide should +be the focus of the audience's attention, not a distraction. + +An example. I teach Railway staff how to respond to accidents. I +wanted to use a slide to discuss how you can move dangerous loads from +a derailed or damaged rail vehicle to a road vehicle after an +accident. The slide I made had a simple drawing of tank wagon, the +kind used for carrying gases or oils. On the side I wrote +Lethal Chemical Company so that I do not have to +explain it. I wanted to make several important points. First, you must +get any overhead electric wires turned off before you do anything if +they are within a certain distance. I drew one of the supporting +structures and drew an arrow with the safety distance on it. Then I +wanted to say that you must not transfer the wagon's contents in +darkness or thunderstorms. I drew a moon and a lightning bolt above +the vehicle. You must get specialist advice, so I drew a sheet of +paper and wrote the word Plan near the vehicle. You +also have to ensure that the vehicle does not move when the weight +inside is removed. I drew little red wedges by the wheels. Everything +I need to talk about is on this drawing. All I have to do is look at +the drawing and it tells me what I need to cover. When I have covered +all the things in the drawing, I have finished on that +subject. + +In general, only use a slide or picture if it shows something +that adds to what you are saying. Finally, relax and try not to rush +through it all. Talk to them, not at them and remember that a +presentation is about whatever message you are trying to get +across. &kpresenter; is a useful tool. It can help you to get that +message over, but it cannot do the job for you. + +     diff --git a/doc/kpresenter/guides.docbook b/doc/kpresenter/guides.docbook new file mode 100644 index 00000000..9055bb43 --- /dev/null +++ b/doc/kpresenter/guides.docbook @@ -0,0 +1,556 @@ + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +Brad +Hards + +
    bradh@frogmouth.net
    +     +     + +Danny +Allen + +
    danny@dannyallen.co.uk
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + + +     +     +Detailed Guides + +This chapter describes how to perform some common tasks in +&kpresenter;. + + +Create a <acronym>HTML</acronym> Slideshow + +Turn an existing presentation into standard HTML +pages with accompanying navigation aids. + + + +First, either make a new presentation, or open an existing one. Then, +click on FileCreate HTML +Slideshow... + + +File menu option to Create HTML +Slideshow... + + + + +File menu option to Create HTML +Slideshow... + + + + + +A dialog box asks if you want to use a previously saved +configuration: + + +Previous configuration dialog + + + + +Previous configuration dialog + + + +Click No if this is the first time that you have +used this feature, or if you want to alter specific options. The +Yes option allows you to use details that you have +previously entered for your HTML slideshow, so that you can +quickly create the slideshow without needing to adjust the options. + + + +You will then get a dialog box asking for a few details: + + +Fill in the details for your HTML +slideshow + + + + +Fill in the details for your HTML +slideshow + + + +Fill in each field (the dialog takes the informations from &kcontrol; if they exist) and ensure that the path details are correct, as this +is where &kpresenter; will save your new HTML files +and pictures. Click on the Next when you are +done. + +If the path you select at this stage does not exist, &kpresenter; will +ask if you would like to create it. + + +Now you can configure the specific HTML options: + + +Fill in additional details for your HTML +slideshow + + + + +Fill in additional details for your HTML +slideshow + + + +Here, the encoding and format details can be changed, along with +the zoom level of the slides. For example, if you originally designed your +slides to display full screen on a 1280 x 1024 resolution screen, you could +scale the slides to 50% to enable them to be easily viewed in a much smaller web +browser window. + +In most cases, the defaults will be fine, and you can safely press the +Next to continue to the next page. + + + +Now you can customize the colors of the web pages: + + +Setting up the display style for your HTML +slideshow + + + + +Setting up the display style for your +HTML +slideshow + + + +When &kpresenter; creates the web pages for you, the text colors +for the navigation aids will follow whatever you set here. To change any of +these colors, click the colored bar next to the corresponding text label. The +colors used in your actual slides will be unchanged. + +Choose colors that are complementary to the contents of your +presentation. + + +The Next button presents a dialog box +that allows you to change the name used on the HTML page for +each slide: + + +Setting the slide names + + + + +Setting the slide names + + + + + + +If your presentation was intended to be displayed in an unattended manner +(&ie; automatic advance to next slide, &etc;), you can also make your +HTML +presentation counterpart exhibit the same behavior: + + +Unattended presentations + + + + + +Unattended presentations + + + +Here, you can force the slide to advance to the next after a specified +amount of time, and also make the presentation return to the start once it +reaches the end. + + + +Now it is time to actually produce your HTML +presentation, the progress of +which is shown in this dialog box: + + +Saving your configuration + + + + + +Saving your configuration + + + +Finally, you can save the configuration you have just used before you +close the dialog box by pressing the Save +Configuration... button. + + + +What we now have are the newly-produced html/ +and pics/ folders, +created where we earlier set the path: + + +The newly created HTML slideshow +folders + + + + +The newly created HTML slideshow +folders + + + + + +There is also an index.html file to launch +your web slideshow. + +You can see how it works by using your file manager or web +browser to open the index.html file. Click where prompted, +and the first slide of your presentation is displayed. It will now behave as a +&kpresenter; slideshow. + +Each click on the arrow icons take you to the next or previous slide. +To get back to the start of the slideshow click on the slide icon. + +To share your presentation with the world, transfer the +newly-produced files to a network-accessible location (&ie; webspace), +remembering to keep the directory structure intact. + + + +Exporting &kpresenter; presentations to a <trademark>Memory +Stick</trademark> + +Some Sony projectors have the ability to run a presentation directly +from a Memory Stick, without needing to connect a +computer up to the projector. &kpresenter; can export presentations to the +format required by these projectors, and this tutorial will show you how to +export your presentation. + + + +Each exported slideshow consists of a series of image files (one for +each slide in the original presentation, plus two title slides) and an +index file. They are created in a fairly complex directory structure +that allows more than one presentation to be stored on a single memory +stick. A simple example is shown below, consisting of two +presentations. + + + + + + +Memory Stick directory +structure + + + + + + + +If the presentation that you want to export is not already open, go to +FileOpen... and select the +presentation that you want to export. + + + + + +Now, select the File menu and choose Create +Memory Stick Slideshow.... + + + +The &kpresenter; Create Memory Stick +Slideshow... menu selection. + + + + +The &kpresenter; Create Memory Stick +Slideshow... menu selection. + + + + + + +This will bring up the Create Memory Stick +Slideshow dialog. + + +The &kpresenter; Create Memory Stick +Slideshow dialog. + + + + +The &kpresenter; Create Memory Stick +Slideshow dialog. + + + + +The Path is the directory in which your presentation will +be exported to as directories (DCIM and +MSSONY, see the directory structure +diagram above) will be created. If you are able to, you may wish to export +directly +to the Memory Stick, in which case you would enter the +location of the medium here. + + + +The Title is used for both the name of the index +file, and as a text label on the title slide. Note that this title +does not affect the titles on any of the normal presentation slides - +the title slide is visible using the Sony projector setup prior to +starting the actual presentation display. + + +Select the Set Colors option to expand the +dialog: + + +The &kpresenter; Create Memory Stick +Slideshow dialog (extended). + + + + +The &kpresenter; Create Memory Stick +Slideshow dialog (extended). + + + + +These two color selectors are only used for the title slide. It +can be useful to change the title slides to make the presentations +easier to identify when working on the projector, though it is perfectly safe to +leave them as default. + + + +You can then press the OK button to proceed with the +actual export process. + + + + + + +Your presentation will now be exported into the correct format, with the +following dialog informing you of the progress of this process: + + + +The &kpresenter; Create Memory Stick +Slideshow progress dialog. + + + + +The &kpresenter; Create Memory Stick +Slideshow progress dialog. + + + + +When the export is complete, you can select the +Done button, and the dialog will close. + + + + + +If you did not export the slideshow directly onto a Memory +Stick, you will need to copy the correct files onto the +Memory +Stick before you can utilise the projector. As noted above, +you need to copy over the correct directories and files starting at +DCIM and MSSONY into the +"root", or / of the Memory Stick. It +is +critical that the directory structure is maintained, and you may +find it easier to copy the whole of DCIM and +MSSONY directories. + + + +If necessary, you can safely rename the index file (which is +Slideshow.SPP by default), however you cannot +rename the slide images, nor can you change the name of these directories, +as these are encoded into the index file. + + + + + + + + +Creating &kpresenter; Templates + +It is very easy to add new templates to &kpresenter;'s library. + +If you have made a presentation in a style that you would like to use +again, you can save it as a template. + +This tutorial will show how we can make a new template and save +it. + + + +Open &kpresenter; and create a new document. + + + +To add a little sparkle to the blank slide, we can change the slide +background - do this by either going to Format > +Slide Background..., or by selecting the same item +from the &RMB; menu: + + +The &kpresenter; Slide Background +dialog. + + + + +The &kpresenter; Slide Background +dialog. + + + +We want the background to look attractive, so let's add a background +gradient by using the drop-down menu, and then selecting the gradient colors by +clicking the colored boxes. Of course, you may choose to use an image as a +background by clicking the Picture tab: feel free to +experiment, but keep it beautiful! + + +Choosing a slide background + + + + +Choosing a slide background + + + + + +The page should now have the background you desire. Create a text box, and +type a heading for your slide: + + +Adding a Heading to the new template + + + + +Adding a Heading to the new template + + + +When you are happy with your template, go to File +Template Manager: + + +FileTemplate +Manager + + + + +FileTemplate +Manager + + + +This dialog box allows you to select where you would like your template to +be saved: + + +Saving the new template + + + + +Saving the new template + + + +I highly recommend that you save the template in the Screen +Presentations group. You may call it whatever you wish, in this case, +my template is named Tutorial_Template. Once you are +happy with the settings, press OK to add your custom +template to the template collection. + + + +You can now close the document you have been working on (there is no need +to save it). The next time you are presented with the startup +dialog, your very own template will be available to select! + + +Your new template in the &kpresenter; startup +dialog. + + + + +Your new template in the &kpresenter; +startup dialog. + + + + + + + +     diff --git a/doc/kpresenter/htmlshow1.png b/doc/kpresenter/htmlshow1.png new file mode 100644 index 00000000..a9f8a4e8 Binary files /dev/null and b/doc/kpresenter/htmlshow1.png differ diff --git a/doc/kpresenter/htmlshow2.png b/doc/kpresenter/htmlshow2.png new file mode 100644 index 00000000..ba52b6ad Binary files /dev/null and b/doc/kpresenter/htmlshow2.png differ diff --git a/doc/kpresenter/htmlshow3.png b/doc/kpresenter/htmlshow3.png new file mode 100644 index 00000000..c4876d15 Binary files /dev/null and b/doc/kpresenter/htmlshow3.png differ diff --git a/doc/kpresenter/htmlshow4.png b/doc/kpresenter/htmlshow4.png new file mode 100644 index 00000000..49da99b6 Binary files /dev/null and b/doc/kpresenter/htmlshow4.png differ diff --git a/doc/kpresenter/htmlshow5.png b/doc/kpresenter/htmlshow5.png new file mode 100644 index 00000000..c69ec431 Binary files /dev/null and b/doc/kpresenter/htmlshow5.png differ diff --git a/doc/kpresenter/htmlshow6.png b/doc/kpresenter/htmlshow6.png new file mode 100644 index 00000000..9db24bc7 Binary files /dev/null and b/doc/kpresenter/htmlshow6.png differ diff --git a/doc/kpresenter/htmlshow7.png b/doc/kpresenter/htmlshow7.png new file mode 100644 index 00000000..d7011cfe Binary files /dev/null and b/doc/kpresenter/htmlshow7.png differ diff --git a/doc/kpresenter/htmlshow8.png b/doc/kpresenter/htmlshow8.png new file mode 100644 index 00000000..6fb56df5 Binary files /dev/null and b/doc/kpresenter/htmlshow8.png differ diff --git a/doc/kpresenter/htmlshow9.png b/doc/kpresenter/htmlshow9.png new file mode 100644 index 00000000..39e9270c Binary files /dev/null and b/doc/kpresenter/htmlshow9.png differ diff --git a/doc/kpresenter/index.docbook b/doc/kpresenter/index.docbook new file mode 100644 index 00000000..79ac6913 --- /dev/null +++ b/doc/kpresenter/index.docbook @@ -0,0 +1,267 @@ + + + + + + + + + + + + + +]> + + + +The &kpresenter; Handbook + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + + +Gary +Cramblitt + +
    garycramblitt@comcast.net
    +     +     + + +     + +2006-11-22 +1.6 + + +19992000 +Krishna Tateneni + + + +20012002 +Neil Lucock + + + +2005 +Anne-Marie Mahfouf + + + +2006 +Gary Cramblitt + + +&FDLNotice; + + + +&kpresenter; is the presentations program in the &koffice; suite of +productivity applications. + + + + +KDE +KPresenter +KOffice +Graphics +Presentations + + +     + + +Introduction + + Please check http://docs.kde.org +for updated versions of this document. + + +&kpresenter; is the presentations program in the &koffice; productivity +suite. Using &kpresenter;, you can prepare a set of slides for use in an +on-screen slideshow or for printing. Your slides can include text and +graphics in a variety of formats, and of course, you can embed all sorts +of objects using KParts. + + + +The &koffice; productivity suite consists of a number of applications +which are designed to work together. Overview documentation for +&koffice; is available, as well as manuals for each component of the +suite. The components of &koffice; are: + + + + + +&kword; - a frames based wordprocessor. + + + + +&kspread; - a spreadsheet application. + + + + + +&kpresenter; - a presentations application. + + + + + + +&kformula; - an editor for mathematical formulae. + + + + + +&kchart; - an application to draw charts and diagrams. + + + + + + + +&koffice; is a free (or open-source) software project which is +released under the terms of the &GNU; General Public +License. + + + + +&tutorial; + +&screen; + +&guides; + +&great; + +&menus; + +&options; + +&a11y; + +&faq; + + +Credits and License + + +&kpresenter; + + + +Program copyright 1998-2000 by Reginald Stadlbauer +reggie@kde.org + + + +Current maintainer is Laurent Montel montel@kde.org. + + + + +Contributors + + + +Werner Trobin trobin@kde.org. + + + + + +David Faure dfaure@kde.org + + + + + +Toshitaka Fujioka fujioka@kde.org + + + + + +Lukáš Tinkl lukas@kde.org + + + + + +Thorsten Zachmann t.zachmann@zagge.de + + + + + +Ariya Hidayat ariya@kde.org + + + + + +Percy Leonhardt percy@eris23.de + + + + + +Documentation based on the work copyright 1999-2000 by Krishna +Tateneni. Portions are copyright 2000-2002 Neil Lucock +neil@nlucock.freeserve.co.uk +and 2005 Anne-Marie Mahfouf annemarie.mahfouf@free.fr + + + +&underFDL; +&underGPL; + + + + +Installation + +&install.intro.documentation; + +&install.compile.documentation; + + + +&documentation.index; + +     + diff --git a/doc/kpresenter/kbd-focus-ext.png b/doc/kpresenter/kbd-focus-ext.png new file mode 100644 index 00000000..1135bb70 Binary files /dev/null and b/doc/kpresenter/kbd-focus-ext.png differ diff --git a/doc/kpresenter/link.png b/doc/kpresenter/link.png new file mode 100644 index 00000000..9c12b06e Binary files /dev/null and b/doc/kpresenter/link.png differ diff --git a/doc/kpresenter/menus.docbook b/doc/kpresenter/menus.docbook new file mode 100644 index 00000000..52d29d6e --- /dev/null +++ b/doc/kpresenter/menus.docbook @@ -0,0 +1,2066 @@ + + + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + +     +     +The Menu and Toolbar Items + +&kpresenter; presents different types of interfaces for you to interact +with the program. Perhaps the most familiar type of interface is the +menu which appears on the top of the &kpresenter; window. + +Clicking on the menu items gives you a list of commands from which you +can choose the one you want. Many of the commands can also be accessed +directly by holding down &Ctrl; or &Alt; and pressing another key on +your keyboard. In the next section, each of the menu commands is +described in brief. + + +The Toolbars + + +Manipulating the Toolbars + +In addition to the menus, &kpresenter; also has a set of toolbars. Each +toolbar consists of a collection of icons. A toolbar icon often presents +a convenient shortcut to a command that is found in one of the menus. + + +The toolbars + + + + + +The toolbars + + + + +You can move the toolbar around by dragging the handle, shown here in red. Toolbars can +be docked or attached to any side of the &kpresenter; +window. If you like, you can also have the toolbar float in +its own window, separated from the main &kpresenter; window as shown in the +screenshot below: + + +Floating toolbar + + + + + +Floating toolbar + + + + + If you don't like dragging toolbars around, +right click on the handle and a menu pops up as shown +in the screenshot below: + + +Toolbar context menu + + + + + +Toolbar context menu + + + + + +The first few items in the popup menu have to do with the placement of +the toolbar. You can choose any of the four sides of the &kpresenter; +window, or have the toolbar float in a separate +window. Choosing Flat hides the toolbar. +To unflat a hidden toolbar, &LMB; click on its handle. + + + + + +Choosing the next item in the menu, Text Position, leads +to an additional menu which lets you control the appearance of the items +in toolbar. This additional cascading menu is shown in the screenshot +below: + + + +The toolbar modes menu + + + + + +The toolbar modes menu + + + + + +The default view of the toolbar is icons only. In this view, if you +don't know what a particular icon means, you can hold the mouse over the +icon, and after a second or so, a little hint pops up in a highlighted +text box as shown in the screenshot below: + + + +Tooltips + + + + + +Tooltips + + + + + +You can choose to display the toolbar items as text instead of icons, or +even to combine both icons and text. If you want both text and icons, +the cascading menu allows you to select whether the text appears beside +the icons or below them. All four styles of displaying toolbar items are +shown in the screenshot below: + + + +The toolbar styles + + + + + +The toolbar styles + + + + + +The &kpresenter; menus are discussed in the following sections. + + + + + + +<guimenu>File</guimenu> Menu + + + + + + +&Ctrl;N + +File +New + + + + +Begins a new presentation. The +startup dialog will open, allowing you to choose a +template for your presentation. + + + + + + + +&Ctrl;O + +File +Open... + + + +Opens an existing presentation. A standard &kde; file +open dialog will appear, allowing you to choose a file to open. + + + + + + + +File +Open Recent + + + + +Displays a list of recently opened files for you to choose +from. + + + + + + + + +&Ctrl;S + +File +Save + + + + +Saves the currently open presentation. If you have not +previously saved it, you will be asked to name the file. If you have +previously saved the presentation, it will be resaved with the same name. + + + + + + + +File +Save As... + + + + +Saves the currently open presentation with a new name. + + + + + + + +File +Reload + + + +Reload the currently active file. + + + + + + + +File +Import... + + + +Import a presentation that was previously created in +one of several common formats. + + + + + + +File +Export... + + + +Export the currently open presentation to one of several common +formats for use in another application, or for exchange with someone +who does not have access to &kpresenter;. + + + + + + +File +Mail... + + + +Open a new email message in your selected email client with the current &kpresenter; document attached. + + + + + + + +File +Create HTML Slideshow... + + + + +Starts the HTML wizard, which is described in the +section . + + + + + + + +File +Create Memory Stick Slideshow... + + + + +Starts the Memory Stick dialog, which is described in the +section . + + + + + + + +Template Manager + + + +Allows you to save the current slide as a +template. In future the template will be available for you to +use to build slides with. Creating a template is further discussed in +section . + + + + + + +File +Use Current Slide as Default Template + + + +Sets the current slide as your default template. +Especially useful if you have created a template of your own to fit into +corporate style guidelines, or if you just use a particular layout very +often. + + + + + + +&Ctrl;P +File +Print... + + +Prints the presentation. More precisely, it opens the +print settings dialog, where you can adjust the settings before printing +your presentation. + + + + + + +File +Print Preview... + + + +Displays the presentation with a &PostScript; viewer, +exactly as it would look if printed. + + + + + + +File +Document Information + + + +Allows you to enter information about the document. +This includes information about the author, and an abstract on the +documents contents. + + + + + + + +&Ctrl;W +File +Close + + + +Close the current presentation. You will be given an +opportunity to save any changes first. + + + + + + + +&Ctrl;Q +File +Quit + + + +Close &kpresenter;. You will be given an opportunity +to save all changes in all open presentations first. + + + + + + + +<guimenu>Edit</guimenu> Menu + + + + + + + +&Ctrl;Z +Edit +Undo: Last task + + + +Undo the last action you performed. + + + + + + + +&Ctrl;&Shift;Z + +Edit +Redo: Last undone +task + + +Redo the last action you undid. If you have not undone +any actions, or the last undo action is not reversible, this menu item +is disabled. + + + + + + +&Ctrl;X +Edit +Cut + + + +Copy the selected item to the clipboard, and remove it from the +document. + + + + + + + +&Ctrl;C +Edit +Copy + + + +Copy the selected item to the clipboard, while leaving it intact +in your presentation. + + + + + + + +&Ctrl;V +Edit +Paste + + + +Insert the contents of the clipboard into your +presentation. + + + + + + + +&Ctrl;Delete +Edit +Delete + + + +Remove the currently selected item from your +presentation. + + + + + + + +&Ctrl;A +Edit +Select All + + + +Select all the objects and text on the current slide. + + + + + + + + +&Ctrl;&Shift;A + +Edit +Deselect + + + +Deselect any currently selected objects. + + + + + + + +&Ctrl;F +Edit +Find... + + + + +Search for text within the presentation. + + + + + + + + +F3 + +EditFind Next + + + +Find the next occurrence of a piece of text within a presentation. + + + + + + + +&Shift;F3 + +EditFind Previous + + + +Find the previous occurrence of a piece of text within a +presentation. + + + + + + + +&Ctrl;R + +EditReplace... + + + +Replace one or more occurrences of a piece of text in +your presentation with a different piece of text. + + + + + + +Edit +Copy Slide + + + +Copy the current slide to the clipboard. + + + + + + +Edit +Duplicate Slide + + + +Insert an exact copy of the current slide. + + + + + + +Edit +Delete Slide + + +Delete the current page from the presentation. You +will be asked to confirm this action. + + + + + + +Edit +Duplicate Object... + + + +Create a duplicate of the currently selected object. A dialog will +display allowing you to set some options for the duplicate, ⪚ if it +should be rotated, or scaled, or offset to a new position on the +slide. + + + + + + + + +<guimenu>View</guimenu> Menu + + + + + + +View +New View + + +Opens another window with the same presentation loaded +so you can work on more than one slide at a time. + + + + + + + +&Ctrl;&Shift;W +View +Close All Views + + + +Close all views on the presentation. You will be given +a chance to save any changes, or to cancel closing. + + + + + + +View +Split View + + + +Splits the window into two (or more) views on the same +presentation. The default split is horizontal. + + + + + + +View +Remove View + + + +Close only the currently active view. The +presentation, and any other views you have open, remain open, and any +changes you have made remain unsaved. + + + + + + +View +Splitter Orientation + + + +Toggle the split view between +Horizontal (the default) and +Vertical. + + + + + + +View +Show Sidebar + + + +Toggle the display of the sidebar where you can +see an overview of all the slides in your presentation. + + + + + + +View +Show Notebar + + + +Toggle the display of the notebar where you can +see an overview of all the notes in your presentation. + + + + + + +View +Slide Master + + + +Toggle the display of the slide master where you can put objects that you want to appear on each slide in your presentation. + + + + + + +View +Formatting Characters + + + +Show a visual representation of non-printing +characters, such as tabs and paragraph markers. This can be +a useful aid to precisely positioning text. + +This item can be toggled. If enabled, formatting characters are +visible; if disabled, they are not. + + + + + + +View +Guide Lines + + + +When working in &kpresenter; you can drag a guide +line from either the horizontal or vertical ruler onto your +document. This guide-line will not print or display in the finished +presentation, it is simply to help you align objects on screen. If +this item is enabled, these guide lines will be visible. If this is +disabled, they will not be visible. + +Guide lines work across slides, allowing you to align objects the +same way across multiple slides. + +Disabling (hiding) guide lines does not delete them. If you have +created guide lines, and then disabled this item, enabling it again +will retain the guide lines you created. + + + + + + +View +Add Guide Line... + + + + +Opens a dialog to select the Orientation +(Horizontal or Vertical) +and choose a Position: + + + + + + + +View +Show/Hide Grid + + + +If enabled, &kpresenter; will display a grid of dots +representing the intersections of imaginary horizontal and vertical +lines. You can use these dots to precisely position objects on the +slide. + + + + +View +Snap to Grid + +If this is enabled, when dropping or moving objects on the +slide the top left corner of the object will snap or +move, to the nearest grid point. +This does reduce your freedom to freely position objects on the +slide, however it also helps to line up objects precisely. It is +easily disabled or enabled with this menu entry, allowing you the best +of both worlds. + + + + + + +View +Zoom + + + +This submenu allows you to zoom in or out of the +slide. Several predefined zoom levels are available, including +Whole Slide to scale the entire slide so as +to be visible in the size window you have open, and +Width to scale the slide so it fills the +entire width of the window, although you may now have to scroll +vertically. There are also several other scaling choices, from +33% up to +500%. + + + + + + + + +<guimenu>Insert</guimenu> Menu + + + + + + + +&Alt;&Shift;C + +Insert +Special Character... + + + +Insert a special character. This might be a character +you don't have a key for on your keyboard layout, for instance ü +on a US Keyboard. + + + + + + +Insert +Variable + + + +Here you can insert a variable that is filled in with a +value that may be updated as you update the document. + + + + + + +Insert +Link... + + + +Insert a hyperlink to a file, a website, or an email +address. This enables these locations to be linked to directly from within active presentations, with resources being handled as appropriately by other applications installed on your system. + + + + + + +Insert +Comment... + + + +Enter a small note that does not display during the +real presentation. You might use this to comment on a colleague's +text, or to leave a note for yourself about something to do +later. + + + + + + + +F2 +Insert +Slide... + + + + +Add a new page to your presentation. A dialog will open +allowing you to choose a template, and whether to insert the new page +before or after the currently selected page. + + + + + + + +InsertFile... + + + +Insert an already existing presentation. A standard &kde; file +open dialog will appear, allowing you to choose a &kpresenter; Document (.kpr) or a +OASIS OpenDocument Presentation (.odp), which will be inserted after the last slide in your current presentation. + + + + + + +F10 +InsertText + + + +Add a new text object. Click and drag to create a frame where +you wish the text to appear. + + + + + + +Insert +Chart + + + +Insert a chart. Click and drag to define the size of the +chart. Some default data will be displayed. Double click to edit the +data and choose the type of chart to display, using the embedded +&kchart; editor. + + + + + + + + +F5 +InsertTable + + + +Insert a table. Click and drag to define the size of +the table. + +A &kspread; open dialog will display. You may import a +spreadsheet that you have saved in one of many formats, including +plain text files. You may also choose to create a new and empty +table. + +Double clicking on the table will allow you to edit the +contents. + + + + + + +Insert +Object + + + + + +An object is an embeddable file, in one of many formats. + +A common use of this action is to insert scaleable clipart in +vector format. + + + + + + + +&Shift;F5 + +Insert +Picture... + + + +Insert a raster image. These are not as easily +scaleable as vector images or clipart. &kpresenter; +currently understands many formats, including .tiff, .jpg, .png and many more. + + + + + + +Insert +Line + + + +You can insert several types of lines. Line drawing is described +further in the drawing tools section. + + + + + + +Insert +Shape + + + +You can insert several prepared shapes, in vector format. These are +editable just like lines you have drawn yourself. Using the drawing +tools is described in detail in the drawing tools +section. + + + + + + +Insert +Scan Image... + + + +Scan an image with a scanner. This requires you have a +scanner installed. It opens the Acquire Image dialog to allow the use of the scanner. + + + + + + + +<guimenu>Format</guimenu> Menu + + + + + + +Format +Select + + + +If you have been using a tool such as the line drawing tool which does +not allow you to select other objects, you can use this menu item to +return to the normal selection cursor. + + + + + + +Format +Rotate + + + +Changes the cursor to a double headed curved arrow. Click with the &LMB; onto an object +and keep the button pressed.Drag with the cursor to rotate the object on the slide around its center. When you are +happy with the position of the object, release the mousebutton to stop +rotating. + +If you change your mind and wish to cancel the rotation, use +EditUndo + to later undo it. + + + + + + +Format +Zoom + + + +Allow you to zoom in or out in the current slide. You can see the zoom factor in the Edit toolbar, in the zoom indicator. + +The zoom factor indicator + + + + + +The zoom factor indicator + + + +Left clicking on the slide will Zoom In. Right clicking on the current slide will present you a menu to allow you to Zoom In, to Zoom Out, to Zoom Entire Slide, to Zoom Slide Width or Zoom Slide Height, to Zoom Selected Objects or Zoom All Objects which put back all objects in your view. + +This action has the same effect as ViewZoom + on another form. + + + + + + +Format +Properties + + + +Open the Properties dialog for the currently selected object on your slide. + +The Properties dialog + + + + + +The Propertiesdialog + + + +The Properties dialog for an object allows you to manipulate it in a +very detailed manner. You can change several properties for the selected object, like the text color if the object is text or the depth if the object is a picture. + + + + + + +Format +Arrange Objects + + + +This is where you can manipulate the stacking order of +objects on the slide. + +An object that is on top will cover, either partially or fully +depending on its size, all other objects beneath it. Meanwhile an +object on the bottom of the stack may not be visible at all, as it is +covered up by other objects. An object in the middle may be partially +covered by other objects, while partially covering yet more objects +itself. + +You can send the selected object down or up a layer, or directly +to the top or bottom of the stack. + + + + + + + +Format +Align Objects + + + + +In the submenu you can quickly align all the currently +selected objects with a side of the slide, or center them either +vertically or horizontally. + + + + + + + + +&Ctrl;G + +Format +Group Objects + + + +If you are drawing, you might want to make something out of +several objects. Arrange the individual parts where you +want them, select one, then hold down the &Ctrl; key +as you click in the others you want to group together. Click +Group Objects and from then on they act as +if they are just one thing. It glues things together. + + + + + + + + +&Ctrl;&Shift;G + +Format +Ungroup Objects + + + +If you decide that you want to alter an object that is made out +of several pieces, you can unglue it with this tool. Click somewhere +away from the object to deselect it, then click to select one of its +parts. + + + + + + +Format +Shadow Objects... + + + +This puts a colored copy of either text or a drawn object behind +it. You can make nice dropped shadows for logos with +this tool. To enable this item, ensure that you have object(s) +selected (you will see the six small black boxes around the +outline.) You choose the color, select which way the shadow is going to +fall and select a distance. For text it looks nice if you set the +distance to two or three. Click Apply +to see the result of your settings for all selected objects on the slide +without leaving the dialog. + + + + + + +Format +Page Layout... + + +Allows you to set the page details. You can specify the margins, +the orientation, either portrait (higher than wide) or Landscape +(wider than high) formats. There are many templates, such as screen, +A4, US legal. + + + + + + +Format +Enable/Disable Document Header + + + +Toggle the display of the header field on the current slide. Header content can only be added in the master slide but you can choose to display the header only on some slides with this action. + + + + + + +Format +Enable/Disable Document Footer + + + +Toggle the display of the footer field on the current slide. Footer content can only be added in the master slide but you can choose to display the footer only on some slides with this action. + + + + + + +Format +Slide Background... + + + + +Allows you to alter the background to your presentation +slides. Your options are Color/Gradient, (which lets you +set either a plain color or one of many gradients) +or Picture, which gives a dialog box to find the picture +you want. Set the View mode: for this picture +to Scaled, Centered, +or Tiled. + + If you want a plain color, click in the box to select +it. Gradients only work when you have chosen two colors. The picture +option allows you to center the picture, zoom it to cover the entire +slide (if it is smaller than the screen, this is very useful) or tile +it. This is used when you want a small pattern to repeat across the +page. It's probably best used with patterns rather than pictures of +logos. + +You can get rid of a picture by selecting another one or +choosing a color/gradient. + + + + + + + + + +<guimenu>Text</guimenu> Menu + +This menu modifies selected text and provides a few tools familiar from +word processing applications for your convienience for when you are making +presentations with large amounts +of text in them. The Text menu will only effect selected or +highlighted text. + + + + + +Text +Default Format + + + +Restores selected text to the system default font size, style and +formatting. + + + + + + +Text +Font... + + + + +The Select Font dialog contains options for selected +segments of text: + + +The Select Font dialog + + + + + +The Select Font dialog + + + + +With this dialog, you can change the font, style and size of +selected text. The preview box at the bottom +allows you to approximate changes before you make them. + + + + + + + + + +&Ctrl;&Alt;P + + +Text +Paragraph... + + + + +The Paragraph Settings dialog contains settings for +larger blocks of text, such as paragraphs. Using this dialog, you can set +indenting, line spacing, bullet/numbered list and border settings. + + + + + + + +Text +Color... + + + + +Use the Select Color dialog to have precise control +over the color of selected text: + + +The Select Color dialog + + + + + +The Select Color dialog + + + + +Using the color spectrum box on the left, +colors can be precisely defined for use in your document. The +color tone can then be adjusted using the scale to the +right of the spectrum box. The input boxes below the +color spectrum allow color values to be entered, so that exact +colors can be specified. + + +Use the color picker to select colors from elsewhere in your document +(⪚ images). + + + + + + + + + +&Ctrl;&Alt;S + +Text +Style Manager + + + +The Style Manager allows you to create an entire set of +attributes that will be applied to selected text all at once. See Working With Styles + + + + + + +Text +Import Styles... + + + +Here you can import styles that you have defined in another &kpresenter; +document. + + + + + + +Text +Style + + + +Using this submenu, you can apply a style that you have previously defined +to the currently selected text. + + + + + + +Text +Create Style From Selection + + + +Copy the properties of the currently selected text and +save them as a style that you may apply to other text. + + + + + + +Text +Align + + + +Align has a submenu with several options: +Align Left (&Alt;L), +Align Center (&Alt;C), +Align Right (&Alt;R), and +Align Block (&Alt;J) +which is also commonly known as Justify. + +Text is by default left-aligned. + + + + + + + +Text +Type + + + +Using this submenu, you can format the currently selected text as a list, +either of the numbered or bulleted type. If you choose numbered, you can then +select a numbering style, and likewise if you choose bulleted, you can +choose the style of bullets to use. + +To change a list back to plain text, select +None as the style. + + + + + + + +&Ctrl;+ + +Text +Increase Depth + + + + + + +&Ctrl;- + +Text +Decrease Depth + + + +Increase Depth and Decrease +Depth move paragraphs in a list either to the right +(Increase Depth) or back to the left +(Decrease Depth). + + + + + + + +Text +Extend Contents to Object Height + + + +Text +Extend Object to Fit Contents + + + +Extend Contents to Object Height and +Extend Object to Fit Contents help to +resize text within the text box or make the text box fit the text you have typed +or pasted into it. + + + + + + +Text +Insert Slide Number + + + +Insert a dynamically-updated slide number. This page number will +automatically update when slides are added or removed from your presentation to +reflect the correct slide value. + + + + + + +Text +Change Case... + + + +Presents a dialog that provides a variety of different case/capitalization +options for the currently selected text. + +You may choose between several styles of capitalization, +including all lower or uppercase, book style capitalization where each +word except conjunctions has an initial capital letter, and sentence +style capitalization where the first word in a sentence is capitalized. You can +also toggle the case, so that uppercase becomes lowercase, and vice +versa. + + + + + + +Text +Spellcheck + + + +Use this submenu to utilize the spellcheck options. If you enable +Autospellcheck, &kpresenter; will automatically check +text that you enter for spelling errors. + +If you prefer to check spelling explicitly, rather than automatically, you +can also force a Spelling... check here. + + + + + + +Text +Autocorrection + + + +Use this submenu to utilize autocorrection options. If you +Enable Autocorrection, common spelling errors will be +corrected as you type. For example, if you entered Teh, +it would be autocorrected to The. + +If the autocorrection feature is not active, you can also +Apply Autocorrection check here. + + + + + + + + +<guimenu>Slide Show</guimenu> Menu + + + + + + +Slide Show +Configure Slide Show... + + + + +You can set up the properties for the entire slide show here, +including whether to show the duration on screen, which of the slides +in a presentation to include, and several other global settings. + + + + + + + + +Slide Show +Edit Object Effect... + + + +Choose what effect you want to apply for the highlighted object. This is where +you can set the order of appearance, how the object will appear, if you want a sound while the object appears and if you want some disappearance effects too. + + + + + + +Slide Show +Edit Slide Transition... + + + +Apply transition effects to the currently open slide. This is where +you can choose how the transition from one slide to the next +will be handled. + +The transition effects you select here are applied on the +transition from this slide +to the next. + + + + + + + +F12 +Slide Show +Start + + + +Begin the slideshow from the current slide. + + + + + + +Slide Show +Start From First Slide + + + +Begin the slideshow from the first slide. + + + + + + +Slide Show +Custom Slide Show... + + + +Opens a dialog to Add..., Modify..., +Remove and Copy slides and +Test the slide show in full screen mode. + + + + + + +Home +Slide Show +Go to Start + + + +Go directly to the first slide in the slide show. + + + + + + +PageUp +Slide Show +Previous Slide + + + +Go back to the previous slide in the slide show. + + + + + + +PageDown +Slide Show +Next Slide + + + +Go to the next slide in the slide show. + + + + + + +End +Slide Show +Go to End + + + +Go immediately to the final slide in the slide show. + + + + + + + + +<guimenu>Settings</guimenu> Menu + +The Settings menu allows you to customize +&kpresenter;. + + + + + + +Settings +Toolbars + + + +The items in this submenu can be toggled, that is, you can both enable and +disable the display of specific toolbars here. + + + + + + +Settings +Configure Autocorrection... + + + +Autocorrection is &kpresenter;'s ability to correct +common typing errors or expand abbreviations independently of the spell +checking function. There are several common typing errors entered for +you by default such as replacing teh with +the and you can add as many more as you +like. + +The ability to expand abbreviations can save you a lot of typing +time, if you often repeat text whether in the same presentation or in +multiple presentations. + +For instance, if you work for Company with a really really +long name Inc. then you might define an autocorrection entry so +that whenever you type myJob or some other piece +of unique text, it will be replaced with Company with a really +really long name Inc.. + +Autocorrection can be applied automatically as you type, or only +on demand when you choose it from the Text +menu. + +Please see the Configure Autocorrection section for a complete explanation. + + + + + + +Settings +Configure Completion... + + + +Autocompletion allows you to type the first few letters of a commonly used word (often technical or job specific), and tells &kpresenter; to finish typing the word for you. + +Please see the Configure Completion section for a complete explanation. + + + + + + + +Settings +Configure Shortcuts... + + + + +Configure Shortcuts allows you to +assign a keyboard shortcut to actions that &kpresenter; menus or icons +contain. + + +Customize Shortcuts + + + + + +Customizing the shortcuts + + + + +If you try to assign a shortcut that is already used, it will +give you a warning message. Highlight what you want to do (in the +picture, I have chosen to make a keyboard shortcut to About +KDE). + +Click the radio button to the Custom key setting and type the +key you want to use. I assigned Control key and +Y to bring up the About KDE dialog +box. + +The button shows what has been assigned. Click +OK to make the changes, click +Default to restore whatever was assigned as +default, click Cancel to do nothing and leave +the dialog. + + + + + + + +Settings +Configure Toolbars... + + + +Configure Toolbars allows you to add or delete icons on each of +the toolbars. + + +Configuring &kpresenter; toolbars + + + + + +Configuring &kpresenter; toolbars + + + + + + +At the top is a drop down box to enable you to choose which +toolbar you want to modify. In the picture the Format toolbar is +selected. If I want to add the Spelling icon to +that toolbar, I click the entry in the left window. The arrow pointing +right becomes available, if I click the arrow the Spelling +entry is added to the selected toolbar. The left arrow +is available when you click in the right side window. It allows you to +remove an icon from a toolbar. The up and down arrows become active +when an item on the wright side is selected. You can also move the highlight in +the right side window up and down with the keyboard arrow keys. By +clicking on the arrows with the mouse you can change the order of the entries +in the menu. + + + + + + + + +Settings +Configure &kpresenter;... + + + +See the configure &kpresenter; section for a complete explanation of all &kpresenter; settings. + + + + + + + +<guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + +     \ No newline at end of file diff --git a/doc/kpresenter/mousenav.png b/doc/kpresenter/mousenav.png new file mode 100644 index 00000000..462c6051 Binary files /dev/null and b/doc/kpresenter/mousenav.png differ diff --git a/doc/kpresenter/msexport1.png b/doc/kpresenter/msexport1.png new file mode 100644 index 00000000..fa3de1e4 Binary files /dev/null and b/doc/kpresenter/msexport1.png differ diff --git a/doc/kpresenter/msexport2.png b/doc/kpresenter/msexport2.png new file mode 100644 index 00000000..27bb44f2 Binary files /dev/null and b/doc/kpresenter/msexport2.png differ diff --git a/doc/kpresenter/msexport2b.png b/doc/kpresenter/msexport2b.png new file mode 100644 index 00000000..a141a903 Binary files /dev/null and b/doc/kpresenter/msexport2b.png differ diff --git a/doc/kpresenter/msexport3.png b/doc/kpresenter/msexport3.png new file mode 100644 index 00000000..55b03e60 Binary files /dev/null and b/doc/kpresenter/msexport3.png differ diff --git a/doc/kpresenter/msexport4.png b/doc/kpresenter/msexport4.png new file mode 100644 index 00000000..63424610 Binary files /dev/null and b/doc/kpresenter/msexport4.png differ diff --git a/doc/kpresenter/options.docbook b/doc/kpresenter/options.docbook new file mode 100644 index 00000000..39f13e13 --- /dev/null +++ b/doc/kpresenter/options.docbook @@ -0,0 +1,1032 @@ + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + +     +     +Configuring &kpresenter; + + +The <guilabel>Configure Autocorrection...</guilabel> Dialog +Auto correction is a system for correcting common typing errors, converting abbreviations to their full spelling and adjusting capitalization. As you could guess from its name, this all occurs automatically, while you are editing your document. + + +Enabling/Disabling Autocorrection + +To toggle autocorrection on, select TextAutocorrectionEnable Autocorrection from the menubar. When enabled, autocorrection makes changes to your document as you type. You can determine which changes to make by configuring autocorrection, as explained below. + + +To toggle autocorrection off, select TextAutocorrectionDisable Autocorrection from the menubar. When disabled, autocorrection changes are not made. You can, however, apply autocorrection manually, using the TextAutocorrectionApply Autocorrection menu. + + +To adjust the options for autocorrection, select Settings +Configure Autocorrection... from the menubar. + +A dialog window appears to help you set your options, with four tabs: Simple Autocorrection, Custom Quotes, Advanced Autocorrection and Exceptions. + + + +<guilabel>Simple Autocorrection</guilabel> + + +Simple Autocorrection + + + + +Simple Autocorrection + + + + + +Convert first letter of a sentence automatically to uppercase +When selected, &kpresenter; will automatically capitalize the first letter after a period. You can tell &kpresenter; when not to alter capitalization in certain instances (ie “Sr.” or “Jr.”). For more details, see the section entitled Autocorrection Exceptions. + + + +Convert two uppercase characters to one uppercase and one lowercase character +When selected, &kpresenter; will automatically convert a double capital letter (a common typographical error), into a single capital letter. You can tell &kpresenter; when not to alter capitalization in certain instances. For more details, see the section entitled Autocorrection Exceptions. + + + +Autoformat URLs +When selected, &kpresenter; will scan text for patterns which suggest a certain section of text is a URL and automatically creates a link. + + + +Suppress double spaces +When checked, &kpresenter; will ignore the second space typed. This prevents users from adding double spaces between words or sentences + + + +Remove spaces at the beginning and end of paragraphs +When selected, &kpresenter; will automatically remove spaces at the beginning and/or the end of a line of text. + + + +Automatically do bold and underline formatting +When selected, &kpresenter; will look for words surrounded by asterisks ( * ). It will remove the asterisks and change the font of all words in between the two asterisks to bold face. +&kpresenter; will also look for words surrounded by underscores ( _ ). It will remove the underscores and underline all words in between the two underscores. + + + +Replace 1/2... with ½... +When selected, &kpresenter; will automatically change 1/2, 1/3 and 3/4 to their single character equivalents. + + + +Use autonumbering for numbered paragraphs +If you start a paragraph with a number and a symbol ( 1) for example), &kpresenter; will automatically convert that paragraph to a numbered paragraph. All future paragraphs will be consecutively numbered. + + + +Replace 1st with 1^st... +When selected, &kpresenter; will automatically change 1st to 1st. + + + +Capitalize name of days +Automatically capitalize the days of the week (Sunday, Monday, Tuesday, etc...). + + + +Use list-formatting for bulleted paragraphs +When selected, &kpresenter; will look for lines that begin with - , and automatically convert the paragraph style to a bulleted list. The bullet is selected with the left button below this option. + + + + + + +<guilabel>Custom Quotes</guilabel> + +Select the tab labeled Custom Quotes + + +Custom Quotes + + + + +Custom Quotes + + + + + +Replace double quotes with typographical quotes + +When selected, this option will replace the standard keyboard double +quotes, with typographical quotation marks. If you want to change the +quotation character, click on one of the buttons. Clicking on +Default, restores the default paragraph marks. + + + + +Replace single quotes with typographical quotes + +When selected, this option will replace the standard keyboard single +quotes, with typographical quotation marks. If you want to change the +quotation character, click on one of the buttons. Clicking on +Default, restores the default paragraph marks. + + + + + + +<guilabel>Advanced Autocorrection</guilabel> + +To switch to the Advanced Autocorrection, click on the tab labeled +Advanced Autocorrection. + + +Advanced Autocorrection + + + + +Advanced Autocorrection + + + +This allows you to automatically have &kpresenter; replace one string +of text with another. This can be useful for special symbols, commonly +used abbreviations that you want spelled out, or common typing errors. + +&kpresenter; uses different autocorrection strings depending on the language. +Set the correct language using the combo box labeled +Replacement and exceptions for language:. + +The check box labeled Enable word replacement is used to +toggle on and off the autoreplacement features of &kpresenter;. If there is no mark in the check box, +then &kpresenter; will not perform any autoreplacements from the list in this dialog. + +If there is a mark in the check box labeled Replace text with format +&kpresenter; will not only change the text when it finds a match, but it will change the formatting of the new text. +If there is no mark in this check box, then +&kpresenter; uses the same formatting options for the replaced text as it found in the search text. For more information +on setting the format options for replacement text, see the section on +Changing the format of the autocorrection string. + + +Adding an autocorrection string + +To add an autocorrection string, simply type the text you want &kpresenter; to +check for in the text box labeled +Find:, then enter the text you want &kpresenter; +to substitute in the text box labeled Replace:. + + +If you want to insert symbols or special characters not available on your +keyboard, you can click the +buttons with three periods on them and select a special character from the table provided. + +When these are entered, click Add.... Your text +strings are now added to the table. + + + +Editing an autocorrection string +Changing the text you want to find. +&kpresenter; does not allow you to change the text to search for. +This is to prevent disastrous mistakes. +Instead, you must delete the current autocorrection rule and +add a new text string with the corrected text to find. + +Changing the text you want to replace. +Begin by clicking once on the string you want to edit. It will be +highlighted and the find and replace text will be listed in the text boxes +above. You can alter the replacement text. When you +are done, simply click on the Modify button. + + + + +Deleting an autocorrection string + +Simply click on the string you want to delete. Now click the +Remove button. The string is removed. + + +Be aware that &kpresenter; does not give you a chance to back out once +you have deleted a string. Be sure you have selected the correct string +before you click the Remove +button. + + + + +Changing the format of the autocorrection string +Currently, you must create the autocorrection string before you can format it. +Once the autocorrection string has been created, simply click on it once with the &LMB;. +Now click on the Change Format... button. A small dialog will appear: + + + + + + + +You can use this dialog to select the format of the replaced text. +The left column consists of 13 check boxes. If there is a mark in the check box, then &kpresenter; will change +any replaced text to match the property selected. +If no mark is in the check box, &kpresenter; does not consider that property when replacing text. + + + + +Family: + +Use this combo box to select the font family you want your replacement text to use. + + + + +Size: + +Use this spin box to set the font size you want &kpresenter; to use for your replaced text. + + + + +Color: and Background color: + +Clicking on either of these two buttons allows you to select the font color and/or background color respectively, +you want &kpresenter; to use. + + + + +Bold: and Italic: + +Use these Yes/No radio buttons to determine whether you want &kpresenter; +to change the fonts to boldface or italicized fonts. + + + + +Strikeout: + +You can select None, Single, Double +or Simple Bold to use for the replacement text. + + + + +Underline: + +You can select None, Single, Double, +Simple Bold or Wave to use for the replacement text. + + + + +Vertical alignment: + +You can select Normal, Superscript or +Subscript to determine what font alignment you want &kpresenter; to use. + + + +Shadow: and Word by word: + +Use these Yes/No radio buttons to determine whether you want &kpresenter; +to use shadow text and/or word by word underlining and strikethrough in the replacement text. + + + + +Capitalization: + +You can select Normal, Uppercase, Lowercase, or +Small Caps to determine what capitalization to use for the replacement text. + + + + +Language: + +You can select the language of the text you will use to replace the found text. + + + + +Once you have selected your options, click OK to accept your text options. +Click Cancel to ignore all changes. +Click Reset to restore the options dialog box to the initial values prior to making any changes. +Click Clear to remove all marks from the checked options. + + + + +<guilabel>Exceptions</guilabel> + +There are instances where &kpresenter; will make autocorrection changes +that are inappropriate. You can use the fourth tab of this dialog to define +exceptions to the rules previously discussed. +The dialog for exceptions is shown below: + + +Exceptions + + + + +Exceptions + + + +To prevent &kpresenter; from deciding an abbreviation or other text is +the end of a sentence, simply enter the text fragment in the text box below +Do not treat as the end of a sentence:. Then click +Add. +As an example: Adding Jr. to this dialog prevents +Robert Jones Jr. is a friend of the family. +from being changed to: +Robert Jones Jr. Is a friend of the family. +To remove an erroneous entry, simply click once on the wrong entry with the &LMB; +and click on the Remove button. +The second set of boxes performs a similar function to the first except text entered in these boxes will allow two capital letters in a word if it +is entered in this text box. +Simply enter the word in the text box below +Accept two uppercase letters in:. Then click +Add. +As an example: Adding CD to this dialog prevents +CD +from being changed to: +Cd +To remove an erroneous entry, simply click once on the wrong entry with the &LMB; +and click on the Remove button. + + + +Manually applying autocorrection + +If autocorrection is turned off in your document, you can manually enable autocorrection. +To manually apply autocorrection, first configure your options by using the +autocorrection dialogs. +Then select +TextAutocorrectionApply Autocorrection +from the menubar. +&kpresenter; will start at the beginning of the document and apply all selected autocorrection options to the entire document. +When &kpresenter; is finished, it will return you to your document for further editing. +For more information on enabling and disabling autocorrection, +see Enabling/Disabling Autocorrection. + + + + + +The <guilabel>Configure Completion</guilabel> Dialog + +Autocompletion allows you to type the first few letters of a commonly +used word (often technical or job specific), and tells &kpresenter; to +finish typing the word for you. This is often very useful when you have lengthy technical words. + + +Using autocompletion +Using autocompletion could not be easier. Simply type the first few +letters of the word you want &kpresenter; to finish, and press +&Ctrl;E. &kpresenter; will look +through the list of autocompletion words and if it finds a word which begins +with those letters, it will finish entering the remainder of the word. + +Adding words to autocompletion +&kpresenter; maintains a list of words for each user that will be used for autocompletion. +You can add words to this list one of two ways: + +&kpresenter; can automatically add new words to the completion list for later approval. +This is selected using the dialog. +Individual words can be added to the list by using +the dialog. + + + + + +Configuring autocomplete +To configure autocompletion, select +SettingsConfigure Completion... +from the menubar. This will bring up a dialog. + + +Completion Dialog + + + + +Completion Dialog + + + + + +Enable word completion +It is used to toggle autocompletion on and off. + + + +Add + +By clicking this button you can manually add +an individual word to the completion list. + + + + +Remove + +To remove words from the completion list, select the word with the &LMB; +from the list, then click this button. + + + + +Automatically add new words to suggestion list + +This option will add any word equal to or longer than +the Characters needed: to the list of proposed +autocompletion words. +The large listbox in the center of the dialog contains the current +proposed list of autocompletion words. +Not all words listed in the list box will be immediatly affected by +autocompletion when entered into this dialog. + + + + +Show words in tooltip + +If this option is enabled, a tool tip box will appear when you type the +beginning of a word that exists in the completion list. To complete the word, +press the key you set to accept suggestions in the Key to accept +suggestion: drop-down list. + + + + + +Characters needed: + +Use this spinbox/slider combination to prevent &kpresenter; +from automatically adding short words to the completion list. You can select +any value from 5-100 and the words will need to be at least the number of +characters set here to be added in the list. + + + + +Suggest words: + +This spinbox/slider combination can be adjusted to allow more or less +words into the autocompletion list. This option is most important when +Automatically add new words to suggestion list is enabled. +This option keeps the list from becoming too cumbersome. You can select any +value from 1 to 500. + + + + +Append space + +If checked, it adds a single space to the end of a word after +autocompletion, this means it is not necessary to add the space manually for the +next word. + + + + +Key to accept suggestion: + +Set the key you want to use when an autocompleted word is suggested to you +and you want to accept it. You can choose +Enter, Tab, Space, +End or Right. + + + + +Make Default + +A word is not part of autocompletion until the list is +saved to disk. At that moment, &kpresenter; +will use that saved list for all autocompletion, until the list is replaced with +another saved list. +Some of the words in the autocompletion list may not have been saved +yet.To save the current list to disk and have &kpresenter; begin +using this new list for autocompletion, click this button. + + + + +Click OK to save your options. Click +Cancel to abort all changes. Click +Reset to reset to the state after you clicked on the +Make Default button. + + + + + + +The <guilabel>Configure &kpresenter;</guilabel> Dialog + + +<guilabel>Interface</guilabel> + + +Configure Interface + + + + +Configure Interface + + + + + +Show rulers +This is checked by default and both a vertical and horizontal +ruler are shown on &kpresenter;slides. When unchecked, the rulers are not shown +anymore on any slide. + + + +Show status bar +Toggle the statusbar which is shown by default. + + + +Number of recent files: +Set the number of recent files which will be opened using the +FileOpen +Recent menu. Default is to remember 10 filenames. The +maximum you can set is 20 and the minimum is 1. + + + +Text indentation depth: +This setting is used in the Text menu by Increase Depth and Decrease Depth menu items to change the indentation depth. Default is 1 centimeter. + + + + + + +<guilabel>Color</guilabel> + + +Color + + + + +Color + + + + + +Background object color: +It changes the background color of the text box. The Text boxes background is white by default. If you had a dark +background color and you wanted to put some white text over it, you +could color the text box so that you could see what you were +typing. When you have finished, the area around the text would revert +to whatever the background color was. The +Defaults button restores the original +settings. + + + +Grid color: +You can change here the grid color which is black as default. + + + + + + + +<guilabel>Spelling</guilabel> + +This tab defines the spellchecker behavior. + + +Spelling + + + + +Spelling + + + + + +Default language: +You can choose here the language for the spellchecker. The languages listed come from aspell so if you want more spelling support languages, you should install the corresponding aspell-ISO packages. + + + +Enable background spellchecking +If it is checked, it will highlight in red mispelled words according to the dictionary selected above and it will spellcheck words as you type them. This is enabled by default. This option has the same effect as TextSpellcheckAutospellcheck and both are checked/unchecked at the same time. + + + +Skip all uppercase words +If this option is checked, the all uppercase words will not be checked for spelling. This option is also used when you choose the TextSpellcheckSpelling... menu option. +This is useful if the document you are working on uses a large number of acronyms. If this box is left unchecked, most of those acronyms will be incorrectly marked. By placing a mark in this checkbox, &kpresenter; will not mark the acronyms as misspelled. + + + +Skip run-together words +If checked, then concatenated words made of existing words are not spellchecked. This is useful in some languages. This option is also used when you choose the TextSpellcheckSpelling... menu option. +Examples of such words are shutout, +cannot and blackout. + +Checking this box will help prevent &kpresenter; from +flagging website and email addresses for spelling errors. These +addresses often contain words run together. + + + + + +Ignore These Words +You can have here a list of words you want to ignore in all spellchecking. + + + +Add +Write a word in the field then click on the Add button to add it in the list. Once the word is added in the list, even if you click the Cancel button of the configuration dialog, it will stay in the list. + + + +Remove +Highlight a word in the list then click on this button to remove it. + + + + + + +<guilabel>Misc</guilabel> + + +Misc + + + + +Misc + + + + +<guilabel>Misc</guilabel> + +Undo/Redo limit: +Set the number of actions you can undo and redo (how many actions &kpresenter; keeps in its Undo buffer). Default is 30. Maximum is 60 and minimum is 10. Any action that exceeds the number set will be forgotten. + + + +Display links +When you want to include a link in your slide, you will use the InsertLink... menu which allows you to insert URL, mail or file links. If the option Display links is checked, all links will be displayed in a different color. This makes document links visible. This is the default behavior. If the option is unchecked, the link will be the same color as the text color. The links are visible (or not) both in the edited slides and in the slide show. A displayed link: + A non displayed link: + + + + +Underline all links +If this is checked, all links will be underlined. The option is checked per default. If it is not checked, the link will not be underlined. A displayed and underlined link: + + + + +Display comments +Comments are inserted in the text at the cursor using the InsertComment... menu. Comments can only be viewed in editing mode and not in the slide show. If this option is checked (default) then each comment will be shown as a small yellow rectangle. You can then right click on it to edit it, remove it or copy its text. A displayed comment: + + + + + + +Display field code +In editor mode (not in slide show) this option will display all the variable codes. This is very useful to see what variable is displayed. Variables are inserted using the InsertVariable menu. + + + +Print slide notes +If checked, all notes will be printed on paper. The notes will all be printed on a separate last page, from slide one to the last slide and finishing with the Master Page Note. You can see the notes for each slide using the ViewShow Notebar menu. + + + + +<guilabel>Grid</guilabel> + +Horizontal grid size: +Set the space in centimeters between two points on an horizontal line on the grid. Default is 0.5 centimeter. + + + +Vertical grid size: +Set the space in centimeters between two points on a vertical line on the grid. Default is 0.5 centimeter. + + + + + +<guilabel>Document</guilabel> + + +Document + + + + +Document + + + + +<guilabel>Document Defaults</guilabel> + +Default font: +Click on the Choose... button, and a new dialog will appear. Use this dialog to choose the default font. This setting determines the default font used by &kpresenter; until further formatting is done. You can revert any text to this default by selecting TextDefault Format from the menubar. + + + +Global language: +Use this drop down box to determine the default language for the document. This setting is used by the hyphenation and spelling tools. + + + +Automatic hyphenation +Check this box if you want &kpresenter; to automatically hyphenate long words when it determines the word wrap in text frames. This is not set as default. + + + + + +<guilabel>Document Settings</guilabel> + +Create backup file +If checked, this will create a .<name>.odp.autosave.odp in the dir where your file is. This backup file can then be used in case of a problem. The backup file is updated everytime you save your document or everytime there is an autosave. + + + +Autosave (min): +You can use this to adjust how often &kpresenter; saves a temporary file. If you set this value to No autosave, &kpresenter; will not autosave. You can adjust the autosave from 1 minute to 60 minutes. + + + +Starting page number: +You can change here the number for the first page. It is set to 1 per default. +This is helpful if you have split a single document into multiple files. + + + +Tab stop: +Each &kpresenter; document has a default set of tab stops. If you add tab stops to your document, the newly added tab stops override the default tabstops. You can use this text box to define the spacing between default tab stops. +As an example, if you enter 1.5 in this text box, and the unit of measure is in centimeters, then the first default tab stop will be located 1.5 cm to the right of the left margin of the frame. The second default tab stop will be located at 3 cm from the left margin, etc. + + + + +<guilabel>Cursor</guilabel> + +Cursor in protected area +When this box is checked and you click in a protected frame of your document, a cursor appears. When the mark is removed from this check box, and you click in a protected frame, there is no cursor visible. + + + +Direct insert cursor + +When this box is checked then you can select a section of text using your mouse. Move the mouse to a new place in your document and click once with the middle mouse button and a copy of the selected text is copied and pasted to the new location in the document. +When there is no mark in this checkbox, in order to copy text from one section to another, you must select the text, manually copy the text in to the clipboard, then manually paste the text in the new location. + + + + + + +<guilabel>Tools</guilabel> + +This dialog sets the default tools settings. There are 5 tabs in this dialog. + + +<guilabel>Outline</guilabel> + + +The Outline tab + + + + +The Outline tab + + + +This is used in the InsertLine menu. + + + +Color: +Set the color of the line. Clicking on the color will bring the standard KDE Select Color dialog. + + +Style: +Choose the line style from No Outline which will not draw any line to dotted lines and plain line. + + +Width: +Set the width of the line. + + +Arrow Style +Set the styles of the beginning and the end of your line for example you can choose an arrow at the end and a square dot at the beginning. + + +The last field displays a preview of your settings. + + + +<guilabel>Fill</guilabel> + + +The Fill tab + + + + +The Fill tab + + + + + +Type: +You can choose between Single Color, Gradient or Transparent as the type. + + +Style: +Choose the style or the pattern. + + +Color: +Choose the color. White is the default one. Clicking on the color will bring you the standard KDE Select Color dialog. + + +The last field displays a preview of your settings, provided the color is not white! + + + +<guilabel>Rectangle</guilabel> + +This is used in the InsertShapeRectangle menu. + + +The Rectangle tab + + + + +The Rectangle tab + + + +You can choose to keep the same ratio for the two settings below by having the + icon or to separate the two settings by using the + icon. + + +Vertical declination: +Set the vertical declination. + + +Horizontal declination: +Set the horizontal declination. + + +The last field displays a preview of your settings. + + + +<guilabel>Polygon</guilabel> + +This is used in the InsertShapeConvex/Concave Polygon menu. + + +The Polygon tab + + + + +The Polygon tab + + + + + +Type: +You can choose Polygon or Convex/Concave. + + +Corners: +Set here the number of corners of the polygon. + + +Sharpness: +Increase or decrease the sharpness of the polygon. + + +The last field displays a preview of your settings. + + + +<guilabel>Pie</guilabel> + +This is used in the InsertShapePie/Arc/Chord menu. + + +The Pie tab + + + + +The Pie tab + + + + + +Type: +You can choose among three options in the dropdown box: Pie, Arc or Chord. + + +Start position: +Set here the start position. + + +Length: +Set the length of your pie. + + +The last field displays a preview of your settings. + + + + + +<guilabel>Paths</guilabel> + + +Paths + + + + +Paths + + +There are two paths that are set here, the Backup Path and the Picture Path. The Backup Path is the directory where your backup files are saved and the Picture Path is the directory where your pictures are saved. Highlight a path in order to modify it and click on Modify Path.... A small dialog appears and if you uncheck Default path, you will be able either to enter a path yourself or to choose one with the standard KDE file dialog. + + + +TTS + +See the Text-to-Speech section +in the accessibility chapter for further details. + + + + + +     diff --git a/doc/kpresenter/properties.png b/doc/kpresenter/properties.png new file mode 100644 index 00000000..a1b38c30 Binary files /dev/null and b/doc/kpresenter/properties.png differ diff --git a/doc/kpresenter/screen.docbook b/doc/kpresenter/screen.docbook new file mode 100644 index 00000000..f35d1116 --- /dev/null +++ b/doc/kpresenter/screen.docbook @@ -0,0 +1,44 @@ + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +     +     +The &kpresenter; Screen + +Here is the default &kpresenter; Screen Layout. + +At the top there is the menubar. All &kpresenter; functions are +available from the menus, which are described in detail in . + +Below the menubar are the toolbars. There are several +toolbars. You may hide and show toolbars as you prefer. The toolbars +are described in detail in . + + +The Outline and +Preview panes give an overview of your entire +presentation. The Preview pane provides +thumbnails of each slide, and allows you to drag and drop to change +the order. The Outline pane provides a +hierarchal tree of each slide, and also the objects inside the slides. +As well as overview, this allows you to easily select objects which +may be covered by others, or are otherwise difficult to grab directly on +the slide. + +     diff --git a/doc/kpresenter/settings01.png b/doc/kpresenter/settings01.png new file mode 100644 index 00000000..db91f31c Binary files /dev/null and b/doc/kpresenter/settings01.png differ diff --git a/doc/kpresenter/settings03.png b/doc/kpresenter/settings03.png new file mode 100644 index 00000000..85d370e6 Binary files /dev/null and b/doc/kpresenter/settings03.png differ diff --git a/doc/kpresenter/settings04.png b/doc/kpresenter/settings04.png new file mode 100644 index 00000000..6f2883bd Binary files /dev/null and b/doc/kpresenter/settings04.png differ diff --git a/doc/kpresenter/template02.png b/doc/kpresenter/template02.png new file mode 100644 index 00000000..8d1ef976 Binary files /dev/null and b/doc/kpresenter/template02.png differ diff --git a/doc/kpresenter/template03.png b/doc/kpresenter/template03.png new file mode 100644 index 00000000..53efdad5 Binary files /dev/null and b/doc/kpresenter/template03.png differ diff --git a/doc/kpresenter/template04.png b/doc/kpresenter/template04.png new file mode 100644 index 00000000..f0e69a16 Binary files /dev/null and b/doc/kpresenter/template04.png differ diff --git a/doc/kpresenter/template05.png b/doc/kpresenter/template05.png new file mode 100644 index 00000000..4faa5eb2 Binary files /dev/null and b/doc/kpresenter/template05.png differ diff --git a/doc/kpresenter/template06.png b/doc/kpresenter/template06.png new file mode 100644 index 00000000..e92f9f73 Binary files /dev/null and b/doc/kpresenter/template06.png differ diff --git a/doc/kpresenter/template07.png b/doc/kpresenter/template07.png new file mode 100644 index 00000000..4e8b694f Binary files /dev/null and b/doc/kpresenter/template07.png differ diff --git a/doc/kpresenter/textmenu1.png b/doc/kpresenter/textmenu1.png new file mode 100644 index 00000000..0ed57be7 Binary files /dev/null and b/doc/kpresenter/textmenu1.png differ diff --git a/doc/kpresenter/textmenu2.png b/doc/kpresenter/textmenu2.png new file mode 100644 index 00000000..7ce121e6 Binary files /dev/null and b/doc/kpresenter/textmenu2.png differ diff --git a/doc/kpresenter/toolsmenu01.png b/doc/kpresenter/toolsmenu01.png new file mode 100644 index 00000000..f1ad7692 Binary files /dev/null and b/doc/kpresenter/toolsmenu01.png differ diff --git a/doc/kpresenter/tts.png b/doc/kpresenter/tts.png new file mode 100644 index 00000000..916f04ca Binary files /dev/null and b/doc/kpresenter/tts.png differ diff --git a/doc/kpresenter/tut01.png b/doc/kpresenter/tut01.png new file mode 100644 index 00000000..fc61e1db Binary files /dev/null and b/doc/kpresenter/tut01.png differ diff --git a/doc/kpresenter/tut02.png b/doc/kpresenter/tut02.png new file mode 100644 index 00000000..edc1f1c1 Binary files /dev/null and b/doc/kpresenter/tut02.png differ diff --git a/doc/kpresenter/tut03.png b/doc/kpresenter/tut03.png new file mode 100644 index 00000000..6f7f419c Binary files /dev/null and b/doc/kpresenter/tut03.png differ diff --git a/doc/kpresenter/tut04.png b/doc/kpresenter/tut04.png new file mode 100644 index 00000000..e609be60 Binary files /dev/null and b/doc/kpresenter/tut04.png differ diff --git a/doc/kpresenter/tut05.png b/doc/kpresenter/tut05.png new file mode 100644 index 00000000..962fcf1f Binary files /dev/null and b/doc/kpresenter/tut05.png differ diff --git a/doc/kpresenter/tut06.png b/doc/kpresenter/tut06.png new file mode 100644 index 00000000..2fd81c15 Binary files /dev/null and b/doc/kpresenter/tut06.png differ diff --git a/doc/kpresenter/tut07.png b/doc/kpresenter/tut07.png new file mode 100644 index 00000000..0320f122 Binary files /dev/null and b/doc/kpresenter/tut07.png differ diff --git a/doc/kpresenter/tut08.png b/doc/kpresenter/tut08.png new file mode 100644 index 00000000..4e479869 Binary files /dev/null and b/doc/kpresenter/tut08.png differ diff --git a/doc/kpresenter/tut09.png b/doc/kpresenter/tut09.png new file mode 100644 index 00000000..f46e7edf Binary files /dev/null and b/doc/kpresenter/tut09.png differ diff --git a/doc/kpresenter/tut10.png b/doc/kpresenter/tut10.png new file mode 100644 index 00000000..345db52a Binary files /dev/null and b/doc/kpresenter/tut10.png differ diff --git a/doc/kpresenter/tut11.png b/doc/kpresenter/tut11.png new file mode 100644 index 00000000..bc7df396 Binary files /dev/null and b/doc/kpresenter/tut11.png differ diff --git a/doc/kpresenter/tut12.png b/doc/kpresenter/tut12.png new file mode 100644 index 00000000..440e49d5 Binary files /dev/null and b/doc/kpresenter/tut12.png differ diff --git a/doc/kpresenter/tut13.png b/doc/kpresenter/tut13.png new file mode 100644 index 00000000..991f7493 Binary files /dev/null and b/doc/kpresenter/tut13.png differ diff --git a/doc/kpresenter/tut14.png b/doc/kpresenter/tut14.png new file mode 100644 index 00000000..54ee8257 Binary files /dev/null and b/doc/kpresenter/tut14.png differ diff --git a/doc/kpresenter/tut15.png b/doc/kpresenter/tut15.png new file mode 100644 index 00000000..1954661f Binary files /dev/null and b/doc/kpresenter/tut15.png differ diff --git a/doc/kpresenter/tut16.png b/doc/kpresenter/tut16.png new file mode 100644 index 00000000..1f289c11 Binary files /dev/null and b/doc/kpresenter/tut16.png differ diff --git a/doc/kpresenter/tut17.png b/doc/kpresenter/tut17.png new file mode 100644 index 00000000..c36b2af8 Binary files /dev/null and b/doc/kpresenter/tut17.png differ diff --git a/doc/kpresenter/tut18.png b/doc/kpresenter/tut18.png new file mode 100644 index 00000000..87a7fda6 Binary files /dev/null and b/doc/kpresenter/tut18.png differ diff --git a/doc/kpresenter/tut19.png b/doc/kpresenter/tut19.png new file mode 100644 index 00000000..4d469987 Binary files /dev/null and b/doc/kpresenter/tut19.png differ diff --git a/doc/kpresenter/tut20.png b/doc/kpresenter/tut20.png new file mode 100644 index 00000000..0a9c8c01 Binary files /dev/null and b/doc/kpresenter/tut20.png differ diff --git a/doc/kpresenter/tut21.png b/doc/kpresenter/tut21.png new file mode 100644 index 00000000..c1d736f2 Binary files /dev/null and b/doc/kpresenter/tut21.png differ diff --git a/doc/kpresenter/tut22.png b/doc/kpresenter/tut22.png new file mode 100644 index 00000000..b96c2f57 Binary files /dev/null and b/doc/kpresenter/tut22.png differ diff --git a/doc/kpresenter/tut23.png b/doc/kpresenter/tut23.png new file mode 100644 index 00000000..9da71f83 Binary files /dev/null and b/doc/kpresenter/tut23.png differ diff --git a/doc/kpresenter/tut24.png b/doc/kpresenter/tut24.png new file mode 100644 index 00000000..d7d20eab Binary files /dev/null and b/doc/kpresenter/tut24.png differ diff --git a/doc/kpresenter/tut25.png b/doc/kpresenter/tut25.png new file mode 100644 index 00000000..4454bcfe Binary files /dev/null and b/doc/kpresenter/tut25.png differ diff --git a/doc/kpresenter/tut26.png b/doc/kpresenter/tut26.png new file mode 100644 index 00000000..302216b5 Binary files /dev/null and b/doc/kpresenter/tut26.png differ diff --git a/doc/kpresenter/tutorial.docbook b/doc/kpresenter/tutorial.docbook new file mode 100644 index 00000000..a0aa1be2 --- /dev/null +++ b/doc/kpresenter/tutorial.docbook @@ -0,0 +1,510 @@ + + + + + + +Neil +Lucock + +
    neil@nlucock.freeserve.co.uk
    +     +     + +Krishna +Tateneni + +
    tateneni@pluto.njcc.com
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + +     +     +A Step-By-Step Tutorial + + +In this chapter, &kpresenter; is introduced using a simple tutorial. We +shall walk through the most basic steps that are involved in creating a +presentation, and adding some basic effects. + + + +Start a new document + + +When you start &kpresenter;, the usual &koffice; startup dialog appears. + + + +The &koffice; +startup dialog + + + +The &koffice; startup dialog + + + + +Select Screen on the left then select the template labeled +Title (highlighted in blue in the screenshot above) by +clicking on it. You can check Always use this template to +make it the default template. + + + +Now click Use This Template. This brings up the slide +editor window, where you can view and edit the slides (and objects contained in +them) in your document. At the moment, we just have one slide, with one +object on it, which is a text box. + + + +The slide editor + + +The slide editor + + + + +Double-click the text box. The cursor changes to a vertical bar to show +that you can now type some text and the background of the edited area +becomes grey. + + + +The text insertion cursor + + + +The text insertion cursor + + + + +Go ahead, type some text! + + + +Adding text + + + +Adding text + + + + +Click away from the text to de-select the text box when you are done +typing. + + + + + +Add a new page + + +Let's now add a new slide to our document. To do so, click the +Insert menu, and then click on +Slide.... + + + +Inserting a slide from the menu + + + +Inserting a slide from the menu + + + + +This brings up the Insert Slide dialog. + + + +The Insert Slide dialog + + + +The Insert Slide +dialog + + + + +Select Use different template and click OK to add a +new page after page 1. + + + +The Create Document dialog comes up so that we can decide +what the new slide should look like. This time, select Screen on the left and double click on the +One Column template (highlighted in blue.) + + + +Choosing a template for the new page + + +Choosing a template for the new +page + + + + +The new slide now appears in the editing window. To change between pages +of your presentation, you can select slides in the pane to the left +(highlighted in blue for this screenshot). + + + +The slides list + + +The slides list + + + + +The newly inserted slide has two text boxes. There is one for a title, +and another to contain a bulleted list of items. + + + +The new slide + + +The new slide + + + + +Double-click and type a title. Then double-click on the second text +box with the bullet. Type some text and end the paragraph by pressing the +Enter or Return key. As you type new +paragraphs, bullets automatically appear in front of them. + + + +Adding text to the second slide + + +Adding text to the second slide + + + + +You can de-select the text box by clicking away from it. + + + + + +Insert a picture + + +Let's go back to the first slide now. Use the list of slides on the left +of your screen. + + + +In this section, we'll liven our presentation up a bit by adding a nice +logo to the title page. To do so, the first step is to click on the +Insert menu item, and then on +Picture.... + + + +Using the menu to add an image + + +Using the menu to add an image + + + + +This brings up a file selection dialog. To learn about this or other +standard &kde; dialog boxes in detail, please consult the &kde; +documentation. You can browse by clicking on folder +icons or by using the browser style buttons on the +toolbar (highlighted in red.) Clicking the up arrow +takes you up one folder level. + + + +Find the file named koffice-logo.png, which may be +in a different folder than the one shown in the screenshot below. You +can also choose any other graphic file if you like! Select the file, and +click OK. + + + +Choosing a picture to add + + +Choosing a picture to add + + + + +Click with the &LMB; where you want to place the loge in it's original size or +draw a rectangle with the left mouse cursor to specify the position and size for the logo. +There are selection handles (little squares) visible around the border of the graphic. + + + +The newly added image + + +The newly added image + + + + +Place the mouse cursor anywhere in the middle of the logo, and drag it +to the middle of the title page. Then use the selection handles to resize +it correctly. + + + +Dragging and resizing the image + + +Dragging and resizing the image + + + + +That's it. Now you have a picture on the title page! + + + + + +Insert a &koffice; object +Let's insert another &koffice; object under the picture, for example +a chart. + + +Every &koffice; supported document can be embedded in a &kpresenter; slide. +Let's choose a chart from &kchart;. To do so, the first step is to click on the +Insert menu item, and then +on Object. + + + +The Insert Object menu + + +The Insert Object menu + + + + +A list of the &koffice; available components appears as submenu. +Select Chart and then outline with your mouse the area you +want to put your chart in on the &kpresenter; slide. + + + +Select the area where to put the chart + + +Select the area where to put the chart + + + + + + +Once you release the mouse button, a blank chart is added on the slide. Whenever +you work in the chart, the toolbars and menubar in &kpresenter; main window are +replaced by those from &kchart;. + + + +&kchart; menus and toolbars embedded + + +&kchart; menus and toolbars embedded + + + +While you are in the chart, clicking with the &RMB; will bring the +&kchart; settings menu which allows you to modify the parameters of the chart. +Please see the &kchart; user manual to get more information on how to use +&kchart;. + +Click anywhere with the &LMB; outside the chart to go back to +&kpresenter; slide. + +A single click on the chart will allow you to drag it to change its +location and also to drag the borders to make it bigger as with any other +&kpresenter; object. Double click on the chart to get into &kchart; mode and +modify any of the chart property. + + + + +Add a shadow to the title text + + +Let's continue enhancing our title page by adding a shadow +behind the title. Right click anywhere on the +title text. This achieves two things: the text box containing the title +is selected, and a menu pops up. + + + +Select the Shadow Objects... option in the popup menu. + + + +The context menu + + +The context menu + + + + +The Shadow dialog pops up. The distance between the +shadow and the text is currently 0 so the shadow cannot be seen (this +part of the dialog box is highlighted in red.) + + + +The Shadow dialog + + +The Shadow +dialog + + + + +Increase the distance value to 3. The effect of changing the distance +can be seen in the preview window. Now click OK. + + + +Adding a shadow to the title + + +Adding a shadow to the title + + + + +Now the title has a shadow! + + + +The new shadowed title + + +The new shadowed title + + + + + + +Change the color of the title text + + +Let's finish by changing the color of the title text from black to +blue. To do so, select the title text by double-clicking the text box and select the text. + + + +Open the Select Color dialog by clicking on the dark blue A +icon on the right side of the Text toolbar (this icon has +a Color... tooltip) or choose the Text menu and then click on +Color... and change the color to blue. + + +The color palette + + +The color palette + + + + +Click OK in the Select Color dialog. Changing the color of +the selected text to blue changes its appearance. The exact color that +highlighted text turns depends on your system color scheme. + + + +Highlighted text + + +Highlighted text + + + + +Now click away from the text to de-select it. + + + +The finished title + + +The finished title + + + + +Now that there are two slides, why not try a slide show! To start the +slide show, press the play button (the blue double arrow) on +the Slide Show toolbar. The first slide should appear on your screen. + + + +The first slide + + +The first slide + + + + +To advance from the first slide to the next, just click anywhere on the +screen, or use the Page Down key. + + + +The second slide + + +The second slide + + + + +To exit the slide show, right click, and then +select the End option from the +popup menu. + + + + +     diff --git a/doc/kpresenter/zoomfactor.png b/doc/kpresenter/zoomfactor.png new file mode 100644 index 00000000..49973890 Binary files /dev/null and b/doc/kpresenter/zoomfactor.png differ diff --git a/doc/krita/Makefile.am b/doc/krita/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/krita/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/krita/README.SCREENSHOTS b/doc/krita/README.SCREENSHOTS new file mode 100644 index 00000000..bc1d55bd --- /dev/null +++ b/doc/krita/README.SCREENSHOTS @@ -0,0 +1,7 @@ +Note for translators: + +The file "mountains.png" is the original photo used for creating the screenshots +in the Dialogs section. + + +- ASK \ No newline at end of file diff --git a/doc/krita/commands-dialogs.docbook b/doc/krita/commands-dialogs.docbook new file mode 100644 index 00000000..758a4924 --- /dev/null +++ b/doc/krita/commands-dialogs.docbook @@ -0,0 +1,1411 @@ + +Dialogs + + +This section describes &krita;'s dialog windows. + + + +Dialogs for working with images + + +The <guilabel>Color Range</guilabel> dialog + + + +The Color Range dialog + + + + + +The Color Range dialog + + + + + + + +You can create a selection based on the color values of pixels here. In the +dropdown box, choose which color range you want to select. Pixels will be +selected according to their color value on this scale (⪚ a fully yellow +pixel would score maximally on the yellow scale and on the red and green scales). +If you check the Invert box, the selection becomes inverted: +pixels will become selected if they have a lower value in the specified range instead. +You can choose whether the current selection should be +added to or subtracted from the color range selection by clicking the +respective option: Add to current selection or +Subtract from current selection. Choose +Select to actually perform the selection or +Deselect to remove these pixels from the selection. + + + + + +The <guilabel>Convert Image Type</guilabel> dialog + + + +The Convert Image Type dialog + + + + + +The Convert Image Type dialog + + + + + + + +This dialog allows you to convert your image from one color space to another. +The Target color space and Destination ICM +profile are used to set to which colorspace and profile the image +will be converted. You can influence how this conversion is done with the +Rendering Intent option. + + +With Perceptual conversion, the source color space is +mapped linearly to the destination color space. If the destination color space +accepts a lesser color range than the source, shifts may occur +because the range is compressed. Relative colorimetric +conversion converts every color to the closest color in the destination color +space. This may mean that a certain color range is mapped to one color in the +destination color space. Saturation means that fully +saturated colors will remain fully saturated, even if this means that the +actual color is changed. With Absolute colorimetric +conversion, the same approach is used as with Relative +colorimetric, but the white point of the color space (the value +designating the color white) is not changed to match the new color space, +which may result in unwanted changes to near colors. + + + + + +The <guilabel>Image Properties</guilabel> dialog + + + +The Image Properties dialog + + + + + +The Image Properties dialog + + + + + + + +In this dialog you can change a couple of image properties. First of all, the +Name of the image. If you did not set a name earlier +(that can also be done when creating the image), it will have a default name +like Image1. Then, you can set its size (determined by the +Width and Height in pixels and +the Resolution in dots per inch) and the color profile to +be used (Profile). Finally, you can fill in the +Description field with any information you want to add to +the image. + + + + + +The <guilabel>Image Size</guilabel> dialog + + + +The Image Size dialog + + + + + +The Image Size dialog + + + + + + + +This dialog lets you resize your image. In the top part, you can choose the +way the image is resized. If you choose Resize, the size +of the image is changed, but its layers (which contain the actual contents) +will not be modified. So, when you double the height and width of the image, +your original image will occupy the top-left quarter part of your new image. +On decreasing the size of your image, the image layers will stretch out over +the image borders, unless you choose Crop layers on image +resize, which will crop all layers to the new image size. + +With Scale, the image layers will be resized with the +image. So increasing the image size will actually enlarge the contents, and +similar for decreasing. + +Under Pixel dimensions, you can set which new size you +want the image to have. The original size is given as a reference. The new +size can be set both as pixels or as a percentage, with 100% being the +original size. If you select Constrain proportions, the +new width and height will always be set to the same percentage. For example, +if you have an image of 200 x 100 pixels, and set the width to 20 pixels, the +height will automatically be changed to 10. With this checkbox unselected, you +can also resize the image non-proportionally. + +The Filter: dropdown box can be used to select a +different algorithm for determining the colors of the pixels in the newly +resized image that did not correspond to a pixel in the old image (the +calculated corresponding location in the old image was located in between +pixels). BSpline uses a 4 x 4 pixel grid and results into a quite high +blurring. Bell is quite fast while resulting in a reasonably smooth image. +Box is the fastest method, but yields the least appealing result. Hermite +keeps the image quite sharp, while smoothing it as well, and is reasonably +fast. Lanczos3 results in sharp images, but is very slow. Mitchell (the +default) is not very fast, but often yields a good intermediate result. +Triangle/Bilinear uses the 2 x 2 pixel grid around the calculated location +resulting in relatively sharp lines. + + + + + +The <guilabel>Rotate Image</guilabel> dialog + + + +The Rotate Image dialog + + + + + +The Rotate Image dialog + + + + + + + +With this dialog, you can rotate the image. The top part of the dialog shows +the result of the rotation in the form of a change in dimension (if any). +Under Direction you can choose between +rotating clockwise and counter-clockwise. Under Angle, +you can set the amount of rotation. 90, 180 and 270 degrees can be selected +using the respective option button, other amounts need to be specified with +the Custom spin box. + + + + + +The <guilabel>Separate Image</guilabel> dialog + + + +The Separate Image dialog + + + + + +The Separate Image dialog + + + + + + + +With this dialog, you can separate (part of) your image. Every color component +(channel) will be put into a separate layer or image. At the top of the +dialog, the current color model is shown. Below that, a couple of options can +be set. + + +Under Source, you can choose what part of the image to +separate. The two options are Current layer, which +(obviously) only uses the currently selected layer and Flatten all +layers before separation, which uses the entire image. + + +Under Output, you can choose where the result of the +separation should be written to: either to a couple of layers, or to a couple +of images. + + +Under Alpha Options, you can choose what should be done +with the alpha channel of the selected layer(s). It can be copied to each new +channel, be discarded, or separated on its own. + + +The two options at the bottom of the dialog, finally, determine whether the +source should be downscaled to 8 bit colors (if it contains more), and whether +the output should be in color (default is to separate the channels to grayscale +values). + + + + +The <guilabel>Shear Image</guilabel> dialog + + + +The Shear Image dialog + + + + + +The Shear Image dialog + + + + + + + +This dialog allows you to shear your image. By shearing, the bounding +rectangle of your image is transformed into a parallellogram. One pixel +row/column is kept in place, the next one is shifted by a certain amount, the +next one by the same amount relative to the previous one, etcetera. +The X and Y shearing angles can be set using the two spin boxes. + + + + + +The <guilabel>Substrate</guilabel> dialog + + + +The Substrate dialog + + + + + +The Substrate dialog + + + + + + + +(This dialog is still to be described.) + + + + + + + +Dialogs for working with layers + + +The <guilabel>Convert Layer Type</guilabel> dialog + + + +The Convert Layer Type dialog + + + + + +The Convert Layer Type dialog + + + + + + + +This dialog is exactly the same as the Convert Image +Type dialog, which converts an entire image instead of a +single layer. See the description there for details. + + + + + +The <guilabel>Drop Shadow</guilabel> dialog + + + +The Drop Shadow dialog + + + + + +The Drop Shadow dialog + + + + + + + +With this dialog, you can add a drop shadow effect to the current layer. +Select the X and Y offsets (displacements) of the shadow relative to the +original layer with the two topmost spin boxes. The Blur +radius spinbox determines the radius in which the shadow will be +blurred (to achieve a smooth transition at the shadow border). If you want +a special color for the shadow, you can choose one with the +Color field. The Opacity slider and +spinbox can be used to make the shadow more or less transparent. Disable the +Allow resizing checkbox if you don't want the layer to be +resized in order to give it a shadow. + + + + + +The <guilabel>Histogram</guilabel> dialog + + + +The Histogram dialog + + + + + +The Histogram dialog + + + + + + + +This dialog shows a histogram for the current layer. With the +Method: settings, you can choose what kind of histogram +to show. You can change the channel(s) to show with the +Channels: listbox, and the scale on which it should be +drawn with the Linear and +Logarithmic radio buttons. Under the preview, there are +buttons available to zoom in to, and move over, the histogram. These are +activated for 16-bit colorspace layers. + + + + + +The <guilabel>Layer Properties</guilabel> dialog + + + +The Layer Properties dialog + + + + + +The Layer Properties dialog + + + + + + + +This dialog is in essence the same as the New Layer dialog, with the difference that +you cannot change its colorspace or profile anymore. These properties are +shown, though, to keep the information complete. + + + + +The <guilabel>Layer Size</guilabel> dialog + + + +The Layer Size dialog + + + + + +The Layer Size dialog + + + + + + + +This dialog allows you to resize the current layer. +Under Pixel dimensions, you can set which new size you +want the layer to have. The original size is given as a reference. The new +size can be set both as pixels or as a percentage, with 100% being the +original size. If you select Constrain proportions, the +new width and height will always be set to the same percentage. For example, +if you have a layer of 200 x 100 pixels, and set the width to 20 pixels, the +height will automatically be changed to 10. With this checkbox unselected, you +can also resize the layer non-proportionally. The Filter: +dropdown list can be used to select a different algorithm for resizing the +layer. + + + + + +The <guilabel>New Adjustment Layer</guilabel> dialog + + + +The New Adjustment Layer dialog + + + + + +The New Adjustment Layer dialog + + + + + + + +In this dialog, you can select the type of adjustment layer to add to the +image. In the left-hand list, you can see the available adjustment layers, +each with a preview. When you select one, the Preview +will change to show a correctly scaled preview of what the result of the +adjustment layer is going to be. + +You can then choose to show either the original image or the preview of the +adjustment layer with the radio buttons below the preview window. The buttons +next to these allow you to zoom in, zoom out, and refresh the preview, +respectively. The Autoupdate checkbox determines if the +preview window should update automatically after you made a change. + +The various options available for the filter that is used to create the +adjustment layer, are shown at the bottom of the dialog. See the section on +filters of this chapter for +descriptions. + + + + + +The <guilabel>New Layer</guilabel> dialog + + + +The New Layer dialog + + + + + +The New Layer dialog + + + + + + + +You can add a new layer to your image with this dialog. If you want a +descriptive name for your layer, you can fill one in at +Name:. You can select the desired colorspace for the new +layer from the Colorspace: list, and the specific +color profile for that colorspace at Profile:. +You can preset the layer's Opacity (you can change it later with the slider in +the Layer box), and choose the mode with which the layer should be composited +onto the final image. + + + + + +The <guilabel>Rotate Layer</guilabel> dialog + + + +The Rotate Layer dialog + + + + + +The Rotate Layer dialog + + + + + + + +This dialog, similar to the Rotate Image +dialog, allows you to rotate the current layer. You can choose the +direction in which to rotate and the amount to rotate the layer by. + + + + + +The <guilabel>Shear Layer</guilabel> dialog + + + +The Shear Layer dialog + + + + + +The Shear Layer dialog + + + + + + + +This dialog works the same as the Shear Image +dialog, except that it operates on the current layer instead of on the +entire image. + + + + + + + +Dialogs for working with filters + + +All filter dialogs consist of a filter-specific part, at the left, and a +generic part, at the right. The generic part contains a preview window, which +you can configure using the controls below it. Choose +Preview or Original depending on +whether you want the preview window to show the preview of the filter effect +or the original image. The four buttons at the bottom right allow you to zoom +in and zoom out, set the zooming factor to 100% (this shows the image at its +original size), and refresh the preview, respectively. Furthermore, the option +Autoupdate determines if the preview window is updated +automatically. If you uncheck this checkbox, you will have to refresh the +preview yourself. + + + +The <guilabel>Blur</guilabel> dialog + + + +The Blur dialog + + + + + +The Blur dialog + + + + + + + +This dialog allows you to customize the way your image is blurred. The +Half-width and Half-height spinboxes +determine the size of the areas of your image that are consecutively blurred. +With the Strength spinbox you can set the strength with which the +blurring should be applied, and with the Angle spinbox +you can add a rotation to the area. The Shape setting, +finally, allows you to choose between circular and rectangular areas + + + + + + +The <guilabel>Brightness / Contrast</guilabel> dialog + + + +The Brightness / Contrast dialog + + + + + +The Brightness / Contrast dialog + + + + + + + +With this dialog, you can customize the brightness and contrast of your image. + +The curve diagram has a histogram-like background that shows you the abundance +of various brightness levels. The curve itself (initially a diagonal line from +bottom left to top right) determines to which new brightness level (on the +vertical axis) pixels with a certain original level (on the horizontal axis) are +to be mapped. For example, the default diagonal line from bottom left to top +right sets every original pixel to its own brightness value, meaning no +change. A horizontal line means that all pixels will get the same brightness. +This means minimal contrast, the brightness itself is indicated by the height +at which the line is placed. + +You can click on a handle (red circle) to select it (a selected handle is +indicated by a filled circle) and drag it around to change the shape of the +curve. The curve will be drawn smoothly through the handles (always +strictly from left to right). If you click on the curve, a handle is added to +it at that position. Clicking somewhere else in the image will also add a +handle at that point. You can press Delete to delete the +currently selected handle. + + + + + +The <guilabel>Bumpmap</guilabel> dialog + + + +The Bumpmap dialog + + + + + +The Bumpmap dialog + + + + + + + +You can apply a bumpmap effect and customize it using this dialog. One layer +is used as bumpmap layer: it is read as grayscale image and the gray values of +its pixels are used to to distort the other layer for creating the depth +illusion. High grey values, &ie; more white, mean a larger height, small +values, &ie; near black, mean a smaller height — or a larger depth, the +height can get below sealevel. A light source, shining +from above on the image that lies on the ground, +is simulated to determine the depth and direction of the shadows. + +The first option in this dialog offers you the selection of the +Bumpmap layer. + +Under Type, you can select what kind of bumpmap to be +applied. There are three types, Linear (a normal +application of the bumpmap), Spherical (focusing on the +extremes, that is, the shadow and highlight values) and +Sinusoidal (focusing on the midtone values). + +Then, there are three options to modify the bumpmap apart from its +algorithmical application. With Compensate for darkening, +the image is restored to about its original average lightness if using the +bumpmap filter would make it darker. The Invert bumpmap +option creates an inverted bumpmap (high and low are reversed). With +Tile bumpmap, a bumpmap layer that is smaller than the +layer it is applied to, will be tiled (repeatedly) to cover the entire layer. + +Under Settings, you can select the mathematical +parameters for the bumpmap. First of all, Azimuth (the +angle of the light source in the X-Y plane), Elevation +(the height of the simulated light source above the surface in degrees, with 0 +degrees being on the ground and 90 degrees being vertically above the image), +and Depth (the maximal vertical distortion of the image). + +Then, there are the X offset and Y +offset, with which you can displace the bumpmap layer relative to +the destination layer, Water level (the depth seen as +neutral), and Ambient light, which determines the +relative amount of ambient (environmental) light. + + + + + +The <guilabel>Color Adjustment</guilabel> dialog + + + +The Color Adjustment dialog + + + + + +The Color Adjustment dialog + + + + + + + +This dialog allows you to customize the Color Adjustment filter. You can use +the curve (see the section on Brightness / +Contrast for a description on the curve) to determine the mapping +from old to new color levels, for each of the channels separately. + + + + + +The <guilabel>Color to Alpha</guilabel> dialog + + + +The Color to Alpha dialog + + + + + +The Color to Alpha dialog + + + + + + + +With this dialog, you can make parts of the image having a certain color +transparent (officially alpha-transparent). You can select the +color you want to remove from the image (replacing it with transparency) with +the Color swatch, and how much a color may differ from +the selected one before it is considered not to match, with the +Threshold spinbox. Setting a threshold of zero (0) +ensures that only pixels with the exact matching color will be made +transparent, higher thresholds will make other colors match as well. + + + + +The <guilabel>Color Transfer</guilabel> dialog + + + +The Color Transfer dialog + + + + + +The Color Transfer dialog + + + + + + + +This dialog lets you copy the colors from one image (the Reference +Image) to the current one. The colors in both images are compared +and each color in the one you are working with, will be replaced by the +nearest one in the reference image. + + + + + + + +The <guilabel>Custom Convolution</guilabel> dialog + + + +The Custom Convolution dialog + + + + + +The Custom Convolution dialog + + + + + + + +With this filter, you can apply a customized distortion effect to your image. +The nine spinboxes at the top left determine the distortion. Each pixel is +assigned a new value based on these values: the old color values of the pixel +inself and the eight surrounding pixels are each multiplied by the values in +the respective spinboxes, these results are added, and the final result is the +new color value for the pixel. Before being applied, this final result can be +multiplied with a certain Factor: or a certain +Offset: can be added to it. + +In the example screenshot, each pixel is assigned a new value based on its +own (the 1 in the center), to which are added the values of the pixels to its +top right and directly below it (each with a factor of 1, &ie; the actual +value, since multiplying by one has no effect), and from which are subtracted +the values of the pixels to its bottom right and directly above it (added with +a factor of -1, so subtracted by a factor of 1). + + + + + +The <guilabel>Emboss</guilabel> dialog + + + +The Emboss dialog + + + + + +The Emboss dialog + + + + + + + +This dialog contains just one option, the Depth: slider +and spinbox which determines the depth of the embossing effect. + + + + + +The <guilabel>Filters Gallery</guilabel> dialog + + + +The Filters Gallery dialog + + + + + +The Filters Gallery dialog + + + + + + + +This dialog can be used to get a quick overview of what the various available +filters do. The filters are in turn applied to the current image and the +results are put in the left list box as thumbnails. If you select one, its +options become available in the Configuration section. +See the description of the respective filter for details. + + + + + +The <guilabel>Gaussian Noise Reduction</guilabel> dialog + + + +The Gaussian Noise Reduction dialog + + + + + +The Gaussian Noise Reduction dialog + + + + + + + +This dialog allows you to customize a Gaussian noise reduction. The +Threshold setting is a measure for how much noise should +be removed (&ie; how quickly a lonely pixel should be made +equal to its surroundings), while the Window Size setting +determines the radius of the area considered when changing pixels. + + + + + +The <guilabel>Lens Correction</guilabel> dialog + + + +The Lens Correction dialog + + + + + +The Lens Correction dialog + + + + + + + +With this dialog, you can fix an image which is distorted due to common lens +anomalies. You can specify a Distortion correction, +indicating how much the image should be corrected if its +concaveness / convexness is not right, for areas near the center and areas +near the edges. If you want an asymmetrical correction, you can specify +different X and Y coordinates for +the center (in percentages of the total width and height, measured from the +top left). + +You can also correct a too light or too dark image with the +Brightness correction spinbox. + + + + + +The <guilabel>Image Restoration</guilabel> dialog + + + +The Image Restoration dialog + + + + + +The Image Restoration dialog + + + + + + + +Using this dialog, you can specify exactly how the image restoration should +be done. This filter tries to increase the quality of an image, for instance +by removing scratches. Various options are available to customize its +behaviour. + +(Unfortunately, these are not described as of yet.) + + + + + +The <guilabel>Oilpaint</guilabel> dialog + + + +The Oilpaint dialog + + + + + +The Oilpaint dialog + + + + + + + +This dialog can configure two parameters for the associated filter. The +Brush size: setting determines the size of the brush that +is used to simulate the oilpaint effect, the Smooth: +setting specifies if the difference in colors between adjacent +swatches may be large (low smoothness) or should be small (high +smoothness). + + + + + +The <guilabel>Pixelize</guilabel> dialog + + + +The Pixelize dialog + + + + + +The Pixelize dialog + + + + + + + +On this dialog, you can adjust two settings. Pixel width: +and Pixel height: indicate the width and height of the +area that should be taken together and averaged to form one new, large +pixel. + + + + + +The <guilabel>Raindrops</guilabel> dialog + + + +The Raindrops dialog + + + + + +The Raindrops dialog + + + + + + + +This filter can be configured using the settings Drop +size: (the average diameter of the raindrops), +Number: (the number of raindrop effects that should be +added to the image), and Fish eyes: (the percentage of +raindrops that should be rendered as fisheye lens effects instead of plain +raindrop effects). + + + + +The <guilabel>Random Noise</guilabel> dialog + + + +The Random Noise dialog + + + + + +The Random Noise dialog + + + + + + + +This filter adds random noise (speckles, or something similar) to your image. +There are two customizable settings: the amount of noise +(Level, as a percentage) and the +Opacity of the noise (should the original color still be +a bit visible or not). + + + + +The <guilabel>Random Pick</guilabel> dialog + + + +The Random Pick dialog + + + + + +The Random Pick dialog + + + + + + + +In this dialog, you can specify parameters for the Random Pick +filter. The Level setting determines how much pixels will +be affected (measured as a percentage), the area which is looked in to take a +new color for a pixel is set with the Size of the window +setting, and the Opacity of the modifications can be set as +well. + + + + + + +The <guilabel>Round Corners</guilabel> dialog + + + +The Round Corners dialog + + + + + +The Round Corners dialog + + + + + + + +This dialog has one setting: the radius of the rounded corners. + + + + + +The <guilabel>Small Tiles</guilabel> dialog + + + +The Small Tiles dialog + + + + + +The Small Tiles dialog + + + + + + + +In this dialog, you can set the amount of subdivisions with the +Number of tiles settings. + + + + + +The <guilabel>Sobel</guilabel> dialog + + + +The Sobel dialog + + + + + +The Sobel dialog + + + + + + + +Here, you can set the parameters for the Sobel edge +detection filter. First of all you can determine which directions to sobel in: +horizontally, vertically, or both. The Keep sign of +result setting does not affect regular images. +Make image opaque determines whether the resulting image +is opaque or transparent. + + + + + +The <guilabel>Unsharp Mask</guilabel> dialog + + + +The Unsharp Mask dialog + + + + + +The Unsharp Mask dialog + + + + + + + +This dialog offers three options for the sharpening filter +Unsharp Mask: the radius (Half-size) +of the mask, the Amount of sharpening that should be +done, and the Threshold level. + + + + + +The <guilabel>Wave</guilabel> dialog + + + +The Wave dialog + + + + + +The Wave dialog + + + + + + + +For both the horizontal and the vertical components of the wave distortion +(note: a vertical wave means that the vertical position is dependent on the +horizontal one, and hence looks like a W), +you can determine four settings here. The Wavelength (a +shorter wavelength means a more erratical wave), the +Shift (which point of the wave should be started at), the +Amplitude (the amount of distortion), and the +Shape (Sinusoidal or rounded, +versus Triangle or pointy). + + + + + +The <guilabel>Wavelet Noise Reduction</guilabel> dialog + + + +The Wavelet Noise Reduction dialog + + + + + +The Wavelet Noise Reduction dialog + + + + + + + +The only setting here, Threshold, indicates how easily pixels +are seen as noise that should be removed and made equal to the surrounding area. + + + + + + + +Miscellaneous dialogs + + +The <guilabel>Add Palette</guilabel> dialog + + + +The Add Palette dialog + + + + + +The Add Palette dialog + + + + + + + +With this dialog, you can add a custom color palette to &krita;. Fill in the +name for your palette in the text field at the top. Then make the palette: use +the button Add New Color... to add a color to the palette +and Remove Selected Color to remove the currently +selected color. Click the button Add to Predefined +Palettes to add your newly created palette to the palette list, or +just choose OK when you're done. + + + + + +The <guilabel>Document Information</guilabel> dialog + + + +The Document Information dialog + + + + + +The Document Information dialog + + + + + + + +This dialog is the same as in other &koffice; programs. You can enter various +information about your document here, which will be saved with the document so +that you can retrieve it later to review or edit. + + + +On the General tab, you can enter the title, subject and +keywords, as well as an abstract. On the bottom of this tab, some statistical +information is displayed. On the Author tab, you can +store information about yourself. The third tab, User-defined +Metadata, allows you to store any other information. + + + + + + + diff --git a/doc/krita/commands-menus.docbook b/doc/krita/commands-menus.docbook new file mode 100644 index 00000000..b3abdcc9 --- /dev/null +++ b/doc/krita/commands-menus.docbook @@ -0,0 +1,2158 @@ + +Menus + + +Some of &krita;'s menus are standard in &kde; or &koffice;, while others are +particular to &krita;. The File menu contains commands for +manipluating files. In the Edit menu, you can find commands +that do things with the current selection. With the commands from the +View menu, you can change the way you look at the image. +The Image menu contains commands that change the entire +image, like converting all layers to another color model or resizing or +scaling the image. The Layer menu is like the +Image menu, but the commands only work on the current +layer. The Select menu contains commands to create and +manipulate selections. The Filter menu contains all the +filters you have installed. These work on the current layer. The +Scripts menu contains entries for working with scripts. +The Settings menu is again common to &koffice; and allows +you to manipulate the toolbars, shortcuts and configuration of &krita;. +Finally, the Help menu gives you access to various +(hopefully helpful) information, such as this handbook. + + + + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N +File +New + +Creates a new document. This displays the +New document dialog, standard across &koffice;, in which +you can choose to start with a blank document of a certain type, or to open a +recently opened document. + + + + +&Ctrl;O +File +Open... + +Opens an existing document. +Because this uses the usual &kde; Open Document +dialog to let you select a file, you can open files via various protocols +(ftp, fish, etcetera). + + + + + +File +Open Recent + +Opens a recently +opened document. Clicking this menu item will show a +submenu with the ten most recently opened documents in which +you can quickly open an image you have been working on lately. + + + + +&Ctrl;S +File +Save + +Saves the document. If you +haven't saved the document before, you will get the Save +Document As dialog, otherwise the document will be saved under +its current name. + + + + +File +Save As... + +Saves the document under a different name. +The default &kde; dialog is used, so saving remotely via ftp +or ssh (fish) is perfectly possible. + + + + +File +Reload + +Reloads the current document +from disk. All changes since you last saved the document +will be lost. + + + + +File +Import... + +Opens an existing document. Unlike +FileOpen, +this does not load the actual document, but only its contents: you receive a +copy of the chosen file as a new document. + + + + + +File +Export... + +Saves the document under a different name. (For +the moment, this is the same as +FileSave +As....) + + + + + +File +Mail... + +Sends the document via email. The default &kde; +mail compose window will be used. + + + + +&Ctrl;P +File +Print... + +Prints the document. You will see the usual +&kde; print dialog appear. + + + + +File +Print Preview... + +Shows a preview of what the printed document +will look like. + + + + +File +Document Information + +Opens the Document +Information dialog. This dialog can be used to add +various information to the image, like title, subject, keywords, author +information, and any other information you want to save with the +image. + + + + +&Ctrl;W +File +Close + +Closes the document. + + + + +&Ctrl;Q +File +Quit + +Quits &krita;. + + + + + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + + +&Ctrl;Z +Edit +Undo + +Undoes the last action carried out. Actions +(like painting a stroke, filling an area, etcetera) are stored on +a stack. The last action you did will be undone, and the image is +restored to the state before that. Immediately choosing +Undo again will undo the action that was carried +out before the one just undone, etcetera. + + + + +&Ctrl;&Shift;Z +Edit +Redo + +Redoes the last action undone. As described at +Undo, a series of actions can be undone. With +Redo, an action undone is carried out again, and if +more actions have been undone before that, you can redo these in +turn. + + + + +&Ctrl;X +Edit +Cut + +Cuts the selection to the +clipboard. The current selection is put on the &kde; +clipboard, and the selection is cleared. + + + + +&Ctrl;C +Edit +Copy + +Copies the selection to the +clipboard. + + + + +&Ctrl;V +Edit +Paste + +Pastes the contents of the +clipboard. + + + + +Edit +Paste into New Image + +Pastes the contents of the +clipboard as a new image. + + + + +Edit +Clear + +Clears the selection. + + + + +&Alt;&Backspace; +Edit +Fill with Foreground Color + +Fills the selection with the current foreground +color. The current foreground color is shown in the top left color +square of the Colors palette. + + + + +&Backspace; +Edit +Fill with Background Color + +Fills the selection with the current background +color. The current background color is shown in the bottom right color +square in the top left corner of the Colors +palette. + + + + +Edit +Fill with Pattern + +Fills the selection with the current pattern. +The current pattern is shown on the Brush Shapes toolbar, +usually at the top right of the &krita; window. + + + + +Edit +Resources + +Contains options for working with color +palettes. + + + + +Edit +Resources +Add New Palette... + +Opens the Add Palette +dialog. You can create a custom color palette +here. + + + + +Edit +Resources +Edit Palette... + +Opens the Edit Palette +dialog. Choose a color palette to edit from this list. You will then be +given the same dialog as with Add Palette, with the +difference that you edit the chosen color palette instead of adding a new +one. + + + + + + + + + + + +The <guimenu>View</guimenu> Menu + + + + + +&Ctrl;&Shift;F +View +Full Screen Mode + +Switches between normal view +and full screen view. In full screen view, the title +bar is hidden and the actual application window is resized to the entire +screen. + + + + +View +New View + +Opens a new view for the +current document. A new application window is opened +so that you can have two different views of the same document, for example +to work on different areas at the same time, or to look at an area at different +zoom levels simultaneously. Changes you make to the document in one view are +immediately visible in other views. + + + + +&Ctrl;&Shift;W +View +Close All Views + +Closes all views. + + + + +View +Split View + +Splits the current view. The +drawing area will be split into two parts, which can be used +just like two views in different windows. + + + + +View +Remove View + +Unsplits the view. The second +view (the bottom or right one) will be closed and the first one will remain +visible. + + + + +View +Splitter Orientation + +Changes the way the split +view is displayed. + + + + +View +Splitter Orientation +Vertical + +Changes the orientation of +the splitter to vertical. The two split +views will be positioned side by side. + + + + +View +Splitter Orientation +Horizontal + +Changes the orientation of +the splitter to horizontal. The two split views will +be positioned above each other. + + + + +&Ctrl;+ +View +Zoom In + +Zooms in on the view. The view +will be more detailed, but a smaller area will be visible at the +same time. + + + + +&Ctrl;- +View +Zoom Out + +Zooms out of the view. A larger +area will be visible at the same time, but it will be less +detailed. + + + + +&Ctrl;0 +View +Actual Pixels + +Zooms the view to actual pixel +level. (1:1 scale) + + + + +View +Actual Size + +Zooms the view to the actual image +size. + + + + +View +Fit to Page + +Zooms the view so that the image fills the available +workspace. + + + + +&Ctrl;R +View +Show Rulers + +Toggles display of the +rulers on and off. + + + + +View +Show Grid + +Toggles display of the +grid lines on and off. + + + + +View +Grid Spacing + +Contains various options to set the distance between +grid lines. The available spacing options are +1x1, 2x2, +5x5, 10x10, +20x20, and 40x40. + + + + + +View +Show Perspective Grid + +Toggles display of the perspective grid on and off. + + + + + + +View +Clear Perspective Grid + +Clears the perspective grid. (All grid lines +that were created, are deleted.) + + + + + +View +Palettes + +Allows you to toggle the +display of the various palettes on and off. The +default view of &krita; shows all palettes, and the items are listed as Hide +palette therefore. When a certain palette is hidden, +the corresponding menu item changes to Show +palette. + + + + +&Ctrl;&Shift;H +View +Palettes +Hide All Palette Windows + +Hides all palettes. + + + + +View +Palettes +Hide Overview + +Hides the +Overview palette. + + + + +View +Palettes +Hide HSV + +Hides the +HSV palette. + + + + +View +Palettes +Hide RGB + +Hides the +RGB palette. + + + + +View +Palettes +Hide Gray + +Hides the +Gray palette. + + + + +View +Palettes +Hide Palettes + +Hides the +Palettes palette. + + + + +View +Palettes +Hide Layers + +Hides the Layers +palette. + + + + +View +Palettes +Hide Scripts Manager + +Hides the Scripts Manager. + + + + + +View +Palettes +Hide Histogram + +Hides the +Histogram palette. + + + + +View +Palettes +Hide Watercolors + +Hides the Watercolors +palette. + + + + +View +Palettes +Hide Brush, Ellipse, Filter tool, Line, Polygon &etc; + +Hides the palette of the selected +Tool. + + + + +View +Wetness Visualisation + +Toggles indication of the wetness of watercolor paint +on and off. + + + + + + + + + + + +The <guimenu>Image</guimenu> Menu + + + + + +Image +Image Properties + +Opens the Image +Properties dialog, +in which you can change the image name, size, +profile and description. + + + + +Image +Resize Image to Size of Current Layer + +Resizes the image to the +size of the currently active layer. + + + + +Image +Substrate... + +Opens the Substrate dialog. + + + +Image +Rotate + +Rotates the image. + + + + +Image +Rotate +Rotate Image... + +Opens the Rotate Image +dialog. + + + + +Image +Rotate +Rotate Image CW + +Rotates the image 90 degrees +clockwise. + + + + +Image +Rotate +Rotate Image CCW + +Rotates the image 90 degrees counterclockwise +(270 degrees clockwise). + + + + +Image +Rotate +Rotate 180 + +Rotates the image 180 degrees. + + + + +Image +Convert Image Type... + +Opens the Convert All +Layers dialog. This allows you to convert the image +to a different color space. Apart from the color space, the profile and +rendering intent can be specified as well. + + + + +Image +Separate Image... + +Opens the +Separate Image +dialog. You can separate the image into layers for each +individual colorspace component there. + + + + +Image +Change Image Size... + +Opens the +Image Size +dialog . You can resize or scale the image using various +algorithms here. + + + + +Image +Shear Image... + +Opens the Shear Image +dialog. You can shear the image in X or Y directions, +or both. + + + + + + + + + + +The <guimenu>Layer</guimenu> Menu + + + + + + +Layer +New + +Creates a new layer. + + + + +&Ctrl;&Shift;N +Layer +New +Add... + +Opens the +New Layer +dialog. This will create a new empty +layer. You can set the name, opacity, composite mode and +layer type. + + + + +Layer +New +Object Layer + +Creates a new layer for a +given &koffice; object type. + + + + +Layer +New +Object Layer +Scalable Graphics + +Creates a new layer for an +embedded &karbon14; object. + + + + +Layer +New +Object Layer +Text Documents + +Creates a new layer for an +embedded &kword; document. + + + + +Layer +New +Object Layer +Flowchart & Diagram + +Creates a new layer for an embedded +&kivio; object. + + + + +Layer +New +Object Layer +Slide Presentations + +Creates a new layer for an embedded +&kpresenter; object. + + + + +Layer +New +Object Layer +Image Object + +Creates a new layer for an +embedded &krita; object. + + + + +Layer +New +Object Layer +Report Template + +Creates a new layer for an embedded +&kugar; Designer object. + + + + +Layer +New +Object Layer +Chart + +Creates a new layer for an +embedded &kchart; object. + + + + +Layer +New +Object Layer +Formula Editor + +Creates a new layer for an +embedded &kformula; object. + + + + +Layer +New +Object Layer +Report Generator + +Creates a new layer for an +embedded &kugar; object. + + + + +Layer +New +Object Layer +Project Management + +Creates a new layer for an +embedded KPlato object. + + + + +Layer +New +Object Layer +Spreadsheets + +Creates a new layer for an +embedded &kspread; document. + + + + +Layer +New +Adjustment Layer + +Opens the New Adjustment +Layerdialog. + + + + +Layer +New +Insert Image as Layer... + +Opens the Import Image +dialog. You can browse and select an image file, +which will be inserted in a new layer. + + + + +&Ctrl;&Shift;J +Layer +New +Cut Selection to New Layer + +Cuts the current selection +and inserts it as a new layer. + + + + +&Ctrl;J +Layer +New +Copy Selection to New Layer + +Copies the current selection +and inserts it as a new layer. + + + + +Layer +Remove + +Removes the current layer +and its contents. + + + + +Layer +Duplicate + +Duplicates the current +layer. + + + + +Layer +Hide/Show + +Toggles the visibility of +the current layer in the image editing window. + + + + +Layer +Mask + +Contains actions for working with layer masks. + + + + +Layer +Mask +Create Mask + + + + + + +Layer +Mask +Mask From Selection + + + + + + +Layer +Mask +Mask To Selection + + + + + + +Layer +Mask +Apply Mask + + + + + + +Layer +Mask +Remove Mask + + + + + + +Layer +Mask +Edit Mask + + + + + + +Layer +Mask +Show Mask + + + + + + +&Ctrl;] +Layer +Raise + +Moves the current layer one +level upward. + + + + +&Ctrl;[ +Layer +Lower + +Moves the current layer one +level downward. + + + + +&Ctrl;&Shift;] +Layer +To Top + +Moves the current layer to the +top. + + + + +&Ctrl;&Shift;[ +Layer +To Bottom + +Moves the current layer to +the bottom. + + + + +Layer +Save Layer as Image... + +Opens the Export Layer +dialog. The current layer will be saved to the +chosen file. + + + + +Layer +Flip on X Axis + +Flips the current layer +horizontally. + + + + +Layer +Flip on Y Axis + +Flips the current layer +vertically. + + + + +Layer +Properties + +Opens the Layer +Properties dialog. You can change the name, +colorspace, opacity, composite mode and position of the current layer +here. + + + + +&Ctrl;E +Layer +Merge with Layer Below + +Merges the current layer +with the one below it. + + + + +&Ctrl;&Shift;E +Layer +Flatten Image + +Merges all visible layers. + + + + +Layer +Rotate + +Rotates the current layer. + + + + +Layer +Rotate +Rotate Layer... + +Opens the Rotate Layer +dialog. + + + + +Layer +Rotate +Rotate CW + +Rotates the current layer 90 degrees +clockwise. + + + + +Layer +Rotate +Rotate CCW + +Rotates the current layer 90 degrees counterclockwise +(270 degrees clockwise). + + + + +Layer +Rotate +Rotate 180 + +Rotates the current layer by +180 degrees. + + + + +Layer +Histogram... + +Opens the Histogram +dialog, in which you can see histograms for the current +layer. + + + + +Layer +Convert Layer Type... + +Opens the +Convert +Current Layer dialog. You can +set various options with respect to the colorspace and +rendering intent. + + + + +Layer +Scale Layer... + +Opens the Layer +Size dialog. You can choose the new +dimensions and the resize filter to use. + + + + +Layer +Layer Effects + +Contains commands to add effects to the current layer. + + + + + +Layer +Layer Effects +Add Drop Shadow... + +Opens the Drop Shadow +dialog. This dialog can be used to add a drop shadow beneath +the current layer. + + + + +Layer +Shear Layer... + +Opens the Shear Layer +dialog. You can select the X and Y angles to shear +by. + + + + + + + + + + + +The <guimenu>Select</guimenu> Menu + + + + + +&Ctrl;A +Select +Select All + +Selects the entire +current layer. + + + + +&Ctrl;&Shift;A +Select +Deselect + +Unselects everything. + + + + +&Ctrl;&Shift;D +Select +Reselect + +Reselects the previous +unselected areas. + + + + +&Ctrl;I +Select +Invert + +Inverts the selection. +(Everything that is selected will be unselected and vice +versa.) + + + + +&Alt;&Ctrl;D +Select +Feather... + +Feathers the selection. (Adds +a soft border around it.) + + + + +Select +Similar + + + + + + +&Ctrl;H +Select +Hide Selection + +Hides the selection. The selection is still +active, but it is not made visible anymore. + + + + +Select +Grow Selection... + +Grows the selection. + + + + +Select +Shrink Selection... + +Shrinks the selection. + + + + +Select +Border Selection... + +Borders the selection. + + + + +Select +Color Range... + +Opens the Color Range +dialog. + + + + + + + + + + + +The <guimenu>Filter</guimenu> Menu + +See the Filters chapter for more +information on filters. + + + + +&Ctrl;&Shift;J +Filter +Apply Filter Again + +Repeats the last filter +action. + + + + +Filter +Adjust + +Contains various options for changing the +colors in your image. + + + + +Filter +Adjust +Auto Contrast + +Automatically changes the image to obtain as much +contrast as possible. + + + + +Filter +Adjust +Brightness/Contrast... + +Opens the +Brightness/Contrast +dialog. You can set the +brightness and contrast ratio of your image here. + + + + +Filter +Adjust +Desaturate + +Desaturates the image. This +will effectively convert the current image to grayscale, but all subsequent +painting is done with usual colors. + + + + +Filter +Adjust +Invert + +Inverts the image or +selection. (Black becomes white, blue becomes yellow, +etcetera.) + + + + +Filter +Adjust +Color Adjustment... + +Opens the Color Adjustment +dialog. You can adjust the colorspace components +of the current image there (for example, in an RGB image, you can change the +contribution of red, green, and blue to the total image). + + + + +Filter +Artistic + +Contains various filters for +artistic actions. + + + + + + +Filter +Artistic +Oilpaint... + +Opens the Oilpaint +dialog to add +an oilpaint effect to the selection or image. + + + + +Filter +Artistic +Pixelize... + +Opens the Pixelize +dialog to pixelize the image. (A block of pixels is +changed so that they all become the same, averaged color.) + + + + +Filter +Artistic +Raindrops... + +Opens the Raindrops +dialog to add a raindrops effect to the selection or +image. + + + + +Filter +Artistic +Dry the Paint + +Dries wet paint. + + + + +Filter +Blur + +Contains various blur filters. + + + + +Filter +Blur +Gaussian Blur + +Performs a slight blur on the image or +selection. + + + + +Filter +Colors + +Contains filters that change the image colors. + + + + +Filter +Colors +Color to Alpha + + + + + + +Filter +Colors +Color Transfer + +Opens the Color Transfer dialog +to give the image a new look. + + + + +Filter +Colors +Maximize Channel + +Adjusts the colors of each pixel by removing color +channels that are less abundant. + + + + +Filter +Colors +Minimize Channel + +Adjusts the colors of each pixel by removing color +channels that are abundant. + + + + +Filter +Edge Detection + +Contains edge detecting filters. + + + + +Filter +Edge Detection +Bottom Edge Detection + +Performs edge detection with the bottom sides of image +parts as references. + + + + +Filter +Edge Detection +Left Edge Detection + +Performs edge detection with the left sides of image +parts as references. + + + + +Filter +Edge Detection +Right Edge Detection + +Performs edge detection with the right sides of image +parts as references. + + + + +Filter +Edge Detection +Sobel... + +Opens the Sobel +dialog. + + + + +Filter +Edge Detection +Top Edge Detection + +Performs edge detection with the top sides of image +parts as references. + + + + +Filter +Enhance + +Contains image enhancing +filters. + + + + +Filter +Enhance +CImg Image Restoration... + +Opens the Image +Restoration dialog. + + + + +Filter +Enhance +Custom Convolution... + +Opens the Custom +Convolution dialog. + + + + +Filter +Enhance +Gaussian Noise Reduction... + + + + + + +Filter +Enhance +Mean Removal + +Sharpens the image or selection by aggravating color +borders. + + + + +Filter +Enhance +Sharpen + +Sharpens the image or selection. + + + + +Filter +Enhance +Unsharp Mask + +Applies an unsharp mask to the image or +selection. + + + + +Filter +Enhance +Wavelet Noise Reducer + +Reduces noise in the image or +selection. + + + + +Filter +Emboss + +Contains emboss filters. + + + + +Filter +Emboss +Emboss Horizontal & Vertical + +Embosses the image or selection on the two main +directions. + + + + +Filter +Emboss +Emboss with Variable Depth... + +Opens the Emboss +dialog. + + + + +Filter +Emboss +Emboss in All Directions + +Embosses the image or +selection. + + + + +Filter +Emboss +Emboss Horizontal Only + +Embosses the image or selection on the horizontal axis +only. + + + + +Filter +Emboss +Emboss Laplascian + +Embosses the image or selection using the Laplace +technique. + + + + +Filter +Emboss +Emboss Vertical Only + +Embosses the image or selection on the vertical axis +only. + + + + +Filter +Map + +Contains map filters. + + + + +Filter +Map +Bumpmap... + +Opens the Bumpmap +dialog. + + + + +Filter +Map +Round Corners... + +Opens the Round +Corners dialog to round off the corners of the image or +selection. + + + + +Filter +Map +Small Tiles... + +Shrinks the image or selection and then tiles +it. + + + + +Filter +Other + +Contains miscellaneous filters. + + + + +Filter +Other +Lens Correction... + +Opens the Lens Correction +dialog to correct for lens anomalies. + + + + +Filter +Other +Random Noise... + +Opens the Random Noise dialog to add +random noise to the image. + + + + +Filter +Other +Random Pick... + +Opens the Random Pick dialog to +distort the image. + + + + +Filter +Other +Wave... + +Opens the Wave dialog to distort the +image + + + + + +Filter +Filters Gallery + +Opens the +Filters +Gallery dialog. This +shows previews of the various filters and allows for easy +comparison. + + + + + + + + + + + +The <guimenu>Scripts</guimenu> Menu + + + + + +Scripts +Execute Script File + +Executes a script file. + + + + +Scripts +Script Manager + +Opens the Script Manager dialog. + + + + + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + + +Settings +Toolbars + +Contains options to display or hide the various +toolbars. + + + + +Settings +Toolbars +File + +Displays or hides the File +toolbar. + + + + +Settings +Toolbars +Edit + +Displays or hides the Edit +toolbar. + + + + +Settings +Toolbars +Navigation + +Displays or hides the Navigation +toolbar. + + + + +Settings +Toolbars +&krita; + +Displays or hides the +&krita; toolbar. + + + + +Settings +Toolbars +Brushes and Stuff + +Displays or hides the +Brushes and Stuff toolbar. + + + + +Settings +Configure Shortcuts... + +Opens the Configure Shortcuts + dialog. This dialog is common to most &kde; applications +and allows you to configure shortcuts for all actions &krita; has to +offer. + + + + +Settings +Configure Toolbars... + +Opens the Configure Toolbars +dialog. This dialog is common to most &kde; applications +and allows you to configure &krita;'s toolbars. + + + + +Settings +Configure &krita;... + +Opens the +Preferences +dialog. You can configure &krita; here to match your personal +preferences. + + + + + + + + + + + +The <guimenu>Help</guimenu> Menu +&help.menu.documentation; + + + diff --git a/doc/krita/commands-palettes.docbook b/doc/krita/commands-palettes.docbook new file mode 100644 index 00000000..3661be60 --- /dev/null +++ b/doc/krita/commands-palettes.docbook @@ -0,0 +1,769 @@ + +Palettes + + +This section describes &krita;'s palettes. The palettes are usually found at +the right hand side of &krita;'s main window. There are three palettes which +help you in customizing your images: + + + +The <guilabel>Control box</guilabel> palette +The Control box contains three tabs. You can get an +overview of the image, view a color histogram, and modify options for the +current tool. + + +<guilabel>Overview</guilabel> + + + +The Overview tab + + + + + +The Overview tab + + + + + +This tab offers you two settings. With the spinbox, slider, and +1:1 button at the bottom, you can set the zoom level +for the document. The Exposure slider and textbox can be +used to choose the exposure level for OpenEXR images. Furthermore, the +X and Y labels indicate the current +pointer position, with (0,0) being the top left corner of the canvas. + + + +<guilabel>Histogram</guilabel> + + + +The Histogram tab + + + + + +The Histogram tab + + + + + +This tab displays a color histogram showing the distribution of +colors over the image. The histogram is split up in red, green and blue +levels. + + + +<guilabel>Tool</guilabel> + +Actually, there is no tab named like this, since the tab name changes to +reflect the name of the currently selected tool. This tab shows the +customization options available for the tools that have them. + + +<guilabel>Brush</guilabel> + + +The Tool tab for Brush + + + + + +The Tool tab for Brush + + + + + +There are three options available on this tab. + +The Opacity slider and spin box are used to set the +opacity when drawing (opacity is the opposite of transparency, i.e. 100% +opaque is 0% transparent, and vice versa). + +In the Mode drop down box, you can choose a drawing +mode. This changes the actual effect that results from drawing on the image +(for example, only changing the saturation or lightness). + +With the Paint direct option, you can determine whether +you want to paint directly on the current layer, or on a temporary layer which +is then composited onto the actual layer. This makes a difference especially +when using relative low opacity values. + + + +<guilabel>Line</guilabel> + + +The Tool tab for Line + + + + + +The Tool tab for Line + + + + + +See Brush +for the description of Opacity and +Mode. The ? button shows a tip about +the usage of modifier keys. + + + +<guilabel>Rectangle</guilabel> + + +The Tool tab for Rectangle + + + + + +The Tool tab for Rectangle + + + + + +See Brush for a description of Opacity and +Mode. + +The Fill drop down box is used to specify whether the +inside of the rectangle should be filled. You can choose between three fill +options: the current foreground color, background color or pattern is +used. + + + +<guilabel>Bezier</guilabel> +See Brush for the +description of Mode and Opacity. + + + + +<guilabel>Ellipse</guilabel> +The same options as for Rectangle are +available here. + + + +<guilabel>Polygon</guilabel> +The same options as for Rectangle are +available here. + + + +<guilabel>Polyline</guilabel> +The same options as for Line +are available here. + + + +<guilabel>Star</guilabel> + + +The Tool tab for Star + + + + + +The Tool tab for Star + + + + + +The options for Rectangle are +available here, as well as two options specific to this tool. + +The Vertices drop down box is used to set the amount +of vertices (points) in the star. + +The Ratio setting defines the shape of the +star. A ratio of 0% will create a star with no inner area (when drawing the +star, the two lines that make up a star point, overlap). Increasing the ratio +will slowly make the star more outlined (the two lines are pulled +apart). A star with a ratio of 100% is a regular polygon. + + + + +<guilabel>Duplicate</guilabel> + + +The Tool tab for Duplicate + + + + + +The Tool tab for Duplicate + + + + + +The same options as for Line +are available here. In addition, there are three other options. + +With the Healing and +Healing radius options, you can specify that the +duplication should not copy the colors, but only the structure +of the source area. + +If you enable the Correct the perspective option, the +duplicate tool will follow your perspective grid. + + + + +<guilabel>Paint with Filters</guilabel> + + +The Tool tab for Paint with Filters + + + + + +The Tool tab for Paint with Filters + + + + + +Depending on the filter, you can set different options here. The +options you can set are the same as those available in the +normal settings dialog for the chosen filter. See the +Filters section in the Dialogs +chapter for more information. + + +<guilabel>Transform</guilabel> + + +The Tool tab for Transform + + + + + +The Tool tab for Transform + + + + + + +You can choose which transformation algorithm to use in the +Filter drop down box. + + + +<guilabel>Crop</guilabel> + + +The Tool tab for Crop + + + + + +The Tool tab for Crop + + + + + +Set the corner coordinates of the area that should remain with the +four spin boxes X, Y, +Width and Height. You can also +fill in Ratio to determine the Y/X ratio. Check one of +the checkboxes to have the respective value remain constant while changing the +size of the area. The drop down box can be used to select whether the entire +image or only the current layer should be cropped. Clicking the +Crop button has the same effect as double-clicking +outside the area in the image. + + + +<guilabel>Contiguous Fill</guilabel> + + +The Tool tab for Contiguous Fill + + + + + +The Tool tab for Contiguous Fill + + + + + +The same options as for Brush +are available here, as are a couple of other options. + +The setting in the Threshold slider and spin box +determines how near the color of a point should be to the color of the +starting point of the fill, in order for the fill to spread out over the +former point. A higher threshold will therefore fill areas that have less +similar colors, a lower threshold limits the spread. + +If you check the Fill entire selection checkbox, the +entire selection will be filled instead of only the neighboring area. + +Checking the Limit to current layer checkbox changes the +behavior of the fill: the extent to which the fill is done, is determined from +the current layer only instead of the entire image. + +By checking the Use pattern checkbox you can choose to +fill with the currently selected pattern instead of with the foreground color. + + + + +<guilabel>Gradient</guilabel> + + +The Tool tab for Gradient + + + + + +The Tool tab for Gradient + + + + + +The same options as for Brush +are available here, as are a couple of other options. + +The Shape drop down box can be used to select the gradient +type: Linear, Bi-Linear, Radial, +Square, Conical and Conical Symmetric. + +The Repeat option determines whether the gradient is +repeated if it does not fill the entire image. With None, the colors on the +ends of the gradient are used to fill the remaining space. With Forwards, the +gradient is normally repeated (connecting the back end of one occurrence with +the front end of the next). With Alternating, the gradient is repeated with +every second occurrence being drawn from back to front (linking front to front +and back to back). + +Check the Reverse checkbox to have the gradient drawn +reversed (from back to front). + +The final setting is Anti-alias threshold, which +determines how smooth the gradient will become. + + + + +<guilabel>Text</guilabel> + + +The Tool tab for Text + + + + + +The Tool tab for Text + + + + + +The same options as for Brush +are available here. Furthermore there is an option Font, +which shows the font that will be used for the text. Click the +... button to change the font. + + + + +<guilabel>Color Picker</guilabel> + + +The Tool tab for Color Picker + + + + + +The Tool tab for Color Picker + + + + + +The first option is a dropdown box in which you can choose which +layer to pick the color from. If you choose a specific layer, +the color of the point in that layer will be retrieved. With Sample +All Visible Layers, the topmost visible layer which is not +transparent at that point is used. + +If the Update current color checkbox is checked, then the +current foreground color (when clicking with the &LMB;) or background color +(when clicking with the &RMB;) is set to the picked color. + +The checkbox Add to palette and the accompanying +dropdown box determine whether the picked color should be added to an existing +palette. Check the checkbox, and choose the desired palette from the list, if +you want to do so. + +The checkbox Show colors as percentages switches the +range of color values displayed from the normal range (e.g. 0 to +255) to a scaled value between 0% and 100%. + +With the Sample radius option, you can choose the area +size to use when picking the color. A radius of one just picks one pixel, +larger radii will make the picker average over the colors of the circle-shaped +area with the chosen radius that is centered around the chosen pixel. + + + + +<guilabel>Select</guilabel> tools + + +The Tool tab for Select tools + + + + + +The Tool tab for Select tools + + + + + +The Paint Selection, Erase Selection, +Select Rectangular, Select Elliptical, Select Polygonal and Select Outline tools have one option: +the Action to perform. You can choose between Add to, or +Subtract from the selection. + + + +<guilabel>Select Contiguous Area</guilabel> + + +The Tool tab for Select Contiguous + + + + + +The Tool tab for Select Contiguous + + + + + +The Action is the same as discussed with the +Select +operations. + +The slider and spin box at Fuzziness determine how near +colors must be to the color at the clicked point to be added to the selection. + +When the Sample merged checkbox is checked, the +bounds of the selection are determined by looking at the entire image instead +of at the current layer. + + + + +<guilabel>Similar Select</guilabel> +The Action and Fuzziness +options are the same as with Select +contiguous. + + + +<guilabel>Select Magnetic</guilabel> + + +The Tool tab for Select Magnetic + + + + + +The Tool tab for Select Magnetic + + + + + +The Action option is the same as with the other +Select tools. + + +The Distance option determines the maximal distance at +which boundaries to attach to, are searched for. The To +Selection button has the same effect as double-clicking the &LMB;: +the selection is finished. + + + + + + + + +The <guilabel>Colors</guilabel> palette +In this palette you can choose the foreground and background colors +that should be used for painting. You can choose these in five different +ways. Each of these has its own tab on this palette. + +You can choose which color to set by clicking the corresponding +buttons at the top left. The topmost color is the foreground color, the +bottom one is the background color. You can click the double-headed arrow +to swap the colors: foreground color becomes background color and vice +versa. You can reset the colors to the default (foreground black, background +white) by clicking the small black/white icon. + + + +<guilabel>HSV</guilabel> + + +The HSV tab + + + + + +The HSV tab + + + + + +On this tab, you can select a color via the Hue / Saturation / Value +system. + +The hue determines the major color and starts at red with 0, then increases +along the color spectrum (that is, along the line yellow, green, +blue, violet) to a maximum of 359. This is represented in the circle on the tab +as the angle component (starting at the top, rotate along the circle +in clockwise direction to increase the hue). + +The saturation determines the pureness of the color. A saturation of 255 +yields the pure color, while a saturation of 0 yields a gray. This is the +radius component of the color circle on the tab: the center corresponds to +no saturation, the circle boundary corresponds to fully saturated. + +The value determines the lightness of the color. This darkens or lightens the +color, as can be set using the vertical slider on the tab. A value of 0 gives +black, a value of 255 gives the pure color. + + + + +<guilabel>RGB</guilabel> + + +The RGB tab + + + + + +The RGB tab + + + + + +On this tab, colors can be selected using their Red / Green / Blue +components. + +You can set red, green and blue components on a scale of 0 to 255. At 0 that +color component is absent, at 255 it is used at maximum intensity. The sliders +will change color to give you a hint about which color you will produce by +altering the corresponding value. + + + + +<guilabel>Gray</guilabel> + + +The Gray tab + + + + + +The Gray tab + + + + + +On this tab, you can choose a gray value (indicated with a K for Key, +the usual designation for black). +The gray value can be chosen on a scale from 0 (pure white) to 255 +(pure black). + + + +<guilabel>Palettes</guilabel> + + +The Palettes tab + + + + + +The Palettes tab + + + + + +On this tab, you can select a color from one of several predefined +color palettes. +You can choose which color palette to pick from in the drop down +box at the top. + + + +<guilabel>Watercolors</guilabel> + + +The Watercolors tab + + + + + +The Watercolors tab + + + + + +This tab offers you a selection of watercolors for painting with wet +paint. + +You can set two options to modify the painting behaviour: Paint +strength influences how much paint you will apply to the canvas, +and Wetness determines how wet the paint is when it is +applied. You can dry the paint later. + + + + + + +The <guilabel>Layers</guilabel> palette +This palette offers two tabs. + + +<guilabel>Layers</guilabel> + + +The Layers tab + + + + + +The Layers tab + + + + + +This tab offers you access to various operations on layers. + +On the top left, you can select what blending mode should be used for the +selected layer. These are the same possibilities as you can choose from for +drawing modes. + +The slider/textbox at the top right determines the opacity of the selected +layer. 0% opacity corresponds to 100% transparency, and vice versa. + +The list shows all layers and their names, and offers various controls for each +layer. The eye icon toggles whether the layer is visible or not. The link icon +is used to link layers together. The lock icon determines if the layer is +locked or not. Locked layers cannot be edited. + +Below the layer list, there are some other controls. You can create a new +layer, move the current layer up or down, show the layer's properties and +delete it. + + +There are some more handy tricks you can do with the mouse within the list. +Right-click on the layer list and select New Folder to +create a new layer folder, which you can use to group layers in. You can also +drag and drop layers to change their order. To do so, click on the bottom part +of the list item representing the layer, drag the mouse, and release the mouse +button at the desired position. If you click at the top part of the list item +instead, you will get a text field so that you can rename the layer. + + + + +<guilabel>Scripts Manager</guilabel> + + +The Script Manager tab + + + + + +The Script Manager tab + + + + + +This tab is a smaller version of the Script +Manager dialog. See the description over there for more +information. + + + + + + diff --git a/doc/krita/commands-toolbars.docbook b/doc/krita/commands-toolbars.docbook new file mode 100644 index 00000000..05ddea55 --- /dev/null +++ b/doc/krita/commands-toolbars.docbook @@ -0,0 +1,752 @@ + +Toolbars + +This section describes &krita;'s toolbars. By default, the +Krita toolbar is located to the left of the drawing area, +while the others can be found at the top, below the menu bar. + +You can customize your toolbars by choosing +SettingsConfigure +Toolbars... or by clicking with the &RMB; on a +toolbar and choosing Configure Toolbars.... + + +The <guilabel>File</guilabel> Toolbar + + + +The File toolbar + + + + + +The File toolbar + + + + + + +This toolbar contains actions for working with files. In &krita;'s +default, there are five buttons on this toolbar: New, +Open, Save, Print +Preview, and Print. + +These actions all correspond to entries in the File menu. + + + + +The <guilabel>Edit</guilabel> Toolbar + + + +The Edit toolbar + + + + + +The Edit toolbar + + + + + + +This toolbar contains editing actions. With default settings this +toolbar offers four buttons: Undo, +Redo, Cut, and +Copy. + +These actions all correspond to entries in the Edit menu. + + + +The <guilabel>Navigation</guilabel> Toolbar + + + +The Navigation toolbar + + + + + +The Navigation toolbar + + + + + + +This toolbar offers easy access to navigation actions. The two +default actions available are Zoom In and +Zoom Out. With Zoom In, the zoom +level is increased. You will see less, but in higher detail. With +Zoom Out, the zoom level is decreased, so that you see +more at less detail. + + + + +The <guilabel>Krita</guilabel> Toolbar + + + +The Krita toolbar + + + + + +The Krita toolbar + + + + + + + +This toolbar contains painting operations and tools, as well as editing and +selecting tools. The available actions and some controls are listed below. You +can change the behaviour of most tools (and with that, usually the resulting +effect) by setting their options. + + + + + + Brush + +With this tool you can paint freely. Click the &LMB; to paint a +single instance of the currently selected brush, or hold the &LMB; and drag +your mouse around to paint. The mouse movements you make are directly used for +painting. + + + + Line + +This tool is used to draw lines. Click the &LMB; to indicate the first +endpoint, keep the button pressed, drag to the second endpoint and release the +button. + +Use &Shift; while holding the mouse button to restrict drawing to only +horizontal or vertical lines. You can press &Alt; while still keeping the &LMB; +down to move the line to a different location. + + + + Rectangle + +This tool can be used to paint rectangles. Click and hold the &LMB; to indicate +one corner of the rectangle, drag to the opposite corner, and release the +button. + +If you hold &Shift; while drawing, a square will be drawn instead of a +rectangle. Holding &Ctrl; will change the way the rectangle is constructed. +Normally, the first mouse click indicates one corner and the second click the +opposite. With &Ctrl;, the initial mouse position indicates the center of the +rectangle, and the final mouse position indicates a corner. +You can press &Alt; while still keeping the &LMB; down to move the rectangle to +a different location. + +You can change between the corner/corner and center/corner drawing +methods as often as you want by pressing or releasing &Ctrl;, provided that you +keep the &LMB; pressed. With &Ctrl; pressed, mouse movements will affect all +four corners of the rectangle (relative to the center), without &Ctrl;, one +of the corners is unaffected. + + + + Ellipse + +Use this tool to paint an ellipse. The currently selected brush is used for +drawing the ellipse outline. Click and hold the &LMB; to indicate one corner of +the bounding rectangle of the ellipse, then move your mouse to +the opposite corner. &krita; will show a preview of the ellipse using a thin +line. Release the button to draw the ellipse. + +If you hold &Shift; while drawing, a circle will be drawn instead of an +ellipse. Holding &Ctrl; will change the way the ellipse is constructed: instead +of two corners, the initial mouse position indicates the ellipse center, and the +final mouse position indicates one of the corners of the bounding rectangle. +You can press &Alt; while still keeping the &LMB; down to move the ellipse to a +different location. + +You can change between the corner/corner and center/corner drawing +methods as often as you want by pressing or releasing &Ctrl;, provided that you +keep the &LMB; pressed. With &Ctrl; pressed, mouse movements will +affect all four corners of the bounding rectangle (relative to the center), +without &Ctrl;, the corner opposite to the one you are moving remains still. + + + + Polygon + +With this tool you can draw polygons. Click the &LMB; to indicate the +starting point and successive vertices, then double-click or press &Enter; to +connect the last vertex to the starting point. + + + + Polyline + +Polylines are drawn like polygons, with the difference that the double-click +indicating the end of the polyline does not connect the last vertex to the +first one. + + + + Star + +This tool creates star-shaped objects. Press the &LMB; to indicate the center, +and drag the mouse to change the size and rotation of the star. + +You can press &Alt; while still keeping the &LMB; down to move the star to a +different location. + + + + Bezier + +You can draw Bezier curves by using this tool. Click the &LMB; to indicate the +starting point of the curve, then click again for consecutive control points +of the curve. + + + +Drawing a Bezier curve + + + + + +Drawing a Bezier curve + + + + + + +&krita; will show a blue line with two handles when you add a control point. +You can drag these handles to change the direction of the curve in that point. + + + +Modifying a Bezier curve + + + + + +Modifying a Bezier curve + + + + + + +You can click on a previously inserted control point to modify it. With an intermediate +control point (&ie; a point that is not the starting point and not the ending +point), you can move the direction handles seperately to have the curve enter +and leave the point in different directions. After editing a point, you can +just click on the canvas to continue adding points to the curve. + + +Pressing Delete will remove the currently selected control +point from the curve. Double-click the &LMB; on any point of the curve or +press &Enter; to finish drawing, or press &Esc; to cancel the entire curve. +You can use &Ctrl; while keeping the &LMB; pressed to move the entire curve to +a different position. + + + +A finished Bezier curve + + + + + +A finished Bezier curve + + + + + + + + Duplicate + +You can use this tool to duplicate parts of an image. Press &Shift; and click +with the &LMB; on the location you want to duplicate from. &krita; will +indicate this location by an outline of your current brush. Then click with +the &LMB; to designate the location where you want to duplicate to, and drag +with the mouse. You will then duplicate whatever is at the source location to +the current (destination) location. + +While you are painting the duplicate, both your cursor in the destination +location and the brush outline in the source location will move, in order to +give you visual feedback. + +You can also use this tool to correct colors in a part of the image: use the +Healing option for that. + + + + Paint with +filters + +This tool allows you to pick a filter and draw with it. The image below shows +the effect of using a large circular brush and painting with, from left to +right, the Maximize Channel, Minimize Channel, Invert, and Desaturate filters. + + + +Painting with filters + + + + + +Painting with filters + + + + + + + + Crop + +With this tool you can crop a layer or an image to a certain rectangular area. +Click and drag with the &LMB; to define an area. This area is designated by an +outline with 8 handles. You can then use the handles to change the size of the +area which the image or layer is to be cropped to. You can also click and drag +inside the area to move the outline in its entirety. + +Double-click outside the area (i.e. on a part of the image that is to be removed) +to confirm the cropping operation. + + + + Move + +With this tool, you can move the current layer or selection by dragging the +mouse. + + + + Transform + +With this tool you can quickly transform the current selection or layer. +Handles will appear at the corners and sides, with which you can resize the +selection or layer. You can perform rotations by moving the mouse above or to +the left of the handles and dragging it. You can also click anywhere inside +the selection or layer and move it by dragging the mouse. + + + + Perspective Transform + +This tool allows you to change the perspective of an image. Designate the area +which should become the new image by clicking at its top-left, top-right, +bottom-right and bottom-left corners. The area given by these four corners +will then be transformed so that the given corners become the corners of the +actual image. + + + + Contiguous Fill + +Use this tool to fill a contiguous area of one color with the current +foreground color or a pattern. Simply click to fill up the area. + + + + Gradient + +This tool fills the current layer or selection with the currently selected +gradient. Click the &LMB;, hold it, and drag the mouse to define two endpoints. +The gradient will be drawn along this line. If the line does not extend to the +border of the selection or layer, the color at the corresponding endpoint of +the gradient will be used to fill up the rest of the area at that side. + + + + Text + +With this tool you can add simple text to your image. Click the &LMB; on the +location at which you want have the text. Then enter the desired text in the +dialog window that appears. The text will be horizontally centered on, and +the top of the text will be at the same height as, the chosen location. + + + + Color Picker + +With this tool you can find the color values of a point. Click the &LMB; +somewhere in the image to see color information about that point in the +Control box. + + + + Pan + +This tool can be used to navigate through your image. Click and hold the &LMB; +and move the mouse to scroll in a certain direction. + + + + Zoom + +Use this tool to zoom in and out. Click the &LMB; to increase the zoom by +a factor 2 (e.g. 1:1 to 2:1), click the &RMB; to decrease the zoom by a factor +2 (e.g. 1:1 to 1:2). + + + + Perspective Grid + +You can create and edit a perspective grid with this tool. Click the &LMB; and +drag the mouse to indicate the first two corners of the grid, then click for +the third and fourth corners. The outline of the grid is now shown and you can +edit it if you are not completely happy. When you switch to a different tool, +the perspective grid will be subdivided and shown as thin gray lines. + +If you only see three corners instead of four, you probably +clicked instead of dragging initially. In this case you can still click the +handle of your now combined first and second corners and drag it to get four +separate corners. + +Clicking the Perspective Grid tool again later will allow +you to modify the grid. You can hide or remove the grid by choosing the +Hide Perspective Grid or Clear +Perspective Grid options from the View menu. + + + + Paint Selection + +This tool can be used to select custom areas. The currently selected brush is +used to select areas: instead of painting on the image, the area is selected. +For more information on selections, see the Selections chapter. + + + + + Erase Selection + +This tool works almost the same as the Paint Selection +tool, but a selection, if it exists at the mouse location, is removed instead +of created. + + + + + Select Rectangular + +You can use this tool to select rectangular areas. Operation is similar to the +Rectangle tool, and &Shift;, &Ctrl; and &Alt; can be used +like when painting rectangles. + + + + + Select Elliptical + +You can use this tool to select elliptical areas. Operation is similar to the +Ellipse tool, and &Shift;, &Ctrl; and &Alt; can be used +like when painting ellipses. + + + + Select +Polygonal + +You can use this tool to select polygonal areas. Operation is similar to the +Polygon tool, and &Shift;, &Ctrl; and &Alt; can be used +like when painting polygons. + + + + Select +Outline + +You can use this tool to select custom outlined areas. Click the &LMB; and drag +with your mouse, like when painting with the Brush tool, +to define the outline. When you release the mouse button, the outline will be +finished with a straight line between the current position and the start +position. + + + + + Select Contiguous + +With this tool you can select contiguous areas of a color. Click with the +&LMB; to select an area. + + + + + Select Similar + +With this tool you can select multiple areas with the same color. Detection is +done the same as with the contiguous fill, but the areas do not need to be +adjacent. + + + + Magnetic Selection + +With this tool you can easily select a visually distinct area. Click with the +&LMB; and move the mouse around the area that you want to select. If the area +has a well enough defined boundary, the selection will be drawn nicely around +it. You will see a number of control points appear, which connect the various +parts of the selection boundary. + +If you want more control over the area that is selected, press &Ctrl; to +switch to manual mode. You will now have to click for each control point. +In manual mode, you can also move control points by clicking on them with the +&LMB; and dragging with the mouse. + +When you want to return to automatic mode, simply press &Ctrl; again. You can +switch between these two modes as often as you like. + + + + Select Bezier + +With this tool you can select an area by drawing a Bezier outline. See the +description of the Bezier tool for details. + + + + + + + +The <guilabel>Brushes and Stuff</guilabel> Toolbar + + + +The Brushes and Stuff toolbar + + + + + +The Brushes and Stuff toolbar + + + + + + +This toolbar contains dropdown palettes in which you +can choose brush shapes, gradients, and fill patterns. It also contains a +dropdown box for painter's tools, and a tablet pressure setting. + + +<guilabel>Brush Shapes</guilabel> + + + +The Brush Shapes palette + + + + + +The Brush Shapes palette + + + + + + +In the Brush Shapes palette, you can choose +which brush to paint with. This brush is used for painting operations +like Freehand, Rectangle, +Ellipse, etcetera. You can choose a predefined +brush (in the Predefined Brushes tab, shown above), or +customize or create one. + + + +The Brush Shapes palette with the Autobrush tab + + + + + +The Brush Shapes palette with the Autobrush tab + + + + + + +The Autobrush tab allows you to create a customized +rectangular or ellipsoid brush. You can set its height and width using +the Size spin boxes. The link icon controls whether +the height and width are forced to be the same or not. If a connected link +picture is shown, changing one value will automatically change the other one +as well. A disconnected link indicates that both values can be set +independently. The fuzziness of the brush can be set with the +Fade spin boxes. Again, horizontal and vertical values can +be allowed to differ or not, depending on the state of the link button. + + + +The Brush Shapes palette with the Custom Brush tab + + + + + +The Brush Shapes palette with the Custom Brush tab + + + + + + +The Custom Brush tab of this palette lets you +use the current image as a brush. With the Add to +Predefined Brushes button, you can save it for later use. + + + + +Gradients + + + +The Gradients palette + + + + + +The Gradients palette + + + + + + +In the Gradients palette, you can choose a gradient +to paint with using the Gradient tool. Clicking once on a gradient in the +palette will show a larger preview. Click it again to make it the current +gradient. +You can create your own gradients with the Custom +Gradient button. + + + + +Patterns + + + +The Patterns palette + + + + + +The Patterns palette + + + + + + +The Patterns palette allows you to choose a pattern +for operations like Pattern fill. Click a pattern to see a preview at +actual size, then click it again to select it. + + + +The Patterns palette with the Custom Pattern tab selected + + + + + +The Patterns palette with the Custom Pattern tab selected + + + + + + +You can also create a custom pattern, as is shown above. + + + + +Painter's tools + +With the Painter's tools dropdown box, you can +select the tool your painting operation should simulate. For example, you can +paint with a normal brush, an airbrush, or a filter. + + + + +Pressure variation + +This setting allows you to change &krita;'s behaviour when you use a +tablet to paint with. When you change the pressure on the tablet, you can +choose between changing the line width (size), the +opacity, and the darkness. + + + + + + diff --git a/doc/krita/commands.docbook b/doc/krita/commands.docbook new file mode 100644 index 00000000..13ab46b0 --- /dev/null +++ b/doc/krita/commands.docbook @@ -0,0 +1,14 @@ + +Command Reference + + +This chapter explains &krita;'s user interface in detail. Each of the menus, +toolbars, palettes, and dialogs will be discussed. + + +&commands-menus; +&commands-toolbars; +&commands-palettes; +&commands-dialogs; + + diff --git a/doc/krita/createdocument.png b/doc/krita/createdocument.png new file mode 100644 index 00000000..5188e232 Binary files /dev/null and b/doc/krita/createdocument.png differ diff --git a/doc/krita/credits.docbook b/doc/krita/credits.docbook new file mode 100644 index 00000000..9059e147 --- /dev/null +++ b/doc/krita/credits.docbook @@ -0,0 +1,63 @@ + + +Credits and License + + +&krita; + + +Program copyright © 1999-2006 The &krita; Team + + + +Contributors: + + +Adrian Page +Adrian.Page@tesco.net +Andrew Richards +physajr@phys.canterbury.ac.nz +Bart Coppens kde@bartcoppens.be +Boudewijn Rempt +boud@valdyas.org (current maintainer) +Carsten Pfeiffer +pfeiffer@kde.org +Casper Boemann cbr@boemann.dk +Cyrille Berger cyb@lepi.org +Danny Allen +dannya40uk@yahoo.co.uk +Dirk Schoenberger +dirk.schoenberger@sz-online.de +Gábor Lehel +illissius@gmail.com +John Califf +jcaliff@compuzone.net +Matthias Elter elter@kde.org +Melchior Franz melchior@kde.org +Michael Koch koch@kde.org +Michael Thaler +michael.thaler@ph.tum.de +Patrick Julien +freak@codepimps.org +Roger Larsson +roger.larsson@norran.net +Sven Langkamp +longamp@reallygood.de + + + + +Documentation copyright © 2005-2006 Boudewijn Rempt +boud@valdyas.org, Sander Koning +sanderkoning@kde.nl +with contributions from Casper Boemann, Bart Coppens, Cyrille Berger, Burkhard +Lueck, and Anne-Marie Mahfouf. + + + +&underFDL; +&underGPL; + + + + diff --git a/doc/krita/crocusses-autocontrast.png b/doc/krita/crocusses-autocontrast.png new file mode 100644 index 00000000..e03b3635 Binary files /dev/null and b/doc/krita/crocusses-autocontrast.png differ diff --git a/doc/krita/crocusses-blur.png b/doc/krita/crocusses-blur.png new file mode 100644 index 00000000..b6aa67da Binary files /dev/null and b/doc/krita/crocusses-blur.png differ diff --git a/doc/krita/crocusses-brightnesscontrast.png b/doc/krita/crocusses-brightnesscontrast.png new file mode 100644 index 00000000..f09808fe Binary files /dev/null and b/doc/krita/crocusses-brightnesscontrast.png differ diff --git a/doc/krita/crocusses-bumpmap.png b/doc/krita/crocusses-bumpmap.png new file mode 100644 index 00000000..ed3d0175 Binary files /dev/null and b/doc/krita/crocusses-bumpmap.png differ diff --git a/doc/krita/crocusses-coloradjustment.png b/doc/krita/crocusses-coloradjustment.png new file mode 100644 index 00000000..4e30ad20 Binary files /dev/null and b/doc/krita/crocusses-coloradjustment.png differ diff --git a/doc/krita/crocusses-colortoalpha.png b/doc/krita/crocusses-colortoalpha.png new file mode 100644 index 00000000..f3f805a1 Binary files /dev/null and b/doc/krita/crocusses-colortoalpha.png differ diff --git a/doc/krita/crocusses-colortransfer.png b/doc/krita/crocusses-colortransfer.png new file mode 100644 index 00000000..cae7c1a9 Binary files /dev/null and b/doc/krita/crocusses-colortransfer.png differ diff --git a/doc/krita/crocusses-customconvolution.png b/doc/krita/crocusses-customconvolution.png new file mode 100644 index 00000000..406c4229 Binary files /dev/null and b/doc/krita/crocusses-customconvolution.png differ diff --git a/doc/krita/crocusses-desaturate.png b/doc/krita/crocusses-desaturate.png new file mode 100644 index 00000000..5d91e28f Binary files /dev/null and b/doc/krita/crocusses-desaturate.png differ diff --git a/doc/krita/crocusses-edgebottom.png b/doc/krita/crocusses-edgebottom.png new file mode 100644 index 00000000..7438f8ab Binary files /dev/null and b/doc/krita/crocusses-edgebottom.png differ diff --git a/doc/krita/crocusses-edgeleft.png b/doc/krita/crocusses-edgeleft.png new file mode 100644 index 00000000..2b31536b Binary files /dev/null and b/doc/krita/crocusses-edgeleft.png differ diff --git a/doc/krita/crocusses-edgeright.png b/doc/krita/crocusses-edgeright.png new file mode 100644 index 00000000..996b6de8 Binary files /dev/null and b/doc/krita/crocusses-edgeright.png differ diff --git a/doc/krita/crocusses-embossall.png b/doc/krita/crocusses-embossall.png new file mode 100644 index 00000000..dcdd6f55 Binary files /dev/null and b/doc/krita/crocusses-embossall.png differ diff --git a/doc/krita/crocusses-embosshorvert.png b/doc/krita/crocusses-embosshorvert.png new file mode 100644 index 00000000..b3eb0d37 Binary files /dev/null and b/doc/krita/crocusses-embosshorvert.png differ diff --git a/doc/krita/crocusses-embossvariable.png b/doc/krita/crocusses-embossvariable.png new file mode 100644 index 00000000..526e45f3 Binary files /dev/null and b/doc/krita/crocusses-embossvariable.png differ diff --git a/doc/krita/crocusses-gaussianblur.png b/doc/krita/crocusses-gaussianblur.png new file mode 100644 index 00000000..df58f7f1 Binary files /dev/null and b/doc/krita/crocusses-gaussianblur.png differ diff --git a/doc/krita/crocusses-gaussiannoise.png b/doc/krita/crocusses-gaussiannoise.png new file mode 100644 index 00000000..3de2a4e9 Binary files /dev/null and b/doc/krita/crocusses-gaussiannoise.png differ diff --git a/doc/krita/crocusses-invert.png b/doc/krita/crocusses-invert.png new file mode 100644 index 00000000..9f3d5046 Binary files /dev/null and b/doc/krita/crocusses-invert.png differ diff --git a/doc/krita/crocusses-lenscorrection.png b/doc/krita/crocusses-lenscorrection.png new file mode 100644 index 00000000..4ac1da9a Binary files /dev/null and b/doc/krita/crocusses-lenscorrection.png differ diff --git a/doc/krita/crocusses-maximizechannel.png b/doc/krita/crocusses-maximizechannel.png new file mode 100644 index 00000000..a3f3a3f2 Binary files /dev/null and b/doc/krita/crocusses-maximizechannel.png differ diff --git a/doc/krita/crocusses-meanremoval.png b/doc/krita/crocusses-meanremoval.png new file mode 100644 index 00000000..d867e95a Binary files /dev/null and b/doc/krita/crocusses-meanremoval.png differ diff --git a/doc/krita/crocusses-minimizechannel.png b/doc/krita/crocusses-minimizechannel.png new file mode 100644 index 00000000..cfe00f21 Binary files /dev/null and b/doc/krita/crocusses-minimizechannel.png differ diff --git a/doc/krita/crocusses-oilpaint.png b/doc/krita/crocusses-oilpaint.png new file mode 100644 index 00000000..6edf1d24 Binary files /dev/null and b/doc/krita/crocusses-oilpaint.png differ diff --git a/doc/krita/crocusses-pixelize.png b/doc/krita/crocusses-pixelize.png new file mode 100644 index 00000000..bce9291c Binary files /dev/null and b/doc/krita/crocusses-pixelize.png differ diff --git a/doc/krita/crocusses-raindrops.png b/doc/krita/crocusses-raindrops.png new file mode 100644 index 00000000..322f674a Binary files /dev/null and b/doc/krita/crocusses-raindrops.png differ diff --git a/doc/krita/crocusses-randomnoise.png b/doc/krita/crocusses-randomnoise.png new file mode 100644 index 00000000..e43979f5 Binary files /dev/null and b/doc/krita/crocusses-randomnoise.png differ diff --git a/doc/krita/crocusses-randompick.png b/doc/krita/crocusses-randompick.png new file mode 100644 index 00000000..2b35f9d5 Binary files /dev/null and b/doc/krita/crocusses-randompick.png differ diff --git a/doc/krita/crocusses-roundcorners.png b/doc/krita/crocusses-roundcorners.png new file mode 100644 index 00000000..12f38646 Binary files /dev/null and b/doc/krita/crocusses-roundcorners.png differ diff --git a/doc/krita/crocusses-sharpen.png b/doc/krita/crocusses-sharpen.png new file mode 100644 index 00000000..25014c6c Binary files /dev/null and b/doc/krita/crocusses-sharpen.png differ diff --git a/doc/krita/crocusses-smalltiles.png b/doc/krita/crocusses-smalltiles.png new file mode 100644 index 00000000..0916036b Binary files /dev/null and b/doc/krita/crocusses-smalltiles.png differ diff --git a/doc/krita/crocusses-sobel.png b/doc/krita/crocusses-sobel.png new file mode 100644 index 00000000..a59c98f3 Binary files /dev/null and b/doc/krita/crocusses-sobel.png differ diff --git a/doc/krita/crocusses-topedge.png b/doc/krita/crocusses-topedge.png new file mode 100644 index 00000000..291da428 Binary files /dev/null and b/doc/krita/crocusses-topedge.png differ diff --git a/doc/krita/crocusses-unsharpmask.png b/doc/krita/crocusses-unsharpmask.png new file mode 100644 index 00000000..31b60d26 Binary files /dev/null and b/doc/krita/crocusses-unsharpmask.png differ diff --git a/doc/krita/crocusses-wave.png b/doc/krita/crocusses-wave.png new file mode 100644 index 00000000..107c53a6 Binary files /dev/null and b/doc/krita/crocusses-wave.png differ diff --git a/doc/krita/crocusses-waveletnoise.png b/doc/krita/crocusses-waveletnoise.png new file mode 100644 index 00000000..e3b25b42 Binary files /dev/null and b/doc/krita/crocusses-waveletnoise.png differ diff --git a/doc/krita/crocusses.png b/doc/krita/crocusses.png new file mode 100644 index 00000000..837da62d Binary files /dev/null and b/doc/krita/crocusses.png differ diff --git a/doc/krita/developers-plugins.docbook b/doc/krita/developers-plugins.docbook new file mode 100644 index 00000000..58dd345e --- /dev/null +++ b/doc/krita/developers-plugins.docbook @@ -0,0 +1,1553 @@ + +Developing &krita; Plugins + + +Introduction + + +&krita; is infinitely extensible with plugins. Tools, filters, large +chunks of the user interface and even colorspaces are plugins. In fact, +&krita; recognizes these six types of plugins: + + + +colorspaces — these define the channels that constitute +a single pixel +tools — anything that is done with a mouse or tablet +input device +paint operations — pluggable painting effects for +tools +image filters — change all pixels, or just the selected +pixels in a layer +viewplugins — extend Krita’s user interface with new +dialog boxes, palettes and operations +import/export filters — read and write all kinds of +image formats + + + +&krita; itself consists of three layered libraries and a directory with some +common support classes: kritacolor, kritaimage and kritaui. Within +&krita;, objects can by identified by a KisID, that is +the combination of a unique untranslated string (used when saving, for +instance) and a translated string for GUI purposes. + +A word on compatibility: &krita; is still in development. From &krita; 1.5 to +1.6 not many API changes are expected, but there may be some. From &krita; 1.6 +to 2.0 we will move from &Qt;3 to &Qt;4, from &kde;3 to &kde;4, from +automake to cmake: many changes are to +be expected. If you develop a plugin for &krita; and choose to do so in +&krita;’s subversion repository, chances are excellent that we’ll help you +porting. These changes may also render parts of this document out of date. +Always check with the latest API documentation or the header files installed +on your system. + + + +KritaColor + + +The first library is kritacolor. This library loads the colorspace plugins. + +A colorspace plugin should implement the KisColorSpace +abstract class or, if the basic capabilities of the new colorspace will be +implemented by lcms (), extend KisAbstractColorSpace. The kritacolor +library could be used from other applications and does not depend on +&koffice;. + + + + +KritaImage + + +The libkritaimage library loads the filter and paintop plugins and is +responsible for working with image data: changing pixels, compositing and +painting. Brushes, palettes, gradients and patterns are also loaded by +libkritaimage. It is our stated goal to make libkritaimage independent of +&koffice;, but we currently share the gradient loading code with &koffice;. + +It is not easy at the moment to add new types of resources such as brushes, +palettes, gradients or patterns to &krita;. (Adding new brushes, palettes, +gradients and patterns is easy, of course.) &krita; follows the guidelines of +the Create project () for these. +Adding support for Photoshop's brush file format needs libkritaimage hacking; +adding more gimp brush data files not. + +KritaImage loads the following types of plugins: + + + +&krita; filters must extend and implement the abstract class +KisFilter, +KisFilterConfiguration and possibly +KisFilterConfigurationWidget. +An example of a filter is Unsharp Mask. +Paint operations or paintops are the set of operations +painting tools suchs as freehand or circle have access to. Examples of +paintops are pen, airbrush or eraser. Paintops should extend the +KisPaintop base class. Examples of new paintops could +be a chalk brush, an oilpaint brush or a complex programmable +brush. + + + + + +KritaUI + + +The libkritaui library loads the tool and viewplugins. This library is a +&koffice; Part, but also contains a number of widgets that are useful for +graphics applications. Maybe we will have to split this library in kritapart +and kritaui in the 2.0 release. For now, script writers are not given access +to this library and plugin writers are only allowed to use this library when +writing tools or viewplugins. KritaUI loads the +following types of plugins: + + + +Tools are derived from KisTool or one +of the specialized tool base classes such as +KisToolPaint, KisToolNonPaint or +KisToolFreehand. A new tool could be a foreground +object selection tool. Painting tools (and that includes tools that paint on +the selection) can use any paintop to determine the way pixels are +changed. +Viewplugins are ordinary KParts that use +kxmlgui to insinuate themselves into &krita;'s user +interface. Menu options, dialogs, toolbars — any kind of user interface +extension can be a viewplugin. In fact, important functionality like &krita;'s +scripting support is written as a viewplugin. + + + + + +Import/Export filters + + +Import/Export filters are &koffice; filters, subclasses of +KoFilter. Filters read and write image data in any of +the myriad image formats in existence. And example of a new &krita; +import/export filter could be a PDF filter. Filters are loaded by the +&koffice; libraries. + + + + + + + +Creating plugins + + +Plugins are written in C++ and can use all of &kde; and &Qt; and the &krita; +developer API. Only viewplugins should use the &koffice; API. Don’t worry: +&krita;’s API’s are quite clear and rather extensively documented (for free +software) and coding your first filter is really easy. + +If you do not want to use C++, you can write scripts in Python or Ruby; that +is a different thing altogether, though, and you cannot currently write tools, +colorspaces, paintops or import/export filters as scripts. + +&krita; plugins use &kde;'s parts mechanism for loading, so the parts +documentation at is relevant here, too. + +Your distribution should have either installed the relevant header files with +&krita; itself, or might have split the header files into either a &koffice; +dev or a &krita; dev package. You can find the API documentation for &krita;'s +public API at . + + + +Automake (and CMake) + + +&kde; 3.x and thus &koffice; 1.5 and 1.6 use automake; +&kde; 4.0 and &koffice; 2.0 use cmake. This tutorial +describes the automake way of creating plugins. + + +Plugins are &kde; modules and should be tagged as such in their +Makefile.am. Filters, tools, paintops, colorspaces and +import/export filters need .desktop files; +viewplugins need a KXMLGui +pluginname.rc file in addition. The easiest way to get +started is to checkout the krita-plugins project from the &koffice; Subversion +repository and use it as the basis for your own project. We intend to prepare +a skeleton &krita; plugin pack for KDevelop, but haven’t had the time to do +so yet. + + + +<filename>Makefile.am</filename> + + +Let's look at the skeleton for a plugin module. First, the +Makefile.am. This is what &kde; uses to generate the +makefile that builds your plugin: + + +kde_services_DATA = kritaLIBRARYNAME.desktop + +INCLUDES = $(all_includes) + +kritaLIBRARYNAME_la_SOURCES = sourcefile1.cc sourcefile2.cc + +kde_module_LTLIBRARIES = kritaLIBRARYNAME.la +noinst_HEADERS = header1.h header2.h + +kritaLIBRARYNAME_la_LDFLAGS = $(all_libraries) -module $(KDE_PLUGIN) +kritaLIBRARY_la_LIBADD = -lkritacommon + +kritaextensioncolorsfilters_la_METASOURCES = AUTO + + +This is the makefile for a filter plugin. Replace +LIBRARYNAME with the name of your work, and you are +set. + +If your plugin is a viewplugin, you will likely also install a .rc file with entries for menubars and toolbars. +Likewise, you may need to install cursors and icons. That is all done through +the ordinary &kde; Makefile.am magic incantantions: + + +kritarcdir = $(kde_datadir)/krita/kritaplugins +kritarc_DATA = LIBRARYNAME.rc +EXTRA_DIST = $(kritarc_DATA) + +kritapics_DATA = \ + bla.png \ + bla_cursor.png +kritapicsdir = $(kde_datadir)/krita/pics + + + + + + +Desktop files + + +The .desktop file announces the type of plugin: + + +[Desktop Entry] +Encoding=UTF-8 +Icon= +Name=User-visible Name +ServiceTypes=Krita/Filter +Type=Service +X-KDE-Library=kritaLIBRARYNAME +X-KDE-Version=2 + + +Possible ServiceTypes are: + + + +Krita/Filter +Krita/Paintop +Krita/ViewPlugin +Krita/Tool +Krita/ColorSpace + + + +File import and export filters use the generic &koffice; filter framework and +need to be discussed separately. + + + + +Boilerplate + + +You also need a bit of boilerplate code that is called by the &kde; part +framework to instantiate the plugin — a header file and an implementation file. + +A header file: + +#ifndef TOOL_STAR_H_ +#define TOOL_STAR_H_ + +#include <kparts/plugin.h> + +/** +* A module that provides a star tool. +*/ +class ToolStar : public KParts::Plugin +{ + Q_OBJECT +public: + ToolStar(QObject *parent, const char *name, const QStringList &); + virtual ~ToolStar(); + +}; + +#endif // TOOL_STAR_H_ + + + + +And an implementation file: + +#include <kinstance.h> +#include <kgenericfactory.h> + +#include <kis_tool_registry.h> + +#include "tool_star.h" +#include "kis_tool_star.h" + + +typedef KGenericFactory<ToolStar> ToolStarFactory; +K_EXPORT_COMPONENT_FACTORY( kritatoolstar, ToolStarFactory( "krita" ) ) + + +ToolStar::ToolStar(QObject *parent, const char *name, const QStringList &) + : KParts::Plugin(parent, name) +{ + setInstance(ToolStarFactory::instance()); + if ( parent->inherits("KisToolRegistry") ) + { + KisToolRegistry * r = dynamic_cast<KisToolRegistry*>( parent ); + r -> add(new KisToolStarFactory()); + } + +} + +ToolStar::~ToolStar() +{ +} + +#include "tool_star.moc" + + + + + +Registries + + +Tools are loaded by the tool registry and register themselves with the tool +registry. Plugins like tools, filters and paintops are loaded only once: view +plugins are loaded for every view that is created. Note that we register +factories, generally speaking. For instance, with tools a new instance of a +tool is created for every pointer (mouse, stylus, eraser) for every few. And a +new paintop is created whenever a tool gets a mouse-down event. + + + +Filters call the filter registry: + + if (parent->inherits("KisFilterRegistry")) { + KisFilterRegistry * manager = dynamic_cast<KisFilterRegistry *>(parent); + manager->add(new KisFilterInvert()); + } + + +Paintops the paintop registry: + + if ( parent->inherits("KisPaintOpRegistry") ) { + KisPaintOpRegistry * r = dynamic_cast<KisPaintOpRegistry*>(parent); + r -> add ( new KisSmearyOpFactory ); + } + + +Colorspaces the colorspace registry (with some complications): + + if ( parent->inherits("KisColorSpaceFactoryRegistry") ) { + KisColorSpaceFactoryRegistry * f = dynamic_cast<isColorSpaceFactoryRegistry*>(parent); + + KisProfile *defProfile = new KisProfile(cmsCreate_sRGBProfile()); + f->addProfile(defProfile); + + KisColorSpaceFactory * csFactory = new KisRgbColorSpaceFactory(); + f->add(csFactory); + + KisColorSpace * colorSpaceRGBA = new KisRgbColorSpace(f, 0); + KisHistogramProducerFactoryRegistry::instance() -> add( + new KisBasicHistogramProducerFactory<KisBasicU8HistogramProducer> + (KisID("RGB8HISTO", i18n("RGB8 Histogram")), colorSpaceRGBA) ); + } + + +View plugins do not have to register themselves, and they get access to a +KisView object: + + if ( parent->inherits("KisView") ) + { + setInstance(ShearImageFactory::instance()); + setXMLFile(locate("data","kritaplugins/shearimage.rc"), true); + + (void) new KAction(i18n("&Shear Image..."), 0, 0, this, SLOT(slotShearImage()), actionCollection(), "shearimage"); + (void) new KAction(i18n("&Shear Layer..."), 0, 0, this, SLOT(slotShearLayer()), actionCollection(), "shearlayer"); + + m_view = (KisView*) parent; + } + + +Remember that this means that a view plugin will be created for every view the +user creates: splitting a view means loading all view plugins again. + + + + +Plugin versioning + + +&krita; 1.5 loads plugins with X-KDE-Version=2 set in the +.desktop file. &krita; 1.6 plugins will +probably be binary incompatible with 1.5 plugins and will need the version +number 3. &krita; 2.0 plugins will need the version number 3. Yes, this is not +entirely logical. + + + + + + + +Colorspaces + + +Colorspaces implement the KisColorSpace pure virtual +class. There are two types of colorspaces: those that can use +lcms for transformations between colorspaces, and those +that are too weird for lcms to handle. Examples of the +first are cmyk, rgb, yuv. An example of the latter is watercolor or wet & +sticky. Colorspaces that use lcms can be derived from +KisAbstractColorSpace, or of one of the base classes +that are specialized for a certain number of bits per channel. + +Implementing a colorspace is pretty easy. The general principle is that +colorspaces work on a simple array of bytes. The interpretation of these bytes +is up to the colorspace. For instance, a pixel in 16-bit GrayA consists of +four bytes: two bytes for the gray value and two bytes for the alpha value. +You are free to use a struct to work with the memory layout of a pixel in your +colorspace implementation, but that representation is not exported. The only +way the rest of &krita; can know what channels and types of channels your +colorspace pixels consist of is through the +KisChannelInfo class. + +Filters and paintops make use of the rich set of methods offered by +KisColorSpace to do their work. In many cases, the +default implementation in KisAbstractColorSpace will +work, but more slowly than a custom implementation in your own colorspace +because KisAbstractColorSpace will convert all pixels +to 16-bit L*a*b and back. + + + +<classname>KisChannelInfo</classname> + + +(http://websvn.kde.org/trunk/koffice/krita/kritacolor/kis_channelinfo.h) + + +This class defines the channels that make up a single pixel in a particular +colorspace. A channel has the following important characteristics: + + +a name for display in the user interface +a position: the byte where the bytes representing this channel +start in the pixel. +a type: color, alpha, substance or substrate. Color is plain +color, alpha is see-throughishness, substance is a representation of amount of +pigment or things like that, substrate is the representation of the canvas. +(Note that this may be refactored at the drop of a hat.) +a valuetype: byte, short, integer, float — or +other. +size: the number of bytes this channel takes +color: a QColor representation of this +channel for user interface visualization, for instance in +histograms. +an abbreviaton for use in the GUI when there’s not much +space + + + + +<classname>KisCompositeOp</classname> + + +As per original Porter-Duff, there are many ways of combining pixels to get a +new color. The KisCompositeOp class defines most of +them: this set is not easily extensible except by hacking the kritacolor +library. + +A colorspace plugin can support any subset of these possible composition +operations, but the set must always include "OVER" (same as "NORMAL") and +"COPY". The rest are more or less optional, although more is better, of +course. + + + + +<classname>KisColorSpace</classname> + + +The methods in the KisColorSpace pure virtual classs +can be divided into a number of groups: conversion, identification and +manipulation. + +All classes must be able to convert a pixel from and to 8 bit RGB (i.e., a +QColor), and preferably also to and from 16 bit L*a*b. +Additionally, there is a method to convert to any colorspace from the current +colorspace. + +Colorspaces are described by the KisChannelInfo vector, +number of channels, number of bytes in a single pixel, whether it supports +High Dynamic Range images and more. + +Manipulation is for instance the combining of two pixels in a new +pixel: bitBlt, darkening or convolving of pixels. + +Please consult the API documentation for a full description of all methods you +need to implement in a colorspace. + +KisAbstractColorSpace implements many of the virtual +methods of KisColorSpace using functions from the +lcms library. On top of +KisAbstractColorSpace there are base colorspace classes +for 8 and 16 bit integer and 16 and 32 bit float colorspaces that define +common operations to move between bit depths. + + + + + + +Filters + + +Filters are plugins that examine the pixels in a layer and them make changes +to them. Although &krita; uses an efficient tiled memory backend to store +pixels, filter writers do not have to bother with that. When writing a filter +plugin for the &Java; imaging API, Photoshop or The Gimp, you need to take care +of tile edges and cobble tiles together: &krita; hides that +implementation detail. + +Note that it is theoretically easy to replace the current tile +image data storage backend with another backend, but that backens are not true +plugins at the moment, for performance reasons. + +&krita; uses iterators to read and write pixel values. Alternatively, you can +read a block of pixels into a memory buffer, mess with it and then write it +back as a block. But that is not necessarily more efficient, it may even be +slower than using the iterators; it may just be more convenient. See the API +documentation. + +&krita; images are composed of layers, of which there are currently four +kinds: paint layers, group layers, adjustment layers (that contain a filter +that is applied dynamically to layers below the adjustment layer) and part +layers. Filters always operate on paint layers. Paint layers contain paint +devices, of the class KisPaintDevice. A paint device in +its turn gives access to the actual pixels. + +PaintDevices are generally passed around wrapped in +shared pointers. A shared pointer keeps track of in how many places the paint +device is currently used and deletes the paint device when it is no longer +used anywhere. You recognize the shared pointer version of a paint device +through its SP suffix. Just remember that you never have to +explicitly delete a KisPaintDeviceSP. + +Let's examine a very simple filter, one that inverts every pixel. The code for +this filter is in the koffice/krita/plugins/filters/example directory. +The main method is + +KisFilterInvert::process(KisPaintDeviceSP src, KisPaintDeviceSP dst, + KisFilterConfiguration* /*config*/, const QRect& rect). + +The function gets passed two paint devices, a configuration object (which is +not used in this simple filter) and a rect. The +rect describes the area of the +paint device which the filter should act on. This area is described by +integers, which means no sub-pixel accuracy. + +The src paint device is for reading from, the +dst paint device for writing to. These parameters may point +to the same actual paint device, or be two different paint devices. (Note: +this may change to only one paint device in the future.) + +Now, let's look at the code line by line: + + +void KisFilterInvert::process(KisPaintDeviceSP src, KisPaintDeviceSP dst, + KisFilterConfiguration* /*config*/, const QRect& rect) +{ + Q_ASSERT(src != 0); + Q_ASSERT(dst != 0); + + KisRectIteratorPixel srcIt = src->createRectIterator(rect.x(), rect.y(), rect.width(), rect.height(), false); + KisRectIteratorPixel dstIt = dst->createRectIterator(rect.x(), rect.y(), rect.width(), rect.height(), true ); + + int pixelsProcessed = 0; + setProgressTotalSteps(rect.width() * rect.height()); + + KisColorSpace * cs = src->colorSpace(); + Q_INT32 psize = cs->pixelSize(); + + while( ! srcIt.isDone() ) + { + if(srcIt.isSelected()) + { + memcpy(dstIt.rawData(), srcIt.oldRawData(), psize); + + cs->invertColor( dstIt.rawData(), 1); + } + setProgress(++pixelsProcessed); + ++srcIt; + ++dstIt; + } + setProgressDone(); // Must be called even if you don't really support progression +} + + + + +This creates an iterator to read the existing pixels. Krita has three +types of iterators: horizontal, vertical and rectangular. The rect iterator +takes the most efficient path through the image data, but does not guarantee +anything about the location of the next pixel it returns. That means that you +cannot be sure that the pixel you will retrieve next will be adjacent to the +pixel you just got. The horizontal and vertical line iterators do guarantee +the location of the pixels they return. + + +(2) We create the destination iterator with the write +setting to true. This means that if the destination paint +device is smaller than the rect we write, it will automatically be enlarged to +fit every pixel we iterate over. Note that we have got a potential bug here: +if dst and src are not the same device, +then it is quite possible that the pixels returned by the iterators do not +correspond. For every position in the iterator, src may be, +for example, at 165,200, while dst could be at 20,8 — +and therefore the copy we perform below may distort the image... + + +Want to know if a pixel is selected? That is easy — use the +isSelected method. But selectedness is not a binary +property of a pixel, a pixel can be half selected, barely selected or almost +completely selected. That value you can also got from the iterator. Selections +are actually a mask paint device with a range between 0 and 255, where 0 is +completely unselected and 255 completely selected. The iterator has two +methods: isSelected() and +selectedNess(). The first returns true if a pixel is +selected to any extent (i.e., the mask value is greater than 1), the other +returns the maskvalue. + + +As noted above, this memcpy is a big bad bug... +rawData() returns the array of bytes which is the +current state of the pixel; oldRawData() returns the +array of bytes as it was before we created the iterator. However, we may be +copying the wrong pixel here. In actual practice, that will not happen too +often, unless dst already exists and is not aligned with +src. + + +But this is correct: instead of figuring out which byte represents which +channel, we use a function supplied by all colorspaces to invert the current +pixel. The colorspaces have a lot of pixel operations you can make use of. + + + + +This is not all there is to creating a filter. Filters have two other +important components: a configuration object and a configuration widget. The +two interact closely. The configuration widget creates a configuration object, +but can also be filled from a pre-existing configuration object. Configuration +objects can represtent themselves as XML and can be created from XML. That is +what makes adjustment layers possible. + + + +Iterators + + +There are three types of iterators: + + + +Horizontal lines +Vertical lines +Rectangular iterors + + + +The horizontal and vertical line iterators have a method to move the iterator +to the next row or column: nextRow() and +nextCol(). Using these is much faster than creating a +new iterator for every line or column. + +Iterators are thread-safe in &krita;, so it is possible to divide the work +over multiple threads. However, future versions of &krita; will use the +supportsThreading() method to determine whether your +filter can be applied to chunks of the image (&ie;, all pixels modified +independently, instead of changed by some value determined from an examination +of all pixels in the image) and automatically thread the execution your +filter. + + + + +<classname>KisFilterConfiguration</classname> + + +KisFilterConfiguration is a structure that is used to +save filter settings to disk, for instance for adjustment layers. The +scripting plugin uses the property map that’s at the back of +KisFilterConfigaration to make it possible to script +filters. Filters can provide a custom widget that &krita; will show in the +filters gallery, the filter preview dialog or the tool option tab of the +paint-with-filters tool. + + +An example, taken from the oilpaint effect filter: + + +class KisOilPaintFilterConfiguration : public KisFilterConfiguration +{ + +public: + + KisOilPaintFilterConfiguration(Q_UINT32 brushSize, Q_UINT32 smooth) + : KisFilterConfiguration( "oilpaint", 1 ) + { + setProperty("brushSize", brushSize); + setProperty("smooth", smooth); + }; +public: + + inline Q_UINT32 brushSize() { return getInt("brushSize"); }; + inline Q_UINT32 smooth() {return getInt("smooth"); }; + +}; + + + + +<classname>KisFilterConfigurationWidget</classname> + + +Most filters can be tweaked by the user. You can create a configuration widget +that Krita will use where-ever your filter is used. An example: + + + + +The Oilpaint dialog + + + + + +The Oilpaint dialog + + + + + + + +Note that only the left-hand side of this dialog is your responsibility: +&krita; takes care of the rest. There are three ways of going about creating +an option widget: + + + +Use &Qt; Designer to create a widget base, and subclass it for +your filter +Use one of the simple widgets that show a number of sliders +for lists of integers, doubles or bools. These are useful if, like the above +screenshot, your filter can be configured by a number of integers, doubles or +bools. See the API dox for KisMultiIntegerFilterWidget, +KisMultiDoubleFilterWidget and +KisMultiBoolFilterWidget. +Hand-code a widget. This is not recommended, and if you do so +and want your filter to become part of &krita;’s official release, then I’ll ask +you to replate your hand-coded widget with a &Qt; Designer +widget. + + + +The oilpaint filter uses the multi integer widget: + + + +KisFilterConfigWidget * KisOilPaintFilter::createConfigurationWidget(QWidget* parent, KisPaintDeviceSP /*dev*/) +{ + vKisIntegerWidgetParam param; + param.push_back( KisIntegerWidgetParam( 1, 5, 1, i18n("Brush size"), "brushSize" ) ); + param.push_back( KisIntegerWidgetParam( 10, 255, 30, i18n("Smooth"), "smooth" ) ); + return new KisMultiIntegerFilterWidget(parent, id().id().ascii(), id().id().ascii(), param ); +} + +KisFilterConfiguration* KisOilPaintFilter::configuration(QWidget* nwidget) +{ + KisMultiIntegerFilterWidget* widget = (KisMultiIntegerFilterWidget*) nwidget; + if( widget == 0 ) + { + return new KisOilPaintFilterConfiguration( 1, 30); + } else { + return new KisOilPaintFilterConfiguration( widget->valueAt( 0 ), widget->valueAt( 1 ) ); + } +} + +std::list<KisFilterConfiguration*> KisOilPaintFilter::listOfExamplesConfiguration(KisPaintDeviceSP ) +{ + std::list<KisFilterConfiguration*> list; + list.insert(list.begin(), new KisOilPaintFilterConfiguration( 1, 30)); + return list; +} + + + +You can see how it works: fill a vector with your integer parameters and +create the widget. The configuration() method +inspects the widget and creates the right filter configuration object, in this +case, of course, KisOilPaintFilterConfiguration. The +listOfExamplesConfiguration method (which should be +renamed to correct English...) returns a list with example configuration +objects for the filters gallery dialog. + + + + +Filters conclusion + + +There’s more to coding interesting filters, of course, but with this +explanation, the API documentation and access to our source code, you should +be able to get started. Don’t hesitate to contact the &krita; developers on +IRC or on the mailing list. + + + + + + +Tools + + +Tools appear in &krita;’s toolbox. This means that there is limited space for +new tools — think carefully whether a paint operation isn’t enough for +your purposes. Tools can use the mouse/tablet and keyboard in complex ways, +which paint operations cannot. This is the reason that Duplicate is a tool, +but airbrush a paint operation. + +Be careful with static data in your tool: a new instance of your tool is +created for every input device: mouse, stylus, eraser, airbrush — whatever. +Tools come divided into logical groups: + + +shape drawing tools (circle, rect) +freehand drawing tools (brush) +transform tools that mess up the geometry of a +layer +fill tools (like bucket fill or gradient) +view tools (that don’t change pixels, but alter the way you +view the canvas, such as zoom) +select tools (that change the selection +mask) + + + +The tool interface is described in the API documentation for +KisTool. There are three subclasses: +KisToolPaint, KisToolNonPaint +and KisToolShape (which is actually a subclass of +KisToolPaint) that specialize +KisTool for painting tasks (i.e., changing pixels) , +non-painting tasks and shape painting tasks. + +A tool has an option widget, just like filters. Currently, the option widgets +are shown in a tab in a dock window. We may change that to a strip under the +main menu (which then replaces the toolbar) for &krita; 2.0, but for now, +design your option widget to fit in a tab. As always, it’s best to use &Qt; +Designer for the design of the option widget. + +A good example of a tool is the star tool: + + + +kis_tool_star.cc Makefile.am tool_star_cursor.png wdg_tool_star.ui +kis_tool_star.h Makefile.in tool_star.h +kritatoolstar.desktop tool_star.cc tool_star.png + + + +As you see, you need two images: one for the cursor and one for the toolbox. +tool_star.cc is just the plugin loader, similar to what +we have seen above. The real meat is in the implementation: + + + +KisToolStar::KisToolStar() + : KisToolShape(i18n("Star")), + m_dragging (false), + m_currentImage (0) +{ + setName("tool_star"); + setCursor(KisCursor::load("tool_star_cursor.png", 6, 6)); + m_innerOuterRatio=40; + m_vertices=5; +} + + + +The constructor sets the internal name — which is not translated +— and the call to the superclass sets the visible name. We also load the +cursor image and set a number of variables. + + + +void KisToolStar::update (KisCanvasSubject *subject) +{ + KisToolShape::update (subject); + if (m_subject) + m_currentImage = m_subject->currentImg(); +} + + + +The update() method is called when the tool is +selected. This is not a KisTool method, but a +KisCanvasObserver method. Canvas observers are notified +whenever something changes in the view, which can be useful for tools. + +The following methods (buttonPress, +move and buttonRelease) are +called by &krita; when the input device (mouse, stylus, eraser etc.) is +pressed down, moved or released. Note that you also get move events if the +mouse button isn’t pressed. The events are not the regular &Qt; events, but +synthetic &krita; events because we make use of low-level trickery to get +enough events to draw a smooth line. By default, toolkits like &Qt; (and GTK) +drop events if they are too busy to handle them, and we want them all. + + + +void KisToolStar::buttonPress(KisButtonPressEvent *event) +{ + if (m_currentImage && event->button() == LeftButton) { + m_dragging = true; + m_dragStart = event->pos(); + m_dragEnd = event->pos(); + m_vertices = m_optWidget->verticesSpinBox->value(); + m_innerOuterRatio = m_optWidget->ratioSpinBox->value(); + } +} + +void KisToolStar::move(KisMoveEvent *event) +{ + if (m_dragging) { + // erase old lines on canvas + draw(m_dragStart, m_dragEnd); + // move (alt) or resize star + if (event->state() & Qt::AltButton) { + KisPoint trans = event->pos() - m_dragEnd; + m_dragStart += trans; + m_dragEnd += trans; + } else { + m_dragEnd = event->pos(); + } + // draw new lines on canvas + draw(m_dragStart, m_dragEnd); + } +} + +void KisToolStar::buttonRelease(KisButtonReleaseEvent *event) +{ + if (!m_subject || !m_currentImage) + return; + + if (m_dragging && event->button() == LeftButton) { + // erase old lines on canvas + draw(m_dragStart, m_dragEnd); + m_dragging = false; + + if (m_dragStart == m_dragEnd) + return; + + if (!m_currentImage) + return; + + if (!m_currentImage->activeDevice()) + return; + + KisPaintDeviceSP device = m_currentImage->activeDevice ();; + KisPainter painter (device); + if (m_currentImage->undo()) painter.beginTransaction (i18n("Star")); + + painter.setPaintColor(m_subject->fgColor()); + painter.setBackgroundColor(m_subject->bgColor()); + painter.setFillStyle(fillStyle()); + painter.setBrush(m_subject->currentBrush()); + painter.setPattern(m_subject->currentPattern()); + painter.setOpacity(m_opacity); + painter.setCompositeOp(m_compositeOp); + KisPaintOp * op = + KisPaintOpRegistry::instance()->paintOp(m_subject->currentPaintop(), m_subject->currentPaintopSettings(), &painter); + painter.setPaintOp(op); // Painter takes ownership + + vKisPoint coord = starCoordinates(m_vertices, m_dragStart.x(), m_dragStart.y(), m_dragEnd.x(), m_dragEnd.y()); + + painter.paintPolygon(coord); + + device->setDirty( painter.dirtyRect() ); + notifyModified(); + + if (m_currentImage->undo()) { + m_currentImage->undoAdapter()->addCommand(painter.endTransaction()); + } + } +} + + + +The draw() method is an internal method of +KisToolStar and draws the outline of the star. We call +this from the move() method to give the user feedback +of the size and shape of their star. Note that we use the +Qt::NotROP raster operation, which means that calling +draw() a second time with the same start and end +point the previously drawn star will be deleted. + + + +void KisToolStar::draw(const KisPoint& start, const KisPoint& end ) +{ + if (!m_subject || !m_currentImage) + return; + + KisCanvasController *controller = m_subject->canvasController(); + KisCanvas *canvas = controller->kiscanvas(); + KisCanvasPainter p (canvas); + QPen pen(Qt::SolidLine); + + KisPoint startPos; + KisPoint endPos; + startPos = controller->windowToView(start); + endPos = controller->windowToView(end); + + p.setRasterOp(Qt::NotROP); + + vKisPoint points = starCoordinates(m_vertices, startPos.x(), startPos.y(), endPos.x(), endPos.y()); + + for (uint i = 0; i < points.count() - 1; i++) { + p.drawLine(points[i].floorQPoint(), points[i + 1].floorQPoint()); + } + p.drawLine(points[points.count() - 1].floorQPoint(), points[0].floorQPoint()); + + p.end (); +} + + + +The setup() method is essential: here we create the +action that will be plugged into the toolbox so users can actually select the +tool. We also assign a shortcut key. Note that there’s some hackery going on: +remember that we create an instance of the tool for every input device. This +also means that we call setup() for every input +device and that means that an action with the same name is added several times +to the action collection. However, everything seems to work, so why worry? + + + +void KisToolStar::setup(KActionCollection *collection) +{ + m_action = static_cast<KRadioAction *>(collection->action(name())); + + if (m_action == 0) { + KShortcut shortcut(Qt::Key_Plus); + shortcut.append(KShortcut(Qt::Key_F9)); + m_action = new KRadioAction(i18n("&Star"), + "tool_star", + shortcut, + this, + SLOT(activate()), + collection, + name()); + Q_CHECK_PTR(m_action); + + m_action->setToolTip(i18n("Draw a star")); + m_action->setExclusiveGroup("tools"); + m_ownAction = true; + } +} + + + +The starCoordinates() method contains some funky math +— but is not too interesting for the discussion of how to create a tool +plugins. + + + +KisPoint KisToolStar::starCoordinates(int N, double mx, double my, double x, double y) +{ + double R=0, r=0; + Q_INT32 n=0; + double angle; + + vKisPoint starCoordinatesArray(2*N); + + // the radius of the outer edges + R=sqrt((x-mx)*(x-mx)+(y-my)*(y-my)); + + // the radius of the inner edges + r=R*m_innerOuterRatio/100.0; + + // the angle + angle=-atan2((x-mx),(y-my)); + + //set outer edges + for(n=0;n<N;n++){ + starCoordinatesArray[2*n] = KisPoint(mx+R*cos(n * 2.0 * M_PI / N + angle),my+R*sin(n *2.0 * M_PI / N+angle)); + } + + //set inner edges + for(n=0;n<N;n++){ + starCoordinatesArray[2*n+1] = KisPoint(mx+r*cos((n + 0.5) * 2.0 * M_PI / N + angle),my+r*sin((n +0.5) * 2.0 * M_PI / N + angle)); + } + + return starCoordinatesArray; +} + + + +The createOptionWidget() method is called to create +the option widget that &krita; will show in the tab. Since there is a tool per +input device per view, the state of a tool can be kept in the tool. This +method is only called once: the option widget is stored and retrieved the next +time the tool is activated. + + + +QWidget* KisToolStar::createOptionWidget(QWidget* parent) +{ + QWidget *widget = KisToolShape::createOptionWidget(parent); + + m_optWidget = new WdgToolStar(widget); + Q_CHECK_PTR(m_optWidget); + + m_optWidget->ratioSpinBox->setValue(m_innerOuterRatio); + + QGridLayout *optionLayout = new QGridLayout(widget, 1, 1); + super::addOptionWidgetLayout(optionLayout); + + optionLayout->addWidget(m_optWidget, 0, 0); + + return widget; +} + + + +Tool Conclusions + + +Tools are relatively simple plugins to create. You need to combine the +KisTool and KisCanvasObserver +interfaces in order to effectively create a tool. + + + + + + + +Paint operations + + +PaintOps are one of the more innovative types of plugins in Krita (together +with pluggable colorspaces). A paint operation defines how tools change the +pixels they touch. Airbrush, aliased pencil or antialiased pixel brush: these +are all paint operations. But you could — with a lot of work — +create a paintop that reads Corel Painter XML brush definitions and uses those +to determine how painting is done. + +Paint operations are instantiated when a paint tool receives a +mouseDown event and are deleted when the mouseUp event is +received by a paint tool. In between, the paintop can keep track of previous +positions and other data, such as pressure levels if the user uses a tablet. + +The basic operation of a paint operation is to change pixels at the cursor +position of a paint tool. That can be done only once, or the paint op can +demand to be run at regular intervals, using a timer. The first would be +useful for a pencil-type paint op, the second, of course, for an +airbrush-type paintop. + +Paintops can have a small configuration widget which is placed in a toolbar. +Thus, paintop configuration widgets need to have a horizontal layout of +widgets that are not higher than a toolbar button. Otherwise, &krita; will +look very funny. + +Let’s look at a simple paintop plugin, one that shows a little bit of +programmatic intelligence. First, in the header file, there’s a factory +defined. This factory creates a paintop when the active tool needs one: + + + +public: + KisSmearyOpFactory() {} + virtual ~KisSmearyOpFactory() {} + + virtual KisPaintOp * createOp(const KisPaintOpSettings *settings, KisPainter * painter); + virtual KisID id() { return KisID("paintSmeary", i18n("Smeary Brush")); } + virtual bool userVisible(KisColorSpace * ) { return false; } + virtual QString pixmap() { return ""; } + +}; + + + +The factory also contains the KisID with the public and +private name for the paintop — make sure your paintop’s private name +does not clash with another paintop! — and may optionally return a +pixmap. &krita; can then show the pixmap together with the name for visual +identifcation of your paintop. For instance, a painter’s knife paintop would +have the image of such an implement. + +The implementation of a paintop is very straightforward: + + + +KisSmearyOp::KisSmearyOp(KisPainter * painter) + : KisPaintOp(painter) +{ +} + +KisSmearyOp::~KisSmearyOp() +{ +} +void KisSmearyOp::paintAt(const KisPoint &pos, const KisPaintInformation& info) +{ + + + +The paintAt() method really is where it’s at, with +paintops. This method receives two parameters: the current position (which is +in floats, not in whole pixels) and a +KisPaintInformation object. which contains the +pressure, x and y tilt, and movement vector, and may in the future be extended +with other information. + + + + if (!m_painter->device()) return; + + KisBrush *brush = m_painter->brush(); + + + +A KisBrush is the representation of a Gimp brush file: +that is a mask, either a single mask or a series of masks. Actually, we don’t +use the brush here, except to determine the hotspot under the +cursor. + + + + Q_ASSERT(brush); + + if (!brush) return; + + if (! brush->canPaintFor(info) ) + return; + + KisPaintDeviceSP device = m_painter->device(); + KisColorSpace * colorSpace = device->colorSpace(); + KisColor kc = m_painter->paintColor(); + kc.convertTo(colorSpace); + + KisPoint hotSpot = brush->hotSpot(info); + KisPoint pt = pos - hotSpot; + + // Split the coordinates into integer plus fractional parts. The integer + // is where the dab will be positioned and the fractional part determines + // the sub-pixel positioning. + Q_INT32 x, y; + double xFraction, yFraction; + + splitCoordinate(pt.x(), &x, &xFraction); + splitCoordinate(pt.y(), &y, &yFraction); + + KisPaintDeviceSP dab = new KisPaintDevice(colorSpace, "smeary dab"); + Q_CHECK_PTR(dab); + + + +We don’t change the pixels of a paint device directly: instead we create a +small paint device, a dab, and composite that onto the current paint device. + + + + m_painter->setPressure(info.pressure); + + + +As the comments say, the next bit code does some programmatic work to create +the actual dab. In this case, we draw a number of lines. When I am done with +this paintop, the length, position and thickness of the lines will be +dependent on pressure and paint load, and we’ll have create a stiff, smeary +oilpaint brush. But I haven’t had time to finish this yet. + + + + // Compute the position of the tufts. The tufts are arranged in a line + // perpendicular to the motion of the brush, i.e, the straight line between + // the current position and the previous position. + // The tufts are spread out through the pressure + + KisPoint previousPoint = info.movement.toKisPoint(); + KisVector2D brushVector(-previousPoint.y(), previousPoint.x()); + KisVector2D currentPointVector = KisVector2D(pos); + brushVector.normalize(); + + KisVector2D vl, vr; + + for (int i = 0; i < (NUMBER_OF_TUFTS / 2); ++i) { + // Compute the positions on the new vector. + vl = currentPointVector + i * brushVector; + KisPoint pl = vl.toKisPoint(); + dab->setPixel(pl.roundX(), pl.roundY(), kc); + + vr = currentPointVector - i * brushVector; + KisPoint pr = vr.toKisPoint(); + dab->setPixel(pr.roundX(), pr.roundY(), kc); + } + + vr = vr - vl; + vr.normalize(); + + + +Finally we blt the dab onto the original paint device and tell the painter +that we’ve dirtied a small rectangle of the paint device. + + + + if (m_source->hasSelection()) { + m_painter->bltSelection(x - 32, y - 32, m_painter->compositeOp(), dab.data(), + m_source->selection(), m_painter->opacity(), x - 32, y -32, 64, 64); + } + else { + m_painter->bitBlt(x - 32, y - 32, m_painter->compositeOp(), dab.data(), m_painter->opacity(), x - 32, y -32, 64, 64); + } + + m_painter->addDirtyRect(QRect(x -32, y -32, 64, 64)); +} + + +KisPaintOp * KisSmearyOpFactory::createOp(const KisPaintOpSettings */*settings*/, KisPainter * painter) +{ + KisPaintOp * op = new KisSmearyOp(painter); + Q_CHECK_PTR(op); + return op; +} + + + +That’s all: paintops are easy and fun! + + + + + +View plugins + + +View plugins are the weirdest of the bunch: a view plugin is an ordinary KPart +that can provide a bit of user interface and some functionality. For instance, +the histogram tab is a view plugin, as is the rotate dialog. + + + + + +Import/Export filters + + +&krita; works with the ordinary &koffice; file filter architecture. There is a +tutorial, a bit old, but still useful, at: . It is probably best +to cooperate with the &krita; team when developing file filters and do the +development in the &koffice; filter tree. Note that you can test your filters +without running &krita; using the koconverter utility. + +Filters have two sides: importing and exporting. These are usually two +different plugins that may share some code. + +The important Makefile.am entries are: + + + +service_DATA = krita_XXX_import.desktop krita_XXX_export.desktop +servicedir = $(kde_servicesdir) +kdelnk_DATA = krita_XXX.desktop +kdelnkdir = $(kde_appsdir)/Office +libkritaXXXimport_la_SOURCES = XXXimport.cpp +libkritaXXXexport_la_SOURCES = XXXexport.cpp +METASOURCES = AUTO + + + +Whether you are building an import filter or an export filter, your work always +boils down to implementing the following function: + + + +virtual KoFilter::ConversionStatus convert(const QCString& from, const QCString& to); + + + +It is the settings in the .desktop files +that determine which way a filter converts: + +Import: + + + +X-KDE-Export=application/x-krita +X-KDE-Import=image/x-xcf-gimp +X-KDE-Weight=1 +X-KDE-Library=libkritaXXXimport +ServiceTypes=KOfficeFilter + + + +Export: + + + +X-KDE-Export=image/x-xcf-gimp +X-KDE-Import=application/x-krita +ServiceTypes=KOfficeFilter +Type=Service +X-KDE-Weight=1 +X-KDE-Library=libkritaXXXexport + + + +And yes, the mimetype chosen for the example is a hint. Please, pretty please, +implement an xcf filter? + + + +Import + + +The big problem with import filters is of course your code to read the data on +disk. The boilerplate for calling that code is fairly simple: + + +Note: we really, really should find a way to enable &krita; to keep +a file open and only read data on a as-needed basis, instead of copying the +entire contents to the internal paint device representation. But that would +mean datamanager backends that know about tiff files and so on, and is not +currently implemented. It would be ideal if some file filters could implement +a class provisionally named KisFileDataManager, create +an object of that instance with the current file and pass that to KisDoc. But +&krita; handles storage per layer, not per document, so this would be a hard +refactor to do. + + +KoFilter::ConversionStatus XXXImport::convert(const QCString&, const QCString& to) +{ + if (to != "application/x-krita") + return KoFilter::BadMimeType; + + KisDoc * doc = dynamic_cast<KisDoc*>(m_chain -> outputDocument()); + KisView * view = static_cast<KisView*>(doc -> views().getFirst()); + + QString filename = m_chain -> inputFile(); + + if (!doc) + return KoFilter::CreationError; + + doc -> prepareForImport(); + + if (!filename.isEmpty()) { + + KURL url(filename); + + if (url.isEmpty()) + return KoFilter::FileNotFound; + + KisImageXXXConverter ib(doc, doc -> undoAdapter()); + + if (view != 0) + view -> canvasSubject() -> progressDisplay() -> setSubject(&ib, false, true); + + switch (ib.buildImage(url)) { + case KisImageBuilder_RESULT_UNSUPPORTED: + return KoFilter::NotImplemented; + break; + case KisImageBuilder_RESULT_INVALID_ARG: + return KoFilter::BadMimeType; + break; + case KisImageBuilder_RESULT_NO_URI: + case KisImageBuilder_RESULT_NOT_LOCAL: + return KoFilter::FileNotFound; + break; + case KisImageBuilder_RESULT_BAD_FETCH: + case KisImageBuilder_RESULT_EMPTY: + return KoFilter::ParsingError; + break; + case KisImageBuilder_RESULT_FAILURE: + return KoFilter::InternalError; + break; + case KisImageBuilder_RESULT_OK: + doc -> setCurrentImage( ib.image()); + return KoFilter::OK; + default: + break; + } + + } + return KoFilter::StorageCreationError; +} + + + +This is supposed to be an importfilter, so +if it is not called to convert to a &krita; image, then something is +wrong. +The filter chain already has created an +output document for us. We need to cast it to KisDocM, +because &krita; documents need special treatment. It would not, actually, be +all that bad an idea to check whether the result of the cast is not 0, because +if it is, importing will fail. +If we call this filter from the GUI, we try +to get the view. If there is a view, the conversion code can try to update the +progressbar. +The filter has the filename for our input +file for us. +KisDoc needs to be +prepared for import. Certain settings are initialized and undo is disabled. +Otherwise you could undo the adding of layers performed by the import filter +and that is weird behaviour. +I have chosed to implement the actual +importing code in a separate class that I instantiate here. You can also put +all your code right in this method, but that would be a bit +messy. +My importer returns a statuscode that I +can then use to set the status of the import filter. &koffice; takes care of +showing error messages. +If creating the +KisImage has succeeded we set the document's current +image to our newly created image. Then we are done: return +KoFilter::OK;. + + + + + + + diff --git a/doc/krita/developers-scripting.docbook b/doc/krita/developers-scripting.docbook new file mode 100644 index 00000000..b4ee3a53 --- /dev/null +++ b/doc/krita/developers-scripting.docbook @@ -0,0 +1,534 @@ + +Scripting + + +In &krita;, you can write scripts in Ruby or Python (the availability of the +interpreters might depend on what your distributions or the administrator of +your machine did install). Here you will find a description of the scripting +API. + +Some examples are distributed with &krita;, and you might find them in +/usr/share/apps/krita/scripts (or +/opt/kde/share/apps/krita/scripts). + + + +Variables in the <classname>Krosskritacore</classname> module + + +KritaDocument returns a +Document object +KritaScript returns a +ScriptProgress object + + + +You can retrieve an object using the get function of the +Krosskritacore module, in Ruby you will have to write something like that: + +doc = Krosskritacore::get("KritaDocument") +script = Krosskritacore::get("KritaScript") + + + + + + +Functions in the <classname>Krosskritacore</classname> module + + +Function: getBrush +This function returns a Brush taken from the list of +&krita; resources. It takes one argument: the name of the brush. +For example (in Ruby): + +Krosskritacore::getBrush("Circle (05)") + + +Function: getFilter +This function returns a Filter taken from the list of +&krita; resources. It takes one argument: the name of the filter. +For example (in Ruby): + +Krosskritacore::getFilter("invert") + + +Function: getPattern +This function returns a Pattern taken from the list of +&krita; resources. It takes one argument: the name of the pattern. +For example (in Ruby): + +Krosskritacore::getPattern("Bricks") + + +Function: loadBrush +This function loads a Brush and then returns it. +It takes one argument: the filename of the brush. + +Function: loadPattern +This function loads a Pattern and then returns it. +It takes one argument: the filename of the pattern. + +Function: newCircleBrush +This function returns a Brush with a circular shape. It +takes at least two arguments: width and height. It can take two other +arguments: width of the shading, and height of the shading. If the shading +is not specified, no shading will be used. +For example (in Ruby): + +Krosskritacore::newCircleBrush(10,20) # create a plain circle +Krosskritacore::newCircleBrush(10,20,5,10) # create a gradient + + +Function: newHSVColor +This function returns a new Color with the given HSV +triplet. It takes three arguments: hue component (0 to 255), saturation +component (0 to 255), value component (0 to 255). + +For example (in Ruby): + +Krosskritacore::newHSVColor(255,125,0) + + +Function: newImage +This function returns a new Image. It takes four arguments: +width, height, colorspace id, name of the image. And in return you get an +Image object. +For example (in Ruby): + +Krosskritacore::newImage(10,20, "RGBA", "kikoo") + + +Function: newRectBrush +This function returns a Brush with a rectangular shape. +It takes at least two arguments: width and height. It can take two other +arguments: width of the shading and height of the shading. If the shading is +not specified, no shading will be used. +For example (in Ruby): + + Krosskritacore::newRectBrush(10,20) # create a plain rectangle + Krosskritacore::newRectBrush(10,20,5,10) # create a gradient + + +Function: newRGBColor +This function returns a new Color with the given RGB +triplet. It takes three arguments: red component (0 to 255), blue component (0 to +255), green component (0 to 255). +For example (in Ruby): + +Krosskritacore::newRGBColor(255,0,0) # create a red color +Krosskritacore::newRGBColor(255,255,255) # create a white color + + + + + +Descriptions and function lists for various objects in +<classname>Krosskritacore</classname> + + +Object: PaintLayer + + +Function: beginPainting + +Function: convertToColorspace +Convert the image to a colorspace. This function takes one argument: the name +of the destination colorspace. +For example (in Ruby): + +image.convertToColorspace("CMYK") + + +Function: createHistogram +This function creates a Histogram for this layer. It takes two arguments: +the type of the histogram ("RGB8HISTO"), and 0 if the histogram is linear, or +1 if it is logarithmic. + +Function: createHLineIterator +Create an iterator over a layer, it will iterate on a row. This function takes three arguments: +x (start in the row), y (vertical +position of the row), width of the row. + +Function: createPainter +This function creates a Painter which will allow you to +paint on the layer. + +Function: createRectIterator +Create an iterator over a layer, it will iterate on a rectangular area. This +function takes four arguments: x, y, +width of the rectangle, height of the rectangle. + +Function: createVLineIterator +Create an iterator over a layer, it will iterate on a column. This function +takes three arguments: x (horizontal position of the +column), y (start in the column), height of the column. + +Function: endPainting +This function closes the current undo entry and adds it to the history. + +Function: fastWaveletTransformation +Returns the fast wavelet transformation of the layer. + +Function: fastWaveletUntransformation +Untransforms a fast wavelet into this layer. It takes one argument: a wavelet +object. +For example (in Ruby): + +wavelet = layer.fastWaveletTransformation() +layer.fastWaveletUntransformation(wavelet) + + +Function: getHeight +Return the height of the layer. + +Function: getWidth +Return the width of the layer. + + + +Object: Filter + + +Function: getFilterConfiguration +This function returns the FilterConfiguration +associated with this filter. + +Function: process +This function will apply the filter. It takes at least one argument: the +source layer. You can also use these four aguments: x, +y, width, height. +(x,y,width,height) +defines the rectangular area on which the filter +will be computed. If the rectangle is not defined, then the filter will be +applied on the entire source layer. +For example (in Ruby) + +doc = Krosskritacore::get("KritaDocument") +image = doc.getImage() +layer = image.getActivePaintLayer() +width = layer.getWidth() +height = layer.getHeight() +filter = Krosskritacore::getFilter("invert") +filter.process(layer, layer) +filter.process(layer, layer, 10, 10, 20, 20 ) + + + +Object: FilterConfiguration + + +Function: getProperty +This function returns the value of a parameter of the associated +Filter. It takes one argument: the name of the +parameter. + +Function: setProperty +This function defines a parameter of the associated +Filter. It takes two arguments: the name of the +parameter and the value, whose type depends on the +Filter. + + + +Object: Histogram + +This class allows you to access the histogram of a +PaintLayer. +Example (in Ruby): + + doc = krosskritacore::get("KritaDocument") + image = doc.getImage() + layer = image.getActiveLayer() + histo = layer.createHistogram("RGB8HISTO",0) + min = layer.getMin() * 255 + max = layer.getMax() * 255 + for i in min..max + print layer.getValue(i) + print "\n" + end + + + + +Function: getChannel +Return the selected channel. + +Function: getCount +This function returns the number of pixels used by the histogram. + +Function: getHighest +This function returns the highest value of the histogram. + +Function: getLowest +This function returns the lowest value of the histogram. + +Function: getMax +This function returns the maximum bound of the histogram (values at greater +position than the maximum are null). The value is in the range 0.0 – 1.0. + +Function: getMean +This function returns the mean of the histogram. + +Function: getMin +This function returns the minimum bound of the histogram (values at smaller +position than the minimum are null). The value is in the range 0.0 – 1.0. + +Function: getNumberOfBins +Return the number of bins of this histogram. + +Function: getTotal +This function returns the sum of all values of the histogram. + +Function: getValue +Return the value of a bin of the histogram. This function takes one argument: +index, in the range [0..255]. + +Function: setChannel +Select the channel of the layer on which to get the result of the histogram. +This function takes one argument: the channel number. + + + +Object: ScriptProgress +ScriptProgress is used to manage the progress bar +of the status bar in &krita;. +For example (in Ruby): + +script = Krosskritacore::get("KritaScript") +script.setProgressTotalSteps(1000) +script.setProgressStage("progressive", 0) +for i in 1..900 + script.incProgress() +end +script.setProgressStage("brutal", 1000) + + + +Function: incProgress +This function increments the progress by one step. + +Function: setProgress +This function sets the value of the progress. It takes one argument: +the value of the progress. + +Function: setProgressStage +This function sets the value of the progress and displays the text. + +Function: setProgressTotalSteps +This function set the number of steps that the script will require. It takes +one argument: the maximum value of the progress + + + +Object: Wavelet +This object holds the coefficients of a wavelet transformation of a +PaintLayer. + + +Function: getDepth +Returns the depth of the layer. + +Function: getNCoeff +Returns the value of the Nth coefficient. The function takes one argument: the +index of the coefficient. + +Function: getNumCoeffs +Returns the number of coefficients in this wavelet (= size * size * depth). + +Function: getSize +Returns the size of the wavelet (size = width = height). + +Function: getXYCoeff +Returns the value of a coefficient. The function takes two arguments: +x and y. + +Function: setNCoeff +Set the value of the Nth coefficient. The function takes two arguments: the +index of the coefficient and the new value of the coefficient. + +Function: setXYCoeff +Set the value of a coefficient. The function takes three arguments: +x, y, and the new value of the +coefficient. + + + +Object: Painter + + +Function: convolve +This function applies a convolution kernel to an image. It takes at least three arguments: +a list of kernels (all lists need to have the same size), +factor, and offset. + +The value of a pixel will be given by the following function: K * P / factor + offset, +where K is the kernel and P is the neighbourhood. + +It can take the following optional arguments: borderOp +(control how to convolve the pixels on the border of an image: 0 = use the +default color, 1 = use the pixel on the opposite side of the image, 2 = use +the border pixel, 3 = avoid border pixels), channel (1 for +color, 2 for alpha, 3 for both), x, y, +width, height. + +Function: setFillThreshold +Sets the fill threshold. It takes one argument: the threshold. + +Function: fillColor +Starts filling with a color. It takes two arguments: x and +y. + +Function: fillPattern +Starts filling with a pattern. It takes two arguments: x +and y. + +Function: paintPolyline +This function will paint a polyline. It takes two arguments: a list of x +positions, and a list of y positions. + +Function: paintLine +This function will paint a line. It takes five arguments: +x1, y1, x2, +y2, and pressure. + + +Function: paintBezierCurve +This function will paint a Bezier curve. It takes ten arguments: +x1, y1, p1, +cx1, cy1, cx2, +cx2, x2, y2, +p2, where (x1,y1) is +the start position, p1 is the pressure at the start, +(x2,y2) is the end position, +p2 is the pressure at the end. +(cx1,cy1) and +(cx2,cy2) are the positions of the +control points. + +Function: paintEllipse +This function will paint an ellipse. It takes five arguments: +x1, y1, x2, +y2, pressure, where +(x1,y1) and +(x2,y2) are the positions of the two +centers. + +Function: paintPolygon +This function will paint a polygon. It takes two arguments: a list of x +positions and a list of y positions. + +Function: paintRect +This function will paint a rectangle. It takes five arguments: +x, y, width +height, pressure. + +Function: paintAt +This function will paint at a given position. +It takes three arguments: x, y, +pressure. + +Function: setPaintColor +This function sets the paint color (also called foreground color). It takes +one argument: a Color. + +Function: setBackgroundColor +This function sets the background color. It takes one argument: a +Color. + +Function: setPattern +This function sets the pattern used for filling. It takes one argument: a +Pattern object. + +Function: setBrush +This function sets the brush used for painting. It takes one argument: a +Brush object. + +Function: setPaintOp +This function defines the paint operation. It takes one argument: the name of +the paint operation. + +Function: setDuplicateOffset +This function defines the duplicate offset. It takes two arguments: the +horizontal offset and the vertical offset. + +Function: setOpacity +This function set the opacity of the painting. It takes one argument: the +opacity, in the range 0 to 255. + +Function: setStrokeStyle +This function sets the style of the stroke. It takes one argument: 0 for none, +or 1 for brush. + +Function: setFillStyle +This function sets the fill style of the Painter. +It takes one argument: 0 for none, 1 for fill with foreground color, 2 for +fill with background color, 3 for fill with pattern. + + + +Object: Iterator +This object allows you to change pixel values one by one. +The name of some functions depends on the colorspace, for instance, if the +colorspace of the layer is RGB, you will have setR, +setG and setB, and for +CMYK: setC, setM, +setY and setK. In the documentation +below we will assume that the colorspace is called ABC, with three channels: +A, B and C. + + +Functions: setA, +setB, setC +Those functions take one argument: the new value of one of the channels of +this pixel. + +Function: setABC +Set the value of all channels. This function takes one argument: an array with +the new values for all channels. + +Functions: getA, +getB, getC +Return the value of one of the channels of this pixel. + +Function: getABC +Return an array with the values of all channels. + +Function: darken +Darken a pixel. This function takes at least one argument: +shade (amount used to darken all color channels). This +function can take the following optional argument: +compensation (to limit the darkening). + +Function: invertColor +Invert the color of a pixel. + +Function: next +Increment the position, go to the next pixel. + +Function: isDone +Return true if the iterator is at the end (no more pixels are +available). + + + + + + + +Resources + + +Here are hints or partial lists of resources for &krita;. + +For Brush and Pattern: You can get +the name and the associated brush or pattern from the selector in &krita;'s +toolbar. + +A list of ids for colorspaces in &krita;: LABA, RGBA, RGBA16, RGBAF32, +RGBAF16HALF, LMSAF32, GRAYA, GRAYA16, CMYK, CMYKA16. + + + + + diff --git a/doc/krita/developers.docbook b/doc/krita/developers.docbook new file mode 100644 index 00000000..27549530 --- /dev/null +++ b/doc/krita/developers.docbook @@ -0,0 +1,13 @@ + +Developer's information + + +This chapter contains information for developers or other enthousiasts who +want to get more out of &krita;. + + +&developers-scripting; +&developers-plugins; + + + diff --git a/doc/krita/dialogs-addpalette.png b/doc/krita/dialogs-addpalette.png new file mode 100644 index 00000000..378ba4db Binary files /dev/null and b/doc/krita/dialogs-addpalette.png differ diff --git a/doc/krita/dialogs-blur.png b/doc/krita/dialogs-blur.png new file mode 100644 index 00000000..d41f5844 Binary files /dev/null and b/doc/krita/dialogs-blur.png differ diff --git a/doc/krita/dialogs-brightnesscontrast.png b/doc/krita/dialogs-brightnesscontrast.png new file mode 100644 index 00000000..4dd8673d Binary files /dev/null and b/doc/krita/dialogs-brightnesscontrast.png differ diff --git a/doc/krita/dialogs-bumpmap.png b/doc/krita/dialogs-bumpmap.png new file mode 100644 index 00000000..5a778bef Binary files /dev/null and b/doc/krita/dialogs-bumpmap.png differ diff --git a/doc/krita/dialogs-coloradjustment.png b/doc/krita/dialogs-coloradjustment.png new file mode 100644 index 00000000..8d6dcc29 Binary files /dev/null and b/doc/krita/dialogs-coloradjustment.png differ diff --git a/doc/krita/dialogs-colorrange.png b/doc/krita/dialogs-colorrange.png new file mode 100644 index 00000000..d72961a1 Binary files /dev/null and b/doc/krita/dialogs-colorrange.png differ diff --git a/doc/krita/dialogs-colortoalpha.png b/doc/krita/dialogs-colortoalpha.png new file mode 100644 index 00000000..c51d3878 Binary files /dev/null and b/doc/krita/dialogs-colortoalpha.png differ diff --git a/doc/krita/dialogs-colortransfer.png b/doc/krita/dialogs-colortransfer.png new file mode 100644 index 00000000..ccdfe92b Binary files /dev/null and b/doc/krita/dialogs-colortransfer.png differ diff --git a/doc/krita/dialogs-convertimagetype.png b/doc/krita/dialogs-convertimagetype.png new file mode 100644 index 00000000..54ec4e93 Binary files /dev/null and b/doc/krita/dialogs-convertimagetype.png differ diff --git a/doc/krita/dialogs-convertlayertype.png b/doc/krita/dialogs-convertlayertype.png new file mode 100644 index 00000000..748ef1f9 Binary files /dev/null and b/doc/krita/dialogs-convertlayertype.png differ diff --git a/doc/krita/dialogs-cubism.png b/doc/krita/dialogs-cubism.png new file mode 100644 index 00000000..302a4017 Binary files /dev/null and b/doc/krita/dialogs-cubism.png differ diff --git a/doc/krita/dialogs-customconvolution.png b/doc/krita/dialogs-customconvolution.png new file mode 100644 index 00000000..c3036a05 Binary files /dev/null and b/doc/krita/dialogs-customconvolution.png differ diff --git a/doc/krita/dialogs-documentinformation.png b/doc/krita/dialogs-documentinformation.png new file mode 100644 index 00000000..0df47cdd Binary files /dev/null and b/doc/krita/dialogs-documentinformation.png differ diff --git a/doc/krita/dialogs-dropshadow.png b/doc/krita/dialogs-dropshadow.png new file mode 100644 index 00000000..5539c24c Binary files /dev/null and b/doc/krita/dialogs-dropshadow.png differ diff --git a/doc/krita/dialogs-emboss.png b/doc/krita/dialogs-emboss.png new file mode 100644 index 00000000..cd1ddfff Binary files /dev/null and b/doc/krita/dialogs-emboss.png differ diff --git a/doc/krita/dialogs-filtersgallery.png b/doc/krita/dialogs-filtersgallery.png new file mode 100644 index 00000000..30994265 Binary files /dev/null and b/doc/krita/dialogs-filtersgallery.png differ diff --git a/doc/krita/dialogs-gaussiannoise.png b/doc/krita/dialogs-gaussiannoise.png new file mode 100644 index 00000000..5630a2aa Binary files /dev/null and b/doc/krita/dialogs-gaussiannoise.png differ diff --git a/doc/krita/dialogs-histogram.png b/doc/krita/dialogs-histogram.png new file mode 100644 index 00000000..1f91c1e4 Binary files /dev/null and b/doc/krita/dialogs-histogram.png differ diff --git a/doc/krita/dialogs-imageproperties.png b/doc/krita/dialogs-imageproperties.png new file mode 100644 index 00000000..1d100a2d Binary files /dev/null and b/doc/krita/dialogs-imageproperties.png differ diff --git a/doc/krita/dialogs-imagerestoration.png b/doc/krita/dialogs-imagerestoration.png new file mode 100644 index 00000000..0f5f8286 Binary files /dev/null and b/doc/krita/dialogs-imagerestoration.png differ diff --git a/doc/krita/dialogs-imagesize.png b/doc/krita/dialogs-imagesize.png new file mode 100644 index 00000000..7db26de9 Binary files /dev/null and b/doc/krita/dialogs-imagesize.png differ diff --git a/doc/krita/dialogs-layerproperties.png b/doc/krita/dialogs-layerproperties.png new file mode 100644 index 00000000..1c0852d2 Binary files /dev/null and b/doc/krita/dialogs-layerproperties.png differ diff --git a/doc/krita/dialogs-layersize.png b/doc/krita/dialogs-layersize.png new file mode 100644 index 00000000..2b7bfaa7 Binary files /dev/null and b/doc/krita/dialogs-layersize.png differ diff --git a/doc/krita/dialogs-lenscorrection.png b/doc/krita/dialogs-lenscorrection.png new file mode 100644 index 00000000..39449f4b Binary files /dev/null and b/doc/krita/dialogs-lenscorrection.png differ diff --git a/doc/krita/dialogs-newadjustmentlayer.png b/doc/krita/dialogs-newadjustmentlayer.png new file mode 100644 index 00000000..cb55622b Binary files /dev/null and b/doc/krita/dialogs-newadjustmentlayer.png differ diff --git a/doc/krita/dialogs-newlayer.png b/doc/krita/dialogs-newlayer.png new file mode 100644 index 00000000..07b9b7c8 Binary files /dev/null and b/doc/krita/dialogs-newlayer.png differ diff --git a/doc/krita/dialogs-oilpaint.png b/doc/krita/dialogs-oilpaint.png new file mode 100644 index 00000000..c25e49ff Binary files /dev/null and b/doc/krita/dialogs-oilpaint.png differ diff --git a/doc/krita/dialogs-pixelize.png b/doc/krita/dialogs-pixelize.png new file mode 100644 index 00000000..87e5d72c Binary files /dev/null and b/doc/krita/dialogs-pixelize.png differ diff --git a/doc/krita/dialogs-raindrops.png b/doc/krita/dialogs-raindrops.png new file mode 100644 index 00000000..8fef6e22 Binary files /dev/null and b/doc/krita/dialogs-raindrops.png differ diff --git a/doc/krita/dialogs-randomnoise.png b/doc/krita/dialogs-randomnoise.png new file mode 100644 index 00000000..40cffc10 Binary files /dev/null and b/doc/krita/dialogs-randomnoise.png differ diff --git a/doc/krita/dialogs-randompick.png b/doc/krita/dialogs-randompick.png new file mode 100644 index 00000000..dd71fe13 Binary files /dev/null and b/doc/krita/dialogs-randompick.png differ diff --git a/doc/krita/dialogs-rotateimage.png b/doc/krita/dialogs-rotateimage.png new file mode 100644 index 00000000..569a157d Binary files /dev/null and b/doc/krita/dialogs-rotateimage.png differ diff --git a/doc/krita/dialogs-rotatelayer.png b/doc/krita/dialogs-rotatelayer.png new file mode 100644 index 00000000..8b06e26f Binary files /dev/null and b/doc/krita/dialogs-rotatelayer.png differ diff --git a/doc/krita/dialogs-roundcorners.png b/doc/krita/dialogs-roundcorners.png new file mode 100644 index 00000000..07d3c1d1 Binary files /dev/null and b/doc/krita/dialogs-roundcorners.png differ diff --git a/doc/krita/dialogs-separateimage.png b/doc/krita/dialogs-separateimage.png new file mode 100644 index 00000000..ae245750 Binary files /dev/null and b/doc/krita/dialogs-separateimage.png differ diff --git a/doc/krita/dialogs-shearimage.png b/doc/krita/dialogs-shearimage.png new file mode 100644 index 00000000..0b7c4676 Binary files /dev/null and b/doc/krita/dialogs-shearimage.png differ diff --git a/doc/krita/dialogs-shearlayer.png b/doc/krita/dialogs-shearlayer.png new file mode 100644 index 00000000..1b4fb94b Binary files /dev/null and b/doc/krita/dialogs-shearlayer.png differ diff --git a/doc/krita/dialogs-smalltiles.png b/doc/krita/dialogs-smalltiles.png new file mode 100644 index 00000000..d7640ec5 Binary files /dev/null and b/doc/krita/dialogs-smalltiles.png differ diff --git a/doc/krita/dialogs-sobel.png b/doc/krita/dialogs-sobel.png new file mode 100644 index 00000000..5ce7b6a6 Binary files /dev/null and b/doc/krita/dialogs-sobel.png differ diff --git a/doc/krita/dialogs-substrate.png b/doc/krita/dialogs-substrate.png new file mode 100644 index 00000000..2c9fe069 Binary files /dev/null and b/doc/krita/dialogs-substrate.png differ diff --git a/doc/krita/dialogs-unsharpmask.png b/doc/krita/dialogs-unsharpmask.png new file mode 100644 index 00000000..b26332f9 Binary files /dev/null and b/doc/krita/dialogs-unsharpmask.png differ diff --git a/doc/krita/dialogs-wave.png b/doc/krita/dialogs-wave.png new file mode 100644 index 00000000..929a20c5 Binary files /dev/null and b/doc/krita/dialogs-wave.png differ diff --git a/doc/krita/dialogs-waveletnoise.png b/doc/krita/dialogs-waveletnoise.png new file mode 100644 index 00000000..90b735ec Binary files /dev/null and b/doc/krita/dialogs-waveletnoise.png differ diff --git a/doc/krita/faq.docbook b/doc/krita/faq.docbook new file mode 100644 index 00000000..91ac0b1e --- /dev/null +++ b/doc/krita/faq.docbook @@ -0,0 +1,51 @@ + +Questions and Answers + + +Sometimes, stuff does not work as one would like. &krita; can crash — not all +that often, these days, but still. So you might need some help. The first thing +to do is trying to determine what was going on, exactly. Try to reproduce the +problem and write down what you did before the problem occurred. + +Then you can create a bug report: go to the Help menu and select +Report Bug. That way, we know exactly which version of +&krita; you are using. Please try to make reasonably sure that your problem has +not been reported already! Also, please try to be as complete as possible in +describing your problem. + +You can also, if it is just that you cannot figure out how to do something +that you can do using Photoshop (or any other drawing program) using &krita;, +or if you have some other question, e-mail the &krita; developers at our +mailing list kimageshop@kde.org, or e-mail the program or +documentation maintainer directly at boud@valdyas.org or +sanderkoning@kde.nl, respectively. + + + + +&reporting.bugs; +&updating.documentation; + + + + + diff --git a/doc/krita/index.docbook b/doc/krita/index.docbook new file mode 100644 index 00000000..b5ef3c1b --- /dev/null +++ b/doc/krita/index.docbook @@ -0,0 +1,137 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + + +The &krita; Handbook + + + + +Boudewijn +Rempt + +boud@valdyas.org + + + +Casper +Boemann + +cbr@boemann.dk + + + +Cyrille +Berger + +cberger@cberger.net + + + +Sander +Koning + +sanderkoning@kde.nl + + + + + +2005-2006 +Boudewijn Rempt +Casper Boemann +Cyrille Berger +Sander Koning + + +&FDLNotice; + + + +2006-09-13 +1.6 + + + + + +&krita; is part of the &koffice; package. &krita; is a photo retouching, image +editing application, but above all, a paint application that will allow you to +create original art on your computer as if you were working with paint and +brushes, pencils, pen and ink — or, at least, it will one day. We are +continually working on extending &krita; and making it better in every respect. + + + + +KDE +koffice +Krita +image manipulation +graphics +painting + + + + +&introduction; +&tutorial; +&images; +&views; +&layers; +&selections; +&filters; +&colorspaces; +&commands; +&settings; +&developers; +&faq; +&credits; +&installation; + +&documentation.index; + + + diff --git a/doc/krita/installation.docbook b/doc/krita/installation.docbook new file mode 100644 index 00000000..83158a74 --- /dev/null +++ b/doc/krita/installation.docbook @@ -0,0 +1,73 @@ + +Installation + + +How to obtain &krita; + + + +&install.intro.documentation; + + + + +Requirements + + + + +&krita; depends on the following libraries, apart from what &koffice; needs +itself: + + +Image +Magick — X11 Image Processing and Display +Package +Little CMS +— A free color management system in 100K +OpenEXR + + + + +You can find a list of changes in the ChangeLog file or on +&krita;'s website. + + + + +Compilation and Installation + + + + + +&install.compile.documentation; + + + + + + + diff --git a/doc/krita/introduction.docbook b/doc/krita/introduction.docbook new file mode 100644 index 00000000..7441f80d --- /dev/null +++ b/doc/krita/introduction.docbook @@ -0,0 +1,153 @@ + +Introduction + + +What is &krita;? + +&krita;, part of &koffice;, can do everything you want with images — or +it will be able to one day. Everything from photo retouching, image editing, +and last but not least creating original art on your computer as if you were +working with real paint and brushes, pencils, pen and ink. Every day +&krita; becomes a little better, a little more useful. We are working on it, +anyway. We, that is, Adrian, Bart, Boudewijn, Casper, Cyrille, Michael and Sven. +It could be you, too — whether you would like to help with some artwork +for the user interface, cool ideas for the todo, helpful bug reports, usability +reviews or even actual code, you will not be snubbed by us. + + +&krita; is as much yours as it is ours. It should be fun, innovative, and +experimental — first and foremost a pleasure to use and to hack on. + + + + +Key features + +The most important features &krita; currently has to offer, are: + + +Plugins: Krita is extensible through plugins. There are tools, +colorspaces, paint operations, filters and kpart-based user interface plugins. + + +Scriptable: &krita; is scriptable in Python and Ruby using +Kross, the cross language scripting engine that originated in Kexi. The +scripting is compatible with PyQt/KDE and Korundum for adding GUI +items, such as dialog boxes. + +Color models: &krita; uses lcms for a dependable color +workflow using icc profiles for importing, exporting, selecting paint colors, +printing, cutting and pasting. 8, 16, and 32 bit colorspaces are available +(RGB, CMYK, L*a*b*, ...) and colors can be selected from a color wheel, rgb or +grayscale sliders or with a palette. + +Editing and viewing: Unlimited undo and redo are available. +You can cut, copy and paste between lagers and images, with conversion through +icc profiles if this is necessary. OpenGL is supported for display. The view +can be made fullscreen and can be split. Rulers are available, the +image can be zoomed, and for maximizing the workspace all palette windows can +be hidden in one go. Also a histogram palette is available. + +Images and layers: Layers and entire images can be mirrored, +sheared, rotated and scaled, converted between colorspaces, and layers in +different colorspaces can be merged. An image can be separated into colorspace +channels. + +Layers: Layers can be added, removed, grouped, locked, made +(in)visible, and re-ordered. Adjustment layers (layers which perform a filter +function) can be added as well. A layer can be saved as a separate image and +its colorspace can be changed. + +Tools: Through the innovative paintOp plugin system, all +painting tools (brush, ellipse, line, etc.) can paint aliased, anti-aliased, +erase, airbrush and more. + +Filters: &krita; can multithread the operation of some +filters. Filters can be previewed in the filter gallery. Available filters +include color adjustment, sharpen or blur, emboss, raindrops, and +more. + +Brushes: The GIMP brush shapes can be used, both colored and +grayscale brushes and pipe brushes. Custom brushes can be created, even from +entire layers or images. Colored brushes can also be used as +masks. + + + + +Color management + +One of the most distinguishing features in &krita; is its color management. +If you put two screens side to side, you will notice that there is often a lot +of difference in the way they display colors. Even white, especially white, is +often not the same thing at all. On one screen it can be a dirty yellow, on +another screen a sickly bluish. Very seldom is it a creamy milk-white. The same +holds, unfortunately, for scanners, printers and digital cameras. So, if you +want to see the right colors on screen and on paper, being the colors that you +saw when taking your snapshot, you will have to compensate. + +&krita; can do this for you: in &krita;, a color is (almost) never just a set of +numbers, one for each color channel; it is a set of numbers with information +attached. And that extra information is contained in a profile: your image has a +profile, your scanner has a profile, your camera should have a profile and your +screen has a profile. When passing information from your image to your screen, +the profiles are checked and the correct color is computed. This may cause a +little slowness, now and then, but the result is that you can work with colors, +instead of almost meaningless RGB triplets. + +Available colorspaces are: 8 bit/channel RGB, CMYK, grayscale and wet +watercolors, 16 bit/channel RGB, CMYK, grayscale and L*a*b*, half +RGB, and 32 bit float RGB (HDR) and LMS. + + + + +Image formats + +&krita; currently supports the following image formats, both for importing and +exporting, apart from its own: PNG, TIFF, JPEG, Dicom, XCF, PSD, GIF, BMP, +XPM, Targa, RGB, and OpenEXR. Additionally, &krita; can import +ICO files. PSD (the Photoshop file format) is only supported up to version 6, +from version 7 on, the Photoshop file format is closed. + +Embedded icc profiles and exif information are preserved on export to +supporting file formats. &krita;'s native file format stores icc and exif +information. + + + + + + +About this manual + +We are assuming you have got a good working knowledge of &kde; and of your +operating system. The first chapter will give you a quick tour of &krita;'s +cool features; the other chapters will expand on that information. + + +This manual is not complete. The invitation to join us and help out extends to +the manual, too! + + +Should you have any questions, comments or suggestions, please contact the +documentation maintainer at sanderkoning@kde.nl. + + + + +About the application maintainer + +Hi! I'm Boudewijn Rempt — the current maintainer of &krita;. I was +educated as a linguist, retrained as a database developer, work as a Java +hacker, study theology and I have always liked to paint and sketch a little. +Conspiciously absent in my life have been two important things for a developer +of an image app: mathematics and experience with graphic design. That means that +I am probably not the best person to explain the niceties of using an image +editor or a paint application to you. If you catch me in an error, please don't +hesitate to mail me: boud@valdyas.org. + + + + + diff --git a/doc/krita/mainscreen.png b/doc/krita/mainscreen.png new file mode 100644 index 00000000..f0f775a7 Binary files /dev/null and b/doc/krita/mainscreen.png differ diff --git a/doc/krita/mountains-burn.png b/doc/krita/mountains-burn.png new file mode 100644 index 00000000..679e0ebd Binary files /dev/null and b/doc/krita/mountains-burn.png differ diff --git a/doc/krita/mountains-color.png b/doc/krita/mountains-color.png new file mode 100644 index 00000000..0766e86f Binary files /dev/null and b/doc/krita/mountains-color.png differ diff --git a/doc/krita/mountains-darken.png b/doc/krita/mountains-darken.png new file mode 100644 index 00000000..9f15fe4c Binary files /dev/null and b/doc/krita/mountains-darken.png differ diff --git a/doc/krita/mountains-divide.png b/doc/krita/mountains-divide.png new file mode 100644 index 00000000..1471b2dc Binary files /dev/null and b/doc/krita/mountains-divide.png differ diff --git a/doc/krita/mountains-dodge.png b/doc/krita/mountains-dodge.png new file mode 100644 index 00000000..4904225f Binary files /dev/null and b/doc/krita/mountains-dodge.png differ diff --git a/doc/krita/mountains-hue.png b/doc/krita/mountains-hue.png new file mode 100644 index 00000000..82be57dc Binary files /dev/null and b/doc/krita/mountains-hue.png differ diff --git a/doc/krita/mountains-lighten.png b/doc/krita/mountains-lighten.png new file mode 100644 index 00000000..d8e5a85a Binary files /dev/null and b/doc/krita/mountains-lighten.png differ diff --git a/doc/krita/mountains-multiply.png b/doc/krita/mountains-multiply.png new file mode 100644 index 00000000..e734cfc5 Binary files /dev/null and b/doc/krita/mountains-multiply.png differ diff --git a/doc/krita/mountains-normal.png b/doc/krita/mountains-normal.png new file mode 100644 index 00000000..244bc6ff Binary files /dev/null and b/doc/krita/mountains-normal.png differ diff --git a/doc/krita/mountains-original.png b/doc/krita/mountains-original.png new file mode 100644 index 00000000..7bd1dea9 Binary files /dev/null and b/doc/krita/mountains-original.png differ diff --git a/doc/krita/mountains-overlay.png b/doc/krita/mountains-overlay.png new file mode 100644 index 00000000..bf6cf10f Binary files /dev/null and b/doc/krita/mountains-overlay.png differ diff --git a/doc/krita/mountains-saturation.png b/doc/krita/mountains-saturation.png new file mode 100644 index 00000000..c114891c Binary files /dev/null and b/doc/krita/mountains-saturation.png differ diff --git a/doc/krita/mountains-screen.png b/doc/krita/mountains-screen.png new file mode 100644 index 00000000..2600fbcd Binary files /dev/null and b/doc/krita/mountains-screen.png differ diff --git a/doc/krita/mountains-value.png b/doc/krita/mountains-value.png new file mode 100644 index 00000000..097aa5d1 Binary files /dev/null and b/doc/krita/mountains-value.png differ diff --git a/doc/krita/mountains.png b/doc/krita/mountains.png new file mode 100644 index 00000000..b97ed9ea Binary files /dev/null and b/doc/krita/mountains.png differ diff --git a/doc/krita/newimage.png b/doc/krita/newimage.png new file mode 100644 index 00000000..804f927c Binary files /dev/null and b/doc/krita/newimage.png differ diff --git a/doc/krita/palettes-colors-gray.png b/doc/krita/palettes-colors-gray.png new file mode 100644 index 00000000..9c7d2fab Binary files /dev/null and b/doc/krita/palettes-colors-gray.png differ diff --git a/doc/krita/palettes-colors-hsv.png b/doc/krita/palettes-colors-hsv.png new file mode 100644 index 00000000..78da99c9 Binary files /dev/null and b/doc/krita/palettes-colors-hsv.png differ diff --git a/doc/krita/palettes-colors-palettes.png b/doc/krita/palettes-colors-palettes.png new file mode 100644 index 00000000..4c71dce0 Binary files /dev/null and b/doc/krita/palettes-colors-palettes.png differ diff --git a/doc/krita/palettes-colors-rgb.png b/doc/krita/palettes-colors-rgb.png new file mode 100644 index 00000000..55f1ff4f Binary files /dev/null and b/doc/krita/palettes-colors-rgb.png differ diff --git a/doc/krita/palettes-colors-watercolors.png b/doc/krita/palettes-colors-watercolors.png new file mode 100644 index 00000000..722bf0ff Binary files /dev/null and b/doc/krita/palettes-colors-watercolors.png differ diff --git a/doc/krita/palettes-controlbox-bezier.png b/doc/krita/palettes-controlbox-bezier.png new file mode 100644 index 00000000..b31e87b2 Binary files /dev/null and b/doc/krita/palettes-controlbox-bezier.png differ diff --git a/doc/krita/palettes-controlbox-brush.png b/doc/krita/palettes-controlbox-brush.png new file mode 100644 index 00000000..b3a62f38 Binary files /dev/null and b/doc/krita/palettes-controlbox-brush.png differ diff --git a/doc/krita/palettes-controlbox-colorpicker.png b/doc/krita/palettes-controlbox-colorpicker.png new file mode 100644 index 00000000..02d19266 Binary files /dev/null and b/doc/krita/palettes-controlbox-colorpicker.png differ diff --git a/doc/krita/palettes-controlbox-contiguousfill.png b/doc/krita/palettes-controlbox-contiguousfill.png new file mode 100644 index 00000000..97eb56cf Binary files /dev/null and b/doc/krita/palettes-controlbox-contiguousfill.png differ diff --git a/doc/krita/palettes-controlbox-crop.png b/doc/krita/palettes-controlbox-crop.png new file mode 100644 index 00000000..c8338b77 Binary files /dev/null and b/doc/krita/palettes-controlbox-crop.png differ diff --git a/doc/krita/palettes-controlbox-duplicate.png b/doc/krita/palettes-controlbox-duplicate.png new file mode 100644 index 00000000..6b7f0277 Binary files /dev/null and b/doc/krita/palettes-controlbox-duplicate.png differ diff --git a/doc/krita/palettes-controlbox-ellipse.png b/doc/krita/palettes-controlbox-ellipse.png new file mode 100644 index 00000000..b057604c Binary files /dev/null and b/doc/krita/palettes-controlbox-ellipse.png differ diff --git a/doc/krita/palettes-controlbox-fill.png b/doc/krita/palettes-controlbox-fill.png new file mode 100644 index 00000000..3aed5634 Binary files /dev/null and b/doc/krita/palettes-controlbox-fill.png differ diff --git a/doc/krita/palettes-controlbox-gradient.png b/doc/krita/palettes-controlbox-gradient.png new file mode 100644 index 00000000..e18a8325 Binary files /dev/null and b/doc/krita/palettes-controlbox-gradient.png differ diff --git a/doc/krita/palettes-controlbox-histogram.png b/doc/krita/palettes-controlbox-histogram.png new file mode 100644 index 00000000..9c2c2b65 Binary files /dev/null and b/doc/krita/palettes-controlbox-histogram.png differ diff --git a/doc/krita/palettes-controlbox-line.png b/doc/krita/palettes-controlbox-line.png new file mode 100644 index 00000000..36900c63 Binary files /dev/null and b/doc/krita/palettes-controlbox-line.png differ diff --git a/doc/krita/palettes-controlbox-overview.png b/doc/krita/palettes-controlbox-overview.png new file mode 100644 index 00000000..9bab4336 Binary files /dev/null and b/doc/krita/palettes-controlbox-overview.png differ diff --git a/doc/krita/palettes-controlbox-paintwithfilters.png b/doc/krita/palettes-controlbox-paintwithfilters.png new file mode 100644 index 00000000..da712402 Binary files /dev/null and b/doc/krita/palettes-controlbox-paintwithfilters.png differ diff --git a/doc/krita/palettes-controlbox-polygon.png b/doc/krita/palettes-controlbox-polygon.png new file mode 100644 index 00000000..11347420 Binary files /dev/null and b/doc/krita/palettes-controlbox-polygon.png differ diff --git a/doc/krita/palettes-controlbox-polyline.png b/doc/krita/palettes-controlbox-polyline.png new file mode 100644 index 00000000..36900c63 Binary files /dev/null and b/doc/krita/palettes-controlbox-polyline.png differ diff --git a/doc/krita/palettes-controlbox-rectangle.png b/doc/krita/palettes-controlbox-rectangle.png new file mode 100644 index 00000000..b057604c Binary files /dev/null and b/doc/krita/palettes-controlbox-rectangle.png differ diff --git a/doc/krita/palettes-controlbox-select.png b/doc/krita/palettes-controlbox-select.png new file mode 100644 index 00000000..59cd04ea Binary files /dev/null and b/doc/krita/palettes-controlbox-select.png differ diff --git a/doc/krita/palettes-controlbox-selectcontiguous.png b/doc/krita/palettes-controlbox-selectcontiguous.png new file mode 100644 index 00000000..26c3d4d9 Binary files /dev/null and b/doc/krita/palettes-controlbox-selectcontiguous.png differ diff --git a/doc/krita/palettes-controlbox-selectmagnetic.png b/doc/krita/palettes-controlbox-selectmagnetic.png new file mode 100644 index 00000000..798434f8 Binary files /dev/null and b/doc/krita/palettes-controlbox-selectmagnetic.png differ diff --git a/doc/krita/palettes-controlbox-selectsimilar.png b/doc/krita/palettes-controlbox-selectsimilar.png new file mode 100644 index 00000000..6043a28e Binary files /dev/null and b/doc/krita/palettes-controlbox-selectsimilar.png differ diff --git a/doc/krita/palettes-controlbox-star.png b/doc/krita/palettes-controlbox-star.png new file mode 100644 index 00000000..e963b2d5 Binary files /dev/null and b/doc/krita/palettes-controlbox-star.png differ diff --git a/doc/krita/palettes-controlbox-text.png b/doc/krita/palettes-controlbox-text.png new file mode 100644 index 00000000..42043596 Binary files /dev/null and b/doc/krita/palettes-controlbox-text.png differ diff --git a/doc/krita/palettes-controlbox-transform.png b/doc/krita/palettes-controlbox-transform.png new file mode 100644 index 00000000..4c4c95d7 Binary files /dev/null and b/doc/krita/palettes-controlbox-transform.png differ diff --git a/doc/krita/palettes-layers-layers.png b/doc/krita/palettes-layers-layers.png new file mode 100644 index 00000000..4ca4ff8e Binary files /dev/null and b/doc/krita/palettes-layers-layers.png differ diff --git a/doc/krita/palettes-layers-scriptsmanager.png b/doc/krita/palettes-layers-scriptsmanager.png new file mode 100644 index 00000000..b0092993 Binary files /dev/null and b/doc/krita/palettes-layers-scriptsmanager.png differ diff --git a/doc/krita/preferences-color.png b/doc/krita/preferences-color.png new file mode 100644 index 00000000..9db8e687 Binary files /dev/null and b/doc/krita/preferences-color.png differ diff --git a/doc/krita/preferences-display.png b/doc/krita/preferences-display.png new file mode 100644 index 00000000..b7d245f5 Binary files /dev/null and b/doc/krita/preferences-display.png differ diff --git a/doc/krita/preferences-general.png b/doc/krita/preferences-general.png new file mode 100644 index 00000000..f8322529 Binary files /dev/null and b/doc/krita/preferences-general.png differ diff --git a/doc/krita/preferences-grid.png b/doc/krita/preferences-grid.png new file mode 100644 index 00000000..6bb9ed95 Binary files /dev/null and b/doc/krita/preferences-grid.png differ diff --git a/doc/krita/preferences-performance.png b/doc/krita/preferences-performance.png new file mode 100644 index 00000000..2884030b Binary files /dev/null and b/doc/krita/preferences-performance.png differ diff --git a/doc/krita/preferences-sidebar.png b/doc/krita/preferences-sidebar.png new file mode 100644 index 00000000..a7fcff98 Binary files /dev/null and b/doc/krita/preferences-sidebar.png differ diff --git a/doc/krita/preferences-tablet.png b/doc/krita/preferences-tablet.png new file mode 100644 index 00000000..6ec6f8c0 Binary files /dev/null and b/doc/krita/preferences-tablet.png differ diff --git a/doc/krita/settings.docbook b/doc/krita/settings.docbook new file mode 100644 index 00000000..fd72d68d --- /dev/null +++ b/doc/krita/settings.docbook @@ -0,0 +1,229 @@ + + +Settings + +This chapter describes the various settings that affect the way &krita; +functions and looks. + + +The <guilabel>Preferences</guilabel> dialog + + +A number of options to configure &krita; are available via the +Preferences dialog, which is available via +SettingsConfigure +&krita;.... The dialog is divided into several +sections, which you can open via the sidebar at the left, shown below. + + + + +The available Preferences sections + + + + + +The available Preferences sections + + + + + + + +The <guilabel>General</guilabel> section + + + +The General section + + + + + +The General section + + + + + + + +This section offers three options. First of all, the setting in the +Cursor shape: dropdown box determines what the drawing +cursor looks like. You can choose between a cursor resembling the actual tool +you are working with, a normal cursor, a crosshair, and a brush-shaped cursor. +Then you can select the Palette Behavior. You can set +here when palettes may be docked (set aside at a window +border): always (Allow docking), never +(Allow only floating), or when there is enough space +(Allow docking only on large screens). The last option is +Palette font size: which determines the text size used in +the palettes. Set this to a larger value if you have trouble reading the text, +with the side effect that the palettes will take more space. + + + + + +The <guilabel>Display</guilabel> section + + + +The Display section + + + + + +The Display section + + + + + + + +This section contains just one option. If your graphics card and driver have +OpenGL support, you can enable it here to make drawing faster (the +processor of yor graphics card will take over part of the calculations). Be +warned, though: there are a few cases where enabling OpenGL is known to +introduce erratic behavior. + + + + + +The <guilabel>Color Management</guilabel> section + + + +The Color Management section + + + + + +The Color Management section + + + + + + + +Here you can set various options related to colorspaces in rendering, editing +and printing of images. The topmost option can be used to set the default +color model for creating new images (useful if you usually want to create CMYK +images, for instance). Use the Display options to let +&krita; know what color profile your monitor uses, and how rendering should be +done. Under Printing, you can set the color model and +profile for your printer. The next option determines what &krita; should do +when you paste an image into it that was copied from another application. If +Use Blackpoint compensation is checked, whenever a +colorspace conversion is needed, the black points of the source and +destination colorspaces are matched. + + + + + +The <guilabel>Performance</guilabel> section + + + +The Performance section + + + + + +The Performance section + + + + + + + +Two options are available here. The Maximum number of tiles kept in +memory setting indicates how many tiles (image subparts) &krita; +will keep in memory. The default setting should be reasonable, if you are low +or very high on memory, you may want to decrease or increase this option, +respectively. The Swappiness: option determines how eager +&krita; will be to swap to disk. + + + + + +The <guilabel>Tablet</guilabel> section + + + +The Tablet section + + + + + +The Tablet section + + + + + + + +If you have a tablet device attached, you can enable it and set its pressure +sensitivity in this section. + +You need to activate the tablet devices you want to use with &krita;. There +are three supported devices: the cursor, the eraser and the stylus. You can +activate them using the tablet sections. Only use the configuration options of +a device if you use a non-Wacom tablet, and if the behavior of the tablet is +unexpected, like moving when you press on the tablet for instance. In this +situation, you can use the dialog to make sure you have a correct interaction: +values (position, pressure, tilt...) are sent from the tablet to the computer +in a given order, it might happen that some tablets do not use the default +order. You can set this in the configuration options of a device. + + + + + +The <guilabel>Grid</guilabel> section + + + +The Grid section + + + + + +The Grid section + + + + + + + +In this section, you can fine-tune &krita;'s grid. The line styles for the +grid can be set in the Styles option set. +Colors allows you to choose the line colors for the grid. +The horizontal and vertical spacing between the main lines can be set under +Spacing, as well as the amount of subdivisions (in how +many smaller parts a grid section is subdivided). Furthermore you can set the +Offset: usually the grid is painted starting at the top +left corner, if you want the first main grid lines not to start there, you can +enter an offset (displacement) here. + + + + + + + diff --git a/doc/krita/tool-bezier-example.png b/doc/krita/tool-bezier-example.png new file mode 100644 index 00000000..818774a7 Binary files /dev/null and b/doc/krita/tool-bezier-example.png differ diff --git a/doc/krita/tool-bezier-example2.png b/doc/krita/tool-bezier-example2.png new file mode 100644 index 00000000..07a4eb65 Binary files /dev/null and b/doc/krita/tool-bezier-example2.png differ diff --git a/doc/krita/tool-bezier-example3.png b/doc/krita/tool-bezier-example3.png new file mode 100644 index 00000000..6ff03222 Binary files /dev/null and b/doc/krita/tool-bezier-example3.png differ diff --git a/doc/krita/tool-bezier.png b/doc/krita/tool-bezier.png new file mode 100644 index 00000000..84e3d75b Binary files /dev/null and b/doc/krita/tool-bezier.png differ diff --git a/doc/krita/tool-brush.png b/doc/krita/tool-brush.png new file mode 100644 index 00000000..f2f917c5 Binary files /dev/null and b/doc/krita/tool-brush.png differ diff --git a/doc/krita/tool-colorpicker.png b/doc/krita/tool-colorpicker.png new file mode 100644 index 00000000..285e04f6 Binary files /dev/null and b/doc/krita/tool-colorpicker.png differ diff --git a/doc/krita/tool-contiguousfill.png b/doc/krita/tool-contiguousfill.png new file mode 100644 index 00000000..a2c087f9 Binary files /dev/null and b/doc/krita/tool-contiguousfill.png differ diff --git a/doc/krita/tool-crop.png b/doc/krita/tool-crop.png new file mode 100644 index 00000000..05e80ae1 Binary files /dev/null and b/doc/krita/tool-crop.png differ diff --git a/doc/krita/tool-duplicate.png b/doc/krita/tool-duplicate.png new file mode 100644 index 00000000..604e4210 Binary files /dev/null and b/doc/krita/tool-duplicate.png differ diff --git a/doc/krita/tool-ellipse.png b/doc/krita/tool-ellipse.png new file mode 100644 index 00000000..77fdda70 Binary files /dev/null and b/doc/krita/tool-ellipse.png differ diff --git a/doc/krita/tool-eraseselection.png b/doc/krita/tool-eraseselection.png new file mode 100644 index 00000000..3ad47747 Binary files /dev/null and b/doc/krita/tool-eraseselection.png differ diff --git a/doc/krita/tool-gradient.png b/doc/krita/tool-gradient.png new file mode 100644 index 00000000..4c110075 Binary files /dev/null and b/doc/krita/tool-gradient.png differ diff --git a/doc/krita/tool-line.png b/doc/krita/tool-line.png new file mode 100644 index 00000000..60dfa84d Binary files /dev/null and b/doc/krita/tool-line.png differ diff --git a/doc/krita/tool-move.png b/doc/krita/tool-move.png new file mode 100644 index 00000000..cf019e7a Binary files /dev/null and b/doc/krita/tool-move.png differ diff --git a/doc/krita/tool-paintselection.png b/doc/krita/tool-paintselection.png new file mode 100644 index 00000000..83ae74e4 Binary files /dev/null and b/doc/krita/tool-paintselection.png differ diff --git a/doc/krita/tool-paintwithfilters-example.png b/doc/krita/tool-paintwithfilters-example.png new file mode 100644 index 00000000..15c8e1c8 Binary files /dev/null and b/doc/krita/tool-paintwithfilters-example.png differ diff --git a/doc/krita/tool-paintwithfilters.png b/doc/krita/tool-paintwithfilters.png new file mode 100644 index 00000000..dc8815ae Binary files /dev/null and b/doc/krita/tool-paintwithfilters.png differ diff --git a/doc/krita/tool-pan.png b/doc/krita/tool-pan.png new file mode 100644 index 00000000..1470a167 Binary files /dev/null and b/doc/krita/tool-pan.png differ diff --git a/doc/krita/tool-perspectivegrid.png b/doc/krita/tool-perspectivegrid.png new file mode 100644 index 00000000..f2815380 Binary files /dev/null and b/doc/krita/tool-perspectivegrid.png differ diff --git a/doc/krita/tool-perspectivetransform.png b/doc/krita/tool-perspectivetransform.png new file mode 100644 index 00000000..fbcbf59d Binary files /dev/null and b/doc/krita/tool-perspectivetransform.png differ diff --git a/doc/krita/tool-polygon.png b/doc/krita/tool-polygon.png new file mode 100644 index 00000000..98f4d711 Binary files /dev/null and b/doc/krita/tool-polygon.png differ diff --git a/doc/krita/tool-polyline.png b/doc/krita/tool-polyline.png new file mode 100644 index 00000000..5a688216 Binary files /dev/null and b/doc/krita/tool-polyline.png differ diff --git a/doc/krita/tool-rectangle.png b/doc/krita/tool-rectangle.png new file mode 100644 index 00000000..27c9dfd1 Binary files /dev/null and b/doc/krita/tool-rectangle.png differ diff --git a/doc/krita/tool-selectbezier.png b/doc/krita/tool-selectbezier.png new file mode 100644 index 00000000..4604f957 Binary files /dev/null and b/doc/krita/tool-selectbezier.png differ diff --git a/doc/krita/tool-selectcontiguous.png b/doc/krita/tool-selectcontiguous.png new file mode 100644 index 00000000..07339ef1 Binary files /dev/null and b/doc/krita/tool-selectcontiguous.png differ diff --git a/doc/krita/tool-selectelliptical.png b/doc/krita/tool-selectelliptical.png new file mode 100644 index 00000000..5ae5f504 Binary files /dev/null and b/doc/krita/tool-selectelliptical.png differ diff --git a/doc/krita/tool-selectmagnetic.png b/doc/krita/tool-selectmagnetic.png new file mode 100644 index 00000000..77d3a49d Binary files /dev/null and b/doc/krita/tool-selectmagnetic.png differ diff --git a/doc/krita/tool-selectoutline.png b/doc/krita/tool-selectoutline.png new file mode 100644 index 00000000..6258c37f Binary files /dev/null and b/doc/krita/tool-selectoutline.png differ diff --git a/doc/krita/tool-selectpolygonal.png b/doc/krita/tool-selectpolygonal.png new file mode 100644 index 00000000..5e390dee Binary files /dev/null and b/doc/krita/tool-selectpolygonal.png differ diff --git a/doc/krita/tool-selectrectangular.png b/doc/krita/tool-selectrectangular.png new file mode 100644 index 00000000..1ad6718e Binary files /dev/null and b/doc/krita/tool-selectrectangular.png differ diff --git a/doc/krita/tool-selectsimilar.png b/doc/krita/tool-selectsimilar.png new file mode 100644 index 00000000..cfa8b235 Binary files /dev/null and b/doc/krita/tool-selectsimilar.png differ diff --git a/doc/krita/tool-star.png b/doc/krita/tool-star.png new file mode 100644 index 00000000..7dab3218 Binary files /dev/null and b/doc/krita/tool-star.png differ diff --git a/doc/krita/tool-text.png b/doc/krita/tool-text.png new file mode 100644 index 00000000..da97cda6 Binary files /dev/null and b/doc/krita/tool-text.png differ diff --git a/doc/krita/tool-transform.png b/doc/krita/tool-transform.png new file mode 100644 index 00000000..fded6ebe Binary files /dev/null and b/doc/krita/tool-transform.png differ diff --git a/doc/krita/tool-zoom.png b/doc/krita/tool-zoom.png new file mode 100644 index 00000000..e30f00d9 Binary files /dev/null and b/doc/krita/tool-zoom.png differ diff --git a/doc/krita/toolbar-brushes-brushshapes-autobrush.png b/doc/krita/toolbar-brushes-brushshapes-autobrush.png new file mode 100644 index 00000000..5ea48486 Binary files /dev/null and b/doc/krita/toolbar-brushes-brushshapes-autobrush.png differ diff --git a/doc/krita/toolbar-brushes-brushshapes-custombrush.png b/doc/krita/toolbar-brushes-brushshapes-custombrush.png new file mode 100644 index 00000000..4c89af8d Binary files /dev/null and b/doc/krita/toolbar-brushes-brushshapes-custombrush.png differ diff --git a/doc/krita/toolbar-brushes-brushshapes-predefined.png b/doc/krita/toolbar-brushes-brushshapes-predefined.png new file mode 100644 index 00000000..ddcb7d1b Binary files /dev/null and b/doc/krita/toolbar-brushes-brushshapes-predefined.png differ diff --git a/doc/krita/toolbar-brushes-gradients.png b/doc/krita/toolbar-brushes-gradients.png new file mode 100644 index 00000000..f466a81d Binary files /dev/null and b/doc/krita/toolbar-brushes-gradients.png differ diff --git a/doc/krita/toolbar-brushes-patterns-custompattern.png b/doc/krita/toolbar-brushes-patterns-custompattern.png new file mode 100644 index 00000000..90f76a23 Binary files /dev/null and b/doc/krita/toolbar-brushes-patterns-custompattern.png differ diff --git a/doc/krita/toolbar-brushes-patterns.png b/doc/krita/toolbar-brushes-patterns.png new file mode 100644 index 00000000..5e64f461 Binary files /dev/null and b/doc/krita/toolbar-brushes-patterns.png differ diff --git a/doc/krita/toolbar-brushesandstuff.png b/doc/krita/toolbar-brushesandstuff.png new file mode 100644 index 00000000..3915acd8 Binary files /dev/null and b/doc/krita/toolbar-brushesandstuff.png differ diff --git a/doc/krita/toolbar-edit.png b/doc/krita/toolbar-edit.png new file mode 100644 index 00000000..aef82505 Binary files /dev/null and b/doc/krita/toolbar-edit.png differ diff --git a/doc/krita/toolbar-file.png b/doc/krita/toolbar-file.png new file mode 100644 index 00000000..302e5c1c Binary files /dev/null and b/doc/krita/toolbar-file.png differ diff --git a/doc/krita/toolbar-krita.png b/doc/krita/toolbar-krita.png new file mode 100644 index 00000000..d1c6c4b9 Binary files /dev/null and b/doc/krita/toolbar-krita.png differ diff --git a/doc/krita/toolbar-navigation.png b/doc/krita/toolbar-navigation.png new file mode 100644 index 00000000..f1dd911c Binary files /dev/null and b/doc/krita/toolbar-navigation.png differ diff --git a/doc/krita/toolbar-transformationtools.png b/doc/krita/toolbar-transformationtools.png new file mode 100644 index 00000000..32a8125f Binary files /dev/null and b/doc/krita/toolbar-transformationtools.png differ diff --git a/doc/krita/toolbars-button-zoomin.png b/doc/krita/toolbars-button-zoomin.png new file mode 100644 index 00000000..bdc0746c Binary files /dev/null and b/doc/krita/toolbars-button-zoomin.png differ diff --git a/doc/krita/toolbars-button-zoomout.png b/doc/krita/toolbars-button-zoomout.png new file mode 100644 index 00000000..4d002a6a Binary files /dev/null and b/doc/krita/toolbars-button-zoomout.png differ diff --git a/doc/krita/tutorial-quick-starts.docbook b/doc/krita/tutorial-quick-starts.docbook new file mode 100644 index 00000000..05f36729 --- /dev/null +++ b/doc/krita/tutorial-quick-starts.docbook @@ -0,0 +1,183 @@ + +Quick start guides + +Crop an area and save it + +Aim: from a picture, crop an area and save that area in a new file + +Open &krita; with the original picture. + + +The original picture + + + + +The original picture + + + +Select the Select Rectangular tool in the +&krita; toolbar. + + +The Select a rectangular area tool + + + + +The Select a rectangular area tool + + + +Select the area you want to make a new picture with. &krita; makes the +outside area grey. + + +The selected area + + + + +The selected area + + + +Then use the +EditCopy +menu item or &Ctrl;C to +copy the selected area. + +Click again on the Edit menu. +Use the Paste into new image item. + + +The Edit menu + + + + +The Edit menu + + + +&krita; opens a new window with the selected area as new image. + + +The new image + + + + +The new image + + + +Save the new image. + + + +Draw a rectangle on your picture + +Aim: draw a coloured rectangle on your picture + +Open &krita; with the original picture. My picture consists of a view of +a toolbar in which I want to point an icon by putting a red rectangle around +it. + + +The original picture + + + + +The original picture + + + +Enable the Brushes and Stuff toolbar using +SettingsToolbars +menu. +Also make sure the palettes are viewed. If not, use the +ViewPalettes +menu. + + +&krita; view + + + + +&krita; view + + + +Click on the Brush Shapes icon in the +Brushes and Stuff toolbar. + + +The Brush Shapes icon + + + + +The Brush Shapes icon + + + +Select which brush shape you want to use among the predefined +brushes. + + +Selecting a brush shape + + + + +Selecting a brush shape + + + +Select the drawing shape on the &krita; toolbar. I choose a +rectangle. + + +Selecting the Rectangle icon + + + + +Selecting the Rectangle icon + + + +In the Colors palette, select the color you want by clicking on one of the +tabs and then choosing the color. + + +Choosing the color + + + + +Choosing the color + + + +Finally draw your shape on your picture and save the new picture! + + +Drawing + + + + +Drawing + + + +Thanks go to Anne-Marie Mahfouf for providing this tutorial. + + + + diff --git a/doc/krita/tutorial-quick-starts1.png b/doc/krita/tutorial-quick-starts1.png new file mode 100644 index 00000000..9db94c65 Binary files /dev/null and b/doc/krita/tutorial-quick-starts1.png differ diff --git a/doc/krita/tutorial-quick-starts10.png b/doc/krita/tutorial-quick-starts10.png new file mode 100644 index 00000000..7df8da5b Binary files /dev/null and b/doc/krita/tutorial-quick-starts10.png differ diff --git a/doc/krita/tutorial-quick-starts11.png b/doc/krita/tutorial-quick-starts11.png new file mode 100644 index 00000000..35ea5696 Binary files /dev/null and b/doc/krita/tutorial-quick-starts11.png differ diff --git a/doc/krita/tutorial-quick-starts12.png b/doc/krita/tutorial-quick-starts12.png new file mode 100644 index 00000000..c8647140 Binary files /dev/null and b/doc/krita/tutorial-quick-starts12.png differ diff --git a/doc/krita/tutorial-quick-starts2.png b/doc/krita/tutorial-quick-starts2.png new file mode 100644 index 00000000..450c82a5 Binary files /dev/null and b/doc/krita/tutorial-quick-starts2.png differ diff --git a/doc/krita/tutorial-quick-starts3.png b/doc/krita/tutorial-quick-starts3.png new file mode 100644 index 00000000..e6e65d9e Binary files /dev/null and b/doc/krita/tutorial-quick-starts3.png differ diff --git a/doc/krita/tutorial-quick-starts4.png b/doc/krita/tutorial-quick-starts4.png new file mode 100644 index 00000000..0d5f1a20 Binary files /dev/null and b/doc/krita/tutorial-quick-starts4.png differ diff --git a/doc/krita/tutorial-quick-starts5.png b/doc/krita/tutorial-quick-starts5.png new file mode 100644 index 00000000..877d07c6 Binary files /dev/null and b/doc/krita/tutorial-quick-starts5.png differ diff --git a/doc/krita/tutorial-quick-starts6.png b/doc/krita/tutorial-quick-starts6.png new file mode 100644 index 00000000..b1b4173c Binary files /dev/null and b/doc/krita/tutorial-quick-starts6.png differ diff --git a/doc/krita/tutorial-quick-starts7.png b/doc/krita/tutorial-quick-starts7.png new file mode 100644 index 00000000..42477b57 Binary files /dev/null and b/doc/krita/tutorial-quick-starts7.png differ diff --git a/doc/krita/tutorial-quick-starts8.png b/doc/krita/tutorial-quick-starts8.png new file mode 100644 index 00000000..314467f7 Binary files /dev/null and b/doc/krita/tutorial-quick-starts8.png differ diff --git a/doc/krita/tutorial-quick-starts9.png b/doc/krita/tutorial-quick-starts9.png new file mode 100644 index 00000000..a42b2d51 Binary files /dev/null and b/doc/krita/tutorial-quick-starts9.png differ diff --git a/doc/krita/tutorial-select-layer-1.png b/doc/krita/tutorial-select-layer-1.png new file mode 100644 index 00000000..0ebdfe16 Binary files /dev/null and b/doc/krita/tutorial-select-layer-1.png differ diff --git a/doc/krita/tutorial-select-layer-10.png b/doc/krita/tutorial-select-layer-10.png new file mode 100644 index 00000000..0b8f6750 Binary files /dev/null and b/doc/krita/tutorial-select-layer-10.png differ diff --git a/doc/krita/tutorial-select-layer-11.png b/doc/krita/tutorial-select-layer-11.png new file mode 100644 index 00000000..589f049b Binary files /dev/null and b/doc/krita/tutorial-select-layer-11.png differ diff --git a/doc/krita/tutorial-select-layer-12.png b/doc/krita/tutorial-select-layer-12.png new file mode 100644 index 00000000..045ecc55 Binary files /dev/null and b/doc/krita/tutorial-select-layer-12.png differ diff --git a/doc/krita/tutorial-select-layer-13.png b/doc/krita/tutorial-select-layer-13.png new file mode 100644 index 00000000..fb715dfd Binary files /dev/null and b/doc/krita/tutorial-select-layer-13.png differ diff --git a/doc/krita/tutorial-select-layer-2.png b/doc/krita/tutorial-select-layer-2.png new file mode 100644 index 00000000..8fc7f9a0 Binary files /dev/null and b/doc/krita/tutorial-select-layer-2.png differ diff --git a/doc/krita/tutorial-select-layer-3.png b/doc/krita/tutorial-select-layer-3.png new file mode 100644 index 00000000..bc1ce878 Binary files /dev/null and b/doc/krita/tutorial-select-layer-3.png differ diff --git a/doc/krita/tutorial-select-layer-4.png b/doc/krita/tutorial-select-layer-4.png new file mode 100644 index 00000000..37f971d0 Binary files /dev/null and b/doc/krita/tutorial-select-layer-4.png differ diff --git a/doc/krita/tutorial-select-layer-5.png b/doc/krita/tutorial-select-layer-5.png new file mode 100644 index 00000000..77658e0b Binary files /dev/null and b/doc/krita/tutorial-select-layer-5.png differ diff --git a/doc/krita/tutorial-select-layer-6.png b/doc/krita/tutorial-select-layer-6.png new file mode 100644 index 00000000..85d78dd5 Binary files /dev/null and b/doc/krita/tutorial-select-layer-6.png differ diff --git a/doc/krita/tutorial-select-layer-7.png b/doc/krita/tutorial-select-layer-7.png new file mode 100644 index 00000000..deca6a10 Binary files /dev/null and b/doc/krita/tutorial-select-layer-7.png differ diff --git a/doc/krita/tutorial-select-layer-8.png b/doc/krita/tutorial-select-layer-8.png new file mode 100644 index 00000000..576a9081 Binary files /dev/null and b/doc/krita/tutorial-select-layer-8.png differ diff --git a/doc/krita/tutorial-select-layer-9.png b/doc/krita/tutorial-select-layer-9.png new file mode 100644 index 00000000..79e846ce Binary files /dev/null and b/doc/krita/tutorial-select-layer-9.png differ diff --git a/doc/krita/tutorial-select-layer-sample.png b/doc/krita/tutorial-select-layer-sample.png new file mode 100644 index 00000000..b6294b1b Binary files /dev/null and b/doc/krita/tutorial-select-layer-sample.png differ diff --git a/doc/krita/tutorial-select-layer.docbook b/doc/krita/tutorial-select-layer.docbook new file mode 100644 index 00000000..3e60bc88 --- /dev/null +++ b/doc/krita/tutorial-select-layer.docbook @@ -0,0 +1,263 @@ + +A Small selections and layers tutorial + + + +The starting image + + + + + +The starting image + + + + + + +The image above is the image we will work with. Start krita with this +image (in the documentation folder +$KDEDIR/share/doc/HTML/en/krita/tutorial-select-layer-sample.png) +and save it to your Home folder (by choosing Save Image As...). + +Then open it in &krita; — your screen will look a bit like this (we have +zoomed in): + + + +Krita with the starting image + + + + + +The starting image + + + + + + +Now try to select the outline of the head with the Select Outline tool: + + + +The Select Outline tool + + + + + +The Select Outline tool + + + + + + +After you select it, it should look a bit like this picture: + + + +The picture after selecting the head + + + + + +The picture after selecting the head + + + + + + +If you accidently select too much, you can cut that part easily off by switching the tool to Subtract mode: + + + +The Subtract mode + + + + + +The Subtract mode + + + + + + +Now it's time to make the edges of the selection a bit fuzzy. This can be done by applying Feather to the selection. + + + +Feather selection + + + + + +Feather selection + + + + + + +Now cut the selection, using +EditCut. +Delete the current layer with +LayerRemove +Layer. Paste your selection, with +EditPaste. +Now we give ourselves a bit more room to work in by resizing the image a bit. +Use the ImageChange Image +Size... dialog for this. + + + +The Image Size dialog + + + + + +The Image Size dialog + + + + + + +Add a new layer, and place it below the old layer. You do this by selecting +the new layer in the layerbox, and then pressing the little 'down' arrow at the bottom. +Now we are going to select the area around the head with a contiguous select +(the tool has a selection-with-bucketfill icon at the border). + + + +The Select Contiguous tool + + + + + +The Select Contiguous tool + + + + + + +Make sure to select Sample merged in the tool options: + + + +The Sample merged option + + + + + +The Sample merged option + + + + + + +Feather the selection again, and invert it. +Select the Contiguous Fill tool (this is a different tool than +the Contiguous Select tool) and use it on the layer. + + + +The Contiguous Fill tool + + + + + +The Contiguous Fill tool + + + + + + +Deselect with SelectDeselect. +You'll notice some artefacts of the feathering at the sides. You can select them easily with a rectangular selection and then cut them. + + + +The Select Rectangular tool + + + + + +The Select Rectangular tool + + + + + + +Move the shadow layer a bit down and to the right to make it look nice. + + + +Moving the shadow layer + + + + + +Moving the shadow layer + + + + + + +Now you can use the Crop tool to make the image better fit around the head. + + + +The Crop tool + + + + + +The Crop tool + + + + + + +Save the image, and you're done :-) + + + +The resulting image + + + + + +The resulting image + + + + + + +Thanks go to Bart Coppens for providing this tutorial. The original is available at http://www.bartcoppens.be/krita/hackergotchi.html. + + + diff --git a/doc/krita/tutorial-starting.docbook b/doc/krita/tutorial-starting.docbook new file mode 100644 index 00000000..f720a88c --- /dev/null +++ b/doc/krita/tutorial-starting.docbook @@ -0,0 +1,117 @@ + +Starting to know &krita; + + +So, let's show you all the niceties. You can start &krita; either on its own +or from the &koffice; shell. In your &kde; menus, &krita; should be placed +either under Graphics or under Office — it depends a bit on who packaged +&koffice; for you. Or do what I do: press +&Alt;F2 (which opens the +minicli), type krita and +press OK. + + + +A little later, you'll be greeted by a dialog: + + + + +The Create Document dialog + + + + + +The Create Document dialog + + + + + + + +This is standard for &koffice;: you can create a new document, choose a +document from among your files or select a document you had opened in an earlier +session. We have got a bunch of templates here, ordered by color model. &krita; +is a very flexible application and can handle many different types of images: +CMYK images for printers, RGB images for +the web, RGB images with high channel depths for +photographers, watercolor images for painters — and more. For now, choose +Custom Document. That will allow +us to see the New Image dialog box: + + + + +The New Image dialog + + + + + +The New Image dialog + + + + + + + +Here you can give your document a name, determine the dimensions and the +resolution. The combination of width/height and resolution determines how big +your image will be on screen or on paper: if your image has a resolution of +100x100 dpi, and your image is 1000x1000 pixels big, then, if everything is +configured correctly, your image will be exactly 10 inches long and 10 inches +wide if you check with a ruler, no matter the resolution of your screen or of +your printer — if shown at 100%. However, life is seldom so well-regulated +that this actually works out. For now, just think pixels, not inches. + + + +The next group of options is a lot more interesting than resolution: &krita; +is an enormously flexible application and you can work with many kinds of +images. For this tutorial, just select RGB (8 +bits/channel). You can also select a profile. For now, we leave this +at the default setting of sRGB built-in - (lcms internal). + + + +In the third option group, you can select the initial canvas color and the +amount of opacity/transparency of this color. Furthermore you can +add a description of the contents. We leave these options at their default +settings as well, so click Create to actually create the new +image. + + + +You will now see the main &krita; screen. + + + + +&krita;'s main screen + + + + + +&krita;'s main screen + + + + + + + +On the left hand side and on the top, there are toolbars which offer you access +to tools for painting, editing, and selecting. +You can find a more detailed description of these toolbars here. The actual painting area is in the +middle. On the right side of your screen, there are various palettes, which you +can read more about in this section. +Finally, there is a menu bar at the top of the screen, as usually. Read more +about it here. + + + diff --git a/doc/krita/tutorial-tablet-1.png b/doc/krita/tutorial-tablet-1.png new file mode 100644 index 00000000..6857e2d6 Binary files /dev/null and b/doc/krita/tutorial-tablet-1.png differ diff --git a/doc/krita/tutorial-tablet-2.png b/doc/krita/tutorial-tablet-2.png new file mode 100644 index 00000000..21f49de7 Binary files /dev/null and b/doc/krita/tutorial-tablet-2.png differ diff --git a/doc/krita/tutorial-tablet-3.png b/doc/krita/tutorial-tablet-3.png new file mode 100644 index 00000000..092fe4ab Binary files /dev/null and b/doc/krita/tutorial-tablet-3.png differ diff --git a/doc/krita/tutorial-tablet.docbook b/doc/krita/tutorial-tablet.docbook new file mode 100644 index 00000000..2e5e6184 --- /dev/null +++ b/doc/krita/tutorial-tablet.docbook @@ -0,0 +1,141 @@ + +Working with tablets + +This tutorial is intended to describe you the first steps with working +with a tablet with &krita;. The tutorial assumes you are using &Linux;. + + +Configuring it + + +As any hardware it nearly works out of the box. &Linux; should recognize it +fine, but you might have to configure the X11 server by hand. The best way to +do this is to follow the instruction on the Wacom &Linux; howto: . + +Then, in &krita;, you need to enable the various tools (in the +Tablet section of the +SettingsConfigure +&krita;... dialog) — you can find more +information in the tablet settings +section. + + + + + +First contact with the tablet + + +There are three devices of your tablet that you can use with &krita;: + + + +the cursor, the mouse that was shipped with the Wacom +tablet +the eraser, the round part on the top of the pen +the stylus, the thin point on the bottom of the pen + + + +By default, when you use the stylus or the cursor on the tablet, the Brush +tool and the pixel brush painting operation will get selected. The eraser +device is associated to the pixel eraser painting operation. +But if you select a different tool or a different painting operation with one +device, &krita; will remember the association when you switch between devices. + + + + + +Outlines of a flower + + +Even if you knew how to draw before you started with a tablet, you will need +to adapt to the tablet. It doesn't feel the same. So I suggest to start with +something simple, like a flower, and to use a picture as a model: + + + + +A flower + + + + + +A flower + + + + + + + +First, you will need to create a new layer for the outline. I advise you to +lock the layer with the picture, it will prevent you from making mistakes. + +Drawing the outline of the flower seems pretty easy, but for your first +experience you will have a great difficulty to precisely follow the line on +the screen while your hand has to move on the tablet. Eventually you will get +something like this: + + + + +The outline of the flower + + + + + +The outline of the flower + + + + + + + + + +Colorization + + +For the colorization, you will need to create a third layer. You will +have to move it below the layer with the outlines, and do not forget to lock +the outline layer. + +It's mostly easier than the outline part, just select the color you want to +use (either with the color selector or with the color picker), then for most +of the work you can use the fill tool: with the mouse, click on the part you +want to fill, as by default the fill tool will take the outline into +consideration. On the following image, the different colors of the heart of +the flower are not seperated by outlines, to do them I just completed the +missing outline with a yellow or brown line to create the separation between +the different colors. + + + + +The colored flower + + + + + +The colored flower + + + + + + + +The resulting image looks and feels like old fashion clipart, mostly because +it lacks shadows and illumination, which are not covered by this tutorial. + + + + + diff --git a/doc/krita/tutorial.docbook b/doc/krita/tutorial.docbook new file mode 100644 index 00000000..078b1886 --- /dev/null +++ b/doc/krita/tutorial.docbook @@ -0,0 +1,14 @@ + +Tutorial + + +The toolbars and palettes shown in these tutorials may not match your +installation of &krita;. Our apologies for this inconvenience. + + +&tutorial-starting; +&tutorial-select-layer; +&tutorial-quick-starts; +&tutorial-tablet; + + diff --git a/doc/krita/using-colorspaces.docbook b/doc/krita/using-colorspaces.docbook new file mode 100644 index 00000000..0222e8d3 --- /dev/null +++ b/doc/krita/using-colorspaces.docbook @@ -0,0 +1,149 @@ + +Colorspaces + + +This chapter gives information on what colorspaces are, which colorspaces +&krita; offers, and what you should keep in mind when using them. + + + +Introduction to colorspaces + + +What is a colorspace? + + +In short, a colorspace is a way to represent colors by specifying a number of +parameters. As parameters, one can choose for example the amounts of red, +green and blue light needed for the color. This results in the commonly known +RGB colorspace. One can visualize this as a three-dimensional space, with each +of the red, green, and blue light components being an axis in the colorspace. +A color then corresponds to a certain point in this colorspace, defined by its +coordinates on the three axes. + + +To be more precise, a colorspace is a combination of a color model (indicating +which axes are present) and a mapping function (indicating which values +correspond to which colors). + + +Not every color can be represented in every colorspace. Some colorspaces +define more, or different, colors than others. The set of colors that can be +represented in a certain colorspace is called its gamut. Because gamuts +can differ widely, it is not guaranteed that images in a certain colorspace +can be converted to another colorspace without having to substitute certain +colors for others, even if they are based on the same color model. + + + + + + + +Available colorspaces + + +&krita; offers colorspaces based on RGB, CMYK, Lab, LMS, YCbCr, and Gray +color models. These are shortly discussed in this section. + + + +The RGB color models + + +The abbreviation RGB stands for Red, Green, Blue, and the color model with +this name refers to the three light components that are emitted in displays +(televisions, computer monitors, etcetera) to create a certain color. This +color model is used by default in virtually any standard painting application. + +When defining a color in the RGB model, its red, green and blue components are +specified. If all components are absent (each component is emitted at 0 +percent intensity, so no light at all), the color is pure black. If all +components are fully present (100 percent intensity), the color is pure white. +If one component is present at full intensity and the other two are absent, +the pure respective color is obtained. + +Two more examples: if both red and green are emitted at 100 percent and blue +is not emitted, pure yellow is obtained. A color with all three components at +the same intensity is a shade of gray. + +There are various colorspaces that implement the RGB model. For example, the +so-called RGB8 colorspace represents each color with 8 bits per component. +Since 8 bits allow for 256 distinct values, the total number of different +colors that can be specified in this colorspace is 256 (red) * 256 (green) * +256 (blue), or about 16.7 million colors. In &krita;, a couple of RGB +colorspaces are available, for example RGB32, which is able to distinguish +between 4.2 billion values per component. + + + + + +The CMYK color model + + +CMYK is the abbreviation for Cyan, Magenta, Yellow, blacK (although officially +the K stands for Key, black is much more commonly used). This color model is +based on ink: a color is specified by the amount of ink needed for a point +to be perceived as having that color. + +Since CMYK colors are used by printers while RGB colors are used on-screen, +one often wants to convert RGB colors to CMYK colors. As this cannot always be +done correctly, printed images may turn out to look quite different than what +is perceived on-screen. + + + + + +The L*a*b* color model + + +This color model uses three parameters for a color: its +luminance or lightness (L*, which lies between 0 for black and +100 for white), its position between absolute red and absolute green (a*, +which is negative for colors closer to green and positive for colors closer to +red), and its position between yellow and blue (b*, which is negative for +colors closer to blue and positive for colors closer to yellow). + + + + + +The LMS color model + + +This model is based on the contribution of actual light wave lengths to the +color. The human eye is sensitive to three types of light waves, distinguished +by their wave lengths: long (L), middle (M) and short (S) waves. The eye's +sensitivity for a certain color on these three wavelengths can be expressed in +L, M and S coordinates. + + + + + +The YCbCr color model + + +The YCbCr model is often used for video systems. The Y parameter indicates the +luminance or lightness of the color (which can be seen as a gray-tone), the Cb +and Cr parameters indicate the chrominance (color tone): Cb places the color +on a scale between blue and yellow, Cr indicates the place of the color +between red and green. + + + + +The Gray color model + + +The Gray color model simply represents colors as shades of gray (with black +and white being the extremes). + + + + + + + diff --git a/doc/krita/using-filters.docbook b/doc/krita/using-filters.docbook new file mode 100644 index 00000000..3dd686c4 --- /dev/null +++ b/doc/krita/using-filters.docbook @@ -0,0 +1,923 @@ + +Filters + + +&krita; comes with a number of filters. These can be used to enhance or +otherwise modify the image, either in whole or in part. Some filters are +applied directly, others are customizable, meaning that you are presented with +a dialog in which you can tune the result to your liking before the filter is +applied. If a selection is active, a filter is applied on the selected part of +the image. If no selection is active, the entire image is modified. + +This chapter describes the available filters in detail. To make comparing the +filters easier, each filter has been applied to the same image and each description +contains a comparison image, showing the result of applying the filter described. +The original image (with thanks to the photographer, Christian Peper) is shown +below at half the original size. The sample images demonstrating the +results of applying the filters, with the original image at the left and the +modified image at the right, are shown at 25% of the original size. + +Some filters yield reasonable results for most images. For +other filters though, quite some tweaking needs to be done before the desired +outcome is achieved. If a filter does not do what you want, it might need +more or less customising. The examples in this chapter are exaggerated to +give a good impression of the filters. You will usually want to have more +gentle modifications. + +Tip: If you want to apply a filter to everything except a certain part of your +image (for example, you want to desaturate your image except for the centre), +select the part you do not want to apply the filter to, use the +SelectInvert +menu option, and then apply the filter. + + +See the Dialogs for working with +filters section for descriptions of the settings available for the +customizable filters. + + + +The original image + + + + + +The original image + + + + + + +The Auto Contrast filter + +The Auto Contrast filter changes the contrast of your image to what should be +the best settings. Usually this works out fine, but in some cases (for example +photos taken under unusual lighting circumstances), the filter will not yield +satisfying results. + + +You can find the Auto Contrast filter in the Filter +Adjust menu. This filter is not customizable. + + +The image with the Auto Contrast filter applied to it + + + + + +The image with the Auto Contrast filter applied to it + + + + + + + +The Blur filter + +You can use the Blur filter to blur your image (give it a fuzzy look). + + +You can find the filter in the Filter +Blur menu. +See the section on the +Blur dialog +for more information on its settings. + + +The image with the Blur filter applied to it + + + + + +The image with the Blur filter applied to it + + + + + + + +The Brightness / Contrast filter + +With this filter, you can adjust the brightness and contrast of your image. + + +You can find the filter in the Filter +Adjust menu. +See the section on the +Brightness / Contrast dialog +for more information on its settings. + + +The image with the Brightness / Contrast filter applied to it + + + + + +The image with the Brightness / Contrast filter applied to it + + + + + + + +The Bumpmap filter + +The Bumpmap filter takes two layers and uses one of these to convert the other +one so that it will give an illusion of depth. The object layer (the layer to be +transformed) is the actual layer that should receive the three-dimensional +looks. The bumpmap layer is a grayscale layer, which is read and used to +determine the height for each point of the object layer. Alternatively, the +same layer can be used as both object layer and bumpmap layer. + + +You can find the filter in the Filter +Map menu. +See the section on the +Bumpmap dialog for more information on its +settings. + + +The image with the Bumpmap filter applied to it + + + + + +The image with the Bumpmap filter applied to it + + + + + + + +The CImg Image Restoration filter + +With this filter, you can perform minor enhancements to your image, for +example removing small scratches or adding a slight blur. The difference +between our sample original image and the result of applying this filter with +standard settings is virtually none. + + +You can find the filter in the Filter +Enhance menu. +See the section on the +Image Restoration dialog +for more information on its settings. + + + + +The Color Adjustment filter + +This filter allows you to change the looks of your image by increasing or +decreasing the abundance of certain colors. + + +You can find the filter in the Filter +Adjust menu. +See the section on the +Color Adjustment dialog +for more information on its settings. + + +The image with the Color Adjustment filter applied to it + + + + + +The image with the Color Adjustment filter applied to it + + + + + + + +The Color to Alpha filter + +This filter changes a color or color range in your image to become +transparent, effectively clearing regions with those colors. + + +You can find the filter in the Filter +Colors menu. +See the section on the +Color to Alpha dialog +for more information on its settings. + + +The image with the Color to Alpha filter applied to it + + + + + +The image with the Color to Alpha filter applied to it + + + + + + + +The Color Transfer filter + +With this filter, you can re-color an image using the colors from another +image. Each color in your current image will be replaced by the most alike +color used in the other image. + + +You can find the filter in the Filter +Colors menu. +See the section on the +Color Transfer dialog +for more information on its settings. + + +The image with the Color Transfer filter applied to it + + + + + +The image with the Color Transfer filter applied to it + + + + + + + +The Custom Convolution filter + +This filter allows you to distort your image by setting a number of +parameters. + + +You can find the filter in the Filter +Enhance menu. +See the section on the +Custom Convolution dialog +for more information on its settings. + + +The image with the Custom Convolution filter applied to it + + + + + +The image with the Custom Convolution filter applied to it + + + + + + + +The Desaturate filter + +This filter converts your image to grayscale by setting the saturation of each +pixel's color to zero. + + +You can find the filter in the Filter +Adjust menu. +This filter is not customizable. + + +The image with the Desaturate filter applied to it + + + + + +The image with the Desaturate filter applied to it + + + + + + + +The Edge Detection filters + +These filters try to detect edges (boundaries) in the picture +and modify the image such that only these edges retain their respective colors, +while the rest of the image is turned gray. Through the use of lighting the +image will then get a three-dimensional look. + +There are four edge detection filters available. Each of these detects edges +from a different side (possibly considering other parts of the image as being +edges) and will therefore obtain a different resulting image. + + +You can find the filters in the Filter +Edge Detection menu. +These filters are not customizable. + + +The image with the Bottom Edge Detection filter applied to +it + + + + + +The image with the Bottom Edge Detection filter applied to it + + + + + + + +The Emboss filters + +Emboss filters work somewhat like edge detection filters, with the difference +that embossed images are entirely gray. Areas in the picture are detected and +are given a certain height level, which is made visible by using +grayscale borders, making the image look like it is three-dimensional. + + +You can find the filters in the Filter +Emboss menu. +Except for the Emboss with Variable Depth filter, these filters are not +customizable. See the section on the +Emboss dialog +for more information on the settings of the Emboss with Variable Depth filter. + + +The image with the Emboss in All Directions filter applied to it + + + + + +The image with the Emboss in All Directions filter applied to it + + + + + +The image with the Emboss with Variable depth filter applied to +it + + + + + +The image with the Emboss with Variable depth filter applied to it + + + + + + + +The Gaussian Blur filter + +This filter makes the image a little fuzzy by blurring it in a pseudo-random +way. A gaussian algorithm is used for finding the extent to which each part of +the image should be blurred. + + +You can find the filter in the Filter +Blur menu. +This filter is not customizable. + + +The image with the Gaussian Blur filter applied to it + + + + + +The image with the Gaussian Blur filter applied to it + + + + + + + +The Gaussian Noise Reduction filter + +With this filter, you can remove noise from your image. + + +You can find the filter in the Filter +Enhance menu. +See the section on the +Gaussian Noise Reduction dialog +for more information on its settings. + + +The image with the Gaussian Noise Reduction filter applied to it + + + + + +The image with the Gaussian Noise Reduction filter applied to it + + + + + + + +The Invert filter + +This filter inverts all colors. The Red, Green and Blue component of each pixel +are taken and subtracted from 255. This means that red becomes cyan, green +becomes purple, and blue becomes yellow. The resulting values form the new +pixel color. + + +You can find the filter in the Filter +Adjust menu. +This filter is not customizable. + + +The image with the Invert filter applied to it + + + + + +The image with the Invert filter applied to it + + + + + + + +The Lens Correction filter + +This filter can fix distortions in your image resulting from for example +pincushion lens effects, and modify some lighting. + + +You can find the filter in the Filter +Other menu. +See the section on the +Lens Correction dialog +for more information on its settings. + + +The image with the Lens Correction filter applied to it + + + + + +The image with the Lens Correction filter applied to it + + + + + + + +The Maximize Channel filter + +This filter gives each pixel in your image a new color: only the color channel +that contributes the most to the color of a pixel is retained (except for +gray pixels, which are kept gray). + + +You can find the filter in the Filter +Colors menu. +This filter is not customizable. + + +The image with the Maximize Channel filter applied to it + + + + + +The image with the Maximize Channel filter applied to it + + + + + + + +The Mean Removal filter + +This filter sharpens the image by changing the colors of neighboring pixels +with approximately the same color, so that small differences are evened out. + + +You can find the filter in the Filter +Enhance menu. +This filter is not customizable. + + +The image with the Mean Removal filter applied to it + + + + + +The image with the Mean Removal filter applied to it + + + + + + + +The Minimize Channel filter + +This filter gives each pixel in your image a new color: the color channel +that contributes the most to the color of a pixel is removed (except for +gray pixels, which are kept gray). + + +You can find the filter in the Filter +Colors menu. +This filter is not customizable. + + +The image with the Minimize Channel filter applied to it + + + + + +The image with the Minimize Channel filter applied to it + + + + + + + +The Oilpaint filter + +An oilpaint effect is given to the image by creating patch-shaped areas in which +the most important color is applied to the entire area. + + +You can find the filter in the Filter +Artistic menu. +See the section on the +Oilpaint dialog +for more information on its settings. + + +The image with the Oilpaint filter applied to it + + + + + +The image with the Oilpaint filter applied to it + + + + + + + +The Pixelize filter + +The image is pixelated by taking a square area and giving it the mean color +value of the pixels it contains. + + +You can find the filter in the Filter +Artistic menu. +See the section on the +Pixelize dialog +for more information on its settings. + + +The image with the Pixelize filter applied to it + + + + + +The image with the Pixelize filter applied to it + + + + + + + +The Raindrops filter + +This filter makes it look like raindrops have fallen on the image by distorting +drop-shaped areas with a lens-like effect as one would see when looking +at the image through a real raindrop. Some raindrops will have a fish-eye lens +effect. + + +You can find the filter in the Filter +Artistic menu. +See the section on the +Raindrops dialog +for more information on its settings. + + +The image with the Raindrops filter applied to it + + + + + +The image with the Raindrops filter applied to it + + + + + + + +The Random Noise filter + +With this filter, random noise can be added to your image. + + +You can find the filter in the Filter +Other menu. +See the section on the +Random Noise dialog +for more information on its settings. + + +The image with the Random Noise filter applied to it + + + + + +The image with the Random Noise filter applied to it + + + + + + + +The Random Pick filter + +This filter distorts the image by interchanging pixels. + + +You can find the filter in the Filter +Other menu. +See the section on the +Random Pick dialog +for more information on its settings. + + +The image with the Random Pick filter applied to it + + + + + +The image with the Random Pick filter applied to it + + + + + + + +The Round Corners filter + +This filter just rounds off the corners of the image. This is done by making +the outside of the rounded corner transparent. + + +You can find the filter in the Filter +Map menu. +See the section on the +Round Corners dialog +for more information on its settings. + + +The image with the Round Corners filter applied to it + + + + + +The image with the Round Corners filter applied to it + + + + + + + +The Sharpen filter + +This filter sharpens the image. + + +You can find the filter in the Filter +Enhance menu. +This filter is not customizable. + + +The image with the Sharpen filter applied to it + + + + + +The image with the Sharpen filter applied to it + + + + + + + +The Small Tiles filter + +The picture is reduced in size and repeated multiple times. + + +You can find the filter in the Filter +Map menu. +See the section on the +Small Tiles dialog +for more information on its settings. + + +The image with the Small Tiles filter applied to it + + + + + +The image with the Small Tiles filter applied to it + + + + + + + +The Sobel filter + +This is a more enhanced edge detection filter. + + +You can find the filter in the Filter +Edge Detection menu. +See the section on the +Sobel dialog +for more information on its settings. + + +The image with the Sobel filter applied to it + + + + + +The image with the Sobel filter applied to it + + + + + + + +The Unsharp Mask filter + +This filter sharpens part of your image. (The name unsharp is +historical: parts would be masked off while the rest would be made less sharp.) + + +You can find the filter in the Filter +Enhance menu. +See the section on the +Unsharp Mask dialog +for more information on its settings. + + +The image with the Unsharp Mask filter applied to it + + + + + +The image with the Unsharp Mask filter applied to it + + + + + + + +The Wave filter + +This filter transforms your image into a wave shape. + + +You can find the filter in the Filter +Other menu. +See the section on the +Wave dialog +for more information on its settings. + + +The image with the Wave filter applied to it + + + + + +The image with the Wave filter applied to it + + + + + + + +The Wavelet Noise Reduction filter + +This filter reduces noise in the image by giving loose pixels a color close to +the surrounding area. This causes small details to be lost, but can enhance the +general view of the image when this is hampered by too many unnecessary details. + + +You can find the filter in the Filter +Enhance menu. +See the section on the +Wavelet Noise Reduction dialog +for more information on its settings. + + +The image with the Wavelet Noise Reduction filter applied to +it + + + + + +The image with the Wavelet Noise Reduction filter applied to it + + + + + + + + diff --git a/doc/krita/using-images.docbook b/doc/krita/using-images.docbook new file mode 100644 index 00000000..e3b1f239 --- /dev/null +++ b/doc/krita/using-images.docbook @@ -0,0 +1,66 @@ + +Images + + +Creating and modifying images is one of &krita;'s core functionalities. While +most of the other chapters in this manual focus on the things you can do when +painting or editing, this chapter shows you what you can do with respect to +the images themselves. + + + +Working with files + + +Unless you are doing some quick sketching, working with &krita; will most +likely involve files. You can open existing images — &krita; can work +with a large number of file formats, see Image formats — +or start &krita; to create a new one. When you are done or if you want to +continue at a later time, you can easily save your work. + + + + +Opening existing files +When you start &krita;, you can open an existing image with +the Open Existing Document button at the lower left of +the opening dialog. You can also use the +FileOpen +menu option (&Ctrl;O). +This will bring up the Open Document dialog in which you +can choose an image to open. The opening dialog and the +File menu also contain a list of the most recently used +files for quick access. + + +Saving your work in progress +With the +FileSave +and FileSave As... +menu options (or their respective shortcuts &Ctrl;S and &Ctrl;&Shift;S), you can save your +work. The former option will save the modifications to the current image, the +latter option will show the Save Document dialog in which +you can give a new file name for the image. If this is the first time you save +the image, Save will ask for a file name as well. + + + +Creating a new image +From the opening dialog (available via the +FileNew +menu option or the &Ctrl;N keys), you can create a +fully custom document or choose one of the image templates. These templates +offer a quick way of creating a new image. See the Starting to know &krita; tutorial. + + + + + + + + diff --git a/doc/krita/using-layers.docbook b/doc/krita/using-layers.docbook new file mode 100644 index 00000000..8cb574f6 --- /dev/null +++ b/doc/krita/using-layers.docbook @@ -0,0 +1,620 @@ + +Layers + + +This chapter gives an overview of how layers work in &krita;. + + + +Background information on layers + + +Extensive use of &krita; will almost require you to have some knowledge of +layers. Using layers, you can work on one part of the image without touching +the rest of it, and most effects are best applied on a layer, instead of on +the whole image. Of course, if you do want to apply an effect to an entire +image, &krita; does offer you that possibility, and there is nothing against +it. + +The idea behind layers is quite simple. As the name suggests, layers lie on +top of each other, and together form the layer stack. The final resulting +image is that what you see when looking through the stack from top to bottom. +This means that usually the upper layers of your image will have more or less +transparency, since you cannot look through a layer which has no transparency. +(&krita; works with opaqueness instead of transparency. A layer that is 100 +percent opaque is 0 percent transparent, and vice versa.) A layer higher in +the stack gets applied later than one lower in the stack. For example, if your +image contains four layers, numbered from 1 (lowest) to 4 (highest), the +effect that layer number 4 adds to the image, is applied to the result from +applying layers 1 through 3. + +Every image you edit in &krita; contains layers. When you create a new image, +the layer box (usually shown at the bottom right of your screen, see this section) will contain +one layer. The painting and editing you do is then applied to that layer. Once +you add more layers, you can choose on which part of the image you want to +work, by selecting the respective layer. All further painting is then applied +to that layer, until you select another one. + +Layers are also an excellent way to check whether adding certain effects (or +applying certain image modifications) come out right. Add a layer which +contains what you want to try out, and show or hide it with the eye icon in +the layer box. You can especially profit from this method if you have multiple +effects to check out: show and hide them in any combination, and decide which +you like best. And since you can move the layers around, you can also +experiment with the order in which the effects are applied. + +See the Selections and layers +tutorial for a small hands-on introduction. + + + + +The layer box + +The layer box is the instrument you will use most to work with layers. It +gives an overview of the layers that are present in your image, and using it +you can manage layers by adding, removing, reordering or modifying them. + +The layer box consists of three parts. The middle part gives an overview of the +layers in the image. At the top, you can set some properties for the current +layer. At the bottom, a couple of layer management options can be found. The +next sections describe these three parts in more detail. + + + +Layer overview + +This part shows you which layers are present in your image. In a tree-like +structure, the layer group hierarchy is shown: layers that are contained within +a layer group are displayed a bit to the right to indicate their belonging to +that group. + +For each layer, a thumbnail preview and its name are shown. The layer name +is preceded by a folder icon if it is a group layer. Furthermore, two +indicators are present: the eye icon shows whether the layer is currently +visible (an open eye indicates that the layer is visible, a closed eye +indicates that it is not), and the lock icon shows whether the layer is +locked. No changes can be made to a locked layer. + +When you click on a layer's eye icon, its visibility is switched from on to +off or vice versa. Clicking on the lock icon enables or disables editing of +that layer. You can click on the name of the current layer to rename it. +Note that to rename a layer, it has to be the current one. You do not need to +activate a layer in order to make it (in)visible or (un)locked via the eye and +lock icons, respectively: these work directly. + +Doubleclick on a layer entry in the list to open the Layer +Properties dialog. This dialog shows a layer's colorspace and +profile. You can also change its name, opacity and composite mode here. + + + + +Layer options + +The top of the layer box contains two controls for setting properties of the +currently selected layer. The list box at the left allows you to quickly set +the layer's composite mode. The spin field and slider at the right can be used +to change the layer's opacity. + +At the bottom of the layer box, there are five buttons. From left to right, +these are as follows. The New Layer icon brings up a +submenu from which you can choose which type of layer you want to add. This +menu can also be opened by clicking with the &RMB; on the layer box. The +Move Layer Down and Move Layer Up +buttons move the current layer one level down and up, respectively, within the +current layer group. If the layer is already the last or first within the +layer group, trying to move it further will move it out of the layer group. +The Layer Properties button opens the Layer +Properties dialog, just as when you would have doubleclicked +on the layer. The Delete Layer button deletes the +current layer. + + + + + + +Working with layers + + +Because layers are quite important when extensively using &krita;, you can +perform a lot of operations on them. These are all available via the Layer menu. Some of +the possibilities: + + + +Add, remove, and duplicate layers; +Create and edit layer masks; +Flip, rotate, scale and shear layers; +Convert layers between colorspaces; +Save layers as images; +View layer histograms. + + + + + +Adjustment Layers + +Adjustment layers are layers that consist of a filter and an optional +selection. The filter effect is applied to the composite image of all +layers under the adjustment layer in the current layer group. The big +thing is, adjustment layers apply these effects non-destructively. The +original image data is not modified. + +Almost all &krita; filters are suitable for use in adjustment +layers -- even filters that would downgrade the image quality. For instance, +the raindrops filter converts to 8-bit RGB before working its magic. If you +would try to use this filter directly on a 16-bit L*a*b* layer, &krita; would +warn you about the conversion to RGB and back again this filter would cause. +Not so with adjustment layers: the original data isn't touched, so applying +the filter is safe. + +What about the colorspace of an adjustment layer then? In order to examine +this issue, you need to know what happens when &krita; renders an adjustment +layer. + + + +Adjustment layers and selections + +If the currently active layer has an active selection, then that selection +will be copied and used as a mask for the adjustment layer. If there is no +active selection, then there will be no mask and the adjustment will apply to +the entire extent of the layers under the adjustment layer in the current +group. There is no way of adding a mask to an existing +adjustment layer. + +If there is a mask in the adjustment layer, you can edit the mask using the +ordinary painting tools and painting operations. + + + + + +A note on projections + + +&krita; composites the layers bottom to top, within each layer group. The +aggregate -- or the projection as it is also called -- is then filtered by +the adjustment layer. If there are layers on top of the adjustment layer, +those are composited onto the projection. &krita; converts all layer data before +compositing, so if the bottom-most layer in an image is grayscale, all layers +are converted to grayscale before compositing -- and that means that the +adjustment layer projection will be grayscale, too. + +With this knowledge you'll understand why &krita; can often offer better +performance working with layers on top of an adjustment layer which is on top +of a complex layer structure: &krita; uses the projection and doesn't even look +anymore at the layers under the adjustment layer. Unless, of course, you +change one of them. + + + + + + +Compositing modes + + +Layers can be composited in various ways, each yielding a different effect. +This section describes the available compositing modes. Each description is +accompanied by an example: on top of an original image (see below), a rainbow +gradient is added. + + + + +The original image + + + + + +The original image + + + + + + + +<guilabel>Normal</guilabel> + + +The Normal mode does nothing special. It adds the layer +to the image, and if no other special effects like opacity are changed, the +underlying layers will only be visible at places where the new layer is +itself transparent. + + + + +The gradient applied with the Normal compositing +mode + + + + + +The gradient applied with the Normal compositing +mode + + + + + + + + + +<guilabel>Multiply</guilabel> + + +The Multiply mode blends the two layers so that the +bottom layer gets colorized by the new layer. The resulting +image is generally quite dark. + + + + +The gradient applied with the Multiply compositing +mode + + + + + +The gradient applied with the Multiply compositing +mode + + + + + + + + + +<guilabel>Burn</guilabel>, <guilabel>Dodge</guilabel>, +<guilabel>Divide</guilabel> and <guilabel>Screen</guilabel> + + +The Burn, Dodge, +Divide and Screen modes all add an +extra burning effect by following contours instead of using +straight lines. In addition, Burn and +Divide use the inverted colors instead of the actual +colors of the composited layer. + + + + +The gradient applied with the Burn compositing +mode + + + + + +The gradient applied with the Burn compositing +mode + + + + + + + + +The gradient applied with the Dodge compositing +mode + + + + + +The gradient applied with the Dodge compositing +mode + + + + + + + + +The gradient applied with the Divide compositing +mode + + + + + +The gradient applied with the Divide compositing +mode + + + + + + + + +The gradient applied with the Screen compositing +mode + + + + + +The gradient applied with the Screen compositing +mode + + + + + + + + + +<guilabel>Overlay</guilabel> + + +Like Multiply, the Overlay mode +colorizes the underlying layer. The resulting image is about as light as +the original layer. + + + + +The gradient applied with the Overlay compositing +mode + + + + + +The gradient applied with the Overlay compositing +mode + + + + + + + + + +<guilabel>Darken</guilabel> + + +The Darken mode darkens the underlying layer while +colorizing it to match the colors in the composited layer. + + + + +The gradient applied with the Darken compositing +mode + + + + + +The gradient applied with the Darken compositing +mode + + + + + + + + + +<guilabel>Lighten</guilabel> + + +The Lighten mode lightens the underlying layer while +colorizing it to match the colors in the composited layer. + + + + +The gradient applied with the Lighten compositing +mode + + + + + +The gradient applied with the Lighten compositing +mode + + + + + + + + + +<guilabel>Hue</guilabel>, <guilabel>Saturation</guilabel> and +<guilabel>Value</guilabel> + + +The Hue, Saturation and +Value modes respectively apply the hue, saturation and +value components of the composited layer to the underlying layer. + + + + +The gradient applied with the Hue compositing +mode + + + + + +The gradient applied with the Hue compositing +mode + + + + + + + + +The gradient applied with the Saturation compositing +mode + + + + + +The gradient applied with the Saturation compositing +mode + + + + + + + + +The gradient applied with the Value compositing +mode + + + + + +The gradient applied with the Value compositing +mode + + + + + + + + + +<guilabel>Color</guilabel> + + +The Color mode colorizes the underlying layer, yielding +very strong colors. + + + + +The gradient applied with the Color compositing +mode + + + + + +The gradient applied with the Color compositing +mode + + + + + + + + + + + +Layer Masks + + +Basically, a layer mask is a mask that you place on your paint layer. This +will literally mask areas of the layer, so that the content underneath shows +through. You can paint on it with greyscale colors: the more black the color, +the less the layer under it will shine through, the more white, the less the +layer under it will be shown. So complete white will let nothing through, +complete black will let everything through. Basically, it is a bit like +selecting a piece of your image, and then cutting it, so that the selected +bits go away. So what is the use for a mask here? The big advantage is that it +is non-destructive: if you decide that you masked out the wrong part of your +layer, you can easily remove the mask and start anew, something a lot harder +(not to say near impossible, especially in between sessions) with regular +selection-cutting. + +So, how to create a mask? There are 2 ways: + + + + +Start from scratch. +LayerMaskCreate +Mask. The mask starts with everything being +retained, that is, a complete white mask. Basically you will not see any +changes as long as you do not paint on it. + + +Start from the current selection. +LayerMaskMask +From Selection. The selectedness will be converted +to whiteness. This means that fully selected area will be visible, fully +unselected areas will be invisible, and the rest will be partially visible, +depending on how much the area was selected. + + + + +Editing the mask + + +First, make sure you are editing the mask, not the layer, by making sure +LayerMaskEdit +Mask is checked. (This is checked by default.) Then +you can paint on the layer just like before, only now you are +painting on the mask, instead of on the layer itself. To stop painting on the +mask, you can uncheck the Edit Mask checkbox. There's +also the option to show the mask, through checking +LayerMaskShow +Mask. (This is not checked by +default). This option will render the entire layer as a visual representation +of the mask in greyscale, instead of the actual layer. This can be handy to +see where your mask is, but it might be not as handy when you want to edit it, +since you cannot look at the actual layer. + +Other actions: you can also remove the mask if you are not satisfied with it, +and want to start over again, or just want to remove it, with +LayerMaskRemove +Mask. You can also apply the mask, +meaning that the mask will be made permanently. This means that the mask is +removed, but that its effect of transparency will be committed to the layer. + + + + + + diff --git a/doc/krita/using-selections-1.png b/doc/krita/using-selections-1.png new file mode 100644 index 00000000..b3ff682a Binary files /dev/null and b/doc/krita/using-selections-1.png differ diff --git a/doc/krita/using-selections-2.png b/doc/krita/using-selections-2.png new file mode 100644 index 00000000..4b23bb5f Binary files /dev/null and b/doc/krita/using-selections-2.png differ diff --git a/doc/krita/using-selections-3.png b/doc/krita/using-selections-3.png new file mode 100644 index 00000000..cca12363 Binary files /dev/null and b/doc/krita/using-selections-3.png differ diff --git a/doc/krita/using-selections-4.png b/doc/krita/using-selections-4.png new file mode 100644 index 00000000..5d82cafb Binary files /dev/null and b/doc/krita/using-selections-4.png differ diff --git a/doc/krita/using-selections-5.png b/doc/krita/using-selections-5.png new file mode 100644 index 00000000..5c524be8 Binary files /dev/null and b/doc/krita/using-selections-5.png differ diff --git a/doc/krita/using-selections-6.png b/doc/krita/using-selections-6.png new file mode 100644 index 00000000..16d76bc3 Binary files /dev/null and b/doc/krita/using-selections-6.png differ diff --git a/doc/krita/using-selections.docbook b/doc/krita/using-selections.docbook new file mode 100644 index 00000000..5465b8a6 --- /dev/null +++ b/doc/krita/using-selections.docbook @@ -0,0 +1,200 @@ + +Selections + + +This chapter gives a short introduction on selections. + +You can select a part of an image masking off the rest. This is handy when +you want to cut, copy or just modify a part of the image without affecting +the rest. For processing selected objects &krita; applies a mask. Each pixel of +the selection is processed based on a value of its mask, or the level +of the selection, that can range from 0 (unselected) to 255 +(selected). Yes, that is right, you can have fractionally selected pixels. +And by working on individual pixels you can paint your selection. + +The selection mask is visualized with unselected pixels having a blueish +tint, and selected pixels looking like normal. Fractionally selected pixels +are shown as something in between. Additionally a red border is drawn around +the selected areas. Fractionally selected pixels are inside the border, so +even inside the red border you can possibly see the blueish tint on some pixels. + + + +Making a selection + +A whole range of tools exist to make selections. From rectangles, ellipses +and freehand to the more exotic like color range select. When you make +several selections they add up. So a rectangle select followed by an +ellipse select select both areas. Later on, you can subtract areas from +the selection by using, for example, the Erase Selection tool. + +To get back to normal (no active selection), choose +SelectDeselect +. To select all pixels, choose +SelectSelect All +. + +You may think that those two actions give the same result, but it +is much more efficient to have no active selection than to have selected +everything. + +After having deselected you can bring your selection back by choosing +SelectReselect +. + + + + +Painting your selection + +As said above you can essentially paint your selection, and just like +when you paint normally you can choose to paint your selection freehand or +guided with rectangles, ellipses, &etc;. You also have the choice of different +paint tools like pen, brush, airbrush, &etc;. Choose the guide tool, and the +paint tool in the toolbox, and go ahead and paint your +selection. + +The guide tools work just like you may be used to from other applications. So +holding down shift while drawing a rectangle or an ellipse still forces them to +be a square or a circle respectively. + + + +Painting a selection + + + + + +Painting a selection + + + + + +Painting a selection + + + + + +Painting a selection + + + + + + + + +Unselecting + +All the selection paint tools have an option to add or subtract from the +selection. This means that you can use all your familiar tools to both select +and unselect. There is also a true selection eraser among the selection paint +tools. + + + +Unselecting + + + + + +Unselecting + + + + + + + +Making a new selection + +When you want to make a new selection, replacing the currently active one, you +first need to deselect the active selection. Choose +SelectDeselect +. + + + + +Selecting a contiguous area (magic wand) + +To follow the analogy of painting your selection &krita; also provides an +equivalent to filling a contiguous area. Some paint applications call this +selection tool the magic wand tool. What it does is select the nearby +pixels as long as they have nearly the same color as the pixel you click +on. The selection floods out from the point you click on. In the fuzziness +option you can set how different the colors are allowed to be before the +flooding stops. + + + +Before the magic wand + + + + + +Before the magic wand + + + + + + +A magic wand selection + + + + + +A magic wand selection + + + + + + + + +Selecting similar colors + +The Select Similar tool lets you pick a pixel and then select all pixels that +have a similar color. Picking a color in one corner of the image may select a +pixel in another corner if they have similar color. +With the Fuzziness option you can set how similar the colors must be to become +selected. + + + +Selecting similar colors + + + + + +Selecting similar colors + + + + + + + +Inverting the selection + +In some cases it is easier to specify your selection the other way around. That +is, first you select the parts that ultimately should not be selected and then +then you choose +SelectInvert +. +What invert does, is that for every pixel it flips the selection level so to +speak, by setting it to 256 minus the current selection level. Thus what was +selected becomes unselected and vice versa. + + + + diff --git a/doc/krita/using-views.docbook b/doc/krita/using-views.docbook new file mode 100644 index 00000000..6760209e --- /dev/null +++ b/doc/krita/using-views.docbook @@ -0,0 +1,167 @@ + +Views + + +One of the most important things you need to know when working with a painting +or image editing application, is how to adapt the view of your image to your +(changing) needs. This chapter describes the various possibilities &krita; +offers. + + + +Zooming + + +By zooming, you can view your images at various levels of detail. Zooming out +will show a larger part of the image, but with less detail. &krita; offers a +couple of options that affect which part of the image is shown: + + + + +Zooming in +Zooming in allows you to see more details, but you will only +see a smaller part of the image. You can zoom in by choosing the +ViewZoom +in menu item, by clicking the + + Zoom in button on the +toolbar, or by pressing the &Ctrl;+ keys. +You can zoom in up to 1600% (a 16:1 ratio) via a number of fixed zoom levels. + + + +Zooming out +Zooming out allows you to see a larger part of the image while +losing some detail. Zooming out can be done by choosing the +ViewZoom +out menu item, by clicking the + + Zoom out button on the +toolbar, or by pressing the &Ctrl;- keys. +You can zoom out up to 0.2% (a 1:500 ratio) via a number of fixed zoom levels. + + + +Going back to 100% +As viewing your image at its real size is quite handy at +times, you can do so via the +ViewActual +pixels menu item or by pressing &Ctrl;0. + + + +Zooming in and out from the Overview +tab +The Overview tab of the control box +(usually found at the right hand side of the &krita; window) also allows you +to change the zoom level by using the slider or the spinbox. Slightly +different zoom levels are available here, so if zooming in or out as described +above does not produce a view you want, you can try using this option. The +1:1 button offers another way of getting back to a 100% +zoom. + + +Special zooms +There are two more special ways of zooming. The +ViewFit to +Page menu item zooms your image such that it is +as large as possible while remaining entirely visible. The +ViewFull Screen +Mode menu item (pressing &Ctrl;&Shift;F will also activate +this mode) enlarges the &krita; window to fill your entire screen, removing +the title bar as well. Although this is not a real way of +zooming, it can help you by showing just that little bit more of your +image. + + + + + + + +Working with views + + +Apart from changing the zoom level of your view, you can also open different +views for the same image. This way, you can for example look at two different +parts of your image that would not fit on your screen together otherwise. + + + + +New view windows +You can open a new &krita; window for your image by choosing +ViewNew +View Both windows are independent from each other +(so you can select different tools, view different parts of your image, +&etc;), but changes you make to the image in one window are immediately +visible in the other. To close a window, use the normal window closing button. +There is also an option ViewClose +All Views, which closes all newly created views and +leaves only the original window open. + + +Splitting views +You can also split a window into two views. Like a new window, +one view of a split window has its own settings for brushes, zoom levels and +the like, but both views are shown in the same window. To split your window, +choose ViewSplit +View. The viewing area of the &krita; window will +then be divided into two halves. You can switch between horizontal and +vertical division with the +ViewSplitter +Orientation menu, and get back to one view by +choosing ViewRemove +View. + + + + + + + +Miscellaneous view options + + +&krita; also offers two options that can help you with knowing where you are. + + + + +Rulers +You can have &krita; show rulers along the sides of your +image, indicating x and y coordinates. To do so, choose +ViewShow +Rulers or press &Ctrl;R. The rulers will +automatically adapt to your zoom level to show a proper amount of +subdivisions. To remove the rulers, choose the same menu option (now called +Hide Rulers) or press &Ctrl;R again. + + +Grid +In order to see grid lines, choose +ViewShow +Grid. You can set the distance between grid lines +with ViewGrid +Spacing and you can choose different colours for the +lines in the SettingsConfigure +&krita;... dialog (see the Grid section of the Settings +chapter). + + + + + + + + diff --git a/doc/kspread/Makefile.am b/doc/kspread/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kspread/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kspread/a11y.docbook b/doc/kspread/a11y.docbook new file mode 100644 index 00000000..c7ceaee5 --- /dev/null +++ b/doc/kspread/a11y.docbook @@ -0,0 +1,320 @@ + + + + +Gary +Cramblitt + + + + + +For Users with Disabilities +This section of the documentation discusses accessibility features in &kspread; +for users with disabilities. Some of these features apply to &kde; as a whole and are controlled from +&kcontrolcenter;. Some apply to all &koffice; applications, +and some are specific to &kspread;. + + +Installing the <command>kdeaccessibility</command> Module +kdeaccessibility + +Most of the features described in this chapter are enabled by installing the +kdeaccessibility module. +The kdeaccessibility module is part of the &kde; project +http://www.kde.org. The kdeaccessibility +package can be obtained from &kde-ftp;, the +main ftp site of the &kde; project. + + +Many distributions offer precompiled binaries on their ftp sites. Please check your distribution's web sites for more information. + +More information about &kde; accessibility can be obtained by +visiting http://accessibility.kde.org/. + + + + +Visual Impairments +Visual Impairments + +&kspread; is not usable by totally blind users. It is hoped that +a general screen reader for the blind will be available in future versions of &kde;. + + + +Theming +Theming +For low-sighted or light allergic users, several features are available in the &kcontrolcenter; +Appearance & ThemesTheme Manager, +like high contrast color themes. If you are light allergic, the +HighContrastDark or HighContrastLight themes +may be helpful. If you have difficulty reading small fonts or seeing small icons, the +HighContrastDark-big or HighContrastLight-big +themes will increase the size of text, buttons, and icons. You may also customize +background, colors, fonts, and icons from the same dialog. A set of monochrome icons +is available. + + +If you choose one of the Big themes, you may discover that +some windows are too large to fit your monitor. Purchasing a larger monitor will be helpful. +You can drag the portions of the window not visible into the visible area by +holding down the &Alt; key and dragging with the &LMB; anywhere +within the screen. If you have trouble operating a mouse, you can also move screens by pressing +&Alt;F3. In +the dropdown Windows Operations Menu, choose +Move. +Move the screen with the arrow keys and press &Esc; to finish the move. + + + + + +&kmagnifier; +magnifier +The kdeaccessibility module includes a screen magnifier +application called &kmagnifier;. +If it is installed, you can run it from +K-ButtonUtilities +KMag (Screen Magnifier). + + + + +Text-to-Speech +Text-to-Speech +TTS +The kdeaccessibility module includes a Text-to-Speech +component called KTTS. If KTTS is installed, you can configure &kspread; to +speak the text that is under the mouse pointer or speak the text of each +screen widget as it receives focus. Before using this feature, first configure +KTTS. See The KTTS Handbook for details. +To turn on the TTS feature in &kspread;, +select SettingsConfigure +&kspread;... from the menubar. +This will display a dialog box. +Clicking on TTS will allow you to change +the following. + + + + + + + + + +Speak widget under mouse pointer +When checked, &kspread; will speak the text of each widget +as the mouse pointer moves over the widget. + + + +Speak widget with focus +When checked, &kspread; will speak the text of each widget +as it receives focus. + + + +Speak tool tips +When checked, &kspread; will speak the popup tool tip +for each widget in addition to the text of the widget. + + + +Speak Whats This +When checked, &kspread; will speak the Whats This help +for each widget in addition to the text of the widget. + + + +Say whether disabled +When checked, &kspread; will speak the word "disabled" +if the widget is currently disabled (grayed). + + + +Speak accelerators +When checked, &kspread; will speak the accelerator +of the widget in addition to the text of the widget. +Accelerators are the underlined letters you see in the text of the +widget. For example, in the main menu, the +Quit menu item +has the "Q" underlined. You can choose it by pressing Q. +To speak the accelerator, check this option and enter the +word you want to speak before the accelerator in the +Prefaced by the word box. In this +example shown above, &kspread; will speak "Accelerator Q". + + + +Polling interval +This option determines how often &kspread; will +check for a change in the widget under the mouse pointer or +a new focused widget. You should leave this option on the +default setting. + + + + + +If the TTS option does not appear +on this screen, you do not have the KTTS component installed +in your system. + + +Not all widgets are spoken. For example, +the items on the main menubar are not spoken. + + + + + + + +Motor Impairments and Mouseless Operation +Motor Impairments +Mouseless Operation + + +KMouseTool +If you can operate a mouse, but have trouble clicking, the +KMouseTool application may help. Run it from +K-ButtonUtilities +KMouseTool (Automatik Mouse Click). + + + + +XAccess Features +XAccess +Sticky Keys +Slow Keys +Bounce Keys + +The &kcontrolcenter; offers several keyboard features collectively called XAccess. +They include: + + +Sticky Keys +This feature permits operation of meta keys, such as +&Alt;, &Ctrl;, and &Shift; without having to hold the keys down. It is useful +when you can only use one finger or one hand to operate the keyboard. +With Sticky Keys on, press and release a &Alt;, &Ctrl;, or &Shift; key, then +press another key. The result is as if you pressed both keys at once. +Press the &Alt;, &Ctrl;, or &Shift; key again to turn off the sticky key. +Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityAccessibility +Modifier Keys. + + + +Slow Keys +This feature is useful if you have hand tremors or difficulty +accurately pressing keys. It prevents +inadvertent key presses by requiring that a key be held down for a minimum +time before it is accepted. Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityAccessibility +Keyboard Filters. + + + +Bounce Keys +This feature is also useful if you have hand tremors. It prevents +inadvertent repeated key presses by preventing another keystroke for +a certain amount of time. Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityAccessibility +Keyboard Filters. + + + + + + + +Mouse Emulation +Mouse Emulation +Mouse Emulation permits you to move and click the mouse using the keyboard. +Press &Alt;F12 to activate it. Use the arrow keys +to move the mouse pointer to the desired location, and press spacebar +to "click" the mouse. Unfortunately, you cannot use Mouse Emulation to perform +&RMB; clicks or dragging. + + + + +Mouse Navigation +Mouse Navigation +This feature permits you to emulate the mouse using the numeric keypad +of your keyboard. To activate it, go to +K-Button&kcontrolcenter; +PeripheralsMouse +Mouse Navigation. +Check the Move pointer with keyboard (using the num pad) box. When you do this, the other settings will become enabled, and you can customize the keyboard pointer behavior further, if required. + The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The 5 key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the / key (which makes it &LMB;), +* key (which makes it middle mouse button) and - (which makes it &RMB;). + Using the + emulates a doubleclick to the selected pointer button. You can use the +0 key to emulate holding down the selected pointer button (for easy dragging), +and then use the . to emulate releasing the selected pointer button. + + + + + + + + + + + +Keyboard shortcuts + +Use the Menu key to pop up the context +menu. On most keyboards, the Menu key is on the righthand +side of the keyboard between the &Windows; and &Ctrl; +keys. It has a menu icon on it. + + + + + +Resizing panels + +If you have activated two or more views of a spreadsheet, +you can move the sizing bar between the views by pressing F8. A sizing icon appears +overtop the sizing bar. Use the arrow keys to move the bar up or down, or left or right. +Press F8 again or &Esc; when finished sizing. + + + + + +Setting focus to widgets + +Normally, one can use the and &Shift; +to move focus from one widget to the next in any application. However, in &kspread;, +pressing does not move the focus; instead it moves the cell selection forwards. +You can set focus to any widget that can receive focus by +pressing &Alt;F8. A small lettered box appears +overtop each widget on the screen that can receive focus. + + + + + + + + +Press the letter to move focus to the corresponding widget. Press +&Alt;F8 again or &Esc; +to abandon moving the focus. + + + + + + + diff --git a/doc/kspread/advanced.docbook b/doc/kspread/advanced.docbook new file mode 100644 index 00000000..f6aadfab --- /dev/null +++ b/doc/kspread/advanced.docbook @@ -0,0 +1,815 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + +     +     +Advanced &kspread; + +Series +When constructing a spreadsheet you often need to include a series of +values, such as 10, 11, 12..., in a row or column. There are several ways you +can do this in &kspread;. +For a simple short series such as 5, 6, 7, 8... the Drag and Copy + method is the simplest. Enter the starting value into the starting +cell and the next value of the series into an adjacent cell. +Then select both cells and move the mouse pointer so that it is over the small +square at the bottom right corner; the cursor will change to a +diagonal double headed arrow. Then hold the left +mouse button down while you drag the cells down or across as needed. +The step size is calculated as the difference between the two starting +values that you have entered. +For example if you enter 4 into cell A1 and +3.5 into A2 then select both cells and Drag and Copy +them down, the step size will be the value in A2 minus the value +in A1, -0.5 in this case so you will get the series 4, 3.5, 3, 2.5, 2... + +The Drag and Copy method will even cope with series where +the step value is not a constant value but is itself a series. So that if you +start with 1, 3, 4, 6 Drag and Copy will extend it to 1, 3, 4, 6, 7, 9, 10, +12..., the step value in this example being the series 2, 1, 2, 1... + +&kspread; also recognizes some special series such as +the days of the week. Try entering Friday into a cell +(note the capitalization) then Drag and Copy it down. To see what special series +are available, and perhaps create your own, select Tools +Custom Lists... . + +If you select a cell and choose Series... +from the Insert menu you will see the Series + dialog box. This is useful for creating series that are too long +to be conveniently constructed using the Drag and Copy method, or for +creating geometric series such as 1, 1.5, 2.25, 3.375... where the step value, +1.5 in this case, is used as a multiplier. +If the type of series that you want is too complicated for any of the +previous methods, consider using a formula and Drag and Copying that. For +example to create a series with the values 2, 4, 16, 256... enter +2 into A1, =A1*A1 into A2, and +Drag and Copy cell A2 down. + + + +Formulae + +Built in Functions +&kspread; has a huge range of built in mathematical and other functions +that can be used in a formula cell. They can be seen and accessed by selecting +a cell then choosing Function... from the +Insert menu. This brings up the Function + dialog box. +Select the function you want to use from the listbox at the left of the +dialog box. The Help tab page will then display a description, +the return type, Syntax, Parameters, and Examples for this function. +In addition this page provides often links to Related Functions. +Then press the button with the down arrow key symbol on it to paste +it into the text edit box at the bottom of the dialog. +The Parameters tab page will then be displayed +to let you enter the parameter(s) for the function you have just +chosen. If you want to enter an actual value for a parameter, just type it +into the appropriate text box in the Parameters page. To +enter a cell reference rather than a value, left +click on the appropriate text box in the Parameters page; +then left click on the target cell in +the spreadsheet. +Instead of using the Parameters page, cell +references such as B6 can be entered by typing them +directly into the edit box at the bottom of the Function +dialog. If a function has more than one parameter separate them with a +semi-colon (;). +Pressing the OK button will insert the +function into the current cell and close the Function +dialog. +You can of course do without the Function +dialog and simply type the complete expression into the Formula toolbar's +main edit box. Function names are not case sensitive. Do not forget that all +expressions must start with an = symbol. + + + +Logical Comparisons +Logical functions such as IF(), AND(), OR() take parameters which have the +logical (boolean) values True or False. This type of value can be produced by +other logical functions such as ISEVEN() or by the comparison of values in +spreadsheet cells using the comparison expressions given in the following +table. + + +     + + Expression + Description + Example + + + +== +Is equal to +A2==B3 is True if the value in A2 is equal to +the value in B3 + + +!= +Is not equal to +A2!=B3 is True if the value in A2 is not equal +to the value in B3 + + +<> +Is not equal to +Same as A2!=B3 + + +< +Is less than +A2<B3 is True if the value in A2 is less than +the value in B3 + + +<= +Is less than or equal to +A2<=B3 is True if the value in A2 is less than +or equal to the value in B3 + + +> +Is greater than +A2>B3 is True if the value in A2 is greater +than the value in B3 + + +>= +Is greater than or equal to +A2>=B3 is True if the value A2 is greater than +or equal to the value in B3 + + + + +Thus if you enter =IF(B3>B1;"BIGGER";"") into +a cell it will display BIGGER if the value in B3 is greater than that in B1, +otherwise the cell will show nothing. + + + +Absolute Cell References +If a formula contains a cell reference that reference will normally be +changed when the cell is copied to another part of the worksheet. To prevent +this behavior put a $ symbol before the column letter, row +number or both. + + + +If A1 contains the formula =D5 then on copying the +cell to B2 it will become =E6 (the normal behavior). + + +If A1 contains the formula =$D5 then on copying the +cell to B2 it will become =D6 (column letter not +changed). + + +If A1 contains the formula =D$5 then on copying the +cell to B2 it will become =E5 (row number not +changed). + + +If A1 contains the formula =$D$5 then on copying the +cell to B2 it will remain as =D5 (neither the column +letter nor the row number are changed). + + + +When you are entering or editing a cell reference in a formula the +shortcut key F4 can be used to step through these four +possibilities. +Named cells can be used in a similar +way to include a unchanging cell reference in a formula. + + + + + +Arithmetic using Special Paste +Sometimes you may want to add a single value to a number of +cells, or subtract a value from them, or multiply or divide them all by a +single value. The Special Paste... option lets you +do this quickly and easily. +First, enter the modifier value into any spare cell on your spreadsheet +and Copy it. Then select the area of cells you want +to change, choose Special Paste... from the +Edit or right mouse button menu +and select Addition, Subtraction, +Multiplication or Division from the +Operation section of the dialog box. +You can also apply different modifier values to different rows or +columns of the target area by copying an area containing the wanted modifiers +before selecting the target area and doing Special Paste... + . For example, if you enter 5 into cell +A1, 10 into B1, select both cells and do a +Copy then Special Paste... +Addition into cells A10 to D15, 5 will be added to A10:A15 and +C10:C15, and 10 to B10:B15 and D10:D15. +Note that a modifier value can be a formula as well as a simple numeric +value. If it is a formula then &kspread; will adjust the cell references as +for a normal Paste operation. + + + +Goal Seeking +&kspread; can be used to solve algebraic expressions such as +x + x^2 = 4 or For what value of x does x + x squared +equal 4 ? +For this example you could enter =A2+A2*A2 +into A1 then either try different values in A2 until the result in A1 is as +close as you wish to 4 or, preferably, use &kspread;'s +Goal Seek feature which automatically adjusts the +value in one cell to try to make the value in another cell as close as +possible to a target value. +It is invoked by selecting Goal Seek from +the Data menu. This brings up a dialog box in which you +should enter the reference of the target value cell (A1 +in this case) into the Set cell: box, the target value +itself (4) into the To value: box +and the reference of the cell that is to be changed +(A2) into the By changing cell: +box. Note that you need to have entered some initial value into the cell that +is to be changed before starting Goal Seek. +Pressing the Start button will start the +calculation. When it finishes and if it has found a solution press the +OK button to accept the result or +Cancel to keep the original value. + + + + +Using more than one Worksheet +When you start a new, empty, document with &kspread; it will create a +number of blank worksheets. The number of sheets it creates is determined +by the Number of sheets open at the beginning: setting in +the Interface page of &kspread;'s +configuration dialog box. +InsertSheet + will add another sheet to the document. +If the Show tabs box in the Interface + page of &kspread;'s configuration dialog box is checked a small +tab will be shown near the bottom left of &kspread;'s window for each sheet. +Left click on one of these tabs to see that sheet. + +You can also switch between worksheets by using the +&Ctrl;PageDown +to move to the next sheet, +&Ctrl;PageUp to move to +the previous one. +Worksheets are given the default names of Sheet1, +Sheet2... You can give a sheet a different name by +right clicking on the tab and selecting +Rename Sheet.... +To remove a sheet from the document use the Remove Sheet + option in the Format +Sheet submenu or in the little +menu that pops up when you right click on the tab +for the sheet you want to remove. +Other entries in the Format +Sheet submenu allow you to show or hide a sheet in +much the same way as rows and columns can be hidden. +If you want a formula in one sheet to refer to a cell in another sheet, +the cell reference must start with the sheet name followed by an exclamation +mark (!). For example if you enter =Sheet2!A2 + into a cell in Sheet 1, that cell will take the value from A2 of +Sheet2. Note that sheet names are case sensitive. + + + +Consolidating Data +You may have constructed a document containing several worksheets +containing similar data but for, say, different months of the year, and wish +to have summary sheet containing the consolidated (⪚, sum or average) values +of the corresponding data items in the other sheets. +This task can be made slightly easier by using the +Consolidate... item from the Data menu. +Selecting this option brings up the Consolidate +dialog box. +For each of the source sheets, enter a reference to the desired data area +in the Reference: box. Press Add to +transfer it to the Entered references: box. The reference +should include the name of the sheet containing the source data, such as +January!A1:A10, and can be entered automatically by +selecting the area in the appropriate sheet. +After entering the references for all of the source data sheets +select the cell in the target sheet where you want the top left corner of the +consolidated results to appear. Then choose the appropriate function from +the Function: combo box and press the +OK button. +If you check the Copy data box in the +Consolidate dialog the values resulting from the consolidation will +be placed into the target cells rather than the formulae to calculate them. + + + + + +Inserting a Chart +You can insert a chart into a sheet to give a graphical view of your +data. +First select the area of cells containing the data and choose +InsertChart +. The cursor will change to a small cross shape which you +should drag across the sheet while holding the left + mouse button down to define the area where you want the +chart to appear, there is no need to be too accurate at this stage as the +chart size can easily be changed at any time. When you release the mouse +button a chart wizard dialog box will appear. +The wizard allows you to define the type of chart, labels and legend +that you need. You may wish to refer to the &kchart; Handbook at this stage, +but again if you make a wrong choice you can correct it later. +When you press the Finish button the wizard will +vanish and you will see the chart embedded into the worksheet. + + + + + + +Screenshot of embedded chart + + + +To move, resize or even delete the embedded chart click anywhere +within the chart area. It should now appear with a diagonal hatch border +and with a small black square at each corner and in the middle of each edge. + +If you move the cursor over any of the black squares it should change +to a double headed arrow. You can resize the chart by dragging one of these +squares with the left mouse button pressed. To +delete the chart right click on one of the +squares and select Delete Embedded Document. +To move the chart move the cursor so that it is over one of the +hatched borders. The cursor should then change to a hand, press the +left mouse button and you will be able to drag the +chart to where you want it to be. +To restore the chart to its normal appearance simply click anywhere +outside of the chart area. +To change the format of the chart itself left +click twice within the chart area. It should then appear with a diagonal +hatch border without any small black squares and &kchart;'s +Chart Toolbar should appear in &kspread;'s window. You can then +use these &kchart; tools or a selection from the menu that pops up when you +right click in the chart area to change the chart. + + + +Inserting External Data +You can insert data from a text file or from the clipboard into a +worksheet by first selecting the cell where you want the top left item of the +inserted data to appear, then choosing From Text File... + or From Clipboard... from the +InsertExternal Data + sub menu. +In both cases &kspread; will assume that the data is in +CSV form and will open a +dialog box allowing you to control how the data is extracted from the file or +clipboard and placed into the worksheet cells. +If support for it has been included in your system, &kspread; can also +insert data from a SQL database into a worksheet. This is +done by using the Insert +External DataFrom Database... + option. + + + +Link Cells +A spreadsheet cell can be linked to an action so that +left clicking on the cell will, for example, open your +browser. To make a cell act in this way select it and choose +InsertLink... +. This will bring up the Insert Link +dialog box, which lets you choose between four types of link: + + +An Internet link cell will try to +open your default browser at the &URL; entered in the +Internet address: text box of the Insert +Link dialog when it is clicked. This could be, for example, +http://www.koffice.org. + + +Clicking on a cell containing a Mail +link will open your email composer using the address entered in the +Email: text box as the To: address. For example +anon@example.com. + + +A File link cell holds the path to +a file or folder, as entered into the File location: +text box, and will try to open that file or folder with a suitable +application when clicked on. + + +The Cell type of link cell holds a +&kspread; cell reference, entered in the Cell: text box. +Left clicking on this type of link cell causes +&kspread;'s focus to move to the target cell. + + + +All four types of link cell need some suitable text to be entered into +the Comment: field of the Insert Link +dialog. This is the text that appears in the cell, you can set +its style to Bold or Italic if you +wish. + + + +Validity Checking +&kspread; can automatically check the validity of entered data against +a number of criteria, and pop up a message box if the data is invalid. +To enable this feature, select the cell(s) to be monitored and choose +EditValidity... +. This will bring up &kspread;'s Validity +dialog box which has two tabbed pages. +In the Values page select what type of data is to +be considered valid from the Allow: combo box list then +define the valid range of values by choosing one of the options in the +Data: combo box and entering suitable value(s) into +one or both of the edit box(es). +When you have done this change to the Error Alert +tab page. Here you can choose the type of message box +(Stop, Warning +or Information) that will appear when an invalid +value is entered, and define the message box title and message text. +Note that this feature only checks data that you enter into the cell, +for a way of checking the results from formulae cells see the Conditional Cell Attributes section of this +Handbook. + + + +Protection + + +Document Protection +Protecting the document means that without the password a user cannot add +or delete sheets. Document protection does not protect cells. +Select ToolsProtect +Document.... +A dialog appears asking you for a password. The Password: strength meter +indicates if your password is secure enough. The longer the indicator is, the +more secure your password. + + + + + + +The Protect Document dialog + + + +That password will then be required to unprotect the document. + + + + + + +The Unprotect Document dialog + + + +When a document is protected, you may not: + + +Rename a sheet + + +Insert a sheet + + +Remove a sheet + + +Hide a sheet + + +Show a sheet + + +See the sheet properties + + +Merge or dissociate cells + + + + + +Sheet protection +Protecting a sheet means protecting the contents of all protected cells +and objects on a sheet. Individual cells or a selection of cells can be +unprotected within a protected sheet, see next section. +To protect a sheet, select +ToolsProtect Sheet.... +A dialog appears asking you for a password. The Password strength meter +indicates if your password is secure enough. The longer the indicator is, the +more secure will be your password. +That password will then be required to unprotect the sheet. +When a sheet is protected, you may not: + + +Insert any object or chart + + +Format any cell + + +Insert a row or a column + + +Edit and change cell content + + +Change any content in the sheet + + + +Protecting a sheet is especially useful for preventing accidental +erasure of formulae. + + + +Cell or selected cells protection +Cell protection is active for all cells by default and is +effective when you enable sheet protection. So if you keep the default and if +you protect the sheet, all cells will be protected. +If you want only certain cells to be protected, this default protection +must be turned off for all other cells. For example you might want most cells +to accept user input so you will uncheck Protected for +those and choose to keep protected cells that should stay unchanged (such as +titles). So you need 3 steps in order to protect only some cells: unprotect all +the cells, select the cells to protect and protect them and then protect the +whole sheet. +To unprotect all the cells: + + +Select the entire spreadsheet with the mouse. + + +In the menubar, select FormatCell +Format.... + + +In the dialog that appears, go to the Cell Protection tab. + + +Check Hide all and uncheck Protected +to remove the protection on all cells. The cells are now all unprotected. + + +To protect a range of selected cells or a selection of non-contiguous +cells: + + +Highlight the range of cells that are to be protected or use the &Ctrl; key to select non-contiguous cells. + + +When all of the desired cells are selected, go to +the FormatCell +Format... menu. + + +In the dialog that appears, go to the Cell Protection tab. + + +Click on the box next to Protected then click +on OK. + + +Once the cells are marked for protection, the protection option must be +enabled at the sheet level, that means you must protect the entire sheet for the +cell to be effectively protected: + + +Select +ToolsProtect Sheet.... + + +In the dialog that appears, provide a safe password, then confirm it by typing +it again. Click on OK. + + +Protected cells in a protected sheet cannot be edited without unprotecting the +whole sheet, and any sheet changes are disabled. For example, no one can +insert rows or columns, change column width, or create embedded charts. + + + + + +Hide cell formula +You might want to hide your formulae so other people cannot see +them. By default, every cell is protected and not hidden. But it is important to +remember that these attributes have no effect unless the sheet itself is +protected. + + + + + + +A default cell with a formula + + + +To hide cell formulae, select the appropriate cell or range of cells or +non-contiguous cells with &Ctrl; and +then choose the FormatCell +Format... menu. In the Cell format +dialog, click the Cell Protection tab and select Hide formula. +After you protect the sheet, the results of the formulae will be visible, but +the formulae will not. +You have now to protect the sheet: choose +ToolsProtect Sheet... +to display the Protect Sheet dialog box. Enter a safe password twice to prevent +others from unprotecting the sheet. +When Hide formula is enabled and +Protected is disabled, the formula is hidden after +protecting the sheet but the cell content can be changed. + + + + + + +Hide formula is enabled but the cell is not protected and the +sheet is protected + + + +When Hide formula and Protected +are enabled, the formula is hidden after protecting the sheet and the cell +content cannot be changed. + + + + + + +Hide formula and Protected are enabled in Cell Protection and the +sheet is protected + + + +Keep in mind that it is very easy to break the password for a +protected sheet so if you are looking for real security, this is not the +best solution. + + + +Hide all in the cell +You can hide both the formula and the content of the cell by +choosing Hide all in the Cell Protection tab in the +FormatCell +Format... menu. In the screenshot below, the +cell itself is not protected (Protected is unchecked) thus +the cell content can be changed. + + + + + + +Hide all only is enabled (no cell protection) and +the sheet is protected + + + +Here the cell itself is protected so it cannot be overwritten. + + + + + + +Hide all and Protected are +enabled in Cell Protection and the sheet is protected + + + + + + + + +Other Features + + +Splitting the View +If your spreadsheet is so large that you cannot see all of it at once, +splitting &kspread;'s window into two or more views can help you work on it. +This is done by selecting View +Split View which will split the current view into +two parts. ViewSplitter Orientation + lets you choose between +Horizontal and Vertical +splitting. +This technique is particularly useful when you want to select an area +of the spreadsheet that is larger than can be shown in one view, perhaps to +paste a copied cell into it. +Use the scrollbars to position the two views to show the top left and +bottom right cells of the wanted area, select the top left cell in one +view then hold the &Shift; key pressed while you select the +bottom right cell with the left mouse button. +If there is more than one sheet in your document, you can show a +different sheet in each of the split views. +The relative sizes of the views can be changed by dragging the thick bar +separating the views. +To remove a view select View +Remove View + + + + +Named Cells and Areas +You can give a name such as foo to a cell or to +any area of a sheet by selecting the cell or area then selecting +Area Name... from the right mouse +button menu. This will bring up the Area Name dialog box +where you can enter any name you wish. +You can also name a cell or area by selecting it then typing the name +into the small text box at the left end of the Formula toolbar, overwriting the +cell reference that normally appears here. +If you enter a name that has already been used into this text box +&kspread;'s selection will change to show the named cell(s). +The DataShow Area... + option will give you a list of existing names +and let you change &kspread;'s focus to any of them or let you remove a name. + +Named cells are particularly useful in formulae as an alternative to + absolute cell references as the names can +be used in place of normal cell references and do not change when the +cell containing the formula is copied. When a name is used in this way it +should be enclosed in single quotation marks. +For example, if cell A1 has been given the name fred + then you can enter a formula such as ='fred' + 2 + into another cell which would always give the result of adding +2 to the value in A1 no matter where the formula cell was copied to. +Note that cell and area names are treated as being in lowercase. + + + +Cell Comments +A cell can contain a text comment that can be viewed when working on +the spreadsheet but which is not printed and not normally seen. +To add a comment select the cell and choose Add/Modify +Comment... from the right mouse +button menu or from the Insert +Cell Comment menu and type your comment into the +resulting Cell Comment dialog box. +To see the comment hover the mouse pointer over the top right corner of +the cell. The comment will appear as if it were a Tooltip. + +If you check the Show comment indicator box of the +Sheet Properties dialog, those +cells containing comments will be highlighted by a small red triangle in the +top right corner. +To open this dialog, click with the right mouse +button onto the sheet tab at the bottom of the main window and select +Sheet Properties from the popup menu. Or select it from the +FormatSheet menu. + +To remove a comment from a cell, select Remove Comment + from the right mouse button menu or +choose EditClear +Comment. + + + + + + + diff --git a/doc/kspread/basics.docbook b/doc/kspread/basics.docbook new file mode 100644 index 00000000..2a06be21 --- /dev/null +++ b/doc/kspread/basics.docbook @@ -0,0 +1,637 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +     +     +&kspread; Basics + +Like the rest of &kde;, &kspread; is highly configurable, which can +cause problems for readers trying to compare the text in a document such as +this with what they see on the version of &kspread; running on their desktop. +To cut down on some of the possibilities for confusion, it it suggested that +when you first start to use &kspread; you set the default options in all pages +of the &kspread; configuration dialog (obtained by selecting +SettingsConfigure +&kspread;...) except for Completion mode: + in the Misc page, which should be set to +None. + +You may also find it helpful to globally Enable tooltips +in &kcontrolcenter; in Appearance & +ThemesStyle +on the Style page. + + +Spreadsheets for Beginners + +This section attempts to explain by example what a spreadsheet program +such as &kspread; actually does, and why it is such a useful tool in any +situation where you have to deal with numbers. If you have already used a +spreadsheet program you may wish to skip to the next section. + +The first thing to do is to start up &kspread;. You can do this by +left clicking on a &kspread; icon if there is one +on your desktop or panel, or you can select +Office&kspread; + +from the K menu. + + + + + + + +&kspread; at first run + + +When it has started you will be given the choice of opening a recent +document, creating a new document from a template (with templates categories) or +opening an existing document . Select the General category +on the left and choose the Blank Worksheet template. Then +click the Use This Template button. + +Looking at &kspread; once it has started up, you will see a sheet of +empty rectangular cells arranged in numbered rows and lettered columns. This +is where you enter data or formula, text or charts. + + + + + +Screenshot starting1 + + + +Now, enter the text and values shown in the first 5 rows of the above +screenshot into the same cells of your spreadsheet. Ignore what is in row 7 +for the moment. To enter anything into a cell first select the cell by +left clicking inside it, then type whatever you +want, then press Enter or use the arrow keys to move the +selection point to another cell. + +What we have entered so far could be a simple budget for the next two +months, listing how much we think we will be spending for Food, Shelter, +Clothing and any Other expenditure. Now select cell B7 (column B, row 7), +type in =B2+B3+B4+B5 and press Enter. +Because it begins with a = symbol &kspread; sees this as a +formula, something it has to calculate, in this case by adding together the +values in the 4 cells B2 to B5, and what is shown in the cell B7 is the result +of that calculation. +You could enter a similar formula into cell C7, except that in this case +it would have to be =C2+C3+C4+C5, but there is an +easier way which is to Copy cell B7 and Paste it into C7. &kspread; will +automatically adjust the cell references from B.. to C.. when the Paste is +done. +At this point you may think that &kspread; is doing no more than you +could manage with pencil, paper and a calculator, and you could be right, but +remember that this is a very small example of a spreadsheet, doing simple +calculations on only a few numbers. For any reasonably amount of values or data +using a spreadsheet to do the calculations is much quicker and more accurate +than doing them manually. +Also, a spreadsheet lets you play the What if? game. +Because each formula is automatically recalculated whenever any of the values +it refers to are changed, you can quickly see what happens if you alter any of +them. Using our example you can see the effect of reducing the amount spent on +food in December by just entering a new value into cell C2. If you had a +spreadsheet that modelled the greenhouse effect accurately you could perhaps +see the effect of a 50 percent reduction in the amount of methane released +into the atmosphere. + + + +Selecting Cells +You can select a single cell or a rectangular area of cells in the +spreadsheet. The selected cell(s) are displayed with a thick black border. + + +You can select a single cell in one of the following ways +left click on it +enter the cell reference (for example B5) +into the cell reference box at the left end of the Formula toolbar and press +Enter +use the ViewGoto +Cell... menu option + + +You can also steer your way around with the arrow keys. +Pressing the Enter key will move the current selection one +position up, down, left or right depending on the setting in the Misc + page of &kspread;'s configuration dialog +box. If you hold the &Shift; key down while using the +arrow keys the selection will move to the start or end of the +block of occupied cells. +To select an area of contiguous cells drag the mouse cursor across the +desired area with the left button held down, or enter +the references of the top left and bottom right cells separated by a colon into +the Formula toolbar cell reference box (for example B7:C14 +) and press Enter, or enter these cell references +in a similar format into the dialog box brought up by +ViewGoto Cell.... +You can also select an area of cells by selecting the cell in one corner +of the wanted area then holding the &Shift; key down while using the +left mouse button to select the cell in the opposite +corner. + +To select a complete row or column of cells left + click on the row number at the left of the worksheet or on the +column letters at the top. To select adjacent rows or columns drag the mouse +pointer over the appropriate row numbers or column letters with the +left button held down. + +To select non-contiguous cells, click on the first cell you want to select +then hold the &Ctrl; key and select the other +cells. + + + + +Entering Data +Entering data into a cell can be as simple as selecting the cell, typing +your data, then pressing Enter or moving the selection to +another cell with one of the arrow keys. Depending on how you +enter the data, &kspread; will interpret it as a number, date, time or text: + + +Numbers are entered in the obvious way; 123, +-123, 456.7 or in scientific notation +-1.2E-5. + + +Dates should be entered in your System format, as defined in +the &kcontrolcenter; in +Regional & Accessibility +Country/Region & LanguageTime & Dates + dialog box. If, for example, you are using the DD/MM/YYYY form +you should enter 30/03/2002 for 30th March 2002. +Leading zeroes can be omitted from the day and month fields and only the last +one or two digits of the year need to be entered if the date is in the current +century, for example 9/1/2 for 9th January 2002. + + +Times should also be entered using the System format. For +example if you are using a 12 hour clock then enter times in HH:MIN am|pm or +HH:MIN:SS am|pm format such as 9:42 am or +10:30:52 pm. + + +&kspread; defines any input data as text if it cannot +recognize the data as being a number, date or time. + + +By default, &kspread; right justifies numbers, dates and times +within a cell and left justifies anything else. This can be a useful guide +to whether you have entered a date or time in the correct format. But +remember that how items are displayed can be changed by altering +the cell format. + +The main text entry box in the Formula toolbar provides an easy way of +editing the contents of a selected cell. Press Enter or +left click on the green tick mark when you are +happy with what you have entered, or click on the red cross to cancel your +edits. + + +Generic Cell Format + +&kspread; uses the Generic cell format as default. As long +as this format is used, &kspread; autodetects the actual data type depending +on the current cell data. For example if you enter some text into a cell and +later enter a number into the same cell, &kspread; automatically interprets +the new data as a number. If you want to define the type of data yourself, you +can explicitly set it in the cell format. +You can change the format back to Generic at any time. + + + + + + +Copy, Cut and Paste + +At first glance, &kspread;'s Cut, +Copy and Paste appear +to be similar to these functions in other &kde; applications. Having selected +a cell or cells, you can choose Copy or +Cut from the Edit menu or from +the drop down menu you get by holding the right +mouse button down on a selected cell. You can also use the shortcuts +&Ctrl;C + or &Ctrl;X +, then move the selection to the target cell and choose +Paste or press +&Ctrl;V. However there are some +subtleties associated with these functions in &kspread; and these are discussed +below. + +If a cell contains a formula then the formula itself is copied rather +than the displayed result, and if the formula contains a reference to another +cell, then that reference is changed by the Cut +or Copy and Paste +operation to point to the cell that is in the same relative position as in +the original cell. For example if cell A2 contains the formula +=B3 and is copied to C4, cell C4 will contain =D5 +. +This may seem to be a rather strange way of doing a copy, but +99 percent of the time it is exactly what is wanted (if it is not then see the +section about absolute cell references). +For example in the simple shopping list shown below, cell D2 should contain +=B2 * C2, D3 should be =B3 * C3, +D4 should be =B4 * C4 and so on. Instead of having to +enter a different formula in each cell, you can just enter the first formula +into D2 and then copy it into the cells below, letting &kspread; adjust the +cell references to suit. + + + + + +Screenshot copy1 + + + + +Copying and Pasting Cell Areas +In the above example D2 can be copied into all three cells D3 to D5 at +once by just copying D2 then selecting the complete cell area D3:D5 before +doing the paste. +A rectangular area of cells can be cut or copied in one operation by +selecting the area before doing the cut or copy. Then select the top left +corner cell of the area you want to paste into before doing the paste. +If you cut or copy a rectangular area of cells, say B2:C3, and paste it +into a larger area such as A10:D13 the original pattern of cells will be +repeated to fill the target area. +&kspread; also provides a Drag and Copy method for +copying cells down into other cells immediately below or to the +right of the original cell(s). To use this method select the cell(s) to be +copied then position the mouse pointer over the small black square at the +bottom right corner of the selected cell(s) so the cursor changes to a double +headed arrow. Then hold the left mouse button down +while you drag the selected cell(s) as far as you wish. Note that cell +references in formulae are incremented according to the +relative position change. Absolute references are not changed. + + + +Other Paste Modes +A cell may contain text, a value, or a formula, and may also contain +special font, border or background formatting +information. &kspread; has special versions of Paste that let +you handle these items in different ways. + +EditSpecial +Paste...brings up the Special +Paste dialog box. By selecting the appropriate item from +the top part of this dialog you can choose to paste just +Text , the cell Format, any +Comment in the cell(s) or Everything +without border. The items in the bottom part of this dialog +box allow you to do simple arithmetic +on an area of cells. + + +Paste with Insertion... inserts the copied +cell(s) into the sheet by moving the cells that would otherwise be overwritten +a suitable number of rows of columns down or to the right. It can also be used +to insert complete copied row(s) or column(s) into the worksheet. + + + + + +Insert and Delete +Use the Delete key or Edit +ClearText + to remove the text, value or formula from selected cell(s), +row(s) or column(s) without affecting anything else. + +To delete everything in the selected cell(s), row(s) or column(s), +including comments and special formatting, use +&Shift;Delete or choose the Delete + option from the Edit menu or from the pop +up menu you get when you right click on a selection. + +To remove selected row(s) or column(s) completely, use the +Delete Rows or Delete +Columns options from the right mouse +button pop up menu. +If you select a cell or cells and choose Remove Cells... + from the right mouse button pop up +menu, you can then choose whether other cells in the worksheet will be moved +up or to the left to fill in the space left by the cell(s) you have chosen to +remove. +If you want to insert new, blank, row(s) or column(s) into the +sheet, select row(s) or column(s) where you wish the new row(s) or +column(s) to be placed and choose the Insert Rows, +Insert Columns option from the +right mouse button pop up menu. +You can insert new cells into the worksheet by selecting the +area where you want them to appear then choosing the +Insert Cells... option from the right +mouse button pop up menu. You will then be asked whether the existing cell(s) +in the selected area should be moved down or to the right to make room for the +new ones. + + + + +Simple Sums +If the first character in a cell is an equals sign (=) +&kspread; will take the cell contents to be a formula which is to be +calculated. The result of the calculation will be displayed in the cell rather +than the formula itself. For example, enter =2+3 +into a cell and it should display 5. +More usefully, a formula can contain references to other cells, so +that =B4+A3 will calculate the sum of the values in +cells B4 and A3, and this calculation will be updated whenever cells B4 or A3 +are changed. +As well as addition, a formula can make use of the - +symbol for subtraction, * for multiplication, and +/ to perform division. The round bracket symbols ( +and ) can also be used as in normal algebra, so you could +enter more complex formulae such as =((B10 + C3) *5 - F11) / 2 +. + +Cells containing a formula will be marked with a small blue triangle +at the bottom left corner if the Show formula indicator +check box in the Format +SheetSheet Properties + dialog is checked. +&kspread; also includes a large number of built-in functions for +applications such as statistical, trigonometrical and financial calculations. +Their use will be examined in more depth in a +later section of this manual, but if you are interested at this stage +choose Function... from the Insert + menu and take a look through the Function + dialog box that will be displayed.. +For the time being, however, the SUM function may +be of interest as it calculates the sum of all values in a specified area of +cells. For example =SUM(B4:C10) calculates the sum of +all values in the cell area B4 to C10. +If &kspread; displays a row of # symbols when you have +entered your formula this usually means that it cannot understand what +you have entered, but if the row of # symbols ends with a +small red arrow this just means that the cell is not wide enough to display +the complete result, in which case you should either make the cell(s) wider +or change their format so that the result +does fit properly. + + +Recalculation +If the Automatic recalculation box in the +Format +SheetSheet Properties + dialog box is +checked, &kspread; will recalculate the values of cells whenever anything that +affects them is changed in the sheet. +When Automatic recalculation is not checked for the current sheet, you can instruct &kspread; to perform a recalculation at any time by +using the Recalculate Sheet or +Recalculate Document option in the Tools +menu or their shortcuts &Shift;F9 + or F9. + + + + +Sorting Data +In the simple example shown below, the data consist of the names and +countries of a number of mountains together with their height above sea level. +&kspread; can sort data such as this in different ways. + + + + + + +Screenshot of sorted data + + + +We may want the data sorted so that the names are in +alphabetical order. To do this select the area containing the data (A2:C7 +in this case) and choose Sort... from the Data +menu. This opens the Sorting dialog box. +Sorting is done alphanumerically, and the default is case sensitive, numbers coming +before uppercase letters which come before lowercase letters, so that cells +containing the entries Cat, bar, +77 and Bat would be sorted into +the following order: 77 Bat Cat bar. + +Using the Sort Criteria page of this dialog box +lets you Sort Rows or Sort Columns. +If you check the First row contains headers box data in the +first row will not be included in the sort operation. +You can choose which column or which row of the data is to be used as a primary sort key and, +if you wish, other columns or rows to be used as secondary and tertiary keys. Using +the example in the above screenshot, choosing column B as the first key and +column C as the second would sort the data by country and, for each country, +by height. + +The Options page of the dialog allows you to sort using the +order of items in a custom list such as January, February... instead +of alphanumerically. +The cell format is moved with the cell content, if you select +Copy cell Formatting (Borders, Colors, Text Style) +Uncheck the option Case sensitive sort to get a sort +not depending on capitalization. + + + + + +The Status bar Summary Calculator +The left hand end of the Status bar shows a summary of the values in +the selected cell(s). According to the setting of the Method of +calc: combo box in the Misc page of +&kspread;'s configuration dialog the summary can be: + + + +Sum +The value displayed is the sum of the values in the selected +cells. + + + + +Min +The value displayed is the minimum of the values in the selected +cells. + + + + +Max +The value displayed is the maximum of the values in the selected +cells. + + + + +Average +The value displayed is the average of the values in the selected +cells. + + + + +Count +The value displayed is the number of cells containing numeric +values. + + + + +None +No summary calculation is performed. + + + +The method of calculation can also be changed by right + clicking on the summary calculation result area of the +Status bar and choosing an item from the pop up menu. + + + + +Saving your Work +&kspread; saves the complete document, which may include more than one +worksheet, as a single document file. +If you have created a new document, or want to save an existing one +under a different name, use File +Save As.... This will bring up &kde;'s common +Save Document As dialog box. +Choose the folder where you want to save the document and enter a +suitable file name into the Location: text box. &kspread; +documents are normally automatically saved with a .ods +extension, you do not need to add this to the filename but do make sure that +the Filter: selection is set to +OASIS OpenDocument SpreadSheet. +To save your document without changing its name, just use +FileSave. + +You can also save a &kspread; document in a foreign format: see + the Import/Export section for more information +about doing this. +When you save a modified version of an existing document +&kspread; will keep the previous version as a backup file, adding a +~ to the end of the filename. +&kspread; can provide some protection against losing your work because +of a computer crash or because you have closed &kspread; without saving the +current document. It does this by automatically saving the latest version of +the document you are working on every few minutes using a modified file name. +The autosaved version is normally removed when you next save your document, +so that it will only exist if it is more up to date than the version that was +saved manually. +When you open a document &kspread; checks to see if an autosaved +version exists, and if it finds one it will offer to open that instead. +Autosaved documents are saved with a file name of the form +.yourfilename.autosave (note the leading period), +so that spread1.ods would be autosaved as +.spread1.ods.autosave. The autosave feature is +user configurable in the settings dialog. + + +Templates +If you are going to be creating a lot of similar documents you can +save yourself time and trouble by first creating a template and then +using that as the basis for the individual documents. +To do this first create a document containing the common elements, +then save it as a template by choosing File +Create Template From Document.... +Doing this opens the Create Template dialog box. +Enter a name for your new template into the Name: text +box and press OK. The next time you start a new +document by choosing FileNew + or when you next start &kspread; the +startup dialog window will give you the option of creating the +new document from your template. +The Create Template dialog box also lets you +choose a different picture to be displayed above the template name in the +startup dialog window, and lets you save your templates +under different group names, which will appear as different pages in +the dialog. + + + + + +Printing a Spreadsheet +Printing a spreadsheet is basically done by selecting +FilePrint... which +brings up &kde;'s common Print dialog box where you can +choose, among other options, the printer to be used, the number of copies and +whether all or only selected pages are to be printed. +By default &kspread; will print all items in the current worksheet, but +you can restrict this by first selecting the area that you want to be +printed then choosing Define Print Range from the +FormatPrint Range + sub menu. +&kspread; will print as many pages as are necessary to include all +items in the current worksheet. You can quickly see how a worksheet will be +spilt into separate pages for printing by checking the +View +Show Page Borders box. The boundaries +of each printed page will then be marked by colored lines in the +worksheet. + +For a more detailed view of what is to be sent to the printer, including +anything you have asked to be included in the page headers and footers (see +below), choose FilePrint +Preview.... + +To improve the appearance of the printed output , you can change the +fonts, colors, borders and sizes of the cells in the worksheet, see the +Spreadsheet Formatting section for more +details about how to do this. + +You can also use the Page Layout dialog box, +invoked by selecting FormatPage +Layout..., to change the orientation of the printed +pages, the paper size (this should be suitable for your printer) and the size +of the page borders. +The Header & Footer page of the +Page Layout dialog box also lets you add text, including items such +as the filename, date and page number to the header and footer, of each +printed page. +The Ranges section of the Options + page of the Page Layout dialog box provides +an alternative way of restricting the printed output to just one part of the +worksheet and allows you to repeat selected column(s) or row(s) on each printed +page. This page also lets you select whether or not to print the grid, +comment indicators and formula indicators, objects and charts. +In the section Scale Printout you can set a scalefactor +or limit the number of pages for the print. + + + +     + + diff --git a/doc/kspread/cellformat0.png b/doc/kspread/cellformat0.png new file mode 100644 index 00000000..fe692bf8 Binary files /dev/null and b/doc/kspread/cellformat0.png differ diff --git a/doc/kspread/cellformat1.png b/doc/kspread/cellformat1.png new file mode 100644 index 00000000..cf3a2333 Binary files /dev/null and b/doc/kspread/cellformat1.png differ diff --git a/doc/kspread/cellformat2.png b/doc/kspread/cellformat2.png new file mode 100644 index 00000000..a7752f03 Binary files /dev/null and b/doc/kspread/cellformat2.png differ diff --git a/doc/kspread/cellformat3.png b/doc/kspread/cellformat3.png new file mode 100644 index 00000000..eb36f521 Binary files /dev/null and b/doc/kspread/cellformat3.png differ diff --git a/doc/kspread/cellformat4.png b/doc/kspread/cellformat4.png new file mode 100644 index 00000000..2bb29706 Binary files /dev/null and b/doc/kspread/cellformat4.png differ diff --git a/doc/kspread/cellformat5.png b/doc/kspread/cellformat5.png new file mode 100644 index 00000000..5c4b7b15 Binary files /dev/null and b/doc/kspread/cellformat5.png differ diff --git a/doc/kspread/cellformat6.png b/doc/kspread/cellformat6.png new file mode 100644 index 00000000..358ede34 Binary files /dev/null and b/doc/kspread/cellformat6.png differ diff --git a/doc/kspread/cellformat7.png b/doc/kspread/cellformat7.png new file mode 100644 index 00000000..2760c71d Binary files /dev/null and b/doc/kspread/cellformat7.png differ diff --git a/doc/kspread/cellprotection1.png b/doc/kspread/cellprotection1.png new file mode 100644 index 00000000..6f95cb94 Binary files /dev/null and b/doc/kspread/cellprotection1.png differ diff --git a/doc/kspread/cellprotection2.png b/doc/kspread/cellprotection2.png new file mode 100644 index 00000000..eda1e10c Binary files /dev/null and b/doc/kspread/cellprotection2.png differ diff --git a/doc/kspread/chart1.png b/doc/kspread/chart1.png new file mode 100644 index 00000000..3cdf6055 Binary files /dev/null and b/doc/kspread/chart1.png differ diff --git a/doc/kspread/commands.docbook b/doc/kspread/commands.docbook new file mode 100644 index 00000000..1c2ae044 --- /dev/null +++ b/doc/kspread/commands.docbook @@ -0,0 +1,1540 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +     +     +Command Reference + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New + +Create a new document. + + + + + +&Ctrl;O + +File +Open... + +Open an existing document. + + + + +File +Open Recent + +Open an existing document by selecting it +from a combo box of recently used files. + + + + + +&Ctrl;S + +File +Save + +Save the document. + + + + +File +Save As... + +Save the document with a new name or format. + + + + + +File +Reload + +Reloads the document. + + + + + +File +Import... + +Import other documents. + + + + + +File +Export... + +Save a document to any supported format. +The document does not become the exported file. + + + + + +File +Mail... + +Send the file as an email attachment. + + + + + +File +Create Template From Document... + +Create a &kspread; template +based on this document. + + + + + + +&Ctrl;P + +File +Print... + +Print the document. + + + + +File +Print Preview... + +View the document as it will be printed. + + + + + +File +Document Information + +View or enter information about the document and +author. + + + + + + +&Ctrl;W + +File +Close + +Close the current document but leave &kspread; running. + + + + + + +&Ctrl;Q + +File +Quit + +Quit &kspread;. + + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + + + +&Ctrl;Z + +Edit +Undo + +Undo the last action. + + + + + +&Ctrl;&Shift;Z + +Edit +Redo + +Redo the last undone action. + + + + + + +&Ctrl;X + +Edit +Cut + +Put selected item(s) into the clipboard and remove +them from the original location. If you then +do a Paste the item(s) will be be inserted at +the new location. + + + + + + +&Ctrl;C + +Edit +Copy + +Copy selected item(s) to the clipboard. + + + + + + +&Ctrl;V + +Edit +Paste + +Paste item(s) from the clipboard to the selected +cell(s). + + + + + +Edit +Special Paste... + +Special forms of Paste. + See the sections Other Paste +Modes and Arithmetic using Special +Paste for more details. + + + + + +Edit +Paste with Insertion + +Move content of the paste area either to the right +or down and paste item(s) from the clipboard to the selected cell(s). + + + + + +Edit +Fill + +Fills up the selected area with the values from the +first item-set. All four directions are supported. Note that the +term "item-set" describes the first set of values seen in the fill direction. +If the fill direction is Left then the first item-set is the last column of the +selection. + + + + + + +&Ctrl;F + +Edit +Find... + +Find cell containing given text. + + + + + + +F3 + +Edit +Find Next + +Find the next cell containing given text. + + + + + + +&Shift;F3 + +Edit +Find Previous + +Find the previous cell containing given text. + + + + + + +&Ctrl;R + +Edit +Replace... + +Find and replace given text in cell(s). + + + + + +Edit +Clear + +Clear Text, +Comment, Validity or +Conditional Cell +Attributes from selected cell(s). + + + + + +Edit +Delete + +Delete everything from selected cell(s). + + + + + +Edit +Remove Link + +Remove the link while leave the displayed text. + + + + + +Edit +Conditional Cell Attributes... + +Add or modify conditional cell attributes. + + + + + +Edit +Validity... + +Set or modify the error checking criteria and error +alert message for selected cell(s). See +Validity Checking for more details. + + + + + + +&Ctrl;M + +Edit +Modify Cell + +To modify selected cell in-situ. + + + + + + + + +The <guimenu>View</guimenu> Menu + + + + + +View +New View + +Open a new instance of &kspread; +with the same document. + + + + + + +&Ctrl;&Shift;W + +View +Close All Views + +Close all open instances of &kspread; + + + + + +View +Split View + +Split current view into two parts. + + + + + +View +Remove View + +Remove current view. (Where the window +contains two or more views) + + + + + +View +Splitter Orientation + +Change view split to Horizontal or Vertical. + + + + + +View +Goto Cell... + +Change &kspread;'s focus to show defined cell. + + + + + +View +Show/Hide Page Borders + +Toggle marking of printed page borders in the sheet +with red lines. + + + + + + +View +Zoom + +Increase or decrease the magnification used to display +the spreadsheet. Range from 33% to 500%. + + + + + + + + + + +The <guimenu>Insert</guimenu> Menu + + + + + + + +Insert +Cell Comment + +Add/Modify Comment... or +Remove Comment. + + + + + +Insert +Function... + +Insert a mathematical function. See the +section Formulae for more details. + + + + + +Insert +Series... + +Insert a series. See the section +Series for more details. + + + + + +Insert +Link... + +Insert a link into the selected cell. +See the section +Link Cells for more details. + + + + + +Insert +Special Character... + +Insert a special character into the selected cell. + + + + + +Insert +Object + +Embed another &koffice; document into the sheet. + + + + + +Insert +Chart + +Insert a chart. See the section +Inserting a Chart for more details. + + + + + +Insert +Picture + +Opens the standard &kde; file dialog +to insert a picture. + + + + + +Insert +External Data + +Insert data From Database..., +From Text File... or From +Clipboard.... See the section Inserting +External Data for more details. + + + + + + + + +The <guimenu>Format</guimenu> Menu + + + + + +&Alt;&Ctrl;F + +Format +Cell Format... + +Format selected cell(s). See the +Spreadsheet Formatting section for more +details. + + + + + +Format +Properties + +Opens a dialog to change the properties of +an inserted object or picture. + + + + + +Format +Change Angle... + +Change angle of displayed text in selected cell(s). + + + + + + +Format +Decrease Indent + +Move text in selected cell(s) to the left. + + + + + +Format +Increase Indent + +Move text in selected cell(s) to the right. + + + + + +Format +Increase Precision + +Increase displayed precision of numbers in selected +cell(s). + + + + + +Format +Decrease Precision + +Decrease displayed precision of numbers in selected +cell(s). + + + + + +Format +Adjust Row & Column + +Set row and column sizes to show selected cell(s) +properly. + + + + + +Format +Row + +Resize, equalize, hide or show row(s). + + + + + +Format +Column + +Resize, equalize, hide or show column(s). + + + + + +Format +Sheet + +Remove, hide, show worksheet or configure +advanced sheet properties. + + + + + +Format +AutoFormat... + +Autoformat the selected cells: a dialog let you choose betwen two proposed formats. + + + + + +Format +Style Manager + +Create, Modify or delete cell format styles. + + + + + +Format +Style + +Apply a style to selected cell(s). +To manage styles use +FormatStyle Manager... + + + + + + +Format +Create Style From Cell... + +Create a new style from the format of the +selected cell. +To manage styles use +FormatStyle Manager... + + + + + + +Format +Page Layout... + +Format printed page layout. + + + + + +Format +Print Range + +Define or reset the print range. + + + + + + + +The <guimenu>Data</guimenu> Menu + + + + +Data +Sort... + +Sort data in selected cells. See the section +Sorting Data for more details. + + + + + +Data +Text to Columns... + +This option attempts to interpret text in the selected cell(s) +as CSV data, placing each +item into a different cell in the row. + + + + + +Data +Insert Columns + +Insert new column(s) at left of selected column(s). + + + + + + +Data +Insert Rows + +Insert new row(s) above selected row(s). + + + + + + +Data +Delete Columns + +Delete selected column(s). + + + + + +Data +Delete Rows + +Delete selected row(s). + + + + + +Data +Insert Cells... + +Insert new cell(s). + + + + + +Data +Remove Cells... + +Remove selected cell(s). + + + + + +Data +Merge Cells + +Merge selected cells. + + + + + +Data +Dissociate Cells + +Dissociate (split apart) previously merged cells. + + + + + + +Data +Show Area... + +Change &kspread;'s focus to show a previously +named area. See the section Named Cells +and Areas for further details. + + + + + +Data +Subtotals... + +Create different kinds of subtotals to a +database. + + + + + +Data +Goal Seek... + +Open the Goal Seek dialog box. See +Goal Seeking for details. + + + + + +Data +Consolidate... + +Consolidate data. See the section +Consolidating Data for more details. + + + + + + + +The <guimenu>Tools</guimenu> Menu + + + + +Tools +Spelling... + +Check spelling of words in the worksheet. + + + + + +Tools +Custom Lists... + +View or amend the special series of words recognized +by &kspread;. + + + + + +Tools +Protect Sheet... + + +Protect the sheet with a password. A dialog pops up prompting you for a password. Unchecking this option will prompt you for the password in order to unprotect the sheet. Protecting a sheet means protecting all cells in the sheet. In a protected sheet, the cells cannot be reformatted or overwritten. + + + + + +Tools +Protect Document... + + +Protect the whole document with a password. A dialog pops up prompting +you for a password. Unchecking this option will prompt you for the password in +order to unprotect the document. In a protected document you cannot rename or +remove a sheet. Document protection does not mean that each individual sheet +is protected. + + + + + + +&Shift;F9 + +Tools +Recalculate Sheet + +Recalculate formulae in the current sheet. + + + + + + +F9 + +Tools +Recalculate Document + +Recalculate all sheets. + + + + + +Tools +Insert Calendar... + +Insert a calendar in your sheet. A dialog asks you for the start and end dates. The corresponding calendar is then inserted from the current cell. + + + + + + +Tools +Script Manager... + +Opens the Scripts Manager dialog to execute, load, unload, install, uninstall and get more scripts. + + + + + +Tools +Scripts + +Here you can execute the script Export to HTML File or start the Script Editor. + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + +Settings +Show/Hide Status Bar + +Show or hide the Status Bar. +The Status Bar shows additional information for selected items and +instant calculations of the selected cells. + + + + + +Settings +Show/Hide Tab Bar + +Show or hide the Tab Bar. +All Sheets of the current Document can be accessed through the Tab Bar. + + + + + +Settings +Show/Hide Formula Bar + +Show or hide the Formula Bar. +The Formula Bar can be used to edit the content of the selected cell. + + + + + +Settings +Toolbars + +Show or hide the toolbars: File, +Edit, Navigation, +Format and Color/Border. + + + + + +Settings +Configure Shortcuts... + +Configure the keyboard shortcuts used by &kspread;. + See the section on configuring shortcuts + for more details. + + + + + + +Settings +Configure Toolbars... + +Configure the toolbars. The section on +configuring toolbars has more +information. + + + + + +Settings +Configure &kspread;... + +General &kspread; configuration. See the +section on &kspread; configuration for +more details. + + + + + + + + +The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + +The Right Mouse Button Menu +This section describes the items in the pop up menu obtained by +right clicking on a selected cell or cells, +row(s) or column(s). + + + + + + +&Alt;&Ctrl;F + +Cell Format... + +Format selected cell(s). See the +Spreadsheet Formatting section for more +details. + + + + + + +&Ctrl;X + +Cut + +Put selected item(s) into the clipboard. If +you then do a Paste the item(s) will be moved from the +original location to the new one. + + + + + + +&Ctrl;C + +Copy + +Copy selected item(s) into the clipboard. + + + + + + +&Ctrl;V + +Paste + +Paste item(s) from the clipboard to the selected cells. + + + + + + +Special Paste... + +Special forms of Paste. + See the sections Other Paste +Modes and Arithmetic using Special +Paste for more details. + + + + + +Paste with Insertion + +Paste from the clipboard to the selected cell(s), moving the +previous cell(s) to make room. + + + + + +Delete + +Delete contents of selected cell(s). + + + + + +Adjust Row & Column + +Change size of row and column to display selected +cell(s) completely. + + + + + +Default + +Set default formats for selected cell(s). + + + + + +Area Name... + +Name selected area. See the section +Named Areas for more details. + + + + + +Resize Row... + +Change height of selected row. + + + + + +Adjust Row + +Change height of selected row to display cell(s) +completely. + + + + + +Resize Column... + +Change width of selected column. + + + + + +Adjust Column + +Change width of selected column to display cell(s) +completely. + + + + + +Insert Cells... + +Insert new cell(s) at selected location, moving +existing cell(s) to make room. + + + + + +Remove Cells... + +Remove selected cell(s), moving other cell(s) to +occupy the space left by the removed cell(s). + + + + + +Insert Rows + +Insert new row(s) above selected row(s). + + + + + + +Delete Rows + +Delete selected row(s). + + + + + +Hide Rows + +Hides selected row(s). + + + + + +Show Rows + +Shows selected row(s). +In order to show hidden rows you need to select a range of rows that +includes the hidden rows. + + + + + +Insert Columns + +Insert new column(s) at left of selected column(s). + + + + + + +Delete Columns + +Delete selected column(s). + + + + + +Hide Columns + +Hides selected column(s). + + + + + +Show Columns + +Shows selected column(s). +In order to show hidden columns you need to select a range of columns that +includes the hidden columns. + + + + + +Add/Modify Comment... + +Add or modify a comment to the selected cell. + + + + + +Selection List... + +Lets you select and paste text from any +cell of the current selection of cells into the selected cell. + + + + + +Show Related Words + +Opens the Related Words dialog box. + + + + + + + +Other Shortcuts +This section describes those &kspread; shortcut keys used for operations +that do not appear in any of the menus. + + + + + +&Ctrl;Arrow keys + +If the selected cell is occupied then move the +cell cursor to the start or end of the occupied block in the current row or +column. If the selected cell is not occupied then move the cell cursor to +the start or end of the block of unoccupied cells in the current row or column. + + + + + + +&Ctrl;&Shift;Arrow keys + +If the selected cell is occupied then select all +occupied cells to the start or end of that block of occupied cells in the +current row or column. +If the selected cell is not occupied then select all unoccupied cells to the +start or end of that block of unoccupied cells in the current row or column. + + + + + + +Page Down + +Move the cell cursor 10 cells down. + + + + + +Page Up + +Move the cell cursor 10 cells up. + + + + + +&Ctrl;Page Down + +Move to the next sheet. + + + + + +&Ctrl;Page Up + +Move to the previous sheet. + + + + + +F4 + +Change cell reference between normal and +absolute reference types. + + + + + +&Ctrl;& + +Add a border to the selected cell(s). + + + + + +&Ctrl;$ + +Display the value of the selected cell(s) in Money +format. + + + + + +&Ctrl;% + +Display the value of the selected cell(s) in +Percentage format. + + + + + +&Ctrl;^ + +Display the value of the selected cell(s) in +Scientific format. + + + + + +&Ctrl;# + +Display the value of the selected cell(s) in +Date format. The value is taken as the number of days since +1 January 1900. + + + + + +&Ctrl;@ + +Display the value of the selected cell(s) in +Time format. The value is taken as the number of seconds since +midnight. + + + + + +&Ctrl;! + +Display the value of the selected cell(s) in +normal Number format. + + + + + + + +     + + diff --git a/doc/kspread/config.docbook b/doc/kspread/config.docbook new file mode 100644 index 00000000..23f1a29f --- /dev/null +++ b/doc/kspread/config.docbook @@ -0,0 +1,145 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +     +     +Configuring &kspread; Shortcuts and Toolbars + + +Shortcuts +To change the shortcut key arrangements used by &kspread; select +SettingsConfigure Shortcuts... +. This will launch a dialog box as shown below. + + + + + + +Shortcut config screenshot 1 + + +Search through the list box to find the action you want to add or +change the shortcut keys for and select it by left +clicking on the name. By entering the name of the action in the search bar at the +top you can quickly find the desired action. You will then be able to change the shortcut +by selecting the None, Default or +Custom radio button or by clicking on the large button in +the Shortcut for Selected Action area. +The Configure Shortcut dialog box will then open. + + + + + + +Simple shortcut configuration + + +You can now simply press the key combination you want to act as the +shortcut, for example +&Ctrl;&Shift;S. The Configure +Shortcut dialog box will then close by itself as soon as the shortcut +is configured. + + + + + + +Advanced shortcut configuration + + + +You can also click on the Advanced >> button in the +Configure Shortcut dialog to get more options. +There you can configure a Primary shortcut: and a secondary +Alternate shortcut:. +You can even choose Multi-key mode, which lets you add additional +keys to the shortcut. + + +Configuring the shortcut with the simple dialog sets the primary +shortcut. + + + +User Defined Menus +You can add your own pop up menu to &kspread; so that pressing one key +combination will make the menu appear then pressing a second key, or using the +Up arrow and Down arrow keys and pressing +Enter, will select an item from it. +To do this add a Custom shortcut for each of the +actions you want to appear in the menu and in the Configure Shortcut + dialog check the Multi-key mode box, press the +key combination that you want to bring up your new menu then, separately, +press the key that will choose that item from the menu. + + + + +Toolbars +&kspread; has five toolbars: File, +Edit, Navigation, +Format and Color/Border. +each of which may or may not be shown depending on the choices made in the +Settings menu. +You can choose whether a toolbar appears at the Top, +Left, Right or +Bottom of &kspread;'s window by right clicking on +the toolbar, which brings up the Toolbar Menu, and making +a selection from the Orientation sub menu. This +Toolbar Menu also has sub menus for choosing whether the +toolbar displays icons, text or both, and the size of the icons. + +Another way of moving a toolbar is by positioning the mouse pointer over +the two vertical bars at the left end of each toolbar and holding the +left mouse button down while you drag the toolbar +to the wanted position. When you drag the toolbar in this way you can release +the mouse button when it is some distance from any of &kspread;'s window +sides, and then you will get a floating toolbar, which is not locked to any +particular part of &kspread;'s window and can in fact be moved outside of +the window. To put a floating toolbar back into one of the traditional +positions right click on its titlebar to bring +up the Toolbar Menu then choose one of the options in +the Orientation sub menu. +You can also flatten a toolbar by left + clicking on the two vertical bars at the left end of the +toolbar or by selecting Orientation +Flat from the Toolbar +Menu. A flattened toolbar appears as a small +rectangle containing two horizontal bars just under &kspread;'s Menubar. It +can be restored to normal by left clicking on it. + +Selecting Configure Toolbars... from the +Settings menu will bring up a dialog box which lets you add +buttons to or remove them from &kspread;'s toolbars. +To use this Configure Toolbars dialog box first +select a toolbar from the Toolbar: combo box. The +right hand Current actions: window will then show the +buttons currently present on the toolbar. You can remove a button by selecting +it in this window then pressing the left arrow button, or move it around by +pressing the up and down arrow buttons. To add a new button to the toolbar +select it in the Available actions: list then press the +right arrow button. + +     + + diff --git a/doc/kspread/configdialog.docbook b/doc/kspread/configdialog.docbook new file mode 100644 index 00000000..8936eef5 --- /dev/null +++ b/doc/kspread/configdialog.docbook @@ -0,0 +1,377 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +     +     +The &kspread; Configuration Dialog Box + +Selecting Settings +Configure &kspread;... opens a dialog box +with several pages, selected with the icons at the left of the dialog box, +which allow you to change many aspects of &kspread;'s operation. + + +<guilabel>Locale Settings</guilabel> + + + + + + + Locale Settings Configuration. + + + +This page of &kspread;'s configuration dialog box shows how items +such as numbers, date, time and money are displayed. +If you have loaded a spreadsheet that was generated using a different +locale, then pressing the Update Locale Settings +button on this page will update it to conform to your locale settings as they are fixed in &kcontrolcenter;. + + + +<guilabel>Interface</guilabel> + + + + + + + Interface Configuration. + + + +This page of &kspread;'s configuration dialog box (obtained by selecting +Configure &kspread;... from the Settings + menu) controls some more &kspread; features: + + + +Number of sheets open at the beginning: +Controls how many worksheets will be created if the +option Blank Worksheet is chosen when +&kspread; is started. + + + + +Number of files to show in Recent Files list: +Controls the maximum number of filenames that are shown +when you select File +Open Recent. + + + + +Autosave Delay (minutes): +Here you can select the time between autosaves, or disable +this feature altogether by choosing Do not save automatically +(drag the slider to the far left). + + + + +Create backup files +Check this box if you want some backup files created. This is checked per default. + + + + +Show vertical scrollbar +Check or uncheck this box to show or hide the vertical +scrollbar in all sheets. + + + + +Show horizontal scrollbar +Check or uncheck this box to show or hide the horizontal +scrollbar in all sheets. + + + + +Show column header +Check this box to show the column letters across the top of each +worksheet. + + + + +Show row header +Check this box to show the row numbers down the left side. + + + + +Show tabs +This check box controls whether the sheet tabs are shown +at the bottom of the worksheet. + + + + +Show formula toolbar +Here is where you can choose to show or hide the Formula bar. + + + + +Show status bar +Uncheck this box if you want to hide the status bar. + + + + + + + + +<guilabel>Misc</guilabel> + + + + + + + Miscellaneous Configuration. + + + +The Misc page of &kspread;'s configuration +dialog box contains the following items; + + + +Completion mode: +Lets you choose the (auto) text completion mode from a +range of options in the drop down selection box. + + + + +Pressing enter moves cell cursor: +Select whether pressing the Enter +key will move the cursor Down, Up, +Right, Left or Down, +First Column as determined by the setting in this drop down selection box. + + + + +Method of calc: +This drop down selection box can be used to choose the +calculation performed by the Statusbar Summary + function. + + + + +Indentation step (cm): +Lets you define the amount of indenting used by the +Increase Indent option in the Format + menu. + +The unit taken here is the one you fixe in the Configure +&kspread; dialog, in the Page Layout tab in the Default page +unit: setting. + + + +Show error message for invalid formulae +If this box is checked a message box will pop up when what +you have entered into a cell cannot be understood by &kspread;. + + + + + + + + + + +<guilabel>Color</guilabel> + + + + + + + Color Configuration. + + + +This page of &kspread;'s configuration dialog box lets you choose the +color of the sheet grid. If you do not want the grid to appear at all, uncheck the Show grid box in +the FormatSheetSheet Properties dialog. + +This page also lets you select the color of the lines used to indicate +the printed page borders when the Show Page Borders +box in the View menu is checked. +Click on the current color to display the standard KDE Select Color dialog. + + + + +Grid color: +Click here to change the grid color &ie; the color of the borders of each cell. + + + + +Page borders: +When the ViewShow Page Borders menu item is checked, the page borders are displayed. Click here to choose another color for the borders than the default red. + + + + + + + + +<guilabel>Page Layout</guilabel> + + + + + + + Page Layout Configuration. + + + +This page of &kspread;'s configuration dialog box lets you set up the +default page size, orientation and units used by the printer and by the +Page Layout dialog box (obtained by selecting +Page Layout... from the Format + menu. + + + + +Default page size: +Choose the default page size for your worksheet among all the most common page sizes. Note that you can overwrite the page size for the current sheet using the FormatPage Layout... dialog. + + + + +Default page orientation: +Choose the default sheet orientation: portrait or landscape. +Note that you can overwrite the orientation for the current sheet using the +FormatPage +Layout... dialog. + + + + +Default page unit: +Choose the default unit that will be used in your all your sheets. Note that you can overwrite the unit for the current sheet using the FormatPage Layout... dialog. + + + + + + + + +<guilabel>Spelling</guilabel> + + + + + + + Spelling Configuration. + + + +This page lets you configure the behavior of &kspread;'s spell +checker. + + + +Create root/affix combinations not in dictionary + +If this box is checked then when &kspread; finds a word in +the document which it does not recognize but which consists of a recognized +root word plus a recognized prefix or suffix it will accept it, whereas if +the box is not checked the spell checker will reject it. + + + + +Consider run-together words as spelling errors + +If this box is checked then common words which are run +together will be considered to be spelling errors, for example +cannot. + + + + +Dictionary: +This drop down selection box can be used to select +alternative dictionaries. + + + + +Encoding: +To select the character encoding that should be used. + + + + +Client: +This combo box lets you select between different spell +checking programs that may be present on your computer. + + + + +Skip all uppercase words +Check this box if you want the spellchecker to ignore +uppercase words, which are usually acronyms such as &kde;. + + + + +Do not check title case +Check this box if you want the spellchecker to ignore +the title case, for example My Own Spreadsheet or My own spreadsheet. If this is unchecked, the spell checker will ask for a uppercase letter in the title nouns. + + + + + + +Configure Text-To-Speech options +See the Text-to-Speech section +in the accessibility chapter for further details. + +     + + diff --git a/doc/kspread/configure1.png b/doc/kspread/configure1.png new file mode 100644 index 00000000..7d227130 Binary files /dev/null and b/doc/kspread/configure1.png differ diff --git a/doc/kspread/configure2.png b/doc/kspread/configure2.png new file mode 100644 index 00000000..af956024 Binary files /dev/null and b/doc/kspread/configure2.png differ diff --git a/doc/kspread/configure3.png b/doc/kspread/configure3.png new file mode 100644 index 00000000..d12ca56a Binary files /dev/null and b/doc/kspread/configure3.png differ diff --git a/doc/kspread/configure4.png b/doc/kspread/configure4.png new file mode 100644 index 00000000..549b8f1b Binary files /dev/null and b/doc/kspread/configure4.png differ diff --git a/doc/kspread/configure5.png b/doc/kspread/configure5.png new file mode 100644 index 00000000..3d179421 Binary files /dev/null and b/doc/kspread/configure5.png differ diff --git a/doc/kspread/configure6.png b/doc/kspread/configure6.png new file mode 100644 index 00000000..92910c62 Binary files /dev/null and b/doc/kspread/configure6.png differ diff --git a/doc/kspread/copy1.png b/doc/kspread/copy1.png new file mode 100644 index 00000000..4833e0d5 Binary files /dev/null and b/doc/kspread/copy1.png differ diff --git a/doc/kspread/currency.png b/doc/kspread/currency.png new file mode 100644 index 00000000..5143aeb1 Binary files /dev/null and b/doc/kspread/currency.png differ diff --git a/doc/kspread/decreasedecimal.png b/doc/kspread/decreasedecimal.png new file mode 100644 index 00000000..6167f5dd Binary files /dev/null and b/doc/kspread/decreasedecimal.png differ diff --git a/doc/kspread/faq.docbook b/doc/kspread/faq.docbook new file mode 100644 index 00000000..c8687449 --- /dev/null +++ b/doc/kspread/faq.docbook @@ -0,0 +1,45 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +     +     +Questions and Answers + + + + +How many rows and columns can I have in a sheet? + +Theoretically up to 32767 rows and 32767 columns. + + + +Where are the templates stored? + +As .kst files under +~/.kde/share/apps/kspread/templates/. + + + + +     + + + diff --git a/doc/kspread/format.docbook b/doc/kspread/format.docbook new file mode 100644 index 00000000..afe5787c --- /dev/null +++ b/doc/kspread/format.docbook @@ -0,0 +1,693 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +Raphael +Langerhorst + +
    raphael.langerhorst@kdemail.net
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + +     +     +Spreadsheet Formatting + + + +Cell Format +To change the format and appearance of selected cell(s), row(s) or column(s) use +the Cell Format... option from the Format + menu or from the right mouse button popup +menu. + + + + + + +Right mouse button context menu. + + + +This will bring up the Cell Format dialog box +which has several tabbed pages: + + +Data Formats and Representation + + + + + + +Data Format page. + + + +The Data Format page of the Cell Format dialog box +lets you control how the values of cells are displayed. +The top part of this page lets you select the format to be used when +displaying numeric values, dates or times. A Preview pane +allows you to see the effect of the new format. + +You can set the same data format for a row or a column by selecting the +row or column and calling the Cell Format dialog with the &RMB;. +You can increase the precision decimal for any number in Generic, +Number, Percent, Money or +Scientific formats using the Increase decimal +precision icon in the Format toolbar: + + +You can decrease the precision decimal for any number in Generic, +Number, Percent, Money or +Scientific formats using the Decrease decimal precision icon +in the Format toolbar: + + + + + +Generic +This is the default format and &kspread; autodetects the +actual +data type depending on the current cell data. By default, &kspread; right +justifies numbers, dates and times within a cell and left justifies anything +else. +If the Generic format does not suit you, you can change to a specific +format among the choices below. + + + +Number +The number notation uses the notation you globally choose in +&kcontrolcenter; in Regional & +AccessibilityCountry/Region & LanguageNumbers. +Numbers are right justified by default. + + + +Percent +When you have a number in the current cell and you switch the +cell format from Generic to Percent, the current cell number will be multiplied +by 100%. +For example if you enter 2 and set the cell format to Percent, the number +will then be 200 %. Switching back to Generic cell format will bring it back to +2. +You can also use the Percent icon in the Format +Toolbar: + + + + + +Money +The Money format converts your number into money notation using +the settings globally fixed in &kcontrolcenter; in Regional +& AccessibilityCountry/Region & LanguageMoney. The +currency symbol will be displayed and the precision will be the one set in +&kcontrolcenter;. +You can also use the Currency icon in the Format toolbar to set the +cell formatting to look like your current currency: + + + + + + +Scientific +The Scientific format changes your number using the scientific +notation. For example, 0.0012 will be changed to 1.2E-03. Going back using +Generic cell format will display 0.0012 again. The Generic cell data format does +not keep scientific notation so if you want this notation, you have to specify +it using this menu item. + + + +Fraction +The Fraction format changes your number into a fraction. For +example, 0.1 can be changed to 1/8, 2/16, 1/10, &etc;. You define the type of +fraction by choosing it in the field on the right. If the exact fraction is not +possible in the fraction mode you choose, the nearest closest match is chosen. +For example: when we have 1.5 as number, we choose Fraction +and Sixteenths 1/16 the text displayed into cell is "1 +8/16" which is an exact fraction. If you have 1.4 as number in your cell and you +choose Fraction and Sixteenths 1/16 +then the cell will display "1 6/16" which is the nearest closest Sixteenth +fraction. + + + +Date format +To enter a date, you should enter it in one of the formats set +in &kcontrolcenter; in Regional & +AccessibilityCountry/Region & LanguageTime & +Dates. There are two formats set here: the date format +and the short date format. +A random natural number NN will be transformed in the date from 30st +December 1899 (which is 0) with the number of days NN added. For example if you +have a cell with 100 and you choose Date format, "1900-04-09" will be +displayed in the cell which is 100 days after 30st December 1899. This starting +date is two days early as it was a bug in Lotus 123 and then it stayed that way +in Excel in order to keep compatibility. Few people will need to calculate from +1st January 1900 anyway and adding 9 days to 1st November 2000 for example will +give you 10th November 2000 so all normal calculations on dates are +correct. +When a cell is in the Date format, you can drag this cell down as +you do with numbers and the next cells will also get +dates, each date being increased by one day. + + + +Time format +This formats your cell content as a time. To enter a time, you +should enter it in the Time format set in &kcontrolcenter; +in Regional & AccessibilityCountry/Region & +LanguageTime +& Dates. In the Cell Format +dialog box you can set how the time should be displayed by choosing one of the +available time format options. The default format is the system format set in +&kcontrolcenter;. When the number in the cell does not make sense as a time, +&kspread; will display 00:00 in the global format you have in +&kcontrolcenter;. + + + +Text +This formats your cell content as text. This can be useful if +you want a number treated as text instead as a number, for example for a ZIP +code. Setting a number as text format will left justify it. When numbers are +formatted as text, they cannot be used in calculations or formulas. It also +change the way the cell is justified. + + + +Custom +Does not work yet. To be enabled in the next release. + + + + +The lower part of the Data Format page lets you add +a Prefix: such as a $ symbol at the start of each item or +a Postfix: such as $HK to the end. You can also control +how many digits are displayed after the decimal point for numeric values, +whether positive values are displayed with a leading + sign and whether +negative values are shown in red. + + + + +Fonts and Text Settings + + + + + + +Font page. + + + +The Font page lets you select the font family, Style:, +Size:, Weight: +and Color: for the current cell, including some additional options like +underlined or striked out text. +The lower part of the page gives a Preview of the selected text format. +The default font is set for all cells in the +FormatStyle +Manager menu with the currently used style. + + + + +Style: +Choose the style for your font for the currently selected cells. +When you select several cells with different styles, the displayed style is set +to Varying (No Change) and leaving it that way will keep +all your current style settings for each cell. Changing to +Roman for example will change all the selected cells style +text to Roman. + + + +Size: +Choose the size for your font for the currently selected cells. +When you select several cells with different sizes, the displayed size is set to + (no number written) and leaving it that way will keep all +your current size settings for each cell. Changing to 14 +for example will change all the selected cells font size to +14. + + + +Weight: +Choose the weight for your font for the currently selected +cells. When you select several cells with different font weight, the displayed +weight is set to Varying (No Change) and leaving it that +way will keep all your current weight settings for each cell. Changing to +Bold for example will change all the selected cells font +weight to Bold. + + + +Color: +Choose the color for the currently selected cells' text. +Clicking on the color bar will bring you the standard KDE Select Color dialog +where you will be able to choose the new color. + + + +Underline +Underlines the currently selected cells' text if checked. This +is +not checked per default. + + + +Strike out +This will strike out the currently selected cells' text if this +is checked. This is not checked per default. + + + + + + + +Text Position and Rotation + + + + + + +Position page. + + + +From the Position page you can control the position +of text within a cell by making suitable selections in the Horizontal + and Vertical areas or by setting the +Indent value. You can also choose to have the text +appear vertically rather than horizontally, or even at an angle. + + + +Horizontal +Set the content position horizontally in the cell. +Standard is default and is set from the data format you choose. +Left means the content will be displayed on the left of the cell. +Center means the content will be in the center horizontally in the cell. +Right means the content of the cell will be displayed on the right of the +cell. + + + +Vertical +Set the content position vertically in the cell. +Top means the content will be displayed on top of the cell. +Middle means the content will be in the middle vertically in the cell. +Bottom means the content of the cell will be displayed at the bottom of the +cell. + + + +Text Option +This is only available when the rotation is 0°. +Wrap text wraps the text so it fits in the previous cell size. If this is not +checked, the text will stay on one line. +Vertical text puts your text vertically. + + + +Rotation +Your text will appear oriented in the angle you set here. +Positive values will move it counter-clockwise and negative values will move it +clockwise. + + + +Merge Cells +When checked, this has the same effect +as DataMerge +Cells. You need to have at least two +consecutive cells selected. Those consecutive cells are then merged into a +bigger one. +When a merged cell is selected and when you uncheck this, then all cells +come back to their original size as before the merging. It has the same effect +as DataDissociate +Cells. + + + +Indent +Set the amount of indent that will be used in the cell when you +choose the FormatIncrease +Indent or +FormatDecrease +Indent menus. + + + +Size of Cell +You set here the size of the cell, either a custom width and +height or choose the default width and height. + + + + + + +Cell Border + + + + + + +Border page. + + + +The Border page lets you set the appearance of the +cell borders. If you have selected more than one cell you can apply different +styles to the borders between the cells and that surrounding the selected area. + +First select the pattern and color from the Pattern +section of the Border page then apply that to +different parts of the border by clicking on the appropriate button in the +Border section, or on one of the Preselect + buttons. The left hand button in the Preselect + section will clear any previously applied border(s). Note that you +can also add a diagonal strike-through line to the cell(s). + + +Cell Background + + + + + + +Background page. + + + +The cell background pattern and color can be selected from the +Background page. +Simply choose a desired Pattern, then select the pattern +Color and the Background color. +At the bottom of this page you can see a Preview of the configured +cell background. + + +Cell Protection + + + + + + +Cell protection page. + + + +You can change the way the content of a cell is protected in the +Cell Protection page. +All cells are protected by default (that means cell content cannot be +changed) and for the cell protection to be active you also need to protect the +sheet using the ToolsProtect Sheet... +menu and to provide a password. +You can also hide the cell formula in order to protect the way you calculate the +formula. This also needs to enable sheet protection to work. +You can hide the cell content with Hide all and again this needs sheet +protection. +You can learn more about all these settings in the Advanced &kspread; chapter, Protection +section. + + +Hide all +This hides the cell content and works only when the sheet is +protected which means that changing the Hide all +attribute of a cell has no effect unless the sheet is protected. Whether the +cell itself is protected or not does not matter. + + + + + + +Hide all. + + + +When Hide all is selected, Protected +and Hide formula are disabled as when the +sheet is protected Hide all hides the cell content and the +formula and thus masks and protects the cell content. + + + +Protected +If checked, the cell content will be protected. This is +the default behaviour. You need to protect the whole sheet using the +ToolsProtect Sheet... +menu for this individual cell protection to work. When a cell is protected, its +content cannot be changed. + + + +Hide formula +When this is checked, the cell is still visible. However, +its contents do not appear in the Formula bar. Hiding formula is only working +for cells that contain formulae so the user cannot view the formula. And the +sheet must be protected for this to work. + + + + +Do not print text +If you check Do not print text then the +text in the cell will not be printed. This is unchecked per default which means +that the cell text will always be printed by default. + + + + + + + +Conditional Cell Attributes +You can make the appearance of a cell change according to the value it +contains, useful perhaps if you are using &kspread; to keep track of your +household expenses and want to highlight any item greater than, say, one +thousand dollars. +To do this select the cell(s) then choose Conditional Cell +Attributes... from the Edit menu. This will +bring up the Conditional Cell Attributes dialog box where +you can make the font type and color of a cell change when the value meets +one or more conditions. Note that the second and third conditions only apply +if the previous condition(s) are not met. +Use ClearConditional +Cell Attributes from the Edit +menu to clear any conditional attributes from selected cells. + + + +Changing Cell Sizes +The Position page in the Cell Format + dialog lets you alter the size of the selected cell(s). Note that +changing the height of a single cell will change the height for all cells in +that row, similarly changing the width will affect the entire column. +You can also select the row(s) or column(s) to be changed then select +Resize Row... or Resize Column... + from the right mouse button pop up +menu or from the FormatRow + or Format +Column menu. +If you move the mouse cursor so that its tip is over the line between +two of the row numbers at the left of &kspread;'s window the cursor will +change to show two parallel lines each with a short arrow headed line coming +from it. When the cursor is in this state you can hold the left + mouse button down and drag the border between the two rows, +changing the height of the upper row. A similar technique can be used to +change the width of a column. + +To set the row height or column width to the minimum needed to +display the contents, select the whole row or column, and click with the &RMB; +on the row or column label. In the menu which appears, select +Adjust Row or Adjust +Column. The row or column will resize to the minimum +necessary. You can also select a single cell or range of cells, and +click Adjust Row & Column from either +the &RMB; popup menu or the Format menu. + +You can make a number of adjacent rows or columns the same size by +selecting them then choosing Format +RowEqualize Row or +FormatColumn +Equalize Column. + + + + +Merging Cells +It is often convenient to have one cell that spreads across two or more +columns or down more than one row. This can be done by merging two or more +cells into one. Select the cells to be merged than choose +DataMerge Cells. +To reverse this process, select the merged cell then choose +Dissociate Cells from the Data menu. + + + +Hiding Rows and Columns +A finished spreadsheet can often be made to look more attractive by +hiding the cells containing intermediate calculations so that only the +important data input and result areas are shown. +In &kspread; you can hide selected rows or columns by +using the Hide Rows and Hide +Columns options from the Format +Row, Format +Column or +right mouse button menus. Hidden rows and columns +are not displayed on the screen or included in a print out. +Hiding cells in this way also makes them slightly less prone to +accidental change. +To un-hide a row or column select Row +Show Rows... or +ColumnShow Columns... + from the Format +menu. In the dialog box which appears, you can select any number of +rows to show (use &Ctrl; + click to select +multiple rows or columns). + + + +Sheet properties +You can access the current sheet properties either by right clicking +on the sheet tab and choosing Sheet Properties or by +using the Format +SheetSheet +Properties menu. Please note that you can only +access the Sheet Properties when the document or the sheet is not +protected. +You can set different properties that will be valid in the current +sheet. Clicking on OK will validate your changes +and Defaults will bring back the default settings. + + + + + + +Sheet Properties dialog. + + + + + +Layout direction: +Let you choose the sheet orientation. Default is that the first +column of the sheet is on the left. If you choose Right to Left, then the first +column will be on the right and the others added from right to left. + + + +Hide zero +If this box is checked any cell containing the value zero will +appear blank. + + + +Automatic recalculation + This setting controls whether formulae are recalculated +automatically when the value of any cell they refer to changes. + + + +Show column as numbers +If this box is checked the column headings will show as numbers +rather than as letters. Letters are default. + + + +Use LC mode +If this box is checked the cell reference shown at the left end +of the Formula Bar will be displayed in LC mode (i.e. L2C3) rather than in its +normal form B3. This does not seem to be of much use at the moment. + + + +Convert first letter to uppercase +Check this box and the first letter of any text you type in will +automatically be converted to uppercase. + + + +Show grid +If checked the grid (the cell limits) will be shown. This is +default. If you uncheck it, the grid will be hidden. + + + +Show page borders +If you check this option, the page borders will be drawn on your +current sheet. Per default the page borders are not displayed. It is useful to +see the page borders if you want to print your sheet. + + + +Show formula +If this box is checked &kspread; will display the actual +formulae in cells rather than the results. + + + +Show formula indicator +If this box is checked &kspread; will display a small blue +triangle at the bottom left corner of cells containing formulae. This is useful +if you want to protect cells with formulae. + + + +Show comment indicator +If this box is checked cells containing comments will be marked +by a small red triangle at the top right corner. + + + + +     + + diff --git a/doc/kspread/hideformula1.png b/doc/kspread/hideformula1.png new file mode 100644 index 00000000..5a9b589a Binary files /dev/null and b/doc/kspread/hideformula1.png differ diff --git a/doc/kspread/hideformula2.png b/doc/kspread/hideformula2.png new file mode 100644 index 00000000..f4f1fe26 Binary files /dev/null and b/doc/kspread/hideformula2.png differ diff --git a/doc/kspread/hideformula3.png b/doc/kspread/hideformula3.png new file mode 100644 index 00000000..9b2c58ca Binary files /dev/null and b/doc/kspread/hideformula3.png differ diff --git a/doc/kspread/hideformula4.png b/doc/kspread/hideformula4.png new file mode 100644 index 00000000..cb5b5a7f Binary files /dev/null and b/doc/kspread/hideformula4.png differ diff --git a/doc/kspread/hideformula5.png b/doc/kspread/hideformula5.png new file mode 100644 index 00000000..a0ebc9e5 Binary files /dev/null and b/doc/kspread/hideformula5.png differ diff --git a/doc/kspread/importexport.docbook b/doc/kspread/importexport.docbook new file mode 100644 index 00000000..e5c36f3a --- /dev/null +++ b/doc/kspread/importexport.docbook @@ -0,0 +1,105 @@ + + + + +Pamela +Robert + +
    pamroberts@blueyonder.co.uk
    +     +     + +     +     +Importing and Exporting Foreign Formats +&kspread; has a limited ability to import (read) and export (write) +spreadsheet files with foreign formats. &kspread;'s capabilities at the time +of writing are summarized in the table below, for more up to date +information visit +http://www.koffice.org/filters/status.phtml. + + +     + + Format + Import + Export + + + +Applix Spreadsheet +Beta +None + + +Comma Separated Values (CSV +) +Good +Good + + +dBase +Beta +None + + +Excel 97/2000 +Good +None + + +Gnumeric +Beta +Beta + + +HTML +None +Beta + + +Quattro Pro +Beta +None + + + + +To import a foreign file just load it as though it were a &kspread; +native file with File +Open.... +To export a &kspread; file in a different format select +FileSave As... +and select the format from the Filter: combo box. +Although &kspread; automatically adds a +.ksp extension to the names of files saved in its native format, +you should add the correct extension for foreign formats. + + +<acronym>CSV</acronym> Data +Tables of data are often held in text files with the values in a +line being separated by a comma, space, tab or other character, +for example 123, 456, 789, abcd, efgh. Such files +are commonly called CSV (Comma Separated +Values) files, even though the separating character may not be a comma. +If you ask &kspread; to open a text file it assumes that the file is +in CSV format and launches a dialog box that allows you to +specify the delimiter (separating character) used by the file, and shows how +the data items will be placed into different spreadsheet cells. +Other options in this dialog box let you define the Format + of the spreadsheet cells, whether text quote characters should be +removed, and whether the first line(s) of the file should be ignored. + + + + + diff --git a/doc/kspread/increasedecimal.png b/doc/kspread/increasedecimal.png new file mode 100644 index 00000000..bb56dd92 Binary files /dev/null and b/doc/kspread/increasedecimal.png differ diff --git a/doc/kspread/index.docbook b/doc/kspread/index.docbook new file mode 100644 index 00000000..171b78a6 --- /dev/null +++ b/doc/kspread/index.docbook @@ -0,0 +1,207 @@ + + + + + + + + + + + + + + +]> + + + + +The &kspread; Handbook + + + + + +Pamela +Roberts + +
    pamroberts@blueyonder.co.uk
    +     +     + +Anne-Marie +Mahfouf + +
    annemarie.mahfouf@free.fr
    +     +     + +Gary +Cramblitt + +
    garycramblitt@comcast.net
    +     +     + +     + + +2002 +Pamela Roberts + + + +2005 +Anne-Marie Mahfouf + + + +2006 +Gary Cramblitt + + + + +&FDLNotice; + +2006-06-12 +1.5.2 + + + + +&kspread; is a full featured spreadsheet program. + + + + +KDE +Koffice +KSpread +Spreadsheet + + +     + + +Introduction + +This handbook is dedicated to the memory of Visicalc. + +&kspread; is a full featured spreadsheet program. It is part of the &koffice; +productivity suite for the K Desktop Environment (&kde;). +Other &koffice; applications include &kword;, (word processing), +&kpresenter; (slide presentation creator) and &kchart; (for producing charts +and graphs) among others. + +You might care to visit +http://www.kde.org for more information about &kde; in general, or the +&koffice; web site at +http://www.koffice.org + + + +&basics; + +&format; + +&advanced; + +&config; + +&configdialog; + +&a11y; + +&commands; + +&faq; + + + +Credits and License + + +&kspread; + + +Program copyright 1998-2002 The KSpread Team: + + + +Torben Weis weis@kde.org + +Laurent Montel lmontel@mandrakesoft.com + +David Faure faure@kde.org + +John Dailey dailey@vt.edu + +Philipp Müller philipp.mueller@gmx.de + +Ariya Hidayat ariya@kde.org + +Norbert Andres nandres@web.de + +Shaheed Haque srhaque@iee.org + +Werner Trobin trobin@kde.org + +Nikolas Zimmerman wildfox@kde.org + +Helge Deller deller@gmx.de + +Percy Leonhart percy@eris23.org + +Eva Brucherseifer eva@kde.org + +Phillip Ezolt phillipezolt@hotmail.com + +Enno Bartels ebartels@nwn.de + +Graham Short grahshrt@netscape.net + + + + + +Documentation copyright 2002 Pamela Roberts +pamroberts@blueyonder.co.uk + + +Minor updates to documentation for &koffice; 1.3 by +&Philip.Rodrigues; &Philip.Rodrigues.mail;. + +&underFDL; +&underGPL; + + + +Installation + +&kspread; is part of &kde;'s &koffice; package and uses various +&koffice; libraries. &koffice; itself is part of &kde; and depends on the +general &kde; libraries. +For instructions on acquiring and installing &kde;, &koffice; and +&kspread; please visit +http://www.kde.org and +http://www.koffice.org. + + + +&documentation.index; +     + + + diff --git a/doc/kspread/kbd-focus-ext.png b/doc/kspread/kbd-focus-ext.png new file mode 100644 index 00000000..f7aa6f58 Binary files /dev/null and b/doc/kspread/kbd-focus-ext.png differ diff --git a/doc/kspread/mousenav.png b/doc/kspread/mousenav.png new file mode 100644 index 00000000..462c6051 Binary files /dev/null and b/doc/kspread/mousenav.png differ diff --git a/doc/kspread/newdocument.png b/doc/kspread/newdocument.png new file mode 100644 index 00000000..923a61b6 Binary files /dev/null and b/doc/kspread/newdocument.png differ diff --git a/doc/kspread/percent.png b/doc/kspread/percent.png new file mode 100644 index 00000000..75649e5b Binary files /dev/null and b/doc/kspread/percent.png differ diff --git a/doc/kspread/sheetproperties.png b/doc/kspread/sheetproperties.png new file mode 100644 index 00000000..ee325f86 Binary files /dev/null and b/doc/kspread/sheetproperties.png differ diff --git a/doc/kspread/shortcut1.png b/doc/kspread/shortcut1.png new file mode 100644 index 00000000..df152f85 Binary files /dev/null and b/doc/kspread/shortcut1.png differ diff --git a/doc/kspread/shortcut2.png b/doc/kspread/shortcut2.png new file mode 100644 index 00000000..d47fab20 Binary files /dev/null and b/doc/kspread/shortcut2.png differ diff --git a/doc/kspread/shortcut3.png b/doc/kspread/shortcut3.png new file mode 100644 index 00000000..34a25dea Binary files /dev/null and b/doc/kspread/shortcut3.png differ diff --git a/doc/kspread/sort1.png b/doc/kspread/sort1.png new file mode 100644 index 00000000..cc1436b4 Binary files /dev/null and b/doc/kspread/sort1.png differ diff --git a/doc/kspread/starting1.png b/doc/kspread/starting1.png new file mode 100644 index 00000000..0bcc216e Binary files /dev/null and b/doc/kspread/starting1.png differ diff --git a/doc/kspread/tts.png b/doc/kspread/tts.png new file mode 100644 index 00000000..332d77bf Binary files /dev/null and b/doc/kspread/tts.png differ diff --git a/doc/kugar/Makefile.am b/doc/kugar/Makefile.am new file mode 100644 index 00000000..e786da56 --- /dev/null +++ b/doc/kugar/Makefile.am @@ -0,0 +1,3 @@ + +KDE_LANG = en +KDE_DOCS = AUTO diff --git a/doc/kugar/add_detail.png b/doc/kugar/add_detail.png new file mode 100644 index 00000000..852d7361 Binary files /dev/null and b/doc/kugar/add_detail.png differ diff --git a/doc/kugar/add_detail_footer.png b/doc/kugar/add_detail_footer.png new file mode 100644 index 00000000..2db8829c Binary files /dev/null and b/doc/kugar/add_detail_footer.png differ diff --git a/doc/kugar/add_detail_header.png b/doc/kugar/add_detail_header.png new file mode 100644 index 00000000..44cbc570 Binary files /dev/null and b/doc/kugar/add_detail_header.png differ diff --git a/doc/kugar/datadtd.docbook b/doc/kugar/datadtd.docbook new file mode 100644 index 00000000..d393e1b8 --- /dev/null +++ b/doc/kugar/datadtd.docbook @@ -0,0 +1,46 @@ + + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +<sgmltag class="element">KugarData</sgmltag> Document Type +Definition + + +<?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE KugarData [ + <!ELEMENT KugarData (Row*)> + <!ATTLIST KugarData + Template CDATA #REQUIRED> + + <!ELEMENT Row EMPTY> + <!ATTLIST Row + level CDATA #REQUIRED + col1 CDATA #IMPLIED + col2 CDATA #IMPLIED + ... CDATA #IMPLIED + coln CDATA #IMPLIED> + ]> + +     diff --git a/doc/kugar/dataref.docbook b/doc/kugar/dataref.docbook new file mode 100644 index 00000000..30f56ec3 --- /dev/null +++ b/doc/kugar/dataref.docbook @@ -0,0 +1,130 @@ + + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +<sgmltag class="element">KugarData element</sgmltag> + + +The KugarData element defines a +report's data source. The basic structure is a collection of rows and +columns. This document does not define data types and their attributes. +The report template defines column data type information. + + + +The document creator can apply an &XSL; style sheet to an existing +document to convert it to this format. If &XSL; is used, the creator +can apply custom macros using &XSL; for column calculations, sorting, +&etc;. + + + +<!ELEMENT KugarData (Row*)> +<!ATTLIST KugarData + Template CDATA #REQUIRED> + +<!ELEMENT Row EMPTY> +<!ATTLIST Row + level CDATA #REQUIRED + col1 CDATA #IMPLIED + col2 CDATA #IMPLIED + ... CDATA #IMPLIED + coln CDATA #IMPLIED> + + + + +Kugar data element + +The KugarData element contains zero +or more Row elements. A Row must contain one level +attribute with a value corresponding to detail level in the template. Other attributes +represent data columns. + + +The value of the Template +attribute is the &URL; of the report template +used to format the data. + + + + + +Row element + + + + +Attributes + + + + + +level + + +The attribute value indicates which detail in the report template +is used to display data. Rows can contain various column sets for various levels, +so any attribute except level should +be stated as #IMPLIED. + + + + + +column + + +The name of the attribute is the column name, and uses the format as given +in the KugarData definition. +The attribute name is used in the report template to bind the data to the +report fields. + + + + + + + + + + +     + diff --git a/doc/kugar/designer.docbook b/doc/kugar/designer.docbook new file mode 100644 index 00000000..34195ca3 --- /dev/null +++ b/doc/kugar/designer.docbook @@ -0,0 +1,364 @@ + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +Report Template Designer Manual + +&kudesigner; allows interactive creation and modification of +report templates, and placement of report sections and section items onto a +report. + + &kudesigner; is a WYSIWYG +application. Report page size defines the report +dimensions on the screen. At the present moment, the scale is set +to 100% automatically and cannot be changed. + + +Every report template may contain the following report sections: +Report Header +Page Header +Detail Header +Detail +Detail Footer +Page Footer +Report Footer + + + +Report sections may contain the following report items: +Label +Field +Calculated Field +Special Field +Line + + +Report sections and items can be placed onto the report template by +using menus or toolbars. + +Every element, such as a report template, a report section or an +item has its own properties. These properties define geometrical, +textual and any other parameters. Every time an element is placed, a set +of default properties is applied. For example, when +Label is placed, its Text property value is +set to Text. + +To change properties, use the Report Item +Options dialog. This dialog can be called by &RMB; clicking +on an item or with an Edit Properties button in the +Edit Toolbar. + See screenshot below (properties for a Field item): + + + +To delete an item, &MMB; click on it or use the Delete button in the +Edit Toolbar. + + + + + + + + +New Report dialog + + + + + +The &kudesigner; menu reference + + + +&Ctrl; +N + +File +New + + +Bring up the New Report dialog +to create a new report template. + +As seen on the screenshot, the report page size, orientation and margins +must be set before the report can be created. + + + + + + + +New Report dialog + + + + + + + + +&Ctrl; +O + +File +Open... + +Open the previously saved report template. + + + + +File +Open Recent + +Display a list of recently opened templates. +Select a file to open it. + + + + +&Ctrl; +S + +File +Save + +Save the current report template into a text file in &XML; format. + + + + +File +Save As... + +Save the current report template into a file and give it another name. + + + + +&Ctrl; +W + +File +Close + +Close the current report template. + + + + +&Ctrl; +P + +File +Print + +Print... the current report template as text in &XML; format. + + + + +&Ctrl; +Q + +File +Quit + +Quit the program. + + + + +Edit +Clear Selection + +Cancel any edit action, so no properties +will be edited or items deleted. + + + + +Edit +Edit Properties + +Edit properties of the selected item. + + + + +Edit +Delete + +Delete the selected item. + + + + +Sections +Report Header + +Place the Report Header section onto the report template. + + + + +Sections +Page Header + +Place the Page Header section onto the report template. + + + + +Sections +Detail Header + +Place the Detail Header section onto the report template. +Before placing the section, the Add Detail Header dialog will be shown to +specify the detail level. The Detail header will be added to the detail section of the given level. + + + + + + +Add Detail Header dialog + + + + + + + + +Sections +Detail + +Place the Detail section onto the report template. +Before placing the section, the Add Detail dialog will be shown to +specify the detail level. + + + + + + +Add Detail dialog + + + + + + + + +Sections +Detail Footer + +Place the Detail Footer section onto the report template. +Before placing the section, the Add Detail Footer dialog will be shown to +specify the detail level. The Detail footer will be added to the detail section of the given level. + + + + + + +Add Detail Footer dialog + + + + + + + + +Sections +Page Footer + +Place the Page Footer section onto the report template. + + + + +Sections +Report Footer + +Place the Report Footer section onto the report template. + + + + +Items +Clear Selection + +Clear item selection, so no report item will be added to the section. + + + + +Items +Label + +Place the Label element onto the section. + + + + +Items +Field + +Place the Field element onto the section. + + + + +Items +Calculated Field + +Place the Calculated Field element onto the section. + + + + +Items +Special Field + +Place the Special Field element onto the section. + + + + +Items +Line + +Place the Line element onto the section. + + + +     diff --git a/doc/kugar/file_new.png b/doc/kugar/file_new.png new file mode 100644 index 00000000..310c0e46 Binary files /dev/null and b/doc/kugar/file_new.png differ diff --git a/doc/kugar/index.docbook b/doc/kugar/index.docbook new file mode 100644 index 00000000..cbe87b76 --- /dev/null +++ b/doc/kugar/index.docbook @@ -0,0 +1,156 @@ + + + + + + + + + + + + + + + + +]> + + + + +The &kugar; Handbook + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     + +2000 +2001 +Phil Thompson + + +2002 +Alexander Dymo + + +&FDLNotice; + +2002-06-11 +1.02.00 + + + + + +&kugar; is a template based &XML; report engine. +&kudesigner; is a flexible &GUI; report template designer for &kugar; report engine. + + + + +KDE +kdeutils +kugar +kudesigner +report +generator +engine +designer + + +     + + +Introduction + + &kugar; is a report creation tool for &Qt; and &kde;. It includes +a &GUI; report template designer, a report engine, a &konqueror; part +for easy report preview and a set of examples. + + The &kudesigner; is a report template creation tool +for the &kugar; report engine. The &kugar; report engine uses an &XML; +based report template file (which can be created by hand or with +&kudesigner;) and a data file (also in &XML; format) to create +reports. To get more information on &kudesigner; refer to the Report Template Designer Manual. + + + See The KugarTemplate Document +Type Definition for an overview of the template's +DTD (file format), KugarData Document Type Definition and +Tutorial for a step-by-step explanation +on how reports can be created. + + Programmers should also refer to the Programmer's guide to find information +about using &kugar; in their own applications. + + +&tutorial; + +&starting; + +&designermanual; + +&progguide; + + +Credits and License + + +&kugar; + + + +Copyright 2000 Mutiny Bay Software + + +Copyright 2000, 2001, Phil Thompson + + +Copyright 2002 Alexander Dymo + + +Portions of the documentation Copyright 2000, 2001 Phil Thompson +and Copyright 2002 Alexander Dymo + + +&underFDL; +&underGPL; + + + + +Document Structure +&templatedtd; +&template; +&templateelements; +&datadtd; +&dataelements; + + + +Installation + +&install.intro.documentation; +&install.compile.documentation; + + +     diff --git a/doc/kugar/kugar.png b/doc/kugar/kugar.png new file mode 100644 index 00000000..7232fa5c Binary files /dev/null and b/doc/kugar/kugar.png differ diff --git a/doc/kugar/progguide.docbook b/doc/kugar/progguide.docbook new file mode 100644 index 00000000..5b60db0d --- /dev/null +++ b/doc/kugar/progguide.docbook @@ -0,0 +1,544 @@ + + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +Programmer's Guide + + +How to use &kugar; for reporting in your own programs + + +There are several ways to use &kugar; + + +Create a temporary file and fill it with data, organized according to the +KugarData Document Type Definition. Then +call the kugar shell command ( + +kugar + + + + + + + +) to preview and print the report. +See Using &kugar; shell for previewing reports +for a detailed description. + + + + +Use &kugar; directly in the application's code. +See Using &kugar; classes for reporting +for a detailed description. + + + + +Create a &Qt; designer plugin, use it to build the application &GUI; in the designer and +link it to the program dynamically. +See Creating a &Qt; designer plugin +for a detailed description. + + + + + The last two ways are acceptable for &Qt; and &kde; developers; +but &kugar; is designed to be a report generator, independent from a +programming language and/or IDE. It uses &XML; +format for describing report templates and data files. So any program +can produce output in &kugar; data file format as described in KugarData DTD or +even a report template file format (see KugarTemplate DTD). +&kugar; shell (report viewer) can be used to preview and print the +generated report. + + + + +Using &kugar; shell for previewing reports + + +The way to create and preview (print) a report is: + + +Create a report template file with &kudesigner; + + + + +Create a data file with column values for detail bands of the report. +Use KugarData DTD to produce correct data files. + + + + +Run &kugar; shell to preview and print a report. For example, to do this, in C or C++ +languages call: + + +system(). + + + +Don't forget to include stdlib.h. + + + + + + +Using &kugar; classes for reporting + +The &kugar; library includes two widgets for use. + + +The KReportViewer class is designed for &kde; +developers. It supports a &kde; printing system and &UNIX; localization +via i18n() calls. + + +The MReportViewer class is designed for &Qt; +developers and provides real crossplatforming. It can be used not +only on &UNIX; platforms, but also on &Windows; and &MacOS;. + + +In order to build a program that uses the &kugar; library, it should be linked +with libkugar.so shared library, which is provided with the &kugar; distribution on all +&UNIX; platforms. + + +Include files are kugarqt.h and kugar.h +for &Qt; and &kde; programs respectively. + +For a detailed example of how &kugar; classes can be used, look in the /shell +folder in the &kugar; sources. + + +MReportViewer (and KReportViewer too) +contains several public methods that can be used. + + + +void renderReport + + +Renders the report onto a screen. + + + + +void printReport + + +Calls the print dialog to print the report. + + + + +void clearReport + + +Clears the report on a screen and frees report data. +Call this before opening the new report. + + + + +bool setReportData +const QString &data_file_name + +Sets report data from data_file_name file. + + + + +bool setReportData +const QIODevice &data_io_device + +Sets report data from data_io_device file. +IO device can be any successor of the QIODevice class. +For example, to fetch records directly from the database, +create a QIODevice successor and redefine all necessary +functionality. + + + + + +bool setReportTemplate +const QString &template_file_name + +Sets report template from template_file_name file. + + + + +bool setReportTemplate +const QIODevice &template_io_device + +Sets report template from template_io_device file. +IO device can be any successor of the QIODevice class. +For example, to obtain a report template from network storage or database, +create a QIODevice successor and redefine all necessary functionality. + + + + + + +Creating &Qt; designer plugin + + +This is the example code of how a designer plugin is created. The code below creates a plugin for +a &kde; KReportViewer widget. + + + +If a &Qt; +widget is desired, replace KReportViewer with +MReportViewer and kugar.h with +kugarqt.h in the plugin code. + + + +Plugin usage + +The designer plugin will allow the usage of &Qt; Designer to place a KReportViewer +widget onto a window and preview it correctly. + + + +Programs that make use of this plugin must be linked dynamically with it. +The corresponding library is called libkugar_plugin.so. +Widgets or dialogs that include KReportViewer +widget must include <kugar.h> in implementation and have a forward declaration +of class KReportViewer. Includes can be done with &Qt; +Designer's Object Explorer (Source tab). + + + +To build the plugin run: + +qmake +kugar_plugin.pro + + +make + + + + + + +Plugin code + + +The plugin code consists of three files: +kugar_plugin.h +kugar_plugin.cpp +kugar_plugin.pro + +A header file for the KugarWidgetPlugin, QWidgetPlugin successor; +A source file for the KugarWidgetPlugin, QWidgetPlugin successor; +A project file for the QMake utility. + + + + +kugar_plugin.h + + +#include <qwidgetplugin.h> + +class KugarWidgetPlugin:public QWidgetPlugin +{ +public: + KugarWidgetPlugin (); + + QStringList keys () const; + QWidget *create (const QString & classname, QWidget * parent = + 0, const char *name = 0); + QString group (const QString &) const; + QIconSet iconSet (const QString &) const; + QString includeFile (const QString &) const; + QString toolTip (const QString &) const; + QString whatsThis (const QString &) const; + bool isContainer (const QString &) const; +}; + + + + + +kugar_plugin.cpp + + +#include "kugar_plugin.h" +#include <kugar.h> + +static const char *kugar_pixmap[] = { + "22 22 127 2", + ".d c #000000", + ".c c #131313", + ".b c #282828", + ".a c #434241", + ".e c #4e463a", + ".# c #595551", + ".G c #66553b", + "#F c #68635f", + "#R c #6b4f23", + "#q c #6e6862", + "#M c #6f5229", + ".n c #6f6146", + ".w c #735310", + ".V c #755c2a", + ".I c #775f34", + ".0 c #77694a", + "#n c #7e6434", + ".o c #806f50", + "#C c #835d2d", + ".P c #837c75", + "#B c #85653a", + "#k c #85827e", + ".x c #866d46", + ".U c #877967", + ".X c #888888", + ".F c #89724d", + "#x c #8b6d2a", + ".S c #8d7759", + ".z c #8e733b", + "#L c #906e49", + "#Q c #947b56", + ".r c #948058", + ".J c #957844", + ".4 c #987736", + ".q c #998969", + ".k c #999897", + ".R c #9a8a75", + "#i c #9f8348", + "#I c #a37c4b", + ".u c #a38d66", + ".E c #a58558", + "#A c #a8834b", + ".s c #a9967a", + ".t c #aa9467", + ".C c #ae9f8d", + "#6 c #afa49d", + "#5 c #afa9a4", + "#W c #b18e4d", + ".K c #b1935a", + ".B c #b39660", + "#V c #b49866", + "#a c #b49d6c", + "## c #b49d72", + ".j c #b5b4b4", + "#0 c #b7a597", + ".O c #b9b1a9", + ".L c #bb9c61", + ".M c #bb9e6b", + ".A c #bca778", + "#j c #bea46b", + ".T c #bfb37d", + ".v c #c0b391", + ".W c #c3a262", + ".i c #c4c4c4", + "#m c #c5b7aa", + "#8 c #c69f80", + ".D c #c6b79b", + "#3 c #c7a589", + ".7 c #c7a76c", + "#u c #c7bbaf", + ".6 c #c8ad74", + "#7 c #c8b7a9", + "#r c #c8beb5", + ".m c #c8c8c8", + "#U c #cbad96", + "#f c #ccb681", + "#h c #cdac6c", + "#P c #cdb49f", + "#X c #cdb8a6", + "#H c #ceb7a4", + ".y c #ceb892", + ".N c #cecac3", + "#Z c #cfb16f", + "#O c #cfbdad", + ".Z c #cfc7c0", + "#w c #d0bcab", + ".5 c #d1ad6b", + "#s c #d1bfb1", + ".h c #d5d5d5", + "#l c #d6cdc6", + "#D c #d8b36e", + ".H c #dac592", + "#t c #dbb977", + ".g c #dcdcdc", + ".1 c #e0dcc1", + ".f c #e0e0df", + "#1 c #e3c8b1", + "#S c #e4cdb9", + ".3 c #e4d9a3", + "#4 c #e6c1a1", + "#2 c #e7c4a5", + "#K c #e9c179", + "#g c #e9c47e", + "#Y c #e9c8ac", + ".2 c #eae6c0", + "#T c #ebcdb3", + ".Q c #ebd4b9", + "#E c #ecca87", + "#z c #ecd799", + ".l c #ececeb", + "#G c #efd7c2", + "#e c #efe3ab", + ".8 c #efe8e3", + "#v c #f1dcca", + "#. c #f2e2d4", + ".p c #f4f4f4", + "#y c #f5daa0", + "#J c #f6cf7f", + ".9 c #f7ede4", + "#p c #f9d995", + ".Y c #fcf9f6", + "#d c #fefcc5", + "#c c #fefdda", + "#b c #fefee1", + "#N c #ffd685", + "#o c #fff0a9", + "Qt c #ffffff", + "QtQtQtQtQtQt.#.a.a.a.b.b.b.c.c.d.d.dQtQtQtQt", + "QtQtQtQtQtQt.e.f.g.g.f.g.g.h.i.j.d.k.dQtQtQt", + "QtQtQtQtQtQt.a.gQtQtQtQtQtQt.l.f.c.m.k.dQtQt", + "QtQtQtQtQt.n.n.n.n.n.o.g.pQtQt.l.bQt.m.k.dQt", + "QtQtQt.q.q.r.q.s.t.r.q.u.u.g.pQt.a.fQt.m.k.d", + "QtQt.s.s.v.w.x.y.y.t.z.A.t.B.i.p.#.a.b.c.d.d", + "Qt.C.C.D.E.F.G.A.H.F.I.J.K.L.M.i.p.l.N.O.P.d", + "Qt.s.v.Q.q.R.S.T.A.R.U.V.L.W.W.X.g.Y.f.Z.k.d", + ".0.s.t.Q.1.U.R.2.3.S.U.4.5.6.6.7.j.8.9#..O.d", + ".G##.V#a#b.1#c#c#d#e#f#g#h#i#j.W#k#l.9#.#m.d", + ".G.4.F#n#c#c#c#d#d#o#p#g.x.w#i.L#q#r#.#.#s.d", + ".e.J.J.I.3#d.H#j.6#f#p#t#n.w.E.L#q#u#.#v#w.d", + ".G.A#x.z#y#z#A#B#B#C#D#E.4.4.6#h#F#m#v#G#H.d", + ".o.s.A#j#E#t#I#I#I#C#A#J#p#p#K#t#F#m#v#G#H.d", + "Qt##.A.6.7#I#I#A.E#L#M.W#N#J#K.a.U#O#G.Q#P.d", + "Qt#a.M.L.J#A#I.4.E#Q.x#R#D#J#g.#.C#S.Q#T#U.d", + "QtQt#V.K.z#Q.s.S.x.S#B#M#W#E.a.U#X.Q#T#Y#U.d", + "QtQtQt.M#i#B.r#Q#Q.r#Q.z#Z.a#q#0#1#T#Y#2#3.d", + "QtQtQtQtQt#j.L.L.W.5#t.a.#.U#0#1#T#Y#2#4#3.d", + "QtQtQtQtQtQt.d#F#q#q#q.P.C#O#S.Q#T#Y#2#4#3.d", + "QtQtQtQtQtQt.d#5#5#6#6#0#7#w#H#P#U#U#3#3#8.d", + "QtQtQtQtQtQt.d.d.d.d.d.d.d.d.d.d.d.d.d.d.d.d" +}; + +KugarWidgetPlugin::KugarWidgetPlugin () +{ +} + +QStringList KugarWidgetPlugin::keys () const +{ + QStringList list; + list << "KReportViewer"; + return list; +} + +QWidget* KugarWidgetPlugin::create (const QString & key, QWidget * parent, + const char *name) +{ + if (key == "KReportViewer") + return new KReportViewer (parent, name); + return 0; +} + +QString KugarWidgetPlugin::group (const QString & feature) const +{ + if (feature == "KReportViewer") + return "Display"; + return QString::null; +} + +QIconSet KugarWidgetPlugin::iconSet (const QString &) const +{ + return QIconSet (QPixmap (kugar_pixmap)); +} + +QString KugarWidgetPlugin::includeFile (const QString & feature) const +{ + if (feature == "KReportViewer") + return "kugar.h"; + return QString::null; +} + +QString KugarWidgetPlugin::toolTip (const QString & feature) const +{ + if (feature == "KReportViewer") + return "Kugar report viewer widget"; + return QString::null; +} + +QString KugarWidgetPlugin::whatsThis (const QString & feature) const +{ + if (feature == "KReportViewer") + return "A widget to view xml reports"; + return QString::null; +} + +bool KugarWidgetPlugin::isContainer (const QString &) const +{ + return FALSE; +} + +Q_EXPORT_PLUGIN( KugarWidgetPlugin ) + + + + +kugar_plugin.pro + + +SOURCES += kugar_plugin.cpp +HEADERS += kugar_plugin.h + +DESTDIR = $(QTDIR)/plugins/designer +TARGET = kugar_plugin + +target.path=$$plugins.path +isEmpty(target.path):target.path=$$QT_PREFIX/plugins +PROJECTNAME = KugarPlugin +TEMPLATE = lib +CONFIG += qt warn_on release plugin +unix:LIBS += -lkugar +LANGUAGE = C++ + + + + + + +     diff --git a/doc/kugar/props.png b/doc/kugar/props.png new file mode 100644 index 00000000..7a110f89 Binary files /dev/null and b/doc/kugar/props.png differ diff --git a/doc/kugar/starting.docbook b/doc/kugar/starting.docbook new file mode 100644 index 00000000..555df6a9 --- /dev/null +++ b/doc/kugar/starting.docbook @@ -0,0 +1,60 @@ + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +Starting &kugar; and &kudesigner; + +The &kugar; program takes two commandline arguments: + + + +kugar + + + + + + + + + +For example, kugar +sample1.kdf +sample1.ktf + + + +The &kudesigner; program can be started with no arguments +or with a report template file name as an argument: + + +kudesigner + +template.ktf + + + +     diff --git a/doc/kugar/template-elements.docbook b/doc/kugar/template-elements.docbook new file mode 100644 index 00000000..d48bb2a7 --- /dev/null +++ b/doc/kugar/template-elements.docbook @@ -0,0 +1,2493 @@ + + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +<sgmltag class="element">KugarTemplate</sgmltag> template +elements + + + +     + +Section bands +Section elements + + + + +ReportHeader +Line + + +PageHeader +Label + + +DetailHeader +Field + + +Detail +CalculatedField + + +DetailFooter +Special + + +PageFooter +Page Footer + + +ReportFooter +Report Footer + + + + + + + +<sgmltag class="element">ReportHeader</sgmltag> and <sgmltag +class="element">ReportFooter</sgmltag> sections + + +The ReportHeader and ReportFooter elements define report sections +that are usually printed at the beginning and end of the report. + + + +<!ELEMENT ReportHeader (Line*, Label*, Special*)> +<!ATTLIST ReportHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + + +<!ELEMENT ReportFooter (Line*, Label*, Special*, CalculatedField*)> +<!ATTLIST ReportFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + + + + +Attributes + + + + +Height + +Sets the height of the report section. If you don't want +this section, set this value to 0. + + + + + +PrintFrequency + + +Set the print frequency of the section. + + + + + + +Value +Print Frequency + + + + +0 +First Page + + +1 +Every Page + + +2 +Last Page + + + + + + + + + + + + + +<sgmltag class="element">PageHeader</sgmltag> and <sgmltag +class="element">PageFooter</sgmltag> sections + + +The PageHeader and PageFooter elements define report sections +that are usually printed on every page of the report. + + + +<!ELEMENT PageHeader (Line*, Label*, Special*)> +<!ATTLIST PageHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + + +<!ELEMENT PageFooter (Line*, Label*, Special*)> +<!ATTLIST PageFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + + + + +Attributes + + + + +Height + +Sets the height of the report section. If you don't want +this section, set this value to 0. + + + + + +PrintFrequency + + +Set the print frequency of the section. + + + + + + +Value +Print Frequency + + + + +0 +First Page + + +1 +Every Page + + +2 +Last Page + + + + + + + + + + + + + + +<sgmltag class="element">DetailHeader</sgmltag> and <sgmltag +class="element">DetailFooter</sgmltag> sections + + +The DetailHeader and DetailFooter elements define report sections +that are printed before and after details of a given level and below on the report. + + + +<!ELEMENT DetailHeader (Line*, Label*, Special*)> +<!ATTLIST DetailHeader + Height CDATA #REQUIRED + Level CDATA #REQUIRED> + + + +<!ELEMENT DetailFooter (Line*, Label*, Special*)> +<!ATTLIST DetailFooter + Height CDATA #REQUIRED + Level CDATA #REQUIRED> + + + + + +Attributes + + + + +Height + +Sets the height of the report section. If you don't want +this section, set this value to 0. + + + + + +Level + + +Set the hierarchy level of the section. Sections with higher levels will be printed +before sections with lower ones. Level can be any number beginning from 0. + + + + + + + + + + + + +<sgmltag class="element">Detail</sgmltag> section + + +The Detail element defines the report +section that contains the report data. The report can have multiple details, +which are accessed by the detail's Level attribute. + + + +<!ELEMENT Detail (Line*, Label*, Special*, Field*)> +<!ATTLIST Detail + Height CDATA #REQUIRED + Level CDATA #REQUIRED> + + + + +Attributes + + + + +Height + +Sets the height of the report section. If you don't want +this section, set this value to 0. + + + + +Level + + +Set the hierarchy level of the section. Sections with higher levels will be printed +before sections with lower ones. Level can be any number beginning from 0. This is an attribute +of a row element in a data file. + + + + + + + + + + + + +<sgmltag class="element">Line</sgmltag> + + +The Line element defines a report +object used to draw lines on a report. + + + +<!ELEMENT Line EMPTY> +<!ATTLIST Line + X1 CDATA #REQUIRED + Y1 CDATA #REQUIRED + X2 CDATA #REQUIRED + Y2 CDATA #REQUIRED + Width CDATA #REQUIRED + Color CDATA #REQUIRED + Style CDATA #REQUIRED> + + + + +Attributes + + + + +X1 + + +Sets the starting x coordinate (relative to the section's upper left corner) for the line. + + + + + +Y1 + + +Sets the starting y coordinate (relative to the section's upper left corner) for the line. + + + + + +X2 + + +Sets the ending x coordinate (relative to the section's upper left corner) for the line. + + + + + +Y2 + + +Sets the ending y coordinate (relative to the section's upper left corner) for the line. + + + + + +Width + + +Sets the width of the line. + + + + + +Color + + +Sets the color of the line. The color is defined as an RGB (Red Green Blue) value +(r,g,b). r, g and b must be in the range 0..255. + + + + + +Style + + +Sets the drawing style for the line. + + + + + + +Value +Line Style + + + + + +0 +No Pen + + +1 +Solid + + +2 +Dash + + +3 +Dot + + +4 +Dash Dot + + +5 +Dash Dot Dot + + + + + + + + + + + + + +<sgmltag class="element">Label</sgmltag> + + +The Label element defines a report +object used to draw fixed text on a report. + + + + <!ELEMENT Label EMPTY> + <!ATTLIST Label + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED> + + + + +Attributes + + + + +Text + + +Sets the label's text. + + + + + +X + + +Sets the x coordinate (relative to the section's upper left corner) for positioning the label. + + + + + +Y + + +Sets the y coordinate (relative to the section's upper left corner) for positioning the label. + + + + + +Width + + +Sets the width of the label. + + + + + +Height + + +Sets the height of the label. + + + + + +BackgroundColor + + +Sets the background color of the label. The color is defined as an +RGB (Red Green Blue) value (r,g,b). r, g and b must be in the range 0..255. + + + + + +ForegroundColor + + +Sets the foreground color of the label. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderColor + + +Sets the border color of the label. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderWidth + + +Sets the border width for the label. + + + + + +BorderStyle + + +Sets the border style for the label. + + + + + + +Value +Border Style + + + + +0 +None + + +1 +Solid + + +2 +Dash + + +3 +Dot + + +4 +Dash Dot + + +5 +Dash Dot Dot + + + + + + + + +FontFamily + + +Sets the font family for the label's text. + + + + + + +FontSize + + +Sets the font size for the label's text. + + + + + +FontWeight + + +Sets the font weight for the label's text. + + + + + + +Value +Font Weight + + + + +25 +Light + + +50 +Normal + + +63 +Demi Bold + + +75 +Bold + + +87 +Black + + + + + + + + + +FontItalic + + +Sets the font italic flag for the label's text. + + + + + + +Value +Italic + + + + +0 +False + + +1 +True + + + + + + + + + +HAlignment + + +Sets the label's horizontal text alignment. + + + + + + +Value +Horizontal Alignment + + + + +0 +Left + + +1 +Center + + +2 +Right + + + + + + + + +VAlignment + + +Sets the label's vertical text alignment. + + + + + + +Value +Vertical Alignment + + + + +0 +Top + + +1 +Middle + + +2 +Bottom + + + + + + + + +WordWrap + + +Sets the word wrap flag for the label's text. + + + + + + +Value +Word Wrap + + + + +0 +False + + +1 +True + + + + + + + + + + + + + + +<sgmltag class="element">Field</sgmltag> + + +The Field element defines a report +object used to draw data on a report. + + + +<!ELEMENT Field EMPTY> +<!ATTLIST Field + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> + + + + +Attributes + + + + +Field + + +Sets the data field for the object. This is an attribute of a row element in a data file. + + + + + +Text + + +Not used. + + + + + +X + + +Sets the x coordinate (relative to the section's upper left corner) for positioning the field. + + + + + +Y + + +Sets the y coordinate (relative to the section's upper left corner) for positioning the field. + + + + + +Width + + +Sets the width of the field. + + + + + +Height + + +Sets the height of the field. + + + + + +BackgroundColor + + +Sets the background color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +ForegroundColor + + +Sets the foreground color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderColor + + +Sets the border color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderWidth + + +Sets the border width for the field. + + + + + +BorderStyle + + +Sets the border style for the field. + + + + + + +Value +Border Style + + + + +0 +None + + +1 +Solid + + +2 +Dash + + +3 +Dot + + +4 +Dash Dot + + +5 +Dash Dot Dot + + + + + + + + +FontFamily + + +Sets the font family for the field's text. + + + + + + +FontSize + + +Sets the font size for the field's text. + + + + + +FontWeight + + +Sets the font weight for the field's text. + + + + + + +Value +Font Weight + + + + +25 +Light + + +50 +Normal + + +63 +Demi Bold + + +75 +Bold + + +87 +Black + + + + + + + + + +FontItalic + + +Sets the font italic flag for the field's text. + + + + + + +Value +Italic + + + + +0 +False + + +1 +True + + + + + + + + + +HAlignment + + +Sets the field's horizontal text alignment. + + + + + + +Value +Horizontal Alignment + + + + +0 +Left + + +1 +Center + + +2 +Right + + + + + + + + +VAlignment + + +Sets the field's vertical text alignment + + + + + + +Value +Vertical Alignment + + + + +0 +Top + + +1 +Middle + + +2 +Bottom + + + + + + + + +WordWrap + + +Sets the word wrap flag for the field's text. + + + + + + +Value +Word Wrap + + + + +0 +False + + +1 +True + + + + + + + + + +DataType + + +Sets the field's data type. + + + + + + +Value +Data Type + + + + +0 +String + + +1 +Integer + + +2 +Float + + +3 +Date + + +4 +Currency + + + + + + + + +DateFormat + + +Sets the field's date format. For this to work, the format of the date +from the data document must be in the format mm/dd/yyyy or mm-dd-yyyy, +otherwise the original date format is used. If the data type is other than +date, set this to 0. + + + + + + +Value +Date Format + + + + +0 +m/d/yy + + +1 +m-d-yy + + +2 +mm/dd/yy + + +3 +mm-dd-yy + + +4 +m/d/yyyy + + +5 +m-d-yyyy + + +6 +mm/dd/yyyy + + +7 +mm-dd-yyyy + + +8 +yyyy/m/d + + +9 +yyyy-m-d + + +10 +dd.mm.yy + + +11 +dd.mm.yyyy + + + + + + + + +Precision + + +Sets the field's numeric precision. If the data type is other than a numeric +type, set this to 0. + + + + + +Currency + + +Sets the field's currency symbol If the data type is other than currency, set +this to 36 ($). The value is a number +representing a Unicode character. + + + + + +NegValueColor + + +Sets the color for negative numeric values. The color is defined as an +RGB (Red Green Blue) value (r,g,b). r, g and b must be in the range 0..255. If data is +other than a numeric type, set to 255,0,0. + + + + + +CommaSeparator + + +Sets whether commas are used in numeric fields. If the data type is other than +a numeric type, set this to 0. + + + + + + +Value +Comma Separator + + + + +0 +False + + +1 +True + + + + + + + + + + + + + + +<sgmltag class="element">CalculatedField</sgmltag> + + +The CalculatedField element defines a report +object used to draw calculated values on a report. + + + +<!ELEMENT CalculatedField EMPTY> +<!ATTLIST CalculatedField + CalculationType CDATA #REQUIRED + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> + + + + +Attributes + + + + +CalculationType + + +Sets the calculation type for the field. + + + + + + +Value +Calculation + + + + +0 +Count + + +1 +Sum + + +2 +Average + + +3 +Variance + + +4 +Std Deviation + + + + + + + + + +Field + + +Sets the data field for the object. This is an attribute of a row element in a data file. + + + + + +Text + + +Not used. + + + + + +X + + +Sets the x coordinate (relative to the section's upper left corner) for positioning the field. + + + + + +Y + + +Sets the y coordinate (relative to the section's upper left corner) for positioning the field. + + + + + +Width + + +Sets the width of the field. + + + + + +Height + + +Sets the height of the field. + + + + + +BackgroundColor + + +Sets the background color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +ForegroundColor + + +Sets the foreground color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderColor + + +Sets the border color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderWidth + + +Sets the border width for the field. + + + + + +BorderStyle + + +Sets the border style for the field. + + + + + + +Value +Border Style + + + + +0 +None + + +1 +Solid + + +2 +Dash + + +3 +Dot + + +4 +Dash Dot + + +5 +Dash Dot Dot + + + + + + + + +FontFamily + + +Sets the font family for the field's text. + + + + + + +FontSize + + +Sets the font size for the field's text. + + + + + +FontWeight + + +Sets the font weight for the field's text. + + + + + + +Value +Font Weight + + + + +25 +Light + + +50 +Normal + + +63 +Demi Bold + + +75 +Bold + + +87 +Black + + + + + + + + + +FontItalic + + +Sets the font italic flag for the field's text. + + + + + + +Value +Italic + + + + +0 +False + + +1 +True + + + + + + + + + +HAlignment + + +Sets the field's horizontal text alignment. + + + + + + +Value +Horizontal Alignment + + + + +0 +Left + + +1 +Center + + +2 +Right + + + + + + + + +VAlignment + + +Sets the field's vertical text alignment. + + + + + + +Value +Vertical Alignment + + + + +0 +Top + + +1 +Middle + + +2 +Bottom + + + + + + + + +WordWrap + + +Sets the word wrap flag for the field's text. + + + + + + +Value +Word Wrap + + + + +0 +False + + +1 +True + + + + + + + + +DataType + + +Sets the field's data type. + + + + + + +Value +Data Type + + + + +0 +String + + +1 +Integer + + +2 +Float + + +3 +Date + + +4 +Currency + + + + + + + + +DateFormat + + +Sets the field's date format. For this to work, the format of the date +from the data document must be in the format mm/dd/yyyy or mm-dd-yyyy, +otherwise the original date format is used. If the data type is other than +date, set this to 0. + + + + + + +Value +Date Format + + + + +0 +m/d/yy + + +1 +m-d-yy + + +2 +mm/dd/yy + + +3 +mm-dd-yy + + +4 +m/d/yyyy + + +5 +m-d-yyyy + + +6 +mm/dd/yyyy + + +7 +mm-dd-yyyy + + +8 +yyyy/m/d + + +9 +yyyy-m-d + + +10 +dd.mm.yy + + +11 +dd.mm.yyyy + + + + + + + + +Precision + + +Sets the field's numeric precision. If the data type is other than a numeric +type, set this to 0. + + + + + +Currency + + +Sets the field's currency symbol. If the data type is other than currency, set +this to 36 ($). The value is a number +representing an unicode character. + + + + + +NegValueColor + + +Sets the color for negative numeric values. The color is defined as an +RGB (Red Green Blue) value (r,g,b). r, g and b must be in the range 0..255. If data is +other than a numeric type, set to 255,0,0. + + + + + +CommaSeparator + + +Sets whether commas are used in numeric fields. If the data type is other than +a numeric type, set this to 0. + + + + + + +Value +Comma Separator + + + + +0 +False + + +1 +True + + + + + + + + + + + + + + + +<sgmltag class="element">Special</sgmltag> + + +The Special element defines a report +object used to draw page numbers and the current date on a report. + + + +<!ELEMENT Special EMPTY> +<!ATTLIST Special + Type CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DateFormat CDATA #REQUIRED> + + + + +Attributes + + + + +Type + + +Sets the type of special object. + + + + + + +Value +Type + + + + +0 +Current Date + + +1 +Page Number + + + + + + + + +Text + + +Not used. + + + + + +X + + +Sets the x coordinate (relative to the section's upper left corner) for positioning the field. + + + + + +Y + + +Sets the y coordinate (relative to the section's upper left corner) for positioning the field. + + + + + +Width + + +Sets the width of the field. + + + + + +Height + + +Sets the height of the field. + + + + + +BackgroundColor + + +Sets the background color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +ForegroundColor + + +Sets the foreground color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + + +BorderColor + + +Sets the border color of the field. The color is defined as an RGB (Red Green Blue) +value (r,g,b). r, g and b must be in the range 0..255. + + + + + +BorderWidth + + +Sets the border width for the field. + + + + + +BorderStyle + + +Sets the border style for the field. + + + + + + +Value +Border Style + + + + +0 +None + + +1 +Solid + + +2 +Dash + + +3 +Dot + + +4 +Dash Dot + + +5 +Dash Dot Dot + + + + + + + + +FontFamily + + +Sets the font family for the field's text. + + + + + + +FontSize + + +Sets the font size for the field's text. + + + + + +FontWeight + + +Sets the font weight for the field's text. + + + + + + +Value +Font Weight + + + + +25 +Light + + +50 +Normal + + +63 +Demi Bold + + +75 +Bold + + +87 +Black + + + + + + + + + +FontItalic + + +Sets the font italic flag for the field's text. + + + + + + +Value +Italic + + + + +0 +False + + +1 +True + + + + + + + + + +HAlignment + + +Sets the field's horizontal text alignment. + + + + + + +Value +Horizontal Alignment + + + + +0 +Left + + +1 +Center + + +2 +Right + + + + + + + + +VAlignment + + +Sets the field's vertical text alignment. + + + + + + +Value +Vertical Alignment + + + + +0 +Top + + +1 +Middle + + +2 +Bottom + + + + + + + + +WordWrap + + +Sets the word wrap flag for the field's text. + + + + + + +Value +Word Wrap + + + + +0 +False + + +1 +True + + + + + + + + +DateFormat + + +Sets the field's date format. For this to work, the format of the date +from the data document must be in the format mm/dd/yyyy or mm-dd-yyyy, +otherwise the original date format is used. If the data type is other than +date, set this to 0. + + + + + + +Value +Date Format + + + + +0 +m/d/yy + + +1 +m-d-yy + + +2 +mm/dd/yy + + +3 +mm-dd-yy + + +4 +m/d/yyyy + + +5 +m-d-yyyy + + +6 +mm/dd/yyyy + + +7 +mm-dd-yyyy + + +8 +yyyy/m/d + + +9 +yyyy-m-d + + +10 +dd.mm.yy + + +11 +dd.mm.yyyy + + + + + + + + +Precision + + +Sets the field's numeric precision. If the data type is other than a numeric +type, set this to 0. + + + + + + + + + + + + + + diff --git a/doc/kugar/template.docbook b/doc/kugar/template.docbook new file mode 100644 index 00000000..f5299fce --- /dev/null +++ b/doc/kugar/template.docbook @@ -0,0 +1,357 @@ + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +<sgmltag class="element">KugarTemplate</sgmltag> element + + +The KugarTemplate element defines +report attributes relating to page size, orientation, and margins. + + + +<!ELEMENT KugarTemplate (ReportHeader, PageHeader, DetailHeader*, Detail*, DetailFooter*, PageFooter, ReportFooter)> +<!ATTLIST KugarTemplate +PageSize CDATA #REQUIRED +PageOrientation CDATA #REQUIRED +TopMargin CDATA #REQUIRED +BottomMargin CDATA #REQUIRED +LeftMargin CDATA #REQUIRED +RightMargin CDATA #REQUIRED> + + + + + +Elements + + + + +The KugarTemplate element contains +the following elements: + + + + +ReportHeader + + +The ReportHeader element defines +report sections that are usually printed at the beginning of the report. + + + + + +PageHeader + + +The PageHeader element defines report +sections that are usually printed at the top of every page of the +report. + + + + + +DetailHeader + + +The DetailHeader element defines report +sections that are printed before details of a given level on the report. + + + + + +Detail + + +The Detail element defines the report +section that contains the report data. The report can have an unlimited number +of details. + + + + + +DetailFooter + + +The DetailFooter element defines report +sections that are printed after details of a given level and below on the report. + + + + + +PageFooter + + +The PageFooter element defines report +sections that are usually printed at the end of every page in the +report. + + + + + +ReportFooter + + +The ReportFooter element defines report +sections that are usually printed at the end of the report. + + + + + + + + + + + +Attributes + + + + +PageSize + + +Sets the size of the report page. The following values are available: + + + + +     + +Value +Page Size + + + + + +0 +A4 + + +1 +B5 + + +2 +Letter + + +3 +Legal + + +4 +Executive + + +5 +A0 + + +6 +A1 + + +7 +A2 + + +8 +A3 + + +9 +A5 + + +10 +A6 + + +11 +A7 + + +12 +A8 + + +13 +A9 + + +14 +B0 + + +15 +B1 + + +16 +B10 + + +17 +B2 + + +18 +B3 + + +19 +B4 + + +20 +B6 + + +21 +B7 + + +22 +B8 + + +23 +B9 + + +24 +C5E + + +25 +Comm10E + + +26 +DLE + + +27 +Folio + + +28 +Ledger + + +29 +Tabloid + + +30 +NPageSize + + + + + + + + + + +PageOrientation + + +Sets the report page orientation. + + + + + + +Value +Orientation + + + + +0 +Portrait + + +1 +Landscape + + + + + + + + +TopMargin + + +Sets the top margin of the report page. + + + + + +BottomMargin + + +Sets the bottom margin of the report page. + + + + + +LeftMargin + + +Sets the left margin of the report page. + + + +RightMargin + + +Sets the right margin of the report page. + + + + + + + + diff --git a/doc/kugar/templatedtd.docbook b/doc/kugar/templatedtd.docbook new file mode 100644 index 00000000..70d75015 --- /dev/null +++ b/doc/kugar/templatedtd.docbook @@ -0,0 +1,188 @@ + + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +The KugarTemplate Document Type Definition + + + +<?xml version="1.0" encoding="UTF-8"?> + +<!DOCTYPE KugarTemplate [ + <!ELEMENT KugarTemplate (ReportHeader, PageHeader, DetailHeader*, Detail*, DetailFooter*, PageFooter, ReportFooter)> + <!ATTLIST KugarTemplate + PageSize CDATA #REQUIRED + PageOrientation CDATA #REQUIRED + TopMargin CDATA #REQUIRED + BottomMargin CDATA #REQUIRED + LeftMargin CDATA #REQUIRED + RightMargin CDATA #REQUIRED> + + <!ELEMENT ReportHeader (Line*, Label*, Special*)> + <!ATTLIST ReportHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + <!ELEMENT PageHeader (Line*, Label*, Special*)> + <!ATTLIST PageHeader + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + <!ELEMENT DetailHeader (Line*, Label*, Special*)> + <!ATTLIST DetailHeader + Height CDATA #REQUIRED + Level CDATA #REQUIRED> + + <!ELEMENT Detail (Line*, Label*, Special*, Field*)> + <!ATTLIST Detail + Height CDATA #REQUIRED + Level CDATA #REQUIRED> + + <!ELEMENT DetailFooter (Line*, Label*, Special*)> + <!ATTLIST DetailFooter + Height CDATA #REQUIRED + Level CDATA #REQUIRED> + + <!ELEMENT PageFooter (Line*, Label*, Special*)> + <!ATTLIST PageFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + <!ELEMENT ReportFooter (Line*, Label*, Special*, CalculatedField*)> + <!ATTLIST ReportFooter + Height CDATA #REQUIRED + PrintFrequency CDATA #REQUIRED> + + <!ELEMENT Line EMPTY> + <!ATTLIST Line + X1 CDATA #REQUIRED + Y1 CDATA #REQUIRED + X2 CDATA #REQUIRED + Y2 CDATA #REQUIRED + Width CDATA #REQUIRED + Color CDATA #REQUIRED + Style CDATA #REQUIRED> + + <!ELEMENT Label EMPTY> + <!ATTLIST Label + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED> + + <!ELEMENT Field EMPTY> + <!ATTLIST Field + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> + + <!ELEMENT CalculatedField EMPTY> + <!ATTLIST CalculatedField + CalculationType CDATA #REQUIRED + Field CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DataType CDATA #REQUIRED + DateFormat CDATA #REQUIRED + Precision CDATA #REQUIRED + Currency CDATA #REQUIRED + NegValueColor CDATA #REQUIRED + CommaSeparator CDATA #REQUIRED> + + <!ELEMENT Special EMPTY> + <!ATTLIST Special + Type CDATA #REQUIRED + Text CDATA #REQUIRED + X CDATA #REQUIRED + Y CDATA #REQUIRED + Width CDATA #REQUIRED + Height CDATA #REQUIRED + BackgroundColor CDATA #REQUIRED + ForegroundColor CDATA #REQUIRED + BorderColor CDATA #REQUIRED + BorderWidth CDATA #REQUIRED + BorderStyle CDATA #REQUIRED + FontFamily CDATA #REQUIRED + FontSize CDATA #REQUIRED + FontWeight CDATA #REQUIRED + FontItalic CDATA #REQUIRED + HAlignment CDATA #REQUIRED + VAlignment CDATA #REQUIRED + WordWrap CDATA #REQUIRED + DateFormat CDATA #REQUIRED> + ]> + +     diff --git a/doc/kugar/tut_edit_height.png b/doc/kugar/tut_edit_height.png new file mode 100644 index 00000000..da4618f7 Binary files /dev/null and b/doc/kugar/tut_edit_height.png differ diff --git a/doc/kugar/tut_empty_report.png b/doc/kugar/tut_empty_report.png new file mode 100644 index 00000000..7effe6dd Binary files /dev/null and b/doc/kugar/tut_empty_report.png differ diff --git a/doc/kugar/tut_file_new.png b/doc/kugar/tut_file_new.png new file mode 100644 index 00000000..a06492e3 Binary files /dev/null and b/doc/kugar/tut_file_new.png differ diff --git a/doc/kugar/tut_rep_complete.png b/doc/kugar/tut_rep_complete.png new file mode 100644 index 00000000..1ac79a22 Binary files /dev/null and b/doc/kugar/tut_rep_complete.png differ diff --git a/doc/kugar/tut_rep_generated.png b/doc/kugar/tut_rep_generated.png new file mode 100644 index 00000000..7b8be549 Binary files /dev/null and b/doc/kugar/tut_rep_generated.png differ diff --git a/doc/kugar/tut_rep_look1.png b/doc/kugar/tut_rep_look1.png new file mode 100644 index 00000000..1fad4189 Binary files /dev/null and b/doc/kugar/tut_rep_look1.png differ diff --git a/doc/kugar/tut_rep_look2.png b/doc/kugar/tut_rep_look2.png new file mode 100644 index 00000000..e01a61fb Binary files /dev/null and b/doc/kugar/tut_rep_look2.png differ diff --git a/doc/kugar/tut_set_level.png b/doc/kugar/tut_set_level.png new file mode 100644 index 00000000..9a364a24 Binary files /dev/null and b/doc/kugar/tut_set_level.png differ diff --git a/doc/kugar/tutorial.docbook b/doc/kugar/tutorial.docbook new file mode 100644 index 00000000..67cd0f42 --- /dev/null +++ b/doc/kugar/tutorial.docbook @@ -0,0 +1,313 @@ + + + + + +Alexander +Dymo + +
    cloudtemple@mksat.net
    +     +     + +Phil +Thompson + +
    phil@river-bank.demon.co.uk
    +     +     + +     +     +Tutorial + +This tutorial attempts to be a brief introduction to Kugar. + +You will create a sample report template with &kudesigner;, +a sample data file and finally generate a complete report. + +The source code for sample templates and data files can be found +in sample1.ktf and sample1.kdf +that are distributed with &kugar;. + + + +Creating the report template with &kudesigner; + + +Run Kugar Designer by typing kudesigner in the shell. + + + +After you start the designer, choose File|New +and set the page size to Letter and paper orientation to +Landscape. Set the left and right margins to 48, top +and bottom margins to 40. All dimensions in &kudesigner; (page +margins, sizes, positions, &etc;) are measured in millimeters. + + + + + + +New Report dialog + + + + + + +A new report is now created and all buttons on the Items Toolbar +and Sections Toolbar are now enabled (the corresponding +menu items from Items and Sections are also enabled). + + + + + + +Empty Report window + + + + + +Now it is the time to add some sections to the report and determine +their sizes. We will add report header and footer, +page header and footer and a single +detail section. Report headers and footers are printed on the +first page and on the last page of the report before and after any other report data accordingly. +Report footers are good places for calculated fields. +Page headers and footers are printed at the top and bottom of each page. +Our report will have one detail section with level 0. This means that all our data rows +have identical structure (&ie; fields). If the data structure is more complex or it is +organized according to a master-detail relationship, more detail levels should be created. +See sample3.ktf and sample3.kdf for an example +of how that can be done. +Refer to the template elements descriptions +for additional information. + + +Sections are added by using Sections menu +or a Sections Toolbar. Now add a report header and footer, +a page header and footer and then a detail section. +When adding a detail section, set +its level to 0 as shown on the screenshot below. + + + + + + +Setting the detail level + + + + + + +Our report should now look like this one in the screenshot. + + + + + + +Report with sections + + + + + + +All our sections have a predefined height - 50mm. Let's change it. +To do this &RMB; click on the Report Header section or click the Edit Properties +button on the Edit Toolbar and then choose a section. +The Properties window should be shown. + + + + + + +Height of the section editing + + + + + + +Now set the Report Header's height to 70. Let's perform that procedure +for all other sections. Set the Page Header's height to 45 and the Detail's to 30. +The Page and Report Footers should be 32 mm in height. + + + +A report template with properly sized sections is ready to be filled with +report items. + + + + + + +Report with sized sections + + + + + + +You can now add items to the sections on the report. Five different types of +items can be added to the report. Label +is a rectangular area that can have borders and can be filled by +any kind of textual data. The Label's foreground and background colors, +as well as fonts, can be changed. Border line types and line colors are also +customizable. Fields can be placed +on to a detail section. Fields represent data fields; their values +will be collected from a data file while generating a report. +Counts, sums, averages, &etc; for field values can be printed on the report +by means of Calculated Fields. +Specials are labels with predefined text, +such as current date or page number. The general report appearance can be refined +with Lines. + + + +To add a report item click the corresponding item button on the Items Toolbar +and place (click) it on the section. The chosen item will be placed on the selected section +with the upper left corner at the given coordinates. Other properties are set to default +values and can be changed with the Report Item Options dialog (the same way +we used to change the section's height). + + + +So, let's add labels to the report header and page header as shown on the screenshot below. +Note that the Mutiny Bay Software label has its BorderStyle +and BorderWidth set to 0 and Software Inventory Report - 1mm. +Any colors are set as a combination of three values (RGB - red,green,blue) separated by commas. + + + +We will also add field elements to the detail section. Just assume we have four fields +- title, version, platform and copies. So, four Field elements should be placed and +their Field properties set. Note that Text +property is automatically set to [field_name]. + + + +Our page footer is a good place to show the current date and page number, so add two +special fields and set their Type properties to 0 and 1. +A special with Type=0 will represent date and one with Type=1 - page number. Note that +special's Text property is changed automatically. + + + +The last element to be placed is a Calculated Field for the copies +field. To acquire a sum (copies) set the calculated field's Field property +to copies and CalculationType to 1 (sum function). + + + +Finally, our report template should look like this: + + + + + + +Complete report + + + + + + + + + + +Creating the report data file + + +Generally speaking, data files may be created in several ways. Some will use xsl transformation tables +to generate proper &XML; from another &XML; document (like a &kspread; spreadsheet); others will use +their own program to fetch data from a database and fill the data file. In this tutorial we will +simply create it by hand. The source code for the example can be found in file sample1.kdf +or copied from the example below. + + + +<?xml version=1.0 encoding=UTF-8?> + +<!DOCTYPE KugarData [ + <!ELEMENT KugarData (Row* )> + <!ATTLIST KugarData + Template CDATA #REQUIRED> + + <!ELEMENT Row EMPTY> + <!ATTLIST Row + level CDATA #REQUIRED + title CDATA #REQUIRED + version CDATA #REQUIRED + platform CDATA #REQUIRED + copies CDATA #REQUIRED> +]> + +<KugarData Template="sample1.ktf"> + <Row level="0" title=" BRU" version="15.0" platform="x86" copies="1"/> + <Row level="0" title=" Caldera Open Linux" version="2.2" platform="x86" copies="3"/> + <Row level="0" title=" K Desktop" version="1.1.1" platform="x86" copies="1"/> + <Row level="0" title=" Netscape Communicator" version="4.6" platform="x86" copies="10"/> + <Row level="0" title=" Redhat Linux" version="5.0" platform="x86" copies="11"/> + <Row level="0" title=" Redhat Linux" version="5.1" platform="x86" copies="12"/> + <Row level="0" title=" Redhat Linux" version="5.2" platform="x86" copies="14"/> + <Row level="0" title=" Redhat Linux" version="6.0" platform="x86" copies="15"/> + <Row level="0" title=" Star Office" version="5.0" platform="x86" copies="1"/> + <Row level="0" title=" Star Office" version="5.1" platform="x86" copies="3"/> + <Row level="0" title=" Microsoft Windows NT" version="3.1" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="3.51" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="4.0" platform="x86" copies="1"/> + <Row level="0" title=" Microsoft Windows NT" version="5.0" platform="x86" copies="1"/> + <Row level="0" title=" Sun Solaris" version="2.5" platform="Sparc" copies="1"/> +</KugarData> + + + + + +Generating the report + + +At this moment we have a report template (sample1.ktf) and +a report data file (sample1.kdf). + + +To generate a report, type the following command in the shell: +kugar + + + + +This will bring up a &kugar; shell window with the report generated. + + + + + + +Generated report + + + + + + + +     diff --git a/doc/kword/ChooseTempDia.png b/doc/kword/ChooseTempDia.png new file mode 100644 index 00000000..10852c0e Binary files /dev/null and b/doc/kword/ChooseTempDia.png differ diff --git a/doc/kword/Makefile.am b/doc/kword/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kword/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kword/Tut1.png b/doc/kword/Tut1.png new file mode 100644 index 00000000..f2203f59 Binary files /dev/null and b/doc/kword/Tut1.png differ diff --git a/doc/kword/Tut11a.png b/doc/kword/Tut11a.png new file mode 100644 index 00000000..349690bb Binary files /dev/null and b/doc/kword/Tut11a.png differ diff --git a/doc/kword/Tut11b.png b/doc/kword/Tut11b.png new file mode 100644 index 00000000..7d8ae6d0 Binary files /dev/null and b/doc/kword/Tut11b.png differ diff --git a/doc/kword/Tut13.png b/doc/kword/Tut13.png new file mode 100644 index 00000000..0af51f9c Binary files /dev/null and b/doc/kword/Tut13.png differ diff --git a/doc/kword/Tut13a.png b/doc/kword/Tut13a.png new file mode 100644 index 00000000..82a8cf93 Binary files /dev/null and b/doc/kword/Tut13a.png differ diff --git a/doc/kword/Tut14.png b/doc/kword/Tut14.png new file mode 100644 index 00000000..44101725 Binary files /dev/null and b/doc/kword/Tut14.png differ diff --git a/doc/kword/Tut14a.png b/doc/kword/Tut14a.png new file mode 100644 index 00000000..8754ea73 Binary files /dev/null and b/doc/kword/Tut14a.png differ diff --git a/doc/kword/Tut14b.png b/doc/kword/Tut14b.png new file mode 100644 index 00000000..01863a1f Binary files /dev/null and b/doc/kword/Tut14b.png differ diff --git a/doc/kword/Tut15.png b/doc/kword/Tut15.png new file mode 100644 index 00000000..4c685c18 Binary files /dev/null and b/doc/kword/Tut15.png differ diff --git a/doc/kword/Tut15b.png b/doc/kword/Tut15b.png new file mode 100644 index 00000000..77ec4330 Binary files /dev/null and b/doc/kword/Tut15b.png differ diff --git a/doc/kword/Tut16.png b/doc/kword/Tut16.png new file mode 100644 index 00000000..d753485a Binary files /dev/null and b/doc/kword/Tut16.png differ diff --git a/doc/kword/Tut18.png b/doc/kword/Tut18.png new file mode 100644 index 00000000..01863a1f Binary files /dev/null and b/doc/kword/Tut18.png differ diff --git a/doc/kword/Tut19.png b/doc/kword/Tut19.png new file mode 100644 index 00000000..c997e273 Binary files /dev/null and b/doc/kword/Tut19.png differ diff --git a/doc/kword/Tut2.png b/doc/kword/Tut2.png new file mode 100644 index 00000000..06844d06 Binary files /dev/null and b/doc/kword/Tut2.png differ diff --git a/doc/kword/Tut21.png b/doc/kword/Tut21.png new file mode 100644 index 00000000..48948a3e Binary files /dev/null and b/doc/kword/Tut21.png differ diff --git a/doc/kword/Tut22.png b/doc/kword/Tut22.png new file mode 100644 index 00000000..191b2cb1 Binary files /dev/null and b/doc/kword/Tut22.png differ diff --git a/doc/kword/Tut3.png b/doc/kword/Tut3.png new file mode 100644 index 00000000..64ed9298 Binary files /dev/null and b/doc/kword/Tut3.png differ diff --git a/doc/kword/Tut4.png b/doc/kword/Tut4.png new file mode 100644 index 00000000..a75b8643 Binary files /dev/null and b/doc/kword/Tut4.png differ diff --git a/doc/kword/Tut7.png b/doc/kword/Tut7.png new file mode 100644 index 00000000..8c12d42e Binary files /dev/null and b/doc/kword/Tut7.png differ diff --git a/doc/kword/Tut8.png b/doc/kword/Tut8.png new file mode 100644 index 00000000..fc9d6d1e Binary files /dev/null and b/doc/kword/Tut8.png differ diff --git a/doc/kword/a11y.docbook b/doc/kword/a11y.docbook new file mode 100644 index 00000000..bcf95101 --- /dev/null +++ b/doc/kword/a11y.docbook @@ -0,0 +1,365 @@ + + + + +Gary +Cramblitt + + + + + +For Users with Disabilities +This section of the documentation discusses accessibility features in &kword; +for users with disabilities. Some of these features apply to &kde; as a whole and are controlled from +&kcontrolcenter;. Some apply to all &koffice; applications, +and some are specific to &kword;. + + +Installing the <command>kdeaccessibility</command> Module +kdeaccessibility + +Most of the features described in this chapter are enabled by installing the +kdeaccessibility module. +The kdeaccessibility module is part of the &kde; project +http://www.kde.org. The kdeaccessibility +package can be obtained from &kde-ftp;, the +main ftp site of the &kde; project. + + +Many distributions offer precompiled binaries on their ftp sites. Please check your distribution's web sites for more information. + +More information about &kde; accessibility can be obtained by +visiting http://accessibility.kde.org/. + + + + +Visual Impairments +Visual Impairments + +&kword; is not usable by totally blind users. It is hoped that +a general screen reader for the blind will be available in future versions of &kde;. + + + +Theming +Theming +For low-sighted or light allergic users, several features are available in the &kcontrolcenter; +Appearance & ThemesTheme Manager, +like high contrast color themes. If you are light allergic, the +HighContrastDark or HighContrastLight themes +may be helpful. If you have difficulty reading small fonts or seeing small icons, the +HighContrastDark-big or HighContrastLight-big +themes will increase the size of text, buttons, and icons. You may also customize +background, colors, fonts, and icons from the same dialog. A set of monochrome icons +is available. + + +If you choose one of the Big themes, you may discover that +some windows are too large to fit your monitor. Purchasing a larger monitor will be helpful. +You can drag the portions of the window not visible into the visible area by +holding down the &Alt; key and dragging with the &LMB; anywhere +within the screen. If you have trouble operating a mouse, you can also move screens by pressing +&Alt;F3. In +the dropdown Windows Operations Menu, choose +Move. +Move the screen with the arrow keys and press &Esc; to finish the move. + + + + + +&kmagnifier; +magnifier +The kdeaccessibility module includes a screen magnifier +application called &kmagnifier;. +If it is installed, you can run it from +K-ButtonUtilities +KMag (Screen Magnifier). + + + + +Text-to-Speech +Text-to-Speech +TTS +The kdeaccessibility module includes a Text-to-Speech +component called KTTS. If KTTS is installed, you can configure &kword; to +speak the text that is under the mouse pointer or speak the text of each +screen widget as it receives focus. Before using this feature, first configure +KTTS. See The KTTS Handbook for details. +To turn on the TTS feature in &kword;, +select SettingsConfigure +&kword;... from the menubar. +This will display a dialog box. +Clicking on TTS will allow you to change +the following: + + + + + + + + + +Speak widget under mouse pointer +When checked, &kword; will speak the text of each widget +as the mouse pointer moves over the widget. + + + +Speak widget with focus +When checked, &kword; will speak the text of each widget +as it receives focus. + + + +Speak tool tips +When checked, &kword; will speak the popup tool tip +for each widget in addition to the text of the widget. + + + +Speak What's This +When checked, &kword; will speak the What's This help +for each widget in addition to the text of the widget. + + + +Say whether disabled +When checked, &kword; will speak the word "disabled" +if the widget is currently disabled (grayed). + + + +Speak accelerators +When checked, &kword; will speak the accelerator +of the widget in addition to the text of the widget. +Accelerators are the underlined letters you see in the text of the +widget. For example, in the main menu, the +Quit menu item +has the "Q" underlined. You can choose it by pressing Q. +To speak the accelerator, check this option and enter the +word you want to speak before the accelerator in the +Prefaced by the word box. In this +example shown above, &kword; will speak "Accelerator Q". + + + +Polling interval +This option determines how often &kword; will +check for a change in the widget under the mouse pointer or +a new focused widget. You should leave this option on the +default setting. + + + + + +If the TTS option does not appear +on this screen, you do not have the KTTS component installed +in your system. + + +Not all widgets are spoken. For example, +the items on the main menubar are not spoken. The text of the +&kword; document window is also not spoken, but see + for another way to speak the document. + + + + + + + +Motor Impairments and Mouseless Operation +Motor Impairments +Mouseless Operation + + +KMouseTool +If you can operate a mouse, but have trouble clicking, the +KMouseTool application may help. Run it from +K-ButtonUtilities +KMouseTool (Automatik Mouse Click). + + + + +XAccess Features +XAccess +Sticky Keys +Slow Keys +Bounce Keys + +The &kcontrolcenter; offers several keyboard features collectively called XAccess. +They include: + + +Sticky Keys +This feature permits operation of meta keys, such as +&Alt;, &Ctrl;, and &Shift; without having to hold the keys down. It is useful +when you can only use one finger or one hand to operate the keyboard. +With Sticky Keys on, press and release a &Alt;, &Ctrl;, or &Shift; key, then +press another key. The result is as if you pressed both keys at once. +Press the &Alt;, &Ctrl;, or &Shift; key again to turn off the sticky key. +Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityAccessibility +Modifier Keys. + + + +Slow Keys +This feature is useful if you have hand tremors or difficulty +accurately pressing keys. It prevents +inadvertent key presses by requiring that a key be held down for a minimum +time before it is accepted. Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityAccessibility +Keyboard Filters. + + + +Bounce Keys +This feature is also useful if you have hand tremors. It prevents +inadvertent repeated key presses by preventing another keystroke for +a certain amount of time. Activate this feature in +K-Button&kcontrolcenter; +Regional & AccessibilityAccessibility +Keyboard Filters. + + + + + + + +Mouse Emulation +Mouse Emulation +Mouse Emulation permits you to move and click the mouse using the keyboard. +Press &Alt;F12 to activate it. Use the arrow keys +to move the mouse pointer to the desired location, and press spacebar +to "click" the mouse. Unfortunately, you cannot use Mouse Emulation to perform +&RMB; clicks or dragging. + + + + +Mouse Navigation +Mouse Navigation +This feature permits you to emulate the mouse using the numeric keypad +of your keyboard. To activate it, go to +K-Button&kcontrolcenter; +PeripheralsMouse +Mouse Navigation. +Check the Move pointer with keyboard (using the num pad) box. When you do this, the other settings will become enabled, and you can customize the keyboard pointer behavior further, if required. + The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The 5 key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the / key (which makes it &LMB;), +* key (which makes it middle mouse button) and - (which makes it &RMB;). + Using the + emulates a doubleclick to the selected pointer button. You can use the +0 key to emulate holding down the selected pointer button (for easy dragging), +and then use the . to emulate releasing the selected pointer button. + + + + + + + + + + + +Keyboard shortcuts + +&kword; has a number of keyboard shortcuts that will be useful +to users who cannot operate a mouse. See for +details. In addition, the following tips will be useful: + + + + +Several of the functions that can only be performed with the mouse in the +main document panel can be performed with the keyboard in the +Document Structure area. See . +You can switch from the document panel +to the Document Structure area by pressing +&Alt;1. Switch to the +document panel by pressing +&Alt;2. + +Use the Menu key to pop up the context +menu. On most keyboards, the Menu key is on the righthand +side of the keyboard between the &Windows; and &Ctrl; +keys. It has a menu icon on it. + + +When inserting a new frame into the document, you can insert the frame +at the current position of the text caret, instead of positioning it with +the mouse. Just press &Enter; when the crosshairs appear. You can resize +the new frame or change its position by changing the numbers in the +Connect Frame dialog. See + for details. + + +In order to change the properties of a frame or delete a frame, you must first select it. +To do so without using the mouse, position the text caret anywhere inside the frame and +choose EditSelect Frame +from the main menubar. Alternatively, press &Alt;1 to +go to the Document Structure area, +scroll to the desired frame, press the Menu key to pop up the context +menu and choose +Properties +or Delete Frame. + +You cannot use the arrow keys to move the text caret into some +frames within the document panel. To move the caret inside the frame, +press &Alt;1 to +go to the Document Structure area, +scroll to the desired frame, press the Menu key to pop up the context +menu and choose Edit Text. + + + + + + +Resizing panels + +You can move the sizing bar between the Document Structure area +and the main document panel by pressing F8. A sizing icon appears +overtop the sizing bar. Use the arrow keys to move the bar left or right. +Press F8 again or &Esc; when finished sizing. + + + + + +Setting focus to widgets + +Normally, one can use the and &Shift; +to move focus from one widget to the next in any application. However, when focus is on +the main document in &kword;, pressing does not move the focus; instead it inserts +a tabulator into the document. You can set focus to any widget that can receive focus by +pressing &Alt;F8. A small lettered box appears +overtop each widget on the screen that can receive focus. + + + + + + + + +Press the letter to move focus to the corresponding widget. Press +&Alt;F8 again or &Esc; +to abandon moving the focus. + + + + + + + diff --git a/doc/kword/addentry.png b/doc/kword/addentry.png new file mode 100644 index 00000000..0ecdeea3 Binary files /dev/null and b/doc/kword/addentry.png differ diff --git a/doc/kword/addrecord.png b/doc/kword/addrecord.png new file mode 100644 index 00000000..bb9796d0 Binary files /dev/null and b/doc/kword/addrecord.png differ diff --git a/doc/kword/alignBlock.png b/doc/kword/alignBlock.png new file mode 100644 index 00000000..5a2e0b89 Binary files /dev/null and b/doc/kword/alignBlock.png differ diff --git a/doc/kword/alignCenter.png b/doc/kword/alignCenter.png new file mode 100644 index 00000000..07f0e5c9 Binary files /dev/null and b/doc/kword/alignCenter.png differ diff --git a/doc/kword/alignLeft.png b/doc/kword/alignLeft.png new file mode 100644 index 00000000..6aa98185 Binary files /dev/null and b/doc/kword/alignLeft.png differ diff --git a/doc/kword/alignRight.png b/doc/kword/alignRight.png new file mode 100644 index 00000000..c725fc19 Binary files /dev/null and b/doc/kword/alignRight.png differ diff --git a/doc/kword/auto1.png b/doc/kword/auto1.png new file mode 100644 index 00000000..0935d753 Binary files /dev/null and b/doc/kword/auto1.png differ diff --git a/doc/kword/auto2.png b/doc/kword/auto2.png new file mode 100644 index 00000000..e3c0f22c Binary files /dev/null and b/doc/kword/auto2.png differ diff --git a/doc/kword/auto3.png b/doc/kword/auto3.png new file mode 100644 index 00000000..d41beaaa Binary files /dev/null and b/doc/kword/auto3.png differ diff --git a/doc/kword/auto4.png b/doc/kword/auto4.png new file mode 100644 index 00000000..c631d5e1 Binary files /dev/null and b/doc/kword/auto4.png differ diff --git a/doc/kword/autocompdlg.png b/doc/kword/autocompdlg.png new file mode 100644 index 00000000..56d168cc Binary files /dev/null and b/doc/kword/autocompdlg.png differ diff --git a/doc/kword/back.png b/doc/kword/back.png new file mode 100644 index 00000000..4b7765e4 Binary files /dev/null and b/doc/kword/back.png differ diff --git a/doc/kword/basic.png b/doc/kword/basic.png new file mode 100644 index 00000000..fa46a675 Binary files /dev/null and b/doc/kword/basic.png differ diff --git a/doc/kword/basics.docbook b/doc/kword/basics.docbook new file mode 100644 index 00000000..cf1ef613 --- /dev/null +++ b/doc/kword/basics.docbook @@ -0,0 +1,194 @@ + + + + +Mike +McBride + + + + +The &kword; Window + + +Overview +screen + +&kword;, like most &GUI; based programs, divides +the window up into several areas. Each area of the window is used to +perform a group of similar features. When you examine the &kword; +window, it is divided into 5 major areas: + + +The &kde; Titlebar +(which remains at the top of all programs run under +&kde;). + +The Menubar. + +An assortment of +Toolbars. + +The Document Structure Area. + +The Document +Area, including the rulers and scrollbars. + +The Status bar. + + + + + + + + + + +The &kde; Titlebar +The &kde; titlebar sits on top of all applications run under &kde;. +For more information on the titlebar, please see the &kde; User Guide. + + + +The Menubar + +The menubar provides access to all of &kword;'s functions and +options. Each part of the &kword; menubar is detailed in the section +entitled: The Menubar. + + + +The Toolbars + +The toolbars provide shortcuts to commonly used functions. +&kword; uses 8 toolbars, with similar functions grouped together. + + + + +Document Structure Area +The Document Structure area places individual types of data into useful groups +(pictures, tables, text, etc) to help you find the correct data in a complicated document. For +more information, see the section on Document Structure. + + + + +The Statusbar +The status bar provides important information during the editing of your document. +In the lower left corner, &kword; gives you the current page number and the total number of pages. There will be helpful text shown in +the status bar whenever you hold the mouse over a menu item. +The status bar can be toggled on and off. +See the section on Configure &kword; User Interface. + + + +The Document Area + +The document area consists of: + + +Horizontal and Vertical Rulers - +The rulers can be used to help you layout your document. For more +information on rulers, see Using +Rulers. + + + +Scrollbars - The scrollbars are used to move through a &kword; document +quickly. The &kword; scrollbars functions similar to all scrollbars in +&kde; or &Windows;. +The scrollbars can be toggled on and off. +See the section on Configure &kword; User Interface. + + +Tab Selector - This is used to select and place tab stops in your document for +easy formatting. For more information on tab stops, see the section +entitled Using Tab Stops. + + + +Document View - This is the area of the screen which is used to enter text. It +shows you the current status of your document, and allows you to adjust +frames, select text, and cut and paste text. + + + + + + + + + + +Using Rulers +rulers +Along the top and left edges of the document area, are a +horizontal and a vertical ruler. + +These rulers measure from the top left corner of the page. + +Each ruler has a bright area surrounded by a dark area. The +bright area shows the size and location of the currently edited frame +on that page. As you change frames, the bright area changes to reflect +the new frame's settings. + + + + + + + + +The ruler can measure the page in many common units of measure including: + + +Millimeters (mm) +Points (pt) +Inches (in) +Centimeters (cm) +Decimeters (dm) +Pica (pi) +Didot (dd) +Cicero (cc) + + +To change the units of the ruler, place the mouse cursor over one +of the rulers (either one), and click with the +&RMB;. + +Select the units you want to use from the popup menu. You will notice both rulers +change to the new unit of measure. + +You may also notice two vertical arrows (one pointed up, the other +pointed down), on the left side of the bright area of the horizontal +ruler. These are used to adjust the margin of a paragraph. For more +information, see the section entitled Formatting Paragraphs. + +Finally, you may see some black marks, which are not part of the +ruler. They may appear as L shaped, a Reverse-L, an Upside-down T, or +an Upside-down T with a dot in it. These are locations of tab stops. +For more information see the section entitled Using Tab Stops. + + +To quickly format the page layout, you can right mouse click on +either ruler. A small sub menu will appear. Simply select Page Layout..., +and the Page Layout Dialog box +will appear. + + + +If you don't want the rulers in your document area, they +can be switched off. Simply select +ViewHide Rulers from the menubar. +This will remove the rulers from the document area. Simply select +ViewShow Rulers to display the rulers again. + + + + + + diff --git a/doc/kword/bbord.png b/doc/kword/bbord.png new file mode 100644 index 00000000..218a0ea7 Binary files /dev/null and b/doc/kword/bbord.png differ diff --git a/doc/kword/bdcolorbut.png b/doc/kword/bdcolorbut.png new file mode 100644 index 00000000..9c372cd8 Binary files /dev/null and b/doc/kword/bdcolorbut.png differ diff --git a/doc/kword/bdselbut.png b/doc/kword/bdselbut.png new file mode 100644 index 00000000..b93a6ae3 Binary files /dev/null and b/doc/kword/bdselbut.png differ diff --git a/doc/kword/bdsizebut.png b/doc/kword/bdsizebut.png new file mode 100644 index 00000000..31bc4d6c Binary files /dev/null and b/doc/kword/bdsizebut.png differ diff --git a/doc/kword/beginning.png b/doc/kword/beginning.png new file mode 100644 index 00000000..0e2d3df2 Binary files /dev/null and b/doc/kword/beginning.png differ diff --git a/doc/kword/bkgdcolorbut.png b/doc/kword/bkgdcolorbut.png new file mode 100644 index 00000000..43ac05c6 Binary files /dev/null and b/doc/kword/bkgdcolorbut.png differ diff --git a/doc/kword/bold.png b/doc/kword/bold.png new file mode 100644 index 00000000..6e353e3b Binary files /dev/null and b/doc/kword/bold.png differ diff --git a/doc/kword/bookmarks.docbook b/doc/kword/bookmarks.docbook new file mode 100644 index 00000000..2015a536 --- /dev/null +++ b/doc/kword/bookmarks.docbook @@ -0,0 +1,69 @@ + + + + +Mike +McBride + + + + +Document bookmarks +bookmarks + +Bookmarks are invisible placeholders that allow you to move easily to specified points in a large document. +Some other wordprocessors have bookmarks as part of their interface. If you are familiar with their use, you will +find that &kword; functions in a similar manner. +It should be noted that bookmarks are attached to the text near the cursor, not the page location. If +the text moves forward or backward in the document (as text is inserted or deleted respectively), the bookmark moves with the text. + +Creating a new bookmark +Creating a bookark is simple. +Place the cursor where you want the bookmark to be inserted. Select +InsertBookmark... from +the menubar. +A small dialog box will appear. +Type a short description of the bookmark location (i.e. Chapter 1, Appendix, Abstract, etc). This description will identify the +bookmark for you. +Click OK to create the bookmark. +Click Cancel to return to your document without creating a bookmark. + + + +Jump to a previously created bookmark +To jump to a previously created bookmark, select +ToolsSelect Bookmark... from +the menubar. +A small dialog will appear. Double click on the desired bookmark with the &LMB;. You will immediately be taken to +the location in the document that is attached to that bookmark. +Alternatively, you can click once on the desired bookmark with the &LMB;, and then click on +OK. This will function the same as double clicking on the bookmark. + + + + +Rename a bookmark +To rename a bookmark, select +ToolsSelect Bookmark... from +the menubar. +A small dialog will appear. Click on the desired bookmark with the &LMB;. Now click Rename Bookmark. +A small dialog will appear. Enter the new name for your bookmark. Click OK. The +bookmark is renamed immediately. + + + +Delete a bookmark +To delete a bookmark, select +ToolsSelect Bookmark... from +the menubar. +A small dialog will appear. Click on the desired bookmark with the &LMB;. +Be sure you have selected the correct bookmark from the list before proceeding. &kword; does not ask for +confirmation before deleting the selected bookmark. +Now click Delete Bookmark. +The bookmark is deleted immediately. + + + + + + diff --git a/doc/kword/borbutB.png b/doc/kword/borbutB.png new file mode 100644 index 00000000..66624ae7 Binary files /dev/null and b/doc/kword/borbutB.png differ diff --git a/doc/kword/borbutL.png b/doc/kword/borbutL.png new file mode 100644 index 00000000..889074a9 Binary files /dev/null and b/doc/kword/borbutL.png differ diff --git a/doc/kword/borbutR.png b/doc/kword/borbutR.png new file mode 100644 index 00000000..fbcc6044 Binary files /dev/null and b/doc/kword/borbutR.png differ diff --git a/doc/kword/borbutT.png b/doc/kword/borbutT.png new file mode 100644 index 00000000..bd8555af Binary files /dev/null and b/doc/kword/borbutT.png differ diff --git a/doc/kword/bord.png b/doc/kword/bord.png new file mode 100644 index 00000000..e414b5a6 Binary files /dev/null and b/doc/kword/bord.png differ diff --git a/doc/kword/bordtb.png b/doc/kword/bordtb.png new file mode 100644 index 00000000..1f3711c1 Binary files /dev/null and b/doc/kword/bordtb.png differ diff --git a/doc/kword/bullist.png b/doc/kword/bullist.png new file mode 100644 index 00000000..d0eda054 Binary files /dev/null and b/doc/kword/bullist.png differ diff --git a/doc/kword/cftb.png b/doc/kword/cftb.png new file mode 100644 index 00000000..5f403675 Binary files /dev/null and b/doc/kword/cftb.png differ diff --git a/doc/kword/chapnumb.docbook b/doc/kword/chapnumb.docbook new file mode 100644 index 00000000..bbeb8a06 --- /dev/null +++ b/doc/kword/chapnumb.docbook @@ -0,0 +1,15 @@ + + + + +- +- + + + + + Chapter numbering + chapter numbering + + Not written yet + diff --git a/doc/kword/chcase.png b/doc/kword/chcase.png new file mode 100644 index 00000000..051e822a Binary files /dev/null and b/doc/kword/chcase.png differ diff --git a/doc/kword/chcolorbut.png b/doc/kword/chcolorbut.png new file mode 100644 index 00000000..51579475 Binary files /dev/null and b/doc/kword/chcolorbut.png differ diff --git a/doc/kword/chfontbut.png b/doc/kword/chfontbut.png new file mode 100644 index 00000000..b748cda5 Binary files /dev/null and b/doc/kword/chfontbut.png differ diff --git a/doc/kword/chsizebut.png b/doc/kword/chsizebut.png new file mode 100644 index 00000000..ab8b8121 Binary files /dev/null and b/doc/kword/chsizebut.png differ diff --git a/doc/kword/chstylebut.png b/doc/kword/chstylebut.png new file mode 100644 index 00000000..5ee49649 Binary files /dev/null and b/doc/kword/chstylebut.png differ diff --git a/doc/kword/clearright.png b/doc/kword/clearright.png new file mode 100644 index 00000000..d88f1625 Binary files /dev/null and b/doc/kword/clearright.png differ diff --git a/doc/kword/colin.png b/doc/kword/colin.png new file mode 100644 index 00000000..cea3c68d Binary files /dev/null and b/doc/kword/colin.png differ diff --git a/doc/kword/colorseldlg.png b/doc/kword/colorseldlg.png new file mode 100644 index 00000000..11539ae9 Binary files /dev/null and b/doc/kword/colorseldlg.png differ diff --git a/doc/kword/colout.png b/doc/kword/colout.png new file mode 100644 index 00000000..1aa02037 Binary files /dev/null and b/doc/kword/colout.png differ diff --git a/doc/kword/columns.docbook b/doc/kword/columns.docbook new file mode 100644 index 00000000..a48135e8 --- /dev/null +++ b/doc/kword/columns.docbook @@ -0,0 +1,56 @@ + + + + +Mike +McBride + + + + + +Columns +columns + +You can divide the page into several columns, of equal width, with +a user controlled space in between each column. + + +This feature is only available in Text Oriented documents. + +If you are working in a Page Layout document, you can +build up several columns using a different frame for each column. + + +To change the number and width of columns select +FormatPage Layout... +from the menubar. + +This will bring up a dialog box. + + + + + + + +Click on the tab labeled Columns. + +This will change the dialog box. + + + + + + + +You can now select the number of columns in the spin box labeled Columns:, and the spacing +between columns in the text box labeled Column spacing:. + +The preview box shows you what your page will look like. + +Click OK when you are done. + +Click Cancel to abort changes. + + diff --git a/doc/kword/ctab.png b/doc/kword/ctab.png new file mode 100644 index 00000000..2255874d Binary files /dev/null and b/doc/kword/ctab.png differ diff --git a/doc/kword/ctab2.png b/doc/kword/ctab2.png new file mode 100644 index 00000000..77787106 Binary files /dev/null and b/doc/kword/ctab2.png differ diff --git a/doc/kword/decindbut.png b/doc/kword/decindbut.png new file mode 100644 index 00000000..8b8a9971 Binary files /dev/null and b/doc/kword/decindbut.png differ diff --git a/doc/kword/delentry.png b/doc/kword/delentry.png new file mode 100644 index 00000000..5453f9f5 Binary files /dev/null and b/doc/kword/delentry.png differ diff --git a/doc/kword/delrecord.png b/doc/kword/delrecord.png new file mode 100644 index 00000000..a8feb98e Binary files /dev/null and b/doc/kword/delrecord.png differ diff --git a/doc/kword/doccomments.docbook b/doc/kword/doccomments.docbook new file mode 100644 index 00000000..0f409ccd --- /dev/null +++ b/doc/kword/doccomments.docbook @@ -0,0 +1,69 @@ + + + + +Mike +McBride + + + + +Document Comments +comments + +Document comments are included in &kword; to allow you to have your documents read by another +person. That person can make comments about the text and the comment will appear right next to the text. + +Adding a comment to a document +To add a comment to a document, select the text you want the comment to apply to. +Select +Insert +Comment... + from the menubar. This will bring up a small dialog box. +Type the text of your comment in the dialog box provided. If you click on the +Add Author Name, the text will be signed, dated and the current time will be added. +The authors name must be entered in the Document Information +dialog or the name will not be included. +When you have entered all of your text, click OK to add your comment. +The comment will appear as a small yellow box at the cursor location. + + +Adding to or changing the comment in a document +To add more comments or change previous comments place the mouse pointer over the comment you +want to edit. Click once with the &RMB;. A popup menu will appear. Select Edit Comment.... +You can now make your changes to the comment. + + +Deleting a comment from a document +To delete a comment, place the mouse pointer over the comment you +want to edit. Click once with the &RMB;. A popup menu will appear. Select Remove Comment. +The comment is immediately deleted. + + +Hiding all comments in a document +To hide all comments, select +Settings +Configure &kword;... + from the menubar. +This will bring up a dialog box. + + + + + + + + +Click on Misc. + + + + + + + + +The check box labeled Display comments is used to toggle the comments on and off. + + + diff --git a/doc/kword/doclinks.docbook b/doc/kword/doclinks.docbook new file mode 100644 index 00000000..8f2c4cb2 --- /dev/null +++ b/doc/kword/doclinks.docbook @@ -0,0 +1,81 @@ + + + + +Mike +McBride + + + + +Document Links +document links + +&kword; has the ability to insert Internet addresses, email addresses, locations within the current document (bookmarks) and external file locations with a descriptor. This is most often used to +create web pages in &kword;. + +Once inserted into the document, the descriptor will be visible in &kword;, but when saved as a web document, the descriptor will become + the hyperlink for the location specified with the address. + +Insert a new document link +To insert a document link select +Insert +Link... + from the menubar. This will bring up a small dialog box. + + + + + + + + +Using the icon bar on the left, choose which link type you want to insert. +In the comment field, type the text you want to appear in your web document (for example: The KOffice Web Site). +In the address field, type the Internet address, email address or +file location you want the comment to be linked with (for example: http://www.koffice.org) +Click OK. +By default, &kword; displays links underlined (as in most browsers). You can turn this behavior on and off by +selecting SettingsConfigure +&kword;... from the menubar and selecting the Misc page. More information can be found +here. + +Opening a document link +You an use a document link from within &kword;. +Simply click once on the document link with the &RMB;. A popup menu will appear. Select Open Link. +A document link to a web site will open a new browser window and take you directly to that web site. A document link to an +email address, will open a new message in your email program. A document link to a file will open the appropriate viewer or editor for +that file type. + + +Copy a document link +You an use a document link in another application, by copying it from a &kword; document. +Simply click once on the document link with the &RMB;. A popup menu will appear. Select Copy Link. +The link address has now been inserted into the clipboard. You can paste your clipboard entry into any other application. + +Changing a document link +To change the details of a document link Simply click +once on the document link with the &RMB;. A popup menu will appear. Select Change Link.... +The Insert Link dialog box will appear, with the current settings of the link displayed. + + + + + + + +Make any appropriate changes and click OK to make your changes. + +Deleting a document link +You can delete a document link like any other text in your document. +Simply place the cursor at the end of the document link, and press &Backspace;. Alternatively, place +the cursor at the beginning of the document link and press Delete on the keyboard. The document link is deleted in its entirety. + +Converting a document link to text +If a document link is no longer needed as a link, but you want to preserve the text that is the link, click once on the document link with the &RMB;. A popup menu will appear. Select Remove Link.... The linked text will now become plain text, and the link will be deleted. + + + + + + diff --git a/doc/kword/docstruct.docbook b/doc/kword/docstruct.docbook new file mode 100644 index 00000000..cef30613 --- /dev/null +++ b/doc/kword/docstruct.docbook @@ -0,0 +1,148 @@ + + + + +Mike +McBride + + + + +<guilabel>Document Structure</guilabel> +document structure + +Sometimes, when editing a complicated document, it can be helpful to look at an organized view of your document. +You can use this organized view to jump immediately to certain text +frames, select picture frames, change frame properties, delete frames, + or simply review your document. + + +Show and hide <guilabel>Document Structure</guilabel> area +Because simple documents do not need the information provided in the Document Structure area, &kword; +has the ability to toggle the Document Structure area on and off. +To toggle the Document Structure area on and off, select +ViewShow Doc Structure + from the menubar to make the Document Structure area visible. Select +ViewHide Doc Structure + from the menubar to make the Document Structure area disappear. + +You can move focus to the document structure area by pressing +&Alt;1. You can move focus to the main document panel by pressing +&Alt;2. + + + + +Navigating the document structure area +Lets examine a sample Document Structure area. + + + + + + +As you can see, there are five groups of frames categorized (Text +Frames/Frame Sets +Pictures, Tables, Formula +Frames, +Embedded Objects). + + + +Text Frames/Frame Sets +Within this category, is a list of all text framesets. Below +each frameset, each frame is listed. Below each frame, each paragraph is +listed. + + + +Pictures +Within this category is a list of all frames that contain +pictures, and the folder the pictures were loaded from. + + + +Tables +Within this category is a list of all frames that contain +tables. Note that a table behaves very much like a frameset. +Each cell of the table is a frame, and each frame may contain +multiple paragraphs. + + + +Formula Frames +Within this category is a list of all frames that contain +formulas. + + + +Embedded Objects +Within this category, is an alphabetical list of all frames +that contain data from other &koffice; applications. + + +You can use your mouse to select the category you want, or first +put focus in the document structure area (press &Alt;1) +then use the up and down arrow keys to scroll through the list. +Double click on a category to expand or collapse the category, +or press the right or left arrow keys. + +Depending on your document, you may not have all categories in your +Document Structure area. The category only +appears when there is at least one frame in the +category. + + + + + +Edit a text frame, frameset, or paragraph using the document structure area +To edit a text frame, frameset, or paragraph, click on the +item with the &RMB; or scroll to the item and press the +Menu key. A popup menu will appear. Select Edit +Text from the menu. + + + +Speak the text of a text frame, frameset, or paragraph using the document structure area +If you have the KTTS component installed in your system, you can have the computer +speak the text of the document. To speak the text of a frame, frameset, or paragraph, click on the +item with the &RMB; or scroll to the item and press the +Menu key. A popup menu will appear. Select Speak +Text from the menu. + + +The Speak Text menu item will be disabled if KTTS +is not installed in your system. + +If KTTS fails to speak the text, or speaks the text in the wrong +language, make sure you have a Talker in +KTTS configured with the correct language. See The KTTS Handbook +for details. Also, make sure the Global Language is properly +set in the &kword; settings. + + + + +Jump to a frame, frameset, or paragraph using the document structure area +To display a frame, frameset, or paragraph in the main document panel, click on the +item with the &RMB; or scroll to the item and press the +Menu key. A popup menu will appear. Select Show + from the menu. + + +Delete frame or frameset using the document structure area +To delete a frame or frameset, click on the +frame title with the &RMB; or scroll to the frame title and press the +Menu key. A popup menu will appear. Select Delete +Frame from the menu. + + +Edit a frame or paragraph properties using the document structure area +To change the properties of a frame or paragraph, click on the +item with the &RMB; or scroll to the item and press the +Menu key. A popup menu will appear. Select +Properties from the menu. + + + diff --git a/doc/kword/docstruct.png b/doc/kword/docstruct.png new file mode 100644 index 00000000..10a52edf Binary files /dev/null and b/doc/kword/docstruct.png differ diff --git a/doc/kword/docvariables.docbook b/doc/kword/docvariables.docbook new file mode 100644 index 00000000..d8e8cc97 --- /dev/null +++ b/doc/kword/docvariables.docbook @@ -0,0 +1,486 @@ + + + + +Mike +McBride + + + + +Document Variables +variablesintroduction + +A variable is a simple way of allowing &kword; to modify the document in very +specific ways to reflect the changing nature of the document or report. +A variable can be a number (such as a page number, the total number of pages in a document, etc), +a selection of words (clients name, product name, the documents filename, etc), +a date, a time, or nearly anything you desire. +Once the variable is defined, a placeholder is inserted in the document. +&kword; will replace this placeholder with the value of that variable each time the placeholder is used. +Variables can either be fixed (which means that once inserted, their value does not +change), or variable (where the placeholder is +updated by &kword; to reflect +the current value of the variable). +This chapter will begin with a few examples of commonly used variables +(date, +time, and +page numbers), +then detail the +remaining variables + available to you. Finally, it will detail how to +create +custom variables for documents. + +Date and Time +Many letters, reports and documents contain +information about the dates or times they correspond to. The date and time +information may establish the creation of a document (which will remain +fixed as long as the document is around), or the date and time may serve as +a notice of the last date of modification (which would change with each passing day). +&kword; allows for both fixed and variable date and time variables in the document. +Insert Date +variablesinsert date +insert date + +To insert the date in the document, simply place the cursor in the text box where the date +should be inserted and select + +InsertVariableDate + from the menubar. This will bring up several selections. To insert the current date, select one of two +options: +Current date (fixed) and Current date (variable). + + + +Current date (fixed) +Selecting this option will insert the current date into the current cursor position. +This date is determined by checking with the computers system clock. Once entered, this value +will not change, even when &kword; is asked to update the document +variables. +This item is ideal for dates of document creation, or when including data in a report from todays work. +Compare this choice to Current date (variable). + + + +Current date (variable) +Selecting this option will insert the current date into the current cursor position. +This date is determined by checking with the computers system clock. This value will +change when &kword; is asked to update the document +variables. +This option is good for any point in the document where the current date is always wanted. +Compare this choice to Current date (fixed) + + + +Once the date has been selected, a dialog box will appear. + + + + + + +The top combo box determines the layout of the variable. Your choices are: + + + +Locale date format +This inserts the date in the format specified in the +&kde; Control Center. +To select this option, simply make sure the upper combo box says +Locale date format. A preview of the date format will appear above the +OK button. If satisfied click OK. + + + + +Preformatted date strings +&kword; comes with 19 predefined date strings. These predefined strings will +be all that are needed in most circumstances. Simply select the predefined string in the upper +combo box. A preview of the date format will appear above the +OK button. If satisfied click OK. + + + + +Custom String +If the appropriate format for the date cannot be found, it is possible to create custom +date format strings. +A date format string consists of a list of letters and numbers which follow +specific rules (which are outlined below) to create the completed date. +The date format string consists of placeholders and +separators. The placeholders are defined in the following three tables. +Days + + + +Day placeholdersdddddddddd +Example606ThuThursday + +Months + + + +Month placeholdersMMMMMMMMMM +Example303MarMarch + +Year + + + +Year placeholdersyyyyyy +Example022002 + +Simply combine placeholders with normal text (separators) to create completed date strings. + +For example: +MM/dd/yyyy is translated to 01/06/2004 +and +MMMM d, yyyy becomes January 6, 2004 +Notice that only the placeholders change. Spaces, commas, slashes and other text remains unchanged. +It is important to remember that placeholders are case sensitive. +DD is not a placeholder, + only dd. +To create a custom date string, place a mark in the Custom check box. +Now type placeholders and separators text into the upper combo box. Alternatively +select the format from the Insert: +combo box, and the +placeholder will be inserted into the date format string at the cursor location. + + + + + +There is a spinbox labeled Correct in Days. You can use this spin box to adjust the date up or +down one or more days from the current date. + +A preview of the current date +string is visible above the +OK button. Click OK when +the date format string is correct to insert the variable into the document. + +Once the date has been inserted into the document, it can be reformatted to a different layout +and toggled between fixed and variable dates. Simply click once with the &RMB; on the date. +A small menu will appear. Select Change Variable To and a submenu will appear. Select your new +variable or new layout from the menu and the variable is immediately updated. + + + There are three additional dates you can insert into your document: + + +Date of Last Printing +Selecting this option will insert the date this document was last printed into the current cursor position. + + + + +Date of File Creation +Selecting this option will insert the date this document created into the current cursor position. + + + + +Date of File Modification +Selecting this option will insert the date this document was last edited into the current cursor position. + + + + + + + + +Insert Time +variablesinsert time +insert time + +To insert the time in the document, simply place the cursor in the text box where the time should +be inserted and select + +InsertVariableTime + from the menubar. This will bring up two selections: +Current time (fixed) and Current time (variable). + + + +Current time (fixed) +Selecting this option will insert the current time into the current cursor position. +This time is determined by checking with the computers system clock. Once entered, this value +will not change, even when &kword; is asked to update the document +variables. +This item is ideal for timestamps. +Compare this choice to Current time (variable). + + + +Current time (variable) +Selecting this option will insert the current time into the current cursor position. +This time is determined by checking with the computers system clock. This value will +change when &kword; is asked to update the document +variables. +This option is good for any point in your document where the current time is always wanted. +Compare this choice to Current time (fixed) + + + +This brings up a dialog box. + + + + + + +The top combo box determines the layout of the variable. The choices are: + + + +Locale format +This inserts the time in the format specified in the +&kde; Control Center. +To select this option, simply make sure the upper combo box says +Locale format. A preview of the current time +string is visible above the OK button. If satisfied click OK. + + + + +Preformatted time strings +&kword; comes with 6 predefined time strings. These predefined strings will +be all that are needed in most circumstances. Simply select the predefined string in the upper +combo box. A preview of the current time +string is visible above the OK button. If satisfied click OK. + + + +Custom String +If the appropriate format cannot be found, a custom +time format string can be created. +A time format string consists of a list of letters and numbers which follow +specific rules (which are outlined below) to create the completed time. +The time format string consists of placeholders and +separators. The placeholders are defined in the following five tables. +Hours + + + +Hour placeholdershhh +Example606 + +Minutes + + + +Minutes placeholdersmmm +Example303 + +Seconds + + + +Seconds placeholderssss +Example202 + +Milliseconds + + + +Milliseconds placeholderszzz +Example022 + +Seconds + + + +AM/PM placeholdersapAP +ExampleamAM + + +Simply combine placeholders with normal text (separators) to create completed time strings. + +For example: +hh:mm:ss becomes 06:23:13 +and +h:mm ap becomes 6:23 am +Notice that only the placeholders change. Spaces, colons and other text remains unchanged. +It is important to remember that placeholders are case sensitive. +HH is not a placeholder, + only hh +To create a custom time string, place a mark in the Custom check box. +Type the placeholders and separator text into the upper combo box. Alternatively, +you can select the format from the Insert: +combo box, and the +placeholder will be inserted into the time format string at the cursor location. +A preview of the current time +string is visible below the Custom check box. Click OK when +the time format string is correct to insert the variable into your document. + + + + +A preview of the current time +string is visible below the Custom check box. Click OK when +the time format string is correct to insert the variable into your document. + +Once the time has been inserted into the document, it can be reformatted to a different layout +and toggled between fixed and variable times. Simply click once with the &RMB; on the time in the document. +A small menu will appear. Select Change Variable To and a submenu will appear. Select your new +variable or new layout from the menu and the variable is immediately updated. + + + + + +Page Numbering +variablesinsert page numbers +insert page numbers + +Inserting page numbers is easy in &kword;. +There are five variables that relate to page numbers: Page Number, +Number of Pages,Section TitleNext Page, +and Previous Page. +To insert the current page number, place the cursor where you want the page number and select + +InsertVariablePage +Page Number + from the menubar. The page number will be inserted at the current cursor location. +To insert the total number of pages, place the cursor where you want the variable and select + +InsertVariablePage +Number of Pages + from the menubar. The total number of pages will be inserted. +To insert the title of the section, place the cursor where you want the variable and select + +InsertVariablePage +Section Title + from the menubar. The section title will be inserted. +By selecting +InsertVariablePage +Next Page + from the menubar, a reference to the page number after the current page will be inserted at the current cursor location. +Likewise, by selecting +InsertVariablePage +Previous Page + from the menubar, a reference to the page number before the current page will be inserted at the current cursor location. + +Page numbers are updated dynamically as the document +is edited. +Page numbers are usually best located within +headers and footers. This ensures that +every page will have a page number at the appropriate place. + +Section Title +You can insert the section title anywhere in your document by selecting + +InsertVariablePage +Section Title + from the menubar. +&kword; determines the Section title by beginning a search from the top of the current page. The first paragraph with a style of +Head 1 is the section title. If there are no paragraphs on the current page, &kword; does the same search along +on previous pages until it finds a section title. + + +Other Variables +variablesmiscellaneous variables + +&kword; provides other commonly used variables that you might find useful. This set of variables +are specific to the document. You can insert these variables by selecting + +InsertVariableDocument Information + from the menubar. This will bring up a list of variables. The variables are detailed below. + + + +VariableExampleDetails + + +Author NameJoseph UserThe name of the author as specified in the Document information box. +CityPhiladelphiaThe city specified in the Document information box. +Company&kde;The company name specified in the Document information box. +CountryUnited StatesThe country name specified in the Document information box. +Directory Name/home/juser/kwordThis is the folder name for the document. The filename is not included in the folder name variable. +Directory & Filename/home/juser/kword/Resume.kwdThe folder and filename of the current file. +Document AbstractThis is a current resume. The document abstract specified in the Document information box. +Document KeywordsResume, job, application The document keywords specified in the Document information box. +Document SubjectMy resume. The document subject line specified in the Document information box. +Document TitleMy ResumeThe document title specified in the Document information box. +Emailjoeuser@kde.orgThe email address of the author as specified in the Document information box. +FaxAny valid telephone numberThe fax machine number specified in the Document information box. +File NameResume.kwdThe complete name of the file. +File Name without extensionResumeThe filename without the suffix (usually .kwd). +InitialsJCUThe initials specified in the authors section of the Document information box. +Postal codeAny valid postal codeThe postal code specified in the Document information box. +Street123 Main St.The street address specified in the Document information box. +Telephone (work)Any valid telephone numberThe telephone number specified in the Document information box. +Telephone (private)Any valid telephone numberThe telephone number specified in the Document information box. +TitleDirector of Information SystemsThe title specified in the authors section of the Document information box. + +Additionially, there are numerous variables under the Statistics submenu for inserting the number of words, lines, frames, etc. These variables should be self explanitory. +Uninitialized variables will appear as <none>, until you define their +value in the +Document information box. + +Custom Variables +variablescustom + +&kword; has many predefined variables. You may encounter documents where it would be nice +to define your own variables for a document. +Using Custom Variables, you can create an unlimited number of variables for each document. +Create a new custom variable +variablescreate custom variable + +To create a new custom variable, place the cursor at the location in the document to insert the new variable. +Select +InsertVariableCustom +New from the menubar. This will bring up a dialog box. +Enter the variable name and its current value in the text boxes provided. +Click OK to create the new variable name and insert it at the current +cursor location. Click Cancel to cancel the creation of the new variable. + +It is now possible to insert this new variable at any +place in your document. + +Edit a custom variables value +variablesedit custom variables + +In order for variables to be useful, you need to be able to give them a value, and be able to +change that value easily. To change the value of a variable: +Select +Tools +Custom Variables... from the menubar. +This will bring up a dialog box. +Each custom variable has a line in this table. The first column is the name of the variable, and +the second column is the value. +To change the value of a variables, simply click within the text box to the right of +the variable name. Enter the desired value. +When all the changes have been complete, simply click OK and all the +variables will be updated. + +Insert a custom variable +variablesinsert custom variable + +To insert a new custom variable select +InsertVariableCustom + from the menubar. The custom variable is listed in the submenu. Click on the name of +the variable and &kword; will insert the variable, with its current value, at the cursor location. + + +Updating All Variable Values +variablesupdating + +You can tell &kword; to update all variable values (to make sure all variables are set to their +current values). This is especially important with dates and times. +Simply select +InsertVariableRefresh All Variables + from the menubar. + +Updating One Date or Time Variable Value +You can tell &kword; to update a single date or time variable value, and leave the others unchanged. +Simply place the mouse pointer over the variable you want to update and click with the &RMB;. +Select Change Variable To. A small menu will appear which will show +several new date or time formatting options and the option to change either dates or times to fixed or variable time formats. Simply select +the new option and this variable will be updated. + + diff --git a/doc/kword/dtab.png b/doc/kword/dtab.png new file mode 100644 index 00000000..c8513bd2 Binary files /dev/null and b/doc/kword/dtab.png differ diff --git a/doc/kword/dtab2.png b/doc/kword/dtab2.png new file mode 100644 index 00000000..0c5d00d1 Binary files /dev/null and b/doc/kword/dtab2.png differ diff --git a/doc/kword/dtpfmtpg1.png b/doc/kword/dtpfmtpg1.png new file mode 100644 index 00000000..63518acd Binary files /dev/null and b/doc/kword/dtpfmtpg1.png differ diff --git a/doc/kword/editcopy.png b/doc/kword/editcopy.png new file mode 100644 index 00000000..1e6c38ad Binary files /dev/null and b/doc/kword/editcopy.png differ diff --git a/doc/kword/editcut.png b/doc/kword/editcut.png new file mode 100644 index 00000000..84ba0e15 Binary files /dev/null and b/doc/kword/editcut.png differ diff --git a/doc/kword/editing.docbook b/doc/kword/editing.docbook new file mode 100644 index 00000000..733da667 --- /dev/null +++ b/doc/kword/editing.docbook @@ -0,0 +1,1903 @@ + + + + +Mike +McBride + + + + +Detailed Guides: Editing your Document + +This section of the guide will cover more advanced features of +data editing. This section focuses entirely on text data. For working +with other types of data, please see the section entitled More than just text. + + +Selecting Text +selecting text +For many editing and formatting functions in &kword;, certain actions (bold face, underline,&etc;) should be +applied to a +certain section of text, not the document as a whole. You specify which +text should be altered by selecting (or highlighting) the text you want changed. + +Selected text has a colored background to separate it from +unselected text. + + + + + + + + +Select text by designating a start and an end +point. All the text in between the start and end point is selected +text. + +Text can be selected with either the mouse or the keyboard. + + +Using The Mouse + +To select text with the mouse, place the mouse pointer at the start point. Click and hold down the +&LMB; and drag the mouse pointer. This +selects all text between the initial click of &LMB; and the +current position of the mouse cursor. When the mouse pointer is at the desired end point, release the button. +The start and endpoints will become fixed. + + + + +Using The Keyboard +To use the keyboard, &kword; takes the initial position of the text cursor as the start point. +Use the following key combinations to move the endpoint to the desired location. + + +Key CombinationFunction + +&Shift;Left ArrowMoves the endpoint one character to the left. +&Ctrl;&Shift;Left ArrowMoves the endpoint one word to the left. +&Shift;Right ArrowMoves the endpoint one character to the Right. +&Ctrl;&Shift;Right ArrowMoves the endpoint one word to the Right. + +&Shift;Up ArrowSelects all characters from the start of the selection, to the character directly up one line. +&Ctrl;&Shift;Up ArrowSelects all characters from the start of the selection, to the first character of the line directly above. + +&Shift;Down ArrowSelects all characters from the start of the selection, to the character directly down one line. +&Ctrl;&Shift;Down ArrowSelects all characters from the start of the selection, to the last character of the line directly below. + +&Shift;HomeSelects all characters from the start of the selection, to the beginning of the line. +&Ctrl;&Shift;HomeSelects all characters from the start of the selection, to the beginning of the document. + +&Shift;EndSelects all characters from the start of the selection, to the end of the line. +&Ctrl;&Shift;EndSelects all characters from the start of the selection, to the end of the document. + +&Shift;Page-UpMoves the current endpoint one screen up. +&Ctrl;&Shift;Page-UpMoves the current endpoint one page up. The endpoint is located at the first character of this page. + + +&Shift;Page-DownMoves the current endpoint down one screen. + +&Ctrl;&Shift;Page-DownMoves the current endpoint down one page. The endpoint is locate at the first character of this page. +&Ctrl;ASelect all text in the current frameset. + + +Once the start and endpoints have been defined, all text between the startpoint and endpoint is selected. + + + + + + +Using Multiple Views +viewsusing multiple + +Introduction +When editing very large documents, there will be times when it is helpful to +edit two parts of the document. In a situation such as this, +&kword; can open additional windows to edit the same document. +These new windows are called Views, since they provide +a different viewpoint of the the same document. +Views are very important tools when working with large documents. +Set one view to edit one part of the document, and using the other view, freely +move through the document making updates and changes. These changes are automatically revealed in all views. + + + + +Creating a new view +viewscreate new view +Creating a new view creates an entirely new window, with toolbars, menubars etc. +Compare this with the Split View command. + +To create a new view select ViewNew View + from the menubar. + +A new window will be created. Alterations to your document can be made in either view. +Updates in one window will be immediately visible in the other. + + + + +Splitting the current view into two separate views. +viewssplit current view +It is also possible to split one view into two views. Both views are contained within one window, and +use the same toolbars, menubars, etc. Contrast this to the effect of the New View command. + +To split the current view, select +ViewSplit View from the menubar. + +The current document area will be split into two views. Alterations to your document can be made in either view. +Updates in one view will be immediately visible in the other. + +The views can either be split horizontally or vertically. See the next section for instructions. + + + + +Changing the split view orientation +viewschange split view orientation +To change the direction that the views are split, simply select +ViewSplitter Orientation from the menubar. +This will show a submenu. Select either Horizontal or Vertical. + +All views in the current window will immediately change to the new orientation. + + + + +Changing the size of views +viewsresizing +The relative sizes of each view can be adjusted with your mouse. +To adjust the view size, look at the border between the scrollbar of one view +(the upper or right view) and the ruler of the other view (the lower or left view). There is a +solid border which appears raised between the scrollbar and the ruler. As the mouse pointer passes +over this bar, it changes from an arrow to double lines with double arrows. + + +Screen shot + +When the mouse pointer changes, click once with the &LMB; and hold the button +down. Drag that border to the new location. When the mouse button is released, the +views will change to the new proportions. + + + + + +Remove View +viewsremoving +To remove a view, simply place the mouse pointer in the view to be deleted and click with the &LMB;. +Then select ViewRemove View +from the menubar. + + + + +Close all views To close all views, select +viewsclosing all views +ViewClose All Views +from the menubar. + + + + +Undo/Redo +undoing last edit +redoing previously undone edit +It happens all the time. While working on a document, a change is made. +The change was wrong, now you want to back out of your changes. + +Fortunately, &kword; has a solution. + +Each time a change is made to a document, &kword; remembers what +the change was. &kword; can +Undo each change once a time. + +As an example, you are writing a business letter and type in the following sentence: + +It is a pleasure for me to give you this letter of introduction to your newest employee. + +But that doesn't seem right, so you change it: + +It is a joy for me to give you this letter of introduction to your newest employee. + +You decide it was better the first time and you want to change it back. + +Simply select +EditUndo from +the menubar. + +The text now reads pleasure again. + +It is a pleasure for me to give you this letter of introduction to your newest employee. + +If, after you Undo a change, and then want to reverse that decision, +select +EditRedo and +the Undo is reversed. + + +Sometimes it is not possible for &kword; to undo an edit. In these instances, &kword; +will display the Undo function gray and the function is not +accessible. + +Othertimes, &kword; will only perform a partial undo of the previous task. +This is because &kword; processes changes to documents differently then might +initially be expected. Simply select +EditUndo +again, and more of the edits will be undone. + +By default, &kword; keeps track of the last 30 edits to the document. +This number can be adjusted up or down. For details, see Configuring &kword;. +The Undo and Redo commands can +be accessed from the menubar (as in the examples above), by using keyboard shortcuts or from the toolbar. + + + +CommandToolbar ButtonKeyboard Shortcut + +Undo +&Ctrl;Z +Redo +&Ctrl;&Shift;Z + + + + + + + +Cut/Copy/Paste and the Clipboard +clipboardusing + +The clipboard is a concept familiar to most people +who have used modern word processors. It is a piece of your computers +memory which is set aside as a temporary storage space. Text can be +Cut or Copied from your document into +the clipboard. You can move to another part of the document or to +another application entirely, and Paste this text at the new +location. + +The most common use for the clipboard is to move or copy text +which has already entered into one part of the document to another +part of the same document or to another document entirely. + +This concept is probably best described with an example. + +To do this, we begin with a test sentence + +The big, red fox jumped over the lazy dog. + +Using the mouse or keyboard, select the phrase + big, red (notice the space before big is selected). + +Now select +EditCopy from +the menubar. + +This has moved a copy of the selected text to the +clipboard. + +Now place the mouse cursor directly behind the word +lazy and click once. + +Now select +EditPaste +from the menubar. + +The resulting sentence is: + +The big, red fox jumped over the lazy big, red dog + +The clipboard is not limited to text. +The clipboard can contain tables, pictures, spreadsheets or any other type of information. + + +The <guimenuitem>Copy</guimenuitem> Command +clipboardcopying text to +The Copy command can be invoked 4 ways: + + + +By selecting +EditCopy from +the menubar + + + +By clicking +on the toolbar. + + + +Using the keyboard shortcut: &Ctrl;C or the alternate keyboard shortcut: +&Ctrl;Insert + + + +After the text is selected, click once with the &RMB; and hold the button down. +A small popup menu will appear. Simply select Copy + + + + +The Copy command moves a copy of the selected data +to the clipboard. The original data is +unaffected. + + + + +The <guimenuitem>Cut</guimenuitem> Command +clipboardmoving text to +The Cut command can be invoked 4 ways: + + + +By selecting +EditCut from +the menubar + + + +By clicking +on the toolbar. + + + +Using the keyboard shortcut: &Ctrl;X or the alternate keyboard shortcut: +&Shift;Delete + + +After the text is selected, click once with the &RMB; and hold the button down. +A small popup menu will appear. Simply select Cut + + +The Cut command moves a copy of the selected data +to the clipboard. The selected data is then deleted from the +document. + + + + +The <guimenuitem>Paste</guimenuitem> Command +clipboardmoving text from +The Paste command can be invoked 4 ways: + + + +By selecting +EditPaste +from the menubar + + + +By clicking +on the toolbar. + + + +Using the keyboard shortcut: &Ctrl;V or the alternate keyboard shortcut: +&Shift;Insert + + + +Place the cursor where the contents of the clipboard +should be inserted. Click once with the &RMB; and hold the button down. A small +popup menu will appear. Simply select Paste + + + + +The Paste command inserts a copy of all the data in +the clipboard at the current position of the cursor. The clipboard is +unaffected. (So another paste command will produce yet another copy of +the data in the document.) + + +If no text in the document is currently highlighted, the +Paste command inserts +the data at the current position of the cursor. + +If there is selected text when the +Paste command is executed, the selected text +is replaced with the contents of the +clipboard. + + +The clipboard is not limited to the bounds of the current document. If +text is copied (or cut) from a document, this text can be pasted +into another open document, or another application entirely. + + + + + +Finding and Replacing Text + + +The <guimenuitem>Find</guimenuitem> Command +searching for text +finding text in a document + +The Find command can be invoked 3 ways: + + + +By selecting +EditFind... +from the menubar + + + +You can use the keyboard shortcut:&Ctrl;F + + + +By clicking on +the toolbar. + + + +When the Find Command is invoked, a dialog appears. + + + + + + + + +Basic Text Search +The combo box labelled Text to find, +provides a place for you to enter the text of your search command. (In +the screenshot, that box is currently filled with +KDE). + +If you click on +Find, then &kword; will search the document until it +finds a match to your text. If &kword; cannot find a match, a dialog +box will appear that says No matches found for "Text to find". +If you want to repeat a recent search, simply select the arrow in the drop-down +box and a list of your most recent searches will appear. Simply select your search +from the list and click Find. + + + +Refining Your Search + +&kword;'s find feature is much more sophisticated than we +discussed above. Using the options in the dialog box, you can narrow +down your search to find exactly what you +want. + + +Regular Expressions in &kword; + +The default action for &kword; is to search for an exact match of +the text. &kword; has the ability to match text +that follows a pattern or a set of rules. + +To enable patterns, place a mark in the box labeled Regular expression. + +This will enable the Edit button. +This button can be a quick way to create regular expressions for people unfamiliar +with &UNIX; regular expressions. + +A more thourough discussion of regular expressions in KDE can be found in the help manual for &kregexpeditor;, which can be found in the &khelpcenter;. + + + +Formatting options +&kword; also has the ability to search your document for text that matches +certain formatting options as well as the text itself. + +To include formatting options in your search, click the button labeled +Show Formatting Options. + +Once Show Formatting Options has been clicked, a new dialog will appear. + + + + + + + + +You can use this dialog to select the options you want to include in your search. +The left column consists of 13 check boxes. If there is a mark in the check box, then &kword; will evaluate +any searchable text for that property. If no mark is in the check box, &kword; does not consider that property when performing a search. + + + + +Family: + +Use this combo box to select the font family you want to include in your search text. + + + + +Size: + +Use this spin box to set the font size you want &kword; to search for. + + + + +Color: and Background color: + +Clicking on either of these two buttons allows you to select the font color and/or background color respectively, +you want &kword; to search +for. For more information on selecting a color, see the +section on Selecting Colors from the Color Dialog. + + + + +Bold: and Italic: + +Use these Yes/No radio boxes to determine whether you want &kword; +to include boldface or italicized fonts in the search text. + + + + +Strikeout: + +You can select None, Single, Double +or Simple Bold to modify your search. + + + + +Underline: + +You can select None, Single, Double, Simple Bold +or Wave to modify your search. + + + + +Vertical alignment: + +You can select Normal, Subscript or +Superscript to determine what font alignment you want &kword; to search for. + + + + +Shadow: and Word by word: + +Use these Yes/No radio boxes to determine whether you want &kword; +to include shadow text in the search text and whether to search for word by word underlining and strikethrough text. + + + + +Capitalization: + +You can select Normal, Uppercase, Lowercase, or +Small Caps to determine what capitalization you want &kword; to search for. + + + + +Language: + +You can select the language of the text you want &kword; to search for using this dropdown box. + + + +Once you have selected your options, click OK to accept your search options. +Click Cancel to ignore all changes. +Click Reset to restore the options dialog box to the default values. +Click Clear to remove all marks from the checked options. + + + + +Other Search options + +In addition to pattern matching, you can limit the search results +with a few useful options. + + + +Case sensitive + +When this option is selected, &kword; will not only search for the +string of letters, but will verify that the case of the letters is the +same. For example. Searching for: +KDEwill match: +KDE and +hiddenKDEinwords but not: Kde, +kde or hiddenkdeinwords. + + + + +Find backwards + +This option changes the direction of the search. This can be +useful when you only want to search for a string of text before the +current cursor position, not after. This option is usually used in +conjunction with From cursor, but if that option is +not specified, &kword; will start searching from the end of the document +backwards. + + + + +Whole words only + +When this option is selected, &kword; will only return search +items that are surrounded by spaces, paragraph marks or punctuation. For +example. Searching for: KDEwill +match: KDE but not: +hiddenKDEinwords or KDElike. + + + + +Selected Text +If you want to limit your search to a specific part of +the document (a few paragraphs, for example), you can select the part of +the document you want to search prior to selecting +the Find command. When text is selected, &kword; +will default to only searching the selected text. You can use this +option to enable or disable this restriction. + +This option will not be available if you have not selected text +prior to selecting the Find command. + + + + + +From cursor + +By default, &kword; begins searching at the beginning of the +document. If this option is selected, &kword; begins its search from +the current position of the cursor. The direction that &kword; searches +is, by default forward in the document, but can be changed with the +Find backwards option. + + + + + + + + +The <guimenuitem>Replace</guimenuitem> Command + +The Replace command is an extension of the Find command. If you +are familiar with the Find command, you will see many +similarities. + +The Replace command can be invoked 2 +ways: + + + +By selecting +EditReplace... +from the menubar + + + +You can use the keyboard shortcut: &Ctrl;R + + + +When the Replace command is invoked, a dialog +appears. + + + + + + + +Basic Search and Replace +replacing text + +The combo box labeled Text to find:, +provides a place for you to enter the text of your search command. (In +the screenshot, that box is currently filled with +KDE) + +You can enter your replacement text in the text box labeled +Replacement text:. You can now click +OK to replace all occurrences in the document, or +you can further refine your search. + + + + +Refining Your Search + +&kword;'s find feature is much more sophisticated than we +discussed above. Using the options in the dialog box, you can narrow +down your search to find exactly what you +want. + + +Regular Expressions in &kword; + +The default action for &kword; is to search for an exact match of +the text. &kword; has the ability to match text +that follows a pattern or a set of rules. + +To enable patterns, place a mark in the box labeled Regular expression. + +This will enable the Edit button. +This button can be a quick way to create regular expressions for people unfamiliar +with &UNIX; regular expressions. + +A more thourough discussion of regular expressions in KDE can be found in the help manual for &kregexpeditor;, which can be found in the &khelpcenter;. + + + +Formatting options +&kword; also has the ability to search your document for text that matches +certain formatting options as well as the text itself. + +To include formatting options in your search, click the button labeled +Show Formatting Options. + +Once Show Formatting Options has been clicked, a new dialog will appear. + + + + + + + + +You can use this dialog to select the options you want to include in your search. +The left column consists of 13 check boxes. If there is a mark in the check box, then &kword; will evaluate +any searchable text for that property. If no mark is in the check box, &kword; does not consider that property when performing a search. + + + + +Family: + +Use this combo box to select the font family you want to include in your search text. + + + + +Size: + +Use this spin box to set the font size you want &kword; to search for. + + + + +Color: and Background color: + +Clicking on either of these two buttons allows you to select the font color and/or background color respectively, +you want &kword; to search +for. For more information on selecting a color, see the +section on Selecting Colors from the Color Dialog. + + + + +Bold: and Italic: + +Use these Yes/No radio boxes to determine whether you want &kword; +to include boldface or italicized fonts in the search text. + + + + +Strikeout: + +You can select None, Single, Double +or Simple Bold to modify your search. + + + + +Underline: + +You can select None, Single, Double, +Simple Bold or Wave to modify your search. + + + + +Vertical alignment: + +You can select Normal, Subscript or +Superscript to determine what font alignment you want &kword; to search for. + + + + +Shadow: and Word by word: + +Use these Yes/No radio boxes to determine whether you want &kword; +to include shadow text in the search text and whether to search for word by word underlining and strikethrough text. + + + + +Capitalization: + +You can select Normal, Uppercase, Lowercase, or +Small Caps to determine what capitalization you want &kword; to search for. + + + + +Language: + +You can select the language of the text you want &kword; to search for using this dropdown box. + + + +Once you have selected your options, click OK to accept your search options. +Click Cancel to ignore all changes. +Click Reset to restore the options dialog box to the default values. +Click Clear to remove all marks from the checked options. + + + + +Other Search options + +In addition to pattern matching, you can limit the search results +with a few useful options. + + + +Case sensitive + +When this option is selected, &kword; will not only search for the +string of letters, but will verify that the case of the letters is the +same. For example. Searching for: +KDEwill match: +KDE and +hiddenKDEinwords but not: Kde, +kde or hiddenkdeinwords. + + + + +Find backwards + +This option changes the direction of the search. This can be +useful when you only want to search for a string of text before the +current cursor position, not after. This option is usually used in +conjunction with From cursor, but if that option is +not specified, &kword; will start searching from the end of the document +backwards. + + + + +Whole words only + +When this option is selected, &kword; will only return search +items that are surrounded by spaces, paragraph marks or punctuation. For +example. Searching for: KDEwill +match: KDE but not: +hiddenKDEinwords or KDElike. + + + + +Selected Text +If you want to limit your search to a specific part of +the document (a few paragraphs, for example), you can select the part of +the document you want to search prior to selecting +the Find command. When text is selected, &kword; +will default to only searching the selected text. You can use this +option to enable or disable this restriction. + +This option will not be available if you have not selected text +prior to selecting the Find command. + + + + + +From cursor + +By default, &kword; begins searching at the beginning of the +document. If this option is selected, &kword; begins its search from +the current position of the cursor. The direction that &kword; searches +is, by default forward in the document, but can be changed with the +Find backwards option. + + + + +Once you have selected your options, click OK to accept your search options. +Click Cancel to ignore all changes. +Click Reset to restore the options dialog box to the default values. +Click Clear to remove all marks from the checked options. + + + +Replace with formatted text +&kword; also has the ability to replace the found text with formatted text. + +To include formatting options in your search, click the button labeled +Show Formatting Options in the Replace With section. + +Once Show Formatting Options has been clicked, a new dialog will appear. + + + + + + + + +You can use this dialog to select the format of the replaced text. +The left column consists of 13 check boxes. If there is a mark in the check box, then &kword; will change +any replaced text to match the property selected. +If no mark is in the check box, &kword; does not consider that property when replacing text. + + + + +Family: + +Use this combo box to select the font family you want your replacement text to use. + + + + +Size: + +Use this spin box to set the font size you want &kword; to use for your replaced text. + + + + +Color: and Background color: + +Clicking on either of these two buttons allows you to select the font color and/or background color respectively, +you want &kword; to use. For more information on selecting a color, see the +section on Selecting Colors from the Color Dialog. + + + + +Bold: and Italic: + +Use these Yes/No radio boxes to determine whether you want &kword; +to change the fonts to boldface or italicized fonts. + + + + +Strikeout: + +You can select None, Single, Double +or Simple Bold to use for the replacement text. + + + + +Underline: + +You can select None, Single, Double, +Simple Bold or Wave to use for the replacement text. + + + + +Vertical alignment: + +You can select Normal, Subscript or +Superscript to determine what font alignment you want &kword; to use. + + + +Shadow: and Word by word: + +Use these Yes/No radio boxes to determine whether you want &kword; +to use shadow text and/or word by word underlining and strikethrough in the replacement text. + + + + +Capitalization: + +You can select Normal, Uppercase, Lowercase, or +Small Caps to determine what capitalization to use for the replacement text. + + + + +Language: + +You can select the language of the text you will use to replace the found text. + + + + +Once you have selected your options, click OK to accept your text options. +Click Cancel to ignore all changes. +Click Reset to restore the options dialog box to the initial values prior to making any changes. +Click Clear to remove all marks from the checked options. + + + +Using placeholders +Placeholders are useful when you want to add text to complex search strings. Currently &kword; has only one placeholder: +Complete text string. +This placeholder will contain the entire text string matched by the Find command. +For example: +You create a search string, using regular expressions: Reference \d +In order for this string example to work, a mark must be placed in the check box labeled +Regular expression +Regular expressions are available by placing a mark in this checkbox. The use of regular expressions is beyond the +scope of this manual. For more information see the KDE Regular Expression Manual (Available in the &kde; help center). +Now in the Replace With section of the replace dialog, you place a mark in the check box labeled +Use placeholders. Click the Insert Placeholder button and select +Complete Match. &kword; will insert a \0 in the +Replacement text: text box. +Now surround the placeholder with parentheses, so your text string is: (\0) +When this is executed, whenever &kword; encounters the find text (ie. Reference 0, Reference 1, +Reference 2, etc) it will surround the text in parenthesis ((Reference 0), (Reference 1), +(Reference 2), respectively). +As you can see, the placeholder will maintain a copy of the search text. You can use this placeholder to add text to the ends of any +search string you can imagine. + + + +Other Replace Options + +Additional options in the dialog are: + + +Case sensitive + +When this option is selected, &kword; will not only +search for the string of letters, but will verify that the case of the +letters is the same. For example. Searching for: +KDEwill match: +KDE and hiddenKDEinwords but +not: Kde, kde or +hiddenkdeinwords. + + + + +Find backwards + +This option changes the direction of the search. This can be +useful when you only want to search for a string of text before the +current cursor position, not after. This option is usually used in +conjunction with From cursor, but if that option is +not specified, &kword; will start searching from the end of the document +backwards. + + + + +Whole words only + +When this option is selected, &kword; will only return search +items that are surrounded by spaces, paragraph marks or punctuation. For +example. Searching for: KDEwill +match: KDE but not: +hiddenKDEinwords or KDElike. + + + + +Selected Text +If you want to limit your search to a specific part of +the document (a few paragraphs, for example), you can select the part of +the document you want to search prior to selecting +the Find command. When text is selected, &kword; +will default to only searching the selected text. You can use this +option to enable or disable this restriction. + + +This option will not be available if you have not selected text +prior to selecting the Find command. + + + + + +From cursor + +By default, &kword; begins searching at the beginning of the +document. If this option is selected, &kword; begins its search from +the current position of the cursor. The direction that &kword; searches +is, by default forward in the document, but can be changed with the +Find backwards option. + + + + +Prompt on replace + +If this option is selected, &kword; will prompt the user +before each replacement. This allows you to +approve or disapprove each replacement. + + + + + + + + + + + + + +Spellchecking +spellingcheck spelling of document +&kword; can compare each word in your document to several commonly available dictionaries. It will offer you +the opportunity to change any words it believes are misspelled. +By default, if any text in the document is selected, +&kword; only checks the spelling of currently selected text. +If you want to check the spelling of a +specific part of your document, simply select the text you want to check the +spelling of. +To check the entire document, leave all text in the document unsellected, and &kword; will check +the entire document. +You can check the spelling of text 2 ways: + + + +By selecting +ToolsSpellcheckSpelling... +from the menubar + + + +By clicking on +the toolbar. + + + +Spellchecking your document is controlled through a dialog +box. + + + + + + + + +In this example, the misspelled word &kword; found, was +youve. The currently suggested replacement word is listed in the text box labeled +Replace with:. In the list box labeled Suggested Words is a list of words +the spelling program has determined as possible correct spellings. + +From here you have eight options: + + + +Replace + +Replaces the current word with the suggested word. Only replaces this +occurrence. + + + + +Replace All + +Replaces all occurrences of the current word with the +suggested word through the entire document. + + + + +Ignore + +Do not make any changes to this occurrence. Ask again if this +word appears further down in the document. + + + + +Ignore All + +Do not make any changes to this or any other occurrence of this word. Do not +ask about this word again. + + + + +Add + +Add the current word to the dictionary. + + + + +Stop + +Keep the current changes, but stop any further checking. + + + + +Cancel + +Stop spellchecking. + + + + +Help + +Loads a help file for the spellchecker. + + + + +When the entire document has been checked, &kword; will return the cursor to the same spot +in the document that the spellchecking was begun. + + +If the document does not have any spelling errors, &kword; does +not show a dialog box informing you there were no spelling errors. + +When spellchecking is started, it +will proceed to check all of the document against the dictionary, and +if there are no spelling errors it will close the spellcheck dialog box. With short documents, +this may happen quickly. &kword; has spellchecked the document! + + +There are several options for configuring the spelling application used. +For more details, please see the section entitled +Configure Spelling. + + +Automatically mark misspelled words +spellingautomatically mark misspelled words + +&kword; can check the spelling of your document as you edit it. It will underline in red any word which +it cannot find in the dictionary. This behavior can be turned on and off by the user. By selecting +ToolsSpellcheckAutospellcheck +from the menubar you can toggle autospellchecking on and off. + + + + + +Finding related word (Thesaurus) +thesaurus, using +Wordnet +related words + +&kword; comes with a small thesaurus based on the Wordnet project. For more information on Wordnet, visit the +Wordnet homepage. +You can invoke the thesaurus two ways: + + +Simply click on the desired word with the &RMB;. A popup menu will appear. Select +Show Related Words from the menu and a dialog will appear. +By selecting +ToolsShow Related Words +from the menubar + + +Which ever method you choose, &kword; opens the &kthesaurus; dialog box. + + + + + +The word you selected from your document appears in the combo box labeled Search for:. +There are three columns of alternate words: Synonyms, More General words (hypernyms), More Specific Words (hyponyms). +If you find an appropriate alternate word, simply click on the word in the list, and this word will now be listed in the text box labeled +Replace With:. +To finalize the replacement click Replace. +To keep your original word, click Cancel. +To obtain more specific help, or for help on using the full version of Wordnet, click the Help button for help with +&kthesaurus; (including additional thesauri for non-english languages). + + + + +Autocorrection +autocorrectionusing + +Auto correction is a system for correcting common typing errors, +converting abbreviations to their full spelling and adjusting +capitalization. As you could guess from its name, this all occurs +automatically, while you are editing your document. + + +Enabling/Disabling Autocorrection + +To toggle autocorrection on, select +ToolsAutocorrection +Enable Autocorrection +from the menubar. When enabled, autocorrection makes changes to your document as you type. You can +determine which changes to make by configuring autocorrection. + +To toggle autocorrection off, select +ToolsAutocorrection +Disable Autocorrection +from the menubar. When disabled, autocorrection changes are not made. You can, however, +apply autocorrection manually. + + + +Configuring Autocorrection Options +autocorrectionconfiguring + +To adjust the options for autocorrection, select +SettingsConfigure Autocorrection... +from the menubar. + +A dialog window appears to help you set your options. + + +Simple Autocorrection + + + + + + + + + + + +Convert first letter of a +sentence automatically to uppercase + +When selected, &kword; will automatically capitalize the first +letter after a period. You can tell &kword; when not to alter capitalization +in certain instances (ie Sr. or Jr.. For more details, see the section entitled +Autocorrection Exceptions. + + + + +Convert two uppercase letters to one uppercase and one +lowercase letter + +When selected, &kword; will automatically convert a double capital +letter (a common typographical error), into a single capital +letter. You can tell &kword; when not to alter capitalization +in certain instances. For more details, see the section entitled +Autocorrection Exceptions. + + + + +Autoformat URLs + +When selected, &kword; will scan text for patterns which suggest a certain section +of text is a URL and automatically creates a link. +For more details on links, see the section entitled +Document Links. + + + + +Suppress double spaces + +When checked, &kword; will ignore the second space typed. +This prevents users from adding double spaces between words or sentences + + + + +Remove spaces at the beginning and end of paragraphs + +When selected, &kword; will automatically remove spaces at the beginning and/or the end of a line of text. + + + + +Automatically do bold and underline formatting + +When selected, &kword; will look for words surrounded by asterisks ( * ). It will remove the asterisks and change the font of all +words in between the two asterisks to bold face. +&kword; will also look for words surrounded by underscores ( _ ). It will remove the underscores and underline all +words in between the two underscores. + + + + +Replace 1/2... with ½... + +When selected, &kword; will automatically change 1/2, 1/3 and 3/4 to their single character equivalents. + + + + +Use autonumbering for numbered paragraphs + +If you start a paragraph with a number and a symbol ( 1) for example). &kword; will automatically +convert that paragraph to a numbered paragraph. All future paragraphs will be consecutively numbered. + + + + +Replace 1st with 1^st + +When selected, &kword; will automatically change 1st to 1st. + + + + +Capitalize name of days + +Automatically capitalize the days of the week (Sunday, Monday, Tuesday, etc...). + + + + +Use list-formatting for bulleted paragraphs + +When selected, &kword; will look for lines that begin with - , and automatically convert the paragraph style +to a bulleted list. The bullet is selected with the left button below this option. + + + + + + + +Custom Quotes +Select the tab labeled Custom Quotes + + + + + + + + + +Replace double quotes with typographical quotes + +When selected, this option will replace the standard keyboard double +quotes, with typographical quotation marks. If you want to change the +quotation character, click on one of the buttons. Clicking on +Default, restores the default paragraph marks. + + + + +Replace single quotes with typographical quotes + +When selected, this option will replace the standard keyboard single +quotes, with typographical quotation marks. If you want to change the +quotation character, click on one of the buttons. Clicking on +Default, restores the default paragraph marks. + + + + + +Advanced Autocorrection + +To switch to the Advanced Autocorrection, click on the tab labeled +Advanced Autocorrection. + + + + + +This allows you to automatically have &kword; replace one string +of text with another. This can be useful for special symbols, commonly +used abbreviations that you want spelled out, or abbreviations. + +&kword; uses different autocorrection strings depending on the language. +Set the correct language using the combo box labeled +Replacements and exceptions for language:. + +The check box labeled Enable word replacement is used to +toggle on and off the autoreplacement features of &kword;. If there is no mark in the check box, +then &kword; will not perform any autoreplacements from the list in this dialog. + +If there is a mark in the check box labeled Replace text with format +&kword; will not only change the text when it finds a match, but it will change the formatting of the new text. +If there is no mark in this check box, then +&kword; uses the same formatting options for the replaced text as it found in the search text. For more information +on setting the format options for replacement text, see the section on +Changing the format of the autocorrection string. + + +Adding an autocorrection string + +To add an autocorrection string, simply type the text you want &kword; to +check for in the text box labeled +Find, then enter the text you want &kword; +to substitute in the text box labeled Replace. + + +If you want to insert symbols or special characters not available on your +keyboard, you can click the +buttons with three periods on them and select a special character from the table provided. + +When these are entered, click Add. Your text +strings are now added to the table. + + + +Editing an autocorrection string +Changing the text you want to find. +&kword; does not allow you to change the text to search for. +This is to prevent disastrous mistakes. +Instead, you must delete the current autocorrection rule and +add a new text string with the corrected text to find. + +Changing the text you want to replace. +Begin by clicking once on the string you want to edit. It will be +highlighted and the find and replace text will be listed in the text boxes +above. You can alter the replacement text. When you +are done, simply select Modify. + + + + +Deleting an autocorrection string. + +Simply click on the string you want to delete. Now click the +Remove button. The string is removed. + + +Be aware that &kword; does not give you a chance to back out once +you have deleted a string. Be sure you have selected the correct string +before you click the Remove +button. + + + + +Changing the format of the autocorrection string. +Currently, you must create the autocorrection string before you can format it. +Once the autocorrection string has been created, simply click on it once with the &LMB;. +Now click on the Change Format... button. A small dialog will appear: + + + + + + + +You can use this dialog to select the format of the replaced text. +The left column consists of 13 check boxes. If there is a mark in the check box, then &kword; will change +any replaced text to match the property selected. +If no mark is in the check box, &kword; does not consider that property when replacing text. + + + + +Family: + +Use this combo box to select the font family you want your replacement text to use. + + + + +Size: + +Use this spin box to set the font size you want &kword; to use for your replaced text. + + + + +Color: and Background Color: + +Clicking on either of these two buttons allows you to select the font color and/or background color respectively, +you want &kword; to use. For more information on selecting a color, see the +section on Selecting Colors from the Color Dialog. + + + + +Bold: and Italic: + +Use these Yes/No radio boxes to determine whether you want &kword; +to change the fonts to boldface or italicized fonts. + + + + +Strikeout: + +You can select None, Single, Double +or Simple Bold to use for the replacement text. + + + + +Underline + +You can select None, Single, Double, +Simple Bold or Wave to use for the replacement text. + + + + +Vertical alignment: + +You can select Normal, Subscript or +Superscript to determine what font alignment you want &kword; to use. + + + +Shadow: and Word by word: + +Use these Yes/No radio boxes to determine whether you want &kword; +to use shadow text and/or word by word underlining and strikethrough in the replacement text. + + + + +Capitalization: + +You can select Normal, Uppercase, Lowercase, or +Small Caps to determine what capitalization to use for the replacement text. + + + + +Language: + +You can select the language of the text you will use to replace the found text. + + + + +Once you have selected your options, click OK to accept your text options. +Click Cancel to ignore all changes. +Click Reset to restore the options dialog box to the initial values prior to making any changes. +Click Clear to remove all marks from the checked options. + + + + +Autocorrection Exceptions +autocorrection +exceptions + +There are instances where &kword; will make autocorrection changes +that are inappropriate. You can use the fourth tab of this dialog to define +exceptions to the rules previously discussed. +The dialog for exceptions is shown below: + + + + + +To prevent &kword; from deciding an abbreviation or other text is +the end of a sentence, simply enter the text fragment in the text box below +Do not treat as the end of a sentence:. Then click +Add. +As an example: Adding Jr. to this dialog prevents +Robert Jones Jr. is a friend of the family. +from being changed to: +Robert Jones Jr. Is a friend of the family. +To remove an erroneous entry, simply click once on the wrong entry with the &LMB; +and click on the Remove button. +The second set of boxes performs a similar function to the first except +text entered in these boxes will allow two capital letters in a word if it +is entered in this text box. +Simply enter the word in the text box below +Accept two uppercase letters in:. Then click +Add. +As an example: Adding CD to this dialog prevents +CD +from being changed to: +Cd +To remove an erroneous entry, simply click once on the wrong entry with +the &LMB; and click on the Remove button. + + + + +Manually applying autocorrection +autocorrectionmanually +applying + +If autocorrection is turned off in your document, you can manually enable autocorrection. +To manually apply autocorrection, first configure your options by using the +autocorrection dialogs. +Then select +ToolsAutocorrection +Apply Autocorrection +from the menubar. +&kword; will start at the beginning of the document and apply all selected +autocorrection options to the entire document. +When &kword; is finished, it will return you to your document for further editing. +For more information on enabling and disabling autocorrection, +see Enabling/Disabling Autocorrection. + + + + + +Autocompletion +autocompletion + +Autocompletion allows you to type the first few letters of a commonly +used word (often technical or job specific), and tell &kword; to +finish typing the word for you. This is often very useful when you have lengthy +technical words. + +Using autocompletion +Using autocompletion could not be easier. Simply type the first few +letters of the word you want &kword; to finish, and press +&Ctrl;E. &kword; will look +through the list of autocompletion words and if it finds a word which begins +with those letters, it will finish entering the remainder of the word. + +Adding words to autocompletion +&kword; maintains a list of words for each user that will be used for +autocompletion. +You can add words to this list one of two ways: + +&kword; can automatically add new words to the completion list +for later approval. +This is selected using the dialog. +Individual words can be added to the list by using +the dialog. + + + + +Configuring autocomplete +To configure autocompletion, select +SettingsConfigure +Completion... +from the menubar. This will bring up a dialog. + + + + + + + + + + +Enable word completion +It is used to toggle autocompletion on and off. + + + +Add + +By clicking this button you can manually add +an individual word to the completion list. + + + + +Remove + +To remove words from the completion list, select the word with the &LMB; +from the list, then click this button. + + + + +Automatically add new words to suggestion list + +This option will add any word equal to or longer than +the Characters needed: to the list of proposed +autocompletion words. +The large listbox in the center of the dialog contains the current +proposed list of autocompletion words. +Not all words listed in the list box will be immediatly affected by +autocompletion when entered into this dialog. + + + + +Show words in tooltip + +If this option is enabled, a tool tip box will appear when you type the +beginning of a word that exists in the completion list. To complete the word, +press the key you set to accept suggestions in the Key to accept +suggestion: drop-down list. + + + + + +Characters needed: + +Use this spinbox/slider combination to prevent &kword; +from automatically adding short words to the completion list. You can select +any value from 5-100 and the words will need to be at least the number of +characters set here to be added in the list. + + + + +Suggest words: + +This spinbox/slider combination can be adjusted to allow more or less +words into the autocompletion list. This option is most important when +Automatically add new words to suggestion list is enabled. +This option keeps the list from becoming too cumbersome. You can select any +value from 1 to 500. + + + + +Append space + +If checked, it adds a single space to the end of a word after +autocompletion, this means it is not necessary to add the space manually for the +next word. + + + + +Key to accept suggestion: + +Set the key you want to use when an autocompleted word is suggested to you +and you want to accept it. You can choose +Enter, Tab, Space, +End or Right. + + + + +Make Default + +A word is not part of autocompletion until the list is +saved to disk. At that moment, &kword; +will use that saved list for all autocompletion, until the list is replaced with +another saved list. +Some of the words in the autocompletion list may not have been saved +yet.To save the current list to disk and have &kword; begin using +this new list for autocompletion, +click this button. + + + + +Click OK to save your options. Click +Cancel to abort all changes. Click +Reset to reset to the state after you clicked on the +Make Default button. + + + + + + diff --git a/doc/kword/editpaste.png b/doc/kword/editpaste.png new file mode 100644 index 00000000..121448cf Binary files /dev/null and b/doc/kword/editpaste.png differ diff --git a/doc/kword/edittb.png b/doc/kword/edittb.png new file mode 100644 index 00000000..8235f46d Binary files /dev/null and b/doc/kword/edittb.png differ diff --git a/doc/kword/end.png b/doc/kword/end.png new file mode 100644 index 00000000..13797589 Binary files /dev/null and b/doc/kword/end.png differ diff --git a/doc/kword/enumlist.png b/doc/kword/enumlist.png new file mode 100644 index 00000000..bc555968 Binary files /dev/null and b/doc/kword/enumlist.png differ diff --git a/doc/kword/exoffset.png b/doc/kword/exoffset.png new file mode 100644 index 00000000..9c9998d4 Binary files /dev/null and b/doc/kword/exoffset.png differ diff --git a/doc/kword/expression.png b/doc/kword/expression.png new file mode 100644 index 00000000..a9c69da4 Binary files /dev/null and b/doc/kword/expression.png differ diff --git a/doc/kword/expressions.docbook b/doc/kword/expressions.docbook new file mode 100644 index 00000000..0d0a3f33 --- /dev/null +++ b/doc/kword/expressions.docbook @@ -0,0 +1,93 @@ + + + + +Mike +McBride + + + + +Expressions +expressions + +Expressions are a way to quickly insert common phrases into a document. Once an expression has been selected, the +text is inserted into &kword;. + Expressions are different from variables. Expressions are inserted as regular text, can only be +changed later by manually editing the text. Variables, insert a placeholder in the document which can be automatically updated at +a later date. +Using expressions +To use an expression could not be easier. +Simply place the cursor at the location you want the expression inserted and select + +InsertExpression + from the menubar. This will give you a submenu with groups of expressions. Select the group that is appropriate +for your expression. This will bring up a list of expressions available to you. Select the appropriate expression. +Once selected, that expression will be inserted at the cursor position. + +Add, change and delete expression groups and expressions +Adding an expression is accomplished by selecting +ToolsEdit Personal Expressions... + from the menubar. This will bring up a dialog box. + + + + + + +The list at the left shows you all available groups (Employees and Notices +in the example above). +Notices is the currently selected group. +Add a new group +You will need to create a new group the first time you want to add a new expression. &kword; + will not allow the user to edit or remove any predefined expressions. You create a new group by clicking on the + New located below the group list. A new group will be created + with the name new group. You can change the name of the new group by clicking on the + newly created group in the group list on the left, then editing the text box on the right labeled Group name:. + +Change the name of a group +To change the name of a group, simply click on the group in the list on the left side of the dialog. Type the new name in the text +box labeled Group name:. + +Delete a group +To delete a group, click on the group in the list on the left side of the dialog. +Be sure you have selected the correct group prior to clicking on the Delete +button. &kword; will not give you the opportunity to restore the group if it is accidentally deleted. + Click on the +Delete button below the group list. The group and all of the expressions it +contained are immediately deleted. +Deleting an expression with this dialog does not delete the expression from any document. It only removes the +expression from the menus. + +Add a new expression to a group +The left side of the dialog box lists all the available groups. Select the group you want to add your expression to by +clicking with the &LMB; on the name of the group. The list on the right of the dialog labeled +Expressions lists all the current expressions in the current group. +To add an expression, click on the New located below the expression list. +A new expression is created called empty. Type your new expression in the textbox below the list of expressions. + +Edit an expression in a group +The left side of the dialog box lists all the available groups. Select the group that contains your expression to by +clicking with the &LMB; on the name of the group. The list on the right of the dialog labeled +Expressions lists all the current expressions in the current group. +Click on the expression you want to edit in the expression list on the right. +Click in the text box below the expression list. You can now edit your expression in the textbox below the list of expressions. +When you are finished adding new expressions, simply click OK. + +Delete an expression +To delete an expression, click on the group in the list on the left side of the dialog. This will show a list of the expressions +belonging to that group in the listbox on the right labeled Expressions. +Select the expression you want to delete by clicking once with the &LMB;. +Be sure you have selected the correct expression prior to clicking on the Delete +button. &kword; will not give you the opportunity to restore the expression if it is accidentally deleted. + Click on the +Delete button below the expression list. The +expression is immediately deleted. +Deleting an expression with this dialog does not delete the expression from any document. It only removes the +expression from the menus. +When you are finished making changes, simply click OK. + + + + + diff --git a/doc/kword/exst.png b/doc/kword/exst.png new file mode 100644 index 00000000..87297239 Binary files /dev/null and b/doc/kword/exst.png differ diff --git a/doc/kword/exul.png b/doc/kword/exul.png new file mode 100644 index 00000000..32a36619 Binary files /dev/null and b/doc/kword/exul.png differ diff --git a/doc/kword/fchardlg.png b/doc/kword/fchardlg.png new file mode 100644 index 00000000..444f0601 Binary files /dev/null and b/doc/kword/fchardlg.png differ diff --git a/doc/kword/fchardlg2.png b/doc/kword/fchardlg2.png new file mode 100644 index 00000000..d491493f Binary files /dev/null and b/doc/kword/fchardlg2.png differ diff --git a/doc/kword/fchardlg3.png b/doc/kword/fchardlg3.png new file mode 100644 index 00000000..592a342b Binary files /dev/null and b/doc/kword/fchardlg3.png differ diff --git a/doc/kword/fchardlg4.png b/doc/kword/fchardlg4.png new file mode 100644 index 00000000..ceadfb81 Binary files /dev/null and b/doc/kword/fchardlg4.png differ diff --git a/doc/kword/fchardlg5.png b/doc/kword/fchardlg5.png new file mode 100644 index 00000000..942c0e1e Binary files /dev/null and b/doc/kword/fchardlg5.png differ diff --git a/doc/kword/filefloppy.png b/doc/kword/filefloppy.png new file mode 100644 index 00000000..57d25a64 Binary files /dev/null and b/doc/kword/filefloppy.png differ diff --git a/doc/kword/filenew2.png b/doc/kword/filenew2.png new file mode 100644 index 00000000..d6ffc964 Binary files /dev/null and b/doc/kword/filenew2.png differ diff --git a/doc/kword/fileopen.png b/doc/kword/fileopen.png new file mode 100644 index 00000000..5ba1875b Binary files /dev/null and b/doc/kword/fileopen.png differ diff --git a/doc/kword/fileprint.png b/doc/kword/fileprint.png new file mode 100644 index 00000000..b4c9d55d Binary files /dev/null and b/doc/kword/fileprint.png differ diff --git a/doc/kword/fileprint2.png b/doc/kword/fileprint2.png new file mode 100644 index 00000000..51eee9dd Binary files /dev/null and b/doc/kword/fileprint2.png differ diff --git a/doc/kword/filetb.png b/doc/kword/filetb.png new file mode 100644 index 00000000..d0b1b5b5 Binary files /dev/null and b/doc/kword/filetb.png differ diff --git a/doc/kword/find.png b/doc/kword/find.png new file mode 100644 index 00000000..515a840f Binary files /dev/null and b/doc/kword/find.png differ diff --git a/doc/kword/finddlg.png b/doc/kword/finddlg.png new file mode 100644 index 00000000..d8cf12c6 Binary files /dev/null and b/doc/kword/finddlg.png differ diff --git a/doc/kword/finddlg2.png b/doc/kword/finddlg2.png new file mode 100644 index 00000000..98fefdf8 Binary files /dev/null and b/doc/kword/finddlg2.png differ diff --git a/doc/kword/footcfg1.png b/doc/kword/footcfg1.png new file mode 100644 index 00000000..713263e4 Binary files /dev/null and b/doc/kword/footcfg1.png differ diff --git a/doc/kword/footcfg2.png b/doc/kword/footcfg2.png new file mode 100644 index 00000000..830094ed Binary files /dev/null and b/doc/kword/footcfg2.png differ diff --git a/doc/kword/footcfg3.png b/doc/kword/footcfg3.png new file mode 100644 index 00000000..d50fbcf9 Binary files /dev/null and b/doc/kword/footcfg3.png differ diff --git a/doc/kword/footend.png b/doc/kword/footend.png new file mode 100644 index 00000000..6dffe55b Binary files /dev/null and b/doc/kword/footend.png differ diff --git a/doc/kword/footendnotes.docbook b/doc/kword/footendnotes.docbook new file mode 100644 index 00000000..5ec62451 --- /dev/null +++ b/doc/kword/footendnotes.docbook @@ -0,0 +1,200 @@ + + + + +Mike +McBride + + + + +Footnotes and Endnotes +footnotesintroduction +endnotesintroduction + +&kword; has a complete set of tools to create and manage footnotes and endnotes. When you assign a footnote, &kword; automatically +places the footnote at the bottom of the correct page. When you assign an endnote, the notation is located in a numbered list at the end of your text. + If the footnote or endnote reference point is moved to a new page, the footnote automatically +follows and is renumbered as needed (if the user desires). +&kword; also has the ability to separately manage endnotes and footnotes in the same document. +You have the option of having &kword; control the numbering of your footnotes. Alternatively, you can manually specify each footnote. +There are multiple automatic numbering schemes and your footnotes can be separated from the text with a dividing line. + + +Add a new footnote or endnote +footnotescreating +endnotescreating + +To add a new footnote or endnote, place your cursor at the end of the text you want to reference. Then select +InsertFootnote/Endnote... +from the menubar. This will bring up a dialog box. + + + + + + + + + +If you want &kword; to automatically number your footnotes or endnotes for you, make sure that Automatic is selected. +If you want to manually enter all footnotes in, then select Manual and enter the footnote or endnote entry in +the text box to the right. +If at all possible, try to allow &kword; to automatically number the footnotes and endnotes for you. If &kword; controls the numbering, and you +insert, delete or move footnotes, &kword; will automatically renumber or reorder the footnotes for you. + +Then select either Footnote or Endnote. Footnotes will appear at the bottom of the +page where the notation occurs. Endnotes will appear as an ordered list at the end of your document. + +Click Configure to change the look of your footnotes or endnotes. +Click Cancel to return to your document without inserting a footnote or endnote. + +Click OK to insert the footnote or endnote. &kword; will create the footnote or endnote +entry, and place the cursor at the beginning of the entry for you to enter the desired reference information. +Type your reference information in the space provided. + +When you have finished entering your footnote or endnote reference information, simply move your cursor over the footnote or endnote +number. Click with the &RMB;. A popup menu will appear. Select Go to Footnote and &kword; will move the cursor back to the text +where the reference was made. + + + +Change reference of footnote +footnotesediting +endnotesediting + +There are two ways to change reference information for a footnote: + +Place the mouse pointer over the footnote you want to change, and click once with the &RMB;. +A popup menu will appear. Select Edit Footnote. &kword; will immediately move your +cursor to the appropriate footnote reference. +Simply move to the bottom of the page (if it is a footnote) or the end of the document +(if it is an endnote). Locate the footnote or endnote reference, and click once with the &LMB;. +You can jump to the end of the document by typing &Ctrl;End. + + + + +Delete a footnote or endnote +footnotesdeleting +endnotesdeleting + +To delete a footnote, simply delete the footnote or endnote number. &kword; will remove the reference information and resize the footnote frame. + + + +Change the look of footnotes +footnoteschange appearance + +To configure the appearance of footnotes, select Format +Footnote... from the menubar. A dialog will appear. + + + + + + + + +There are 5 predefined numbering methods for footnotes. Those methods are listed in the left +side of the dialog box. Begin by selecting the numbering method you want by clicking once with the &LMB;. +In the text box labeled Prefix text:, you can enter any characters you want to +appear before the footnote number. +In the text box labeled Suffix text:, you can enter any characters you want to +appear after the footnote number. +You can adjust the starting position of the footnote counter using the spinbox labeled Start at:. + + + +Change the appearance of separator line +To change the appearance of the separator line, click on the tab labeled Separator Line. + + + + + + + +You can determine the alignment of the separator line by selecting Left, +Centered or Right +Determine the length of the line using the spin box labeled Size on page:. +The spinbox labeled Width: is used to determine the thickness of the seperator line. +Do not confuse this option with the Size on page: option. The Width: is used to set the thickness of the line, not its distance across the page. +Use the combo box labeled Style to determine what kind of line is drawn. +Click OK to change the look of all footnotes or click Cancel to keep +the previous options. + + + +Change the placement of the footnotes +You can determine how much space separates the main text frame and the footnotes. Select + +FormatPage Layout... +from the menubar. This will bring up a dialog: + + + + + + + + +Click on the tab labeled Header & Footer. + + + + + + + + +At the bottom of the dialog is a text box is labeled +Spacing between footnote and body. As the label +suggests, you can use this text box to specify the distance between +the bottom edge of the main frame, and the top edge of the footnotes. +When you have entered the desired spacing, click +OK, and the footnotes will change position on +the page. + +If both footnotes and endnotes are on the current page, the +setting will apply to the space between the body and the +footnotes. + + + +Change the look of endnote entries +endnoteschange appearance + +To configure the appearance of endnotes, select Format +Footnote... from the menubar. A dialog will appear. + + + + + + + +Click on the tab labeled Endnotes. + + + + + + + + +There are 5 predefined numbering methods for footnotes. Those methods are listed in the left +side of the dialog box. Begin by selecting the numbering method you want by clicking once with the &LMB;. +In the text box labeled Prefix text:, you can enter any characters you want to +appear before the endnote number. +In the text box labeled Suffix text:, you can enter any characters you want to +appear before the endnote number. +You can adjust the starting position of the endnote counter using the spinbox labeled Start at:. + +If you want a line seperating the text of the document from your endnotes, instructions +for this can be found in the section entitled Change the appearance of separator line. + + + + + diff --git a/doc/kword/formabs.png b/doc/kword/formabs.png new file mode 100644 index 00000000..df2e5d7e Binary files /dev/null and b/doc/kword/formabs.png differ diff --git a/doc/kword/formatchar.docbook b/doc/kword/formatchar.docbook new file mode 100644 index 00000000..724a726c --- /dev/null +++ b/doc/kword/formatchar.docbook @@ -0,0 +1,319 @@ + + + + +Mike +McBride + + + + +Formatting Characters +textformatting +fontformatting +formatting text + +This section will cover the changes that can be made to individual characters or +blocks of characters including: + + +Character size +Font +Font style (italic, bold, etc). +Underlines, superscript, subscript, strikeout, etc. +Character color and background color. +Character case. + + + + +Changing Size, Font, Font Style, Text color and Background Color +textchange size +change text size +textchange font +change text font +textchange color +change text color +textchange background color +change text background color +textbold +bold text +textitalicized +italicized text +textunderlined +underlined text +textstrikethrough +strikethrough text +textsuperscript +superscript text +textsubscript +subscript text + + + +Using the Keyboard or toolbars + +There are several keyboard shortcuts which you can use to make +common changes to character formatting. After selecting the text, you +can use these key combinations to toggle each attribute. + +The Format toolbar also has buttons which you can use to +toggle these same attributes. + +The following table details each attribute, the toolbar buttons +and the keyboard shortcuts. + + + +AttributeToolbar +ButtonKey Combo + +Font Size +Decrease font size: Ctrl< Increase font size: Ctrl> +Font- +Bold Face&Ctrl;B +ItalicsCtrlI +UnderlineCtrlU +Strikethrough- +Superscript- +Subscript- +Font Color- + + + + +You cannot change the all text attributes using the keyboard or a button on a +toolbar. For these attributes, you must use the dialog +box. + + + + + +Using the Dialog Box + +If you have many changes to make, you can also use a dialog box to +set these same attributes. + +You can open the Select Font dialog box in one of three +ways: + + + +Select +FormatFont... +from the menubar. + + + +Click on the selected text with the &RMB;. A small menu will appear. Select Font... from the +menu. + + + + +You can use the keyboard shortcut: +&Alt;&Ctrl;F + + + +Either method will open a dialog box + + + + + + + + +Using this dialog box, you can select the font, size, +italics and boldface options from the top three list boxes. + +The preview box along the middle of the dialog, will show you how your current +settings will appear. + +If the default preview string is not appropriate, you can change it by clicking once +inside the preview box with the &LMB;. A text cursor will appear. You can edit the text to suit your needs. +The sample sentence will revert to the default the next time you +open this dialog. + + +If you click the tab labeled Highlighting, the dialog changes to: + + + + + + + + +The subsection labeled Underlining: has two combo boxes and a color selector box. +In the left most combo box select between +no underline (None), Single, Simple Bold, +Double or Wave underlining. + + + + + + + + + +Use the center combo box to select the style of underlining (Solid line, dashed line, etc.). +Use the right color selector box to select a color for the underline using the +color selection dialog box. + +The subsection labeled Strikethrough: has two combo boxes. +Use the left combo box to select between +no strikethrough (None), Single, Double or +Simple Bold strikethrough. Use the right combo box to select the line style. + + + + + + + + +The checkbox labeled Word by word determines how underlining and strikethrough are drawn. + + + + + + + + +The section labeled Capitalization lets you select one of four special capitalization options. +This will change the capitalization of the selected text. Examples of each scheme are shown below. + + + + + + + + +The changes to capilalization will only affect the selected text at the current moment. This formatting is not enforced after closing the dialog box. + +The third tab labeled Decoration allows you to change the color of the font, change the background color and create artificial shadows for your characters. Click on the tab: + + + + + + + + +Using the buttons labeled Text color: and Background color: you can change the color of the text or the background behind the text. + +To create the illusion of a shadow behind your text, select the color you want your shadow by clicking the button labeled Shadow color:. Then select the distance between the shadow and +the text using the spin box labeld Shadow & distance:. Finally, select the direction of your shadow by +selecting one of the eight red squares. A preview of your shadow appears at the bottom of the dialog box. + +The fourth tab labeled Layout allows you to create superscripts and subscripts. It also lets you select automatic hyphenation on a character by character basis. + + + + + + + + +The section labeled Position has four radio buttons and two spin boxes. Selecting Normal, produces text of normal height and at the normal vertical position. Selecting Superscript or Subscript will convert the currently selected text. If you select Custom, you can use the spin box labeled Offset: to move the selected text up or down relative to normal text alignment. Look at the example below: + + + + + + + + +Notice how a positive offset raises the text, and a negative offset lowers the text. + +You can also use the spinbox labeled Relative size: to make the selected font larger or smaller. + +The checkbox labeld Auto hyphenation is used to toggle automatic hyphenation on or off for the selected text. + +The fifth tab labeled Language allows you to change the language. Click on the tab: + + + + + + + + +You can select the language to use on the selected text with the drop down box. If the selected text allows for automatic hyphenation, +&kword; will use general rules of spelling for the selected language to automatically hyphenate the selected text. + +Clicking OK will commit your changes to the +document and close the dialog box. + +Clicking Apply will commit your changes to the +document but keep the dialog box open. + +Clicking Reset will restore the default settings to the selected text. + +Clicking Cancel will abort all changes +made. + + + + + +Changing Font Case +textchanging case +change case of text + +&kword; can change the case (uppercase or lowercase) of large blocks of text to one of five pre-defined styles. +Begin by selecting the block of text you want changed. Select +ToolsChange Case... +from the menubar. +A small dialog box will appear with five options: + + +Uppercase +Will convert all characters to uppercase. +Example: KWORD WILL AUTOMATICALLY CHANGE CASES. + + + + +Lowercase +Will convert all characters to lowercase. +Example: kword will automatically change cases. + + + + +Title case +Will capitalize every word. +Example: Kword Will Automatically Change Cases. + + + + +Toggle case +Converts all lowercase letters to uppercase and +converts all uppercase letters to lowercase. + + + + +Sentence case +Capitalizes the first character after a period. + + + + + +When you have selected the desired options click OK and &kword; will make the changes. + + + + + + + diff --git a/doc/kword/formatframes.docbook b/doc/kword/formatframes.docbook new file mode 100644 index 00000000..ab081ddd --- /dev/null +++ b/doc/kword/formatframes.docbook @@ -0,0 +1,503 @@ + + + + +Mike +McBride + + + + +Setting the Properties for a Frame +framesconfigure + +For each frame in your document, you can determine: + + + +how &kword; handles full text frames + + + +how text wraps around or through overlapping +frames + + + +the exact size of the frame + + + +establish margins within a frame. + + + +set a background color and pattern for the frame. + + + +All of these options can be altered using a set of dialog boxes, +or by using a previously defined framestyle. +A framestyle is a predefined set of frameset formatting options which is given a name. Once a frameset +has been assigned a framestyle, any changes made to the framestyle will be reflected in all framesets which are +assigned that framestyle. +You may be noticing that framestyles function in a way similar to text styles. The main difference, is +framestyles control the look of the frame, and textstyles control the look of paragraphs within the frame. + + +Using the frame settings dialogs + +All of these settings can be determined in the Frame +Properties dialog box. + +In order to adjust the properties of any frame, you must first +select the frame you want to change. + +Simply click once on the frame border of the frame you want to +edit. (Or by holding down the &Ctrl; key and clicking inside the frame with the +&LMB;.) + +You edit the properties of a frameset using a set of dialogs which you can +open one of two ways: + + + +Select +FramesFrame/Frameset Properties +from the menubar. + + + +Place the mouse pointer on the border of the frame, and click once +with the &RMB;. A small menu +will appear. Select Frame/Frameset Properties.... + + + + +The Properties dialog consists of one dialog box, with six index +tabs labeled Options, +Text Run Around, +Connect Text Frames, +Geometry, +Background and +Borders. + +General Options +framesconfigure automatic creation +framesprotect contents of + + + + + + + + +The tab labeled Options is used to determine how +&kword; behaves when there is too much text +to fit within the current bounds of the +frame. + +&kword; has three solutions to this situation: + + + +Create a new +page +When a frame becomes full, &kword; automatically +creates a new page. On this new page, it may create a new frame, of the +same size and position, if you choose. + + + +Resize last +frame +When a frame becomes full, &kword; +automatically extends the bottom border of the text frame to accommodate +the new text. It will continue to expand as new text is added. Conversely, it will shrink again if text is removed from the frame. + + + +Don't show the extra text +&kword; does not +create a new frame or change the current frame in any way. You will +need to manually resize the current frame, or add a new frame to the +frame set. + + + +Simply make your selection in the section labeled If Text is Too Long for Frame. + +In the section entitled On New Page Creation, you have three options available. You must select one. + + + +Reconnect frame to current flow +Create a new frame, the same size and shape on a new page, and make it the last frame in the frameset. + + + +Do not create a followup frame +Creates a new page, but not a new frame. + + + +Place a copy of this frame +Creates a new page, with a new frame the same size, shape and position on the page. Additionally, &kword; +copies the contents of the frame from the previous page. +This is useful for title frames, headers and footer frames. Each page will have an automatic copy of this information +on any new pages. + + + + + +If you place a mark in the check box labled Changes will be applied to all +frames in frameset, then any changes made in the frame properties dialog box +will automatically be applied to all frames within the frameset. + +If you place a mark in the check box labeled Protect content, &kword; +will not allow any changes to the text within the frame, or the formatting of the text within the frameset. + +You can still reshape or even delete the frame, but the content within the frame is locked. To lock the location +and size of the frame, see the Geometry tab. + +To make changes to the text, you need to remove the mark from Protect content. + + +Text Flow around frames +framesforce text around + +To adjust how text flows around overlapping frames, click the tab +labeled Text Run Around. + + + + + + + + +When you overlay two text frames, and text from both frames is +competing for the same space on the page, &kword; can (at your option), +make sure that text from two frames does not overlap. + + + + + + + + + + + +As you can see from the options in the dialog box, there are three +possible choices. + + + +Text will run through this frame + +By selecting this option, &kword; will ignore this frame +when it displays the text in overlapping frames. + + + + +Text will run around the frame + +By selecting this option, &kword; will wrap the text +of overlapping frames around this frame. +If this option is selected, you can determine which side the text runs around in the section labeled +Run Around Side. Simply choose Left, Right, +or Longest side. + + + + +Text will not run around this frame + +By selecting this option, &kword; will not wrap any +text around the edges of this frame, but instead, will skip down below +this frame before continuing to display text in overlapping frames. + + + + +You can also determine how close your frames appear by setting the +Distance Between Frame & Text in the spin boxes provided. If you place a mark in the +checkbox labeled Synchronize changes +&kword; will make all distances equal. + + +Move a frame to a new frameset +framesedit framesets +framesetsedit + +You can change which frameset the current frame belongs to by selecting +the Connect Text Frames tab. + + + + + + + + +This dialog gives you the option to create a new frameset for the current frame or move the selected frame to a current frameset. +Select Select existing frameset to connect frame to:, to add the current frame to a previously created +frameset. Choose one of the +framesets listed in the table below to specify which frameset. +To create a new frameset, select Create a new frameset: and type the name of the new frameset in the +text box labeled Name of frameset. &kword; will create a new frameset with the current frame +as the only frame in the frameset (for now). +It is helpful to name your framesets with descriptive names. Name the frameset with a description of the contents +so that you can quickly refer to it again later. + + +Frame size and position +framesgeometry +framesdetermine size (dialog box) +framesdetermine position (dialog box) + +You can adjust the size and position of your frame by +clicking on the tab labeled Geometry. + + + + + + + + +This dialog box allows you to specify exactly +where the frame goes and how large it is. + +If you put a mark in the check box labeled Protect size and position, the frame size and position will +be fixed at their current location. You will not be able to move the frame on the page until this box is unchecked. + +Determine Size and Position +You can locate your frame on the page by first entering the Left: +and Top: measurements. This determines where the top left corner of the +frame will be. All measurements are from the top left corner of the +page. + +You can also determine the exact size of the frame by entering its +Height: and Width: in the text boxes provided. These two measurements are +relative to the top left corner of the frame you specified above. not to the size of the page. + +Determine Margins in the Frame + +Using the boxes labeled +Left:, Right:, Top: and Bottom:, you can establish +margins within the frame. This should not be confused with margins for the page, which are defined in the +page properties dialog box. + +If the Synchronize changes check box has a mark in it, &kword; will take any changes you +make to one margin, and automatically apply them to the other 3 margins. + +In other words, if this check box is selected, and you enter a margin of 1 cm in any of the 4 margin boxes, all 4 frame margins will now +become 1 cm in size. + +If this option is off, each text box can be given a different value. + + + + +Frame Background +framesbackground colors and patterns + +You can adjust the background color of the text frame by selecting the Background tab. + + + + + + + + +Select the color of the background by clicking on the button labeled +Background color:. The color is selected using the +Color selection dialog. + + +Frame Borders +framesborders + +You can change the borders of the text frame by selecting the Borders tab. + + + + + + + + +Select the Style: and Width: of the borders +with the two drop down boxes on the left side of the dialog. +Select the color of the borders by clicking on the button labeled +Color:. The color is selected using the +Color selection dialog. +Use the four icons (Border Left, Border Right, Border Top +and Border Bottom) below the Color button +to determine on which side of the frame you want to have a border. +A Preview of the selected settings is shown on the right side of the dialog. + + +Click OK to accept all of your changes and to close the dialog box. +Click Apply to accept all of your changes without closing the dialog box. +Click Cancel to forget all of your changes. + + + + +Using frame styles +framesframe styles +frame styleusing + + +Formatting a frame with a framestyle +frame styleapply frame style to a frame + +To format a frame using a predefined framestyle simply: +Select the frame(s) by holding down &Ctrl; and clicking within the frame with the &LMB;. +Select +FramesFramestyle +from the menubar. A submenu will appear, listing all the currently defined framestyles. Select the name of the framestyle +you want and all selected frames will automatically be formatting using the options of that framestyle. + + + +Editing a framestyle +frame styleediting + +To change the options of a framestyle, you will need to use the framestyle manager. +Select +FramesFrame Style Manager... +from the menubar. A dialog box will appear. + + + + + + + + +All of the currently defined framestyles are listed in the listbox on the left. The currently selected framestyle is highlighted, and +the name of the currently selected framestyle is listed in the text box labeled Name. (In this example, +the currently selected framestyle is Light Gray.) +Select the framestyle you want to change by clicking on the name of the framestyle in the listbox on the left. +There are three tabs in on the right side of the dialog box: General, Borders +and Background +In the General tab, you can change the name of the liststyle by typing the new name in the text box +labeled Name. You can also see a preview of what your frame will look like in the preview box. +The Borders tab works the same as the tab of the same name when formatting a paragraph. For more specific +information click here. +The Background tab operates identically to the same tab when formatting a frame. Click +here for more specific instructions. +Once all changes have been made, click OK to save your changes. All of the affected framesets will +be changed to reflect the new options. + + + +Creating a new framestyle +frame stylecreate new + +To create a new framestyle, select +FramesFrame Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +Select a framestyle from the list at the left which most closely matches your new desired framestyle by clicking on the name with the &LMB;. +The selected framestyle will be used as a template for the new framestyle. +Click on the New button. &kword; will generate a new framestyle, which is a copy +of the previously selected framestyle. +Choose a name for your new framestyle, and type it in the text box labeled Name. +You can now change your frame border and background options. For details, see +Editing a framestyle. +When you are finished creating your framestyle, click OK, and your framestyle is saved. +Framestyles are specific for each document. A framestyle created in one document can not be used in another document unless you +import the framestyle from that document. + + + +Deleting a framestyle +frame styledeleting + +To delete framestyle, select +FramesFrame Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +Select the framestyle you want to delete by clicking once with the &LMB; in the list on the left. +Click on the Delete button. +&kword; will not allow you to delete the Plain framestyle. + + + +Changing the order of the framestyles in the list +To change the order that the framestyles are listed, select +FramesFrame Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +The order the framestyles are listed in the menu is determined by the order of the framestyles in the list on the left. +Select the framestyle you want to move from the list at the left by clicking once with the &LMB;. +Now click on the up and down arrows located at the bottom of the list of framestyles. This will move the +selected framestyle up or down in the list of framestyles. +When you are satisfied with the order of the list, select OK. + + + +Importing a framestyle from another &kword; file +frame styleimporting from another file + +To import a framestyle from another &kword; file, select +FramesFrame Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +Click the button labeled Import From File... to open the +file selection dialog. +  Choose your file, and click OK. +A new dialog box will appear listing all available framestyles for importing. + + + + + + + +If &kword; encounters a duplicate framestyle name in the selected file, it will append a number to the end of the +framestyle name to identify the imported style. +As an example, if you import the Plain framestyle from another &kword; file, &kword; will change +the name to Plain-1. +Select all the framestyles you want to import. Then click +OK. +The framestyles will now appear at the bottom of your list of framestyles. Click OK +to save the framestyles to the new document. + + + diff --git a/doc/kword/formatpara.docbook b/doc/kword/formatpara.docbook new file mode 100644 index 00000000..88d78aa5 --- /dev/null +++ b/doc/kword/formatpara.docbook @@ -0,0 +1,388 @@ + + + + +Mike +McBride + + + + +Formatting Paragraphs +paragraphformatting +This section will detail all the options available to format paragraphs. + +To format a paragraph, place the cursor in the paragraph. To format more than +one paragraph at a time, simply select the paragraphs with the mouse or keyboard. + +You can format one or more paragraphs one of three ways: + + + +Select +FormatParagraph... +from the menubar + + +Type &Alt;&Ctrl;P + + +Place the mouse pointer in the paragraph and click once +with the &RMB;. A small menu +will appear. Select Paragraph.... + + + +A dialog will appear. + +The Paragraph Settings dialog consists of five tabbed sections +labeled Indent and Spacing, General Layout, Borders, +Bullets/Numbering, and +Tabulators. + + +Indents and Spaces +paragraphindent lines +paragraphchange line spacing +paragraphkeep lines and paragraphs together + +With this dialog box the +spacing between lines, and the spacing between paragraphs can be specified. + + + + + + + + +The first section of this dialog box is labeled +Indent, and consists of three spin boxes: + + + +Left + +Enter a value in this box to indent the lines of the selected paragraphs away from the left margin. +The first line is unaffected by this spin box. To +alter the first line, specify that value in the spin box labeled First Line. + + + + +Right + +Enter a value in this spin box to indent all lines of the selected paragraph +(including the first line) away from the right +margin. + + + + +First Line +Enter a number in this spin box to indent the first line of a paragraph away from the left +margin. +Entering a negative value in this spin box will create a hanging indention. + + + + +The next section is labeled Line Spacing. It +consists of a combo box and a spin box. + +The combo box determines the method of calculating the spacing between lines. It has several choices: + + + +Single, 1.5 Lines and Double + +If any of these options are selected, the paragraph will have single, 1 and 1/2 or double spacing respectively. + + + + +Proportional + +If this option is selected, the spin box is enabled. When you enter a number in the spin box, &kword; uses that number as a multiplier for line spacing. To look at it another way, if you enter 1.00 in this box, &kword; will use single spacing. If you enter 2.00 in this box, &kword; will use double spacing. If you enter 3.00 in this box, &kword; will use triple spacing, etc. You are not limited to whole numbers. You could enter 1.87 in this box and &kword; would use 1.87 line spacing. + + + + +Line Distance + +If this option is selected, the spin box is enabled. When you enter a number in the spin box, &kword; places a measured amount of space between each line. As an example, if you enter 0.75 and the units used by &kword; are inches, then &kword; will place 0.75 inches between each line. + + + + +At least + +This sets the minimum line spacing value. This can be useful if you have paragraphs with widely differing font sizes. Typically, &kword; calculates the distance between lines by looking at the tallest character in the line. You can use this feature to overide close linespacing in small font paragraphs to make them even with large font paragraphs. &kword; will not cause any fonts to overlap using this spacing technique. + + + + +Fixed + +This sets the distance between the tops of each line to a specific unit of measure. If this option is set too small, &kword; will overlap characters, which will obscure the bottom parts of the characters. +This should not be confused with Line Distance which inserts a specific unit of space between lines. Fixed specifies the distance between the top of one line and the top of the next line. + + + + + + +The last section is labeled Paragraph Space. +It consists of two entries: + + + +Before + +By entering a value here, additional spacing is added before each paragraph. + + + + +After + +By entering a value here, additional spacing is added after each paragraph. + + + + +On the right of the dialog box, is a preview box, which will +approximate the final layout of your +document. + + + + +General Layout +paragraphjustification +paragraphcenter paragraph +paragraphleft/right aligns +paragraphhorizontally align paragraphs + +This section determines how the text is placed within +the line. With other applications, you may have referred to +this simply as alignment, or +justification. + + + + + + + + +Once again, a preview pane is shown on the right side of the dialog box. + +In the upper left corner of the dialog box is a section labeled Alignment. + +If Left, +Right or Center are selected, the text will +be moved on the line so that it aligns with the left margin, aligns with +the right margin, or is centered between the margins +respectively. + +If Justify is selected, &kword; will increase +the space between words, so that each line (with +the exception of the last line in a paragraph), reaches both the left +and right margins. + +You can use toolbar buttons to quickly change the justification of one or more paragraphs + + + +ButtonCommand + + +Left Align +Center Align +Right Align +Justify Text + + + + + +The lower section controls how &kword; divides paragraphs when a +paragraph will not fit entirely within the current frame or page. + +The first option is labeled Keep lines +together. If this option is selected, then all of the lines +of the paragraph will remain on the same page. If this is not selected, +&kword; may choose to move part of a paragraph to a new page or frame. +For most work, this option is usually left +unchecked. + +The next two options are labeled Insert Break Before Paragraph + and Insert Break After Paragraph. +When one of these options is checked, and the paragraph moves to the +next frame in the frame set, a hard frame break will be inserted in front +of the current paragraph or after the previous paragraph (depending on the option selected). +This will serve to keep the paragraph in the +next frame, even if text prior to that frame is deleted. This option is +often used in conjunction with Keep lines together, +to ensure that the paragraph does not creep back onto the page during +editing. + + + + +Decorations +paragraphborders + +The next section is used to define the background color of the current paragraphs and configure graphical borders +around your paragraphs. + + + + + + + + +Clicking the color button to the right of Background color:, will let you select a color to serve as the background +of your paragraph. +&kword; can surround (on some or all sides) a +paragraph with a border. This border can be solid or not, of any color +and of many sizes. This dialog panel is used to adjust the +borders. + + + +Style + +Use this combo box to select the overall type +of the new border. +The choices are previewed in each selection. + + + + +Width + +This will determine how wide the resulting border will be. It is +measured in points. + + + + +Color + +Clicking on the color bar will allow you to select a color using the color selection dialog +box. + + + +Now that it is determined how the borders should look, specify which edges of the paragraphs need borders. + + + + + + +Select/Unselect Left Border. Clicking this +button will apply the current options to the left paragraph border. +Clicking a second time will remove the left paragraph border. + + + + +Select/Unselect Right Border. Clicking this +button will apply the current options to the right paragraph border. +Clicking a second time will remove the right paragraph border. + + + + +Select/Unselect Top Border. Clicking this button +will apply the current options to the top paragraph border. Clicking a +second time will remove the top paragraph border. + + + + +Select/Unselect Bottom Border. Clicking this +button will apply the current options to the bottom paragraph border. +Clicking a second time will remove the bottom paragraph border. + + + + + +It is possible to mix and match border styles, widths and colors in one paragraph. +Simply determine the border style, width and color for one border edge, and select the border +using the border buttons. Now alter the style width or color to create a new border look and click the new border button. + + + +The Preview window will show you how your +paragraph borders will look. + + + + +Bullets and Numbering +paragraphbulleted +paragraphnumbered +lists + +A very common element of a document, is a list of items. The list +contains several elements which may be numbered, for easy +reference. Alternatively, the list elements may be simply set off from +the rest of the text with a special character preceding each element. These special characters +are called bullets. + +This dialog box is used to define your bullets or the +numbering method of lists in the document. This dialog box can also be used to number chapters and sections. + + + + + + + + +The top section of the dialog box has three options: None, List +and Chapter. + +If None is selected, the text is not marked as +either a list or a chapter. No other features of this dialog +box will alter the text when this option is chosen. + +List is used to create +lists in the document. These lists are +automatically numbered and formatted to appear similar. +For more information on lists, see the section entitled Lists. + +Chapter is used to +number chapters and sections of a document. + + + + +Tabulators + + + + + + + + + +This dialog is used to adjust the tab stops. For more details, +see Using Tab Stops. + + + + diff --git a/doc/kword/formbrac.png b/doc/kword/formbrac.png new file mode 100644 index 00000000..c9f471d4 Binary files /dev/null and b/doc/kword/formbrac.png differ diff --git a/doc/kword/formcbrac.png b/doc/kword/formcbrac.png new file mode 100644 index 00000000..d15b971c Binary files /dev/null and b/doc/kword/formcbrac.png differ diff --git a/doc/kword/formfrac.png b/doc/kword/formfrac.png new file mode 100644 index 00000000..5cf409d6 Binary files /dev/null and b/doc/kword/formfrac.png differ diff --git a/doc/kword/formframe1.png b/doc/kword/formframe1.png new file mode 100644 index 00000000..c922d70b Binary files /dev/null and b/doc/kword/formframe1.png differ diff --git a/doc/kword/formframe2.png b/doc/kword/formframe2.png new file mode 100644 index 00000000..dff85d2d Binary files /dev/null and b/doc/kword/formframe2.png differ diff --git a/doc/kword/formframe3.png b/doc/kword/formframe3.png new file mode 100644 index 00000000..12dba009 Binary files /dev/null and b/doc/kword/formframe3.png differ diff --git a/doc/kword/formframe4.png b/doc/kword/formframe4.png new file mode 100644 index 00000000..8d7a18d1 Binary files /dev/null and b/doc/kword/formframe4.png differ diff --git a/doc/kword/formframe5.png b/doc/kword/formframe5.png new file mode 100644 index 00000000..c9cfb0a7 Binary files /dev/null and b/doc/kword/formframe5.png differ diff --git a/doc/kword/formframe6.png b/doc/kword/formframe6.png new file mode 100644 index 00000000..713a2b6a Binary files /dev/null and b/doc/kword/formframe6.png differ diff --git a/doc/kword/forminteg.png b/doc/kword/forminteg.png new file mode 100644 index 00000000..12a1aad4 Binary files /dev/null and b/doc/kword/forminteg.png differ diff --git a/doc/kword/formllind.png b/doc/kword/formllind.png new file mode 100644 index 00000000..72ea58a0 Binary files /dev/null and b/doc/kword/formllind.png differ diff --git a/doc/kword/formlrind.png b/doc/kword/formlrind.png new file mode 100644 index 00000000..6c7ba324 Binary files /dev/null and b/doc/kword/formlrind.png differ diff --git a/doc/kword/formmat.png b/doc/kword/formmat.png new file mode 100644 index 00000000..9a49be62 Binary files /dev/null and b/doc/kword/formmat.png differ diff --git a/doc/kword/formover.png b/doc/kword/formover.png new file mode 100644 index 00000000..da6b9c1f Binary files /dev/null and b/doc/kword/formover.png differ diff --git a/doc/kword/formprod.png b/doc/kword/formprod.png new file mode 100644 index 00000000..f8ea9d64 Binary files /dev/null and b/doc/kword/formprod.png differ diff --git a/doc/kword/formsbrac.png b/doc/kword/formsbrac.png new file mode 100644 index 00000000..b14e5db8 Binary files /dev/null and b/doc/kword/formsbrac.png differ diff --git a/doc/kword/formspecchar.png b/doc/kword/formspecchar.png new file mode 100644 index 00000000..e00f843a Binary files /dev/null and b/doc/kword/formspecchar.png differ diff --git a/doc/kword/formsqrt.png b/doc/kword/formsqrt.png new file mode 100644 index 00000000..fbeca9f9 Binary files /dev/null and b/doc/kword/formsqrt.png differ diff --git a/doc/kword/formsum.png b/doc/kword/formsum.png new file mode 100644 index 00000000..580dd2a2 Binary files /dev/null and b/doc/kword/formsum.png differ diff --git a/doc/kword/formtb.png b/doc/kword/formtb.png new file mode 100644 index 00000000..b6ba11e1 Binary files /dev/null and b/doc/kword/formtb.png differ diff --git a/doc/kword/formulas.docbook b/doc/kword/formulas.docbook new file mode 100644 index 00000000..fa8d9344 --- /dev/null +++ b/doc/kword/formulas.docbook @@ -0,0 +1,69 @@ + + + + +Mike +McBride + + + + +Formulas +formulas + +&kword; has the ability to directly create formulas using the formula editor common to all &koffice; applications. +This is a formula editor for creating graphical versions of formulas. &kword; does not currently have the ability +to solve mathematical equations. + +Add a formula +There are three ways to insert a formula into a document: + + +By selecting +InsertFormula from +the menubar + + + +Using the keyboard shortcut: F4 + + + +or by clicking on the toolbar. + + +&kword; creates a formula frame at the current cursor location. +Formula frames behave differently than most other frames in &kword;: + +All formula frames are inserted inline by default. +This frame can later be +converted to a non-inline frame later. +Formula frames expand and contract depending on the resulting size of the formula. +Formula frames automatically determine where in the line they are lined up. + + + + + +Moving a formula +By default, formula frames are created as inline frames by default. The formula frame +will move with the text as any other inline frame would. +If you want to have more control over where the formula is placed, you can convert it to a framed formula by clicking on the +frame surrounding the formula with the &RMB;. A popup menu will appear. Simply select Inline Frame and the formula will +now be a freely movable frame. +Once converted to a freely movable frame, you can move the frame +just like any other frame in &kword;. + + +Removing a formula +To delete a formula in &kword;, simply delete the frame around it. + + +Editing a formula +Editing a formula is beyond the scope of this documentation. +Please see the &kformula; handbook for help with the editing of the formula. + + + diff --git a/doc/kword/formulind.png b/doc/kword/formulind.png new file mode 100644 index 00000000..35128d7d Binary files /dev/null and b/doc/kword/formulind.png differ diff --git a/doc/kword/formunder.png b/doc/kword/formunder.png new file mode 100644 index 00000000..2ae09dfc Binary files /dev/null and b/doc/kword/formunder.png differ diff --git a/doc/kword/formurind.png b/doc/kword/formurind.png new file mode 100644 index 00000000..f8fe2afc Binary files /dev/null and b/doc/kword/formurind.png differ diff --git a/doc/kword/forward.png b/doc/kword/forward.png new file mode 100644 index 00000000..03f5200f Binary files /dev/null and b/doc/kword/forward.png differ diff --git a/doc/kword/fpara1.png b/doc/kword/fpara1.png new file mode 100644 index 00000000..452c02d9 Binary files /dev/null and b/doc/kword/fpara1.png differ diff --git a/doc/kword/fpara2.png b/doc/kword/fpara2.png new file mode 100644 index 00000000..978eb0d4 Binary files /dev/null and b/doc/kword/fpara2.png differ diff --git a/doc/kword/fpara3.png b/doc/kword/fpara3.png new file mode 100644 index 00000000..f88d63ca Binary files /dev/null and b/doc/kword/fpara3.png differ diff --git a/doc/kword/fpara4.png b/doc/kword/fpara4.png new file mode 100644 index 00000000..c797b8ec Binary files /dev/null and b/doc/kword/fpara4.png differ diff --git a/doc/kword/fpara5.png b/doc/kword/fpara5.png new file mode 100644 index 00000000..d3165325 Binary files /dev/null and b/doc/kword/fpara5.png differ diff --git a/doc/kword/fpicture.png b/doc/kword/fpicture.png new file mode 100644 index 00000000..d73158ee Binary files /dev/null and b/doc/kword/fpicture.png differ diff --git a/doc/kword/framers.png b/doc/kword/framers.png new file mode 100644 index 00000000..0460c83e Binary files /dev/null and b/doc/kword/framers.png differ diff --git a/doc/kword/frames.docbook b/doc/kword/frames.docbook new file mode 100644 index 00000000..639538ee --- /dev/null +++ b/doc/kword/frames.docbook @@ -0,0 +1,435 @@ + + + + +Mike +McBride + + + + +Working with Frames +framesintroduction +Since &kword; is a frames based word processor, an understanding of +frames and framesets is necessary for all but the most simple of documents. + +This section is designed to give you a firm understanding of how +to create, destroy and manipulate frames so &kword; can provide you with +the exact document you want. + + +Framesets +framesetsintroduction + +Before we continue our discussion of Frames, its important that we +define a couple terms now: + + + +Frame + +A frame is a rectangular space on the page. This space defines an +area where text (or other data), can be placed. + + + + +Frameset + +A frameset is a group of frames. Each frame in the frameset has a +position within the frameset + +The position is determined by their placement on the page. If frames extend across the entire width of the page, the frame which begins closest +to the top of the page is Frame #1. The next frame that is closest to the top of the page is Frame #2, etc. +If the frames do not extend across the width of the page, the frame whose +left edge is closest to the left margin will be frame #1. In this case, +the vertical position of the frame is ignored. + +All text flows from one frame to another within a +frameset, and only within a frameset. Text flows from frame +to frame within the frameset according to the position of each +frame on the page (and therefore the order of the frames within the frameset). + +As an example: If we have a frameset that consists of three +frames (#1, #2, and #3). + +As we type text into Frame #1, the text is shaped to the outline +of Frame #1. + +When the text will no longer fit within Frame #1, it is +automatically continued into Frame #2. + + + + +Text moves freely between frames +within a frameset. If you insert text in the middle of a frame, all text after the inserted text is +rearranged as you type. + + + + +Selecting a frame +framesselecting + +You can select a frame within a frameset two ways: + +By clicking on the text frame border of the frame you want +to select. +By holding down the &Ctrl; key and clicking anywhere within the frame. + +There should now be 8 squares around the edges of the frame. + + + +Adding a Text Frame to a Document +framesadding a text frame + +Adding a text frame can be done one of three ways: + + + +By selecting +InsertText +Frame from the menubar + + + +You can use the keyboard shortcut: +F10 + + + +or by clicking on the toolbar. + + + +Whatever method you choose, &kword; responds by changing the cursor +to a set of cross hairs. + +Using the mouse, place the crosshairs at the desired position of the upper left corner of the +new text frame. + +Click once with the &LMB;. + +Alternative, first position the text caret at the place where you want to insert +the frame. When the mouse cursor changes to crosshairs, press &Enter;. + + +A dialog box appears. + + + + + + + +This dialog box is used to determine which frameset this new frame will belong to. + +Using the screenshot as an example, a new text frame has been created in a +document which currently has two framesets (called Text Frameset +1, and Text Frameset 2). + +You now have the option of either: + + + +Add the new frame to one of the previously created +framesets. + +To do this, simply select the frameset you want the new frame to belong to. + (Either Text Frameset 1, or +Text Frameset 2 in the example.) + +When this text frame is created, the new text frame will become +a member of the selected frameset. + + + +Create a new frameset. + +If you want this to be a new frameset, you should enter a descriptive +name for your new frameset. (A name which will tell you what you might +find in that frameset). This name should be entered in the text box +labeled Name of frameset:. +This newly added frame will be the +only frame in the frameset. + + + +The other tabs in this dialog box, can be used to set some options +for this frame. For more information on these options, see the section +entitled Setting the properties for a frame. + +If you click OK, the new frame will be +created. + +If you click Cancel, the new frame will not +be created, and you will be returned to editing your document. + + +By default, &kword; creates a small frame with the upper left corner of the +frame located on the page where you clicked with the mouse cursor. After the frame is +created, you are expected to reshape the frame to fit your needs. + +If you would prefer to establish the shape of your frame while you are +creating the frame, simply click the &LMB; where you want the upper left corner to +be placed and hold the button down. Drag the mouse towards the opposite corner of the frame to establish the +boundaries of the new frame. As +you drag the mouse, you will see a box drawn. This box represents the +boundaries of your new text frame. When you are satisfied with the size and shape of the new text +frame, release the mouse button. + + + + +Deleting a Frame From a Document +framesdeleting + +You may decide you no longer need a frame in your document. You +could leave it blank (so it would not be visible in the final output), +but you should delete it to keep your document as simple as +possible. + +Begin by clicking on the text frame border of the frame you want +to delete. (Or holding down the &Ctrl; key and clicking inside the frame with the +&LMB;.) + +There are now 8 squares on the edges of the frame. + +If this is the frame you want to delete, you can do so by: + + + +Press the Delete key. + + + +Selecting +FramesDelete +Frame from the menubar + + + +While the cursor is on the border of the frame you want to delete, +click once with the &RMB;. A small menu will appear. Select Delete +Frame. + + + + + + + +Moving a Frame +framesmoving + +Moving a frame around on the page is easy. + +Begin by clicking on the text frame border of the frame you want +to move. (Or holding down the &Ctrl; key and clicking inside the frame with the +&LMB;.) + +There are now 8 squares on the edges of the frame. + +Click and hold the &LMB; on the border again and drag the cursor in the direction you want to move the +frame. + +You will see an outline of the frame as you move it. When the +outline is where you want it, release the mouse button. + +A faster way to move the frame, can be done by holding down the +&Ctrl; and &Shift; keys on the keyboard and click and hold with the &LMB;. Drag +the mouse cursor on the page and when the frame is in the correct location, release +the &LMB;. + + + + + +Resizing a Frame +framesresizing + +It is also easy to change the size or shape of a frame. + +Begin by clicking on the text frame border of the frame you want +to change. (Or holding down the &Ctrl; key and clicking inside the frame with the +&LMB;.) This selects +this frame as the current frame. + +There are now 8 squares on the edges of the frame. By moving +these squares, you will be able to drag the frame border(s) to a new +location. + +Each square will move a different combination of borders. + + + + + + + + +As an example: To move the bottom border of a frame, place the +mouse over the box at the six o'clock position in the frame. When the +mouse is over the box, it will change to a double headed arrow. + +Now click with the &LMB; +and hold the button down. As you move the mouse up and down on the +page, you will see that the frame changes shape to match the movements of +the mouse. When the bottom edge of the frame is at the new location, +simply release the mouse button, and the changes will become +permanent. + + +If you are using a Text Oriented Template, you cannot change +the size of the primary frame by dragging the edges of the frame. If you +want to resize this frame, you must do so by Changing the margins + + + + + +Reconnecting Frames in a Frameset/Changing text flow. +framescreate/edit framesets + +Normally, each new text frame is created with a specific +purpose. Sometimes, however, as the document is changed, changes to the text flow +will need to be made. To accomplish this, you will need +to know how to move a frame from one frameset to another. + +First click on the frame border of the frame you want to +move to another frameset. + +You can change the frameset of the currently selected frame by +selecting +FramesFrame/Frameset Properties +from the menubar + +You can also accomplish this by clicking on the frame border once with the &RMB;, and selecting +Frame/Frameset Properties... from the popup menu. + +This will bring up a dialog box with five tabs. Select the tab +labeled Connect Text Frames. + +You will be presented with a list of framesets. Simply select the new +frameset. + +When you click OK, the currently selected frame will be added +to that frameset. + + + +Raise and Lower Frames +framesraise +frameslower + +When two frames occupy the same place on a page, they must overlap. +When they overlap, one frame sits above the other frame. +You can raise and lower the frames to change which frame sits above the other frames by using four commands. + + + +Bring to Front +To raise a frame, select the frame by clicking once on the frame border with the &LMB;. +Select +FramesBring to Front + from the menubar. +This will place the frame on top of all other frames that it overlaps. + + + + +Raise Frame +To raise a frame, select the frame by clicking once on the frame border with the &LMB;. +Select +FramesRaise Frame + from the menubar. +This will move the frame up one level of any frame that it overlaps. +Pressing &Ctrl;&Shift;R is the +same as selecting Raise Frame from the menubar. + + + + +Send to Back +To lower a frame, select the frame by clicking once on the frame border with the &LMB;. +Select +FramesSend to Back + from the menubar. +This will place the frame below all other frames that it overlaps. + + + +Lower Frame +To lower a frame, select the frame by clicking once on the frame border with the &LMB;. +Select +FramesLower Frame + from the menubar. +This will move the frame down one level of any frame that it overlaps. +Pressing &Ctrl;&Shift;L is the +same as selecting Lower Frame from the menubar. + + + + + + +Hard Frame Breaks +framesframe breaks +page breaks + +A hard frame break is a special formatting character. It is +invisible on the final printed output. + +The purpose of a hard frame break, is to force all the +text that follows it into the next frame in the frameset. + +If we have the following sentence: We have nothing to +fear but fear itself + +and we insert a Hard Frame Break, just before the word +but, we will end up with one frame containing We have nothing +to fear, and the next frame in the frameset beginning with +but fear itself. + +To add a Hard Frame Break, you should first place the keyboard +cursor where you want the break to be located in the document. + +A Hard Frame Break can be inserted one of two ways: + + + +Select InsertPage Break from the menubar + + + +You can use the keyboard shortcut: +CtrlReturn + + + +If you want to remove a Hard Frame Break, you simply delete it +like you would any other character. +Since this is not a character that +you can normally see in &kword;, it will be easier to delete a Hard Frame Break with the following procedure. + + + +Select +ViewFormatting +Characters from the menubar. This will make the breaks visible. + +Find the newly revealed Page Break, labeled --- Frame Break ---. + Place the mouse pointer in +front of this and click once with the &LMB;. This will place the cursor directly in front of the page break. + +Now press the Delete key. + + + + + diff --git a/doc/kword/framestylist.png b/doc/kword/framestylist.png new file mode 100644 index 00000000..9f6b059e Binary files /dev/null and b/doc/kword/framestylist.png differ diff --git a/doc/kword/fundimentals.docbook b/doc/kword/fundimentals.docbook new file mode 100644 index 00000000..2556809d --- /dev/null +++ b/doc/kword/fundimentals.docbook @@ -0,0 +1,178 @@ + + + + +Mike +McBride + + + + + +Fundamentals +This section of the documentation discusses starting &kword;, introduces the user to templates and +discusses an important difference between two major types of templates. + + + +Starting &kword; +starting &kword; + +&kword; can be started one of four ways: + + + +You can select &kword; through the system menus, under: +K-ButtonOffice +KWord. + + + +If you are in a terminal program (&konsole;, Xterm, &etc;), you can type: +$ kword & + +Or + +$ kword filename & + + + +Using &konqueror;, you can click on your data file (&kword; +documents end in .kwd). This will +automatically start &kword; and begin editing the file. + + + +Using the &koffice; Workspace. + + + + + + + +An Introduction to Templates +templatesintroduction + +OK, so the first question a new user may have is: + +Why do I need to use a frames based word processor, when +I am perfectly happy writing my letters on my current (page layout) word +processor? + +Well the good news is, adjusting to a frames based word processor +is easy and once a template is selected, &kword; can act just like a +page layout word processor. There are templates +available for simple correspondence and day to day use. + +When a more complex document (newsletters, +posters, &etc;) needs to be created, you will not need to switch to a different +application to generate these special documents. There are templates in +&kword; which will help generate newsletters or other more +complicated documents. + +What are templates and what can they do for +the user? + +A template can be thought of as an initial mold for a document. + +When a user sits down to write a document, they already have an idea of +what the final product will look like. If they are writing a letter to a +business, a document with only one column, which goes all the +way across the page, and from top to bottom of the page is appropriate. When a user sits +down to author a newsletter for a local organization, however, they may +want a large title across the top, and several columns for quick news +articles. + +With &kword;, this predetermined notion of how the +document should look is used to select a template. By using a template, +a set of frames is created to approximate this final layout. For +a business letter, a document with one large frame that covers the +page from top to bottom and side to side would be selected. +For a newsletter, however, a two or +three column document is more appropriate. Once this +template is selected, &kword; will create the frames automatically. + +What if the user decides to change the +layout after a template is selected? + +This is not a problem. If a document begins as a single +column document and it is decided later that two columns is better, another column can be added. +The purpose of templates is not to +limit the ability to change the layout of a document, but rather to take some of the +work load off the user whenever possible. Choosing the correct template when +beginning a document will simplify the formatting (as opposed to +always selecting the default template and making changes later). +Choosing the wrong template +will not limit the flexibility of the document later on. + +The next section, consists of one more important topic which +you should understand before we begin using &kword;. + + + + + +The difference between Text Oriented and Page Layout +templates +templatesText oriented/Page Layout + +It is vital that the +difference between Text Oriented and Page Layout templates is clear in +your mind. + + + +Text Oriented + +The Text Oriented templates are designed to act like page-oriented +word processors. When you select a Text Oriented template, you will +create a template with one or more frames. The first frame is distinctly +tied to the paper size of your document. When you increase or decrease +the paper size or change the margins, the frame size is automatically +adjusted. You are not able to move this frame +around on the page and you cannot delete this frame. If you need to +adjust the size or position of this frame, you must adjust the margins. On top of the first +frame, you can, of course, add additional frames. These frames can +contain pictures, text or whatever you want. These new frames can be +moved, re-sized and deleted to suit your needs. If you want it, &kword; +will even wrap the text from the first frame around any information in +any subsequent frames. + + + + +Page Layout + +These templates are designed for desktop publishing. When you +select a template from this class, all of the frames are created +equal. This is where the difference between Page Layout and Text +Oriented template lies. None of the frames in a Page Layout template are +tied to the page as tightly as the main frame in a Text Oriented +template is. Each of the frames is independent of the page size, and can +be moved or re-sized without changing margins, &etc; Of course this also +means that altering the margins or paper size of your document requires +that you individually move/resize each frame. + +In addition to not having a main text frame, Page Layout +documents cannot use the automatic headers or footers (though these can be +added in as frames). Additionally, footnotes must be managed by hand while +in Page Layout Mode. + + + + + +As you can see, the choice between Page Layout and Text Oriented +templates is a choice between flexibility (Page Layout) and convenience +(Text Oriented). You can create any document you like with either type +of template. + +If the concept of templates is still unclear, please follow along +with the following tutorial. The first document you create will use a +Page Layout template. This should help clarify exactly how templates +function. + + + diff --git a/doc/kword/graphics.docbook b/doc/kword/graphics.docbook new file mode 100644 index 00000000..6e46b5ec --- /dev/null +++ b/doc/kword/graphics.docbook @@ -0,0 +1,238 @@ + + + + +Mike +McBride + + + + +Graphics +graphicsintroduction + +&kword; is very good at handling textual information. &kword; can also be used to incorporate +graphical images with text. +A source of great clipart that is free to use is the Open Clip Art Library. This project has a large collection of vector graphics indexed and sorted by category, all released into the public domain. +Pictures can be inserted into a document as either framed or inline images. +Framed images are pictures that have a frame around them. The frame around a picture functions +exactly the same as a frame around text. It contains the picture and determines the size and shape of the picture. +An inline image has a frame around it, but this frame is inserted within the current text +frame. If text is inserted in front of the picture, the picture travels down the frame just like any text would. This means the picture will +stay in the same area of the page as the text that surrounds it. +Framed pictures, on the other hand, need to be moved by hand on the page. + +&kword; can use pictures already stored in a file or acquire an image from a scanner. +Insert Graphics from a file +graphicsinserting + +There are three ways to insert a picture into a document: + + +By selecting +InsertPicture... from +the menubar + + + +Using the keyboard shortcut: &Shift;F5 + + + +or by clicking on the toolbar. + + + +All three methods open a file selection dialog. + + + + + + + +Use this dialog to select the picture. + +Pressing Esc at this point will cancel the insertion of a picture into your document. + +Once the appropriate picture file is located, click on the filename once with the &LMB;. Click +OK to continue. +A new dialog box appears. + + + + + + +The right half of this dialog box contains a preview window. The picture should be visible in this window. +The left part of this box contains one button and two check boxes. + + +Choose Picture... +Click this button and &kword; will open a +new file dialog to choose a different picture. + + +Insert Picture Inline +If there is a mark in this check box, the picture will be an inline picture. If there is no mark, a new frame will be +created. For details on the differences, see the introduction. + + +Retain original aspect ratio +Aspect ratio is defined in the &kword; glossary. +If a there is a mark in this check box, &kword; will not allow any change the aspect ratio of the picture. This prevents +inappropriate stretching and compressing of the image. It will still be possible to change the overall size of the image, but it +will not be possible to change the horizontal measurement without also changing the vertical measurement. +If there is no mark in this check box, the horizontal and vertical sizes of the picture can be changed independently. + + + +To insert the picture, click OK. To abort the picture entirely, click Cancel. +If an inline picture was selected, click with the mouse in the appropriate location. The picture will be inserted. +If a framed picture was selected, the mouse cursor will change to crosshairs. Locate one corner of the location of the new picture +frame with the mouse. Click and hold the &LMB; down. Drag the cursor to adjust the size of the picture frame. When the size of the +picture frame is correct, release the &LMB;. &kword; will insert the picture into the frame, and resize the picture to fit within the +frame. + + +Using a picture from a scanner +A complete discussion of how to operate a scanner is beyond the scope of this documentation. This document will confine itself to the controls available in &kword; but will not +go into detail on the use of these controls. +To use a scanner to insert a picture into your kword document, begin by selecting +InsertScan Image... from +the menubar. + &kword; will open a dialog box for you to choose your scanner. Simply click on the radio button to the left of your scanner. Then click OK. This will bring up the scanning dialog: + + + + + + + + +You should begin by selecting the image type that you want to scan and the resolution. First determine the picture type using the drop down box labeled +Scan Mode. You can choose between Color, Greyscale or Binary image. +If you want to select a different scanner, click the Source... button. +If you have selected a Binary image, you can use the drop down box labeled Halftoning to select your halftone protocol. +Select your resolution using the drop down box labeled Resolution +Now place the object you want to scan in the scanner and click Preview Scan. Your scanner will take a low resolution +scan and preview it in the window in the far right of the dialog +Using your mouse, click on the upper left corner of he area you want to scan with the &LMB; and hold the button down. Drag the mouse down and +to the right to create a box for a high-resolution scan. When you have an appropriate sized box, release the &LMB;. Once the box is drawn, you +can adjust the selection box using the mouse. +You can refer to the box to the left of the preview window labeled Selection. This box will show you the height and +width of your selection and the amount of disk space you will need to store this image in the &kword; file. +Once you are satisfied with the size and position of the selection box, click Final Scan. The scanner will scan the selected area at the resolution you selected. +When the scanner is finished, click Close to close the dialog box. Your cursor will now be crosshairs. Using this cursor, draw the size and position you want your picture on the +page. The scanned image will be inserted in a separate frame. You can now adjust the size of the picture by changing the size of the frame +Adjusting the image prior to final scanning +You can use the lower left part of this dialog to adjust your image prior to scanning. +By moving the slider bar labeled Threshold you can adjust the cutoff point of white in the scanned image. +By moving the slider bars labeled Brightness and Sharpness you can adjust the relative brightness and the sharpness of the scanned image. +The preview window will not show you the effects of changes to your scanned image in the preview window. +You can select from one of three pre-defined gamma tables or you can select the User defined option from the drop +down box labeled Use custom gamma table. If you selected User defined you can click the Edit... +to alter the Brightness, Contrast and Gamma for your customized gamma table. + +Adjusting the preview scan size +If you know the size of the object you are scanning, you can select the preview area from the drop-down box labeled Scan size. You can also use the radio buttons +labeled Landscape and Portrait to change the orientation of the preview area. +Changing the orientation between portrait and landscape does not change the orientation of the scanned text or image. + +Using auto-selection +&kword; can try to automatically select the object you want to scan. It does this by looking for an area within the preview window that seems to +define an object in the picture. By default this option is disabled. You can enable autoselection in this dialog. +The autoselection area of the dialog is located just to the left of the preview window in the middle of the dialog box. It consists of three controls: + + +Checkbox +If a mark is placed in the checkbox, auto-selection is enabled. + If there is no mark in the checkbox, then auto-selection is disabled. + + +Drop down box +This drop down box contains two possible choices: Black and White. If +Black is chosen, then &kword; will look for an area surrounded by black to select automatically. +If White is chosen, then &kword; will look for an area surrounded by white to select automatically. + + + +Slider bar labeled Threshold +By adjusting this slider bar, you determine the threshold auto-selection uses to determine the area to select automatically. + + + +Miscellaneous scanning options +There are two additional options for scanning that are accessed by clicking on the Options tab. + + + + + +The checkbox labeled Ask for the scan device on plugin startup toggles the scanner selection dialog on and off. If there is a mark in this +checkbox, &kword; will ask you to select your scanner each time you insert a scanned image into your document. If there is no mark, then &kword; uses the previously +selected scanner. If you have access to only one scanner, or you only use one scanner, you should remove any mark from this box. +The checbox labled Query the network for scan devices is also used to select scanners. If there is a mark in this checkbox, +&kword; will check your local network for scanners that are avaialbe. If there is no mark in this box, &kword; will only look for scanners connected directly to +your machine. +To save these options, click Close. + + + + +Changing the size of a picture +graphicschange the size of + +Resizing a picture is done by changing the size of the frame that surrounds it. &kword; will automatically change the picture to fill the +entire frame. +For information on changing the size of a frame, see Resizing frames. + +Move Pictures +graphicsmoving + +The only way to move an inline image around on the page, is to alter the flow of the text that surrounds it. If this +is causing problems, the picture can always be changed to a framed picture. +To move a framed picture in &kword; is the same as moving any frame in &kword;. + + +Delete Graphics +graphicsdeleting + +To delete a graphic in &kword;, simply delete the frame around it. + +Saving Graphic in separate file +graphicssaving in a separate file + +You can save a picture or graph to a separate file (for use in another document or to archive the graphic). +Simply click once on the graphic with the &RMB;. A popup menu will appear. Select Save Picture.... +A dialog will appear that will allow you to specify where to save the graphic. +This does not remove the picture from the &kword; document file. It is simply a way to extract a picture from a +document so it can be archived or used in another application. + + +Switching between inline and framed pictures +graphicsswitching between inline and framed + +Switching between inline pictures and framed pictures is easy in &kword;. +Change an inline picture to a framed picture +To change in inline picture to a framed picture, click on the desired picture with the &LMB; once. This selects the frame +of the picture. +Now click and hold with the &RMB; and a popup menu will appear. In this menu, is an item labeled +Inline Frame, with a mark in front of it. Select this option by clicking with the &LMB;. +The frame is now +an independent and can be moved around freely. + +Change a framed picture to an inline picture +To change a framed picture into an inline picture, click on the desired picture with the &LMB; once. This selects the frame +of the picture. +Now click and hold with the &RMB; and a popup menu will appear. In this menu, is an item labeled +Inline Frame. Select this option by clicking with the &LMB;. +&kword; has now converted this to an inline frame. +&kword; tries to make a reasonable estimation of where in the text the inline image should be inserted. + + + + + diff --git a/doc/kword/headerfooter.docbook b/doc/kword/headerfooter.docbook new file mode 100644 index 00000000..25221cd6 --- /dev/null +++ b/doc/kword/headerfooter.docbook @@ -0,0 +1,57 @@ + + + + +Mike +McBride + + + + +Headers/Footers +headersusing +footersusing + +Introduction +With multi-page documents, you might want to provide certain +information at the top or bottom of each page throughout the document. +Headers or footers can provide the reader with important information and they tie your +documents together visually. + +Headers and footers are special frames. +You can edit the text and data within the headers and +footers just as you would any other text frame. What makes headers and footers +different from most other frames in &kword; is that they are automatically created at the top and bottom +of each page. + +Headers and footers are only available when using text oriented templates. + +Using headers and footers +You can toggle headers and footers on and off independently at any +time. + +You can toggle the headers by selecting +FormatEnable/Disable Document Headers +from the menubar. + +You can toggle the footers by selecting +FormatEnable/Disable Document Footers +from the menubar. + +The footers will be +added below the margins you set under page setup. The text within the +main frames will be moved so the headers and/or footers do not overlap +any text. + +Since headers and footers are simply text frames that are placed on each page, you can use all of the +tools and techniques you are familiar with to create your header and footer information. + +For more information on options for headers and footers, see the section on +Formatting the page. +For information on page numbers see the section on Page Numbering. +For information on formatting the frame, see the section on +Setting the Properties for a Frame. +For an example of how to place the page numbers on the outside of even and odd pages, see the +How do I? section. + + diff --git a/doc/kword/incindbut.png b/doc/kword/incindbut.png new file mode 100644 index 00000000..0ecefb2f Binary files /dev/null and b/doc/kword/incindbut.png differ diff --git a/doc/kword/index.docbook b/doc/kword/index.docbook new file mode 100644 index 00000000..3a07e5c8 --- /dev/null +++ b/doc/kword/index.docbook @@ -0,0 +1,1852 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]> + + + +The &kword; Handbook + + +Mike +McBride + + +Gary +Cramblitt + +
    garycramblitt@comcast.net
    +     +     + +     + +2000-2006 +Michael McBride + + +2006 +Gary Cramblitt + + +&FDLNotice; + +2006-04-23 +1.5 + + + +&kword; is a complete word-processing and simple desktop publishing program. It is part of the +&koffice; suite of utilities. + + +This manual describes &kword; 1.5. + + + + +KDE +KWord +KOffice +word processing + + +     + + +Introduction + + +Introduction +introduction + +&kword;, is a full featured + +WYSIWYG (What You See Is What You Get) +Word-processor/Desktop Publishing Program. + + +&koffice;applications +&kword; is part of the &koffice; productivity suite for the K Desktop +Environment. Other applications in &koffice; include: + + + +&kspread; (A spreadsheet application.) +&kpresenter; (A presentation creator.) +&karbon14; (A vector drawing program.) +&kivio; (A flowchart creator) +&krita; (A pixel based drawing program.) +&kugar; (A report generation tool.) +&kexi; (An integrated environment for databases.) +&kchart; (A chart and graph creator.) +KPlato (An integrated project management and planning tool.) +and a simple integrated office desktop, to help organize your +work. + + + +All &koffice; applications were designed from the beginning to take +advantage of the features of &kde;. Because of this, &kword; (like +all of &koffice;), supports many advanced features you expect from todays desktop environment. + + + +&kword; is a word-processor which can work either as a traditional word +processor, or as a simple but powerful desktop publishing +application. This is possible because &kword; is a frame oriented word +processor, not a page oriented word processor (&Microsoft; +Word,&Wordperfect; +and Applixware are all page oriented word +processors). + + + +Frame oriented word processors work by creating one or more +frames per page. Each frame acts as a boundary (like +a frame which surrounds a photograph), which limits the text to the +boundaries of the frame. You can move and re-size boundaries to define +exactly where on the page the text will be placed. As you re-size +frames, the text is reworked to fit within these frames. + + + + + + +Button + + + +You can easily connect one frame to the next. When +you connect two frames, any text which does not fit within the first +frame, flows easily and automatically into the next. + + + + +Button + + + +In addition to text, you can include virtually anything inside a frame. +A frame can contain a spreadsheet, pictures, a database form, +or nearly any piece of data. Since each page can have any number of +frames, documents can appear quite sophisticated while still remaining +easy to edit. + + + +&kword; users also benefit from the auto wrap features of &kword;. When +you place one frame on top of part of another frame, the text from the +lowest frame can be automatically wrapped around +the newly created frame. This reformatting occurs in a +WYSIWYG Graphical User Interface, and happens +automatically while you edit. + + + + + + +Button + + +&kword;features + +As a word-processor, &kword; includes the most used options of many other +word processors, while maintaining a simple interface. In addition to +the features you expect from a modern word-processing package (text +entry, bold face, italics, text alignment, text printing, &etc;), +&kword; can: + + + + +Use predefined templates, to generate complex document layout with +one click of the mouse. As a user, you can build your own templates, +download templates from the web, or use the current document to create a +new template. + + +&kword; provides automatic numbering of lists and automatic bulleting of lists with any character or shape you want. + + +Define paragraph layout styles, frame layout styles and table layout styles, to shorten the editing time of +your document, and ensure consistency throughout a long document. + + +Edit headers and footers for your documents. You can have +different headers for even and odd pages, or the same headers +throughout. + + +Search through your document for text. You can further refine +your search by specifying font, format, font size and many other +features of the text. By adding wild-cards to your search, the search and +replace functions can become very powerful. + + +Footnotes and Endnotes. &kword; has all the tools necessary to manage footnotes or endnotes. + + +Tables. You can either use the table formatting capabilities of +&kword;, or you can import any spreadsheet from &kspread;. + + +&kword; has built in support for KParts. KParts allows you to +insert any spreadsheet, picture, chart, graph, document, or any other +data type from any &koffice; application. You are free to edit that +KPart using the tools designed for that task, without needing to start +the application at all. + + +&kword; can zoom in or out to make the editing of your documents +easier on any computer, and with any font size. + + +&kword; supports customizable toolbars and menus. + + +&kword; has extensive internationalization support including right-to-left and left-to-right text flow. + + +You can embed formulas directly into &kword; using the integrated +formula editor. + + +You can have &kword; auto-correct many of the most common spelling and punctuation mistakes. + + +&kword; can check the spelling of your document. &kword; can automatically mark misspelled words as you type. + + +You can access an on-line thesaurus (English only) to find the exact word you are looking for. + +&kword; can automatically create a table of contents, and keep it up to date. + + +&kword; has optional autocompletion for commonly used words. + + +&kword; has support for document bookmarks, to easily navigate large documents.. + + +&kword; has support for Internet hyperlinks and email addresses. + + +&kword; has the ability for proofreaders to make comments about portions of the text. These +comments are stored in the &kword; file, and can be changed or deleted easily. + + +&kword; can merge data from an outside database, spreadsheet, document or text file to create mailinglists, form letters, invoices, etc. + + +&kword; can load and save documents from other wordprocessing programs with an extensive list of filters. + +&kword; can create PDF files. + + +You can edit one document from multiple views. This allows you to have several windows open on +one document. Edits in one window are immediately updated in the other window. + + +&kword; can surround your frames with borders and you can set the background color of each frame separately if you want. + + +&kword; has several accessibility features, including the ability to speak all or part of +a document using Text-to-Speech (KTTS) and manipulate documents using the keyboard only. + + + + +The best part about &kword;, is the effort that has been placed to +make &kword; a productive tool for all your needs from the simplest +letter, to the most complex document you might need to work on. + + + + +What parts of this guide should I read? +getting started + +Anyone who has looked at the table of contents has surely come to +the conclusion that reading this manual from cover to cover, is an +unreasonable (and fortunately unnecessary) task. + +This user guide is designed to be helpful to a wide variety of +users, from the very experienced, to the novice user. Since different users will have different needs, each section of +this manual is self-contained. The user is not expected to have read all of +the previous sections of the manual to find the instructions +useful. + +To help determine what +should be read before starting to work with &kword;, a suggested +reading list for three levels of users is given below. + +If each of these sections is read before + starting to use &kword;, using &kword; will be easier. + + + +     + +Experience Level +Previous Experience +What you should read + + + + + +Novice +No previous computer experience + + +Fundamentals +Step by Step Tutorial +The &kword; Screen +Document Storage and Printing +Editing Your Document +Introduction to Menu Bars and Toolbars +The difference between Text Oriented and Page Layout templates + + + + + +Intermediate +Comfortable with other page based word processors (&Microsoft; +Word, Word Perfect +or Applixware.) + +Fundamentals +Step by Step Tutorial +The difference between Text Oriented and Page Layout templates + + + + +Advanced User +Comfortable with other frames based word processors (Frame Maker, +&etc;). + +The difference between Text Oriented and Page Layout templates + + + + +These sections will help with the basic information. As other specific questions or situations arise, the +other sections of this manual can be used as a reference. + +Obviously this will not cover everyone's needs. Please use it as a guide to help +determine which parts of the manual will be helpful to read before you begin using &kword;. + + + + + + +&fundamentals; +&tutorial; +&basics; +&storeprint; +&editing; + + +Detailed Guides: Document Layout + +This section of the guide is designed to help the user with the format and layout of their +documents. The section will begin with information on changing the size and shape of the page +and the margins, and work progressively through smaller and smaller +blocks of text (frames, then paragraphs, then characters). At each level, all of the format and +layout options will be explained. + +After discussing the formatting of individual characters, the manual will elaborate on styles +(to provide consistent formatting through the document), lists, multi-column documents, tables and finally the use of headers +and footers in a document. + +The final part will show you how to save a document as a template for future documents. + +&pageformat; +&frames; +&formatframe; +&formatpara; +&tabstops; +&formatcharacters; +&styles; +&columns; +&lists; +&tabls; +&headersfooters; +&templatecreation; + + +Detailed Guides: More than just text +Up to this point in the documentation, we have been focusing on text. That is about to change! +This chapter will discuss inserting a table of contents, graphics, page numbers, links to web pages and how to +insert other types of &koffice; data into a document. +This chapter will also cover document information and its relationship to document variables. +Entering Document information +document information +&kword; can store information about the author and the document in the same file as the text and data of the document. +Entering this information into &kword; has two potential benefits: + +This information will always be available for reference. This is especially important in situations where +there are many possible authors (employees) and hundreds (or thousands) of documents. +The information supplied here, can be inserted automatically into the document as a +document variable. + +To enter document information, simply select +FileDocument Information... + from the menubar. This will bring up a dialog box with two tabs. +The first tab is labeled General. Enter a document Title, Subject lines, Keywords and an Abstract. +The bottom of this page displays the Type of the document, the date of the creation and modification, the last printing date, the Total editing time and the Revision number. Click on Reset to clear all data and set the actual date as creation date. +Both the document Title and the Abstract can be accessed throughdocument variables. +The second tab is labeled Author and has blanks to enter the authors name, Initials, Title, Position, Company and contact information (email address, telephone numbers and physical address). +Every value entered in this dialog can be inserted as a +document variables. +At the bottom of the dialog is a button labeled Load From Address Book. Clicking on this button will automatically insert your information contained in the &kde; address book into this &kword; document information dialog. +You must inform the &kde; address book which entry corresponds to your information. +To do this, open the &kde; address book, select the entry that contains your name and address. Now select +EditSet as Personal Contact Datafrom the menubar in the &kde; address book. This only needs to be performed once. +&kword; will now insert the entered information when the Load From Address Book button is clicked. +The second button Delete Personal Data allows you to remove all data of the entries on this page. +When finished entering the information, click OK to apply the changes. +If any document variables were changed, &kword; will update their values throughout the document. + +&graphics; +&toc; +&variables; +&expressions; +&links; +&comments; +&footend; +&parts; +&insfile; +&bookmarks; +&formulas; + + + + +&a11y; + + +Advanced Topics +The sections that are included in this chapter are for advanced users. The instructions for these sections +will assume you are familiar with the basic operation of &kword;. +&struct; + +&mmerge; + + + + + + +How do I... +The next part of &kword; documentation is designed to provide examples on how to solve specific +problems using &kword;. +Each section is a self contained list of steps, and refers the reader to other sections of the documentation +for more complete information on different aspects of &kword;. +These examples were selected to: + +Show how &kword; might function differently from other word processors you are used to. +Show how to combine several elements to create the desired document. +Illustrate the power of &kword;. + +You can use these examples as recipes for your document, or modify them to create the look or content +you desire. + +How do I get the pages numbers on the outsides of the pages and +the title in the middle of the header (like a novel)? +insert page numbers + +This first example shows how you can combine center tabs and variables in a header to create a common format to your document. +Your document must be at least 2 pages long before you begin this procedure. + +Select FileDocument Information +from the menubar. +Click on the General tab. +Click once in the text box labeled Title with the &LMB; and enter +the desired document title. +Click on the OK button. +Select FormatPage Layout... +from the menubar. +Click on the Header & Footer tab. +Select Different header for even and odd pages. +Then click OK. +Select FormatEnable Document Headers +from the menubar. +Move to an odd numbered page in your document, and click in the header box. +Select FormatParagraph... +from the menubar. +The Paragraph Settings dialog will appear. Click on the Tabulators tab. +Click the New button. +Using the arrows of the spinbox labeled Position enter a value that is exactly 1/2 the frame width. The frame width is + listed directly below the Position spin box. +Click the Center radio button in the section entitled Alignment. + +Click the New button again. +Using the arrows of the spinbox labeled Position enter a value that is slightly less than the frame width. The frame width is + listed directly below the Position spin box. +Click the Right radio button in the section entitled Alignment. + +Then click OK. +Click in the header again with the &LMB;. +Type the key. This will move the cursor to the center of the header. +Select InsertVariable +Document InformationDocument Title +from the menubar. +Type the key again. This will move the cursor near the right margin of the header. +Select InsertVariable +PagePage Number +from the menubar. +Move to an even numbered page in your document, and click in the header box. +Select FormatParagraph +from the menubar. +The Paragraph Settings dialog will appear. Click on the Tabulators tab. +Click the New button. +Using the arrows of the spinbox labeled Position enter a value that is exactly 1/2 the frame width. The frame width is + listed directly below the Position spin box. +Click the Center radio button in the section entitled Alignment. +Then click OK. +Click in the header again with the &LMB;. +Select InsertVariable +PagePage Number +from the menubar. +Type the key. This will move the cursor to the center of the header. +Select InsertVariable +Document InformationDocument Title +from the menubar. + +That completes the procedure. Your document now has the title of the document in the center along the top of each page, and +the page numbers on the outside corners of the pages. +If you want page numbers on the bottom of the pages, you can use Footers instead of +headers in your document. + + + +How do I create a <literal role="extension">.pdf</literal> file? +creating a PDF file +PDF, creating + +&kword; differs slightly from other word processors here. Instead of saving your file as a +.pdf file, you print your file to create the +.pdf file. +When you are ready to create a .pdf file from your document: + + +Select FilePrint +from the menubar. +This will bring up the Print dialog. +In the combo box labeled Name, select Print to File (PDF) +Enter your desired filename in the Output file: text box. +If you wish to make any changes to the PDF formatting, select Properties. +A complete explanation to all these properties, is beyond the scope of this document. +Click OK. + +Your PDF file will be created and saved at the location specified in Output file. +For more information on printing in &kde;, visit The &kde; Print web page. + + + + +How do I remove template categories from the startup dialog. + +Templates can only be removed using the Create Template dialog. For instructions, click +Removing template group. + + + + + + +&mbtb; +&opt; + + + +Questions and Answers +FAQ + + + + +When I try to load a document or picture, it does not appear in my dialog +box, but I know I saved it there. Why can I not see it? + + +Check to make sure that you have selected the correct file type in the open dialog box. +If you save a file in one format, but ask +&kword; to show you the files from another format, you will not see your saved file. + + + + + +What is a kwd file? +What is a kwt file? + + +A kwd file is a &kword; document. +A kwt file is a &kword; template file. + + + + + +Where can I get updates? + + +For updates to &kword; you should always check the following sites: +The &koffice; website (http://koffice.kde.org) is the first place to look for updates. +Any software updates, bug fixes or announcements of new releases of &koffice; will be found here. +Addons for &koffice; can be found at http://koffice.kde.org/addons/. + + + + + +How do themes affect &kword;? + + +&kword; (like all of &koffice;) is completely themeable. You can use any QT or &kde; theme to customize the look of &kword;. + + + + + +Can I use &kword; to read &Microsoft; Word files? + + +&kword; does have the ability to import &Microsoft; Word files. The conversion process is not perfect, +and some formatting information will be lost. For more details please refer to the +Import/Export Filters section of the documentation. + + + + + +Can I save my &kword; document as a &Microsoft; Word file? + + +At the moment, &kword; does not yet provide support for exporting to &Microsoft; Word +documents. If you need to exchange documents with MS Word, +you should use Rich Text Format as an intermediate file format. +Rich Text Format files +are converted well by both &Microsoft; Word and &kword;, + + + + + +Can I save my &kword; document as a PDF file? + + +Yes. Instructions on creating a PDF file are found +here. + + + + + +I have to exchange documents with a friend who does not have &kword;; what is +the best way to do this ? + + +What you and your friend need to do is agree on a file format that both word processors +can read and write effectively. Rich Text Format is probably a good choice. + + + + + + + + +Credits and Licenses +creditsoptions +licensesoptions + +&kword; Copyright 1999-2005 by The &kword; Team + + +&kword; Developers (Alphabetically) +Dag Andersen danders@get2net.dk +John Califf jcaliff@compuzone.net +Frank Dekervel frank.dekervel@student.kuleuven.ac.be +Krister Wicksell Eriksson krister.wicksell@spray.se +&David.Faure; &David.Faure.mail; +Nicolas Goutte goutte@kde.org +Shaheed Haque srhaque@iee.org +&Simon.Hausmann; &Simon.Hausmann.mail; +Nash Hoogwater nrhoogwater@wanadoo.nl +&Stephan.Kulow; &Stephan.Kulow.mail; +Sven Lüppken sven@kde.org> +Laurent Montel montel@kde.org +&Daniel.Naber; &Daniel.Naber.mail; +Reginald Stadlbauer reggie@kde.org +Werner Trobin trobin@kde.org +Torben Weis weis@kde.org +&Joseph.Wenninger; jowenn@kde.org +Thomas Zander zander@kde.org + + + + +&kword; Import/Export Filter Developers (Alphabetically) +Enno Bartels ebartels@nwn.de +Wolf-Michael Bolle +&Matthias.Kalle.Dalheimer; kalle@dalheimer.de +Clarence Dang dang@kde.org +Frank Dekervel frank.dekervel@student.kuleuven.ac.be +Nicolas Goutte goutte@kde.org +Tomasz Grobelny grotk@poczta.onet.pl +Shaheed Haque srhaque@iee.org +Ariya Hidayat ariya@kde.org +Robert Jacolin rjacolin@ifrance.com +Michael Johnson + +Ewald Snel ewald@rambo.its.tudelft.nl + + + +&kformula; developers +Andrea Rizzi rizzi@kde.org +Ulrich Kuettler ulrich.kuettler@mailbox.tu-dresden.de + + +Documentation by &Mike.McBride; + + +&underFDL; +This program is licensed under the terms of the &GNU; Library General +Public License v2. + + + + + + +Installation +&kword;installation + + +How to obtain &kword; + +&kword; is part of the &kde; project http://www.kde.org. &kword; is located +in the &koffice; package which can be obtained from &kde-ftp;, the +main ftp site of the &kde; project. + +Many distributions offer precompiled binaries on their ftp sites. Please check your distribution's web sites for more information. + +If you want to compile &kword; from source, then you should read through the next few sections for help on compilation. + + + + +Requirements +&kword;requirements + +In order to successfully use &kword;, you need: + + + +&Qt; Toolkit 3.2 or later. This can be obtained from Trolltech. +While &koffice; will compile and run with any version of &Qt; 3.2 or later, it is recommended that you compile and install +&Qt; 3.3.4 to take advantage of all the bug fixes (including some security fixes) that have occurred. + + + +&kde; 3.3.0 libraries (kdelibs) and the &kde; 3.3.0 base package +(kdebase). These can be obtained from the &kde; web page. +While &koffice; will compile and run with any version of &kde; 3.3.0 or later, it is recommended that you compile and install +&kde; 3.4 to take advantage of all the bug fixes that have occurred. +It is also recommended that you install the arts package 1.3.2 from the +&kde; &FTP; site. + + + +&GNU; c++ compiler or any c++ compiler that supports exceptions. For help on obtaining this, please refer to +your distribution's web site. + + + +autoconf 2.53 or later and automake 1.7 or later + + + +In order to use external databases for mail merging documents, you must have +the QT toolkit compiled with SQL support. To add SQL support (as a plugin), simply include + in your configure line. +driver should be replaced with mysql, odbc, +CVS, or psql as is appropriate for your database needs. + + + +Compilation and Installation + +Complete instructions on installing &koffice; from source are located at +http://www.koffice.org/download/source.php. + + + + + +&kword; Command Line Options +&kword;command line options + +You can specify some initial actions for &kword;. The most +commonly used options are discussed below with instructions on finding +help on the rest of the command line options. + +Specifying the file name + +Probably the most common command line option used is to specify +the file to edit. + +The format for specifying the file name is: + + +$ kword filename + + +Example: + +$ kword Resume.kwd + +This will cause &kword; to load Resume.kwd for editing. + +Show &kword; version + +To see the version numbers for the QT toolkit, &kde;, and &kword; type: + + +$ kword -v + + +Show the license for &kword; + +To see the license for &kword; type: + + +$ kword --license + + + +Show &kword; developer list + +To see the list of developers for &kword; type: + + +$ kword --author + + +Other command line options + +There are many other, rarely used, command line options. You can get detailed help on these options by typing: + +$ kword + + + + + +Import/Export Filters +&kword;filters +filters + +Introduction to Filters +&kword; has the ability (with varying success) to load data +from foreign (non-&koffice;) data files. &kword; also has the ability to +save data as non-&koffice; data files. This is provided to help users +of &kword; to interact more seamlessly with people who use other +operating systems and wordprocessors. + +&kword; does this by loading a non-&koffice; datafile into +memory and passing the data through a filter +to extract as much information as possible from the data file. Some +formatting information will be lost or changed by the filter in the +attempt. + +When &kword; reads data into +&kword; from a non-&koffice; file format, it is +importing the data. + + +When &kword; saves a &kword; document as a non-&koffice; +file format, it is exporting the data. + + +Filters included in &kword; + +&kword; comes with the following filters: + + + + +ApplicationImportExport + +AbiwordYesYes +AmiProYesYes +ApplixwordYesNo +&HTML;YesYes +&kpresenter;YesNo +Hancom WordYesNo +Magic Point PresentationYesNo +&Microsoft; PowerpointYesNo +&Microsoft; WordYesNo +&Microsoft; WriteYesYes +Oasis OpenDocumentYesYes +Openoffice.org PresentationYesNo +Openoffice.org Text DocumentYesYes +Palm DocumentYesYes +PDFYesNo +Plain TextYesYes +RTFYesYes +SGMLNoYes +TeX DocumentNoYes +WMLYesYes +WordperfectYesYes +&XML;YesNo + + + + +For details on each filter, please refer to the &koffice; filters web page. + + + + + + + + +Key Bindings Summary +keyboard shortcutstable of + +Keybindings for Working with Documents + + + +Start New +Document +&Ctrl;N + + + +Open +Document +&Ctrl;O + + + +Save +Document +&Ctrl;S + + + +Print +Document +&Ctrl;P + + + +Close +Document +&Ctrl;W + + + +Quit +&kword; +&Ctrl;Q + + + + + + +Keybindings for Character Selection + + +Move selection one character to the left.&Shift;Left Arrow +Move selection one word to the left.&Ctrl;&Shift;Left Arrow +Move selection one character to the right.&Shift;Right Arrow +Move selection one word to the right.&Ctrl;&Shift;Right Arrow + +Selects all characters from the start of the selection, to the character directly up one line.&Shift;Up Arrow +Selects all characters from the start of the selection, to the first character of the line directly above.&Ctrl;&Shift;Up Arrow + +Selects all characters from the start of the selection, to the character directly down one line.&Shift;Down Arrow +Selects all characters from the start of the selection, to the last character of the line directly below.&Ctrl;&Shift;Down Arrow + +Selects all characters from the start of the selection, to the beginning of the line.&Shift;Home +Selects all characters from the start of the selection, to the beginning of the document.&Ctrl;&Shift;Home + +Selects all characters from the start of the selection, to the end of the line.&Shift;End +Selects all characters from the start of the selection, to the end of the document.&Ctrl;&Shift;End + +Moves the current endpoint one screen up.&Shift;Page-Up +Moves the current endpoint one page up. The endpoint is located at the first character of this page.&Ctrl;&Shift;Page-Up + + +Moves the current endpoint down one screen.&Shift;Page-Down + +Moves the current endpoint down one page. The endpoint is located at the first character of this page.&Ctrl; &Shift;Page-Down +Select all text in the current frame.&Ctrl;A + + + + + +Keybindings for Character Formatting + + + + + +Toggle Boldface On/Off +&Ctrl;B + + + +Toggle Italics On/Off +&Ctrl;I + + + +Toggle Underline On/Off +&Ctrl;U + + + +Format Font +&Alt;&Ctrl;F + + + +Decrease Font Size +&Ctrl;< + + + +Increase Font Size +&Ctrl;> + + + + + + + + + +Keybindings for Paragraph Formatting + + + + + +Align Block (Justify) +&Ctrl;J + + + +Align Center +&Alt;&Ctrl;C + + + +Align Left +&Ctrl;L + + + +Align Right +&Alt;&Ctrl;R + + + +Format Paragraph +&Alt;&Ctrl;P + + + + + + + +Keybindings for Basic Editing Functions and Search and +Replace + + + + + + +Copy +&Ctrl;C (&Ctrl;Insert) + + + +Cut +&Ctrl;X (&Shift;Delete) + + + +Paste +&Ctrl;V (&Shift;Insert) + + + +Find +&Ctrl;F + + + +Replace +&Ctrl;R + + + +Undo +&Ctrl;Z + + + +Redo +&Ctrl;&Shift;Z + + + + + +Keybindings for Inserting + + + + + +Create Text +Frame +F10 + + + +Insert +Picture +&Shift;F5 + + + +Create +Formula Frame +F4 + + + +Create +Table +F5 + + + +Insert Special +Character +&Alt;&Shift;C + + + +Insert Non-breaking Space +&Ctrl;Space + + + +Insert Soft Hyphen +&Ctrl;- + + + +Insert Line +Break +&Shift;Return + + + +Insert Hard Frame +Break +&Ctrl;Return + + + + +Keybindings for Accessibility + + + +Popup Context Menu +Menu (see note below) + + +Resize Panel Forward +F8 + + +Resize Panel Reverse +&Shift;F8 + + +Set Focus to Widget +&Alt;F8 + + +Enter keyboard Mouse Emulation mode +&Alt;F12 + + +Click mouse in Mouse Emulation mode +spacebar + + +Go to Document Structure +&Alt;1 + + +Go to Document +&Alt;2 + + + + +On most keyboards, the Menu key is on the righthand side between +the &Windows; and &Ctrl; keys. It has a menu icon on it. + + +Keybindings for Mouse Navigation + + + + + + + +Miscellaneous Keyboard Shortcuts + + + + +&kword; Handbook +F1 + + + +Whats This? +&Shift;F1 + + + +Completion +&Ctrl;E + + + +Lower Frame +&Ctrl;&Shift;L + + + +Raise Frame +&Ctrl;&Shift;R + + + +Show Stylist +&Alt;&Ctrl;S + + + + + + + + + +&kword; Technical details + +&techstuff; + +Kword &MIME; types +&kword;&MIME; types + +The &kword; &MIME; type is : application/x-kword + + + + + + +Glossary + + +Aspect Ratio + +This is the ratio of the measurement of a screen, picture or document +horizontally compared to the vertical measurement. All standard +computer monitors have the same aspect ratio, regardless of their +resolution. Any &kword; document that conforms to the standard +screen will look good on any monitor. +For many images, it is important to maintain the aspect ratio. This prevents +distortion to the picture. + + + + +Binary code + +Binary code is the actual instructions for the computer. So if we +refer to binaries we mean the executable &kword; +program. While computers have no difficulties reading binary files, +they are not easily understood by people. Compare this distribution method to Source Code. For more information on compiling &kword;, see +the section entitled Installation + + + + +Bitmap Image + +Bit mapped images are composed of individual dots. This type of +file is very good for photographs and complex drawings. The downside of +using bitmap images, is that when you change the size of the image on +the page, there is a loss of detail. The file names of such pictures +often end in jpeg, png or +gif. + + + + +Cells + +Tables are made up of rows and columns of cells. Each cell is +defined by a combination of the row and column of a heading. + + + + +Clipboard + +The clipboard is a temporary storage area in memory. Whenever you +use the Cut or +Copy command, you are placing the object that +was selected into this memory location. Then when you use the +Paste command, you insert the information +from the clipboard into the document. For more information see the +section on Cut/Copy/Paste. + + + + +Compiling + +When you compile a program, you are converting it from +a source file (which is easily edited by a programmer) into a binary +file (which the computer uses). Compare this distribution method to Binary Code. +Compiling programs +is not as easy as installing binary versions. Users who are only interested in +using &kword; are encouraged to find a binary version of &kword; for their computer. For +users who want to learn more about programming, more information on compiling &kword; is +available in the section entitled Installation. + + + +Custom Variables + +Using custom variables you can store certain values (⪚ numbers +or text) for later use in your document or in a script. If you want to +find out more about custom variables, see Document Variables. + + + + +DEB + +This is a binary file format that is used by Debian and Debian-based +distributions. This will be the suffix of a file +specifically for +these distributions. An example would be +koffice-1.2.deb. For more information on installing +these files, refer to the Debian Web +Site. + + + + +Dialog Box + +A dialog box is a small window that appears on top of your working +document. This window usually has questions, information or +configuration options related to the task you are performing. When you +are finished with the dialog box, it will disappear and return you to +your document (possibly after making some changes to the +document). + + + + +DTP + +Stands for DeskTop Publishing. + + + + +FAQ + +Stands for Frequently Asked Questions and +normally means a document, where questions that arise many times are answered. If you +have a question to the developers of &koffice;, you should always have a +look at the FAQ first; you can find the latest version +here. + + + + +File Mask + +A file mask can be thought of as a strainer for you. On the +average computer, there are several thousand files. These files are +sorted into sub-directories, but it is not uncommon for many users to +have 100's of data files in a single sub-directory. +Fortunately for us, most applications use a suffix to their +filenames. By applying a file mask, &kword; will only show you the +files which are not filtered out by the mask. (That is to say &kword; +only shows the files that fit through the strainer). This can be +helpful if you have many files from many different applications. The +file mask is incorporated in the Filter: line of +the Save Document and Open Document dialog boxes. +As an example. If you use a file mask for &kword; files, the file +mask will try to filter out all files that are not for +&kword;. + + + +Filter + +A filter takes a document file from one program (⪚ &Microsoft; +Word), and filters out +the text and formatting information and converts that information into a +&kword; document. Filters are used to read and write files for other +programs. More information on the filters included with &kword; +is available in the section entitled Import/Export Filters. + + + + +Footer + +The footer of a page is an area below the normal text area. Often +it contains the page numbering and maybe some additional +information. The contents of the footer are normally the same for most +pages, and changing the footer on one page will change all other pages +as well. See Header. + + + + +Frame + +Nearly everything in &kword; is in a frame. Text is always in +a text frame. Pictures are in picture frames. Parts are in part +frames. A frame is basically just a rectangle that can contain some part +of your document. Frames can be moved, resized, deleted etc. + + + + +Frameset + +A frame-set is a group of frames which are connected together. If +you are writing text that does not fit into the first frame of a frame-set, +it will continue in the next frame belonging to that frame-set. + + + + +&FTP; + +&FTP; is the File Transfer Protocol; it is an +Internet protocol that allows you to retrieve files from so-called &FTP; +servers. If you want to download &koffice; from the Internet, you will +probably use &FTP;. + + + + +Hard Frame Break + +Normally, &kword; automatically adjusts text so it fits into a +text frame. By inserting a hard frame break you can force &kword; to +always start the next frame in the frameset with the text that follows +the break. + + + + +Hanging indention + +A paragraph where the first line of the paragraph extends outwards to +the left compared with other lines in the paragraph. + + + + + + +Header + +The header of a page is an area above the normal text area. Often +it contains the page numbering and maybe some additional +information. The contents of the header normally are the same for most +pages, and changing the header on one page will change all other pages +as well. See Footer. + + + + +&HTML; + +Stands for HyperText Markup Language. Most +web pages on the Internet are written in +&HTML;. &kword; can read and write +&HTML; documents for publishing on the World Wide +Web. + + + + +Hue + +Hue is a more technically correct term for what we generally refer to as color. +Examples of hues include red, green, blue and purple. + + + + +Inline frame + +An inline frame is a special frame type in &kword;. Inline frames are associated with a position in a text frame. +&kword; will keep the inline frame near the specified text. You will not be able to determine where exactly on a page the +frame will appear, but it will be located close to the specified text. +If you insert or delete text in front of the specified text, the inline image will move up or down the page to follow the +specified text +Inline frames are very useful when they contain a picture, graph or figure. Simply place the inline frame within the +text which describes the object, and &kword; will make sure both the text and the inline frame are always near each other. + + + + +&kde; + +Stands for the K Desktop Environment. Part of &kde; is +required for &kword; to operate. The K Desktop Environment is a user +interface which allows users to manipulate files and operate programs +graphically. For more information, please visit www.kde.org. + + + + +Key Binding + +All of the features of &kword; are available through the menubar. +You will find, however, that there are certain features of &kword; that +you use on a regular basis. You can bind a certain +key combination to that function. Once this combination is bound to the +function, you can use it as a shortcut to the function. &kword; comes +with several predefined key-bindings. For +more information on changing the default key-bindings, click here. + + + + +Landscape + +When you have a standard sheet of paper, you can either orient +your document with the long side vertically or horizontally. When the +horizontal dimension is greater than the vertical, this is termed +Landscape. +Example: + Compare +with Portrait. + + + + +Menubar + +The menubar is located at the top of the &kword; screen. You can +use it to access all features of &kword;. +Menubar: + + + + +Portrait + +When you have a standard sheet of paper, you can either orient +your document with the long side vertically or horizontally. When the +vertical dimension is greater than the horizontal, this is termed +Portrait. +Example: +Compare with Landscape. + + + + +RPM + +This is the binary file format for distributions based on the +&RedHat; package manager, a widely used packaging tool for the &Linux; +operating system. If you still have to get &koffice; and your system +supports RPM packages, you should get &koffice; +packages ending in .rpm. They are +very easy to use. + + + + +Saturation + +Saturation refers to the subjective quantity of a specific hue in a color. Colors with a low saturation appear more white. +Colors with high saturation appear more richly colored. +This is a set of four red dots which increase in saturation from left to right. + + + + + +Scaling Pictures + +Whenever you change the size of a graphics image, you are scaling +that image. In &kword; you scale the pictures by changing the shape of +the frame which surrounds the graphic. + + + + +Source Code + +Source code is the human readable version of an application (such +as &kword;). Computers cannot use source code directly. Instead, +source code must be compiled into +binary code, before use. + + + + +TAR + +Tar is a tool used for the archiving of files in so-called +tar-files which you recognize by their suffix +.tar. You can find &koffice; source +and binary distributions as gzipped +tar-files; however, you should not use them if there are special +packages for your system and package manager. See RPM, DEB. + + + + +tar.gz + +See TGZ. + + + + +TGZ + +Files ending in .tar.gz or +.tgz are tar-files compressed with the +gzip program. This makes the tar files smaller and +quicker to download. You can find &koffice; source and binary +distributions in this format; however, you should not use them if there +are special packages for your system and package manager. See RPM, DEB. + + + + +Toolbar + +A toolbar is a line of buttons which are shortcuts to more of the +commonly used features of &kword;. More information on toolbars can be +found here. +Example Toolbar: + + + + +&URL; + +&URL; is an abbreviation for Universal Resource Locater. A universal resource locater is +the technical term for what is commonly referred to as a websites address. +Examples of &URL;s include http://www.koffice.org and +http://www.kde.org + + + + +Value (color) + +Color value refers to how bright or dark a color is. Colors with low value are more black in appearance. Colors with high +value are more richly colored. +This is a set of four red dots which increase in value from left to right. + + + + + + +Vector Image + +A vector based graphic is described in terms of lines and shapes, +not in terms of dots. These files +scale better than bit-mapped images. + + + + +WYSIWYG + +Stands for What You See Is What You Get. +&kword; is a WYSIWYG word processor, which means that +the document will appear the same on the screen while you are editing +it, as it will on the printed page. + + + + +&X-Window; + +The &X-Window; (also known simply as X) is +required for &koffice; to operate. More information on &X-Window; for +&Linux; can be found at http://www.xfree86.org + + + + + +&documentation.index; + diff --git a/doc/kword/inscoldlg.png b/doc/kword/inscoldlg.png new file mode 100644 index 00000000..4af99694 Binary files /dev/null and b/doc/kword/inscoldlg.png differ diff --git a/doc/kword/insdate.png b/doc/kword/insdate.png new file mode 100644 index 00000000..12a11f35 Binary files /dev/null and b/doc/kword/insdate.png differ diff --git a/doc/kword/insertfile.docbook b/doc/kword/insertfile.docbook new file mode 100644 index 00000000..cf792062 --- /dev/null +++ b/doc/kword/insertfile.docbook @@ -0,0 +1,22 @@ + + + + +Mike +McBride + + + + +Inserting files +inserting files + +&kword; has the ability to insert a previously saved &kword; file into the current document. This is especially useful for +large documents that have multiple authors. +To insert a &kword; file into the current document, place the cursor at the desired insertion point of the document. +Selecting InsertFile... from +the menubar. You will be given a file selection dialog to select the &kword; file you want to insert. +When you have located the &kword; file, click OK, and the new &kword; file will be inserted into the +current document at the current cursor position. +&kword; will integrate the newly inserted document into the structure of the current document. + diff --git a/doc/kword/insgrph1.png b/doc/kword/insgrph1.png new file mode 100644 index 00000000..c404ae67 Binary files /dev/null and b/doc/kword/insgrph1.png differ diff --git a/doc/kword/insgrph2.png b/doc/kword/insgrph2.png new file mode 100644 index 00000000..d1ccc60e Binary files /dev/null and b/doc/kword/insgrph2.png differ diff --git a/doc/kword/insrowdlg.png b/doc/kword/insrowdlg.png new file mode 100644 index 00000000..32c55a38 Binary files /dev/null and b/doc/kword/insrowdlg.png differ diff --git a/doc/kword/instab1.png b/doc/kword/instab1.png new file mode 100644 index 00000000..7d4771b1 Binary files /dev/null and b/doc/kword/instab1.png differ diff --git a/doc/kword/instb.png b/doc/kword/instb.png new file mode 100644 index 00000000..72d4135a Binary files /dev/null and b/doc/kword/instb.png differ diff --git a/doc/kword/instime.png b/doc/kword/instime.png new file mode 100644 index 00000000..dc88fb44 Binary files /dev/null and b/doc/kword/instime.png differ diff --git a/doc/kword/intro1.png b/doc/kword/intro1.png new file mode 100644 index 00000000..a8d2261d Binary files /dev/null and b/doc/kword/intro1.png differ diff --git a/doc/kword/intro2.png b/doc/kword/intro2.png new file mode 100644 index 00000000..0f4fe903 Binary files /dev/null and b/doc/kword/intro2.png differ diff --git a/doc/kword/intro3.png b/doc/kword/intro3.png new file mode 100644 index 00000000..04b6c138 Binary files /dev/null and b/doc/kword/intro3.png differ diff --git a/doc/kword/ital.png b/doc/kword/ital.png new file mode 100644 index 00000000..79a64353 Binary files /dev/null and b/doc/kword/ital.png differ diff --git a/doc/kword/joincell.png b/doc/kword/joincell.png new file mode 100644 index 00000000..ae9cd44c Binary files /dev/null and b/doc/kword/joincell.png differ diff --git a/doc/kword/kbd-focus-ext.png b/doc/kword/kbd-focus-ext.png new file mode 100644 index 00000000..541e124e Binary files /dev/null and b/doc/kword/kbd-focus-ext.png differ diff --git a/doc/kword/kformappcol.png b/doc/kword/kformappcol.png new file mode 100644 index 00000000..31083ce5 Binary files /dev/null and b/doc/kword/kformappcol.png differ diff --git a/doc/kword/kformapprow.png b/doc/kword/kformapprow.png new file mode 100644 index 00000000..df9b1389 Binary files /dev/null and b/doc/kword/kformapprow.png differ diff --git a/doc/kword/kforminscol.png b/doc/kword/kforminscol.png new file mode 100644 index 00000000..1c3391fb Binary files /dev/null and b/doc/kword/kforminscol.png differ diff --git a/doc/kword/kforminsrow.png b/doc/kword/kforminsrow.png new file mode 100644 index 00000000..0d3273fc Binary files /dev/null and b/doc/kword/kforminsrow.png differ diff --git a/doc/kword/kformremcol.png b/doc/kword/kformremcol.png new file mode 100644 index 00000000..452eb974 Binary files /dev/null and b/doc/kword/kformremcol.png differ diff --git a/doc/kword/kformremrow.png b/doc/kword/kformremrow.png new file mode 100644 index 00000000..8dd870fa Binary files /dev/null and b/doc/kword/kformremrow.png differ diff --git a/doc/kword/kpart.png b/doc/kword/kpart.png new file mode 100644 index 00000000..f70b6b1d Binary files /dev/null and b/doc/kword/kpart.png differ diff --git a/doc/kword/kparts.docbook b/doc/kword/kparts.docbook new file mode 100644 index 00000000..67ac3357 --- /dev/null +++ b/doc/kword/kparts.docbook @@ -0,0 +1,56 @@ + + + + +Mike +McBride + + + + +KOffice Data +inserting &koffice; data +&koffice;inserting data into &kword; + +The applications which make up &koffice; are capable of a fine degree of integration between each other. +Because the actual process of inserting a component varies depending on the application, this chapter will not detail +every step of the process. You will need to be familiar with the basics of using the other application in order to correctly insert +a component from that application +Refer to the help files of the other applications for more specific information. +General instructions +There are two ways to insert a component (spreadsheet, presentation, graph, etc) from another application in &koffice;: + + + +Selecting +InsertObject Frame from +the menubar. +You will be given a list of &koffice; applications to choose from. Select the application you desire. + + + +or by clicking on the +toolbar. +A dialog box will appear with a list of &koffice; applications to choose from. Select the application you desire. + + + + +&kword; +will now ask you to define a frame for this object. Place the mouse pointer where you want the upper left corner of the frame to +be located. Click and hold with the &LMB;. Drag the mouse to draw a square for your new object. When you are happy with the size of the object frame, release the &LMB; +&kword; will now execute the application you selected from within &kword;. The details of each +application are different. Please see the application manuals for the specific &koffice; application for details on the use of that +application. (In other words, from this point on, if you insert a spreadsheet from &kspread;, then the windows will act the same +as &kspread;.) + +Working with the inserted component +To edit the data within the component, simply double click with the mouse pointer and &kword; will change the toolbars, menuitems and +application structure to match the &koffice; application. This way, you can use the application specific tools to refine your component. +The frame that contains the embedded data, can be manipulated +the same as any other frame in &kword;. +When you save your document, the component is saved within the &kword; document. + + diff --git a/doc/kword/landscape.png b/doc/kword/landscape.png new file mode 100644 index 00000000..c9c79611 Binary files /dev/null and b/doc/kword/landscape.png differ diff --git a/doc/kword/larrow.png b/doc/kword/larrow.png new file mode 100644 index 00000000..1da2e738 Binary files /dev/null and b/doc/kword/larrow.png differ diff --git a/doc/kword/lbord.png b/doc/kword/lbord.png new file mode 100644 index 00000000..7814e3dc Binary files /dev/null and b/doc/kword/lbord.png differ diff --git a/doc/kword/linkdlg.png b/doc/kword/linkdlg.png new file mode 100644 index 00000000..620b2c6b Binary files /dev/null and b/doc/kword/linkdlg.png differ diff --git a/doc/kword/listdepth1.png b/doc/kword/listdepth1.png new file mode 100644 index 00000000..9f5ce137 Binary files /dev/null and b/doc/kword/listdepth1.png differ diff --git a/doc/kword/listdepth2.png b/doc/kword/listdepth2.png new file mode 100644 index 00000000..8539363a Binary files /dev/null and b/doc/kword/listdepth2.png differ diff --git a/doc/kword/listdepth3.png b/doc/kword/listdepth3.png new file mode 100644 index 00000000..382f8e4b Binary files /dev/null and b/doc/kword/listdepth3.png differ diff --git a/doc/kword/lists.docbook b/doc/kword/lists.docbook new file mode 100644 index 00000000..4e7f8b18 --- /dev/null +++ b/doc/kword/lists.docbook @@ -0,0 +1,165 @@ + + + + +Mike +McBride + + + + +Lists +lists + +&kword; has a simple and flexible list creation system. +Using the same interface, &kword; can create bulleted or enumerated lists of nearly any depth. +For easy, simple lists, &kword; offers +a toolbar button for both enumerated and bulleted lists. + +An enumerating style is a series of letters or +numbers which proposes an order or hierarchy within the list. Bullets +simply mark the item as part of the list and usually consist of a symbol or shape. + +Simple lists + +To quickly create a single level list, &kword; provides two toolbar buttons. +To create a simple enumerated list, simply select from the +paragraph toolbar. +A small menu will list different enumerated list styles. Select the appropriate style and the selected +paragraphs are converted into a list of that style. +To create a simple bulleted list, select from the +paragraph toolbar. +A small menu will list different bulleted list styles. Select the appropriate style and the selected +paragraphs are converted into a bulleted list of that style. +You are still able to make changes to the list styles by using the dialog. + + +Complex lists +All complex list formatting is done through the Paragraph Settings dialog. To get to the Paragraph Settings dialog you can: + + + +Select +FormatParagraph... +from the menubar + + +Type &Alt;&Ctrl;P + + +Place the mouse pointer in the paragraphs that will become the list and click once +with the &RMB;. A small menu +will appear. Select Paragraph.... + + + +A dialog will appear. To find the tab specific to lists, click once on the tab labeled Bullets/Numbers. + + +List type + + + + + + + +To format the selected text as a list, select the radio button labeled List from the top section of the dialog box. + +There is a list of five bullets types and five enumerating styles along the left +side of the dialog box. Select the desired list style from the list on the left. + +Changing the look of the list + +The text box labeled Prefix text: allows the user to add text before +the enumeration or bullet. + +The text box labeled Suffix text: allows the user to add text after +the enumeration or bullet. + +For example: If Step is typed into the Prefix text: +box, and - is typed into the Suffix text: text box, the list will look like this: + + +Step 1 - Place 1 cup of flour in a large mixing bowl. +Step 2 - Add 1/4 tablespoon of yeast. +Step 3 - .... + + +If an enumerated list style is selected, the starting number/letter for the list can be set in the spin box +labeled Start at:. If you have selected a bulleted list style, this box will be inactive. + +Multi-level lists + +The spin box labled Depth: is used to add subsections to your list. By selecting a depth greater than one, +you are adding a subsection to the list. + +Example of a multilevel enumerated list: + + + + + + + + +An example of a multilevel bulleted list: + + + + + + + + +Adjust the depth setting to determine where in the list this text occurs. +By adjusting the spin box labeled Display levels: you can determine if previous levels are displayed. For example, with a list where Depth: is set to three and +Display levels: is set to one might be: + + +i. This is a step +ii. This is another step + + +If you change the Display levels: to two, it would change to: + + +A.i. This is a step +A.ii. This is another step + + + You can always refer to the preview section of the dialog for an example of how +your list will look. + + + + + +Custom Bullets +If you select Custom Bullet from the list of styles, you can click on the button labeled +Custom character: to choose the letter or symbol you want for your bulleted list. + +Restart new list +If you select the checkbox labeled Restart numbering at this paragraph &kword; will start +numbering your list at the beginning. + + Multiple paragraphs in one list element +Each new paragraph represents a new list element. Sometimes, however, it will be desireable to have multiple +paragraphs on a single list element. This is accomplished by inserting a New Line character instead of a Paragraph Break. + +To insert a New Line, type &Shift;Return. + + + + + + + + + + + + + diff --git a/doc/kword/ltab.png b/doc/kword/ltab.png new file mode 100644 index 00000000..60d29657 Binary files /dev/null and b/doc/kword/ltab.png differ diff --git a/doc/kword/ltab2.png b/doc/kword/ltab2.png new file mode 100644 index 00000000..f38b40f8 Binary files /dev/null and b/doc/kword/ltab2.png differ diff --git a/doc/kword/mailmerge.docbook b/doc/kword/mailmerge.docbook new file mode 100644 index 00000000..c0adac9d --- /dev/null +++ b/doc/kword/mailmerge.docbook @@ -0,0 +1,475 @@ + + + + +Mike +McBride + + + + +Mail Merge +mail mergeintroduction + +&kword; has the ability to use data from an outside database (or internal database) to personalize your +documents for individual members/clients/friends. +This section of the manual will cover all aspects of creating, merging and printing documents that are specific to &kword;. This +manual will not cover: + +Creating an external database. +Security issues regarding databases. +Detailed instructions on SQL. It is assumed you have some knowledge regarding SQL if you are using a +SQL database for your data source. +Accessing the network or Internet. + + +For answers to these questions, other documentation is available on the Internet that is specific to the software you have chosen. +You can retreive your mail-merge data from a number of sources: + +If you want to use an outside SQL database, click here for instructions. +If you want to use a &kspread; file for your data, click here. +If you want use information from your &kde; Address Book, click here. +If you want to use the internal database of &kword;, click here. + + + +Using an external SQL database as a data source +mail mergeSQL databases + +&kword; has the ability to use several of the most popular open source databases as a source of data for personalized documents. +In order to access an outside database using SQL, your machine needs to have the appropriate database module compiled +into your copy of QT. +For more information see the installation section of this documentation. +The database can be located on the same machine as &kword;, or on any computer which is accessable through your computer +network or the Internet. +In order to use the database, you must know the following information: + +Name of the database +Host name/IP address of the computer the database is located on +The port address on the specified computer granting SQL access +A valid user name for the database +A valid password for the user name + + +If you have all this information at your finger tips, you are ready to proceed. +Using an outside database to create personalized documents is a three step process: + +Connect to the database and select your query. +Insert the merge fields to tell &kword; +where to insert the database information. +Print the personalized documents. + + + +Locate the database and query the records. +To begin, select +ToolsConfigure Mail Merge... from +the menubar. A dialog box will appear. + + + + + + + + +Click on Open Existing.... Another small dialog will appear. + + + + + + + + +Select QT-SQL Source and click on +OK. A new dialog box will appear. + + + + + + + + +Enter the &URL; or IP address of the computer that holds the database in the text box labeled Hostname:. +Select the driver named QMYSQL3 from the combo box labeled Driver:. +Enter the database name you were provided in the text box labeled Database name: and a +user name in the text box labeled Username:. +If the database access is through a port other than the default port enter that port number in the text box labeled +Port:. +If you are going to be using this database at other times, you can click on the button labeled +Keep settings.... &kword; will ask for a descriptive name. +When you want to restore these settings on future sessions, simply select the descriptive name from the combo box in the +upper left of the dialog box. + +When all information is correct, click OK. &kword; will ask you for a password to that database. Enter +the password in the text box, and click OK. +&kword; will now ask if you want to replace your current data source with the source you have selected. Click Yes. +You are now connected to the database. Now you need to select the data from the database. This dialog box has re-appeared. + + + + + + + + +Click on Edit Current.... Another dialog will appear. + + + + + + + + +This dialog is designed to help you enter and test your database query. The dialog is divided into three +sections: Database information, Query information and Query line. +The database information section is labeled Information and consists of two combo boxes. The +left combo box (Available tables:) gives you a list of all available tables within the current database. +Select the desired table from the list by clicking on the table name with the &LMB;. +A list of all available fields from that table will appear in the right combo box. +The query line is a text box located near the bottom of the dialog labeled Query:. Simply type your +SQL query into this text box and click Execute. &kword; will query the database and return the specified query +in tabular format in the Query Result box. You can alter, or edit your query on the query line and each time you +click Execute, the new query results will appear. +&kword; does not limit your query strings. They can be simple and straight forward: +select * from Clients +Or complex multitable queries: +select Clients.FirstName, Clients.LastName, Clients.address, data.Birthday, +data.EyeColour from eMail, data where data.FirstName=Clients.FirstName and +data.LastName=Clients.LastName + + +Clicking Setup, will allow you to log into a different database. +When you have the correct query in the Query: text box, click OK to select that query. + +This will return you to the mail merge main dialog box. + + + + + + + + +Click Close. + +Now that you have selected your data query, it is time to insert the merge fields in the document. Click +here to continue. + + + + +Using a &kspread; file as a data source +mail mergeusing &kspread; file + +&kword; can use data in a &kspread; document for personalizing documents. +In order to use this data, you only need to know the location of the &kspread; document and the worksheet (page) number the data is located on. + +Using a &kspread; document to create personalized documents is a three step process: + +Select the file the data is located within. +Insert the merge fields to tell &kword; +where to insert the database information +Print the personalized documents. + + + +Selecting the file that contains the data. +To begin, select +ToolsConfigure Mail Merge... from +the menubar. A dialog box will appear. + + + + + + + + +Click on Open Existing.... Another small dialog will appear. + + + + + + + + +Select &kspread; Table Source from the drop down box labeled Available sources: and click on +OK. A new dialog box will appear. + + + + + + + + +Enter the &URL; or file name of the &kspread; document in the text box labeled URL:. You can type the file name +directly into the text box, or click on the button with the blue folder and use the file dialog to select the &kspread; file. +Once you have selected the &kspread; document, the drop down box labeled Page number: will show you all the available pages or worksheets +within the &kspread; document. Select the page (or worksheet) that contains the mail merge data. +When all information is correct, click OK. &kword; will ask you if you want to replace the current data source. Click Yes to continue. + + +You will again see the mail merge main dialog box. + + + + + + + + +Click Close. + +Now that you have selected your data query, it is time to insert the merge fields in the document. Click +here to continue. + + + + +Using your &kde; Address book as a data source +mail mergeusing &kde; Address Book + +&kword; can use data in your address book for personalizing documents. + +Using address book entries to create personalized documents is a three step process: + +Select the people you want included in the mail merge. +Insert the merge fields to tell &kword; +where to insert the database information +Print the personalized documents. + + + +Select the people you want included +To begin, select +ToolsConfigure Mail Merge... from +the menubar. A dialog box will appear. + + + + + + + + +Click on Open Existing.... Another small dialog will appear. + + + + + + + + +Select &kde; Addressbook Plugin from the drop down box labeled Available sources: and click on +OK. A new dialog box will appear. + + + + + + + + +The dialog consists of two listboxes labeled Address Book and Selected Addresses. By moving entries from your Address book to the Selected Addresses listbox, you will be including those entries in your merge document. +To add an entry, select the entry in the left listbox by clicking with the &LMB;. Then click Add. +To remove an entry, select the entry in the right listbox by clicking with the &LMB;. Then click Remove. +You can locate entries quickly by entering the first 2-3 letters of an entries name in the textbox labeled Filter on: +You can load the full address book application by clicking the Address Book... button. +You can also save a distribution list using the Save as Distribution List... button. For more information on distribution lists, see the documentation on the &kde; Addressbook. + +When you have selected all the entries and distribution lists you want, click OK. &kword; will ask you if you want to replace the current data source. Click Yes to continue. + + +You will again see the mail merge main dialog box. + + + + + + + + +Click Close. + +Now that you have selected your data query, it is time to insert the merge fields in the document. Click +here to continue. + + + + + +Using an internal representation of tabular data to create documents +mail mergeusing &kword; data tables + +For small sets of data, or when you do not currently have a database containing the merge data, &kword; +offers you the ability to enter the data directly into &kword; in tabular form. This internal data +structure can then be used to create documents with this data inserted at predefined locations. +Using an internal representation of the data to create personalized documents is a three step process: + +Enter the data into &kword; +Insert the merge fields to tell &kword; +where to insert the database information +Print the personalized documents. + +After the data has been created once, you can go back and change the data as needed, and produce another set of +personalized documents from that data. + + +Enter the data +To begin, select +ToolsConfigure Mail Merge... from +the menubar. A dialog box will appear. + + + + + + + + +Click on Create New.... Another small dialog will appear. +There is currently only one option in this dialog box Internal Storage. Click on +OK. A new dialog box will appear. + + + + + + + + +This is a record card for creating your tabular data file. Along the top is a toolbar and the main part of the dialog is space to hold +your entry/data pairs. +Defining the structure of your data table +First, we need to add one or more entries (merge fields). This is accomplished by clicking the + + +(Add entry) +button (third button from the right along the toolbar). A small dialog box will appear. Type a descriptive name of your entry +in the dialog box (Name, Address, Balance Due, etc....). +This is for the name of the entry, not the data that is contained within the entry. +Click OK, and the entry is added to the card. +Repeat this process until all needed entries are visible on this first card. +If you want to delete an entry, simply click once on the entry name with the &LMB; and select + +(Remove entry). +Be very sure you have selected the correct entry name. Once you tell &kword; to delete +the entry, the entry and all of the data within those entries will be deleted immediately. You will not be +given the option to stop or reverse the process once it is begun. + + +Entering the data into the table +Now that the structure of your data is defined, you can enter the data into your entries. +At the top of the dialog box, are 4 buttons surrounding a spin box. The spin box gives the current record number. All +records are numbered in the order they are added starting with number 1. You can use the spin box to go directly to +the desired record or you can use the arrows to graphically move +through the list of records. + + + + +ButtonAction + +Move directly to record one +Move back one record +Move forward one record +Move to the last record in the dataset + + + + +To enter the data, simply place the cursor in the text box to the right of the entry name, and type in the data. (&kword; uses +No Value as the default value for all entries in newly created records.) +To add a record, click the + + button. +To delete a record, click the + + button. +Be careful when you are deleting records. Once deleted, the record cannot be retrieved. +Continue to enter all data until your dataset is complete. +After your dataset is complete, click OK to +save the changes to your dataset. This will bring up the mail merge main dialog: + + + + + + + + +Click Close. Now it is time to insert the merge fields in the document. + + + + + + +Insert merge fields in document +Now that &kword; knows the entries available in your data source, you can insert the merge fields into your document. +A merge field is a placeholder within the document. This placeholder will be replaced in each personalized document with the +value of the entry for that individual record. + + +Insert a merge field +mail mergeinserting merge fields + +To insert a merge field, place the cursor at the desired place in the document. Select +InsertVariable +Mail Merge... from +the menubar. A list of available entries will appear. Select the desired entry, and click OK. +The merge field is inserted at the current cursor location. The merge field is surrounded by brackets. +You can place the cursor in a new location in the document and insert another placeholder. When you are done inserting placeholders, +you can proceed to printing your document. + + + +Delete a merge field +mail mergedeleting a merge field + +You can delete a merge field two ways. + + +Place the cursor at the end of the merge field, and press the &Backspace; key. +Place the cursor at the beginning of the merge field, and press the Delete key. + + + + + + +Previewing and printing the merged document +mail mergemerging data and text + +Once you have inserted all the merge fields you want, you are ready to preview and print the personalized documents. + +Preview your documents before printing +To preview your document select +ToolsConfigure Mail Merge... from +the menubar. A dialog box will appear. + + + + + + + + +Click Print Preview.... You will be able to see the final output of your personalized documents prior to +printing. + + +Print your personalized documents. +You print personalized documents using the same methods that you do to print traditional documents. For more information on printing +see the section on Printing a Document. + + + + diff --git a/doc/kword/mbtb.docbook b/doc/kword/mbtb.docbook new file mode 100644 index 00000000..e28f8dbc --- /dev/null +++ b/doc/kword/mbtb.docbook @@ -0,0 +1,2628 @@ + + + + + + +Mike +McBride + + + + +The Menu Items/Toolbars + + +Introduction to the Menubar and Toolbars + +The key to getting the most out of &kword;, is found in the menu +bars and the toolbars. + +The menubar is organized into groups of functions (⪚ file +functions, table functions, &etc;). Below each of these groups, is a +submenu of actions. Some of these submenus will have sub menus of +their own. + +The toolbars are also organized into groups. Each toolbar +consists of a set of buttons. Each button performs a specific +function. The toolbars are designed to act as shortcuts for more +commonly used functions. + +The first part of this section of the manual discusses the +manipulation of &kword;'s toolbars to suit your needs. + +The second part of this section, takes a detailed look at each +menubar function, and each standard toolbar button, and provides you with a +brief summary of its action. Many of these sections also provide you with a link to more detailed +information located elsewhere in the &kword; Handbook. + + + + +Hiding, Changing, and Moving Toolbars +toolbarshiding + +&kword; offers the user great flexibility when it comes to +toolbars. This first section will show you some of the many options +you have for relocating, reformatting and removing toolbars. + + +Hiding Toolbars + +When you start &kword; for the first time, several toolbars +are visible. If you don't think you will need a toolbar, and want to +reclaim that desktop space, you can hide any or all of the toolbars + +To hide a toolbar, Select +SettingsToolbars from +the menubar. This will bring up a submenu. All of the toolbars are +listed. Simply select the toolbar you want to hide or restore. + + + + +Moving Toolbars around +toolbarsmoving + +Toolbars can be located on the screen in 5 places. + + +Top +Bottom +Left +Right +Floating + + +Top, Bottom, +Left and Right refer to the +edges of the &kword; screen. + +By locating a toolbar in the Bottom +position, for example, you move the toolbar into a horizontal position +below the Document Area, and along the bottom of the &kword; +window. By locating a toolbar in the Left +position,however, you move the toolbar into a vertical position to the +left of the Document Area, and along the left edge of the &kword; +window. + +Multiple toolbars can be located at each of these points in the +screen. (You could, for instance, move all the toolbars to the top of +the screen). &kword; will shuffle toolbars around, to fit in the most +compact way at that location. + +There are two ways to move any toolbar. + + + + +Click on the striped area of the toolbar with the &LMB; and hold +the button down. Drag the toolbar to the desired location. You will +see a rectangular shape indicating the position and orientation of the +toolbar. When at the desired location, release the &LMB; and the +toolbar will be inserted there. + +or + + + +Click on the toolbar with the &RMB;. A +popup menu will appear. Select +Orientation. A small submenu will +appear. Select Top, +Bottom, Left, +Right, Floating or +Flat. + + + +If you select Floating for any toolbar, a new window will be created just for that toolbar. This window can be moved independently from the &kword; window. + +Finally, if you select Flat for any toolbar, the toolbar will be reduced to a horizontal section of lines located directly below the menubar. To restore this menubar, simply double click with the &LMB; on the flattened toolbar and the toolbar will be restored to its original size and position. + + + +Changing the look of your toolbars +toolbarsformatting + +Toolbars can have their buttons displayed different ways. Below +are examples of the four options for the File +toolbar. + + + + + +Icons Only + + + + +Text Only + + + + +Text Aside Icons + + + + +Text Under Icons + + + + + + +To change the appearance of a toolbar, place the cursor over on +the toolbar you want to change, and click with the &RMB;. + +A small menu will appear at the mouse cursor. Select +Text Position. This will open a submenu, +select your preference from the list. + + +Changing Icon Size +toolbarschanging size + +You can also select the size of the icons by clicking on the +toolbar with the &RMB;. A small popup menu will appear. Select +Icon Size and then your preferred icon +size. + + +Setting the look of one toolbar does not alter the look +of another toolbar. + + + + + + + + + +Menubar + +The Menubar contains all commands available to &kword;. It is +divided into 10 general categories. + + + + + + + + + +<guimenu>File</guimenu> Menu + +By clicking on the File menu, you can begin +new documents, load previously edited documents, print your documents, +close the current document (so you can load another document), or quit +&kword; entirely. + + + + + + + +&Ctrl;N + +FileNew + + Allows you to open new files for editing. For +Step by Step instructions see Beginning a New +Document. + +Typing &Ctrl;N or clicking + + is equivalent to +using the menubar. + + + + + + + +&Ctrl;O +FileOpen... + + + + For opening previously created &kword; files. +For Step by Step instructions see Retrieving a +Saved Document. +Typing &Ctrl;O or clicking + is equivalent to +using the menubar. + + + + + + +FileOpen +Recent + +For opening the most recently edited files. Once you +have clicked on this option, a list of recently edited files will +appear. Select the file you want and &kword; will open the +file. + + + + + + + +&Ctrl;S + +FileSave + +Saves your current file to disk. If you have +not saved the file yet, you will be prompted for a filename. For more +details, see Saving a Document. +Typing &Ctrl;S or clicking + + is equivalent to +using the menubar. + + + + + + +FileSave +As... + + + +Allows you to save your file under another name or another +format. For more details, see Saving a +Document. + + + + + + +FileReload + + + +Reloads the current file from disk, erasing any changes to the document since the last time it was saved. + + + + + + +FileImport... + + + +Will load a file from another application. &kword; attempts to decipher as much of the file as it can. For many files, some information will be lost. For more +information on the ability to import files from other applications, see the section on filters at the end of this documentation. + + + + + + +FileExport... + + + +Will save a file using the format of another application. &kword; attempts to save as much of the file as it can. For many files, some information will be lost. For more +information on the ability to export files to other applications, see the section on filters at the end of this documentation. + + + + + + +FileMail... + + + +Launches your email client so you can send the current file as an attachment. The file must have been saved once before this option can be selected. + + + + + + +FileCreate Template From +Document... + + + +Allows you to save your file as a template, to use as a +starting point for future documents. For more details, see +Creating a new template. + + + + + + +FileStatistics + + + + +Opens a window that counts the sentences, words, +characters and syllables in your document. The +number of sentences is not always absolutely correct, as &kword; has +to guess if a dot really starts a new sentence or not. The number of +syllables is estimated, &kword; therefore assumes that the text is +written in English. + +The Flesch reading ease: score is a number +between 0 and 100 which estimates how readable a text is. The higher +the number, the easier the text can be read. Text with a score of +70-80 should have fairly good readability. + +The Flesch formula uses the number of words per sentences and +the number of syllables per word. It assumes that the use of short +words and short sentences increases the readability of a text. It says +nothing about grammar or meaning. As both the number of sentences and +the number of syllables is estimated, the result is not absolutely +precise. The text should be at least 200 words long, if it isn't the +score will be marked as approximated. + +The Flesch score is defined for English text only, but the basic +idea should work for many other languages, too. + +Click OK to dismiss the +window. + + + + + + +&Ctrl;P +FilePrint... + + +Print the file. For an overview of printing +options see Printing a Document. + +Typing &Ctrl;P or clicking + + are equivalent to using +the menubar. + + + + + + +FilePrint Preview... + + + +Print the file, but sends the output to your postscript +viewer, for your confirmation before sending it to the printer. The +operation of your postscript viewer will vary depending on which viewer +you use. Refer to the help files for your viewer for +help. + +Clicking + is equivalent to using +the menubar. + + + + + + +FileDocument Information + + + +Opens a window that lets you enter information related to +the document (such as author's name, address, phone numbers, +document abstract, &etc;). This information is saved with the document for later +classification. +For more information, see Document Information. + + + + + + +&Ctrl;W +FileClose + + + +Close the file you are currently working on. If you have +not saved your most recent changes, you will be +prompted. +Typing &Ctrl;W +is equivalent to using the menubar. + + + + + + +&Ctrl;Q +FileQuit + + + +Quits &kword;. +Typing &Ctrl;Q is equivalent to +using the menubar. + + + + + + + +<guimenu>Edit</guimenu> Menu + +By clicking on the Edit menu, you can +cut/copy/paste text, undo or redo edits and perform searches and text +replacement. + + + + + +&Ctrl;Z +EditUndo + + + + +Reverses the last action you performed. Not all +actions can be reversed. If you are not able to Undo the last action, +the Undo option will be displayed gray and is +not accessible. For a more thourough +discussion of Undo/Redo, click +here. + +Typing &Ctrl;Z or clicking + + is equivalent to using +the menubar. + + + + + +&Ctrl;&Shift;Z +EditRedo + + + +Reverses the last Undo performed. If the Redo +option is unavailable, the Toolbar will display this items gray. For a more thourough discussion of Undo/Redo, +click here. +Typing &Ctrl;&Shift;Z +or clicking + + is +equivalent to using the menubar. + + + + + + + +&Ctrl;X + +EditCut + + + +Deletes the highlighted text from the document, and places +a copy in the clipboard. For a more complete directions on +cutting and pasting, and a full description of the clipboard, click here. + +Typing &Ctrl;X or clicking + + + + is equivalent to using the menubar. + + + + + + + +&Ctrl;C + +EditCopy + + + +Places a copy of the highlighted text in the clipboard, +without changing the text in the document. For a more complete +directions on cutting and pasting, and a full description of the +clipboard, click here. + +Typing &Ctrl;C or clicking + is equivalent to using +the menubar. + + + + + + + +&Ctrl;V + +EditPaste + + + +Inserts a copy of the clipboard into the current cursor +position. If there is highlighted text, &kword; replaces +replaces all highlighted text with the contents of the clipboard. The +clipboard is not altered. For a more complete directions on cutting and pasting, +and a full description of the clipboard, click here. + +Typing &Ctrl;V or clicking + is equivalent to using +the menubar. + + + + + + + +&Ctrl;A + +EditSelect All + + + +Immediately highlights all text of the current +frameset. + +Typing &Ctrl;A is equivalent to +using the menubar. + + + + + + + +EditSelect All Frames + + + +Immediately selects all frames in the current document. + + + + + + + +EditSelect Frame + + + +Selects the current text frame in the document. + + + + + + + + +&Ctrl;F + +EditFind... + + + +Allows you to search for a series of characters. +The find features of &kword; are covered in more detail under Searching for Text. + +Typing &Ctrl;F or clicking + is equivalent to +using the menubar. + + + + + +F3 + +EditFind Next + + + +Repeat the last search for characters starting at the current cursor position. +The find features of &kword; are covered in more detail under Searching for Text. + +Typing F3 is equivalent to +using the menubar. + + + + + +&Shift;F3 + +EditFind Previous + + + +Repeat the last search for characters starting at the current cursor position and moving backwards. +The find features of &kword; are covered in more detail under Searching for Text. + +Typing &Shift;F3 is equivalent to +using the menubar. + + + + + + +&Ctrl;R + +EditReplace... + + + +Allows you to replace one or more characters with +another set of characters. The find and replace features of &kword; are covered +in more detail under Replacing +Text. +Typing &Ctrl;R is equivalent to +using the menubar. + + + + + +EditDelete Page + + + +Delete the current page. + + + + + +<guimenu>View</guimenu> Menu + + + + +ViewNew View + + + +This will create a new view of your document. +For more information on views, refer to the section entitled Using Multiple Views. + + + + + + + +&Ctrl;&Shift;W + +ViewClose All Views + + + +This will close all views including the current view. This will also quit &kword;. +For more information on views, refer to the section +entitled Using Multiple Views. + + + + + + +ViewSplit View + + + +This will split the current view. The orientation of the +split is determined by the Splitter +Orientation. For more information on views, refer to the +section entitled Using Multiple +Views. + + + + + + +ViewRemove View + + + +This will close the current view. For more +information on views, refer to the section entitled Using Multiple Views. + + + + + + +ViewSplitter Orientation + + + +This determines whether split views are oriented +horizontally or vertically. Click on this option, and you are +presented with a submenu with 2 options: +Vertical and +Horizontal. For more information on views, +refer to the section entitled Using Multiple +Views. + + + + + + +ViewDisplay Mode + + + +When this option is selected, a submenu opens with 3 options: + +Page Mode - &kword; will show you how your page looks in a WYSIWYG environment. This is the standard view +for editing your document. +Preview Mode - This changes &kword; from a single page view, to a multiple page view suitable for evaluating document flow and formatting. +The number of pages shown in preview mode can be adjusted. +Text Mode - When this option is selected, &kword; will only show the text of your document. + + + + + + +ViewFormatting Characters + + + +Clicking on this option toggles the display of formatting +characters. Selecting this option will display non-printable characters +(spaces, character returns, and tab stops). Selecting this option again +will turn the display of these characters off. +Which formatting characters are visible can be configured in the +&kword; configuration dialog. + + + + + + +ViewFrame Borders + + + +Clicking on this option toggles the display of the borders +to frames. Normally, &kword; draws a gray line around each frame, so +you can see the borders of the frames. If you want this option turned +off, you can select this option. Selecting this option again will turn +the borders back on. + + + + + + +ViewShow/Hide Doc Structure + + + +Clicking on this option toggles the display of the document +structure window. For more information, refer to the section entitled +Document Structure. + + + + + + +ViewShow/Hide Rulers + + + +Selecting this option will toggle the rulers off. +Selecting this option again will turn rulers on. More +information on rulers can be found under Using rulers. + + + + + + +ViewShow/Hide Grid + + + +Selecting this option will toggle the grid on. +Selecting this option again will turn grid off. + + + + + + +ViewSnap to Grid + + + +Selecting this option will toggle the snap to grid on. +Selecting this option again will turn snap to grid off. A checkmark before +the menu entry will show you the current status of this option. + + + + + + + +ViewZoom + + + +Selecting this option will let you increase or decrease +the page magnification. Selecting a zoom value larger than 100 percent +causes the text and pictures to appear larger. Selecting a zoom value +smaller than 100 percent will cause the text and pictures to appear +smaller. + + +The zoom value does not affect the final output of the text or +pictures. This option is intended to help you edit and layout your +documents. + + + + + + + +<guimenu>Insert</guimenu> Menu + + + + + +&Alt; &Shift; C + +InsertSpecial Character... + + + +Opens a dialog box which allows you to select characters +not found on the keyboard. +Typing &Alt; &Shift; +C is equivalent to using the menubar. + + + + + + + +&Ctrl;Return + +InsertPage Break + + + +This will enter a special character which will force text +into the next connected text frame (Page Layout Templates) or the next page (Text Oriented Templates). More information can be +found at Page Breaks located in the Working with Frames +section. + +Typing &Ctrl;Return is equivalent to +using the menubar. + + + + + + +InsertPage + + + +This option will insert a new page at the current cursor position. + + + + + +InsertFootnote/Endnote... + + + +This will insert a footnote or endnote at the current cursor +position. More detailed information can be found in Footnotes and Endnotes. + + + + + + +InsertTable of Contents + + + +This will insert or update a table of contents at the current cursor +position. More detailed information can be found in Table of Contents. + + + + + + +InsertVariable + + + +Selecting this option will allow you to insert page +numbers, date, time, author information, &etc; You can find +specific information about page numbers here. More information about Date and +Times can be found under Inserting the Date +and Time. More information on other variables can be found in Document Variables. + + + + + + +InsertExpression + + + +Selecting this option will allow you to insert common +phrases. The phrases are organized into categories. For +information on using and adding expressions refer to the section +entitled Expressions. + + + + + + +InsertLink... + + + +Allows you to connect text to an external web page, +email address or files +For more information refer to the section entitled +Document Links. + + + + + + +InsertComment... + + + +Allows you to add comments to selected text. +For more information refer to the section entitled +Document Comments. + + + + + + +InsertFile... + + + +Allows you to insert another &kword; file within the document. +For more information refer to the section entitled +Inserting Files. + + + + + + +InsertBookmark... + + + +Allows you to mark your place in the document for easy retrieval. +For more information refer to the section entitled +Document Bookmarks. + + + + + + + +F5 + +InsertTable... + + + +This will allow you to create a table in the current +cursor location. For more information, please see the section entitled Tables. + +Typing F5 or +clicking are +equivalent to using the +menubar. + + + + + + + +&Shift;F5 + +InsertPicture... + + + + This option will let you create a new frame, and +automatically insert a picture from a file into the new frame. +After selecting this menu item or toolbar button, a dialog box will be +opened, so you may select the picture file from your system. (For help +with this dialog box, please see Inserting Graphics.) Once you have +selected the file you want, click on the OK +button. &kword; will close the dialog box, and your cursor will change +to cross hairs. Locate the cursor on the page where you would like to +locate one corner of your picture. Click and hold the +&LMB;, then drag the mouse. +This will create a border which represents the final size of the picture +in your document. When you are happy with the size of the picture, +release the mouse button and the picture will be inserted in your new +frame. +Typing &Shift;F5 or +clicking +is equivalent to using the menubar. + + + + + + + +F10 + +InsertText Frame + + + +To create a new text frame. After selecting this +option, your cursor will change to cross hairs. Choose the location of +one corner of your new text frame. Click on the +&LMB; and hold the button down. +Drag the mouse, until you have the desired text frame. When you have +the correct shape and size, release the mouse button. &kword; will now +bring up a dialog box with options to connect this text frame to other +frames in your document. For more information on this subject, see +Working with Frames. + +Typing F10 or +clicking is equivalent to using the +menubar. + + + + + + + +F4 + +InsertFormula + + + +Insert a formula into the document. More +information on formulas in &kword; can be found here. + +Typing F4 or +clicking are +equivalent to using +the menubar. + + + + + + +InsertObject Frame + + + +Creates a new frame, and opens a dialog box listing each +of the &koffice; applications. This will allow you to insert any data +into your &kword; document. +Clicking is equivalent to +using the menubar. + + + + + + +InsertScan Image... + + + +Allows you to access your scanner for inserting pictures into your document. For more information see +the section entitled Using a picture from a scanner. + + + + + + + +<guimenu>Format</guimenu> Menu + + + + + +FormatDefault Format + + + + Automatically changes all formating back to the +default settings for the selected text. +The default format can be set with the Document Configuration options. + + + + + + + + +&Alt;&Ctrl;F + +FormatFont... + + + + Allows you to change the formatting characteristics of +the selected text. For more details, go to Formating Characters + +Typing &Alt;&Ctrl;F is equivalent to +using the menubar. + + + + + + + +&Alt;&Ctrl;P + +Format +Paragraph... + + + +To change the indenting, spacing between paragraphs, text flow, +tab stops, numbering and borders. For more details, go to Formating Paragraphs. +Typing &Alt;&Ctrl;P is equivalent to +using the menubar. + + + + + + +FormatFootnote... + + + +Allows you to change the look of your footnotes. +For more information see +Footnotes. + + + + + + +FormatFormula + + + +Allows you to format the selected formula. For +more information go to Formulas + + + + + + +FormatStyle + + + +Allows you to select a style for the selected text. Selecting this option shows a submenu +listing all available paragraphs styles. Select the correct style and the paragraph style will be changed. +For more +information go to Text Styles. + + + + + + + +&Alt;&Ctrl;S + +FormatStyle Manager... + + + +Opens a dialog to allow you to format, add and delete +styles. For more information go to StylesTyping &Alt;&Ctrl;S is equivalent to +using the menubar. + + + + + + +FormatImport Styles... + + + +Allows you to import a style. For more information go to Text Styles. + + + + + + +FormatCreate Style From Selection... + + + +Uses the currently selected text to create a new style. +For more +information go to Text Styles. + + + + + + +FormatPage Layout... + + + +Use this to alter the properties of the printed page, +including size, headers and footers. For more details, go to +Formating the Page + + + + + + +FormatEnable/Disable Document Headers + + + +Selecting this option will toggle headers on. +Selecting this option again will turn headers off. More +information on headers and footers can be found under Headers and Footers. + + + + + + +FormatEnable/Disable Document Footers + + + +Selecting this option will toggle footers on. +Selecting this option again will turn footers off. More +information on headers and footers can be found under Headers and Footers. + + + + + + + + + + +<guimenu>Frames</guimenu> Menu + + + + + +FramesFrame/Frameset Properties... + + + +Allows you to configure basic formating options for the +frameset. More information on this subject can be found in +Setting properties for +frames. + + + + + + +FramesDelete Frame + + + +This will allow you to delete the entire frame, and all of +the text and objects contained within the frame. + + + + + + + +&Ctrl;&Shift;R + +FramesRaise Frame + + + +This will allow you to raise the frame up one level. For more information see the section entitled +Raise and Lower frames. +Typing &Ctrl;&Shift;R is equivalent to +using the menubar. + + + + + + + +&Ctrl;&Shift;L + +FramesLower Frame + + + +This will allow you to lower the frame down one level. For more information see the section entitled +Raise and Lower frames. +Typing &Ctrl;&Shift;L is equivalent to +using the menubar. + + + + + + +FramesBring to Front + + + +This raises the currently selected frame to the top of all overlapping frames. For more information see the section entitled +Raise and Lower frames. + + + + + + +FramesSend to Back + + + +This lowers the currently selected frame to the bottom of all overlapping frames. For more information see the section entitled +Raise and Lower frames. + + + + + + +FramesCreate Linked Copy + + + +Creates a duplicate frame. The contents of the new frame will automatically be updated to match the contents of the old frame. As you continue to edit the document, changes to one of these frames will result in the same changes to the other frame. + + + + + + +FramesConvert to Text Box + + + +Selected text is removed from the current frame. A new frame is created to allow the selected text to be inserted, and the new text frame is inserted into the current document. This is an easy way to remove a section of text and place it in a text box of its own. + + + + + + +FramesFrame Style Manager... + + + +Allows you to edit the frame styles. For more information see the section entitled +Using frame styles. + + + + + + +FramesCreate Framestyle From Frame... + + + +Create a new framestyle based on the currently selected frame. For more information see the section entitled +Using Framestyles. + + + + + + +FramesFramestyle + + + +Allows you to format the selected frame(s) with a predefined framestyle. For more information see the section entitled +Using frame styles. + + + + + + +FramesFrame Background Color... + + + +This will allow you to change the background color of the current frame. + + + + + + +FramesConfigure Frame Border + + + +This will allow you to change the border surrounding the current frame. When selected, a submenu will +appear with all available border styles. Select the correct style and the borders are instantly changed. + + + + + + + + + + + + +<guimenu>Table</guimenu> Menu + + + + + + +TableProperties + + + +Allows you to change the number of rows and columns in a table. For more +on tables, click here. + + + + + + +TableRowInsert Row... + + + +Allows you to insert a row into a table. For more +on tables, click here. +Clicking is +equivalent to using the menubar. + + + + + + +TableRowDelete Selected Rows... + + + +Delete a row from a table. For more on tables, +click here. + +Clicking +is equivalent to using the menubar. + + + + + + +TableColumnInsert Column... + + + +Allows you to insert a column into a table. For +more on tables, click here. +Clicking is +equivalent to using the menubar. + + + + + + +TableColumnDelete Selected Columns... + + + +Delete a column from a table. For more on tables, +click here. +Clicking +is equivalent to using the menubar. + + + + + + +TableColumnResize Column... + + + +Change the width of the currently selected column. For more on changing column widths, +click here. + + + + + + +TableCellJoin Cells + + + +This will convert two (or more) separate cells into a +single cell. For more on tables, click +here. + + + + + + +TableCellSplit Cell... + + + +This will split one cell into multiple smaller cells. For more on tables, click +here. + + + + + + +TableCellProtect Cells + + + +This prevent changes to the data in the selected cells. For more on tables, click +here. + + + + + + +TableUngroup Table + + + +Converts a table into a grid of individual frames. These individual frames are not connected and can be moved independently around the page. For more on tables, click here. + + + + + + +TableDelete Table + + + +Deletes the table the cursor is in. You can +find more about tables in the section entitled Tables. + + + + + + +TableTable Style Manager... + + + +Lets you edit tablestyles. You can +find more about tables in the section entitled Using Tablestyle. + + + + + + +TableTablestyle + + + +Lets you format the currently selected table using a preformatted template. You can +find more about tables in the section entitled Using Tablestyle. + + + + + + +TableConvert Table to Text + + + +Converts data that is currently in the selected table to regular text.. + + + + + + + +<guimenu>Tools</guimenu> Menu + + + + + + +ToolsSpellcheckAutospellcheck + + + +Will toggle automatic spellchecking of the document on and off. + + + + + + +ToolsSpellcheckSpelling... + + + +Will check the spelling of the document. +Clicking is +equivalent to using the menubar. + + + + + + +ToolsAutocorrectionDisable/Enable Autocorrection + + + +Toggles autocorrection on and off. +For more information see the section entitled +Autocorrection. + + + + + + +ToolsAutocorrectionApply Autocorrection + + +&kword; will format your document according to specific rules. +For more information see Manually Applying Autocorrection. + + + + + +ToolsChange Case... + + + +Allows you to set the case of all selected text. +For more information see +Changing Font Case. + + + + + + +ToolsSort Text... + + + +Alphabetizes the selected paragraphs. You will be given the option to sort in ascending or decending order. + + + + + + +ToolsEdit Personal Expressions... + + + +This is for adding and editing expressions. +For information on using and adding expressions +refer to the section entitled Expressions. + + + + + + +ToolsAdd Expression + + + +Creates a new personal expression with the selected text. For more information on personal expresions, +refer to the section entitled Expressions. + + + + + + +ToolsCustom Variables... + + + +This is for editing custom document variables. +For information on using and adding expressions +refer to the section entitled Document variables. + + + + + + +ToolsSelect Bookmark... + + + +Jump to, rename or delete bookmarks. For more information see the section entitled +Document Bookmarks. + + + + + + +ToolsConfigure Mail Merge... + + + +Displays the Mail Merge Setup Dialog. + + + + + + + + +<guimenu>Settings</guimenu> Menu + + + + + + +SettingsToolbars + + + +Allows you to hide or reveal toolbars individually. For more information see +the section entitled Hiding, Changing and Moving Toolbars. + + + + + + +SettingsConfigure Autocorrection... + + + +Allows you to modify the autocorrection options. +For more on Autocorrection, click +here. + + + + + + +SettingsConfigure Completion... + + + +Allows you to modify the autocompletion options. +For more see the section on Autocompletion. + + + + + + +SettingsConfigure Shortcuts... + + + +Allows you to change the keyboard shortcuts. For +details, click here + + + + + + +SettingsConfigure Toolbars... + + + +Allows you to change the toolbars. For details, +click here + + + + + + +SettingsConfigure &kword;... + + + +Allows you to change miscellaneous &kword; +options.For details, click here. + + + + + + + + +<guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + + + +<guilabel>File</guilabel> Toolbar + +The File toolbar consists of 5 buttons. Each button performs a +task from the menubar. Click on that task for more details. + + + + + + + + + + +ButtonCommand + + + + + +Open New File + + + + +Open Saved File + + + + +Save File + + + + +Print File + + + + +Print Preview + + + + + + +<guilabel>Format</guilabel> ToolBar + +The Format toolbar consists of 9 buttons. Each button +performs a task from the format +character dialog. + + + + + + + + + + +ButtonCommand + + +Select Font Face +Character Size +Toggle Bold Text +Toggle Italics +Toggle Underline +Toggle Strikeout +Toggle Superscript Text +Toggle Subscript Text +Change Font Color +Clicking on the letter changes the selected text to the color previewed in the underline. Clicking the arrow to the right of the letter will let you select a new color. + + + + + + +<guilabel>Insert</guilabel> Toolbar + +The Insert toolbar consists of 5 buttons. Each button performs a +task from the menubar. Click on that task for more details. + + + + + + + + + + +ButtonCommand + + + + + +Insert Table + + + + +Insert Picture + + + + +Insert Text Frame + + + +Insert Formula Frame + + + +Insert Object Frame + + + + + + + + +<guilabel>Edit</guilabel> Toolbar + +The Edit toolbar consists of 8 buttons. Each +button performs a task from the menubar. Click on that +task for more details. + + + + + + + + + + + +ButtonCommand + + + + + +Undo + + + + +Redo + + + + +Cut + + + + +Copy + + + + +Paste + + + + +Spell Check + + + + +Find + + + + +Zoom + + + + + + + +<guilabel>Paragraph</guilabel> Toolbar + +The Paragraph toolbar consists of 9 buttons. Each button performs +a task from the menubar. + + + + + + + + + + + +ButtonCommand + + +Select Character Style +Left Text Align +Center Text Align +Right Text Align +Justify Text +Numbered Text paragraphs +Bulleted Text paragraphs +Reduce paragraph indent +Increase Paragraph Indent + + + + + +<guilabel>Table</guilabel> Toolbar + +The Table toolbar consists of 5 buttons. Each button +performs a task from the menubar. Click on that task for more +details. + + + + + + + + + + + +ButtonCommand + + + + + +Set tablestyle + + + + +Insert Row + + + + +Insert Column + + + + +Delete Row + + + + +Delete Column + + + + + + +<guilabel>Border</guilabel> Toolbar + +The Border toolbar consists of 10 buttons. Each button performs a +task from the menubar. Click on that task for more details. + + + + + + + + + + + +ButtonCommand + + +Set framestyle +Toggle border outline +Toggle Left Frame Border +Toggle Right Frame Border +Toggle Top Frame Border +Toggle Bottom Frame Border +Select Border Size +Select Border Style +Select Border Color +Select Background Color + + + + + +<guilabel>Formula</guilabel> Toolbar + +The Formula toolbar consists of 26 buttons. + + + + + + + + + + + +ButtonCommand + + +Add or Change Square Root +Add Fraction +Add to Brackets +Add to Square Brackets +Add to Curly Brackets +Absolute Value +Add Overline +Add Underline +Integral +Change to Sum +Change to Product +Add Matrix +Add Upper Left Index +Add Lower Left Index +Add Upper Right Index +Add Lower Right Index +-Right Facing Characters +-Left Facing Characters +Special Symbols +Insert Column +Append Column +Remove Column +Insert Row +Append Row +Remove Row + + + + + +Selecting Colors from a <guilabel>Select Color</guilabel> dialog +selecting a color + +&kword; uses a common dialog box any time the user needs to select a color for an object (text, backgrounds, borders, etc.). +This section will go into some detail on how to use this color dialog to choose the best color for your object. +When it is necessary to select a color, a dialog box appears. + + + + + + +The color dialog is an incredibly flexible dialog box, which makes it possible to select colors in one of six different methods: + + +Spectrum selectors +The spectrum selectors consists of a square to adjust Hue and +Saturation, and a tall narrow box to adjust Value. +The white cross hairs in the box show the currently selected color on the spectrum. Drag the cross hairs up to increase +saturation. Drag down to decrease saturation. Move the +cross hairs left or right to change the hue. +To adjust the value of the color, use the tall, narrow box to move the black arrow. Sliding the +arrow up increases the color's value. Sliding the arrow down decreases the color's +value. +The currently selected color is visible in the colored square below the Add to Custom Colors button. + + +Hue, Saturation and Value +Using the three spin boxes labeled H,S and V, a user can +specify the Hue (Range 0-359), Saturation (Range 0-255) +and Value (Range 0-255) +respectively. +The currently selected color is visible in the colored square below the Add to Custom Colors button. + + + +Red, Green and Blue +Using the three spin boxes labeled R,G and B, a user can +specify the amount of Red, Green and Blue to be mixed to form the current color. All three boxes can be set to any value from 0-255. +The currently selected color is visible in the colored square below the Add to Custom Colors button. + + + +Palettes +A palette is a group of related colors. These colors are all made available for easy selection according to a meaningful +association. +To select a new palette, click on the combo box at the top of the palette selection area. +You will be presented with several choices: +Recent Colors - This is a list of the most recently used colors in your document. You can use this palette to +maintain consistency. As each new color is selected, it is automatically added to the recent colors palette. +Custom Colors - You can create your own custom palette. This is done by selecting a +color using one of the other +color selection options, and clicking on Add to Custom Colors. +That color is now added to your custom color palette. +Forty Colors - This is a list of 40 commonly used colors. This is a good palette to choose from if some of the people +viewing your document will be on machines with limited color capability. +Web Colors - This is a predefined palette of colors that you might find useful for designing web pages. +Royal Colors - This is a predefined palette of colors including numerous shades of purple and yellow. +Named Colors - This is a list of color names. The names are based on standard X server color +names. The names are designed to give descriptive names to each color. Simply select the name you want. +Once you have selected a palette, you will be presented with a small square showing each color available in the palette. To +select a color from the palette, simply click on the square of the desired color. +The currently selected color is visible in the colored square below the Add to Custom Colors button. + + + +Eye dropper +The eye dropper can be used to sample a color from the screen. +When the eye dropper button is clicked, the cursor becomes crosshairs. Simply place the crosshairs over any spot on the screen +and click once. &kword; will detect the selected color and automatically change the current color to match the selection. +This is especially useful for matching color elements between previously created elements and new items. +The currently selected color is visible in the colored square below the Add to Custom Colors button. + + +HTML code +If you know the HTML color code you want to use, you can enter it into the text box labeled +HTML:. +For more information on HTML color codes, visit the +Web monkey color code page. +The currently selected color is visible in the colored square below the Add to Custom Colors button. + + + +Once the color is selected, click OK to make that the current color for your text, border, etc. +Click Cancel to abort the color selection. + + +Selecting files using the file dialog +using file dialog + +&kword; uses a common dialog box for all file related actions (saving, loading, or selecting new files +for insertion into the document). An example is shown below. + + + + + + +This section will look more closely at this dialog and provided detailed information on its use. + +We will begin at the top of the dialog. + +Toolbar + +The current location on the drive is listed at the top-center of the dialog. This example dialog shows the current folder is /home/mmcbride/kword. If you click on this drop +down box, you will see common and recently visited folders. By +selecting one of these folders, you will be immediately moved to +that folder and the dialog box will update the file list. + +In the upper left corner, is a blue arrow pointed up. This +arrow will take you up one level in the folder structure. + +The next two buttons are back and forward buttons. These +buttons work just like those in an Internet browser. You can use the Back +button to travel to the previous folder, and the Forward button to +advance into a folder you just came from. + +Next to the arrow buttons, is a Reload button. Clicking this +button, causes &kword; to reload the current folder if new files have been +added or deleted. + +To the right of the Reload button, is a blue file folder with a starburst. This button +will let you create a new folder and name it. + +Next to the new folder button, is a button with a star on it. +This button allows you to set and navigate through bookmarks. This is +a quick way to jump to commonly accessed folders. By clicking +this button, a submenu appears which allows you to add bookmarks or +jump to a new bookmark. + +Next to the bookmark button, is a button with a wrench on it. +Clicking this button brings up a sub menu with several entries: + + + +Sorting + +If this option is selected, a submenu will appear allowing you to sort your files by name, date or size. You can sort them forward or reversed. You can also determine if +folders should be listed before files, or mixed within the files. + + + + +Short View + +If this option is selected, only the names of the files and folders will be shown. +Compare this to detailed view. + + + + +Detailed View + +If this option is selected, the names, sizes, dates, permisions, file owners and group ownerships are shown. +Compare this to short view. + + + + +Show Hidden Files + +This will toggle between revealing and hiding normally hidden files. In most cases you will want to leave this option off. + + + + +Show/Hide Quick Access Navigation Panel + +The tall box along the left side of the dialog with a dark grey backround is the Quick Navigation Panel. You can use this option to toggle whether it is visible or not. +More detailed information about hte Quick Navigation Panel is avialable further down this page. + + + + +Show/Hide Preview + +You can use this option to toggle whether the preview panel is visible or not. Typically, the preview panel is left off, but it can be useful when looking for a picture to insert into a document. + + + + +Separate Folders + +Use this option to toggle between a 2 pane view of the filesystem and a one pane view of the filesystem. +Most people will not need to worry about this option as most people prefer the one pane view. + + + + + +Quick Navigation Bar + +Along the left side of the dialog box, is a column that contains +several icons. You can think of each of these icons as a shortcut to +another subfolder. If you click on an icon, you will be immediately +moved to that location. + +You can add/edit or delete entries from the Location Bar. +Simply click with the &RMB; and a small popup menu will appear. + +File Name and Filters + + +The text box labeled Location: contains the current filename Resume.kwd. This text box will contain the +filename of the currently selected file when loading new documents or files into +&kword;. When saving a file, you will enter the desired filename in this text box. + +The text box labeled Filter: shows we are only looking +at &kword; files. By clicking on the combo box, you can select from several +different file formats. You can also select All Supported Files to display +all files that are supported by &kword;. The file types available will change depending on +the specific task at hand. + +If there is a mark in the checkbox labeled Automatically select filename extension, +then &kword; will add the correct filename extension based on your selection in the Filter: +drop down box. If there is no mark in this box, you are responsible for providing an extension. Most users +will leave this box marked. + +There is a Cancel button, if you click this +button, the action will be aborted, and you will return to editing the +document. + +There is an OK button, which will be used +when we have selected the correct filename. + +Using this dialog, you can move through the folder tree to find +any location on your computer. + +To enter a folder click on that folder. To exit that folder, +click the blue up arrow button. + +This dialog box is used in many different tasks in &kword;. The task will determine the exact effect +of the information you have entered into this dialog box. For more information on the exact effect, see the documentation on that task. + + + diff --git a/doc/kword/migrating.docbook b/doc/kword/migrating.docbook new file mode 100644 index 00000000..c224b1f8 --- /dev/null +++ b/doc/kword/migrating.docbook @@ -0,0 +1,15 @@ + + + + +Mike +McBride + + + + +Migrating to &kword; +migrating to &kword; + +To be written + diff --git a/doc/kword/mmerge1.png b/doc/kword/mmerge1.png new file mode 100644 index 00000000..db14e0b8 Binary files /dev/null and b/doc/kword/mmerge1.png differ diff --git a/doc/kword/mmerge1a.png b/doc/kword/mmerge1a.png new file mode 100644 index 00000000..f6aca0c4 Binary files /dev/null and b/doc/kword/mmerge1a.png differ diff --git a/doc/kword/mmerge2.png b/doc/kword/mmerge2.png new file mode 100644 index 00000000..481d2d09 Binary files /dev/null and b/doc/kword/mmerge2.png differ diff --git a/doc/kword/mmergeab1.png b/doc/kword/mmergeab1.png new file mode 100644 index 00000000..cd330602 Binary files /dev/null and b/doc/kword/mmergeab1.png differ diff --git a/doc/kword/mmergekspread1.png b/doc/kword/mmergekspread1.png new file mode 100644 index 00000000..d187ab96 Binary files /dev/null and b/doc/kword/mmergekspread1.png differ diff --git a/doc/kword/mmergesql1.png b/doc/kword/mmergesql1.png new file mode 100644 index 00000000..67f5b99f Binary files /dev/null and b/doc/kword/mmergesql1.png differ diff --git a/doc/kword/mmergesql2.png b/doc/kword/mmergesql2.png new file mode 100644 index 00000000..05d7df32 Binary files /dev/null and b/doc/kword/mmergesql2.png differ diff --git a/doc/kword/mousenav.png b/doc/kword/mousenav.png new file mode 100644 index 00000000..462c6051 Binary files /dev/null and b/doc/kword/mousenav.png differ diff --git a/doc/kword/numtxtbut.png b/doc/kword/numtxtbut.png new file mode 100644 index 00000000..dcccf5ef Binary files /dev/null and b/doc/kword/numtxtbut.png differ diff --git a/doc/kword/opendlg.png b/doc/kword/opendlg.png new file mode 100644 index 00000000..ede758e5 Binary files /dev/null and b/doc/kword/opendlg.png differ diff --git a/doc/kword/opt.docbook b/doc/kword/opt.docbook new file mode 100644 index 00000000..7fb0b588 --- /dev/null +++ b/doc/kword/opt.docbook @@ -0,0 +1,654 @@ + + + + +Mike +McBride + + + + +&kword; Options +&kword;options +configuring &kword; + +This section of the documentation will show you how to configure &kword; to suit your personal work style and preferences. +&kword; can be modified in three separate ways: + +Configure shortcuts +Configure toolbars +Miscellaneous options + + +Configure Key Bindings (keyboard shortcuts) +configuring keyboard shortcuts +keyboard shortcutschanging +configuring key binding +keyboard key bindingchanging + +To configure the keyboard shortcuts select +SettingsConfigure Shortcuts... + from the menubar. + +This will bring up a dialog box. + + + + + + + + +To edit the shortcuts, the first thing you need to do is find +the action you want to edit. All of the possible actions are listed in +the combo box labeled Action. By using the +scrollbar, locate the action you are interested in and click once with +the &LMB;. + +Once you have selected the action, you can turn your attention to +the bottom half of the dialog box. You use the bottom half of the dialog +box to change the shortcuts. + + + +None + +By selecting this option, the currently selected action will not +have any keyboard shortcut. + + + + +Default + +By selecting this option, the currently selected action will use +the default shortcut. Once this option is clicked, the default keyboard shortcut +is listed below. + + + + +Custom + +By selecting this option, you can choose any keyboard combination +as a shortcut for this action. + + + + + +Defining custom keyboard shortcuts +You determine the key combination by clicking on the button with the current +keyboard combination in it. A second dialog will appear: + + + + + + + + +This dialog box allows you to determine two different key combinations +which will trigger the desired action: Primary shortcut: and Alternate shortcut:. + +Defining simple keyboard shortcuts +Begin by deciding if you want to specify the Primary shortcut: or Alternate shortcut: +, by placing a mark in the appropriate radiobutton. + +The button will clear the current keyboard shortcut. + +Now type the keyboard shortcut into the keyboard. &kword; will use this keyboard combination as the new +keyboard shortcut. The window will close automatically. + +Once you have completed your entries, simply click on OK +to accept the changes or Cancel to cancel your changes. + + +Defining multi-key keyboard shortcuts + +Multi-key keyboard shortcuts can be used when you run out of simple keyboard shortcuts. + +Multi-key shortcuts are edited the same as simple keyboard shortcuts, except a mark is placed in the +check box labeled Multi-key mode prior to entering the keyboard shortcut. + +You can now enter multiple keyboard characters for the keyboard shortcut. + +It is important to understand that keyboard combinations +(i.e.: &Alt; &Shift; +P) are still a single character because all the keys are +depressed at the same time. + +An example of a multi-key combination would be if you press &Alt; +X, release both characters then type a +W. This is a multi-key combination. + +Once you have completed your entries, simply click on OK +to accept the changes or Cancel to cancel your changes. + + + + + +Configure Toolbars +configuring toolbars + +To configure &kword;'s toolbars +select SettingsConfigure +Toolbars... from the menubar. + +This will bring up a dialog box. You can add or remove as many +toolbar buttons to as many toolbars as you like. You can also move the +buttons around on the toolbar using this dialog. + + + + + + + + + +Adding a button to a toolbar + +To add a button to a toolbar, you move it from the +Available actions: box to the Current +actions: column. + +First select the toolbar you want to add a button to by selecting +the toolbar from the combo box labeled +Toolbar: + +Now select the action you want to add from the combo box labeled +Available actions: by clicking once with the left +mouse button. + +Click the blue arrow pointing to the +right. + +Once the OK button or the Apply button has been clicked, the toolbars +will change. + + + + +Deleting a button from a toolbar + +To delete a button from a toolbar, you move it from the +Current actions: box to the Available +actions: column. + +First select the toolbar you want to delete a button from by selecting +the toolbar from the combo box labeled +Toolbar: + +Select the toolbar button you want to remove the button from +the combo box labeled Current actions:. + +Click the blue arrow pointing to the +left. + +Once the OK button or the Apply button has been clicked, the toolbars +will change. + + + + +Moving a button on a toolbar + +First select the toolbar you want to move a button on by selecting +the toolbar from the combo box labeled +Toolbar: + +To move a button, simply click on the button you want to move with +the left mouse button. + +Click the up or down arrows to move the button up or down the +toolbar respectively. + +Once the OK button or the Apply button has been clicked, the toolbars +will change. + + + + + +&kword; Options +&kword;options + +To configure options regarding spelling and the user interface +select SettingsConfigure +&kword;... from the menubar. + +This will bring up a dialog box. + + + +Configure &kword; User Interface + +Clicking Interface will allow you to change +the following. + + + + + + + + + +Units: +Select your preferred unit of measurement. &kword; will use these units for all measurements. See +Using Rulers for more information. + + + + +Show status bar +Placing a mark in this check box makes the status bar visible in &kword;. See +The &kword; Screen for more information. + + + + +Show scrollbar +Placing a mark in this check box makes the scrollbar visible in &kword;. See +The &kword; Screen for more information. + + + + +PageUp/PageDown moves the caret +If this check box has a mark, then when you press the PageUp and PageDown keys +on the keyboard, &kword; moves the text cursor (the caret) down one page. If there is no mark in this check box +then &kword; moves the view, but does not change the position of the text cursor. + + + +Number of recent files: + +This determines the maximum number of files that are listed under + FileOpen +Recent command. You can adjust this value +from 1-20. + + + + +Horizontal grid size: +Determines the horizontal size of the grid. When frames and tab stops are placed on the page, they +are placed on a point in the grid. This gives your document a more professional look because elements are effectively +aligned. You can reduce the grid size if you need finer control of your layout. + + + +Vertical grid size: +Determines the vertical size of the grid. When frames are placed on the page, they +are placed on a point in the grid. This gives your document a more professional look because elements are effectively +aligned. You can reduce the grid size if you need finer control of your layout. + + + +Paragraph indent by toolbar buttons: +Use this spin box to determine how far the paragraph is indented when using the increase indent button +() and the decrease indent button +(). + + + +Number of pages per row in preview mode: +Determines the number of pages per row in preview mode. +This determines the size of the pages in preview mode. + + + +When you are happy with the changes, simply click +OK. + +If you click on Cancel, all changes will be +lost. + +Clicking on the Defaults button restores all +values to their default values. + + + +Configure document options + + + + + + + +Document defaults + + +Default column spacing + +Use this to adjust the default spacing between columns. For more information on columns see +Columns. + + + + +Default font: + +Click on the Choose... button, and a new dialog will appear. Use this dialog to +choose the default font. This setting determines the default font used by &kword; until further formatting is done. You can +revert any text to this default by selecting + FormatDefault Format from +the menubar. + + + + +Global language: + +Use this drop down box to determine the default language for the document. This setting is used by the +hyphenation and spelling tools. + + + + +Automatic hyphenation + +Place a mark in this checkbox if you want &kword; to automatically hyphenate long words when it determines the word wrap +in text frames. + + + + + + +Document settings + + +Autosave every (min): + +You can use this to adjust how often &kword; saves a temporary +file. If you set this value to No autosave, &kword; will not autosave. +You can adjust the autosave from 1 minute to 60 minutes. + + + + +Create backup file + +If there is a mark in this checkbox, &kword; will automatically create a backup file everytime you save your document. + + + + +Starting page number: + +Use this text box to determine the starting page number. For more information on page numbering see +Page Numbering. +This is helpful if you have split a single document into multiple files. + + + + +Tab stop: + +Each &kword; document has a default set of tab stops. If you add tab stops to your document, the newly added +tab stops override the default tabstops. You can use this text box to define the spacing between default tab stops. +As an example. If you enter 1.5 in this text box, and the unit of measure is in centimeters, then the +first default tab stop will be located 1.5 cm to the right of the left margin of the frame. The second default tab stop will be located at 3 cm from the +left margin, etc.... + + + + + +Cursor settings + + +Cursor in protected area + +When there is a mark in this check box, and you click in a protected frame of your document, a cursor appears. When the +mark is removed from this check box, and you click in a protected frame, there is no cursor visible. + + + + + + +When you are happy with the changes, simply click +OK. + +If you click on Cancel, all changes will be +lost. + +Clicking on the Defaults button restores all +values to their default values. + + + + + + +Configure Spelling. + +To configure the options for the speller, click on the button +labeled Spelling. + + + + + + + +Each option is detailed below. + + + +Default language: +Used by the spelling application to choose the correct dictionary. + + + + +Enable background spellchecking +If a mark is placed in this checkbox, &kword; will check the spelling of words in your document as you type them. Words that +&kword; believes are misspelled will have a red line drawn under them. + + + + +Skip all uppercase words +If a mark is placed in this checkbox, &kword; will not check the spelling of any word which consists of all capital letters. +This is useful if the document you are working on uses a large number of acronyms. If this box is left unchecked, most of those acronyms +will be incorrectly marked. By placing a mark in this checkbox, &kword; will not mark the acronyms as misspelled. + + + +Skip run-together words +If this box is not checked, and &kword; finds a two words in its dictionary that are placed next to each other, it will be +marked as misspelled. If this box is checked, the combined word will be ignored. +Examples of such words are shutout, +cannot, and blackout. + +Checking this box will help prevent &kword; from +flagging website and email addresses for spelling errors. These +addresses often contain words run together. + + + +Ignoring words +The bottom half of the dialog box allows you to designate specific words (they may be specialized terminology, proper names, etc) which +should be ignored by the spelling program. + +Adding a word to the ignore list +To add a word, type the word in the text box directly below the words Ignore +These Words and click the Add button. + + +Deleteing a word from the ignore list +To remove a word, select the word in the listbox containing all the currently ignored words by clicking on it with +the &LMB;. Now click the Remove button. + + +Changing the order a word appears in the list +To move a word in the list, select the word in the listbox containing all the currently ignored words by clicking on it with +the &LMB;. Now click the Move Up button or the Move Up button to move the word +within the list. + +When you are happy with the changes, simply click +OK. + +If you click on Cancel, all changes will be +lost. + +Clicking on the Defaults button restores all +values to their default values. + + + + + + +Configure formula options + + + + + + +Use this dialog to format the appearance of formulas in &kword;. See the formula documentation for further details. +When you are happy with the changes, simply click +OK. + +If you click on Cancel, all changes will be +lost. + +Clicking on the Defaults button restores all +values to their default values. + + +Configure miscellaneous options + + + + + + + +Misc + + + +Undo/redo limit: +Use this spin box or slider to determine how many actions &kword; keeps in its Undo buffer. Any action that exceeds +this number will be forgotten. + + + + +Display links +Placing a mark in this check box makes document links visible in &kword;. If there is no mark in this check box, +document links will be hidden. See +Document links for more information. + + + + +Underline all links +Placing a mark in this check box will have &kword; automatically underline a document link when it is created. See +Document links for more information. + + + + +Display comments +Placing a mark in this check box makes document comments visible in &kword;. See +Document comments for more information. + + + + +Display field code +If there is a mark in this check box, &kword; shows the variable name of document variables, +rather than the content of the variable in the &kword; +screen. If this check box does not have a mark, then &kword; shows the contents of the variables. +This option does not affect the printed output. The contents of the variables are printed regardless of the state of this +check box. + + + + + +View Formatting + +You can use these four check boxes to determine what formatting characters are displayed when you have asked &kword; to +show formatting characters. + + + +View formatting end paragraph +Toggles the display of paragraph marks (new-line characters) on and off. + + + + +View formatting space +Toggles the display of individual spaces on and off. + + + + +View formatting tabs +Toggles the display of tab stops on and off. + + + + +View formatting break +Toggles the display of frame breaks on and off. + + + + + +When you are happy with the changes, simply click +OK. + +If you click on Cancel, all changes will be +lost. + +Clicking on the Defaults button restores all +values to their default values. + + + +Configure path options + + + + + + +Use this dialog to set the Backup Path and the directory +for your Personal Expression in &kword;. + + +Configure Text-To-Speech options + +See the Text-to-Speech section +in the accessibility chapter for further details. + + + + diff --git a/doc/kword/opt1.png b/doc/kword/opt1.png new file mode 100644 index 00000000..cf32ccc1 Binary files /dev/null and b/doc/kword/opt1.png differ diff --git a/doc/kword/opt2.png b/doc/kword/opt2.png new file mode 100644 index 00000000..45cbf78d Binary files /dev/null and b/doc/kword/opt2.png differ diff --git a/doc/kword/opt3.png b/doc/kword/opt3.png new file mode 100644 index 00000000..b866c8a2 Binary files /dev/null and b/doc/kword/opt3.png differ diff --git a/doc/kword/opt4.png b/doc/kword/opt4.png new file mode 100644 index 00000000..26de4bed Binary files /dev/null and b/doc/kword/opt4.png differ diff --git a/doc/kword/opt5.png b/doc/kword/opt5.png new file mode 100644 index 00000000..35b59a3e Binary files /dev/null and b/doc/kword/opt5.png differ diff --git a/doc/kword/opt6.png b/doc/kword/opt6.png new file mode 100644 index 00000000..05decd5d Binary files /dev/null and b/doc/kword/opt6.png differ diff --git a/doc/kword/optkb.png b/doc/kword/optkb.png new file mode 100644 index 00000000..cf574a40 Binary files /dev/null and b/doc/kword/optkb.png differ diff --git a/doc/kword/optkb2.png b/doc/kword/optkb2.png new file mode 100644 index 00000000..6628c2a9 Binary files /dev/null and b/doc/kword/optkb2.png differ diff --git a/doc/kword/opttb.png b/doc/kword/opttb.png new file mode 100644 index 00000000..833c4afc Binary files /dev/null and b/doc/kword/opttb.png differ diff --git a/doc/kword/pageformat.docbook b/doc/kword/pageformat.docbook new file mode 100644 index 00000000..39500304 --- /dev/null +++ b/doc/kword/pageformat.docbook @@ -0,0 +1,253 @@ + + + + +Mike +McBride + + + + +Formatting the Page + +Before delving into the specifics of formatting a page in &kword;, remember that +&kword; has two separate types of documents: Text Oriented and Page Layout. +Please review The difference between Text Oriented and Page Layout Documents, +if the differences are still unclear. + +This section of the manual is divided into two sub-parts, one for +Text Oriented, the other for Page Layout. + + + Formatting the Page (Text Oriented Document) +text oriented documentformatting the page size +formatting the page size (text oriented document) +text oriented documentformatting the margins +formatting the margins (text oriented document) +headersformatting +footersformatting the page + +When you are working with a Text Oriented Document, you control +the size and shape of the main frame by setting the paper size and the margins. + +Formatting the page is usually done by selecting: +FormatPage Layout... +from the menubar. + + +You can also go straight to the +Page Layout options by selecting the main frame of the document and then double clicking on either of the +rulers. + + +A dialog box will appear with three tabs, labeled Page Size & Margins, Columns and Header & and Footer. + +The Page Size & Margins tab is for altering +the paper size, and changing the margins. + + + + + + + + +First you will notice, that a preview box appears on the right +half of this dialog. This will approximate the +final look of your document. It is updated with each change, and should +be used as a guide for your changes. + +On the left, the dialog displays the current unit of measurement. +This unit of measurement is the same unit of measurement +you use for your document rulers. (In this example, we are using +inches.) To change the units, follow the instructions in the section entitled +Using Rulers. + +The dialog section labled Page Size is used to specify +the paper size for the document. +&kword; includes many predefined paper sizes. Select the appropriate paper size with the drop down +box labeled Size. + +In addition to standard paper sizes, there are two selections that +deserve special mention. + + +Screen +This format is used to generate a document where +each page has an aspect +ratio (shape) which matches the aspect ratios of computer +monitors. This might be useful for documents which will never be printed, but will appear only on a computer screen. + + + +Custom +You can select this option to specify a unique paper size. +Once selected, two text +entry boxes (labeled Width: and +Height:) become active. Enter the height and width of your desired paper size in these text boxes. + + + +Below the page size, are two radio boxes in the section labeled +Orientation you can select either Portrait or Landscape layout for +your document. + +Below the page orientation, is the Margins subsection, which +consists of 4 spin boxes. + +The Margins define the +white-space surrounding the text in your main frame. You can enter any +number from 0 to the maximum size of the page in these boxes. The units +are the same for all four boxes, and is the same as the measurement +listed at the top of the dialog. + +Clicking on the Columns tab allows you to +change the number of columns on each page. Details on multi-column documents +can be found here. + +Clicking on the Header & Footer tab allows the user to +specify header and footer information. + + + + + + + + +This dialog can be broken into two major sections. + +If you are not familiar with Headers and Footers yet, you should +first read the section entitled Headers/Footers + +Headers + +This section lets you determine the placement of headers, and +which pages have which headers on them. + +If you place a mark in front of Different header for the first page, you +will be able to specify a different format for the header on the first page. + +If you place a mark in front of Different header for even and odd pages, +the even pages will use one header, the odd +pages use another header. +You can use this to ensure the page numbers +are always on the outside of the page, or to list the title of the +document on odd pages and the chapter number on the even pages. + +In the spin box labeled Spacing between header and +body:, you can specify how much empty space should be placed +between the bottom of the header, and the top of the main frame. + +Footers + +This section lets you determine the placement of footers, and +which pages have which footers on them. + +If you place a mark in front of Different footer for the first page, you +will be able to specify a different format for the footer on the first page. + +If you place a mark in front of Different footer for even and odd pages, +the even pages will use one footer, the odd +pages use another footer. + +In the spin box labeled Spacing between footer and +body:, you can specify how much empty space should be placed +between the top of the footer, and the bottom of the main frame. + +Footnote/Endnote + +The bottom spin box is labeled Spacing between footnote and body:. As the label +suggests, you can use this text +box to specify the distance between the bottom edge of the main frame, and the top edge of the footnotes. For more information on +footnotes, see the section entitled footnotes. + +When you are satisfied with the changes you are ready to make, +click OK. + +If you click Cancel, all your changes will +be ignored. + + + + + Formatting the Page (Page Layout Document) +page layout documentformatting the page size +formatting the page size (page layout document) + +When you are working with a Page Layout Document, you control the +size and shape of all the frames individually. + +Formatting the page is usually done by selecting: +FormatPage Layout... +from the menubar. + + +You can also go straight to the Page +Layout options by double clicking on either of the +rulers. + + +A dialog box will appear. + +The Page Size & Margins tab is for altering +the paper size, and changing the margins. + + + + + + + + +First you will notice, that a preview box appears on the right +half of this dialog. This will approximate the +final look of your document. It is updated with each change, and should +be used as a guide for your changes. + +On the left, the dialog displays the current unit of measurement. +This unit of measurement is the same unit of measurement +you use for your document rulers. (In this example, we are using +inches.) To change the units, follow the instructions in the section entitled +Using Rulers. + +The dialog section labled Page Size is used to specify +the paper size for the document. +&kword; includes many predefined paper sizes. Select the appropriate paper size with the drop down +box labled Size. + +In addition to standard paper sizes, there are two selections that +deserve special mention. + + +Screen +This format is used to generate a document where +each page has an aspect +ratio (shape) which matches the aspect ratios of computer +monitors. This might be useful for documents which will never be printed, but will appear only on a computer screen. + + + +Custom +You can select this option to specify a unique paper size. +Once selected, two text +entry boxes (labeled Width: and +Height:) become active. Enter the height and width of your desired paper size in these text boxes. + + + +Next to the paper format, in the section labeled +Orientation you can select either Portrait or Landscape layout for +your document. + +Below the page format options, is the Margins subsection, which +consists of 4 entry boxes. All options in this subsection are disabled in Page Oriented documents. + + + diff --git a/doc/kword/paratb.png b/doc/kword/paratb.png new file mode 100644 index 00000000..cbdd6667 Binary files /dev/null and b/doc/kword/paratb.png differ diff --git a/doc/kword/part-kformula.png b/doc/kword/part-kformula.png new file mode 100644 index 00000000..7f38e7bd Binary files /dev/null and b/doc/kword/part-kformula.png differ diff --git a/doc/kword/part-kspread.png b/doc/kword/part-kspread.png new file mode 100644 index 00000000..93fb3503 Binary files /dev/null and b/doc/kword/part-kspread.png differ diff --git a/doc/kword/picture.png b/doc/kword/picture.png new file mode 100644 index 00000000..eba247ce Binary files /dev/null and b/doc/kword/picture.png differ diff --git a/doc/kword/pntdlg.png b/doc/kword/pntdlg.png new file mode 100644 index 00000000..9a90d6fc Binary files /dev/null and b/doc/kword/pntdlg.png differ diff --git a/doc/kword/pntdlg1.png b/doc/kword/pntdlg1.png new file mode 100644 index 00000000..d70273f0 Binary files /dev/null and b/doc/kword/pntdlg1.png differ diff --git a/doc/kword/portrait.png b/doc/kword/portrait.png new file mode 100644 index 00000000..f1541de9 Binary files /dev/null and b/doc/kword/portrait.png differ diff --git a/doc/kword/rarrow.png b/doc/kword/rarrow.png new file mode 100644 index 00000000..11a8ada5 Binary files /dev/null and b/doc/kword/rarrow.png differ diff --git a/doc/kword/rbord.png b/doc/kword/rbord.png new file mode 100644 index 00000000..20709166 Binary files /dev/null and b/doc/kword/rbord.png differ diff --git a/doc/kword/redo.png b/doc/kword/redo.png new file mode 100644 index 00000000..934e5871 Binary files /dev/null and b/doc/kword/redo.png differ diff --git a/doc/kword/repldlg.png b/doc/kword/repldlg.png new file mode 100644 index 00000000..2efdfc02 Binary files /dev/null and b/doc/kword/repldlg.png differ diff --git a/doc/kword/rowin.png b/doc/kword/rowin.png new file mode 100644 index 00000000..fefbcd16 Binary files /dev/null and b/doc/kword/rowin.png differ diff --git a/doc/kword/rowout.png b/doc/kword/rowout.png new file mode 100644 index 00000000..b82f870f Binary files /dev/null and b/doc/kword/rowout.png differ diff --git a/doc/kword/rtab.png b/doc/kword/rtab.png new file mode 100644 index 00000000..8fc40bcf Binary files /dev/null and b/doc/kword/rtab.png differ diff --git a/doc/kword/rtab2.png b/doc/kword/rtab2.png new file mode 100644 index 00000000..9ce5569f Binary files /dev/null and b/doc/kword/rtab2.png differ diff --git a/doc/kword/ruler.png b/doc/kword/ruler.png new file mode 100644 index 00000000..e1479538 Binary files /dev/null and b/doc/kword/ruler.png differ diff --git a/doc/kword/saturation.png b/doc/kword/saturation.png new file mode 100644 index 00000000..44475821 Binary files /dev/null and b/doc/kword/saturation.png differ diff --git a/doc/kword/saved1.png b/doc/kword/saved1.png new file mode 100644 index 00000000..ce392844 Binary files /dev/null and b/doc/kword/saved1.png differ diff --git a/doc/kword/saved2.png b/doc/kword/saved2.png new file mode 100644 index 00000000..05d9647e Binary files /dev/null and b/doc/kword/saved2.png differ diff --git a/doc/kword/savedlg.png b/doc/kword/savedlg.png new file mode 100644 index 00000000..ee5966a6 Binary files /dev/null and b/doc/kword/savedlg.png differ diff --git a/doc/kword/savetmpl1.png b/doc/kword/savetmpl1.png new file mode 100644 index 00000000..3bfccf0f Binary files /dev/null and b/doc/kword/savetmpl1.png differ diff --git a/doc/kword/scan.png b/doc/kword/scan.png new file mode 100644 index 00000000..0746bfa4 Binary files /dev/null and b/doc/kword/scan.png differ diff --git a/doc/kword/scan2.png b/doc/kword/scan2.png new file mode 100644 index 00000000..caec3df8 Binary files /dev/null and b/doc/kword/scan2.png differ diff --git a/doc/kword/screen.png b/doc/kword/screen.png new file mode 100644 index 00000000..e6f199c1 Binary files /dev/null and b/doc/kword/screen.png differ diff --git a/doc/kword/select1.png b/doc/kword/select1.png new file mode 100644 index 00000000..b3500213 Binary files /dev/null and b/doc/kword/select1.png differ diff --git a/doc/kword/spell.png b/doc/kword/spell.png new file mode 100644 index 00000000..0a3cb23e Binary files /dev/null and b/doc/kword/spell.png differ diff --git a/doc/kword/spelldlg.png b/doc/kword/spelldlg.png new file mode 100644 index 00000000..727b86dd Binary files /dev/null and b/doc/kword/spelldlg.png differ diff --git a/doc/kword/stkout.png b/doc/kword/stkout.png new file mode 100644 index 00000000..b7b7e014 Binary files /dev/null and b/doc/kword/stkout.png differ diff --git a/doc/kword/storeprint.docbook b/doc/kword/storeprint.docbook new file mode 100644 index 00000000..1289f39a --- /dev/null +++ b/doc/kword/storeprint.docbook @@ -0,0 +1,476 @@ + + + + +Mike +McBride + + + + +Detailed Guides: Document Creation, Storage, and Printing + +This section of the documentation will cover everything you need +to know about starting a new document, saving a document, retrieving a +saved document and printing a document. + + +Beginning a New Document +create new document +Starting a new document can be done 5 ways: + + + +You can start &kword; from the +&kde; Panel. + + + +You can start &kword; from the +command line by typing$kword & + + + + +You can begin a new document in &kword; by selecting +FileNew from +the menubar. + + + +You can use the keyboard shortcut: &Ctrl;N + + + +or by clicking on the +toolbar. + + + + +However you begin a new document, a dialog box appears: + + + + + + + +This dialog box allows you to: + + + +Start a new document from a +template + + +Open an existing +document + + +Open a recent +document + + +&kword; remembers your previous choice. That previous choice will be the current default option. + + + +Starting a new document from a template + +In order to start a new document based on a template, you must +first choose which template you want to use. + + +Use the icons located along the left edge of the dialog box to select your template group. Simply click with the &LMB; to select that group and +display all the available templates of that group. + + +Remember templates are either Text Oriented (Blank Document) or Page Layout +templates. If you need to review the differences, click here. + +Once you have selected the icon, you are shown all the available +templates, each with a title and a small icon which shows you the +general layout of the template. + + +&kword; comes with four standard template groups. You can add +new icons by installing outside templates, or creating templates of your +own. + + +To select your template, click on it with the &LMB;. The +selected template will be highlighted. +Confirm your choice by clicking +the Use This Template button. This will begin a new document +with that template. + + + +For faster access to a template, simply double click on the +template, and &kword; will immediately load that template. + + + + +Opening an existing document + +Click on the Open Existing Document... button, and an new +dialog box is revealed. For more details on this dialog box refer to +Using the file selection dialog. + + +Open a Recent Document +&kword; keeps track of the most recently edited documents. You can select one of these documents by clicking on the icon labeled +Recent Documents. This will list the most recently edited files on the system. Simply click on the icon of the desired file with the +&LMB; and click Open This Document. + + + + + + + + + +Saving a Document +saving a document +Once you have entered text and data into a document, you will +usually want to save this to a file on your hard drive. + +&kword; can create a .pdf file for you. For instructions see +How do I create a .pdf file? + + + +The <guimenuitem>Save</guimenuitem> Command +The Save command can be invoked 3 ways: + + + +By selecting +FileSave from +the Menubar + + + +You can use the keyboard shortcut: &Ctrl;S + + + +or by clicking on the toolbar. + + + +Any of these methods results in the same action by &kword;. + +By selecting the Save command, you are +instructing &kword; to save the file under the current filename. You +will not be given the option to change the filename or its location. If +you want to change the name of the file, or where it is saved, you must +select +FileSave +As... from the Menubar. + +If you have not saved this file before, it does not have a +filename. &kword; automatically executes the Save As... +command so you can provide a file name. + +&kword; does not report a successful save. Therefore, if the file +was saved without incident, &kword; will return you to editing your +document. + +You can verify that the file was saved, by checking the titlebar. +If there are unsaved changes, the titlebar will have +[modified] in the titlebar. + + + + + + + + + + If the save was +successful, only the filename will be in the titlebar. If there is a +problem with the save, an error box will appear. + + + + + + + + + + + + + +The <guimenuitem>Save As...</guimenuitem> Command +saving a document with new name + +General +The Save As... command can be invoked 2 +ways: + + + +By selecting FileSave +As... from the Menubar + + +or by trying to Save a file which does +not yet have a filename. + + + +The difference between the Save and the +Save As... command, is the Save +As... command prompts you for a filename, and lets you +select a different file format or location. The +Save command simply saves the file in the +previous location. + + +Using the dialog box + +When you select Save As... a dialog appears. + + + + + + + + +For more information on using this dialog, see the section entitled +Using the file selection dialog. + +When you are in the folder you want to save the file in, type a filename into the +Location: box. +&kword; can create a .pdf file for you. For instructions see +How do I create a .pdf file. + + There is no need to put a .kwd at the end of your filename, &kword; +will do this for you. + + +&UNIX; filenames are more flexible than many other operating +systems. Filenames can: + + +be of nearly any length +be any combination of upper and lowercase letters +include spaces and punctuation + + +Filenames should not: + + + +begin with a space or period +end with a common file extension (.ps,.pdf,etc). + + + + +Once you have entered the correct information you can click on +Save to complete the save. + +&kword; does not report a successful save. Therefore, if the file +was saved without incident, &kword; will return you to editing your +document. If there is a problem with the save, an error box will +appear. + + +&kword; will only allow you to save your file where you are +allowed to by the permissions listed by the operating system. If you try +to save outside that area, &kword; will report an error. + + + + + + + +Retrieving a Saved Document +loading a &kword; file + +The Open... command can be invoked 4 ways: + + + + +By clicking the Open Existing Document +tab when Opening a New Document + + + +By selecting +FileOpen... from +the menubar + + + +You can use the keyboard shortcut: +&Ctrl;O + + + +or by clicking +on the toolbar. + + + +Any of these methods results in the same action by &kword;. + +Using the dialog box +When trying to open a file, a dialog appears. + + + + + + + + +For more information on using this dialog, see the section entitled +Using the file dialog. + +Use this dialog to locate the document you want to load. Once located, click +once with the &LMB; on the filename. Once the filename is selected click OK. The file will be loaded. + +There is a Cancel button, if you click this +button, the load will be aborted. + + + + +Printing A Document +printing a document +The Print... command can be invoked 3 ways: + + + +By selecting +FilePrint... +from the menubar + + +You can use the keyboard shortcut: +&Ctrl;P + + +or by clicking +on the toolbar. + + + +No matter how you do this, the &kde; print dialog will +appear. + + + + + + + + +The top combo box labeled Name: shows the +currently selected printer. To configure this printer click on the +Properties button. + +To select a different printer, click on the combo box and +select the desired printer. + +If you want to print your output into a postscript file, to a PDF file, +a fax modem (to send it as a fax) or email the file as a PDF file, select +the appropriate option from the combo box labeled Name. Once that option has been selected, enter +the filename into the text box labled Output file:. + +The line labled State tells you if your printer is currently connected and if it is printing another page. You can not change any information on this line. + +The lines labled Type and Location tells you what type of printer is currently selected and where that printer is located. You can not change any information on these lines. + + + +The line labled Comment describes how +&kword; interacts with your computer (what driver and print system it is using). You can not change anything on this line. Complete setup of the &kde; +printing system is beyond the scope of this document. For more information see the &kde; +print web site at http://printing.kde.org. + +If you want to print all pages of your document and only one copy, you can click +Print. If you want to change the number of copies or only print selected +pages, click the Options >> button. + +The System Options button allows a user to change the setup of the printers and &kde; print system. This is also beyond the scope of this manual. +If you need to make changes please refer to the &kde; print web site at http://printing.kde.org. + +Depending on which printing system your computer uses, you may find that you have +more printing options then those described below. What is described here, is available on +most systems. + +Once you click Options >>, the dialog box changes to: + + + + + + + + +Under Page Selection, you can select either +to print the whole document (select All), print the page the cursor is +located on (simply select Current), or print a range of pages. If you select the +Range option, enter your page range in the text box +provided. (Example: 3-13) + +In the combo box labeled Page set: you can tell &kword; to +print the Even Pages, the Odd Pages or +All Pages. + +In the box on the right labeled Copies:, you should set the number of copies +you want printed. You can either enter the number directly into the +box, or use the arrows to adjust the number. &kword; can print a maximum +of 999 copies at once. + +You can have &kde; collate your documents by clicking on the +Collate check box. If selected, &kde; will print +all of the pages for copy 1, then print all the pages for copy 2, &etc; +If not selected, &kde; will print all of the copies of the first page, +then all of the copies of the second page, &etc; + +You can also determine if the document is printed in forward order +(print first page first), or reverse order (print last page +first). + +If you click on Options <<, the print dialog will +compress down to the previous view. + +Depending on your systems setup, you may have additional options available to you. These options are discussed at http://printing.kde.org. + +When you are satisfied with your selections, you can click +OK to print. + +If you click on Cancel, the printing will +be aborted. + + + + diff --git a/doc/kword/styldlg1.png b/doc/kword/styldlg1.png new file mode 100644 index 00000000..8b8d1394 Binary files /dev/null and b/doc/kword/styldlg1.png differ diff --git a/doc/kword/styleimport.png b/doc/kword/styleimport.png new file mode 100644 index 00000000..80e10f42 Binary files /dev/null and b/doc/kword/styleimport.png differ diff --git a/doc/kword/styles.docbook b/doc/kword/styles.docbook new file mode 100644 index 00000000..3f0043a6 --- /dev/null +++ b/doc/kword/styles.docbook @@ -0,0 +1,351 @@ + + + + +Mike +McBride + + + + +Text styles +text stylesintroduction + +Introduction to text styles +When you build documents that are more complex than a business +letter, such as a book, newsletter, or resume, the document is often +broken down into sections. Each of these sections may have a similar +appearance. + +You can use text styles to easily keep a consistent look throughout +your document. + + +If you are familiar with Styles in &Microsoft; +Word, &kword; text styles perform similar functions in &kword;. +You can skip to the next section. + + +Lets look at a section of a document and try to identify appropriate text styles: + + + + + + + + +In this example, you can see several different text styles at work: + + +The title is centered, underlined and in bold text +The section title (Income) is boldfaced. +The caption for figure 1-1 is smaller than normal text and boldface. +The rest of the document is in a standard font. + + + +We do not need to know exactly how we want the text and paragraphs +of these sections to look yet. All we need to do is identify these +sections of text as Section Titles, Normal +Text, etc. + +Once we have finished the document, you can change the look of all +the text labeled Section Title all at once. + +This will ensure that all section titles appear consistent +throughout your document. + +&kword; has 8 predefined text styles. + +Text styles should not be confused with table styles or +frame styles. +Text styles determine how the characters and paragraphs appear. Framestyles, control the borders and background color for the +frame. Tablestyles determine how tables appear in the finished document. + + + +Changing the text style of text +text styleschanging text style of selected text + +To change the text style of text, first, select +the text you want the changes to apply to. + +You can now change the text style in one of two ways: + + + +Select +FormatStyle +from the menubar. This will show the list of available text styles, select +the text style from the list. + + + +You can select the text style using the combo box on the Paragraph toolbar. +This combo box looks like this: . + + +Simply select the new text style from the list provided. + +You can change the text style of an entire paragraph. Simply place the cursor in a paragraph (making sure that +no characters are selected) and select a new style. Every character in the paragraph will be converted to the new text style. + + + +Creating a text style +text stylescreating + +If you plan on using text styles extensively in a large document, you +will probably want to create new text styles specific for your needs. + + +There are two ways to create a new text style: + + +Create a text style based on another text style using a dialog. +Format a block of text to the desired format, +then create a text style based on that text. + + + + +Creating a new text style based on a current text style +To create a new text style select +FormatStyle Manager... +from the menubar.This will bring up a dialog box. + + + + + + + +In the list box on the left, is a list of all the currently defined text styles. Select the current style that most closely resembles the new +text style. Click on that text style once with the &LMB;. + +Click the New button. + +&kword; will create a new text style based on the selected text style. It will assign it a temporary name [New Style Template (8)]. + +Type a descriptive name in the box labeled +Name. This will be the name of the text style. + +The rest of the dialog is used to make the alterations needed to create the new +text style. + +The preview box will show you what your new text style will look +like. + +Use the tabs labeled Font, +Indent & Spacing, General Layout, Decorations, Bullets/Numbers, and Tabulators, to format the text style. + +Click OK to create your new text style. +Click Cancel to abort the creation of the +text style. + + +Changing the Font Size, Type etc. + +The tab labeled Font is used to set the font type, font style, formatting, etc. + +This tab functions identically to the change font dialog used to edit general text. +Changes to this tab affect to +all text formated with this text style. + + + + +Changing Paragraph Spacing and Indents + +The tab labeled Indents & Spacing is used to adjust +spacing between lines, and paragraph indentation. + +This tab functions identically to the same tab in the Format Paragraph dialog. +Changes to this tab affect to +all text formated with this text style. + + + +Changing Paragraph Alignment + +The tab labeled General Layout determines how the text is placed within +the line. With other applications, you may have referred to +this as Alignment, or +Justification. + +This tab functions identically to the same tab in the Format Paragraph dialog. +Changes to this tab affect to +all text formated with this text style. + + + + +Changing Paragraph Borders + +The tab labeled Decorations is used to define and configure graphical borders +around your paragraphs. + +This tab functions identically to the same tab in the Format Paragraph dialog. +Changes to this tab affect to +all text formated with this text style. + + + + +Changing Paragraph Numbering/Bullets + +The tab labeled Bullets/Numbers is used to make all text formatted with this text style into a list. + +This tab functions identically to the same tab in the Format Paragraph dialog. +For more information see the section entitled Lists. + + + + + +Changing Tab-stops. + +Using the tab labeled Tabulators it is possible to define tab stops for the new text style. + +This tab functions identically to the same tab in the Format Paragraph dialog. +For more information see the section entitled Using Tab Stops. + + + + + +Creating a text style based on formatted text +If you have text that is already formatted correctly for a new text style: + +Select the text and select + +FormatCreate Style From Selection... +from the menubar. + +&kword; will prompt you for a name for your text style. Enter the name in the text box. +Click the +OK button. + + A new text style is created with the font, paragraph spacing, paragraph alignment, borders and shadows of the +currently selected text. +Future formatting changes to this selected text will not automatically change the text style you just created. If you want the changes +to become part of the text style, you must edit the text style. + + + + +Deleting a text style +text stylesdeleting + +Deleting an unneeded text style is easy. + + +Select +FormatStyle Manager... +from the menubar.This will bring up a dialog box. + + + + + + + + +From the list of available text styles, select the style you want to +delete by clicking once with the &LMB;. + + +Be sure you have selected the correct text style before you click +Delete. &kword; will not ask for confirmation, +so you will not be given an opportunity to back out. + +Click Delete. +The text style is now deleted. + + + + +Editing a text style +text stylesediting + +The true power of text styles, is the ability to edit the formatting +options of that text style after the text style is defined. +By changing the formatting of the text style, &kword; will immediately change +every paragraph with that text style, and maintain a consistent look to +the document. + +&kword; uses the same interfaces to edit the formatting options of a +text style, that it used to create the text style in the first +place. + +To edit a current text style: + +Select +FormatStyle Manager... +from the menubar.This will bring up a dialog box. + + + + + + + +Select the text style you want to edit from the list on the left by clicking once with the &LMB;. +Now you can make the changes you want to this text style. + +The preview box will show you what your new text style will look +like. + + +Do not change the name of your text style. + +Doing so will delete your current text style from the list (and create +a new one with the new name). + +Any paragraphs which were originally formatted with this text style, +will revert to Standard. + + +Use the tabs labeled Font, +Indent & Spacing, General Layout, Decorations, Bullets/Numbers, and Tabulators to alter the look of the text style. + +Click OK to commit your changes. + +Click Cancel to abort all changes to this +text style. + + + + +Import a text style +text stylesimporting + +&kword; has the ability to import a text style from one &kword; document and include it in the +list of text text styles in another &kword; document. +To import a text style, select FormatImport Style... +from the menubar.This will bring up an empty dialog box. +Click on the Load button. This will bring up a +file selection dialog. Choose the &kword; file you want to import the text style from and click +OK. +The dialog box will now fill with all available text text styles available for import. +If &kword; encounters a duplicate text style name in the selected file, it will append a number to the end of the +text style name to identify the imported style. +As an example, if you import the Standard text style from another &kword; file, &kword; will change +the text style name to Standard-1. +Select all the text style you want to import. Then click +OK. + + + diff --git a/doc/kword/subscbut.png b/doc/kword/subscbut.png new file mode 100644 index 00000000..6d0e55ce Binary files /dev/null and b/doc/kword/subscbut.png differ diff --git a/doc/kword/sum.png b/doc/kword/sum.png new file mode 100644 index 00000000..440c6a95 Binary files /dev/null and b/doc/kword/sum.png differ diff --git a/doc/kword/supscbut.png b/doc/kword/supscbut.png new file mode 100644 index 00000000..04310066 Binary files /dev/null and b/doc/kword/supscbut.png differ diff --git a/doc/kword/table.docbook b/doc/kword/table.docbook new file mode 100644 index 00000000..55faf329 --- /dev/null +++ b/doc/kword/table.docbook @@ -0,0 +1,653 @@ + + + + +Mike +McBride + + + + +Tables +tablesusing + +&kword; has the built in ability to generate tables for the display of data. + +These tables can consist of up to 128 rows and 128 columns, +with text centered or justified differently in different cells. Text flows easily around in the +table and cells are resized (if specified by the user) automatically to fit comfortably around the data. + +Tables in &kword; are for the display of data only. No calculations can be performed. + +Remember, if you need the functions of a spreadsheet, you can embed a &kspread; Table in your +document. + +This section of the document will cover the formatting of tables +created in &kword; only. + +Adding a new Table +tablesadding + +You can create a table in &kword; in one of three ways: + + + + +Select Insert +Table... from the menubar. + + +You can use the keyboard shortcut: F5. + + + +or by clicking +on the toolbar. + + + + +This will open a dialog box. The dialog box has two tabs: Geometry and Templates. + + + + + + + + +This dialog box is divided into two halves. + +The right half of the dialog box provides you a quick visual guide +to how many rows and columns will be created in the table. This is +useful for laying out your table. You cannot edit +your table layout here. + +The left half of the dialog box consists of two combo boxes. + +The spin box labeled Number of +rows:, allows you to specify from 1 to 128 rows in the +table. + +The spin box labeled Number of +columns:, allows you to specify from 1 to 128 columns in the +table. + +While adjusting either of these two options, the preview box +adjusts to your new settings. + + +If you click on the tab labeled Templates, you can use predefined table looks to format the look of your table. +For more information see the section on Using formatting templates. + +Click OK to insert the table. +Click Cancel to cancel this action and return to editing your document. + + + +Moving between cells in a table +tablesnavigating + +You can navigate between cells of the table by using the mouse (simply click in the cell you want to edit), +or by using the keyboard (use the arrow keys to move up, down, left or right one cell at a time). + + + +Deleting a Table +tablesdeleting + +To delete a table in &kword;: + +Place the mouse pointer over the frame of any cell of the table you want to +delete and click once with the &LMB;. + +Be sure you have selected the correct table before continuing. +&kword; will not ask for confirmation. + + +Select TableDelete +Table from the menubar + + +The table will be immediately deleted. + + + +Insert Row in Table +tablesinserting a row + +You can insert a row into any place in a table. + +To insert a row into a table, place the mouse pointer over the border of any cell of the table you want to add +a row to. Using your mouse, select either Table +Row +Insert Row... + from the menubar or +click on the +toolbar. + + +This will bring up a dialog box. + + + + + + + +The spin box labeled Row:, allows +you to select any row within the table. This number selection box +limits you to the rows currently in the table. +Select the row you want to use as a reference. + +Now select either Before or +After as is appropriate. + +Click OK to add the row or click +Cancel to not add any rows. + + + + +Insert Column in Table +tablesinserting a column + +To insert a column into a table, place the mouse pointer over the border of any cell of the table you want to add +a column to. Select either TableColumn +Insert Column... from the menubar or click + on the +toolbar. + +This will bring up a dialog box. + + + + + + + + +The number selection box labeled Column:, +allows you to select any column within the table. This number selection +box limits you to the columns currently in the table. + +Select the column you want to use as a reference. + +Now select either Before or +After as is appropriate. + +Click OK to add the column or click +Cancel to not add any columns. + + + + +Delete Row in Table +tablesdeleting a row + +To delete a row from a table: + +Click once with the &LMB; in any cell in the row you want to delete Then: + + + +select TableRow +Delete Selected +Rows... from the menubar + + +or click on the +toolbar. + + +This will bring up a dialog box confirming that your have selected the correct row(s). + + +Make sure you have selected the correct row(s) before +continuing. +&kword; will delete any data contained within the selected rows. + +Click Delete to delete the row, or click Cancel to not +delete any rows. + + + + +Delete Column in Table +tablesdeleting a column + +To delete a column from a table: + +Click once with the &LMB; in any cell in the column you want to delete Then: + + + +select TableColumn +Delete Selected +Columns... from the menubar + + +or click on the +toolbar. + + + +This will bring up a dialog box confirming that your have selected the correct column(s). + + + +Make sure you have selected the correct column(s) before +continuing. +&kword; will delete any data contained within these columns. + + +Click Delete to delete the column(s), or click +Cancel to not delete any columns. + + + + +Change column width +tableschange column width + +When a table is created, all columns are equal in width. You can change the width of individual columns by using +the mouse or the keyboard. +Using the mouse +First select any cell in the column you want to change, by holding down the &Ctrl; key and clicking once with the &LMB;. +The cell is now surrounded by 8 colored boxes. Place the mouse over the box in the middle of the +right vertical border of the cell. The mouse pointer changes to a double-headed arrow. Click on the box and drag the right edge of the +cell to the desired width. When you release the &LMB;, the entire column will assume the width of this cell. + + +Using the dialog box +First, select any cell in the column you want to change, by holding down the &Ctrl; key and clicking once with the &LMB;. +You can select any cell in the table to change column widths. By selecting a cell in the column you want to change +the dialog box will default to the correct column automatically. +Select TableColumn +Resize +Column... from the menubar. +A dialog box will appear. In the spin box labeled Column:, you can chose a different column to set. +In the spin box labeled Width:, enter the desired width of the column. +Click OK to change the width, or click Cancel to leave the column +width unchanged. + + + + +Join Cells in Table +tablesjoin cells + +A table is traditionally made of a grid of rows and columns, with +equal sized cells throughout the table. + +Sometimes you would like to spread text out over several cells in +a table. This is especially common with titles. + +&kword; allows you to do this by Joining two (or +more) adjacent cells of a table together. + + + + + + + +This is an example of three cells joined together in the middle of +a table. + + +You can join cells vertically, as well as horizontally. + + +To join several cells you must first select the cells. To select the cells, hold down the &Ctrl; key +and click once with the &LMB; +in a cell. Click on the next cell with the &LMB;. Continue +this until you have selected all the cells you want to join together. + + +If you have a number of cells in a row that you want to select, +you can select them in two quick steps: +First hold down the &Ctrl; key and click on one of the end cells. +Now hold down the &Shift; key and click on the cell at the other +end of the row or column you want to join. +All cells between these two cells will be selected. + + + +Once you have selected all the cells you want to join, +select TableCell +Join Cells from the menubar + +The cells will now be joined. + +Any text in the left most frame will now be located in the joined +frame. Any text from any other frames will be deleted. + + + +Split Cells in Table +tablessplit cells + +In addition to combining two or more cells into a single cell, it is easy to split one cell into many cells. + +If you decide that you do not want the previously joined cells to +be joined any longer, you can split them back into individual cells +again. You can also split cells within a column or row. They do not need +to have been previously joined. + +To split a cell, select the cell you want to split by holding the &Ctrl; button down and +clicking on it with the +&LMB;. Select TableCell +Split Cell... from the menubar. + +This will bring up a small dialog box which allows you to set the number of rows and +the number of columns you want to split this cell into. + +Once you have set the correct number of rows and columns in the spin boxes, click +OK to split the cells. Click Cancel to abort. + + + + +Ungroup a Table +tablesungrouping + +If you select a cell in a table and then choose Table +Ungroup Table from the menubar, &kword; will convert each cell in your table +into an individual frame. You can then move these frames around independently on the page. + + + + +Protecting a cell in a table. +tablesprotecting cells + +You can protect any or all cells in a table from accidental modification or deletion. +Simply select the cell(s) you want to protect, then: +Select Table +CellProtect Cells +from the menubar or hold down the &Ctrl; button, click in the cell once with the &RMB; and select + CellProtect Cells +from the popup menu. +You will not be able to change the contents or formatting of that cell. + +To disable the protection, simply repeat the steps above, and the cells will no longer be protected. + + + + +Formating a Table +tablesformating + +There are many aspects of a table that can be formatted. + +For information of formatting text with a table see Format characters. +For information on formatting borders between frames in individual cells, see Borders +For information on formatting background color of individual cells, see Frame background +For information on changing the width of columns, see Resizing Columns + +&kword; also provides the user with a set of tools to help speed up the formatting of tables. + + +Altering the number of rows and columns in a table. +tableschanging geometry + +Previously in the manual, we have discussed how to individually add or delete rows and/or columns. &kword; also provides the +user the ability to make major changes to the number of rows and columns in a table. +Select Table +Properties... +from the menubar. A dialog will appear. + + + + + + + + +You can use this dialog to change the number of rows in your table by using the spin box labeled +Number of rows:. +If you reduce the number of rows using this dialog box, &kword; will delete the bottom row(s) +including the data within the rows.Be sure you do not have any data in these rows +that you need to preserve. +You can use this dialog to change the number of columns in your table by using the spin box labeled +Number of columns:. +If you reduce the number of columns using this dialog box, &kword; will delete the right most column(s) +including the data within the columns.Be sure you do not have any data in these columns +that you need to preserve. +Placing a mark in the check box labeled Reapply template to table, will cause &kword; to re-apply the +template to the table after adding or deleting the specified number of rows and/or columns. +Click OK to make changes permenant, or click Cancel to abort all +changes. + + + + +Selecting an entire column for formatting +To select an entire column for formatting, move the mouse pointer to the white space directly above +the desired column. The mouse pointer will turn from an arrow to a hand. If you click with the &LMB;, the entire column will be selected. + + + +Selecting an entire row for formatting +To select an entire row for formatting, move the mouse pointer to the white space directly to the left of +the desired row. The mouse pointer will turn from an arrow to a hand. If you click with the &LMB;, the entire row will be selected. + + + +Using table templates to format an entire table +tablestemplates + +&kword; has templates for many commonly used table formatting options. Table templates provide +the same formatting functionality for tables that +document templates provide you for formating your documents. +Select Table +Properties... +from the menubar. A dialog will appear. Click on the tab labeled Templates. + + + + + + + + +Along the left of the dialog box, is a list of table templates. + +On the right is a preview box that +gives an example of what a table template will look like when applied to your table. + +Below the preview box, are 5 check boxes. + + +First row +This check box will toggle formatting of all cells in the top row. + + + +Last row +This check box will toggle formatting of all cells in the bottom row. + + + +Body +This check box will toggle formatting of all cells in the body. The body of the table is any cells which are not formatted +by any of the other four options. + + + +First column +This check box will toggle formatting of all cells in the left column. + + + +Last column +This check box will toggle formatting of all cells in the right column. + + + + + +Placing a mark in the check box labeled Reapply template to table, will cause &kword; to re-apply the +template to the table after adding or deleting the specified number of rows and/or columns. + +Click OK to make changes permenant, or click Cancel to abort all +changes. + + + + + +Using table styles +tablesstyles +table styles + +Table styles are a rapid way for you to format individual cells of your table to common formats. You can add or remove +table styles, and change predefined table styles to suit your needs. A table style consists of a frame style and a text style +which are grouped together and named. + +Formatting a cell with a table styles +table stylesformatting a cell with + +To format a cell using a predefined table style simply: +Select the cell(s) by holding down &Ctrl; and clicking within the cell with the &LMB;. You can also +select columns and rows. +Select +TableTablestyle +from the menubar. A submenu will appear, listing all the currently defined table styles. Select the name of the table style +you want and all selected cells will automatically be formatting using the options of that table style. + + + +Editing a table style +table stylesediting + +To change the options of a table style, you will use the Table Style Manager. +Select +TableTable Style Manager... +from the menubar. A dialog box will appear. + + + + + + + + +All of the currently defined table styles are listed in the listbox on the left. The currently selected table style is highlighted, and +the name of the currently selected table style is listed in the text box labeled Name. (In this example, +the currently selected table style is Header 1.) +Select the name of the table style you want to change by clicking on the name of the table style in the listbox on the left. + +In the section labeled Adjust is a combo box labeled Framestyle which is used to select the desired frame style. +If you want to add or alter a frame style, click the Change... button, and you will be taken to the +Framestylist to make those changes. +Below that, is a combo box labeled Textstyle: which is used to select the desired text style for this table style. +If you want to add or alter a text style, click on the Change... button, and you will be taken directly to the +Stylelist to make those changes. + +Once all changes have been made, click OK to save your changes. All of the affected table styles will +be changed to reflect the new options. + + + +Creating a new table style +table stylescreating + +To create a new table style, select +TableTable Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +Select a table style from the list at the left which most closely matches your new desired table style. +The selected table style will be used as a template for the new table style. Select the table style by clicking +once with the &LMB; in the list on the left. +Click on the New button. &kword; will generate a new table style, which is a copy +of the previously selected table style. +Choose a name for your new table style, and type it in the text box labeled Name. +You can now change your table style options to customize your newly created table style. For details, see +Editing a table style. + + + +Deleting a table style +table stylesdeleting + +To delete table style, select +TableTable Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +Select the table style you want to delete +by clicking once with the &LMB; on the name of the table style you want to delete. +Click on the Delete button. +&kword; will not allow you to delete the Plain table style. + + + +Changing the order of the table style in the list +table stylesreordering + +To change the order that the table style are listed, select +TableTable Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +The order the table styles are listed in the menu is determined by the order of the table styles in the list on the left. +Select the table style you want to move from the list at the left by clicking once with the &LMB;. +Now click on the Up Arrow and Down Arrow located at the bottom of the list of table styles. +This will move theselected table style up or down in the list of table styles. +When you are satisfied with the order of the list, select OK. + + + +Importing a table style from another &kword; file +table stylesimporting + +To import a table style from another &kword; file, select +TableTable Style Manager... +from the menubar. A dialog box will appear. + + + + + + + +Click the button labeled Import From File. You can +select the &kword; file using the file selection dialog. Choose your file, and click +OK. +A new dialog box will appear listing all available table styles for importing. +If &kword; encounters a duplicate table style name in the selected file, it will append a number to the end of the +table style name to identify the imported style. +As an example, if you import the Plain table style from another &kword; file, &kword; will change +the name to Plain-1. +Select all the table styles you want to import. Then click +OK. +The table styles will now appear at the bottom of your list of table styles. Click OK +to save the table styles in the new document. + + + + diff --git a/doc/kword/tableprop1.png b/doc/kword/tableprop1.png new file mode 100644 index 00000000..c581ec77 Binary files /dev/null and b/doc/kword/tableprop1.png differ diff --git a/doc/kword/tableprop2.png b/doc/kword/tableprop2.png new file mode 100644 index 00000000..8941d0d6 Binary files /dev/null and b/doc/kword/tableprop2.png differ diff --git a/doc/kword/tablestylist.png b/doc/kword/tablestylist.png new file mode 100644 index 00000000..e0062554 Binary files /dev/null and b/doc/kword/tablestylist.png differ diff --git a/doc/kword/tabstops.docbook b/doc/kword/tabstops.docbook new file mode 100644 index 00000000..01fa83f1 --- /dev/null +++ b/doc/kword/tabstops.docbook @@ -0,0 +1,324 @@ + + + + +Mike +McBride + + + + +Using Tab Stops +tab stopsusing +paragraphsetting tab stops + +Tab stops are a (very useful) holdover from the days of +typewriters. They allow you to align text into columns quickly and +easily. + +When a tab stop is in place, you can immediately jump to a +horizontal position on the page by pressing the Tab key. Tab stops +are most commonly used to align columns in a table, or to automatically +indent paragraphs. + +Tab stops are part of the properties of a paragraph. Each +paragraph keeps track of its own set of tab stops. To view the tab +stops of a particular paragraph, place the mouse pointer within a +paragraph, click once, and check the top ruler. The tab stops are +marked as symbols in black. + +&kword; recognizes 4 types of tab stops. Each of these types has +a corresponding symbol to help you identify the type in the +ruler. + + + +TypeExampleSymbolDescription + + +Right Tab Stop + + +With a right tab stop, the right edge of the next set of words is aligned at the tab stop. + +Center Tab Stop + + +With a center tab stop, the text is centered at the tab stop. + +Left Tab Stop + + +With a left tab stop, the left edge of the next set of words is aligned at the tab stop. + +Decimal Tab Stop + + +With a decimal tab stop, the decimal points of the text are aligned at the tab stop. + + + + +Setting Tab Stops +tab stopssetting a new tab stop + +Tab stops can be set one of two ways: + + + +Using the rulers of +&kword; + + +Using a specialized dialog +panel. + + + + +Using the Ruler + +You can use the top ruler of &kword; to interactively insert tab +stops. + +First, you should select the type of tab stop you want to +use. + +Place the mouse cursor over the current tab character (located +directly to the left of the top ruler). Click once with the &RMB;. A small popup menu +will appear. You can select the tab stop you want from the sub +menu. + + +You can also use the left mouse button to cycle through the +different types of tab stops. + +Click once on the current tab character, and the tab stop changes +from left tab stop, to center tab stop. +If you continue to click with the left mouse button, you will change to +right tab stop, then to decimal tab stop, +then back to left tab stop. + + +Once you have the correct type of tab stop, you can simply place +the mouse pointer on the top ruler bar at the desired position, and click once with the +&LMB;. This will place a tab +stop at that position. + + + + +Using the Dialog Box + +The fastest way to get to the tab stop dialog panel, is to select +FormatParagraph... +from the menubar or type &Ctrl;&Alt;P. +This will bring up a dialog box with 5 tabs. Click on the tab +labeled Tabulators. + + + + + + + + +You can now add tab stops by: + + + +Click the New button at the bottom of the list of tab stops. + + +Type the horizontal location of the tab stop in the space +labeled Position. The units used and the current frame width +are listed below the text box. + + +Select the type of tab stop from the list of radio buttons labeled +Alignment. + +Determine what you want to fill the empty space to the tab stop with. +In most cases this should be left as Blank. For information on other options in this section, see +Tab filling. + + + +You can now add another tab stop. When you are done adding tab stops, you can click +OK to finish. + + + + + +Moving Tab Stops +tab stopsmoving + +Tab stops can be moved one of two ways: + + + +Using the rulers of +&kword; + + +Using a specialized dialog +panel. + + + + +Using the Ruler + + + +To move a tab stop with the ruler, place the mouse over the +desired tab stop. The mouse pointer will change to a double +arrow. + + + +Click and hold down the &LMB;. Drag the tab +stop to its new location + + + +When the tab stop is where you want it, release the mouse +button. + + + + + + +Using the Dialog Box + +Select FormatParagraph... +from the menubar or type &Ctrl;&Alt;P. +This will bring up a dialog box with 5 tabs. + +Click on the tab labeled Tabulators + +A very fast way to edit existing tab stops is to simply double click on the +tab stop you want to edit in the top ruler of &kword;. This will also bring up +the Tabulators dialog box with the desired tab stop already selected. + + + + + + + + + +Click on the tab stop you want moved. The list of all tab stops +is in the box on the left side of the dialog panel. + + +Type the horizontal location of the tab stop in the space +labeled Position. The units used and the current frame width +are listed below the text box. + + + +If you need to make changes, select the type of tab stop from the +list labeled Alignment or change the white space character +under Tab Leader. + + +Click OK when you are done moving all tab stops around. + + + + + + +Removing Tab Stops +tab stopsremoving +tab stopsdeleting + + +Tab stops can be removed one of two ways: + + + + +Using the rulers of +&kword; + + +Using a specialized dialog +panel. + + + + +Using the Ruler + + + +To delete a tab stop with the ruler, place the mouse over the +desired tab stop. The mouse pointer will change to a double +arrow. + + +Click and hold down the &RMB; on +the mouse. A popup menu will appear. Select Remove Tabulator. + + + + + +Using the Dialog Box + +Select FormatParagraph... +from the menubar or type &Ctrl;&Alt;P. +This will bring up a dialog box with 5 tabs. + +Click on the tab labeled Tabulators + +A very fast way to edit existing tab stops is to simply double click on the +tab stop you want to edit in the top ruler of &kword;. This will also bring up +the Tabulators dialog box with the desired tab stop already selected. + + + + + + + + + + +Click on the tab stop you want removed. The list of all tab stops +is in the box on the left side of the dialog panel + + +Click the Delete button. + + + +You can delete all tab stops at once by clicking Delete All. +&kword; will not prompt you prior to deleting all tabs, so make sure that is your intention prior to selecting the +Delete All button. + + +When you are done deleting tab stops, you can click +OK to finish. + + + + +Tab filling +tab stopstab filling + +By default, &kword; uses the standard tab function that you are familiar with when using a typewriter or most wordprocessing programs. +You can, however, have &kword; insert dots or lines to fill the tab space. +To change the way the tab fills work in &kword; you change the combo box labeled Filling:. This combo box +gives you many different line styles to choose from. +You can change the thickness of the lines by using the Width: spin box. + + + + + diff --git a/doc/kword/tb1.png b/doc/kword/tb1.png new file mode 100644 index 00000000..7a02c80f Binary files /dev/null and b/doc/kword/tb1.png differ diff --git a/doc/kword/tb2.png b/doc/kword/tb2.png new file mode 100644 index 00000000..efa6d8a4 Binary files /dev/null and b/doc/kword/tb2.png differ diff --git a/doc/kword/tb3.png b/doc/kword/tb3.png new file mode 100644 index 00000000..a17c16b7 Binary files /dev/null and b/doc/kword/tb3.png differ diff --git a/doc/kword/tb4.png b/doc/kword/tb4.png new file mode 100644 index 00000000..a2dde5f5 Binary files /dev/null and b/doc/kword/tb4.png differ diff --git a/doc/kword/tblsty.png b/doc/kword/tblsty.png new file mode 100644 index 00000000..e9beb7d6 Binary files /dev/null and b/doc/kword/tblsty.png differ diff --git a/doc/kword/tbord.png b/doc/kword/tbord.png new file mode 100644 index 00000000..557370bd Binary files /dev/null and b/doc/kword/tbord.png differ diff --git a/doc/kword/techinfo.docbook b/doc/kword/techinfo.docbook new file mode 100644 index 00000000..a2a7dd85 --- /dev/null +++ b/doc/kword/techinfo.docbook @@ -0,0 +1,246 @@ + + + + +Mike +McBride + + + + +&kword; file format +&kword;file format + +&kword; uses two open source, independently developed standards for +its file format. The combination was chosen for its balance between +convenience and open development models. + +First, it should be noted that all &kword; files are multiple &XML; +files that are compressed to reduce their space requirements. + +Select the &kword; version you are interested in: + +&kword; 1.1 and earlier. +&kword; 1.2. +&kword; 1.3. + + + + +&kword; 1.1 and earlier + +The &XML; files are compressed into a single file using the same +algorithm as used by tar. + +You can uncompress the files with the following command: + + +% tar -xzvf filename + + +This will expand the &kword; document file into its component +files. + +The text portion of all &kword; files are &XML; (eXtensible Markup +Language) files. + +For more information on &XML; documents, processors and +technology, please visit World Wide Web Consortium &XML; +pages XML.org Resource +Guide The &XML; +FAQ + +All &kword; documents consist of at least two &XML; files: + + + +maindoc.xml + +This file contains the bulk of the &kword; text, tables and formula +information. It is marked with &XML; tags according to the official DTD. A +copy of the &kword; 1.1 DTD is located at: http://www.koffice.org/DTD/kword-1.1.dtd. + + + +documentinfo.xml + +This file contains the document information. This is information +entered into the dialog boxes when selecting +FileDocument +Information from the menubar. This information +is useful for tracking authors, contact information &etc; +The DTD for &koffice; 1.1 is located at: http://www.koffice.org/DTD/document-info-1.1.dtd. + + + + +In addition, there may be other files included in the &kword; document +file. Pictures, embedded documents and other binary information are stored +within the &kword; document as separate files. + +For more specific information on &kword; file storage or other +internal information, please see The KOffice API and the +General &kde; developer information +pages. + + + +&kword; 1.2 + +The text files are compressed into a single file using the same +algorithm as used by zip. +This change was made because of its broad use in other open source office +suites and its improved performance with lower memory requirements. +You can uncompress the files with the following command: + + +% unzip filename + + +This will expand the &kword; document file into its component +files. + +The text portion of all &kword; files are &XML; +(eXtensible Markup Language) files. + +For more information on &XML; documents, processing and +technology, please visit World Wide Web Consortium &XML; +pages XML.org Resource +Guide The &XML; +FAQ + +All &kword; documents consist of at least three files: + + + +maindoc.xml + +This file contains the bulk of the &kword; text, tables and formula +information. It is marked with &XML; tags according to the official +DTD. A copy of the &kword; 1.2 DTD is located at: http://www.koffice.org/DTD/kword-1.2.dtd. + + + +documentinfo.xml + +This file contains the document information. This is information +entered into the dialog boxes when selecting +FileDocument +Information from the menubar. This information +is useful for tracking authors, contact information etc. +The DTD for &koffice; 1.2 is located at: http://koffice.kde.org/DTD/document-info-1.2.dtd. + + + + +mimetype + +This file contains the mimetype for &kword; files. This information +is used by &kde; to determine that this is a &kword; file. +This file always contains: +application/x-kword + + + + + +In addition, there may be other files included in the &kword; document +file. Pictures, embedded documents and other binary information are stored +within the &kword; document as separate files. + +For more specific information on &kword; file storage or other +internal information, please see The KOffice API and the +General &kde; developer information +pages. + + + +&kword; 1.3 (current version) + +The text files are compressed into a single file using the same +algorithm as used by zip. +This change was made because of its broad use in other open source office +suites and its improved performance with lower memory requirements. +You can uncompress the files with the following command: + + +% unzip filename + + +This will expand the &kword; document file into its component +files. + +The text portion of all &kword; files are &XML; +(eXtensible Markup Language) files. + +For more information on &XML; documents, processing and +technology, please visit World Wide Web Consortium &XML; +pages XML.org Resource +Guide The &XML; +FAQ + +All &kword; documents consist of at least three files: + + + +maindoc.xml + +This file contains the bulk of the &kword; text, tables and formula +information. It is marked with &XML; tags according to the official +DTD. A copy of the &kword; 1.3 DTD is located at: http://www.koffice.org/DTD/kword-1.3.dtd. + + + +documentinfo.xml + +This file contains the document information. This is information +entered into the dialog boxes when selecting +FileDocument +Information from the menubar. This information +is useful for tracking authors, contact information etc. +The DTD for &koffice; 1.3 is located at: http://koffice.kde.org/DTD/document-info-1.3.dtd. + + + + +mimetype + +This file contains the mimetype for &kword; files. This information +is used by &kde; to determine that this is a &kword; file. +This file always contains: +application/x-kword + + + + + +In addition, there may be other files included in the &kword; document +file. Pictures, embedded documents and other binary information are stored +within the &kword; document as separate files. + +For more specific information on &kword; file storage or other +internal information, please see The KOffice API and the +General &kde; developer information +pages. + + + + diff --git a/doc/kword/tedittb.png b/doc/kword/tedittb.png new file mode 100644 index 00000000..f8c9ae5c Binary files /dev/null and b/doc/kword/tedittb.png differ diff --git a/doc/kword/templatecreation.docbook b/doc/kword/templatecreation.docbook new file mode 100644 index 00000000..13023f76 --- /dev/null +++ b/doc/kword/templatecreation.docbook @@ -0,0 +1,115 @@ + + + + +Mike +McBride + + + + +Creating Templates, Saving a document as a template and Deleting Templates + +&kword; comes with several predefined templates (both +Page Layout and Text Oriented templates), which are designed +to provide initial formatting of documents. + +If, however, the same format for a custom document is used over and +over, &kword; can create a template which more +exactly matches the needs of the document. + +An unlimited number of templates can be created in &kword;, and +they can be organized into categories for easy recall. + +Creating a new template +templatescreating + +Templates are created by first generating the layout in +&kword; based on one of the predefined templates, and then saving the +file. Instead of saving it as a traditional file, it is saved as a +template. + +What follows, is a step by step process to save the current +document as a template. + + + +When the document is a completed template, Select +FileCreate Template From +Document... from the menubar. + +This brings up a dialog: + + + + + + + +This dialog helps organize the templates into +groups (categories). + +Select the group to place the new template into. +To create a new group to place templates in, simply click the button +labeled Add Group. A dialog box will appear asking for the +name of the new group. Click OK and the new group is created. + + +Type in a name for the template in the text box labeled Name. + + +Select the icon for your new template by +using the radio buttons on the right +&kword; has a default icon, which is shown below both options. +To change the icon, select Custom and a dialog box will appear. +Simply select the desired icon using the dialog box. Click OK when the icon is selected. + + +Click OK. + + + +Once you have saved the template, the next time you open a +document, your new category/new template will appear in the open file +dialog. + + +Removing a template +templatesdeleting +To delete a template, follow these steps: + + +Select +FileCreate Template From +Document... from the menubar. +This will bring up a dialog + +Click on the small plus sign (+) in front of the template group where the template can be found. + +Click once on the template name +Click on the button labeled Remove. +A small dialog box will appear verifying that you do intend to delete +the template. Simply click Yes. + +The template is now deleted. + +Removing a template group +templatesdeleting template group + +To delete a group of templates, follow these steps: + + +Select +FileCreate Template From +Document... from the menubar. +This will bring up a dialog + +Click once on the group name +Click on the button labeled Remove. +A small dialog box will appear verifying that you do intend to delete +the group of templates. Simply click Yes. + +The group and all of the templates within the group are now deleted. + + + diff --git a/doc/kword/textstyex.png b/doc/kword/textstyex.png new file mode 100644 index 00000000..d6189dbe Binary files /dev/null and b/doc/kword/textstyex.png differ diff --git a/doc/kword/tfcreatebut.png b/doc/kword/tfcreatebut.png new file mode 100644 index 00000000..753eb01b Binary files /dev/null and b/doc/kword/tfcreatebut.png differ diff --git a/doc/kword/thesaurus.png b/doc/kword/thesaurus.png new file mode 100644 index 00000000..6ed9fbc9 Binary files /dev/null and b/doc/kword/thesaurus.png differ diff --git a/doc/kword/toc.docbook b/doc/kword/toc.docbook new file mode 100644 index 00000000..e8cab6a3 --- /dev/null +++ b/doc/kword/toc.docbook @@ -0,0 +1,67 @@ + + + + +Mike +McBride + + + + +Table of Contents +table of contentsintroduction + +When writing a large document, it is useful to include a table of contents. This can be done automatically +with &kword;. +To begin creating a table of contents &kword; needs to know what to include in the table of contents. +The first part of this chapter describes how to prepare the document to generate an accurate table of contents. +The second part of this section, discusses the actual generation and updating of the table of contents. +The final part of this section provides pointers on changing the look of the table of contents. +Preparing the document +table of contentspreparing document for + +&kword; uses a style-based method of creating table of contents entries. +For more information on styles, see the Styles section of this documentation. +To mark each level of the document, use the paragraph styles Head 1, +Head 2 and Head 3. +Major subjects should be marked with the Head 1 style. +Sub-headings under the Head 1 subjects should be marked with Head 2. +Sub-headings under the Head 2 subject headings should be marked with Head 3 +Once this is done, proceed to the next section. + +Creating the table of contents +table of contentscreating +table of contentsupdating + +To create the table of contents is easy. Simply place the cursor in a text frame where the table of contents should be inserted. +Select +InsertTable of Contents from +the menubar. +&kword; locates all entries labeled with the appropriate paragraph styles, and their corresponding page numbers. +It assembles this into the +table of contents. +Once the table of contents is created, it will remain unchanged until &kword; is instructed to update it. +To update the table of contents, click once with the &LMB; in the current table of contents. Then select + +InsertUpdate Table of Contents from +the menubar. +&kword; will replace the old table of contents with a newly updated one. + +Changing the look of the table of contents. +table of contentsformatting + +The look of the table of contents is also adjusted by using the paragraph styles in &kword;. +The table of contents title is formated with the Contents Title paragraph style. +All major subject headings (those marked with the Head 1 style), are now formatted +using Contents Head 1 paragraph style. All sub-headings (those marked with the +Head 2 style), are now formatted +using Contents Head 2 paragraph style. Finally, all sub-headings (those marked with +the Head 3 style), are now formatted +using Contents Head 3 paragraph style. +By changing the look of those three styles, +the appearance of the +table of contents can be radically changed. + + + + diff --git a/doc/kword/tts.png b/doc/kword/tts.png new file mode 100644 index 00000000..3b95737b Binary files /dev/null and b/doc/kword/tts.png differ diff --git a/doc/kword/tutorial.docbook b/doc/kword/tutorial.docbook new file mode 100644 index 00000000..6d9bc502 --- /dev/null +++ b/doc/kword/tutorial.docbook @@ -0,0 +1,356 @@ + + + + +Mike +McBride + + + + +Step by Step Tutorial +tutorial +This section is a step by step +walk through of the most important functions needed to understand how +to create and manipulate a complex document. This tutorial will generate the start of a +newsletter as an example document. + +It is recommend that you go through the tutorial in order at +least once if you are new to frame based word processors. + + +Tutorial: Choosing the initial template + +The steps to this tutorial are numbered from 1 to 23. +Beneath each step, is text in italics which further elaborates or explains the changes. + +When you first start &kword; (or start a new +document after &kword; is running), &kword; asks for a document template. + + + + +Screen shot + + +Here you can either: + + +Select the initial template for your new +document. + + +Open a &kword; document saved to your hard +drive or network. + + + + +Step 1: Click on Page Layout. + +Screen shot + +This will list the Page Layout templates available on +your system. For information on the differences between Page Layout and Text Oriented templates, see the section entitled +The difference between Text Oriented and Page Layout +templates. + +Step 2: Now select the Simple Layout icon by +clicking once with the left button of your mouse. + +Screen shot + +This is the template we will use for the +tutorial. + +Step 3: Now confirm your selection by clicking on +Use This Template. + +Screen shot + +To complete your selection. + +&kword; will open a new document with three frames. The +frames are outlined on the white background, as gray boxes. Each box is +a separate frame. + + + + +Tutorial: Selecting a frame and entering text into that frame + +To begin entering text (or adding any sort of data for +that matter) into a document, its important to let &kword; know which +frame to put the data in. + + +In order to keep both editing and formatting of your document efficient and simple, +the command executed with a mouse click changes depending on where in the &kword; window the pointer +is located. + +When the pointer is located over toolbars, scrollbars, menu buttons or other areas +outside the document, the pointer is an arrow. You should already be +familiar with this type of pointer when using other &kde; programs. +When inside the document, there are two separate pointers which alternate automatically +based on how close to a frame edge the pointer is currently located. +When the mouse pointer is near the edge of a frame, the pointer will change into two intersecting lines +with arrows on all four points. Clicking the left mouse button now will select the nearest frame. +As you move the pointer away from the edge of the frame, the pointer will change into the text entry pointer. +Clicking the left mouse button at this time will tell &kword; to insert text into this frame. + + + +Step 4: Place the mouse pointer over the upper-left frame. +Make sure you do not see the frame select pointer +Step 5: Click once with the left mouse button. + + +Screen shot + +This tells &kword; to insert text into this frame. Click in the upper left corner of the frame to position the cursor in the upper left corner of the frame. + +Step 6: Enter the following text using the keyboard: KWord Press Release. + +This is some sample text for our +newsletter. + +Step 7: Select KWord Press Release by placing +the mouse cursor on the right end of the text. Click once with the +&LMB; and drag the mouse cursor +to the left. Selected text will be white text on a colored +background. When all the text has been selected, release the &LMB;. + + +Screen shot +This defines what text is going to be altered with Step 8. +Step 8: Click inside the Text Size combo box. Change this +number to 26. + + +Screen shot + +This changes the size of the selected text to one more +appropriate for a title. + + + + Tutorial: Changing the size of a frame + +Now that we have entered some text, we can see that the +frame should extend across the entire width of the page for a title. We need to change +the size and shape of the frame. + +Step 9: Place the mouse pointer over the frame border (you will notice the cursor +changes to two intersecting lines with arrows), and click +once with the &LMB;. + +This will select this frame, so it can be +re-shaped. + +You will now notice the frame is outlined in black, with +8 squares on the outline. These squares are used for re-sizing the +frame. + +Step 10: Place the mouse pointer over the square in the lower +right corner of the frame. Click with the &LMB; and hold it +down. Drag the mouse up and to the right. + + +Screen shot + +Notice how the frame changes shape. Adjust the size and +shape of the frame until it looks similar to the example below: + + +Screen shot + +When it does, release the mouse button. + + + + +Tutorial: Moving a frame on the page and layering frames + +Now that we have created a title block, we will center it at the +top of the page. + +Step 11: Place the mouse pointer over the border of the frame (but +not on any of the squares). + +The pointer will now change to a 4 way arrow. This +indicates &kword; is ready to move the frame on the +page. + +Step 12: Click and hold with the &LMB;. Drag the +mouse, and the frame will follow it. Position the frame in the center +of the page near the top. When you are satisfied with its final +location, release the mouse button. + + +Screen shot + +Notice how the right side of the title block has slid behind the empty frame on the right. This is easily corrected. + +Step 13: Select FramesBring to Front. + + +Screen shot + +This will place the title on top of the other frame. You can raise and lower frames to give you the look you need. + + + +Tutorial: Adding a new frame/Making text flow between two frames +Now we will add a new text frame to our document for our first article. +Step 14: Begin by selecting +InsertText +Frame from the menubar. + + +Screen shot + +The pointer has changed to cross-hairs. You can draw +your new text box with this cursor. Start by placing the pointer at one +corner. Click and hold the left mouse +button. Drag the mouse diagonally. An outline will appear which +represents your new text frame. When you have a text frame of +reasonable size, release the left mouse +button. + + +Screen shot + +It is not important if your text box does not resemble +the example for the purposes of this tutorial. + +When you release the left +mouse button, a new dialog box appears. + + +This dialog box lists all the current frame sets and has a radio button to create a +new frame set (default value). By selecting the default value, you will +create a new frame set (text will not flow from any other frame into this +frame). + +Notice that the default name for this frameset is +Text Frameset 3 + +Step 15: For the purposes of this tutorial, the default value of +Create a new frameset is good. Simply select +OK. + + +Screen shot + +Now you can see your new frame has been created. It is called +Text Frameset 3 + +Now we are going to create another small frame right next to this one. + +Step 16: Select InsertText +Frame. + + +Screen shot + +Again using the crosshair pointer, draw another small frame near the first one. + + +Screen shot + +A dialog box will appear. + +Step 17: Select Text Frameset 3 by clicking with the &LMB;. + + +Screen shot + +Step 18: Select OK. + + +Screen shot + +What you have just done, is connect this new textframe, to the last frame you created. + To test this: + +Step 19: Click once inside the leftmost frame with the &LMB;. + + +Screen shot + +Step 20: Begin typing. You will need to type quite a bit, but +keep typing. When you run out of space in the text frame, you will see +your new text is moved immediately into your new text frame. + + +Screen shot + + + + +Tutorial: Deleting a frame + +Now we will delete an unneeded frame. We will delete +the long text frame on the right side of the page. + +Step 21: Place the mouse pointer over the frame border of the right +hand text frame (Remember: watch for the pointer to change), and click with the &LMB;. + + +Screen shot + +This selects the frame. + +Step 22: Select +FramesDelete +Frame. + + +Screen shot + +A small dialog box appears, checking that you really intended to delete this frame. +Step 23: Select Delete. + +This deletes the frame. + + + +Tutorial: Summary + +Hopefully this tutorial has introduced you to the most basic tasks in &kword;. + +At this point, you have : + + +Started a new document using a template +Added text to a frame. +Resized text. +Created, moved, resized and deleted frames. + +The purpose of this tutorial was not to explore every aspect of &kword;, but to +introduce you to the bare essentials. Hopefully you understand the basic manipulation +of frames. From this point, you can refer to the specific sections of the manual for +help, tips and advanced features of &kword;. + + diff --git a/doc/kword/undl.png b/doc/kword/undl.png new file mode 100644 index 00000000..60113775 Binary files /dev/null and b/doc/kword/undl.png differ diff --git a/doc/kword/undo.png b/doc/kword/undo.png new file mode 100644 index 00000000..6fa539ea Binary files /dev/null and b/doc/kword/undo.png differ diff --git a/doc/kword/value.png b/doc/kword/value.png new file mode 100644 index 00000000..3cc80d13 Binary files /dev/null and b/doc/kword/value.png differ diff --git a/doc/kword/viewsize.png b/doc/kword/viewsize.png new file mode 100644 index 00000000..ac2fdc48 Binary files /dev/null and b/doc/kword/viewsize.png differ diff --git a/doc/kword/wbw.png b/doc/kword/wbw.png new file mode 100644 index 00000000..62f4daa5 Binary files /dev/null and b/doc/kword/wbw.png differ diff --git a/doc/kword/wpfmtpg1.png b/doc/kword/wpfmtpg1.png new file mode 100644 index 00000000..97710feb Binary files /dev/null and b/doc/kword/wpfmtpg1.png differ diff --git a/doc/kword/wpfmtpg2.png b/doc/kword/wpfmtpg2.png new file mode 100644 index 00000000..51ce12a1 Binary files /dev/null and b/doc/kword/wpfmtpg2.png differ diff --git a/doc/kword/wpfmtpg3.png b/doc/kword/wpfmtpg3.png new file mode 100644 index 00000000..d4e3f9e3 Binary files /dev/null and b/doc/kword/wpfmtpg3.png differ diff --git a/doc/kword/zoom.png b/doc/kword/zoom.png new file mode 100644 index 00000000..694455ec Binary files /dev/null and b/doc/kword/zoom.png differ diff --git a/doc/thesaurus/Makefile.am b/doc/thesaurus/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/thesaurus/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/thesaurus/index.docbook b/doc/thesaurus/index.docbook new file mode 100644 index 00000000..bd799022 --- /dev/null +++ b/doc/thesaurus/index.docbook @@ -0,0 +1,150 @@ + + + + + +]> + + + +&kthesaurus; + + + +Daniel +Naber +
    daniel.naber@t-online.de
     +     + +     + +2003-04-12 +0.95.00 + + +2002 +2003 +Daniel Naber + + + + +&kthesaurus; lists words related to a given term and offers a user interface +to &wordnet;, a powerful lexical reference system. By default, only the +English language is supported. + + + + +KDE +thesaurus +WordNet +synonyms +dictionary +lexicon +English +words + + +     + + + +The Thesaurus Tab + +The Thesaurus tab offers a small thesaurus, +built from a subset of &wordnet;. +The results are listed in three +categories: Synonyms, More General +Words (hypernyms), More Specific +Words (hyponyms). Synonyms are words with a very similar meaning. +They do not necessarily apply to all senses of each word, so you cannot +always replace a word with any synonym. + +You can double click on a word to search for its synonyms &etc;. +You can also type a word directly into the Search for: +box at the top and press +Return. The word which is currently visible in the +Replace with: box at the bottom is the one that will +be used if you click on Replace. + +&kthesaurus; can be used as a standalone application, but it can also be +used from other applications (like &kword;, typically by right clicking +on a word and selecting Show related words). +The Replace button will only be visible +on a word and selecting Show Related Words). +The Replace with: button will only be visible +if &kthesaurus; is called from another application. + +We have to keep the data file small so that it can be +included in &koffice; — this introduces several limitations +(compared to &wordnet;): + + +Only exact matches are found, ⪚ if you search for a plural +form nothing will be found. +Many not so common words have been removed. +It doesn't distinguish between parts of speech, e.g. verbs and +nouns are mixed up in the lists of words. +It won't separate the different meanings words can have. +Adjectives don't really have a more general / more specific +meaning, so one word may appear in more than one list at the same time. + + +On the other hand, a few words have been added (function words like if +and very few words specific to &kde;). + +Please do not report bugs in the thesaurus +to the &wordnet; project, but to &kde;. + + + + + +Using languages besides English + +By default, only the English language is supported +in &kthesaurus;. You can check out +the +KOffice download page to see which other languages +are available. + + + + + +The &wordnet; tab + +The &wordnet; tab provides a user interface +to a local installation of &wordnet; 1.7. +&wordnet; is an online lexical reference +system whose design is inspired by current psycholinguistic theories +of human lexical memory. The &kthesaurus; user interface offers nearly all options +which are available on the command line. It calls the wn binary, +which has to be in your PATH. + +To learn more about &wordnet;, please see the &wordnet; man pages +or have a look at the &wordnet; homepage. + + + + + + +Copyright and Licensing + + +&kthesaurus; and this documentation is copyrighted by Daniel Naber. + + + +&underFDL; +&underGPL; + + + + +&documentation.index; + +     -- cgit v1.2.1
    +
    +

    $projectname

    + + diff --git a/doc/karbon/Makefile.am b/doc/karbon/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/karbon/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/karbon/index.docbook b/doc/karbon/index.docbook new file mode 100644 index 00000000..670d3acc --- /dev/null +++ b/doc/karbon/index.docbook @@ -0,0 +1,67 @@ + + + + + +]> + + + + +The &karbon14; Handbook + + + + + + + +
    +     +     + +     + +&FDLNotice; + + + +2005-09-04 +0.1.0 + + + + + +&karbon14; is a Scalable Graphics editer for &kde;. + + + + + +KDE +Karbon14 + + +     + + Introduction +The documentation for &kappname; was not finished when &kde; was installed on +this computer. If you need help, please check The &kde; Website for updates, or by +submitting your question to The +&kde; User Mailing list. The &kde; +Team + +&underFDL; + + + +&documentation.index; +     + diff --git a/doc/kchart/Makefile.am b/doc/kchart/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kchart/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kchart/cr22-action-chart_line.png b/doc/kchart/cr22-action-chart_line.png new file mode 100644 index 00000000..ea1199db Binary files /dev/null and b/doc/kchart/cr22-action-chart_line.png differ diff --git a/doc/kchart/cr22-action-data.png b/doc/kchart/cr22-action-data.png new file mode 100644 index 00000000..a72e5438 Binary files /dev/null and b/doc/kchart/cr22-action-data.png differ diff --git a/doc/kchart/cr22-action-options.png b/doc/kchart/cr22-action-options.png new file mode 100644 index 00000000..f03bb673 Binary files /dev/null and b/doc/kchart/cr22-action-options.png differ diff --git a/doc/kchart/cr22-action-wizard.png b/doc/kchart/cr22-action-wizard.png new file mode 100644 index 00000000..cece74de Binary files /dev/null and b/doc/kchart/cr22-action-wizard.png differ diff --git a/doc/kchart/file-toolbar.png b/doc/kchart/file-toolbar.png new file mode 100644 index 00000000..3297c7c0 Binary files /dev/null and b/doc/kchart/file-toolbar.png differ diff --git a/doc/kchart/file-toolbar2.png b/doc/kchart/file-toolbar2.png new file mode 100644 index 00000000..699c4479 Binary files /dev/null and b/doc/kchart/file-toolbar2.png differ diff --git a/doc/kchart/frame_chart.png b/doc/kchart/frame_chart.png new file mode 100644 index 00000000..a28f1437 Binary files /dev/null and b/doc/kchart/frame_chart.png differ diff --git a/doc/kchart/index.docbook b/doc/kchart/index.docbook new file mode 100644 index 00000000..8fdfac40 --- /dev/null +++ b/doc/kchart/index.docbook @@ -0,0 +1,1375 @@ + + + + + + +]> + + + + +The &kchart; Handbook + + + + + +&Jonathan.Drews; &Jonathan.Drews.mail; + + +Raphael +Langerhorst +raphael.langerhorst@kdemail.net + + + + + +&FDLNotice; + +2006-01-30 +1.5.0 + + + +&kchart; is an application for visualizing numerical data. It has many +different chart types available like bar graphs, line plots, pie charts, +ring charts and more. + + +&kchart; is a &koffice; component and is very well integrated with &kspread; +to allow visualization of spreadsheet data. But it is also possible to use +&kchart; as a standalone application or integrate it in other &koffice; +components. + + + + +KDE +kdeutils +Kchart +chart +graph +plot + + + + + + +Introduction + + +&kchart; is a tool for visualizing numerical data. It can be used +as a standalone application with a simple &dataeditor;. But as a +&koffice; component it offers very flexible integration. &kspread; +uses the &kchart; component for charts and diagrams. &kspread; +can be seen as a very powerful data provider for &kchart; input. + + +But embedding is not limited to &kspread;. A &kchart; chart can +be embedded in many of the &koffice; components like &kword;, +&kpresenter; or &kivio;. + + +To start with we will look at the user interface of &kchart; +and how it can be used as a standalone application. When we +are familiar with &kchart; we will investigate the charting +capabilities it offers together with &kspread;. + + + + +The User Interface + +Main Application Interface + +We will take a look at a simple example to get to know &kchart;. +Along the way we will also discuss the user interface at length +so you will learn about many details of the component. + + +When you start &kchart; as a standalone application you get +the usual startup dialog where you can choose between different +templates or load existing chart documents. + + +&kchart; Startup Dialog + + + + + + + +You can choose between various ways to startup &kchart;. On the left, you can +see three options: Recent Documents, +Charts templates and Open Existing +Document.... The first option lets you choose between +recently opened charts, the second is for creating a +new chart from various templates and the third is for opening an existing +chart with a file dialog. + + +For now we will start with the default template. Select +Charts in the left area and then select +Bar Chart in the main template area. Normally +this template should already be selected after choosing +Charts. + + +If you decide to always start &kchart; with a selected template as default +you can also check Always use this template. + + +Click the Use This Template +button on the right, under the template preview. + + +&kchart; User Interface + + + + + + + +As you can see, there is already some example data present. &kchart; +offers the default toolbar for creating a new chart, saving, loading +and printing the chart. The second toolbar offers icons for editing +the data, configuring the chart or using a configuration wizard. +You can also switch between different chart types with the rest +of the icons. Note that some of these chart types also have subtypes. + + +The menu offers all standard entries, including shortcut and +toolbar configuration and page layout for printing. + + +Note that data editing is not available if you use &kchart; from +within &kspread; because all data is provided by the spreadsheet. +As a standalone application the &dataeditor; is an important part +of the application. + + + +Chart Wizard + +The wizard is actually a very useful part of &kchart; for quickly +setting up some basic options like chart type and chart labelling +in a few easy steps. + + +You can run the wizard at any time, it will always preserve your data +and other configuration. Also, you can change every single configuration +you do with the wizard later as well, without losing anything. In fact +the wizard is just a way to set some basic and important options +in one go. + + +To start the wizard simply click on the + + + icon in the toolbar. + + + +Step 0 - Choosing the Data source + +Wizard Step 0 - Data source + + + + + + + +The first step in the wizard is to actually choose the data source. +If the selected data area does not match the data you want, +select the data now. + +Include cells that you want to use as row and column labels, +if you want them in the chart. + +Then go to the next step with the Next > +button. You can also choose Finish at any step +if you are already comfortable with the setup done so far. + + + + +Step 1 - Choosing the Chart Type + +Wizard Step 1 - Chart Type + + + + + + + +The next step in the wizard is to actually choose the primary +type of the chart. This selection has the most important +impact on how your data will be presented. Thus it should +be chosen well. You can change the type of the chart with the +icons in the toolbar without losing any data or configuration +later on. In fact it is even considered normal to test all the +various chart types to find the best fitting. + + +In this example we choose the Lines type. Depending on the +chosen chart type different options are available in the +following steps. + + +After chosing the type you can get to the next step with +the Next > button. + + + +Step 2 - Choosing the Subtype + +Wizard Step 2 - Chart Sub Type + + + + + + + +In case the chosen chart type has various sub types you can +choose it in the second step. If the chart type has no sub types, +this step will be skipped automatically. + + +If you decide to change the sub type later, you can do this +in the appropriate configuration dialog which will be shown +later. + + +You can simply leave the default selection and go to the next +step. Of course you can chose any desired sub type if you want. + + + +Step 3 - Labels and Legend, Fonts + +Wizard Step 3 - Labels and Legend + + + + + + + +In the third step you can set the text for the chart title, +the axes and the legend. You can also configure the desired +font in detail for each of these. + + + +Step 4 - Axes + +Wizard Step 4 - Axes + + + + + + + +The last step of the wizard lets you set various options for +the axes and other options, depending on the chart type. + + +You can either choose Finish to accept +the options for your chart, go < Back and +change various things or simply dismiss all options from the +wizard by choosing Cancel. + + +If you choose Finish all your choices in the wizard will +be integrated in the chart and you can continue to enter +some data and do some fine tuning of various options. + + +Remember that the chart configuration dialog has many more +options available, we will discuss these later. + + + + +The &dataeditor; + +The &dataeditor; can be reached by selecting +EditEdit Data... + from the menu or by clicking on the + + + icon in the toolbar. + + +&dataeditor; in standalone mode + + + + + + + +The &dataeditor; can be used to set all values. You can also define +the number of rows and columns. + + Depending on the chart type rows and columns have different +representations. Each row can generally be considered to be one data +series or data set while each column represents the values of all +data sets at a certain location. + + +The name of a data set can be changed by clicking on the row header +(left of the first column with values). The name of a column can +be changed by clicking on the column header (above the first +row). + + +The number of rows and columns can be adjusted to fit the needs. +Since version 1.4 the restriction to 16 rows and 16 columns has been +eliminated. + + + +Chart Configuration + +&kchart; offers many configuration options for the chart. These are +available in standalone mode and when embedded in &kspread; + + +Depending on the chart type you have selected, the available +options are slightly different. Let's choose the line chart +type by clicking on the + + icon in the toolbar. + + +To get to the chart configuration dialog, select +Format +Chart... + from the menu or click on the + + + icon in the toolbar. +You might need to click on the right or left arrow at the top of the +dialog to get all pages if the width of the dialog is too small. + +Row and Column Swapping + +Configuration page 1 - Row/column swapping + + + + + + + +The first configuration page can be used to swap the +interpretation of rows and columns. +By default one row is considered to be a data set +and each column holds the individual values of the data +series. Here you can choose to have a each column hold +one data set. Note that the values are not really swapped +but only their interpretation. + + + +Chart Subtype + +Configuration page 2 - Chart Subtype + + + + + + + +The second page can be used to select the desired sub type of +a chart. The available sub types depend on the chart type, in +this case the line chart. Some chart types have no sub type +at all in which case this configuration page is not shown. +You also get a preview for each subtype. + + +Remember that the chart type can be chosen from the toolbar while +the subtype can be set through this configuration dialog. + + + +Header and Footer + +Configuration page 3 - Header and Footer + + + + + + + +On the third page you can set the title, the subtitle and the footer of +the chart, each with individual font settings. + + + +Legend + +Configuration page 4 - Legend + + + + + + + +The legend configuration page lets you set all aspects of the legend. +The legend contains the names for all data sets with the respective +colors, this is important to identify the data on the chart. + + +The General box holds the title of the legend, which is displayed +at the top of the legend box. +The Position box can be used to place the legend at various locations +on the chart. Use the central button to hide the legend. + + +The Font box can be used to set +different fonts for the legend title and the individual entries. +Additionally you can set different colors in the Color box. + + + +Axes + +Configuration page 5 - Axes + + + + + + + +The Axes page holds configuration for the chart axes. This +page highly depends on the chart type chosen. For the line +chart you can set linear or logarithmic scales and turn the grid +on and off. + + + +Colors + +Configuration page 6 - Colors + + + + + + + +On the Colors page you can choose the colors for the individual +data sets. You can also set colors for some general chart parts +like axes Line color and Grid color. + + + +Font + +Configuration page 7 - Font + + + + + + + +The Font page can be used to configure various fonts like +titles, axes labels and so on. Some of these fonts can +be set on other pages as well, but on the font page you +have them all in one place. + + + +Background + +Configuration page 8 - Background + + + + + + + +On the Background page you will find various options for tweaking +the background settings of the chart. You can either choose +different background colors or even a background picture. + + + +More... + +This short overview of the configuration options gave you an +introduction to the configuration possibilities of your chart, +it is by no means complete. Different chart types like Bar, +Line and Pie, have +additional specialised configuration pages and you are welcome +to look around, try different chart types and look at the +configuration possibilities. Use the tooltips and read the +What's This? help. To use the What's This? help simply +click on the question mark on the window +decoration and then click on the area of the configuration +page you want get more information on. + + + + + + +&kchart; as a standalone Application + +The previous chapter described the user interface, +various configuration options, data editing and the wizard +in detail. + + +This chapter gives real-life examples on how to use +&kchart; in various situations as a standalone application. +The purpose is to give you some understanding of the +way &kchart; works and how various parts relate to each other. + + +Presenting Sales Figures + +Warming up + +This first example which might often be encountered in real +life is presenting sales figures, or in this particular case +profit. + + +Imagine you own a company that has three main categories of +business: sales, support and training. And you would like +to present the profit of these categories over some years. Making +a graphical statistics is certainly a good idea. &kchart; can +help you here. + + + +Getting started + +Run &kchart; and select the Blank Worksheeet. + + +Starting with a blank chart + + + + + + + +Hit the button Use This Template to get started. &kchart; will present to you +a completely empty document. That's good, we just need to enter +some data and do some basic configuration to get a nice chart. + + +A blank chart + + + + + + + + +Getting the numbers in + +The first step, and probably the most important, is to get the +actual data into the chart. This can easily be done with the +&dataeditor;. As usual you can get to the data editor by +clicking on the + + icon in the toolbar. + + +You will notice that no data is present. Also note that +the number of data rows and columns is set to a minimum, +which is 1. + + +Now, just enter the data you see in the next screenshot. +Note that you can increase the number of rows and columns +with the spin boxes in the lower left corner. The names +of the rows and columns themselves can be changed by +clicking on them. + + +The Data + + + + + + + +Simply click the OK button when you are done. This will present +to you a simple bar chart. + + +Simple chart without fine tuning + + + + + + + +Read on to do some fine tuning! + + + +Fine Tuning + +We will now do some fine tuning and put a title on the chart. +And, we will add a nice 3D effect to the bars as well. + + +Start up the configuration dialog by clicking on the + + + icon in the toolbar. + + +Title + +Options - Title + + + + + + + +Let's start with labeling. Go to the Header/Footer +page and enter the text like in the above screenshot. + + + +X-Axis Font Settings + +The next step is to make the font of the x axis a bit bigger. You +can do this on the Font page. + + +Options - Fonts + + + + + + + +Choose the X-Axis item and click on the +Font... button. Choose a somewhat +larger font like in the following screenshot. + + +Options - X-Axis Font + + + + + + + +Note that the font size is set to Relative. +This means that the font is automatically scaled according +to the overall chart size. This is quite usefull and most +of the time what the average user expects. + + + +Giving it a 3D Look + +Some types of charts like Bar and Pie +have an additional configuration page. + + +Options - 3D Parameters + + + + + + + +To get a 3D effect for this type of chart, go to the Bar +page and simply activate 3D bar. + + +That's all what we need for a reasonable looking chart. Note +that much of this configuration could also have been achieved +with the wizard. It's basically a matter of taste what you +use. Experienced users will likely use the full option dialog +we used in this example. + + +Simply accept the settings by clicking on the OK +button. + + + + +Final output + +The final chart will look like the next screenshot. + + +Final Chart + + + + + + + +You might want to enlarge the application window to see the chart +in full size. Note how the fonts get larger in relation to the +chart size. + + +There are certainly aspects to improve further for your personal +taste. For example try to make the title font even bigger. +Just experiment further, this way you will get to know a lot +of the &kchart; application. + + +Finally you can save the chart from the File +menu and quit &kchart; with +File +Quit + + + + +Exporting to Graphic Formats: SVG, PNG, JPG, &krita;, &karbon14;, Gimp and +more + +For further processing, the chart can also be exported as a graphics file. +Many formats are available. Using either PNG, SVG, JPG or &krita; will likely +produce the best result. + + +To export your current chart simply choose +File +Export... +from the menu and select the desired file format from the filter box. + + + + + + + + + + + + + + +Using &kchart; in &kspread; + + +In addition to standalone operation, &kchart; is designed to be used with +&kspread;. This chapter describes how to create and manipulate charts +from within &kspread;. + + +Remember that &kchart; embedding into &kspread; is a very commonly +used and well implemented feature, the examples in this chapter should +just get you started. + + +As soon as you have created a chart in &kspread; you can take full +advantage of all the &kchart; features by double clicking on the +chart area. This is necessary to get to all advanced configuration +options. Keep in mind that the data editor is not available when +&kchart; is embedded into &kspread;. This is obvious since &kspread; +serves, from &kchart;'s point of view, as a powerful data +provider. + + +Swapping x and y is of particular interest when working with &kspread;. +You can swap interpretation of x and y axis in &kchart; in the +Data Format settings which can be accessed through the Edit menu +or the context menu when right clicking on the chart itself. As noted +above you need to be inside the &kchart; component in order to access +these settings, which can be done by double clicking the embedded +chart in your spreadsheet. + + + +Plotting with &kchart; +To plot with &kchart;, when it is embedded in &kspread;, do the following: + + +Picture of toolbars dialog + + + + + + + + + +Highlight the second row of numbers. + + + +Next click on the Chart button + to create the chart. + + +Select the options you want from the chart wizard. The +chart Wizard will pop up after you insert the chart. + + + + +The whole data could also be created using two columns instead of +two rows. If using columns you might want to switch x and y axis +in the &kchart; configuration as described above. + + +To make a bar chart for individual items, put the numbers in a +column, as shown below. + + +Picture of toolbars dialog + + + + + + + +The orientation of the numbers determines how the plot will be +made. + + + +A row of numbers defines the ordinates for a single plot. + + + +A column of numbers defines the heights for each bar, in a bar +graph. It also determines the size of the slices in a pie chart. + + + + + + + +Command Reference + + +The Main &kchart; Window + + +The <guimenu>File</guimenu> Menu + + + + + +&Ctrl;N + +File +New + +Creates a new document + + + + + +&Ctrl;O + +File +Open... + +Opens a document + + + + +File +Open Recent + +Shows a list of recently opened documents + + + + + +&Ctrl;S + +File +Save + +Saves the chart to the current file. If the chart +has not yet been saved the file dialog is shown. + + + + +File +Save As... + +Saves the document, the file dialog is used. + + + + +File +Reload + +Reloads the document. + + + + + +File +Import... + +Opens a document with any supported format. +The original document will not be modified. + + + + + +File +Export... + +Saves a document to any supported format. +The original document will not be modified. You can also choose +among many image formats like PNG, SVG, &krita;, Gimp or JPG. + + + + + +File +Mail... + +Sends the chart as an email attachment. + + + + +File +Import Data... + +Imports values from a CSV (Comma Separated Values) file, much like +the CSV import in &kspread;. Note that you can specify various +options and different separators (not just commas). + + + + + +File +Create Template From Document... + +Create a &kchart; template +based on this document. + + + + + + +&Ctrl;P + +File +Print... + +Prints the document +Make sure the proper print system is selected in the +Print system currently used: section. This option can +be seen after clicking on the Options >> button. + + + + +File +Print Preview... + +Displays a preview of what the printed +document will look like. + + + + +File +Document Information + +Opens a dialog box where you can enter +information about your chart. +This document information will be +displayed in the &konqueror; file browser as a tooltip. The tooltips +are pop-ups that show the contents of a file when you move your mouse over +the file icon. + + + + + +&Ctrl;W + +File +Close + +Closes the current chart. + + + + + +&Ctrl;Q + +File +Quit + +Quits &kchart; + + + + + + +The <guimenu>Edit</guimenu> Menu + + + + +Edit +Edit Data... + +Opens the &dataeditor;. + + + + + +The <guimenu>Format</guimenu> Menu + + + + +Format +Chart... + +Opens the &kchart; Configuration +dialog. + + + + + +The Configure Tabs + + + +Data Format... + +Swap row and colums (x/y flipping). + + + + + +Chart Sub-type... + +Changes the arrangement of bar graphs. + + + + + +Header & Footer... + +Enter the titles you want for your graph here. + + + + + +Colors... + +Select graph colors, line colors, grid colors and +axis title and axis label colors here. + + + + + +Font... + +Select font style and size here. The +series colors can be selected here also. The series refer to the +individual graphs. Each graphed set of data is a series. + + + + + +Background... + +Select a color or a wallpaper as background for your +graph. + + + + + +Legend... + +Change title, font and location of the legend box. The +color of the legend box can be changed also. + + + + + +Page Layout... + +Set the Margins of the page here. + + + + + + + + +The <guimenu>Settings</guimenu> Menu + + + + + +Settings +Toolbars + +Show/Hide various toolbars (File, +Actions and Types). + + + + +Settings +Configure Shortcuts... + +Configure key shortcuts for &kchart;. + + + + +Settings +Configure Toolbars... + +Configure the &kchart; toolbars. + + + + + + + + +The <guimenu>Help</guimenu> Menu + +&help.menu.documentation; + + + + +Configuring Shortcuts + +The +SettingsConfigure Shortcuts... +allows you to specify shortcuts. + + +Below is an example of how to configure a shortcut for opening +the chart wizard. + + +Picture of shortcut dialog + + + + + + + + + +Click on Custom. + + + +Next click on Primary shortcut:. + + + +Do &Alt;&Ctrl;W +and the dialog should disappear. The shortcut is now entered. + + + +Pressing the keys &Alt;&Ctrl;W +now opens the wizard. + + + + +Configuring Toolbars +The +SettingsConfigure Toolbars... +is used to add additional buttons to the toolbars. + + +Picture of toolbars dialog + + + + + + + + + + +To add a button to the File toolbar, + + + +Picture of toolbars dialog + + + + + + + + make sure File + <&koffice;> is displayed in the top combo box. + + + +Click on one of the items in the left hand pane. This item will now be +highlighted showing that it has been selected. + + + +Next click on the Right arrow button to place it in +the right pane. + + + +Click on Apply and then +click on OK + + + + +The new Item should be in the toolbar. + + + + + + + + + + +Credits and License + + +&kchart; + + +Program copyright 1998-2005 the &kchart; Team + + +Original Authors: + + +&Matthias.Kalle.Dalheimer; &Matthias.Kalle.Dalheimer.mail; + +Torben Weis weis@kde.org + + + +Contributors: + + +Laurent Montel lmontel@mandrakesoft.com + +Karl-Heinz Zimmer khz@kde.org + +Inge Wallin inge@lysator.liu.se + + + + +Documentation copyright 2002 &Jonathan.Drews; &Jonathan.Drews.mail; + + +Documentation copyright 2005 Raphael Langerhorst +raphael.langerhorst@kdemail.net + + + +&underFDL; +&underGPL; + + + +&documentation.index; + + + + diff --git a/doc/kchart/kchart-config1.png b/doc/kchart/kchart-config1.png new file mode 100644 index 00000000..5aeb06ad Binary files /dev/null and b/doc/kchart/kchart-config1.png differ diff --git a/doc/kchart/kchart-config2.png b/doc/kchart/kchart-config2.png new file mode 100644 index 00000000..9fec6cfd Binary files /dev/null and b/doc/kchart/kchart-config2.png differ diff --git a/doc/kchart/kchart-config3.png b/doc/kchart/kchart-config3.png new file mode 100644 index 00000000..cd52c606 Binary files /dev/null and b/doc/kchart/kchart-config3.png differ diff --git a/doc/kchart/kchart-config4.png b/doc/kchart/kchart-config4.png new file mode 100644 index 00000000..b3b12a4d Binary files /dev/null and b/doc/kchart/kchart-config4.png differ diff --git a/doc/kchart/kchart-config5.png b/doc/kchart/kchart-config5.png new file mode 100644 index 00000000..1fe1cf1f Binary files /dev/null and b/doc/kchart/kchart-config5.png differ diff --git a/doc/kchart/kchart-config6.png b/doc/kchart/kchart-config6.png new file mode 100644 index 00000000..206f1a44 Binary files /dev/null and b/doc/kchart/kchart-config6.png differ diff --git a/doc/kchart/kchart-config7.png b/doc/kchart/kchart-config7.png new file mode 100644 index 00000000..9c972945 Binary files /dev/null and b/doc/kchart/kchart-config7.png differ diff --git a/doc/kchart/kchart-config8.png b/doc/kchart/kchart-config8.png new file mode 100644 index 00000000..51d43a8a Binary files /dev/null and b/doc/kchart/kchart-config8.png differ diff --git a/doc/kchart/kchart-dataeditor.png b/doc/kchart/kchart-dataeditor.png new file mode 100644 index 00000000..ac06d9d3 Binary files /dev/null and b/doc/kchart/kchart-dataeditor.png differ diff --git a/doc/kchart/kchart-default.png b/doc/kchart/kchart-default.png new file mode 100644 index 00000000..b8c751b8 Binary files /dev/null and b/doc/kchart/kchart-default.png differ diff --git a/doc/kchart/kchart-example1-1.png b/doc/kchart/kchart-example1-1.png new file mode 100644 index 00000000..9efa5708 Binary files /dev/null and b/doc/kchart/kchart-example1-1.png differ diff --git a/doc/kchart/kchart-example1-2.png b/doc/kchart/kchart-example1-2.png new file mode 100644 index 00000000..2a5373c3 Binary files /dev/null and b/doc/kchart/kchart-example1-2.png differ diff --git a/doc/kchart/kchart-example1-3.png b/doc/kchart/kchart-example1-3.png new file mode 100644 index 00000000..5cbaab82 Binary files /dev/null and b/doc/kchart/kchart-example1-3.png differ diff --git a/doc/kchart/kchart-example1-4.png b/doc/kchart/kchart-example1-4.png new file mode 100644 index 00000000..6e144ee0 Binary files /dev/null and b/doc/kchart/kchart-example1-4.png differ diff --git a/doc/kchart/kchart-example1-5.png b/doc/kchart/kchart-example1-5.png new file mode 100644 index 00000000..c15585b4 Binary files /dev/null and b/doc/kchart/kchart-example1-5.png differ diff --git a/doc/kchart/kchart-example1-6.png b/doc/kchart/kchart-example1-6.png new file mode 100644 index 00000000..da621f0a Binary files /dev/null and b/doc/kchart/kchart-example1-6.png differ diff --git a/doc/kchart/kchart-example1-7.png b/doc/kchart/kchart-example1-7.png new file mode 100644 index 00000000..3cbbba7f Binary files /dev/null and b/doc/kchart/kchart-example1-7.png differ diff --git a/doc/kchart/kchart-example1-8.png b/doc/kchart/kchart-example1-8.png new file mode 100644 index 00000000..c2f88cfe Binary files /dev/null and b/doc/kchart/kchart-example1-8.png differ diff --git a/doc/kchart/kchart-example1-9.png b/doc/kchart/kchart-example1-9.png new file mode 100644 index 00000000..80c6493b Binary files /dev/null and b/doc/kchart/kchart-example1-9.png differ diff --git a/doc/kchart/kchart-kspread-bar.png b/doc/kchart/kchart-kspread-bar.png new file mode 100644 index 00000000..e363f2d6 Binary files /dev/null and b/doc/kchart/kchart-kspread-bar.png differ diff --git a/doc/kchart/kchart-kspread.png b/doc/kchart/kchart-kspread.png new file mode 100644 index 00000000..fec93cc6 Binary files /dev/null and b/doc/kchart/kchart-kspread.png differ diff --git a/doc/kchart/kchart-startupdialog.png b/doc/kchart/kchart-startupdialog.png new file mode 100644 index 00000000..0e64ca9e Binary files /dev/null and b/doc/kchart/kchart-startupdialog.png differ diff --git a/doc/kchart/kchart-wizard0.png b/doc/kchart/kchart-wizard0.png new file mode 100644 index 00000000..e53f73c7 Binary files /dev/null and b/doc/kchart/kchart-wizard0.png differ diff --git a/doc/kchart/kchart-wizard1.png b/doc/kchart/kchart-wizard1.png new file mode 100644 index 00000000..9b07001a Binary files /dev/null and b/doc/kchart/kchart-wizard1.png differ diff --git a/doc/kchart/kchart-wizard2.png b/doc/kchart/kchart-wizard2.png new file mode 100644 index 00000000..4c5c711b Binary files /dev/null and b/doc/kchart/kchart-wizard2.png differ diff --git a/doc/kchart/kchart-wizard3.png b/doc/kchart/kchart-wizard3.png new file mode 100644 index 00000000..73c85a49 Binary files /dev/null and b/doc/kchart/kchart-wizard3.png differ diff --git a/doc/kchart/kchart-wizard4.png b/doc/kchart/kchart-wizard4.png new file mode 100644 index 00000000..6069b890 Binary files /dev/null and b/doc/kchart/kchart-wizard4.png differ diff --git a/doc/kchart/shortcut.png b/doc/kchart/shortcut.png new file mode 100644 index 00000000..faa52243 Binary files /dev/null and b/doc/kchart/shortcut.png differ diff --git a/doc/kchart/toolbars.png b/doc/kchart/toolbars.png new file mode 100644 index 00000000..6c94d35c Binary files /dev/null and b/doc/kchart/toolbars.png differ diff --git a/doc/kexi/Makefile.am b/doc/kexi/Makefile.am new file mode 100644 index 00000000..085981d9 --- /dev/null +++ b/doc/kexi/Makefile.am @@ -0,0 +1,4 @@ + +KDE_LANG = en +KDE_DOCS = AUTO + diff --git a/doc/kexi/basics.docbook b/doc/kexi/basics.docbook new file mode 100644 index 00000000..7bb34b9f --- /dev/null +++ b/doc/kexi/basics.docbook @@ -0,0 +1,504 @@ + + + + + &kexi; Basics + + + + + &kexi; Databases + + + Many applications such as OpenOffice.org or Microsoft Excel create + files which are called documents. &kexi; + creates files too, but we refer to them as &kexi; + database files, or simple database + files here. &kexi; database files usually have the + extension .kexi. + + + + + + In addition to storing your databases in database files, &kexi; + can also use databases on database + servers, which is why we refer to them as + database files, and not simply as + databases. + + + + The term &kexi; project, or simply + project is also used to refer to a &kexi; + database, regardless of whether it is stored in a file or on a + database server. + + + + + + Creating a New Database File + + + + + + Run &kexi;, or if it is already running, use + + + &Ctrl;N + + FileNew + . + + + + + Click the OK to confirm the + creation of the project. + + + + + Enter a name for your project, and click Next. + + + + + Use the file browser to choose a folder where you would + like to save your database file. You may change the file + name in the Location: box if you dislike + the one that is suggested. + + + + + Click Create. + + + + + + + + The &kexi; Main Window + + + The Project Navigator and + Properties Editor are shown in panes on + each side of the child window. These can be resized or hidden + as required. A pane can be hidden by clicking the small cross + at the top of the pane (just below the toolbar). + + + Database objects (tables, queries, etc.) listed in the Project + Navigator can opened by clicking (or + double-clicking, depending upon your global &kde; settings) on their names. + + + + +Main application elements + + + + +Main elements of &kexi; application's window are: + + +Menubar + +contains available commands for the application. +You will find detailed description of any of the commands in the appendix. + + + + +Toolbar + +contains most frequently used commands. + + + + + +Project Navigator's pane + +contains a list of any object (tables, queries, forms, ...) created +within the currently opened database project. The navigator also contains +small toolbar with most usable commands related to the database objects. + + + + +Opened database objects area + +a central area of the application taking most of the screen space. +For IDEAl user interface mode it contains switchable tabs with +windows that are always maximized. For Childframe user interface +mode it contains floating windows. + + + + +Properties pane + +contains a list of properties of currently activated database object. +For certain objects (⪚ form's widgets) it can have several tabs. + + + + +Taskbar + +contains a list of currently opened windows with database objects. +For IDEAl user interface mode, it is available as a number of tabs. +For Childframe user interface mode, it is available as a number of +buttons, behaving just like your operating system's taskbar. + + + + + + +<guilabel>Project Navigator</guilabel> pane + +The Project Navigator pane is one of the most frequently used elements +of the &kexi; main window. The pane contains a list of all objects +created within the currently opened &kexi; database project. The objects +are split into groups: tables, queries, forms. + + +The Project Navigator pane also contains a small toolbar for most +frequently used commands (from left to right): Open +selected object, Design selected object, +Create a new object, and Delete selected +object. + + + +For each object on the list a context menu is available using the &RMB;. +For example, this is context menu for the persons table. + + + + + + +Double clicking with the &LMB; on the object's name on the list allows to +open the object in Data View. If the object's window was alread opened, +the action just activates the window without switching it's view mode. + + +Note that your operating system or window manager can be set up to handle +single clicks instead of double clicks. In this case it is enough to single +click on the object name to open its window. + + + + + + +Database object windows + + +Opening an object's window + + +Select the object in the Project Navigator +pane. + + + + + +Click the Open button on the Project Navigator pane's toolbar. + + + + + +Commands related to object windows +Closing an object window + +When the IDEAl user interface mode (the default) is used, each window has +its own tab. Place the mouse pointer on the icon on the tab. A + Close button will become +visible. Click it to close the tab. + + +In the Childframe on the right hand of each opened window there are +buttons you can use to control the window. Click the first one on the +right hand to close the window. + + +Alternatively, regardless of the user interface mode you are using, +you can select Window +Close from the Menubar. + + +Window buttons for Childframe user interface +mode + + +The other buttons (from right to left) can be used to: maximize, minimize +and undock the window. + + +There's a small icon on the left side of the title bar which can be clicked +to show a context menu with commands related to the window. + + + + + + + + +<guilabel>Property Editor</guilabel> pane + +In the Property Editor pane you can change properties of the object +displayed in the active window. Depending on the context, the pane is +consisted of one or more tabs. The first, always visible tab, Properties, +contains the list of available properties. + + + +Rules for using the Property Editor: + +Each row contains a single property. + + +You can use the mouse or the keyboard to change values of particular +properties. + + + +Most frequently used types of property values are: + +a number; you can enter the value directly +or increase or decrease its value by clicking with the &LMB; on the arrows. + + + +text +drop down list of values +Yes/No; +you can toggle the value by clicking on the button; +Yes (true) means that the button is +toggled on, >No (false) means that +the button is toggled off. + + + + + + +There is no need to confirm a changed value: changes are visible immediately +after moving to a different row of the Property Editor's list or by pressing +the Enter key. + + + +Names of the recently changed properties that not yet were stored in the +database are marked with bold text. + + + + +After changing the value of a property, a special Undo changes +button appears on the right side of the Property Editor's list. + +By clicking it you can revert the value of the property to the original value +that was loaded from the database upon opening the database object. The button +is only visible when the property is actually highlighted. + + + + + +The Property Editor pane is empty if: +no single database object's window is opened, or + + +the active database object's window does not offer properties; it is usually +the case when it is opened in Data View instead of Design View + + + + + + + + + + + + + + + Opening an existing &kexi; database file + + + + To open an existing &kexi; database file: + + + select it in the Open Existing Project + dialog; or + + + open it by clicking on the .kexi file icon. + + + + + + Opening a database file in the <guilabel>Open Existing + Project</guilabel> dialog + + + + Run &kexi;. + You should see Choose Project startup dialog. + Choose Open Existing Project tab. + You will see the following dialog: + + + + From Current location drop down box, pick a folder + containing a file you are looking for. + + + You can either pick a file or enter its name in the + Location: box. + + + Click OK. + + + + + + Notes + + + + By default the Filter: drop down list has + Kexi Database File-Based Project selected. + In case the file you are looking for has an other extension, + you can change the selection of the Filter: + drop down list to All Files to display + all available files (regardless of an extension). + + + If you have selected a file of an external type, like a MS Access .mdb + file, &kexi; will provide you with the option to import the file. + + + + If you have selected a connection data file + (with .kexic extension) or a shortcut to a project on + database server file (with .kexis extension), &kexi; + will display appropriate dialogs. + + + + + + + + Opening an existing &kexi; database file by clicking on .kexi file's icon + + + Click file's icon using your file manager or desktop. + &kexi; will open this database project automatically. + + + + + Notes + + + Note about database files accessed remotely. + You may want to open a database file that is located on a remote + source (⪚ a web or FTP server or a MS Windows network share). + K Desktop Environment allows you to open files from remote sources + directly in applications and to save changes back to the source, but + this is not the case with database files. By clicking on a database + file located on a remote source, a copy of the file will be + downloaded to a temporary directory on your computer and all your + changes will be made to this local file. The remote original of + the file will remain unchanged, so it's recommended to copy + (download) the file to your computer first, then open the file and + copy it back to the remote source if you want to make it up to date. + + + + + + + + Using built-in help + + + + The following ways to get built-in help in &kexi; are available: + + + The Handbook in form of electronic document. + + The Handbook is available by pressing F1 + key or selecting Help&kexi; + Handbook from the menubar. + + + + What's This? hints. + + Select HelpWhat's + This?from the menu bar and click on + an area of the application to get hints about it. + + + + + + diff --git a/doc/kexi/building.docbook b/doc/kexi/building.docbook new file mode 100644 index 00000000..9b900c77 --- /dev/null +++ b/doc/kexi/building.docbook @@ -0,0 +1,248 @@ + + + +Building Simple Databases + +Introduction + +To learn the basics of &kexi;, you could build a simple database +utilizing most elementary &kexi;'s features. To make things simpler, +advanced database design topics will not be covered here. + + +Start by creating a new empty Phone Book. + + + +Having a new empty database project, perform the following steps: + +Design database tables. Read . +Enter data into tables. Read . +Design database queries. Read . +Design forms. Read . +Use forms to enter data. Read . + + + + +Designing Database Tables + +First, there will be two tables added to your database: +persons and phone_numbers. +These are exactly the same tables as described in chapter Database and spreadsheet. +A layout for Persons can be found in section +Data integrity and validity +in that chapter. + + + + + +Select InsertTable + from the Menubar. You can also use the button Create +object: table on the Project +Navigator's toolbar. + + + + +The Table Designer's window will appear. Looking at the top of designer's window +you will notice that &kexi; proposed you a generic name like +template for the new table. The table design is not saved +yet so you will be able to assign more proper name later. Moreover, because of +the same reason, the table name is not yet visible in the +Project Navigator. + + + + + + +The Table Designer window + +Table Designer window consists of following columns: + +PK - Primary Key. + + +Field Caption - caption of the field +which will be displayed during data entering. + + +Data Type - a combo box containing a list of data types, +allowing to set a main rule for entered data for a given field. For example, +when an integer number data type is set for a field, a database user will not +able to enter letter characters into this field. + + +Comments - you can enter here any information useful for +understanding what the given field is provided for. This additional text will +be saved within the table design and only visible in design mode. + + + +In the Table designer window, every row corresponds to +a single table field. You can recognize you are in design +mode because the +Switch to Design View mode button is toggled on within +the main &kexi; toolbar. + + + + +Designing the <emphasis>Persons</emphasis> table + +In the first row click on the cell in the Field Caption +column and enter Name as field caption. + + +Notes about field names and captions + +Every table field must have a name and a caption, these cannot be empty. + + +Field name is a word used by the database, usually not visible for users of the database application. The name may not contain special (national) characters (like ±, ¶, Ü) +or space characters. The name must only contain roman letters, + +numbers and underscore sign "_". Use the latter instead of +spaces or dashes. + + +Field names must be started with a letter or underscore sign +"_", never with a number. + + +It does not matter whether you are using small or capital letters. +For &kexi; the database name "Persons" is the same as +"persons". + + +Field caption, on the other hand, allows you to enter any letters and special characters. It will be displayed for users of the database application. + + + + + + +In a similar way, enter the following fields into the table design: +surname +street +house_number +city + + + + +All the above fields, except house_number, are of type +text. +Change house_number field's type to integer +number. To do this, click on a cell in the Data +Type column, house_number row and then +click on drop down list's button +(you can also press F4 or +&Alt;Down. The list +of data types will appear. Select the Integer number type. + + +From now on, the house_number field only accepts numbers. + + + + +Persons table design is ready. Click +Switch to Data View button on the toolbar to finish +designing and switch to Data View for the table. This allows you entering +data into the table. + + + +As the design is not yet saved in the database, the Save Object As +dialog window appears. You need to specify the name for the new table. + + + +&kexi; offers a generic name like Table1. +To change the name, enter Persons into the +Caption field and press the +Enter key or click the OK +button. The Caption field will be used to display the +table to database end-users, ⪚ as a form. Unlike the name, the caption can +contain any characters including spaces and special characters. + + +Note that filling the Caption field automatically fills +the Name field. For your convenience the rule for using +only letters, numbers and the "_" character is kept. You +can alter the contents of the Name field if you want to. + + + + +You are asked about an agreement for automatic adding of primary key to the table. + + Click Add primary key +button to continue. + + + + +The Persons table has been created and opened in Data View. +Its name appears in the Project Navigator pane. + + + + +Create the phone_numbers table, in a similar +way as persons table. + + + +Create a person field of type Integer +number and phone of type Text. +Do not use a number type here because phone numbers can have many different +forms and prefixes. + + + +Click Switch to +Data View button on the toolbar and enter Phones +caption for the table. As for your previous table, allow &kexi; to automatically +create a primary key. + + + + + + + +&enteringdataintotables; + +&querydesigning; + +&designingforms; + +&enteringdatausingforms; + + + diff --git a/doc/kexi/comparing.docbook b/doc/kexi/comparing.docbook new file mode 100644 index 00000000..f213ac04 --- /dev/null +++ b/doc/kexi/comparing.docbook @@ -0,0 +1,98 @@ + + + + + Comparing &kexi; to other database applications + + + Although different database applications tend to provide similar + functionality, they often use different terminology. For your + convenience, this appendix shows how the terminology used in + &kexi; corresponds to that used by other database applications. + Thus, this chapter may be useful when migrating databases from + one application to another. + + + + Data types + + + The table below shows how the data types in &kexi; correspond + to data types in other database applications. + + + Some of the data types listed here are + sub-types of other types. For example, + the Long text type is a sub-type of the + Text type. To use a sub-type in + &kexi;, you should select the corresponding basic type (in + this case, Text) in the table designer, and then select the + sub-type using the Subtype setting in the + Properties Editor. + + + + Comparison of data types used in &kexi; and other database + applications + + + + + &kexi; + MS Access + dBase/FoxPro + Paradox + + + + + Text (Text) + Text + Character + Alphanumeric + + + Long text (Long text) + Memo + Memo + Memo + + + Date/Time (Date/Time) + Date, Time + Date + DateTime + + + + Integer Number (Integer Number) + Number (Integer) + Numeric + Integer + + + Big Integer Number (Big Integer Number) + Long Integer + Numeric + Long Integer + + + Floating Point Number (Floating Point Number) + Single/Double precision number + Float + Number + + + +
    +     +     diff --git a/doc/kexi/configuration.docbook b/doc/kexi/configuration.docbook new file mode 100644 index 00000000..f3d134f7 --- /dev/null +++ b/doc/kexi/configuration.docbook @@ -0,0 +1,230 @@ + + + + + Configuring &kexi; + + + + This chapter describes how you can configure &kexi; to suit your + own needs and preferences. + + + + + Window Layout + + + &kexi; provides a Mutiple Document + Interface (MDI). This means that you can have + several database objects (such as tables, queries, forms and + scripts) open at the same time and in the same &kexi; main + window. Each database object is shown in a child + window within the main window. + + + There is a choice of two MDI modes available, allowing a choice + of how child windows are managed and displayed. The two modes + are: + + IDEAl Mode; and + Childframe Mode. + + These modes are described in the following two sections. You + can change the MDI mode from the MDI + Mode sub-menu under the Window + menu. Note that changing the MDI mode requires &kexi; to be + restarted before the new mode takes effect. + + + + IDEAl mode + + + + IDEAl mode is the default MDI mode, and may be familiar from + other &kde; applications. In this mode, a single child window + is shown maximized within the &kexi; main window at once. + A tab bar, containing one tab for each child window, allows + other child windows to be viewed by simply clicking on the + relevant tab. + + + + + Childframe mode + + + + In Childframe mode, child windows are displayed in the + main &kexi; window, but need not be maximized within it. + In order to use Childframe mode, you need to select + + Window, + MDI Mode, + Childframe Mode + from the menu. + + + Each child window has a titlebar with buttons for maximizing, + minimizing and closing it. They can also be moved and resized + within the main window in the normal way (for example, they + can be moved by clicking and dragging the title bar). + + + The buttons behave as follows: the right-most button closes + the child window. The button on its left maximizes the child + window - note this causes the buttons to move to the top right + of the main window, above the Properties + editor if it is open. The next button to the left + toggles the child window between minimized and restored. + + + The left-most button detaches, or + undocks, the child window, allowing it + to be moved out of the main window. For more information on + docking and undocking windows, see the next section. + + + + + + + Docking and Undocking Windows + + + By default, the Project Navigator and + Properties Editor panels are displayed as + part of the main &kexi; window. It is possible to + undock each panel, so that it is + displayed in a separate window. Once undocked, it is possible + to dock the panel so it appears back in + the main window again. + + + In Childframe + mode, it is also possible to undock child windows. For + example, a child window showing a database table could be + undocked, allowing the child window showing the table to be + maximized on the screen. + + + It can be useful to undock a window when using: + + + + a small screen; + + + + + large tables, queries or forms; and/or + + + + + more than one montitor. + + + + + + + Docking and undocking side panels + + + The Project Navigator and + Properties Editor side panels may be + undocked by either: + + + + double-clicking on the 'grip' bar at the top of the + panel; or + + + + + clicking once on the arrow at the top of the panel, next + to the cross. + + + + + + + Once undocked, panel windows may be docked into the main + window again similarly to undocking: + + + + double-clicking on the 'grip' bar at the top of the window; or + + + + + clicking once on the arrow at the top of the panel, next + to the cross. + + + + + + + + + Docking and undocking child windows + + + Child windows may be docked and undocked in Childframe mode + only. + + + In Childframe mode, child windows may be undocked by: + + + + right-clicking in the tab bar, on the tab corresponding + to the window to be undocked, and selecting + Undock; or + + + + + + right-clicking on the title bar of the child window, and + selecting Undock; or + + + + + + if the child window is not + maximized, clicking the arrow in the top right corner of + the child window (next to the minimize, maximize and + close buttons for that child window); + + + + + + if the child window is maximized, clicking the arrow to + the right of the menu bar (next to the minimize, restore + and close buttons for that child window). + + + + + + + To dock a child window, right-clicking in the tab bar, on the + tab corresponding to the window to be docked, and select + Dock. + + + + + diff --git a/doc/kexi/contact-example.png b/doc/kexi/contact-example.png new file mode 100644 index 00000000..9b2e5dbf Binary files /dev/null and b/doc/kexi/contact-example.png differ diff --git a/doc/kexi/credits.docbook b/doc/kexi/credits.docbook new file mode 100644 index 00000000..6b910547 --- /dev/null +++ b/doc/kexi/credits.docbook @@ -0,0 +1,63 @@ + + + +Credits and License + + + &kexi; Copyright 2002-2006 The &kexi; Team + + &kexi; Developers: + + Jaroslaw Staniek / OpenOffice Polska js@iidea.pl + + + Lucijan Busch lucijan@kde.org + + + Cedric Pasteur cedric.pasteur@free.fr + + + Adam Pigg adam@piggz.fsnet.co.uk + + + Martin Ellis martin.ellis@kdemail.net + + + Sebastian Sauer mail@dipe.org + + + Christian Nitschkowski segfault_ii@web.de + + + Peter Simonsson psn@linux.se + + + &Joseph.Wenninger; jowenn@kde.org + + + Seth Kurzenberg seth@cql.com + + + Laurent Montel montel@kde.org + + + Till Busch till@bux.at + + + + + + Documentation by Martin A. Ellis martin.ellis@kdemail.net, + Jaroslaw Staniek js@iidea.pl + with contributions from Anne-Marie Mahfouf, Raphael Langerhorst, Michal Kubicki and Aron Stansvik. + + + + +&underFDL; +&underLGPL; + + diff --git a/doc/kexi/database.docbook b/doc/kexi/database.docbook new file mode 100644 index 00000000..e89afa55 --- /dev/null +++ b/doc/kexi/database.docbook @@ -0,0 +1,649 @@ + + + +Introduction to Databases + + +What Is a Database? + +You can define a database as a collection of data on one topic. +It is organised in a way allowing to easily browse the information, +make changes or add new items. + + +Look at this diagram for one of the above examples: a simple phone book. + + + A diagram of a phone number database + + + + + + A diagram of a phone number database + + + + +The above picture shows a set of two contacts each of which is +presented on a separate card. It appears that such a card can +constitute a single row in a table: + + +Contacts table + + +
     + +&koshell;'s Side Pane + + + + &koshell;'s Main View + + + +&koshell; Insert Object dialog + + The Color Range dialogThe Convert Image Type dialogThe Image Properties dialogThe Image Size dialogThe Rotate Image dialogThe Separate Image dialogThe Shear Image dialogThe Substrate dialogThe Convert Layer Type dialogThe Drop Shadow dialogThe Histogram dialogThe Layer Properties dialogThe Layer Size dialogThe New Adjustment Layer dialogThe New Layer dialogThe Rotate Layer dialogThe Shear Layer dialogThe Blur dialogThe Brightness / Contrast dialogThe Bumpmap dialogThe Color Adjustment dialogThe Color to Alpha dialogThe Color Transfer dialogThe Custom Convolution dialogThe Emboss dialogThe Filters Gallery dialogThe Gaussian Noise Reduction dialogThe Lens Correction dialogThe Image Restoration dialogThe Oilpaint dialogThe Pixelize dialogThe Raindrops dialogThe Random Noise dialogThe Random Pick dialogThe Round Corners dialogThe Small Tiles dialogThe Sobel dialogThe Unsharp Mask dialogThe Wave dialogThe Wavelet Noise Reduction dialogThe Add Palette dialogThe Document Information dialogThe Overview tabThe Histogram tabThe Tool tab for BrushThe Tool tab for LineThe Tool tab for RectangleThe Tool tab for StarThe Tool tab for DuplicateThe Tool tab for Paint with Filters The Tool tab for TransformThe Tool tab for CropThe Tool tab for Contiguous FillThe Tool tab for GradientThe Tool tab for TextThe Tool tab for Color PickerThe Tool tab for Select toolsThe Tool tab for Select ContiguousThe Tool tab for Select MagneticThe HSV tabThe RGB tabThe Gray tabThe Palettes tabThe Watercolors tabThe Layers tabThe Script Manager tabThe File toolbarThe Edit toolbarThe Navigation toolbarThe Krita toolbarDrawing a Bezier curveModifying a Bezier curveA finished Bezier curvePainting with filtersThe Brushes and Stuff toolbarThe Brush Shapes paletteThe Brush Shapes palette with the Autobrush +tabThe Brush Shapes palette with the Custom Brush +tabThe Gradients paletteThe Patterns paletteThe Patterns palette with the Custom Pattern tab selectedThe Oilpaint dialogThe available Preferences sectionsThe General sectionThe Display sectionThe Color Management sectionThe Performance sectionThe Tablet sectionThe Grid sectionThe starting imageThe starting imageThe Select Outline toolThe picture after selecting the headThe Subtract modeFeather selectionThe Image Size dialogThe Select Contiguous toolThe Sample merged optionThe Contiguous Fill toolThe Select Rectangular toolMoving the shadow layerThe Crop toolThe resulting imageThe Create Document dialogThe New Image dialog&krita;'s main screenA flowerThe outline of the flowerThe colored flowerThe original imageThe image with the Auto Contrast filter applied to itThe image with the Blur filter applied to itThe image with the Brightness / Contrast filter applied to itThe image with the Bumpmap filter applied to itThe image with the Color Adjustment filter applied to itThe image with the Color to Alpha filter applied to itThe image with the Color Transfer filter applied to itThe image with the Custom Convolution filter applied to itThe image with the Desaturate filter applied to itThe image with the Bottom Edge Detection filter applied to +itThe image with the Emboss in All Directions filter applied to +itThe image with the Emboss with Variable depth filter applied to +itThe image with the Gaussian Blur filter applied to +itThe image with the Gaussian Noise Reduction filter applied to itThe image with the Invert filter applied to itThe image with the Lens Correction filter applied to itThe image with the Maximize Channel filter applied to itThe image with the Mean Removal filter applied to +itThe image with the Minimize Channel filter applied to itThe image with the Oilpaint filter applied to +itThe image with the Pixelize filter applied to +itThe image with the Raindrops filter applied to +itThe image with the Random Noise filter applied to itThe image with the Random Pick filter applied to itThe image with the Round Corners filter applied to +itThe image with the Sharpen filter applied to itThe image with the Small Tiles filter applied to +itThe image with the Sobel filter applied to itThe image with the Unsharp Mask filter applied to itThe image with the Wave filter applied to itThe image with the Wavelet Noise Reduction filter applied to +itThe original imageThe gradient applied with the Normal compositing +modeThe gradient applied with the Multiply compositing +modeThe gradient applied with the Burn compositing +modeThe gradient applied with the Dodge compositing +modeThe gradient applied with the Divide compositing +modeThe gradient applied with the Screen compositing +modeThe gradient applied with the Overlay compositing +modeThe gradient applied with the Darken compositing +modeThe gradient applied with the Lighten compositing +modeThe gradient applied with the Hue compositing +modeThe gradient applied with the Saturation compositing +modeThe gradient applied with the Value compositing +modeThe gradient applied with the Color compositing +modePainting a selectionPainting a selectionUnselectingBefore the magic wandA magic wand selectionSelecting similar colors