User:Claus chr/DPL
There are 263 pages beginning with A-J
- ChoqoK
- Draft/MetaInfo
- Build your first KDE application on Kubuntu
- Create your own mouse cursor theme
- Artikulate
- Compile KPhotoAlbum
- Heaptrack/Build/Ubuntu 16.04
- English: Handbook
- Extjs ondiscussionpage:User talk:Heny
- Building KPhotoAlbum
- Artikulate/PhonemeTrainingUnits
- Category Translation
- Amarok/Manual/AdvancedFeatures/WorkingWithMediaDevices
- Artikulate/ScenarioTrainingUnits
- Elisa
- Amarok/Manual/Draft
- Beginner's Guide
- Browser Configuration
- Installation/Prepare
- Accessibility
- Flow
- Braindump
- Amarok/Manual/Introduction
- Accessibility/Application Overview
- Digikam/AddTextures
- Amarok/Manual/Playlist
- Calligra/Handbooks
- Dolphin/Batch Rename
- Digikam/Faded Effect
- Blogilo
- Digikam/Simple Toning
- Akregator/Tutorials/How to get RSS from a Wordpress blog?
- Amarok/Manual/Organization/ScriptManager
- Digikam/Assign Keyboard Shortcuts to Tags in digiKam
- Amarok/Manual/Organization/Collection/RemoteCollections
- Digikam/Quick Tip:Disable Certain File Types
- Amarok/Manual/Various/AmarokOnOtherPlatforms
- Category Translation Template
- Amarok/Manual/References/KeybindingReference
- Digikam/BleachBypassEffect
- Amarok/Manual/Organization/Collection/RemoteCollections/DAAP
- Filelight
- BasKet
- Amarok/Manual/Various
- BlinKen
- Digikam/Tethered Shooting
- Bluedevil
- Digikam/Configure the Main Toolbar in digiKam
- Artikulate/Introduction
- Amarok/Manual/Organization/Collection/RemoteCollections/UPnP
- Amarok/Manual/Organization/Collection/RemoteCollections/Ampache
- Digikam/Check Database
- Digikam/Geotag Photos with Android
- GCompris
- Digikam/Batch Process
- Digikam/Photoshop Preset Curves
- Amarok/Manual/References
- Digikam/Effects
- Amarok/Manual/Various/AmarokOnOtherPlatforms/OSX
- Digikam/Optimise
- Dragon Player
- Digikam/Face Detection
- Gwenview
- Digikam/Lens Correction Using digiKam
- Amarok/Manual/AmarokWindow
- Amarok/Manual/Organization/Collection
- Applications/Accessibility
- Amarok/QuickStartGuide/TheAmarokWindow
- Digikam/Straighten
- Amarok/Manual/References/MenuAndCommandReference
- Amarok/Manual/References/MenuAndCommandReference/AmarokMenu
- Juk
- Browser Configuration/Mousegestures for all Browsers
- Digikam/Exif
- Digikam/AspectRatios
- Black Screen
- Digikam/MetadataToRaw
- Category Translations Amharic, Arabic Asturianu
- Category Translations Galician Hebrew Hindi
- Digikam/Thumbnails
- Concepts/OpenPGP For Advanced Users
- Category Translations Assamese, Bulgarian Bosnian
- Digikam/Using XMP Sidecar support in digiKam 2
- Digikam/Duplicates
- Digikam/Color Labels and Picks
- An introduction to KDE
- Digikam/Vintage Effect
- Category Translations Luxembourgish Dutch Norwegian
- Dolphin/Customize Folder Icon
- Digikam/Panorama
- Category Translations Català Česky Kaszëbsczi
- Digikam/Using the Advanced Search Tool In digiKam
- Amarok/QuickStartGuide/TheContextView
- Amarok/Manual/Organization/Collection/RemoteCollections/Samba
- Digikam/Performing Fuzzy Searches In digiKam
- Baloo
- Category Translations Hungarian Indonesian Italian
- Amarok/Manual/Organization/Applets
- Digikam/Picasa
- Digikam/Face Recognition
- Cantor
- Amarok/Manual/References/MenuAndCommandReference/Help
- Digikam/ChangeFormat
- Amarok/Manual/References/MenuAndCommandReference/ViewMenu
- Amarok/Manual/References/Credits and License
- Amarok/Manual/Playlist/QueueManager
- Amarok/Manual/Draft/Scrobbling to Libre.fm
- Digikam/Black and White
- Digikam/Geotagging
- Digikam/Noise Reduction
- Amarok/Manual/Organization
- Amarok/Manual/Various/AmarokOnOtherPlatforms/NonKDE Desktops
- Amarok/Manual/Various/AmarokOnOtherPlatforms/Windows
- Gwenview/Hidden Configuration Options
- Category Translations Japanese Georgian Kannada Korean
- Digikam/Levels Adjust
- Amarok/Manual/Draft/References/MenuAndCommandReference/HiddenFeatures
- Digikam/Bugs
- Amarok/QuickStartGuide/HowToDealWithProblems
- Digikam/Import Photos in Digikam
- Category Translations Dansk Deutsch Eesti
- Digikam/Windows
- Digikam/Local Contrast
- Getting started with KAlgebra
- Applications/Science
- Category Translations Kinyarwanda Slovenian Slovak Swedish
- Artwork
- Digikam/Facebook
- Category Translations Polish Brazilian-Portuguese Portuguese
- Digikam/Wikimedia Commons
- Digikam/LightTable
- Digikam/Export via DNLA
- Digikam/Calibrate and Profile Monitor
- Amarok/Manual/References/KeybindingReference/GlobalShortcuts
- Digikam/Versioning
- Category Translations Romanian Russian Rusyn
- Browser Configuration/Opera
- Calligra Author
- Digikam/Soft Proofing
- Digikam/Manage Photos from Multiple digiKam Installations
- Amarok/Manual/References/MenuAndCommandReference/Settings
- Digikam/Maintenance
- Akonadi/Postgres update
- Category Translations Català Croatian Česky Kaszëbsczi
- Category Translations Persian Finnish French
- Amarok/Manual/Playlist/PlaylistFiltering
- Artikulate/Beginning
- Category Translations Greek Esperanto Spanish
- Digikam/Adding Borders To Your Photos
- Digikam/Watermark
- Homerun
- Digikam/Negatives
- Amarok/QuickStartGuide/Glossary
- Ark
- Digikam/Lens Distortion
- Accessibility/Plasma
- Amarok/Manual/Playlist/SavedPlaylists
- Amarok/QuickStartGuide/GettingStarted
- Digikam/Metadata
- Amarok/Manual/AmarokWindow/Toolbar
- Digikam/Compress
- Category Translations Serbian Telugu Turkish Ukrainian
- Digikam/Exposure Blending
- Akregator
- Create a Page
<translate>
Available Tools
- Page Layout helps to standardize the look of pages
- Tool Box shows you wiki markup for the effect you need
- Typographical Guidelines standardizes markup for use in translation, either to official manuals (DocBook) or to other languages.
Deciding where to create your page
Many people choose to draft a page on their own Talk page, then move the result to the desired site. Sometimes there is a good reason for preferring to do it in the final location. If that is the case, consider using before your content {{Construction}} which will display
Wiki Structure
For the convenience of users we try to avoid creating a structure more than three levels deep, avoiding having to type long paths for page names. For most purposes, the following guide will suffice:
Application
Application/Troubleshooting
Application/xxx-How-To
Application/Manual
Application/Manual/Introduction
Application/Manual/Section_1
Application/Manual/Section_xxx
Workflow
- Navigate to a page, which will contain a link to your new page
- Edit this page and insert a link to a new, not yet existing page like this: [[Special:myLanguage/My New Page]]
- Write a one-line summary of what you changed
- Hit the Preview button and check your work
- Save your edits.
Now the page shows a red colored link to your upcoming page. A click on this link will tell you, that the page doesn't exist yet, and offer you to create the page. Clicking this sends you directly to your new page and will open the edit box.
</translate>
- Digikam/RedEye
- General KDE Software FAQs
- Calligra
- Digikam/Using digiKam with MySQL
- Amarok/Manual/References/MenuAndCommandReference/Playlist
- Google Talk support
- Artikulate/TrainingScreen
- Installing KDE neon
- Digikam/Calendars
- Accessibility/Getting Started
- Amarok/Manual/Organization/CoverManager
- Digikam/Geotagging in digiKam 2.0
- Adding an entry to the Create New menu
- Amarok/Manual/Various/ReplayGain
- Getting Help
- Digikam/Batch Queue Manager and Script
- Applications/Desktop
- Akonadi and AddressBook
- Amarok/Manual/References/MenuAndCommandReference/Tools
- Category Translations Vietnamese Chinese
- Amarok/Manual/Organization/Collection/WorkingWithMediaDevices
- How to chat with other KDE users
- Dolphin
- Apper
- Amarok/Manual/Organization/Transcoding
- Digikam/Basic RAW Processing
- Amarok/Manual/References/KeybindingReference/AmarokShortcuts
- Digikam/Sharpening
- Digikam/Renaming Photos
- Falkon
- Amarok/Manual/Organization/Collection/SearchInCollection
- Amarok/Manual/Organization/Collection/ExternalDatabase
- Configure your desktop
- Amarok/Manual/Organization/Collection/StatisticsSynchronization
<translate>
Statistics Synchronization Between Collections and with Last.fm
Beginning with version 2.7, Amarok allows syncing the play-related metadata and statistics of the tracks (such as rating or play count) between any of your collections which show up in
and with the Last.fm web service, if you choose to use Last.fm.Manual Syncing
At any time, you can start manual synchronization from

From here, you can start a synchronization between the collections you select here, which will default to what you have configured in the Amarok Metadata configuration.
Conflicts and Syncing Statistics Dialog
When syncing, Amarok will show a dialog window which states the conflicts and statistics of the syncing that has recently been in progress. In this window you will be able to see three tabs:
, and .
- Matched Tracks
- This tab will show all the tracks that Amarok has found in more than one collection, and reflects conflicts. When tracks are grouped, you can see two types of background: light green, and light red. A light green background indicates the new or updated field, whilst a light red background will indicate the old/overwritten field. You do not need to solve all conflicts listed here; the particular field of the listed tracks are not going to be synced if you do not resolve the conflict.
- Unique Tracks
- These are tracks found in only one collection. You can use it as a difference view. Track dragging is supported here.
- Excluded Tracks
- These are tracks that are not synced because of different reasons, such as identical metadata, so as not cause to disorder in the database.
Synchronizing with Last.fm
If you have the Last.fm plugin enabled and configured correctly with your Last.fm account, you can choose to also synchronize your Amarok play counts, ratings and labels with your Last.fm Library. The sync takes some time, but you may continue using Amarok while it is syncing. Please note that Unattended Synchronization (which will be explained later on) is not possible with Last.fm, and synchronization from Last.fm to Amarok needs to be initiated manually.
Spelling Auto-Correction
Last.fm enables by default a feature that will auto-correct common misspelling during the sync. It can happen that even if you scrobble many track plays, it does not show up in Matched Tracks as Last.fm knows the track under a slightly different name.

You can disable this feature on the Last.fm site, and changes will be applied also to your past scrobbles. You have two options:
- Off
- Tracks are matched properly, but if you change your tags after some time, your play-count will be split in two tracks.
- On
- You can play-count the tracks even if tags are changed after some time, but you will have to use Last.fm preferred spelling.
Unattended Syncing
When you connect a device that is able to sync with your collections, a pop-up like this will appear.

For unattended syncing to start, you only need to click configured to participate in the synchronization, and tracks recently played on the device will be scrobbled to Last.fm, if it is enabled. The process will not ask for user interaction unless any conflict is found in the middle.
in the pop-up. Amarok will work in the background, so the metadata in your device including ratings, first/last played times, play counts and labels will be synced with other collections</translate>
- File transfers
- Amarok/Manual/AmarokWindow/ContextPane
- Common Tasks
- Amarok/Manual/ConfiguringAmarok/ChangingLayout
- Amarok/QuickStartGuide
- Jovie
- Amarok/Manual/Organization/Collection/OrganizeCollection
- Amarok/Manual/Organization/TagEditor
- Amarok/Manual
- Digikam/Process RAW Files
- Applications/Development
- Image Kimdaba
- Concepts/OpenPGP Help Spread
- Amarok/Manual/Playlist/AutomaticPlaylistGenerator
- Applications/System
- Applications/Historic
- Bangarang
- Applications
- Digikam/TaggingEfficient
- Gluon
- Amarok/Manual/Organization/CollectionScanning
- Audex
- Color Management
- History of KDE
- Applications/Multimedia
- IRC Channels
- Amarok/Manual/Playlist/DynamicPlaylists
- Applications/Education
- Amarok/QuickStartGuide/Playlists
- ChoqoK/Using ChoqoK
- Edit Markup
- Akonadi
<translate>
Introduction
The Akonadi framework is responsible for providing applications with a centralized database to store, index and retrieve the user's personal information. This includes the user's emails, contacts, calendars, events, journals, alarms, notes, etc.
Currently, all KDE PIM applications with the exception of Akregator are using Akonadi to access user's PIM data.
Controlling Akonadi
Akonadi will start automatically in the background when any application using it is started.
To manually start, stop or restart Akonadi, you can use the akonadictl
command from the commandline.
Using this method, you can get additional useful information on the console.
To start the Akonadi server,
akonadictl start
To stop the Akonadi server,
akonadictl stop
To restart a running Akonadi server,
akonadictl restart
To query the status of the Akonadi server,
akonadictl status
Disabling the Akonadi subsystem
The Akonadi server is automatically started by any Akonadi-enabled application. If you don't want Akonadi to be started after login, you have to ensure that no Akonadi-enabled application is launched at login or thereafter. Remember to check Plasma applets as well — the Digital Clock widget in the default panel, for instance uses Akonadi to (optionally) display calendar events and this is enabled in its settings by default (see the "Display Events" option) . You must remove any widgets that may start it from your start-up, if you wish Akonadi to start only when you start KMail or other applications.
To ensure that Akonadi is not started, check that no applications require it at login. In particular, open the Plasma clock applet preferences, go to and uncheck to prevent Plasma from requesting information from Akonadi and thus allowing it to start.
Some Definitions
- Real data
- By real data we mean the data, like the contacts or events. These data are stored either on a groupware server or in local files. Where exactly depends on the resource you are using. E.g. the Personal Contacts resource stores its data under $XDG_DATA_HOME/contacts.
- Cached data
- The cached data are copies of the real data that are kept in the database for faster access and offline caching. The database also keeps the meta data which are management data needed by Akonadi to work correctly.
- Configuration data
- The configuration data are the data that configure the Akonadi server and the individual resources. The general configuration data for the server can be found under $XDG_CONFIG_HOME/akonadi. The configuration data for each indvidual resources are stored under $XDG_CONFIG_HOME/akonadi_xyz_resourcerc# (xyz is name of resource and # its instance number).
- The Akonadi server configuration is a couple of files in $XDG_CONFIG_HOME/akonadi. It contains which data sources and helper programs are active and will be started and watched (so they can be restarted on crashes) by one of Akonadi's server processes (akonadi_control).
- Each data source handler (called resources) or helper program (called agents) can have its own configuration although some agents or resources don't require configuration. The general rule is that for every entry in $XDG_CONFIG_HOME/akonadi/agentsrc there is a corresponding configuration file in $XDG_CONFIG_HOME. For example, if the [Instances] section in agentrc contains an entry for akonadi_ical_resource_2, there is also a config file called akonadi_ical_resource_2rc in the $XDG_CONFIG_HOME directory.
- Depending on the type of data, such config files for resources will have filenames or directory names of where the data is stored. Common locations are KDE's legacy default files, e.g. $HOME/.kde/share/apps/korganizer/std.ics. New default locations are files and directories in $XDG_DATA_HOME, e.g. $XDG_DATA_HOME/contacts.
Backup
So now we need to decide what to back up. If you want to backup the "real data", then it depends on the resources you have configured... if you use a groupware server, then the backup should be done there. For contacts, the files under $XDG_DATA_HOME/contacts will normally be what you need.
To back up the entire Akonadi configuration, including which resources are active and their configuration, you can use the pimdataexporter' tool. This, however doesn't back up the Akonadi database containing the cached data and, unfortunately, after restoring the configuration (using the pimdataexporter again), Akonadi will have to re-fetch all data again into its cache. This can cause configuration that points to actual mail folders or calendars to get broken and accidentally point to another folder.
After restoring configuration and syncing all data, it's vital to manually check all folder configuration, especially in KMail identities and make sure the folders are configured properly.
Frequently Asked Questions
Where is my data now?
Your data are safely stored outside of Akonadi control on your disk (e.g. local maildir folder or iCal calendar), or on a remote server (in case of e.g. email over IMAP or events from a CalDAV calendar). Akonadi will optionally store a copy of this data in its database to allow applications to quickly retrieve and display them. Any modifications done to data in the Akonadi database will be synced to the actual storage. The main advantage of using the database as a cache is that remote PIM data are available even when you are offline, and you can still interact with them (e.g. mark emails as read or move them, create new events, reschedule existing meetings etc.) and all the changes will get synced automatically once you connect to the internet again.
Thus, deleting the Akonadi database will not cause any data to be lost (as long as all pending changes are synced).
How to upgrade my PostgreSQL database?
After updating your PostgreSQL server to a new major version, sometimes you will have to convert your Akonadi database for use with this new version. Instructions can be found on this page.
Migration problems
Akonadi's Glossary entry has a brief description of Akonadi's purpose, and other useful links.
How do I switch from MySQL/PostgreSQL to SQLite?
Since Akonadi 6 akonadi-db-migrator is included in akonadi that allows you to switch the database backend. Where for previous versions this involved deleting and recreating the database a migration is now properly supported by akonadi.
The tool needs to be called with the parameter --newengine to chose to which backend it should to: {{{
--newengine <ENGINE> The new DB engine to use. Possible values are "sqlite", "mysql" and "postgres"
}}}
For example: {{{ akonadi-db-migrator --newengine sqlite }}} </translate>
- Applications/Graphics
- Digikam
- Applications/Internet
- Amarok/Manual/AmarokWindow/MediaSources
- Introduction to new contributors
Become a contributor to UserBase
If you want to contribute to UserBase you need to register an account; this has many advantages:
- You get a user name and a user page which you can use to make drafts.
- You can watch pages to get notifications if something on the page changes.
- Your user name makes it easy for other people to recognize your work.
- You become a part of the KDE community.
Creating an Account
- In case you don't have a KDE Identity, register one here (your username will be combined based on your first and last name given during registration).
- After that is done, select the Log in link in the top bar of this wiki and input your KDE Identity.
- Now you are logged in, congrats!
You can change your profile in Preferences, for example timezone in the Date and time tab.
Before you start contributing
Be aware, that contributions to this wiki is released under the Creative Commons License SA 4.0 license.
Please also take note of our Code of Conduct.
What the UserBase wiki is about
This wiki is meant for end users of KDE products.
What the UserBase wiki is not about
- UserBase is not the place for info on development of our software, installation of not-yet-released versions and similar technical subjects. For that, go to the Community wiki.
- It is not for reporting bugs or annoyances or requesting new features. For that, go to our bug reporting site or use the relevant Mailing Lists.
- It is not the place to share your opinions about our products, or tell the developers what they should be doing. If you want a discussion, you might find the Matrix channel #KDE:kde.orge discussion forum discuss.kde.org interesting. (But do remember the Code of Conduct
).
Start contributing
Whatever happens, you are not alone. If you hit a problem don't be afraid to ask. Every page has an associated discussion page. Find a link to it in the menu line immediately below the title line. Edit that page to ask questions, discuss the content or start at discussion about the topic - it is usually picked up quite quickly. Questions can also be asked on Matrix, channel #kde-www:kde.org.
Don't be afraid to make mistakes. Someone is watching over you (or at least over the pages you edit). If you get something wrong, someone else will make it right.
If you want to experiment in order to familiarize yourself with page editing and the wiki markup, feel free to use the Sandbox.
Introduction to wiki editing
See this MediaWiki page for a general introduction to editing wikis. On UserBase we have a number of additional tools to help creating content (see below), and some conventions that we would like our pages to follow. However, you don't need to know everything before you start contributing. You'll learn as you go along.
If you are adding markup for the first time, please have a look at the Edit Markup page and the Typographical Guidelines
Editing a page
In the menu line at the top of the page directly under the page title you will find a link to Edit the page. Depending on your personal settings you may also have an edit-link for each section. To modify the text just click one of these links and start editing. The editor offers basic help.
When you have entered your changes
- Write a one-line summary of what you changed in the Summary box
- Click the Show Preview button
- Check how the page looks like in the preview. If you have included links, hover over them and look at the status bar to see if they are going to take you to the intended location; or better still, open the link in a new tab.
- If you need to correct anything, make the changes in the Edit box and click Show Preview again. Repeat until you're happy with the results
- Click on Save page to save your work
We have a number of guidelines and tools, but you shoudn't feel that you need to master all that before you can start. Don't be afraid to change what others have written, and don't feel offended, if someone changes what you have written.
If you want to discuss some changes with another contributor you can
- raise the issue on the discussion page of page in question, or
- use the link 'View history' to find the contributor you want to contact; then click the link 'talk' next to the name and leave a comment.
Modifying or adding an image
To modify an image see Update an Image.
To add a new image, it should first be uploaded to the server; use the link 'Upload file' in the right margin of the page. Please make sure that the images you upload are free to use under the Creative Commons License SA 4.0. More info here.
Creating a new page
All new pages should be linked to from somewhere. Find a suitable page and add a link to your new page to it. The link should look like this: [[Special:MyLanguage/path-to-your-page|some-text]]. The 'Special:MyLanguage/' part is a bit of magic, that allows readers to find a relevant page - in their own language if translated or else the english version.
Once the page with the link is saved, the link will appear in red, since your page doesn't exist yet. Click the red link and start editing to create the new page.
Relevance
The content should relate to KDE software, directly or indirectly. UserBase is for user content of any kind. E.g.
- For New Users - helping to get started
- For Regular Users - learning about new features and tips
- For Advanced Users - but use sub-pages for this.
Content that is only relevant for KDE contributors should be on Community Wiki.
Translating a page (or modifying a translation)
Before you can start translating content on UserBase you must request translator rights. Go to this page and follow the instructions. Normally you will be given translator rights within a few days. A small note will be added to your request to notify you, that you have been given the requested rights.
At the top of the page there will be a section with links to languages with translations of the current page. There you will find a link 'Translate this page'. Click that to go to the translation interface.
You will also see a link 'Start translating' in the left margin of the page. Clicking that will bring you to a page, that will give you an overview of all translatable pages.
Wiki gardening
If you come across a page that is no longer relevent (fx a page for an app that is no longer maintained) place a {{proposed_deletion|reason}} template on the page.
Guide to editing
Mediawiki syntax
See MediaWiki site for an introduction to basic wiki syntax.
Guide to UserBase editing
See Typographical Guidelines and Toolbox for an overview of syntax and best practices specific to UserBase. Other guides that may be of interest: Edit Markup,
- Applications/Utilities
- Calligra/Download
- Discover
- Amarok
- Digikam/Tutorials
- Asking Questions
- Historical Install Information
- How To Convert a UserBase Manual to Docbook
- Applications/Games
- Amarok/Manual/AmarokWindow/PlaylistPane
- Digikam/Tour
- Applications/Office
- Concepts/OpenPGP For Beginners
- Amarok/Manual/Various/TroubleshootingAndCommonProblems
- Amarok/QuickStartGuide/TheMusicCollection
- Desktop Effects Performance
- Jargon File
- Glossary
- Amarok/Manual/Various/Moodbar
- Digikam/Tutorials/Tagging and Face Tags
- ↑ Back to digiKam Tutorials ↑
What is Tagging and why do you want it
digiKam is an excellent tool to enrich a private photo collection by use of Tags and other metadata that can be written right inside the image files so the information you add follows the image file and will not get lost if you change computers or software (alternatively digiKam can save metadata in "sidecar" helper files next to your videos or read-only image files).
Tags in your photo collection work the same as #hashtags on the Internet – they help you to find all your images that belong to the same category that you provided: locations, names of people, events (birthday, national day…) or anything that is meaningful to you (for example pictures that contain Lego; your 2nd car; sunsets; etc.).
In addition, you can mark specific regions on the picture as “Face tags”, add descriptive text, rating from 1 to 5 stars and some more metadata types. All of this needs to be worth it – add data that you will realistically want to search and filter your collection on. Plus remember that you already have photo date, folder name where the photos are located (which is hopefully meaningful) and possibly even geographical coordinates embedded in your image files even before you start adding any tags.
Working with Tags can be as simple as marking the location, who is in the picture and giving 4-5 stars to really nice pictures. Perhaps you will see an existing Tag hierarchy in your digiKam that was built based on Tags that were found in the images that you already have (those tags may come from your relative, friend or even some software and you are free to use those tags as an example or build your own system). On the other extreme metadata can get almost scientific with rules, data models and words like “Digital Asset Management”. When you are ready to try adding some tags, continue with this tutorial on How-to do it.
Recently machine learning "AI" algorithms are doing more and more photo classification fully automatically, without any manual Tagging needed. Still, you can decide yourself how much manual tagging is worth it and what can be guessed by an algorithm. Note that digiKam also includes some similarity search tools and other clever algorithms which will evolve in the future to provide more value and easier search in your private photo collection.
Main Tagging tools in digiKam
In the current version of digiKam (7.2+) it can be a little bit complicated to find all the metadata tools and toolbars, but thankfully there are excellent keyboard shortcuts that will both help you find all the necessary toolbars and also make entering information very efficient if you choose to remember the shortcuts.
- The main metadata tools
Tags (descriptive tags): | T (re-configurable) |
Face Tags or people tags: | Ctrl + drag a box around a face |
Star rating: | Ctrl + 0 … Ctrl + 5 (re-configurable) |
Edit Title: | Alt + Shift + T (re-configurable) |
Edit Comment: | Alt + Shift + C (re-configurable) |
Pick Label or Flag: | Alt + 0 … Alt + 3 (re-configurable) |
Color Label: | Ctrl + Alt + 0 … Ctrl + Alt + 9 (re-configurable) |
Edit Geo location: | Ctrl + Shift + G (re-configurable) |
Edit Metadata (lots of fields): | Ctrl + Shift + M (re-configurable) |
Rename file (lots of options): | F2 (if you have RAW files, be careful renaming only JPG files) |
Rename folder: | Shift + F2 (affects folder on your disk) |
+ There are more tools such as “Adjust Time & Date” – see the menus and keyboard shortcuts.
Different metadata types
Tags – How To
To add a descriptive Tag – just press T when you have a picture selected. This will immediately open the right toolbar and you can start typing in a tag. Auto-complete will help you find the right spelling to match existing tags, or you can define a new tag.
Remember that descriptive Tags should be used as keywords - try to use as few unique Tags as possible and make sure you are not creating duplicates with spelling variations.

Organize tags:
- Build/edit tag hierarchy (good idea!) - you can drag and drop tags onto each other to “Move here” and create tags and sub-tags. For example Place “Family X home” under “City Name” to get a basic hierarchy.
- Rename tags – right click any tag and select and edit tag “Title”.
- Delete tags – note, if you Delete a tag, it will be removed from all files that ever used it!
- Assign a keyboard shortcut to a Tag – it is possible to add a unique shortcut key to directly assign frequently used tags.
- Changing icon – each tag can have a custom icon (the icon will not be valid outside your digiKam, so do not spend too much effort on this).
digiKam will propagate the change across all image files that used the old name.
Face Tags – How To
Face or People tags are excellent to show not only who is in the picture but also which one out of all those wedding guests is that person you are looking for. Note that digiKam is unique among open-source and multi-platform photo galleries to feature full support for face regions (including imported face tags from other software) – as always digiKam saves your efforts into formats that will be readable by other software and the data stays safely embedded in each image file.
Automatic face detection module in DigiKam is working and being actively developed. It can help you tag people without any privacy concerns of the “free cloud services” such as Google or Facebook. The use of automatic face detection is outside of the scope of this tutorial, but digiKam users do find the feature useful in the current state. No matter how good automatic detection is, you will likely run automatic detection first and then complement the results with manual face tagging.
For effective manual people-tagging use Ctrl + drag a box around a face shortcut. This is a must-know shortcut that beats any other method for adding face tags.

Comments, Captions Description and Title
The "Title" (and also “Captions”) field is suitable to write free text description about the photo or video which does not have the limitations like you find in filenames. Shortcut to quickly find the field: Alt + Shift + T. It is not that important how the field is called - the main difference from Descriptive Tags is that you are not expected to be consistent in the words you use or re-use this metadata among many files.
For compatibility reasons it is better to use only "Title" field. It is of course possible to use both "Title" and "Captions" fields together, but then it is important that you have good metadata settings or you are well aware of the known compatibility issues with other software, including possible loss of your "Captions" data.
Star rating
The classic 5-star rating feature. Quite widely supported and reasonably easy to interpret. You can find guides and suggestions how to use this scale or think of your own.
As an example, here is one way to interpret stars, as used by me:
0 stars | Not yet rated |
1 star | To Delete (not deleted for some reason) |
2 stars | Weak photo (useful for context, or completeness) |
3 stars | Good photo (nice to show to people) |
4 stars | Very good photo (“best of”) |
5 stars | Outstanding photo (“work of art”) |
Pick Label (flag) and Color Label
It is not recommended to use these labels for long-term data management.
Flag and Color labeling is quite individual and open for interpretation. So there is a risk that nobody except You will ever understand the meaning behind your choices. Note that Microsoft software does not properly use or show Flag labels or Color labels. The Flag set in WLPG is also not written to the files, so it is not practically usable outside the temporary local database of WLPG [source].
Still, Flags and Color Labels are supported by digiKam and this type of metadata can also be written into the image files. Here is a more in-depth tutorial about this: Color Labels and Picks in digiKam 2.
Geo location
Geo-tags is a big topic where besides manual coding there is also special hardware or GPS-enabled cameras (like most smartphones) that can help recording GPS data into your image files. DigiKam supports Geo-tags and map view, please see documentation or this tutorial for more details: Geotagging in digiKam. Shortcut: Ctrl + Shift + G.
Author, copyrights and other Metadata
If you wish to add other metadata, you are welcome to use “Edit Metadata” tool with a shortcut: Ctrl + Shift + M.
Advanced topics
Rotating face tags
If you import face tags from Windows Photo Gallery (WLPG) and possibly other software that does not correctly handle image rotation metadata, it is a common problem that in some images the face tags are rotated by 90deg to one side.
Unfortunately, as of now (v7.4) there is no direct way to rotate just face tags within digiKam.
One workaround is to use any software that can losslessly rotate your images, but does not handle face tags (leaves them unchanged). Here is an example of practical workflow using "FastStone Image Viewer":
- Right-click on the image with rotated face tags and select to open the file in the free "FastStone Image Viewer" for Windows. (or if FastStone is your default image viewer use can use → ).
- Losslessly rotate the image in FastStone (or equivalent software) so that it aligns with the face tags. Return to digiKam.
- Refresh the album data by either pressing F5 key or using → command. Now you should see a duplicate of both correct and wrong Face Tags while the image is rotated to a side.
- Fix the face tags by using → . Now the duplicate face tags should be gone, but the image is still lying on the side.
- Finally rotate the image to correct orientation using on-screen button or keyboard shortcut in digiKam.
As you can see, the current workaround is quite tedious, so for images with 1-4 persons it is probably easier to re-tag faces manually (until a better method is introduced).
Copy tags from one file to another
In case you create a new variant of an existing image in another software (for example – re-process a RAW file) it is very useful to be able to copy metadata from the previous variant of the image to the newly created file.
Unfortunately, as of now (v7.4) there is no direct way to copy tags from one file to another in digiKam. Some workarounds are to copy metadata using
- open-source jExifToolGUI (https://hvdwolf.github.io/jExifToolGUI/),
- command line ExifTool (https://exiftool.org/exiftool_pod.html#COPYING-EXAMPLES)
- or other software.
”The batch-click way” method for quicker tagging
Peter Albrecht described his digiKam tagging workflow with focus on efficiency that may help you gain speed and efficiency.
- switch to thumbnail view (you have to be able to select more than one image)
- shift the preview size to the maximum of 256 pixel (you want to be able to recognize the people on the photos)
- switch the right side-view to Caption/Tags and select the tab
- select picture number one and look at the leftmost person on this picture
- hold Ctrl down and select all other pictures, showing this person
- search for the corresponding tag in the right side-view, select it and apply.
- if there are more persons in picture one, then select this picture again go to step 5, while looking for the next leftmost person.
- if you have all the persons in picture one, select picture two and look again for the leftmost person, you have not tagged yet, and go to step 5. (toggling the button tags already assigned in the lower right corner of the Tags tab, is very useful here)
This way you go through all your pictures. In the beginning you have to tag a lot of people, but coming to the last pictures, most people will already be tagged and you can fast jump to the next picture.
About this tutorial
This tutorial is based on and is made to supersede the older tutorial from 2012: Tag your Photos (with focus on efficiency).
You are very welcome to edit, update and Upgrade this tutorial page to make it better. No attribution or copyrights in this page!
- Concepts/OpenPGP Getting Started
- Amarok/Manual/Trash/ConfiguringAmarok
- Digikam/Tutorials/Switch from Microsoft OneDrive or WLPG to digiKam
- ↑ Back to digiKam Tutorials ↑
Introduction
This tutorial is for people who would like to use open-source digiKam in-parallel or instead-of some Microsoft software that organizes photos (especially if you use people face tags):
- Windows Photo Gallery or older Windows Live Photo Gallery (WLPG).
- Microsoft OneDrive or built-in Windows tools.
- Some other Microsoft software.
DigiKam is an excellent replacement for discontinued WLPG and can even be made cross-compatible to use both digiKam and Microsoft software interchangeably (see configuration tutorial) but you should proceed with care and caution when you introduce digiKam or any other software that can alter your existing metadata.
In addition to this tutorial it is highly recommended to also be familiar with related tutorials by the same author: “Setup of digiKam for Windows compatibility” and “Tagging and Face Tags in digiKam”.
As an alternative to this tutorial, there is "Migrate from Windows Photo Gallery to digiKam" of author Farblos. It covers more of the metadata managed by Windows Photo Gallery than this tutorial, but at a certain cost: The migration process described there is one-way only, where you start with exclusive Windows Photo Gallery usage and end up with exclusive digiKam usage. And it requires a lot of command line interaction, most notably with ExifTool.
Back it up! Seriously
Before you allow digiKam (or any other metadata editor) import (show) your previously tagged image files, make sure you have taken all the precautions:
- You have to back-up all your existing image & video files, preferably so that you can very quickly copy them back to the main location (you may need to do it multiple times).
- Create a test photo gallery folder where you will copy-in a few files to test in digiKam, before you give digiKam access to your real photo gallery.
- Make an additional Permanent backup of photo metadata – see below. This is to save you from any issues that may not even be related to migration to digiKam.
- Test as much as possible before you accept that migration was successful and consider overwriting your older backups with digiKam modified files:
- Try tagging over 100 photos will all types of tags that you use.
- Try searching for photos using different tags (hierarchical, star rating, etc.).
- Check how files from different cameras, different sources and formats have migrated.
- Make sure you know what will happen with video metadata, people tags on rotated pictures and other potential issues (see "Microsoft image metadata" section).
- If you plan to use cross-compatibility with OneDrive tagging, WLPG or other software – try to repeatedly make edits in one program then observe the changes in another so that you have files where each type of metadata was over-written in for example:
- WLPG → digiKam → WLPG → digiKam
- digiKam → WLPG → digiKam → WLPG
- (there should not be any lost, duplicated or abnormal tags created from any of the edits. Exception - digiKam will likely create descriptive tags for all People Face Tags. This is not a significant issue for cross-compatibility.)
- Keep your Microsoft Photo Gallery installed as long as possible. This is one more advantage of cross-compatible digiKam setup – you should be able to use old Photo Gallery in parallel to digiKam in case you need to access some video metadata or any other reason.
Permanent backup of photo metadata
Here is an easy method to make a complete metadata backup from all your photos that will easily fit on one M-Disk DVD or a cheap flash drive. You never know when some virus, child or silly mistake will irreversibly wipe or corrupt your metadata. If you notice the damage too late, all your backups may by then already hold the corrupt files and only such permanent backup will be able to help. It is not only good for tags you add manually, but also to preserve more basic metadata like the date when a picture was taken.
The basic principle is that metadata, including all camera data, tags and people face tags are completely resolution-independent – you can dramatically resize and compress image data while preserving 100% of the metadata. Such conversion must be doable by many ways, including in digiKam (please edit this tutorial to add your favorite method), but my personal favorite tool for such metadata backup is:
- Method A
- Open the free "FastStone Image Viewer" for Windows so that you see the main toolbar (not full-screen mode). This program is reliable and has minimal risk of messing up your files.
- Go to → and "Add" all your photo gallery folders to the "Input List".
- Next to “Output Format” set JPEG and in the “Settings” choose quality for example 70%. (we want images to be recognizable, not beautiful).
- Under "Use Advanced Options" choose “Resize based on long side” to for example 1024px. (again just to keep images recognizable, you can go lower if you need to save more space).
- Under “Rename” it is nice to add for example
*_metadata_bckp
to each file, so that you better recognize the highly compressed files if you will work with them. - Choose a reasonable output folder and press (folder structure will be preserved).
- When everything is done, I suggest you add a text file note with date when you did the metadata backup and for what reasons. Then compress everything with 7zip to reduce the size even more and have one easy to move file for permanent storage.
- Method B
Use command line ExifTool to create recursive metadata-only backups as described in detail here: Farblos/wpg2dk - backup. This method is more powerful than "method A", because ExifTool is also a tool that can be used to restore your damaged metadata (following the same tutorial by Farblos).
Microsoft image metadata
Before you start using digiKam to manage your WLPG tagged gallery, it is good to understand where the potential risks and issues are. Depending on how you used tags in WLPG, some of these concerns may not be applicable to you!
- Tag hierarchy needs care – Default Metadata settings in digiKam are prone to create many loose tags out of the nicely organized hierarchies such as for example “Location/USA/New York/Central Park”. If you set up digiKam correctly ("Setup of digiKam for Windows compatibility"), this will be 100% resolved.
- Face / People tags are a challenge – digiKam can fully support people tags as they were handled in WLPG (only for backwards compatibility to Microsoft software, you need correct metadata settings in digiKam). More importantly most (or all) vertical orientation images will have “Face tag rotation issue” which is covered in detail further below.
- No Flag – setting “flag” in WLPG is not saved to any file (only internal database), so this data is lost any time you move to another computer or another program [source].
- No metadata for videos. In contrast to photos, common video file formats do not support embedded metadata. As a result WLPG only stores video metadata in the internal database without any method to export the data Therefore WLPG video metadata is lost any time to you move to another computer or another program. DigiKam actually solves this issue by creating extra .xmp sidecar files next to each un-writable file, so as long as the extra files are not lost, digiKam will always preserve your video tags in the future. In fact, to be safe, it is a good idea to always keep year-month-day date and some keywords in the filename of important video files, because it is easy to separate video file from its metadata.
- Beware of "Read-Only" files! – It is worth double-checking that you do not have any Read-Only files and folders in your collection. We must have all metadata stored inside the files for digiKam to read it, but no software will write your metadata into files if the files are write-protected.
- In case, you just changed some read-only files to writable, you need to open WLPG and to be safe - add some new tag to all files that were previously Read-Only. Wait for WLPG to write that tag along with all other metadata to all files (then you can easily remove that dummy tag in WLPG or later in digiKam). + you can always double-check which metadata is saved in a file by opening file properties in Windows Explorer.
- The rest of the metadata is straightforward. There is marginal risk that captions, star rating and individual descriptive tags from WLPG or OneDrive would get lost. Only reason for this data to get lost is if the image files were set to "Read-Only" or if WLPG did not manage to synchronize tag information to files as it is supposed to. In fact, most software can deal with these more basic tags and you may find other software, such as built-in Windows tools as good-enough alternatives to digiKam which still save metadata into files.
For more information you are very welcome to read excellent articles by José Oliver-Didier which cover a lot more about Microsoft image metadata specifics: https://jmoliver.wordpress.com/2017/02/12/accessing-windows-photo-gallery-metadata-using-exiftool/ , https://jmoliver.wordpress.com/2020/02/16/onedrive-photo-captions-and-tags/ and other related blog posts.
The Migration
Now when you are ready to Switch to using digiKam you need to decide on one of the 2 routes:
- Simple data import using Metadata written inside your image files - approach that can provide nice results for most people (this tutorial is mostly about this approach - see the limitations of this approach in the paragraphs above and below).
- Using this approach - you only need to correctly configure digiKam and then let it scan your photo collection - digiKam will just read all the Metadata out of your image files.
- Main Dis-advantage of the simple approach - Tags and ratings of videos will be lost along with "Flags" (if you use them) + the Face Tag rotation issue asks for some manual work (which can be done at a later point).
- Use the advanced "WPG-metadata-database-to-XMP" method by Farblos: https://github.com/farblos/wpg2dk . The main things consider:
- The database migration method is applicable only once - usually only if you have not started editing your photo gallery in digiKam previously.
- You have WLPG installed - the method reads data out of WLPG database, not image files.
- Main advantage - This method can export metadata on videos, "Flags" and automatically fixes the Face Tag rotation issue (migration is more comprehensive than the simple approach - assuming you have a lot of tagged videos, you use "Flags" or know another reason why the simple approach does not meet your requirements).
- Main Dis-advantage 1 - This method requires a lot of command line steps - not an easy process.
- Main Dis-advantage 2 - Any time and convenience gained compared to the "Simple data import" will likely be offset by the increased risk of data damage and more additional testing needed to verify that everything worked well.
Microsoft Face tag rotation issue
Microsoft’s face tags (usually from WLPG) are affected by long-term-bug which results in face regions being shown rotated by 90 degrees to one side on some of the pictures.
It seems that we want a one-click fix for the whole collection, but in practice it is not very safe to run a script which will make changes to hundreds or thousands of images which are distributed all around your collection. The backups and testing to avoid potential disasters would take much more time than the “one-click” that we all would like.
Therefore I recommend a semi-automated approach which takes 2-3 button presses per image, but includes direct verification that you are making correct changes only where needed.
Root cause and potential workaround
As long as the image “Exif orientation tag” is not “Normal”, Microsoft WLPG will always treat face tags differently than all other software that recognizes “Exif orientation tag” (for example digiKam). Therefore to make a file universally interpreted by all software including Microsoft WLPG any affected file needs to be losslessly rotated so that “Exif orientation tag” is re-set to “Normal”.
The issue exists because Microsoft is the only company in the world which does not correctly support image rotation tags which are used by most digital cameras.
In practice, the problem is almost exclusively present in portrait orientation images with face tags (but only if the image contained “Exif orientation tag” which is typically written by digital cameras with an orientation sensor - again not in all cameras).
Fixing one file at a time
In case you have only a few affected files, it is possible to make corrections on each individual file – please see the other tutorial for information on how to Rotate face tags on individual files.
Semi-automated approach
https://bugs.kde.org/show_bug.cgi?id=447674
This approach practically does not require any testing, because we will manually check and rotate face tags on each potentially affected image. When done correctly it will take a couple of seconds per file and most likely you have around 1000 affected images (1000 x 3sec = 50min of work). Plus this approach can be used at any time – when you migrate your collection, after you have already fixed a few images or when you add a couple or thousands more images that need to be fixed.

- Open the panel
- Click
- Select images which have “People” Tags. (When digiKam reads in Microsoft face tags, it automatically creates descriptive tags with “People” parent tag.)
- Select “In Tree” option because we are interested in sub-tags of the “People” parent tag
- Select “Portrait Orientation” (because this is the orientation data which causes face tag rotation issue in Microsoft’s software).
- You can add additional conditions, for example limit the search to specific Album, Date or camera model. This is especially useful if you are adding new photos to a collection that was previously fixed.
- Press to find all photos that are most likely affected by the issue. (Note, you can always save the current search if you like.)
- Now you have a list of all photos that need to be checked by simply switching to the next photo one after another. Make sure you have “Show Face Tags” activated to directly see all face tags on every photo.
- The actual fix is done by using “Rotate Face Tags” command which has to be mapped to a keyboard shortcut. (Note, this feature was not yet available in v 7.4, but hopefully is there now.)
- The rest of the workflow is:
- “Look if the face tags are wrong”, if Yes,
- “Press the right keyboard shortcut to rotate face tag into correct direction”, then
- “Press Arrow Right to see next photo”.
Fully automatic solution
Since March 2022 there actually is one fully-automatic solution for the face tag rotation issue (along with some other features) - https://github.com/farblos/wpg2dk . Note that this method is Not easy to follow and is suitable for very dedicated users only. Even if a fully-automatic solution would be easy to use (“require just one-click to run and forget"), I personally would still use the Semi-automated approach for data safety and in most cases also to actually save time (manual face tag changes take less time than all the precautions and verification necessary to run a rarely-used script that executes low-level Metadata changes on your whole photo gallery).
Notice that even if you fix all your old files at some point, you may still get more affected images in the future.
Other Metadata issues
For most users, the instructions above will give great results and you do not need to read any further. In case you encounter specific problems, here are some extra hints:
- Potential corruption of metadata due to ”byte order of the makernote section” with Canon files: https://exiftool.org/forum/index.php?topic=11264.0
Summary
Metadata is tricky – different software looks for different data and interprets it in different ways. Nevertheless, everyone can retain all their metadata from WLPG and other Microsoft software in digiKam. But with some additional digiKam configuration you will also retain cross-compatibility to continue searching through your metadata directly in Windows, OneDrive or any other Microsoft software.
Finally, if you make some configuration mistake – it is not the end of the world. Perhaps just using your previous backup will solve your issue, but even in really bad cases there are command-line tools such as ExifTool can come to the rescue.
About this tutorial
This tutorial was originally written for digiKam 7.4 in 2021-12. You are very welcome to edit, update and Upgrade this tutorial page to make it better and keep it up to date. No attribution or copyrights on this page (all illustrations are original as well)!
- Amarok/Manual/ConfiguringAmarok
- Amarok/Manual/Various/FAQ
- Dolphin/File Management
- Digikam/Tutorials/Setup of digiKam for Windows compatibility
- ↑ Back to digiKam Tutorials ↑
Introduction
It is safe to say that digiKam (7.4) is the most powerful image metadata management photo gallery software. Unless you use command-line tools, there is no more universal program to read and write any metadata that you can imagine than digiKam (it even allows you to define new metadata namespaces to read and write data to, in case something is missing). As it is free for everyone, open-source, writes metadata back to files and runs on multiple operating systems – digiKam is truly future-proof tool to manage all your image and video metadata (people face tags, descriptive tags, location, captions, star ratings and more).
Unfortunately, as digiKam tries to be (and can be) cross-compatible with everything at once, the default digiKam settings cannot satisfy everyone. This tutorial provides a suggestion on how to best configure digiKam for new users or people who have managed their photos using any of the Microsoft software, including Windows built-in metadata tools.
The recommended configuration
Of course, you can use digiKam with default settings, but here are the reasons why you may want to follow this tutorial and change the Metadata configuration.
The Advantages:
- Less garbage in the files – the default configuration writes the same metadata multiple times under many metadata fields. While it can be good for ultimate compatibility outside digiKam, it practically guarantees that any other software will read and modify only part of those fields. As a result, if another software is involved, your image will carry both updated metadata as well as old metadata that was originally created by digiKam but not recognized by the other software that did the latest edit (for example OneDrive, Lightroom, etc.)
- More robust – This configuration keeps your digiKam tagged images cross-compatible with Microsoft OneDrive and Windows so you can correctly use and edit metadata even on Windows computers where digiKam is not installed (for example if you send files to your relatives). In addition a lot of major photo metadata software, including online services will correctly read Microsoft compatible tags, because it is one of the most common image metadata formats embedded into image files.
- This configuration will correctly preserve hierarchical tag structures, without creating lots of duplicate tags (when the same information is written in many metadata fields, other software, for example, Microsoft Windows may interpret the metadata from default digiKam configuration as multiple separate tags)
The Drawbacks:
- By disabling Read and Write to less common metadata fields, you are also stopping digiKam from correctly importing such metadata. But it is not very likely to find files that exclusively use the less common metadata fields which we are disabling – usually, the same information will be duplicated in another enabled field. (Plus it is possible to individually disable writing certain metadata fields while still reading them by un-checking “Unify read and write” in the Advanced Metadata settings).
What you need to know
- You have to re-check the Metadata settings every time you update digiKam to a new version, before you resume using digiKam as usual. Currently (digiKam 7.4) you do need to repeat the manual Metadata setting changes after each digiKam update.
- There may be bugs, special exceptions or just format changes that could break cross-compatibility that we try to achieve (from digiKam to Microsoft programs). The good news is that such metadata issues are almost always resolvable either by tools built in into digiKam or in the worst cases by other programs, where ExifTool is usually the ultimate solution to just about any metadata problem (see one old example here).
- If you are migrating from some Microsoft metadata editing software, there is a dedicated additional tutorial to help specifically WLPG, OneDrive and other Microsoft software users - how-to Switch from Microsoft OneDrive or WLPG to digiKam.
- The statement “This configuration keeps your digiKam tagged images cross-compatible with Microsoft” does include some limitations:
- If you save people face tags in digiKam it will automatically create descriptive tags for each person in a hierarchy “People/<face tag name>”. This is not the same as WLPG behavior, but still shows-up nicely in any Microsoft software.
- If you save people face tags in digiKam it will also create "MWG regions" which follow the main standard to save face tags and performs the same function as Microsoft People Tags. Microsoft software will always display correctly people tags saved in digiKam (and digiKam always reads Microsoft created People Tags), but you can not edit digiKam created face tags in Microsoft software!
- Trully cross-compatible changes (edit in digKam or Microsoft at any time) are:
- selecting/deselecting descriptive tags,
- changing Title in digiKam == changing Caption in WLPG,
- changing star rating.
- If you encounter some problems while following this tutorial – please add a “Warning” box to the tutorial to warn everyone about a potential issue and consider filing a bug report at https://bugs.kde.org/describecomponents.cgi?product=digikam
Change the settings
Here are all the steps to correctly set up your digiKam for the recommended configuration.
Step 1 – Configure the basics
Before you begin with the details it is good to have the basics right:
- Check the folder and file Properties of your photo collection using a basic file browser. Check that:
- Either all your image files can be modified (“NOT Read-Only”) – necessary if you want to store all your tags and metadata inside the image files (this is the typical approach for the best metadata preservation).
- Or in case you plan to only use sidecar files for all your media (more information about “Sidecar” files further below), then you may choose to set your files to “Read-Only” (but not folders).
- Select the right database type for digiKam. According to the documentation, all database options are good but have different pros and cons:
- SQLite is effortless to configure, but if you have more than about 100 000 files in your collection it can become a performance bottleneck. Note that you can always migrate to another database type later, so no need to worry about this.
- MySQL Internal requires more work to set up, but should pay off in terms of performance in large photo collections. You will actually need to follow the 1st provided “download” link and install “MariaDB Server” (you can leave the root password empty for MariaDB and Disable Networking) and then click “Find” and locate the 1st required .exe file in the MariaDB installation folder.
- MySQL Server is only used if multiple computers with digiKam will access the same shared photo library. Again, you can migrate to this type of database at a later point.

Finally when you choose which folders with images and videos digiKam will manage, consider that:
- You should NOT add your true main collection to digiKam before you complete "Step 2" and decide if you want to Set up digiKam to ignore RAW files. But you can add some test folder(s) to initialize digiKam and run some tests.
- Consider ticking the “Monitor the albums for external changes” setting. It should make digiKam more intuitive to use, but could also impact performance.

Step 2 - Fix which metadata is written into files
The main Metadata settings are under
→ → → . Here we will set DigiKam to not-write to various unnecessary Metadata fields. (For simplicity we are also disabling reading of those fields, but you are welcome to disable only the writing by un-checking the “Unify read and write”.- Start with WLPG from overwriting your Caption by duplicating Title text). Remember that Microsoft WLPG confuses Title & Caption, so it is safer to only use either “Title” or “Caption” but not both at the same time. See “What tags to use” for more info. (aka Comments): here deselect all namespaces except for “Xmp.dc.description” and “Exif.Image.ImageDescription”. AND using button raise the “Exif.Image.ImageDescription” field to the 1st priority (this is important to stop

- Under – leave only “Xmp.xmp.Label” (it is enough)

- Under – leave only “Xmp.xmp.Rating” and “Xmp.MicrosoftPhoto.Rating”.

- Under we have a more complex case (see screenshot):

Name: | Xmp.dc.subject | (substitute for the existing one) | ||
Spec_options: | TAG_XMPBAG | |||
Separator: | / | |||
Set Tags Path: | YES | <== this is the FIX to the main problem! |
Do the same thing for Xmp.lr.hierarchicalSubject - disable the original and create a new entry. Follow the steps like Xmp.dc.subject above. For 'name' enter 'Xmp.lr.hierarchicalSubject'. Reason is that Darktable uses these, and if Digikam does not read/write them too, they may get out of sync.
- Leave enabled "Xmp.Micosoft Photo.LastKeywordXMP" namespace (as it is used by WLPG)
- Then disable all other namespaces (unless you have a specific reason to keep some of them enabled)
- Finally under – leave only “Xmp.dc.title”. Remember that due to Title & Caption confusion in Microsoft WLPG, it is safer to only use either “Title” or “Caption” but not both at the same time.

Step 3 - Other important metadata settings
Here we check that Metadata is actually written into files, and not just left in the digiKam database.
- Under → → → make sure that all Information is written into the Metadata.
- There is also “Use lazy synchronization” option which I recommend to enable to improve performance and avoid re-writing each file multiple times for every little edit that you make. It also can help to detect accidental metadata changes.

- Under documentation, the option “Read from sidecar files” means "digiKam will only read the sidecar while ignoring the embedded metadata.” the basic idea is to allow digiKam to write sidecar files, but only for media files that can not contain metadata directly (most useful for video files or any file that is set to read-only). According to the

- Finally for it is preferable to choose lossless data rotation instead of using the orientation metadata flag. (The main reason is Microsoft – MS still does not respect the orientation flags and it causes issues such as your pictures may appear on a side when viewed in Windows as well as problems with rotated face tag regions)

Fix Tree view
This setting is not essential, but if you do not have ticks in the
→ and → , then the tree structures in the left panel will not behave as most users would expect – highly recommended to make this change if you are setting up digiKam for a new user.Unfortunately in digiKam (7.4) the Albums tree still has a limitation that only one tree entry can be selected at the same time - https://bugs.kde.org/show_bug.cgi?id=269340. (it is possible to select multiple tree entries in the Tags tree, but not in the Albums tree.)

Personalize appearance
In addition I would suggest to experiment with settings for digiKam's
- appearance in → ,
- thumbnails in → → → and
- sorting in → to get to an optimal look and feel for digiKam.

RAW file handling
If you have “digital negatives” (RAW files) together with the usual .JPG image files in your collection there is always a concern about how to best handle these files. Here are some of the common options:
- Show All
- Most software by default just shows both JPG and RAW files as equals. This is the worst option because it makes it very cumbersome to view, sort or tag your pictures. Remember that when you do need to see both JPG and RAW files together, there are always normal file browsers that are simple and reliable.
- Grouping RAWs under JPGs
- More advanced software offers to automatically recognize which RAW files belong to which JPGs and apply all operations on the “groups” of files. This is a valid approach IF it is easy to use and robust. DigiKam can do grouping, but there are a few things to consider if you choose to use it:
- It is not possible to permanently enable grouping in digiKam (7.4) – grouping must be manually enabled every time by selecting all photos that should be grouped, then right-clicking one thumbnail and selecting → .

- As grouping is not always enabled, it is difficult to explain how to use grouping to infrequent users. And even geeks will not appreciate the required extra manual steps.
- Finally the grouping by Filename is very simplistic in digiKam 7.4. If you make any changes to the filename of the JPG file, for example, add “_cropped” or “_altColor” to the filename, it will no longer be grouped with a corresponding RAW file (so you will again see that RAW file during slideshow and will need to tag it separately.
- Ignoring RAWs
- As digiKam is not a true competitor to a dedicated RAW processor, I prefer to use digiKam only to manage metadata in the photo collection. Then it is optimal to block digiKam from reading RAW files and only deal with JPGs and videos. It means:
- Simplicity – even inexperienced users will not get distracted by the RAW format duplicates of every image. And the limitations in grouping of RAW+JPG in digiKam are not a problem.
- Perfect consistency – if you do not try to sync RAW file metadata with the JPGs then all potential metadata mismatch problems go away. (for example if you import RAW+JPG files where only JPGs have been tagged by another program)
- As RAW files are ignored, they never get modified and there are no additional .xmp sidecar files when you make changes to the Metadata – which is good for backups and performance.
- The downside – to move images between folders, you would have to use a generic file browser, because in “Ignore” mode digiKam will normally not do any operations with RAW files.
- Also you will need to remove RAW files which are left after you delete unwanted JPGs. This is not just digiKam issue as I personally use multiple image viewers for sorting pictures which also leave RAW files behind. My preferred solution for leftover RAW files is this simple Python executable script that automatically removes all orphaned RAW files: "CleanUp_RAW_files.py"
If you... | Show All | Grouping RAWs under JPGs | Ignoring RAWs |
---|---|---|---|
Move complete album | All files & folders are moved | All files & folders are moved | All files & folders are moved |
Move file by file | All files can be moved | All files can be moved | ONLY "JPG" files will be moved |
Delete file by file | All files can be deleted | All files can be deleted | ONLY "JPG" files will be deleted |
Set up digiKam to ignore RAW files
My recommendation is to stop digiKam from reading RAW files and make any changes to RAW files in other software. The full list of RAW file extensions that digiKam can load is given in the documentation [link].
To disable all RAW files (or any other file extensions) go to → → → and under “Image Files” add this list with all file extensions that need to be ignored by digiKam:
-rw2 -crw -cr2 -nef -orf -raf -rwl -pef -ptx -x3f -dcr -kdc -dc2 -k25 -srf -arw -mrw -mdc -raw -dng -bay -erf -fff -mos -pxn –rdc

What tags to use
Even when all the metadata settings are correct, to ensure best cross-compatibility it is still important to use the tags in a compatible way. For example, Windows does not differentiate between “Title”, “Caption” or “Comments” so if you use all of these fields simultaneously, some Microsoft software can overwrite part of what you wrote and cause permanent metadata loss [source].
Here are the strongly-recommended; safe-to-use metadata fields (notice, almost the same as in WLPG):
- Descriptive Tags organized in tag hierarchies – tags are good, but tag hierarchy greatly enhances the usefulness of predefined tags. With the recommended settings, tag hierarchy is fully supported and cross-compatible with Microsoft tools.
- Face Tags or people tags are excellent to specify who is who in the photo. Supported and useful. Note you can as well tag pets or other non-human points of interest using face regions.
- Edit “Title” field – this field is effectively the primary filed for all Comments and Captions despite the name of the field. (In WLPG this data is editable as Caption. More details below.)
- Secondary: “Caption” field can be used if you really have to. Microsoft software will show it as “Comment” in file properties, but for example WLPG cannot edit this field.
- Star rating – fully supported and a more robust alternative to Colors or Flag labels.
- GPS geotag data.
- Names (Author) and Copyright under the Information – Rights in the right digiKam sidebar.
- Plus you can rename the file, but be careful in case your image has a corresponding RAW file. After re-naming, RAW file should still match the beginning of the new filename.
- Finally it is useful to keep meaningful folder names that can contain some basic “Caption” and start with a relevant date in “YYYY-MM-DD” format (to have some control over your files outside dedicated photo management software like digiKam).
For more information how to actually efficiently apply tags in digiKam see “Tagging and Face Tags” tutorial.
For all other Metadata fields and types – use at your own risk. Everything will work in digiKam, but may be hard to access for other software.
Title, Captions and Comments confusion in Windows
This paragraph explains in-depth how the recommended Metadata configuration affects Title, Caption and Comments. In short – it results in a nice match with Windows 10, but if you are migrating from Microsoft WLPG or OneDrive, then you may want to read on.
The screenshot and table below shows how Metadata will appear in:
- Windows 10
- digiKam 7.4
- obsolete Microsoft WLPG.

1 in Windows | 2 in digiKam | 3 in Microsoft WLPG | |
---|---|---|---|
Title saved in digiKam is | Title | Title | Caption |
Caption saved in digiKam is | Comments & Subject | Caption | NOT visible |
Caption saved in WLPG is | Title & Subject | Title (*) | Caption |
As you can see from the table:
- “Title” is the only field that reliably appears in all 3 compared environments
- “Caption” in digiKam will be “Comment” in Windows, but is not visible in the old WLPG. And as long as digiKam uses recommended Metadata configuration, this data is safe from corruption by Microsoft WLPG.
- The “Subject” property in Windows is unreliable and unnecessary. Depending on which program saves the data last it will contain duplicate of digiKam’s “Title” or “Caption”. This field is linked to “Xmp.dc.description” (and possibly also other namespaces).
- (*) special case – if you create Caption in WLPG (or OneDrive?), on import to digiKam it will be duplicated in digiKam as Title and also as Caption. As the relevant information is just duplicated, it makes almost no practical difference. (If you really want to avoid this, you can disable reading of the “Xmp.dc.description” namespace under Advanced settings of “Caption”, but it is important to keep writing to the “Xmp.dc.description” namespace to be able to overwrite any obsolete “Xmp.dc.description” information.)
Future improvement suggestions
No doubt we would like faster, more robust and intuitive way to configure digiKam for an average user. Here are some suggestions on how to make digiKam configuration better:
- Macro – as a temporary measure, someone could write a script to modify digiKam settings using one executable file. The advantage would be that anyone could read and modify what the script does and therefore make a custom one-click setup script for their unique configuration.
- Configuration presets – just as many other programs (for example see Blender keymap presets), digiKam could offer users a choice which Metadata configuration preset to use already during initial configuration. This way there could be multiple ready-made profiles depending on the use case; depending on which other software user migrates from or uses in parallel.
- Simplified digiKam – just as there is ShowFoto as a standalone part of digiKam for image editing, there could be a simplified gallery viewer and manager suitable for non-geeks so that everyone could use the metadata features without complex setup tutorials and editing of configurations.
The good news is – digiKam is open source, so anyone can pick up a challenge and make the improvements we all need. Meanwhile digiKam works already, so happy tagging after the setup!
About this tutorial
This tutorial was originally written for digiKam 7.4 in 2021-12. You are very welcome to edit, update and Upgrade this tutorial page to make it better and keep it up to date. No attribution or copyrights on this page (all illustrations are original as well)!
There are 326 pages beginning with KA-KZ
- KDE Connect
- KXStitch/Manual
- KDE Applications Versioning
- KColorChooser
- KWord/*
- KPlato/Tutorials
- KDevelop4/Manual/Getting started: Sessions, Projects and Working Sets
- KDE System Administration/Kiosk/Resources
- KDE System Administration/PlasmaDesktopScripting
- KDE System Administration/Kiosk/Keys
- KDE System Administration/PlasmaTwoDesktopScripting
- KDE System Administration/Kiosk/Introduction
- KMenu
- KDevelop4/Manual/Tool list/Snippets
- KOffice
- KDE Connect/Tutorials
- KMail/Distributions/ArchLinux
- KDevelop4/Manual/Appendix: Pages that still lack documentation
- KDevelop5/Manual/Appendix: Pages that still lack documentation
- KAlgebra/Screenshots
- KWord/1.5/Manual/MimeType
- KTux
- KMail/Linux
- KMail/Screenshots
- KWord/1.5/Manual/Compile
- KDevelop4/Manual/Tool list/Decoding table
- KWord/1.5/Manual/TempCat
- KGpg/Manual/Credits
- KPlato/Manual/Project Performance View
- KTurtle/Screenshots
- KDevelop4
<translate>
Additional pages for KDevelop4 -
</translate>
- KWord/Manual
- KDiskFree
- KPPP
- KTimer
- KOrganizer/Custom
- KDevelop4/Manual/Tool list/Unit Tests
- KPlato/Manual/Task Performance View
- KGpg/Manual/Introduction
- KNemo
- KPager
- KDE preinstalled
- KOrganizer/Calendar
- KNotes
- KWord/1.5/Manual/InsertBar
- KWord/1.5/Manual/Obtain
- KDevelop5
Additional pages for KDevelop5
- IRC: #kdevelop at freenode
- Dashboard: phabricator.kde.org
- Compile: HowToCompile v5
- Bugs: bugs.kde.org
- KDirStat
- KDE SVN
- KWord/1.5/Manual/TutorialSummary
- KImageMapEditor
- KAddressBook/index
- KMPlayer
- KWord/1.5/Manual/Starting KWord
- KMouth
- KDE Connect/Tutorials/Adding commands
- KMag
- KIPI
- KWord/1.5/Manual/FileBar
- KJots
- KFormula
- KWord/1.5/Manual/ParaBar
- KGraphviewer
- KWord/1.5/Manual/DeletingFrame
- KSniffer
- KOrganizer/Appointments
- KGpg/Manual/Decryption
- KOrganizer/ImpData
- KCharSelect
- KDiff3
- KDevelop5/Manual/Plugins: PHP Debugging
- KWord/1.5/Manual/Inserts
- KOrganizer/Alarms
- KOrganizer/Web
- KWord/Tutorials
- KWord/1.5/Manual/ImpEx
- KWrite
- KAppTemplate
- KInfoCenter
- KNode
- KOrganizer/Future
- KWord/1.5/Manual/IncFilters
- KWord/1.5/Manual/FormatBar
- KWord/1.5/Manual/BorderBar
- KWord/1.5/Manual/RetrieveDoc
- KWin/Gallery
- KRuler
- KWord/1.5/Manual/access
- KLinkStatus
- KWord/1.5/Manual/Toolbars
- KFileReplace
- KOrganizer/Links
- KWord/1.5/Manual/Columns
- KCalc
- KTorrent
- KHelpCenter
- KPlato/Manual/Introduction
- KPDF
- KTouch
- KWord/1.5/Manual/MoveFrame
- KEuroCalc
- KWord/1.5/Manual/EditBar
- KWord/1.5/Manual/ResizeFrame
- KPlato
- KPlayer
- KMediaFactory
- KAddressBook/Tutorials/How to create a new address book?
- KFTPgrabber
- KJots/Recover Deleted KJots Books
- KPlato/Manual/Managing Resources
- KMLDonkey
- KPlato/Manual/Task Execution View
- KAddressBook
- KWord/1.5/Manual/Thesaurus
- KMouseTool
- KPlato/Manual/Main Work Space
- KGeography
- KChart
- KDE International
- KCells
- KJots/Import KNowIt Into KJots
- KTouch/Port Keyboard Layout
- KWord/1.5/Manual/CLO
- KGpg/Manual/Getting Started
- KDE Itinerary
- KPlato/Manual/Cost Breakdown Structure Editor
- KIconEdit
- KSystemLog
- KAddressBook/Tutorials/How to add a new contact?
- KPlato/Manual/Using the Views
- KDbg
- KPilot
- KWord/Manual/Introduction
- KFloppy
- KUIViewer
- KWord/1.5/Manual/Requirements
- KNetworkManager
- KMail/Courses Information Openpgp
- KTechlab
- KPlato/Manual/Work and Vacation Editor
- KDE Partition Manager
- KAlgebra
- KPlato/Manual/Task Status View
- KGpg/Manual
- KWin Rules Application Workarounds
- KTouch/HowTo/DifferentKeyboardLayout
- KGpg/Manual/Using KGpg
- KMix
<translate>
Home » Applications » Multimedia » KMix
</translate>
![]() |
<translate>
Control all your audio channels</translate> |
<translate>
Features
- Quick volume check
- One-click access to Master volume channel
- Full control of all available channels
Step-by-Step
- All access is through the icon in your System Tray
. Hover over the icon, and you see the current volume setting.

- Click on the icon, and you have access to the Master channel, where you can quickly raise or lower the volume, or mute it if the telephone rings.

- From that same display, click the Mixer button, and you have access to all configured channels, to adjust each one to your taste. The channels you see will depend upon the capabilities of your soundcard. This image is from a laptop with Intel ICH6 sound.

- Your card may have capabilities that you can't see in that view, so while you have it open, click . Now you can see all the possibilities, and choose which ones should be visible in your mixer window.

</translate>
- KDevelop4/Manual/Tool list
- KDevelop5/Manual/Tool list
- KBibTeX
- KWord/1.5/Manual/Credits
- KMess
- KAlgebra/Credit payment
- KGet
- KFind
- KOrganizer/ToDo
- KWord/1.5/Manual/ToolbarConfig
- KWord/1.5/Manual/Formula
- KWord/1.5/Manual/DocComments
- KGpg/Manual/Keyserver
- KWord/1.5/Manual/HeadFoot
- KWord/1.5/Manual/InitialTemplate
- KWord/1.5/Manual/UsingRulers
- KWordQuiz
- KMail/Protected Headers
- KWord/1.5/Manual/QandA
- KDevelop4/Manual/Appendix A: Building KDevelop from Sources
- KGpg/Manual/Encrypting
- KWord/1.5/Manual/UndoRedo
- KXStitch/Features
- KWord/1.5/Manual/WhoReads
- KPackage
- KDevelop5/Manual/Appendix A: Building KDevelop from Sources
- KRename
- KDE Wallet Manager
- KDevelop4/Manual/WindowsSetup
- KMail/Devs
- KAlarm
- KWord/1.5/Manual/DataInt
- KWord/1.5/Manual/TextFlow
- KWord/1.5/Manual/UsingFrames
- KDE System Administration/XDG Filesystem Hierarchy
- KWord/1.5/Manual/Differences
- KOrganizer/Screenshots
- KWord/1.5/Manual/Bookmarks
- KDevelop/Install4.5
- KColorEdit
- KMail/Account Wizard
- KDevelop4/Manual/Plugins: Code Generation
- KDevelop5/Manual/Plugins: Code Generation
- KDevelop/Install
- KWord/1.5/Manual/Templates
- KDevelop
- KPlato/Manual
- KWord/1.5/Manual/WindowOverview
- KBruch
- KWord/1.5/Manual/ToC
- KSysGuard
- KLettres
- KMail/Import Options
- KDevelop4/Manual/Getting started
- KDevelop5/Manual/Getting started
- KPlato/Manual/Resource Editor
- KPlato/Manual/Task Dependency Editor (Graphical)
- KWord/1.5/Manual/TemplateWork
- KWord/1.5/Manual/MultiView
- KWord/1.5/Manual/DocInfo
- KWord/1.5/Manual/Spellcheck
- KHangMan
- KWord
- KStars
- KPlato/Manual/Definitions
- KMyMoney
- KWord/1.5/Manual/NewDoc
- KWord/1.5/Manual/DocLinks
- KWord/1.5/Manual/KeyBind
- KSnapshot
- KPhotoAlbum Video Support
- KWord/1.5/Manual/EditDoc
- KWord/Tutorials/SecondLayout
- KAddressBook 4.3
- KWin Rules Window Matching
- KWord/1.5/Manual/ToolbarWork
- KMail/S MIME
- KPlato/Manual/Schedules Editor
- KWord/1.5/Manual/SaveDoc
- KUser
- KXStitch
- KPlato/Manual/Task Editor
- KDevelop5/Manual/Running programs
- KDevelop5/Manual/Tool list/Code browser
- KWord/1.5/Manual/Autocomplete
- KDevelop4/Manual/Running programs
- KWord/1.5/Manual/Clipboard
- KDevelop4/Manual/Working with version control systems
- KWord/1.5/Manual/PrintDoc
- KGpg/Manual/Options
- KWord/1.5/Manual/visual
- KPackageKit
- KWord/1.5/Manual/Book
- KWin Rules
- KMail
- KGpg
- KTimeTracker
- KGeography/Making Maps
- KWord/1.5/Manual/Lists
- KWord/1.5/Manual/KeyBindSum
- KWord/1.5/Manual/SelectColor
- KWord/1.5/Manual/DocStruct
- KDE System Administration
- KWord/1.5/Manual/Expressions
- KDevelop4/Manual/Getting started: A small CMake tutorial
- KDevelop5/Manual/Getting started: A small CMake tutorial
- KPhotoAlbum on Knoppix
- KWord/Manual/IntroGUI
- KWord/1.5/Manual/SelectFile
- KDevelop4/Manual
- KPhotoAlbum
- KWord/1.5/Manual
- KNode/KNode for mailing lists
- KDevelop4/FAQ
- KOrganizer
- KWord/Tutorials/ThirdLayout
- KMid
- KTurtle
- KDE System Administration/Caches
- KWord/1.5/Manual/motor
- KWord/1.5/Manual/Introduction
- KDevelop4/Manual/Working with templates
- KAlgebra/Probabilities
- KDevelop4/Manual/Building (compiling) projects with custom Makefiles
- KDevelop5/Manual/Building (compiling) projects with custom Makefiles
- KDevelop5/Manual
- KDevelop4/Manual/Debugging programs
- KAlgebra/Homework
- KDevelop5/Manual/Working with version control systems
- KDE System Administration/PlasmaDesktopScripting/Examples
- KDevelop4/Manual/Customizing KDevelop
- KDevelop5/Manual/Customizing KDevelop
- KWord/1.5/Manual/TabStops
- KWord/1.5/Manual/FootNotes
- KPhotoAlbum FAQ
- KGpg/Manual/Manage
- KDE System Administration/Configuration Files
- KMail/Backup Options
- KMail/PGP MIME
- KWord/1.5/Manual/Characters
- KDevelop5/Manual/Debugging programs
- KDE System Administration/Startup
- KWord/Tutorials/BasicLayout
- KDE System Administration/Environment Variables
- KDevelop4/TipsAndTricks
- KWord/1.5/Manual/Formatting
- KAlgebra/Console Tab
- KDevelop4/Manual/Code generation with templates
- KWin Rules Window Attributes
- KDE Connect/Tutorials/Useful commands
- KDevelop5/Manual/Sessions and projects
- KMyMoney/FAQ
- KDevelop4/Manual/Sessions and projects
- KWord/1.5/Manual/FormatParas
- KWord/1.5/Manual/UI
- KWin
- KWord/1.5/Manual/TextStyles
- KTurtle/Examples
- KMail/Tools
- KWord/1.5/Manual/Autocorrect
- KWord/1.5/Manual/WorkFrames
- KWord/1.5/Manual/Graphics
- KWord/1.5/Manual/Glossary
- KWin Rules Examples
- KBibTeX/Development
- KDE System Administration/KDE Filesystem Hierarchy
- KOffice/File Formats/KOffice 1.6 File Formats
- KDevelop5/Manual/Code generation with templates
- KWord/1.5/Manual/FrameProps
- KWord/1.5/Manual/MailMerge
- KWord/1.5/Manual/Find
- KWord/1.5/Manual/DocVar
- KDEConnect/zh-hans
- KWord/1.5/Manual/Menubar
- KDEConnect
- KDevelop5/Manual/Working with source code
- KDevelop4/Manual/Working with source code
- KMail/FAQs Hints and Tips
There are 275 pages beginning with Ka-Kz but not Kd
- Krita/Tutorials
- Kivio/Tutorials
- Khipu/newstuff/provider.xml
- Khipu/QuickStartGuide/HowToPlotFunctionsInKhipu ?
- Kategorie: Utilities
- Kexi/Handbook/Building Simple Databases/Designing Reports
- Kategorie: Sicherheit
- Kexi/File Format Support
- Krita/Manual
- Krita/Manual/GroupLayer
- Karbon/Tutorials
- Kexi/Tutorials/Reports
- Kword/1.6/PDF
- Kexi/Handbook/References/SQL Reference
- Kexi/Tutorials/Parameter queries
- Khipu temp
- Kexi/Handbook/Kexi and Other Database Applications
- Kopete/Skype Plugin
- Kword/1.6/ApplixWord
- Konversation/Distributions/Chakra
- Konversation/Distributions/Xandros
- Konversation/Distributions/ArkLinux
- Kword/1.6/DocBook
- Kword/1.6/LaTex
- Kmail/Distributions/Gentoo
- Krita/Manual/Tools/Zoom
- Kword/1.6/WML
- Khipu/Screenshots
- Konversation/Distributions/Fedora
- Kexi/Handbook/References/Supported File Formats
- Kword/1.6/PalmDoc
- Konversation/Distributions/Mageia
- Kscreen
- Kword/1.6/AmiPro
- Kamoso/3.2
- Kexi/Handbook/ Template
- Kword/1.6/WordPerfect
- Kexi/Cheat Sheet
- Kopete/AIM
- Konversation/Distributions/Gentoo
- Kopete/Auto Replace
- Kexi/Handbook/References/Menu Commands/Context Menu in the Object Tab
- Krita/Manual/Tools/Star
- Khipu/newstuff/stuff.xml
- Kmail/Distributions/OpenSUSE
- Kexi/Handbook/References/Menu Commands/The Help Menu
- Kopete/Yahoo
- Krita/Manual/Resources/ResourceManager
- Khipu/Manual/Introduction
- Konversation/Distributions/openSUSE
- Krita/Manual/Tools/Pan
- Kexi/Handbook/Configuring Kexi
- Kexi/Handbook/Appendix B. Comparing Kexi to other database applications
- Kile
- Konversation/Distributions/ArchLinux
- Kopete/Jabber/More info on Kopete
- Krita/Manual/Dockers/SnapSettings
- Kwlan
- Kopete/Firewall
- Konversation/Distributions/Slackware
- Khipu/Manual
- Khipu/Manual/References/Credits and License
- Kopete/Jabber/First steps
- Kio gopher
- Kio-audiocd
- KtikZ
- Kexi/Handbook/Kexi Basics/Opening an existing Kexi database file
- Konversation/Scripts/Media
- Khipu/Manual/Credits and License
- Kig/Screenshots
- Kamoso/3.0
- Kexi/Handbook/Kexi Basics/Kexi Databases
- Kopete/ICQ
- Kid3
- Kexi/Handbook/Introduction to Databases
- Kubuntu/Contribute/BugReporting
- KuickShow
- Kword/1.6/MSWrite
- Kleopatra
- Kexi/Handbook/Kexi Basics/Using built-in help
- Kexi/Handbook/Configuring Kexi/Docking and undocking side panels
- Konversation/Distributions/Exherbo
- KsCD
- Kiten
- Kmail/Getting Started
- Konversation/Distributions/Kubuntu
- Kexi/Handbook/Introduction to Databases/Database Design
- Kexi/Handbook/References/Menu Commands/The Tools Tab
- Kexi/Handbook/References/Toolbar Commands
- Kbarcode
- Krita/Manual/Layerstyles
- Kbluetooth
- Kexi/Handbook/References/Supported File Formats/Comma-separated Values Format
- Kexi/Handbook/Building Simple Databases/Designing Forms/Inserting text labels
- Kopete/OTR
- Kexi/Tutorials
- Kexi/Handbook/Where to go next
- Kompare
- Krusader/How To Add Folder Shortcuts on Krusader Toolbar
- Kopete/ICQ/About ICQ
- Kexi/Handbook/Kexi Basics/Creating a New Database File
- Kexi/Handbook/References/Menu Commands/The External Data Tab
- Kivio
- KolourPaint
- Kubuntu
- Kanagram
- Krusader
- Kexi/Handbook/Credits and License
- Kexi/Handbook/Introduction to Databases/Who Needs a Database?
- Kalzium/Other Chemistry-Applications
- Kexi/Handbook/Kexi Basics/Opening an existing Kexi database file/Opening an existing Kexi database file by clicking on .kexi file's icon
- Konversation/Distributions
- Kaption
- Kopete/Winpopup
- Kexi/Handbook/Kexi Basics
- Kexi/Handbook/References/Menu Commands/The Data Tab
- Khipu
- Kexi/Handbook/References/Menu Commands
- Kexi/Handbook/Building Simple Databases/Entering Data Using Forms
- Kontact Touch/MeeGo
- Kexi/Handbook/References/Menu Commands/The Create Tab
- Kexi/Handbook/Building Simple Databases/Designing Forms/Forms versus tables
- Kopete/ICQ/creating an account
- Kig/FAQ
- Klipper/Pastebins
- KmPlot/Using Sliders
- Kraft
- Kexi/Handbook/Building Simple Databases/Designing Database Tables
- Kexi/Handbook/Building Simple Databases/Designing Forms/Using the Widgets tab
- Kexi/Handbook/Kexi and Other Database Applications/Data Types
- KrossWordPuzzle/Settings
- Kexi/Handbook/References/Supported File Formats/Microsoft Access File Formats
- Kopete/Jabber
- Konversation/KDE3 Sources
- Kig
- Kalzium/Screenshots
- Kooka
- Kexi/Handbook/Building Simple Databases/Designing Forms
- Kontact Touch/About
- Klipper/How to search in phone books using Klipper
- Kontact Touch/Screenshots
- Kexi/Handbook/Introduction to Databases/What Is a Database?
- Kopete/Jabber/Create your Jabber account
- Kexi/Handbook/References/Menu Commands/The Report Design Tab
- KmPlot
- Kig/Macros
- Kexi/Handbook/References/Menu Commands/The KEXI Menu
- Kmail/Configuring Kmail/Accounts/Office 365
- Krita/Manual/BrushEngines/InstantPreview
- Kaffeine
- Konqueror/Web Shortcuts
- Konversation/Distributions/PCLinuxOS
- Konversation/Browsers
- Kwave
- Kontact/SMS
- Kopete/ICQ/add friends
- Kate
- Kaffeine-TV
- Konversation/Scripts/Ghosttrick
- Kopete/Jabber/About Jabber XMPP
- Kexi/Handbook/References/Menu Commands/Context Menus in the Project Navigator
- Kopete/Jabber/Messaging and sending files
- Kexi/Handbook/Building Simple Databases/Designing Forms/Working with form design
- Kexi/Handbook/Kexi Basics/Opening an existing Kexi database file/Opening a database file in the Open Existing Project dialog
- Kexi/Handbook/Building Simple Databases/Designing Forms/Most important terms
- Kalzium
- Karbon
- Kontact
- Klipper
- Kexi/Handbook/References/Menu Commands/The Form Design Tab
- Khipu/Manual/DotKhipuFiles
- KonsoleKalendar
- Kword/1.6/StarWriter
- Kopete/Jabber/Adding friends
- Kubuntu/Software/Games/Steam
- Kexi/Handbook/References/Keyboard Shortcuts
- Kopete
- Kexi/Handbook/Introduction to Databases/Database Creation Software
- Kexi/Handbook/Introduction
- Kopete/Supported Protocols Overview
- Kexi/Handbook/Building Simple Databases/Designing Forms/Inserting widgets - text fields
- Kexi/Handbook/Building Simple Databases/Designing Forms/Actions
- Khipu/QuickStartGuide
- Kubuntu/Support
- Karbon/Tutorials/Artistic Text Shape
- Khipu/KhipuBeyondJustPlotting
- Kexi/Handbook/Building Simple Databases/Designing Database Queries
- Kexi
- Khipu/PlayingWithPlotDictionary
- Kexi/Handbook/Building Simple Databases/Designing Forms/Assigning data sources
- KrossWordPuzzle/Crossword Types
- Konversation/KDE4 Sources
- Kamoso
- Kword/1.6/Writer
- Kword/1.6/RTF
- Kopete/Jabber Transport
- Kexi/Handbook/Building Simple Databases/Designing Forms/Setting the tab order
- Kopete Jabber Jingle
- Kexi/Handbook/Building Simple Databases/Entering Data Into Tables
- Kalgebra/Probabilities
- Kontact Touch/WinCE
- Kubuntu/Welcome
- Kword/1.6/AbiWord
- Krdc
- Konversation/Sources
- Kopete/Jabber Muc
- Kopete/MSN
- Kexi/Handbook/Building Simple Databases
- Krita/Manual/Animation
- KrossWordPuzzle
- Konsole
- Kword/1.6/HTML
- Kexi/Handbook/Building Simple Databases/Designing Forms/Setting widgets size and position by hand
- Kubuntu/Contribute
- Kopete/ICQ/connect through kopete
- Kopete/Jabber/Fill in your account data in Kopete
- Kopete/Webcam Support
- Kexi/Tutorials/Reports/Kexi Reports for Beginners
- Kubuntu/Basic
- Konversation/Tips and Tricks
- Konversation/Konvi2x
- Kmail/Using Folders
- Kontact Touch/Harmattan
- Kword/1.6/Plain text
- Kontact/Kontact Palm Pre Sync
- Kubuntu/Advanced/Repositories
- Koko
- Kexi/Handbook/Building Simple Databases/Designing Database Tables/The Table Designer window
- Krfb
- Kronometer
- Konversation/FAQ
- Krita/Manual/FAQ
- Krita/Manual/ColorManagement/ProfilingandCalibration
- Kexi/Tutorials/Importing SQLite database into Kexi
- Kontact Touch
- Kubuntu/Advanced
- Khipu/newstuff/data/test.khipu
- KonsoleDevelopment
- Kmail/Using Kmail General
- Kronometer/Changelog
- Kronometer/Downloads
- Konversation/Scripts/Import mIRC server list
- Kontact Windows Mobile
- KolorManager
- Konversation
- Kexi/Handbook/Kexi Basics/The Kexi Main Window
- Kexi/Handbook/Building Simple Databases/Designing Forms/Widget layouts
- Krita/new/BugWritingGuidelines
- Kontact Touch/Maemo5
- Kopete/Jabber/Useful configuration hints
- Kexi/Handbook/References/Command-Line Options
- Konqueror
- Kubuntu/Software
- Konversation/Configuring SASL authentication
- Krecipes
- Krita/Tutorial 3A
- Kubuntu/Installation
- Kexi/Handbook
- Kmail/Folder Properties
- Kmail/Configuring Kmail
- Kexi/Handbook/Introduction to Databases/Database and Spreadsheet
- Kmail/Configuring Kmail/Identities
- Kexi/Handbook/References/SQL Reference/SQL Reserved Words
- Krita/Tutorial 6
- Konversation/Scripts/Scripting guide
<translate>
Introduction
Konversation has built-in support for running external scripts which, partnered with D-Bus and Konversation's own D-Bus methods, cover the most common scripting use cases, such as displaying information in the current chat window or controlling another application or even Konversation itself. This guide introduces the basics of writing a Konversation script. It covers only the essential concepts necessary to get started. Language- and system-specific nuances will be left to the user as a learning exercise.
Requirements
All you need is a text editor and a programming/scripting language. Konversation supports any programming language that:
- Can accept and process command-line arguments (argv's).
- Can connect to and call D-Bus, or at least make external system calls (such as executing the program "
qdbus
"). It is probably better and more secure to use the language's native D-Bus bindings if available, rather than executing a system call to runqdbus
.
At the moment, Python, BASH (or Shell), and Perl are known to work and have examples shipped with Konversation. But any language fulfilling the two requirements above would probably also work. This guide will give examples in Python.
Case 1: Display Information into the Current Chat Window
Probably the most common scripting scenario is getting some text to display in the current Konversation tab (channel or private message), with the data usually coming from an external source. This source could be the script itself, another application (such as the media
script included with Konversation), or the Internet (like getting weather information and displaying it in Konversation). Whatever the source, there are 3 steps to perform:
- Getting the input - catching and parsing the command sent by the user from Konversation.
- Processing the data - gathering data from sources and manipulating it based on the input.
- Sending the output - throwing the information back to Konversation through D-Bus.
The following is a nonsensical example of a Konversation script that roughly follows that pattern.
#!/usr/bin/env python # mood - a Konversation script to display a witty remark based on the user's mood. # Usage: /exec mood [mood_string] <!--T:12--> import sys import subprocess <!--T:13--> command = ['qdbus', 'org.kde.konversation', '/irc'] <!--T:14--> argc = len(sys.argv) <!--T:15--> if argc < 2: command.append("error") text = "Server required" elif argc < 3: command.append("error") text = "Target required" elif argc < 4: command.append("error") text = "No mood given" else: server = sys.argv[1] target = sys.argv[2] mood = sys.argv[3] <!--T:16--> if mood == "hungry": text = "Hungry! Anyone got a horse?" elif mood == "sleepy": text = "I yawn, therefore I am." elif mood == "gloomy": text = "Roses are red. Violets are blue, and so am I ..." elif mood == "happy": text = "Thinking happy thoughts (with a dash of pixie dust)." elif mood == "hyper": text = "Just a spoonful of sugar? I think I took a whole jar! *cartwheels*" elif mood == "excited": text = "Are we there yet? Are we there yet? Are we there yet?" else: text = "What were we talking about again?" <!--T:17--> command.append("say") command.append(server) command.append(target) <!--T:18--> command.append(text) <!--T:19--> subprocess.Popen(command).communicate()
Getting the Input
When Konversation calls an external script, it runs it with some predefined arguments, like this:
script_name server target [additional arguments ...]
Arguments are usually stored in a collection (a list or an array, depending on the language) called "argv" indexed from 0 to N, with N being the number of arguments.
- argv[0] is always the script name itself. In most cases, it's safe to ignore this.
- argv[1] is the address of the server the user is currently connected to. In case of multiple connected servers, this will always be the server to which the channel or query window is connected to.
- argv[2] is the target, the name of the chat window where the command to run the script came from which, more often than not, would be the same window where output would be displayed. Of course, you can always change this.
- argv[3] to argv[N] will be any additional arguments that would be sent by the user calling the script through Konversation. This can be anything from flags to enable/disable options in the script or data or text that can be displayed in the output of the script. Not all scripts have additional arguments, like the
uptime
andsysinfo
scripts.
Processing the Data
In the example script, the mood variable, supplied by the user in argv[3] of the script, is compared to predefined values and the appropriate remark is assigned to the text variable. This is a simple example of data processing. You can also fetch data from a predefined data source, like the fortune
script. Or assemble information coming from the operating system, such as done in the sysinfo
script. Whatever information or text you need to be displayed in Konversation, you create that here.
Now that the needed information is processed and assembled, it's time to prepare it for sending back into Konversation, which is discussed in the next section.
Sending the Output
Controlling Konversation externally, like through a script or the command-line, involves using its D-Bus methods. Konversation has several of them, including a group whose purpose is to display messages. Sending D-Bus messages can be tedious. Fortunately, Qt provides a much easier way of doing that, using the helper program "qdbus
". Without going into much detail, all the D-Bus commands we will be sending to make Konversation display messages starts with this string:
qdbus org.kde.konversation /irc
Depending on what kind of message the script will be sending, additional options will be added to that command. Here are but a few examples:
qdbus org.kde.konversation /irc say server target message
This is probably the command that will be most commonly used. It sends message to the chat window target connected to server. If you want the message to be sent to the same chat window where the script was called from, use argv[1] and argv[2] for server and target, respectively. Of course you can always change the target to any channel or nick you want in that server.
qdbus org.kde.konversation /irc error message
This displays the message in the same chat window where the script was invoked. The difference is that the message isn't actually sent to the IRC server and is only visible to the user. The message is also formatted as something like "[D-Bus] Error: message". Useful for informing the user about errors in using the script or if something fails in the script. It doesn't need a server or a target.
qdbus org.kde.konversation /irc sayToAll message
Sends the message to all channels and query windows in all servers. Please use sparingly and observe proper netiquette. It doesn't require a server and a target.
qdbus org.kde.konversation /irc actionToAll message
sayToAll's action sibling. Sends the message to all channels and query windows in all servers BUT prepends "/me" to the actual message, resulting in displaying something like "*YourNick message*". Again, netiquette applies.
There are other /irc related qdbus commands, some of which change the user's status instead of displaying the command. Feel free to explore other possibilities. Another Qt helper program, "qdbusviewer
", provides a graphical interface for browsing through the available commands for Konversation and other "D-Bus aware" programs. You will probably need it a lot especially for the second scripting scenario discussed later.
Getting the Script to Run
Now it's time to actually make the script run in Konversation. Here are the steps:
- Make your script executable.
chmod +x script_name
does it all. It would be better to not include extensions (.sh, .py, .pl, etc.) in your filename, to make it easier to call the script.
- Place the script in either one of two folders:
- If you want your script to be available all users in your system, put the script together with the other scripts installed with Konversation. This may vary from distro to distro (or your own personal tinkering), but common a location is /usr/share/apps/konversation/scripts/. In case it's not there, get the output of the command
kde4-config --install data
and append/konversation/scripts/
to it. Consult your distribution's support channel if it's still not there. - If you want the script just for yourself, simply place the script in ~/.kde/share/apps/konversation/scripts/. Some distros might still be using ~/.kde4/ instead so adjust accordingly.
- Post version 1.3.1 note: another way to find out where the installed scripts are is to run this command in Konversation's input line (using the
media
script as an example, since it comes with any Konversation installation):/exec --showpath media
. Note that if there are two scripts with the same name in the user's home and in the system locations, the one in the user's home will take precedence and be the one shown here.
- If you want your script to be available all users in your system, put the script together with the other scripts installed with Konversation. This may vary from distro to distro (or your own personal tinkering), but common a location is /usr/share/apps/konversation/scripts/. In case it's not there, get the output of the command
- To actually run the script, you need to invoke it by running this command in Konversation's input line:
/exec script_name [additional arguments]
This will call your script and pass the arguments to it. Remember that your script_name is always argv[0], and that the current server and chat window are passed as argv[1] and argv[2], even if you didn't include them in your command. Therefore, any additional arguments would be argv[3] and so on.
- For convenience, you can create a command alias in Konversation so that you can invoke your script simply using /script_name instead of the actual syntax given above. To manually do this, go to
/script_name [arguments]
page. Click on the button and enter "script_name" in the field. So next time you need to run your script, you can simply do use
- Alternately, whenever Konversation is started, it automatically creates a command alias of "/script_name" for "/exec script_name" for every script it finds in the scripts/ directories mentioned earlier.
For the previous example, the script is named "mood" and can be invoked either using /mood [mood]
or /exec mood [mood]
, like:
/mood gloomy
That's basically all you need to know to make a Konversation script. To make it a bit more interesting, let's have an example of another common scripting scenario.
Case 2: Controlling an External Program from Konversation
Thanks to D-Bus, and the fact that a lot of KDE applications have D-Bus methods, you can control any KDE application right from within Konversation. Even without D-Bus, you can let your script start, stop, or possibly even control other applications simply with a command in Konversation. This lets you do a lot of things, like sending a command to a terminal emulator, opening a bug report in a browser providing only the report number (like the bug
script), or simply running a system command (and probably displaying the results of that command, as the cmd
script does).
The following script performs the first example. It first makes Yakuake visible and then runs the command supplied by the user. The script is rather simple and doesn't involve displaying anything back to the user, except in the case of an error when calling the script itself.
#!/usr/bin/env python # yakrun - Konversation script that runs the command supplied by the user in Yakuake and toggles Yakuake's state # Usage: /exec yakrun [command] <!--T:49--> import sys import subprocess <!--T:50--> errorCommand = ['qdbus', 'org.kde.konversation', '/irc', 'error'] toggleCommand = ['qdbus', 'org.kde.yakuake', '/yakuake/window', 'toggleWindowState'] runCommand = ['qdbus', 'org.kde.yakuake', '/yakuake/sessions', 'runCommand'] <!--T:51--> argc = len(sys.argv) <!--T:52--> if argc < 4: text = "No command to run." <!--T:53--> errorCommand.append(text) <!--T:54--> subprocess.Popen(errorCommand).communicate() else: command = " ".join(sys.argv[3:]) <!--T:55--> runCommand.append(command) <!--T:56--> subprocess.Popen(toggleCommand).communicate() subprocess.Popen(runCommand).communicate()
Language-specific Notes
- Be careful when processing arguments and assembling them into a single string with spaces, which might be more error-prone in some languages, such as BASH.
</translate>
- Konversation/Releases
- KrossWordPuzzle/Using KrossWordPuzzle
- Krita/Tutorial 5
- Kexi/Tutorials/Drilling Down on Facebook Data
- Krita/Tutorial 7
- Krita/Tutorial 1
- Krita/Tutorial 4B
- Krita/Tutorial 4A
- Krita/Tutorial 2
- Krita/Tutorial 8
There are 206 pages beginning with Kd
- Kdenlive/Manual/Credits and License
- Kdenlive/Manual/Useful Information/Useful Resources
- Kdenlive/Manual/Useful Information/Tips Tricks
- Kdenlive/Manual/Useful Information/Surround Sound
- Kdenlive/Manual/Useful Information/Shortcuts
- Kdenlive/Manual/Useful Information/FAQ
- Kdenlive/Manual/Useful Information
- Kdenlive/Manual/KdenliveOnOtherPlatforms/OSX
- Kdenlive/Manual/KdenliveOnOtherPlatforms/Non-KDE Desktops
- Kdenlive/Manual/KdenliveOnOtherPlatforms
- Kdenlive/Manual/Troubleshooting and Common Problems
- Kdenlive/Manual/ShootingHints
- Kdenlive/Manual/Toolbars
- Kdenlive/Manual/CapturingAudio
- Kdenlive/Manual/Capturing
- Kdenlive/Manual/Project Menu/Render/Render Profile Parameters
- Kdenlive/Manual/Rendering
- Kdenlive/Manual/Project Menu/Render
- Kdenlive/Manual/Settings Menu
- Kdenlive/Manual/View Menu
- Kdenlive/Manual/Monitor Menu
- Kdenlive/Manual/Timeline Menu
- Kdenlive/Manual/Clip Menu
- Kdenlive/Manual/Tool Menu
- Kdenlive/Manual/Project Menu
- Kdenlive/Manual/Edit Menu/Undo
- Kdenlive/Manual/Edit Menu/Redo
- Kdenlive/Manual/Edit Menu/Copy
- Kdenlive/Manual/Edit Menu/Paste
- Kdenlive/Manual/Edit Menu/Paste Effects
- Kdenlive/Manual/Edit Menu
- Kdenlive/Manual/File Menu/New
- Kdenlive/Manual/File Menu/Open
- Kdenlive/Manual/File Menu/Open Recent
- Kdenlive/Manual/File Menu/Save
- Kdenlive/Manual/File Menu/Save As
- Kdenlive/Manual/File Menu/Revert
- Kdenlive/Manual/File Menu/Transcode Clips
- Kdenlive/Manual/File Menu/DVD Wizard
- Kdenlive/Manual/File Menu/Quit
- Kdenlive/Manual/File Menu
- Kdenlive/Manual/Menu
- Kdenlive/Manual/Titles
- Kdenlive/Manual/Monitors
- Kdenlive/Manual/Effects/Motion
- Kdenlive/Manual/Effects/Misc
- Kdenlive/Manual/Effects/Fun
- Kdenlive/Manual/Effects/Fade
- Kdenlive/Manual/Effects/Enhancement
- Kdenlive/Manual/Effects/Distort
- Kdenlive/Manual/Effects/Custom
- Kdenlive/Manual/Effects/Crop and transform
- Kdenlive/Manual/Effects/Colour Correction
- Kdenlive/Manual/Effects/Colour
- Kdenlive/Manual/Effects/Blur and hide/Auto Mask
- Kdenlive/Manual/Effects/Blur and hide
- Kdenlive/Manual/Effects/Audio Correction
- Kdenlive/Manual/Effects/Audio channels
- Kdenlive/Manual/Effects/Artistic
- Kdenlive/Manual/Effects/Analysis and Data
- Kdenlive/Manual/Effects/Alpha manipulation/Blue Screen
- Kdenlive/Manual/Effects/Alpha manipulation/Color Selection
- Kdenlive/Manual/Effects/Alpha manipulation/Alpha operations
- Kdenlive/Manual/Effects/Alpha manipulation/Alpha shapes
- Kdenlive/Manual/Effects/Alpha manipulation/Rotoscoping
- Kdenlive/Manual/Effects/Alpha manipulation
- Kdenlive/Manual/Transitions
- Kdenlive/Manual/Timeline/Right Click Menu
- Kdenlive/Manual/Timeline/Guides
- Kdenlive/Manual/Timeline/Grouping
- Kdenlive/Manual/Timeline
- Kdenlive/Manual/Projects and Files/Management
- Kdenlive/Manual/Projects and Files/Importing
- Kdenlive/Manual/Projects and Files/Clips
- Kdenlive/Manual/Projects and Files/Notes
- Kdenlive/Manual/Projects and Files/Backup
- Kdenlive/Manual/Projects and Files/Archiving
- Kdenlive/Manual/Projects and Files/Project Settings
- Kdenlive/Manual/Projects and Files/Project
- Kdenlive/Manual/Projects and Files/Project Tree
- Kdenlive/Manual/Projects and Files
- Kdenlive/Manual/Windows Issues
- Kdenlive/Manual/Tutorials
- Kdenlive/Manual/Introduction
- Kdenlive/Manual/Transitions/Hue shift
- Kdenlive/Manual/WIndows Issues
- Kdenlive/Manual/Effects/Misc/Glow (GLSL)
- Kdenlive/Manual/UsingKdenlive/QuickStart/CreatingProject
- Kdialog
- Kde-pim
- Kdenlive/Manual/BugReporting
- Kdenlive/Roadmap
- Kdenlive/Manual/Effects/Misc/threelay0r
- Kdenlive/Templates/ContentTodo
- Kdenlive/Manual/Effects/Audio channels/Mono to stereo
- Kdenlive/Manual/Effects/Misc/colorize
- Kdenlive/Manual/Transitions/addition alpha
- Kdenlive/Manual/Useful Information/Tips Tricks/Ffmpeg and BT 601 Color
- Kdenlive/Manual/Transitions/alpha over
- Kdenlive/Manual/Transitions/addition
- Kdenlive/Manual/View Menu/Show Timeline
- Kdenlive/Manual/Effects/Alpha manipulation/Masking
- Kdenlive/Manual/View Menu/Audio Signal
- Kdenlive/Manual/View Menu/Effect Stack
- Kdenlive/Manual/View Menu/Transition
- Kdenlive/Manual/View Menu/Project Monitor
- Kdenlive/Manual/View Menu/Project Tree
- Kdenlive/Manual/Effects/View Menu/Vectorscope
- Kdenlive/Manual/Transitions/alphain
- Kdenlive/Manual/Settings Menu/Full Screen Mode
- Kdenlive/Manual/Transitions/alphaout
- Kdenlive/Manual/Settings Menu/Toolbars Shown
- Kdenlive/Manual/Transitions/alphaatop
- Kdenlive/Manual/Effects/Misc/twolay0r
- Kdenlive/Manual/Project Menu/Open Backup File
- Kdenlive/Manual/Transitions/alphaover
- Kdenlive/Manual/File Menu/Close
- Kdenlive/Manual/Effects/Misc/nosync0r
- Kdenlive/Manual/Project Menu/Generators
- Kdenlive/Manual/Settings Menu/Configure Notifications
- Kdenlive/Manual/Effects/Misc/Threshold0r
- Kdenlive/Manual/Effects/Colour/B
- Kdenlive/Manual/Settings Menu/Themes
- Kdenlive/Manual/View Menu/Clip Monitor
- Kdenlive/Manual/Project Menu/Analyse Keyframes
- Kdenlive/Manual/Projects and Files/Media Browser
- Kdenlive/Manual/Transitions/Hue
- Kdenlive/Manual/Project Menu/Stop Motion Capture
- Kdenlive/Manual/Settings Menu/Run Config Wizard
- Kdenlive/Manual/Settings Menu/Download New Project Profiles
- Kdenlive/Manual/Project Menu/Adjust Profile to Current Clip
- Kdenlive/Manual/Clip Menu/Reload Clip
- Kdenlive/Manual/Transitions/alphaxor
- Kdenlive/Manual/View Menu/Show Title Bars
- Kdenlive/Manual/Settings Menu/Download New Wipes
- Kdesvn
- Kdenlive/Manual/View Menu/Screen Grab
- Kdenlive/Manual/Clip Menu/Duplicate Clip
- Kdenlive/Manual/View Menu/Effect List
- Kdenlive/Manual/Settings Menu/Manage Project Profiles
- Kdenlive/Manual/Clip Menu/Rename Clip
- Kdenlive/Manual/Transitions/screen
- Kdenlive/Manual/View Menu/Vectorscope
- Kdenlive/Manual/Effects/Audio/Mono to stereo
- Kdenlive/Manual/Clip Menu/Locate Clip
- Kdenlive/Manual/Project Menu/Clean Project
- Kdenlive/Manual/Clip Menu/AutomaticSceneSplit
- Kdenlive/Manual/Clip Menu/Delete Clip
- Kdenlive/Manual/Clip Menu/Replace Clip
- Kdenlive/Manual/Effects/Motion/Speed
- Kdenlive/Manual/Clip Menu/Extract Audio
- Kdenlive/Manual/Edit Menu/Find Next
- Kdenlive/Manual/View Menu/Histogram
- Kdenlive/Ideas
- Kdenlive/Manual/View Menu/Waveform
- Kdenlive/Manual/View Menu/Spectogram
- Kdenlive/Manual/View Menu/Audio Spectrum
- Kdenlive/Manual/View Menu/Load Layout
- Kdenlive/Manual/Effects/Misc/pr0be
- Kdenlive/Manual/Effects/Misc/pr0file
- Kdenlive/Manual/Project Menu/Reverse Clip
- Kdenlive/Manual/Settings Menu/Configure Shortcuts
- Kdenlive/Manual/Titles/Download New Title Templates
- Kdenlive/Manual/Project Menu/Create Folder
- Kdenlive/Manual/Clip Menu/Clip in Timeline
- Kdenlive/Organization
- Kdenlive/Manual/Clip Menu/Duplicate Clip with speed change
- Kdenlive/Manual/Clip Menu/Transcode
- Kdenlive/Manual/View Menu/Save Layout As
- Kdenlive/Manual/Installation/zh-hans
- Kdenlive/Manual/Clip Menu/Edit Clip
- Kdenlive/Manual/Timeline Menu/Insert Clip Zone
- Kdenlive/Manual/View Menu/RGB Parade
- Kdenlive/Manual/alpha operation transitions/zh-hans
- Kdenlive/Manual/Edit Menu/Find
- Kdenlive/Manual/Settings Menu/Download New Render Profiles
- Kdenlive/Manual/Installation
- Kdenlive/Manual/Clip Menu/Markers
- Kdenlive/Manual/Transitions/Wipe
- Kdenlive/Manual/Monitors/Project Monitor RightClick
- Kdenlive/Manual/alpha operation transitions
- Kdenlive/Manual/Transitions/Affine
- Kdenlive/Manual/Timeline Menu/Tracks
- Kdenlive/Manual/View Menu/Undo History
- Kdenlive/Manual/Full Luma
- Kdenlive/Manual/Timeline Menu/Selection
- Kdevelop4/Manual/Meet KDevelop
- Kdevelop5/Manual/Meet KDevelop
- Kdenlive/Manual/Project Menu/Online Resources
- Kdenlive
- Kdenlive/Manual/Timeline Menu/Current Clip
- Kdenlive/Manual/Transitions/Composite
- Kdenlive/Manual/Timeline Menu/Space
- Kdenlive/Manual/Effects/Alpha manipulation/Key Spill Mop Up
- Kdenlive/Manual/zh-hans
- Kdenlive/Manual/Clip Menu/Stabilize
- Kdenlive/Manual/Monitors/Clip Monitor RightClick
- Kdenlive/Manual
- Kdenlive/Manual/Effects/Audio
- Kdenlive/Manual/Settings Menu/Configure Kdenlive
- Kde wayland for artists
- Kdenlive/Manual/QuickStart/zh-hans
- Kdenlive/Manual/QuickStart
- Kdenlive/Manual/Effects
- Kdenlive/Manual/Timeline/Editing
- Kdenlive/Manual/Effects And Transitions
There are 460 pages beginning with L-Z
- Plan/Manual/1/Definitions
- Tips/Take screenshots faster with Spectacle by using shortcuts
- Showcase/Tutorials
- New Imports
- Parley/Manual/Practice
- Parley/Manual/Vocabulary Editing
- Parley/Manual/Practice Setup
- Parley/Manual/Summary After Practice
- Ub-helpfiles-languages
- Plan/Howto/Create New Project
- Macaw-Movies
- Plasma/4.0 (zh CN)
- Projects/Usability/HIG/Layout
- LabPlot/2DPlotting/Histogram
- Toolbox/Subpage Demo
- Plan/Manual/Menus and Tool bars
- LabPlot/Cursor tool
- LabPlot/CursorTool
- LabPlot/Statistics
- LabPlot/DataAnalysis/Smoothing
- Plan/Manual/Cost Breakdown View
- Plan/Manual/Work Package View
- Plan/Manual/Configure Plan Dialog
- Plan/Howto/Create Shared Resources
- Plan/Manual/Task Progress Dialog
- Plan/Manual/Define Currency Dialog
- Translation Workflow/Galician
- Plan/Manual/Project Settings Dialog
- Plan/Manual/Task Settings Dialog
- Plan/Manual/Summary Task Settings Dialog
- Plan/Manual/Edit Work Intervals Dialog
- Plan/Manual/Define Estimate Conversions Dialog
- Plan/Manual/Resource Settings Dialog
- Plan/Manual/Insert File Dialog
- Translation Workflow/Spanish
- Plan/Manual/Define WBS Pattern Dialog
- LabPlot/2DPlotting/XY Curve from a Formula
- Userbase Technical Issues
- Plan/1/Manual
- LabPlot/DataAnalysis/Fitting
- LabPlot/Interface/PropertiesExplorer
- Tellico/Compiling
- Translation Workflow/French
- Parley/FileFormats
- Temlate:Plan/Docversion1
- Troubleshooting/Peripherals Problems
- LabPlot/2DPlotting
- Plan/Howto
- System Settings/Global Policy Configurations
- PlanWork/Manual
- System Settings/Permissions
- System Settings/Actions Policy
- Rekonq/Manual
- Simon/Developing Command Plugins
- Semantik
- Simon/Back ends
- Plan/Manual/Task Dependency Editor (List)
- System Settings/Information Sources
- System Settings/Digital Camera
- System Settings/Workspace
- Tools
- LabPlot/2DPlotting/XYCurve
- LabPlot/DataContainers
- Plasmate
- Plan/Manual/Context Help
- System Settings/Launch Feedback
- System Settings/Windows Decorations
- System Settings/Color
- System Settings/Spell Check
- Simon/TTS Voices
- System Settings/Icons
- System Settings/Touch Screen
- LabPlot/Tutorials
- System Settings/Removable Devices
- System Settings/Plasma Search
- System Settings/Fonts (Category)
- System Settings/Notifications
- Plan/Tutorials
- System Settings/Software Management
- Raptor
- System Settings/Removable Storage
- System Settings/Personal Information
- Task Oriented Plan
- LabPlot/ImportExport/ImportFromFiles
- System Settings/KDE Wallet
- System Settings/Account Details
- LabPlot/GettingStarted
- Okteta/Tutorials
- Software from Source
- Plan/Manual/Startup View
- Plan/Manual/Project Performance View
- LabPlot/DataContainers/Matrix
- System Settings/Plasma Theme
- System Settings/Online Accounts
- System Settings/Search
- System Settings/Activities
- Stats
- System Settings/Device Actions
- System Settings/Mouse
- Rekonq/Manual/Introduction
- System Settings/Touchpad
- Showfoto
- System Settings/Web Shortcuts
- System Settings/Emoticon Theme
- System Settings/File Search
- Plasma/HowTo/Index
- System Settings/Formats
- System Settings/Display and Monitor
- System Settings/Workspace Theme
- LemonPOS
- Simon/Handbook
- LabPlot/CurveTracing
- System Settings/Splash Screen
- Simon/Scenarios
- System Settings/Language
- System Settings/Font
- System Settings/GNOME Application Style (GTK)
- System Settings/Screen Locking
- PvfViewer
- Parley/Manual/Existing collection
- System Settings/Virtual Desktops
- System Settings/Window Rules
- Plan/Manual/Task Performance View
- PlanWork
- System Settings/Locations
- PulseAudio
- Sweeper
- System Settings/Mouse Cursor Theme
- Plan/Manual/Managing Resources
- Yakuake
- System Settings/Regional Settings
- System Settings/Icon Theme
- Plasma Mobile
- Plan/Engineering To Order project tutorial
- Plasma/FAQ/Index
- System Settings/Screen Edges
- Projects/Usability/HIG/Layout/Wizard
- QtiPlot
- System Settings/Application Style
- System Settings/Font Management
- Translation Workflow/Ukrainian
- System Settings/Application and System Notifications
- Translator Account/2017
- System Settings/Desktop Session
- Peruse
- Projects/Usability/HIG/Layout/ViewingVsEditing
- System Settings/Shortcuts
- Plan/Manual/Report Generator
- System Settings/User Manager
- System Settings/Look And Feel
- System Settings/Connections
- Plan/Howto/Organize Your Projects
- Plan/Manual/Task Gantt View
- Tips
- Plan/Manual/Import and Export
- System Settings/Desktop Effects
- Translation Workflow/Russian
- Plan/Manual/Milestone Gantt View
- Projects/Usability/HIG/Layout/Image
- Rocs
- Single database server
- Translator Account/2016
- Plan/Manual/Resource Assignment Gantt View
- Plan/Manual/Resource Assignment View
- System Settings/Applications
- LabPlot/GettingStarted/Installation
- Minuet
- System Settings/Multimedia
- Translator Account/2018
- System Settings/Windows Management
- SymbolEditor File Format
- System Settings/Widget Style
- System Settings/Locale
- Rekonq/Manual/UI
- LatteDock/How to report multi screen issues
- Tutorials/Compose Key Old Version
- Simon
- Translation Workflow/German
- Simon/What do I need?
- PlanWork/Manual/Introduction
- Tutorials/Access another computer's display
- RSIbreak
- Lancelot
- Plasma/PictureFrame
- Tutorials/Change the color of the blue folder icon
- System Settings/Power Management
- LabPlot/CASComputing
- Tutorials/hotkeys
- Skanlite
- Parley/Manual/Vocabulary Practice
- System Settings/Login Screen
- System Settings/Application Appearance
- Plan/Manual/Creating a Project
- Plan/Manual/View Selector
- Plan/Manual/Task Execution View
- LatteDock
- LabPlot/FITSMetadataEditor
- Summary
- Simon/Shadow dictionary
- Translator Account/2019
- System Settings/Desktop Behavior
- Plan/Manual/Cost Breakdown Structure Editor
- LabPlot/DataContainers/Workbook
- Translation Workflow/Romanian
- Translator Account/2014
- Plasma-browser-integration
- Plan/Manual/Introduction
- Spectacle/Tutorials/Invoking Spectacle with custom shortcuts
- System Settings/Workspace Appearance
- Plan/Manual/Reports Generator View
- Plan/Manual/Using the Views
- Showcase
- RSIBreak
- ReadyForTranslation
- System Settings/Autostart
- Tips/Enabling the blue light filter on KDE Plasma
- System Settings/Date & Time
- Translator Account/2015
- LabPlot/ImportExport/Export
- Plasma/Pager
- Simon/Contribute Data
- System Settings/Task Switcher
- Translation Help Needed
- Parley/Manual/Start Page
- Plasma/Installing Plasmoids
- Plan/Manual/Task Status View
- System Settings/Default Applications
- Plan/Manual/Work and Vacation Editor
- Smb4K
- System Settings/Search Desktop
- LabPlot/DataContainers/Spreadsheet
- System Settings/Workspace Behaviour
- Plasma/NetworkMonitor
- Plasma/DeviceNotifier
- Parley
- System Settings/Keyboard
- Temlate:Plan/Prevnext
- Plan/Manual/Main Work Space
- Sandbox
- Translator Account/2013
- Sheets
- Tutorials/Mouse pointer settings for large displays
- SymbolEditor
- LabPlot
- Tips/Pairing your phone and PC with KDE Connect
- LabPlot/Tutorials/Plotting/PlotTextData
- Stage
- Pairs/Editor
- LabPlot/Interface/MainArea
- Off-line Translation
- Raw to DNG
- System Settings/Window Behavior
- Tips/Enable fun desktop effects on KDE Plasma
- LatteDock/HowToReportCrashes
- LabPlot/Interface
- Tutorials/Modify KDE Software Defaults
- Words
- LabPlot/DataAnalysis/FourierTransfromation
- Tutorials/Keyboard
- Update an Image
- System Settings/Appearance
- Wacomtablet
- Websites
- Propose Deletion
- Zanshin
- Working with MyKolab
- Tutorials/Open a console
- Parley/Manual/Introduction
- Plan
- PageLayout
- Quanta
- Session Environment Variables
- Tips/How to customize Night Color on KDE Plasma
- Parley/Manual/Advanced Practice Configuration
- Quassel
- Tellico/Templates
- Tutorials/Change Plasma Language
- Tips/Downloading KDE Connect
- Sound Problems/External Sound Cards
- Nepomuk/kioslaves/tags
- LabPlot/ImportExport/ImportFromSQLDatabases
- LabPlot/UserGuide
- Translation Workflow/Italian
- Tutorials/Flatpak
- Marble
- Skrooge
- Plasma/SystemTray
- Nepomuk/kioslaves/search
- Translator Account/2012
- Welcome to KDE UserBase
- Parley/Manual/Imparare vocaboli utilizzando multiple choice
- Umbrello
- SMPlayer
- Modifying the Sidebar== Involved Pages ==
The Sidebar ist generated with a special page in the MediaWiki namespace, that is MediaWiki:Sidebar. It is a bullet list with special items. Don't mix it up with common list styling!
The list-level controls if the item is written as a separating heading or a link.
The list items are divided into two parts by a pipe "|". Both parts shall be the name of a page that belongs to the MediaWiki namespace as well. The first part is a placholder for the link, the second one is a placeholder for the title of the link shown in the sidebar.
For UserBase related changes we prefer following nomenclature:
** ub-name-url | ub-name
Replace name
to your needs.
Now you have to edit MediaWiki:ub-name and MediaWiki:ub-name-url. These pages will contain only one line with the title of the link and the page the link shall point to.
Example:
- MediaWiki:Sidebar:
... ** ub-helpfiles-new-content-url | ub-helpfiles-new-content ...
- MediaWiki:ub-helpfiles-new-content-url:
Tasks and Tools
Where "Tasks and Tools" is the name of an existing page of the Main namespace. - MediaWiki:ub-helpfiles-new-content:
Add new pages
Links to Anchors
If the link shall point to an anchor of a page you have to insert a redirect-page as a work around. Following the nomenclature this page should be called ub-name-redirect and shall only contain the #REDIRECT statement wich leads to the final destination page.
So let's improve the example from above:
- MediaWiki:Sidebar:
... ** ub-helpfiles-new-content-url | ub-helpfiles-new-content ...
- MediaWiki:ub-helpfiles-new-content:
Add new pages
- MediaWiki:ub-helpfiles-new-content-url:
ub-helpfiles-new_content-redirect
- ub-helpfiles-new-content-redirect:
#REDIRECT [[Tasks and Tools#Add_New_Pages]]
Please notice that this last page belongs to the Main namespace!
Translating Sidebar Items
The pages containing the link titles are listed in a special page that is MediaWiki:Userbase-messages. Just write them down without any list formatting or such.
In our example we have to insert the line
... ub-helpfiles-new-content ...
Now the new items can be translated. Visit the Translate page. At the bottom of the list you will find the page "UserBase's custom interface messages". Finally choose your language and fetch the items to be translated.
<translate>
Also see https://blog.neon.kde.org/index.php/2021/04/06/the-end-of-lts-edition/.
Starting on 2021-07-01, the KDE neon Plasma LTS Edition will no longer receive updates and you must migrate to the regular user edition to receive updates. This includes security updates. Deprecating the LTS edition allows us to more efficiently use our resources for the most valuable and also most used editions of neon. This step has of course been a long time coming. We've removed its visibility from websites 3 years ago https://blog.neon.kde.org/index.php/2018/02/12/hiding-neon-lts-edition/ and the rationale for that is even more true today than it was back then.
Switching to KDE neon User Edition
Usually we do not actively support switching from one edition of KDE neon to another. The following migration path has been tested and should work as intended. Please note that any third party repositories such as PPAs, and non-KDE software installed via .deb files in general may inhibit the migration from working correctly. To be on the safe side we advise that you remove/downgrade the software and/or repositories.
Make a backup of all important data.
Have a new installation medium ready in case the switch goes wrong and you need to reinstall a fresh system. https://neon.kde.org/download
Create a file called 40-neon-user-lts-migration
in your home directory and put the following content inside
Package: * Pin: release l=KDE neon - User Edition Pin-Priority: 1100
Switch the repository
sudo sed -i --regexp-extended 's%(neon\.kde\.org.+)(/lts)%\1%g' /etc/apt/sources.list /etc/apt/sources.list.d/*
Next run the following commands:
sudo mv $HOME/40-neon-user-lts-migration /etc/apt/preferences.d pkcon refresh pkcon update --only-download pkcon offline-trigger
Next you need to restart your system and on startup it will migrate to user edition, followed by an automatic restart. As part of the migration the file you created will be automatically deleted. To ensure all software is at the expected versions it's advised to repeat the pkcon commands to apply remaining updates (if any):
pkcon refresh pkcon update --only-download pkcon offline-trigger
Don't forget to restart.
</translate>
- Simon/Base models
- Working with Google Contacts
- Nepomuk/RemovableMediaHandling
- LabPlot/ThemesAndTemplates
- LabPlot/DataAnalysis/CurveFitting
- Parley/Manual/Vokabellernen im Mutliple Choice Modus
- Lokalize
- Tutorials/Kimpanel
- Projects/Usability/HIG/Layout/CommandPatterns
- Plasma/ColorPicker
- Marble/Maemo/GUIGuidelines
- Plan/Manual/Task Dependency Editor (Graphical)
- LabPlot/Interface/ProjectExplorer
- Parley/Manual/How to study vocabulary in multiple choice mode
- Tips/Take screenshots faster with Spectacle using shortcuts
- LabPlot/ImportExport/ImportFromProjects
- Marble/Maemo/Installation
- Plasma/TweakingPlasma
- Workspace Configuration/Desktop Configuration
- System Settings/Input Devices
- Working with Google Calendar
- Plasma/Clocks
- Lokalize/de-formal
- Plasma/Public Transport
- Plan/Manual/Resource Editor
- Toolbox/Tables
- Plasma/Application Dashboard
- Quanta RefreshDoc script
- What is a distribution
- Plasma/Public Transport/NewServiceProviders
- Nepomuk/FileIndexer
- LabPlot/GettingStarted/YourFirstDataImportVisualisation
- Marble/Bookmarks
- System Settings/Printers
- System Settings/Task Scheduler
- Phonon/Handbook
- Showfoto/Levels Adjust
- Step
- Neon/Installation/OEM
<translate>
OEM installation mode is a special installation mode targetted at hardware manufacturers. The principal difference to a regular installation is that the installation itself creates a temporary user for customization from where the system is switched into firstboot mode. Booting in firstboot mode will let the final user configure the system to her preference and create her actual account.
This enables hardware manufacturers to install and prepare a system for their customers while still letting the customers pick their own user name, keyboard layout and the like.
How To
Put the ISO on a USB stick and boot the device using the stick.
Depending on the operation mode of device the ISO will be either booting in BIOS mode or UEFI mode. The two look slightly different, but both offer an option to start in OEM mode.
UEFI
In UEFI mode you will be greeted by GRUB where you simply have to start the OEM entry rather than the standard one.
BIOS
In BIOS mode you will be greeted by a splash screen. You want to hit Esc to get to the menu. In the menu you can use the F4 key to switch the installer into OEM mode. Once selected simply hit Enter to start.
Installation
The installation process itself is the same as it would be for a non-OEM installation. The major difference is that the installer window title will say that the installer is in OEM mode and the user setup will have the fixed username oem.
System Preparation
Booting into this system will bring you to the system preparation stage. You will be logged into the temporary oem user and can modify the system as necessary. In this stage you could install additional software, language packs, media codecs, drivers and so forth.
The system you are working on is going to be the system the user will use, so take care not to leak credentials in log or configuration files. Should you need to, make sure to delete them before you move on.
Once you are done preparing the system you can prepare it for delivery. Simply open a terminal and run
oem-config-prepare
The system is now in firstboot mode. At this stage you could create a disk image of the final system and supply it to your manufacturer to put on all hard drives, or simply do so yourself. The next time the system is booted it will come up in firstboot mode for the customer.
First Boot
During the first boot a simplified installer interface is used to configure the final system. As part of this, the previously used oem user will be removed.
Finale
Once the configuration is done the user is automatically soft-rebooted into his final system. Ready for rock'n'roll.
</translate>
- System Settings/File Associations
- System Settings/Startup and Shutdown
- Plan/Manual
- System Settings/Window Behaviour
- Telepathy
- Okteta
- System Settings/Locale/How To Install and Apply Interface Translation
- Simon/Tips, Tricks and Best Practices
- Quick Start
- Translator Account/2011
- UserBase/Guidelines
- Projects/Usability/HIG/Layout/NavigationPatterns
- What is KDE (pt BR)
- Quanta RefreshDoc
- Plan/Manual/Schedules Editor
- Lancelot/Comparison
- Plasma/FAQ/5.10
- Plasma/GroupingDesktop
- Marble/OfflineSearch
- Trojitá
- Rekonq/FAQs
- Marble/CustomSpeakers
- QCA
- Plasma/FAQ/5.10/Configuration
- Taking Screenshots
- LabPlot/Worksheet
- Plasma/Netbooks
- Plasma/Kicker
- Marble/Search
- LabPlot/LaTeXTypesetting
- Tellico
- Spectacle
- System Settings/Accessibility
- Pairs
- Tutorials/MIDI on Linux
- Translator Account/2010
- Simon/Installation
- Tutorials/Force Transparency And Blur
- Plan/Manual/Definitions
- Showfoto/Curves Adjust
- Showfoto/Perspective
- Tips/Transfer files between phone and PC using Wi-Fi
- LatteDock/TipsAndTricks
- Okular
- Plan/Manual/Task Editor
- LabPlot/ComputationalNotebooks
- Tutorials/Shared Database
- Tutorials/Kontact/Office365
<translate>
How to use Office365.com with Kontact
Scenario: you want to use KDEPIM Kontact - with cloudbased Office365.com (it might work with LAN-based exchange, untested)
This is tested with 4.13.x and 4.14.10 KDE but might work with earlier versions.
Adding the calendar in read-only mode
Doing this is very easy, as Office 365 can export URLs with iCal files:
- Access the web interface of the calendar on Office 365 and click on . Then select "calendar" and insert your own e-mail address and select to share full details.
- Then click .
- When you get the e-mail, look for the link that begins with "webcal://" and copy it.
- Then in Korganizer right click on the list of calendars and select . Then select from the list.
- In the field you need to paste the "webcal://" URL. But you need to replace the initial "webcal://" with "https://".
Get Read/write access
</translate>
<translate> Get mail working. This is fairly easy as Office365 supports both pop3 and IMAP4. Instructions for settings can be found here.</translate>
<translate> You can also choose to access mail via DavMail, see below for installation instructions. This is said to handle Outlook invitations sent via Exchange better (not tested by the author of this article). In such case when you install DavMail tick setting for IMAP and set up your KMail account accordingly.</translate>
<translate> Get your Office365 calendar and contacts in Kontact. For this use DavMail as intermediary "go-between". So first of all install DavMail, for Debian/(x)Ubuntu users here is a deb package, for others a shell installer.</translate>
<translate> Once that is done start DavMail and configure it. In KDE a "systray" should pop up for basic settings. "Untick" the mail settings but leave Caldav and LDAP settings. The other setting you need is OWA URL that for Office365 is https://outlook.office365.com/owa</translate>
<translate> All other settings are done in Kontact/KDEPIM.</translate>
<translate> To get Calendar working (shared calendars are not tested, feel free to experiment):
. Put yourid@yourdomain.comorgnet and your password, choose Davical server. For server name and path put anything, you will edit later in any case. Click .</translate><translate> On next menu set a name for your resource and click
on the fictional resource. Leave "CalDav" as protocol but change remote url tohttp://localhost:1080/users/yourname@yo ... /calendar/
and credentials toyourname@yourdomain.comorg
and your password, then click and your Calendar should show up. Set a preferred refesh rate and in Kontact do not forget to now tick this Calendar to activate it.</translate>-
<translate> To get your Contacts working:
. Putyourid@yourdomain.comorgnet
and your password, choose Davical server. For server name and path put anything, you will edit later in any case. Click .</translate><translate> On next menu set a name for your resource and click
on the fictional resource. Choose CardDav as protocol but change remote url tohttp://localhost:1080/users/yourname@yo ... /contacts/
and credentials toyourname@yourdomain.comorg
and your password, then click and your Contacts should show up. Set a preferred refresh rate and in Kontact do not forget to now tick this Address Book to activate it.</translate> <translate> Finally to access "public address books". They can be found as LDAP via Kontact/Kaddressbook in KAddressbook
. Then select on the left column LDAP Server Settings and click .</translate><translate> Set this up as "host:localhost", "port:1389", "DN=ou.people", "authentication:simple" "Bind DN" as "yourid@yourdomain.comorgnet" and password well you should know next time you compose a new mail you can now use
button and then .</translate>
<translate> </translate>
- Plasma application launchers
- Troubleshooting/Black Screen
- Live CDs - a way to choose your distro
- Marble/Tracking
- What is KDE
- Working with GMail
- Troubleshooting
- Phonon
- Tasks and Tools
- Sound Problems
- RKWard
- Wiki Team Page
- LabPlot/2DPlotting/BoxPlot
- Marble/WizardMap
- Plasma/Kickoff
- System Settings/Shortcuts and Gestures
- Plasma/Plasmoids
- Mailing Lists
- Plasma/Tasks
- Tutorials/Install KDE software
- Plasma/Panels
<translate>
Panels in Plasma Desktop

A Panel is a widget container which can be located on any side of the screen. There can be multiple panels on the screen or even on the same side. The default layout is one panel that stretches across the entire bottom of the desktop with the following widgets: application menu, desktop pager, task manager (list of open windows), system tray (including things like power management if you are on a laptop), digital clock, and peek at desktop.
Configuration
Panel configuration can be accessed via the context (right click) menu in the panel. At that point, the panel will be in edit mode.

Arranging Widgets
Widgets in the panel can be sorted by dragging them when in configuration mode. Widgets align left in the horizontal and top in the vertical panel. You can center widgets in the panel by adding flexible sized spacers on both sides (see the section on the panel toolbox).
</translate><translate>
The Panel Toolbox
- Size arrows: The arrows on the bar in the middle allow the panel size to be adjusted.
- Arrows pointing left change the minimum panel size.
- Arrows pointing right change the maximum panel size.
- The arrow pointing up is the center of the panel.
- To adjust the height of a horizontal panel or the width of a vertical panel, use the spin box in the toolbox.
- After resizing a panel, you can reset it to maximized in the menu.
- : Allows widgets to be added to the panel. This will open a sidebar from which you can drag widgets into the panel.
- The standard behavior of a spacer is that it uses as much space as possible (flexible size), but you can also set it to a . Enter the context (right click) menu and deactivate .
: Allows you to add a spacer into the panel giving space between the items in it.
- : You can click into the empty space and drag the panel to any of the four edges of the screen.
- : Removes the current panel and all widgets in it.
- (for horizontal panel)/ (for vertical panel): Allows the panel height or width to be adjusted. To change the width of a horizontal panel or the height of a vertical panel, use the arrows.
- : Opens additional settings for the panel (see next section).
The "More Settings" Menu
- : Keeps the panel visible at all times, even when windows are maximised.
- : Hides the panel off screen until the mouse is placed near the screen edge.
- : This allows windows to cover the panel and if maximised, will cover the panel.
- : This allows windows to go below the panel, even when maximised.
- : Makes the panel opaque when any windows are touching it, and translucent otherwise.
- : Makes the panel always opaque,
- : Makes the panel always translucent.
- : Makes the panel fit to the screen edges, if it has been resized.
- : Adds some margin around the panel when no windows are touching it.
- : Deletes the panel.
- : Allows you to set a shortcut to focus the panel when it is not currently visible.
Adding Panels
It is also possible to have more than one panel on your desktop. This proves useful if you want to have a more flexible layout:

To add a new panel either click on the desktop toolbox button and select
or open the context (right click) menu on the desktop and select from the menu.If more than one kind of Panel is installed, you will be able to select between them to choose what sort of Panel you would prefer. By default, two Panel types are available:
, which creates a Panel containing all of the default widgets (launcher, pager, tasks, system tray, clock, etc.), and , which adds a blank Panel without any pre-configured widgets in it.Under the Hood
Should anything "untoward" happen to your panel have a look at ~/.config/plasma-org.kde.plasma.desktop-appletsrc - the panel itself is classed as a containment (there are at least two, the desktop and the panel) which is home to all the different widgets you put there.
</translate>
- Plasma/FAQ/4.4
- Plasma/FAQ/4.4/Tips
- Plasma/Create a Global Theme Package
- Marble/Maemo/GuidanceMode
- NewSystemSettings
- Translation Workflow
<translate>
Much of the information that was on this page is now outdated. How-Tos exist for all the common contributor tasks, including translation, both on- and off-line, and can be found linked from Tasks and Tools.
Guidelines applicable to all Languages
KDE style
The KDE voice is helpful, aspirational, and genuine. Our communications strive to be:
- Efficient
- Highlight the elegance of efficiency — from steps removed and labor reduced to costs saved.
- Effortless
- Communicate in intrinsically simple terms. Be concise, intuitive, eloquent, and fluid.
- Useful
- Address real needs and open up new opportunities.
- Immersive
- Make communications as engaging and comprehensive as the technology they cover.
- Meaningful
- Use real examples and genuine recommendations to make the message personal and relevant.
Know Your Skills
KDE relies on volunteer translators to help make useful KDE information available around the world. As volunteers, you are not required to have any formal language training, but we do ask that you know your fluency and get the support you need to finish a translation if you run into tricky language issues or content that lies outside your translation capabilities.
Because many of the articles on KDE wiki are technical in nature, it also helps to be familiar with—and even fluent in—KDE products. You will need to be able to distinguish between common terms and technical terms in context and determine when user interface or workflow elements that are mentioned in the articles need to be translated.
General guidelines
- Expressions, jargon, and humor
- As you translate, you may encounter expressions, puns, or jargon that are specific to the original language and may be difficult to translate effectively.
- In such cases, translate the concept or point the article is trying to convey and not the exact words.
- Take care to ensure you capture the overall message, and don't worry about losing the humor or the colloquialism.
- Proper names
- Company names and product names should never be translated. Proper company names and product names should always remain in English, no matter what language you are translating for.
- People's names should remain in English for Latin-based languages, but you may transliterate them for non-Latinbased alphabets.
- Terminology
- For help with translating tricky constructions or technical terms, consult the translation-sharing site to: TAUS.
- Simply enter your desired text and then choose which language to translate it from and to. Not all terms are included for all languages, but this can be a helpful tool for completing accurate translations.
- Titles of works
- When you run across the title of a book, program, feature, distro, or other public work, check to see if that title has already been officially translated for your language (by the publisher or distributor), and if so, use that translation.
- If you cannot find a translation for that particular title in your language, do your best to translate it as accurately as possible.
- Units of measurement
- Convert units of measure to make them relevant for the intended language or region. For example, some English-speaking countries use the unit of inch, but other countries may prefer centimeter unit.
- User interface terms
- Translate user interface terms as appropriate for your language.
See here for more information:
1. http://translate.sourceforge.net/wiki/guide/start
2. Glossary: http://translate.sourceforge.net/wiki/guide/glossary
3. Another Glossary: http://www.glossary.com/category.php?q=Computer
Keeping up to date with developments
I propose that the Discussion page attached to this page should be used for orderly debate about issues noted, particularly issues where existing markup is causing problems. Old threads, long since resolved will be cleaned out, and once decisions are made I will update the relevant help pages. I would ask you to put a Watch on Talk:Translation_Workflow.
Getting a Better Understanding of the Process
For a fuller description of the Translate extension, read the description on the developers' website
</translate><translate>
Language-specific guideline pages
We propose to have Team Leaders for each language. As we get leaders appointed, they will take charge of a page of guidelines for their specific language, where they will be named. They will have final say on any question relating to their language. The guidelines are listed below:
</translate>
- Plan/Engineering To Order project tutorial/executing
- System Settings
- Tutorials/KDE3 to KDE SC 4
- Translation Workflow/Danish
- Marble/Maemo/OfflineRouting
- Plasma/HowTo/4.5
- Showfoto/White Balance
- Translate a Page
- Simon/Development Environment
- Tutorials/ComposeKey
- Showfoto/Brightness
- Wiki Team Page/Problems
- Troubleshooting/Samsung scx-4500W
- Simon/Troubleshooting Guide
- Plasma/Public Transport/CreateServiceProviders
- Lancelot/Discover Lancelot
- Plasma/How to create a Unity-like look and feel theme using Plasma’s Desktop Scripting API
- NetworkManagement
- Plasma/Public Transport/ServiceProviders
- Simon/Licensing
- System Activity
- Translation Workflow/Catalan
- Writing an Application Manual
<translate>
Notes
Manuals will be included as sub-pages of the main application page. For brevity, I will refer to that main page as Appname. The structure, therefore would be something like:
- Appname
- Appname/Hints and Tips
- Appname/Manual # Your Contents page
- Appname/Manual/An Introduction to Appname
- Appname/Manual/Configuration Choices
- Appname/Manual/The First Time you use Appname
- Appname/Manual/section 1
- Appname/Manual/section xxx
- Appname/Manual/Hints and Tips
- Appname/Manual/Troubleshooting
- Appname/Manual/Bug reports
- Appname/Manual/Get involved #link to techbase etc
If some of your sections grow too large, you can place subsections on separate pages. It might look like this:
- Appname/Manual # Your Contents page
- Appname/Manual/An Introduction to Appname
- Appname/Manual/Configuration Choices
- Appname/Manual/The First Time you use Appname
- Appname/Manual/section 1
- Appname/Manual/section 1/subsection 1
- Appname/Manual/section 1/subsection 2
and so on.
In order for the automatically generated Docbook to have the same contents page as the one you make on UserBase, and for links to work in the Docbook there are a couple or guidelines, that must be followed:
- The Docbook Table of Contents will list all sections and subsections regardless of whether they have a page of their own. On the other hand, subsubsections won't be listed in the Docbook TOC even though they have a page of their own.
- All pages should have a heading at the very top, either a section (== ... ==), a subsection (=== ... ===), or a subsubsection (==== ... ====), otherwise the Docbook structure will be messed up.
- The title of the section/subsection must exactly match the page name, otherwise Docbook links won't work.
- Subsection titles must be written like this:
=== title ===
, even if it is the top level on a page. Otherwise the Docbook structure will be messed up. Similarly, if you have a very long subsection with subsubsections on pages of their own, these pages must have their titles written like this:==== title ====
.
- Subsubsections that should not appear in the contents page and should not appear on a page of its own in the Docbook must be level 4 or below, i.e ==== or more.
- Links to pages in the manual must exactly match the page name (i.e. no links via redirects!)
- If you link to a subsection of a page, you must have an anchor at the target location. Failing that will mess up Docbook links as well as translations.
You will need a scratchpad to experiment with section headings/pages. You can use either your UserTalk page, or the discussion pages attached to the area where you are working. It's helpful if you remove anything no longer required, once the job is completed.
Developing a Manual
While developing your manual it is usually best to keep it separate from the regular UserBase content. Some prefer to edit their drafts as subpages of their Talk: page. We also have a special Draft: namespace for this purpose.
To create the content page of your manual, simply write http://userbase.kde.org/Draft:Appname/Manual in the address line of your browser, or place the [[Draft:Appname/Manual]] link in a page and then click it. Either way you will be taken to a page telling you that the page does not exist, but that you can create it clicking a link.
Contents
- Once you have made the decisions (that can be a lengthy procedure), create appropriate links on the Contents page. It is, of course, possible to insert a section later if you find you've missed something.
Building your Manual
- Use the red links to create the page, and write up a section at a time.
- Note on the Discussion page anything you will need to refer to later, such as links that can't yet be created.
Formatting considerations
In order for your manual to be translatable into Docbook format there are some restrictions on formatting that should be observed.
- Notes and Warnings do not support alternative titles in Docbook. Don't write something like
{{Remember|2=Don't Forget This!|1=You can use...}}
The2=...
part has no meaning in Docbook and the program transforming the wiki page to Docbook might get very confused. Just write{{Remember|1=You can use...}}
- Embed a Video has some limitations in its current implementation: Only YouTube and Vimeo are supported and only one value (the id of the video) can be passed as argument.
Searching your manual
At some point, you may need to find something that you wrote earlier, but can't remember where. Using the wiki search box may not be ideal unless the string you search for is very specific. You can get much better control over searches using the DPL extension. For example, to find the pages in your manual containing a certain string, you can add the following to any page:
<DPL> titlematch = %Appname/Manual% nottitleregexp = .*((/[a-z][a-z](.|-..)?)|([ _][(][a-z][a-z](...)?[)]))$ namespace = | Draft include = * includematch = /string to search for/ includemaxlength = 0 resultsheader = Manual Pages: format = ,\n* [[Writing an Application Manual|Writing an Application Manual]]\n,, </DPL>
Preparing the Manual for Translation
- The steps for markup editing can be found on Preparing a Page for Translation. Please adhere to that guide, since old markup styles may not still be relevant.
Producing a DocBook manual
Once your manual is written you can have it transformed into a DocBook manual, so that your work can be used like an ordinary KDE handbook. The procedure is described in this page. </translate>
- LatteDock/FAQ
- Table of equivalent applications
- Umbrello/FAQ
- Tutorials/Using Other Window Managers with Plasma
- Plasma/FAQ/4.4/Configuration
- Rekonq
- Typographical Guidelines
<translate>
There are separate pages explaining syntax with example code.
Links
Links to other UserBase pages should follow this pattern:
[[Special:MyLanguage/page name|whatever]]
[[Special:MyLanguage/Welcome to KDE UserBase|start page]] links to the welcome page in the readers language if the translation exists or else to the english version of that page.
Links to external pages follow normal wiki syntax:
[https://web.site.xxx/page text]
Bold Text
Use bold text to highlight
- Window titles
- Common labels that are not user-configurable
- Icon captions
- Program names
For example:
- Highlighting a selection of text will copy it to Klipper.
Italic Text
Use italic text to emphasise
- Words or phrases as in general writing.
- Titles when referencing other works.
- The first use of an unfamiliar word.
Some examples:
- Save your work at this point.
- Details can be found in Samba 3 by Example....
- KDE Manuals are in Docbook format.
Combined Bold and Italic Text
Use this combination for replaceable or variable text.
Some examples:
- To connect to your remote server, type
ssh
username@domain.name in Konsole. - In rpm-based distributions, the command
rpm -q
packagename will result in package-version-release.
Mono-spaced Text
Code should be presented in mono-spaced text, usually boxed, as shown below. Input text will be on a light yellow background. For output text, the background colour will be a light grey.
- Code, whether single lines or blocks, use templates to ensure consistency
- Use the Input template like this:
{{Input|1=<nowiki> qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit rm -r ~/.kde/share/apps/nepomuk rm -r ~/.kde4/share/apps/nepomuk nepomukserver</nowiki>}}
This will display like this:qdbus org.kde.NepomukServer /nepomukserver org.kde.NepomukServer.quit rm -r ~/.kde/share/apps/nepomuk rm -r ~/.kde4/share/apps/nepomuk nepomukserver
- Output works the same way:
{{Output|1=<nowiki>terminal output is also shown as code, but on a grey background</nowiki>}}
which displays asterminal output is also shown as code, but on a grey background
- Starting an Input or Output template on a new line will break the display format if it is within lists. Simply continue on the same line if you need to correct this.
- You can also combine input/output areas with GeSHi syntaxhiglighting. An input area like this
{{Input|<syntaxhighlight lang="php" line> # Initialise common code $preIP = dirname( __FILE__ ); require_once( "$preIP/includes/WebStart.php" ); </syntaxhighlight>}}
will result in# Initialise common code $preIP = dirname( __FILE__ ); require_once( "$preIP/includes/WebStart.php" );
- Single code words can be kept in-line by using
<code></code>
It willdisplay
like this. Note, that if the <code> tag is immediately preceded by a newline character, it will not display properly.
- File names and paths should use the Path template (see below).
Block Quotes
The tags <blockquote> and </blockquote> should be used when quoting other works or other pages. This produces a proportional italic font, with some padding.
Here is an example of the display that you get by using the blockquote tags.
Text in Section Headers
Even though the criteria above may be met, do not use Bold text in section headers or in links.
Text in Information, Note, Tip or Warning Templates
Bold text should be avoided in the text within these templates. Italic text for emphasis may still be used - use sparingly for maximum effect.
</translate><translate>
Lists
You can have various kinds of lists in your pages — bulleted, numbered or itemized. Find details on the Toolbox page.
</translate><translate>
Keeping things together
After your text is written some markup is automatically added by the translation system. This means that whenever it sees a blank line, it starts a new unit. When your text is presented to translators, they typically see it one unit at a time, so it is important not to leave a blank lines in the middle of something that should be treated as a unit. Normally an entire paragraph should be kept in a single unit; and under no circumstance should a sentence be split between units!
If you need a linebreak in the middle of a section, the preferred way to achieve this without breaking units is to use <br /> at the end of the line where you want to break to occur (not on a new line). If you need space between the lines add <br /><br />.
</translate><translate>
Unbalanced brackets
The translation system marks any translated unit as incompletely translated if it contains any kind of unbalanced brackets. If you need to have unbalanced brackets in your text, please add a balancing bracket in a comment tag, like this:
<!-- }} -->{{ A line <!--T:38--> Another line}}<!-- {{ -->
This goes for all kinds of brackets, even ordinary parentheses. (Of course it is normally better to avoid blank lines within a mark up unit - see Keeping things together.)
Special Tags
- <keycap> and </keycap> denote (keyboard) key names e.g. Enter
- <keycap></keycap> can also be used around groups of keys to be used concurrently, e.g. Ctrl + Alt + F1 to launch a virtual terminal. (Note that "(space)+(space)" is used to link keys to be pressed concurrently).
- Sequences of menu choices should use <menuchoice> and </menuchoice> for example
- In general, if the user needs to choose an element, even if it is not in a menu, the <menuchoice></menuchoiсe> markup should be used.</translate>
<translate>
- If you are contributing to a manual page, you should always use the markup describes above. For other pages, though, there is a template to enter menu selections: {{Menu|Top|sub|...}}. Fx, {{Menu | View | Message List | Aggregation | Standard Mailing List}} yields → → → </translate>
<translate>
- If you want to use the <menuchoice> but use → in stead of ->, you write
& rarr;
(without a space between '&' and r!) as in <menuchoice> View</menuchoice> & rarr; <menuchoice>Message List</menuchoice> which yields → . (Note, that the → character has to be outside of the menuchoice tags to be shown properly
Files and file paths
Traditionally, file names and paths have been marked up between <tt>...</tt> tags.
<tt>~/.kde/share</tt>
yields
~/.kde/share
There is now also a template for this, which should be preferred in new content for ordinary UserBase pages (but not for manual pages, please!):
{{Path | ~/.kde/share }}
yields
~/.kde/share
The Problematic Pipe
In some situations the pipe symbol can't be used - for instance when adding parameters into a template. In any such case, please use {{!}} which will display as a pipe symbol. For example, if you want to display a command line containing the pipe character using the {{Input|...}} template, the simplest way to do it is this: {{Input|1=cmd1 {{!}} cmd2}}
which displays
cmd1 | cmd2
If you just write {{Input|cmd1 | cmd2}}
you get instead
cmd1
the problem being, that cmd2
is seen as a second parameter to the template, which in this case is not used.
In many cases, you can also enclose the text containing the pipe character between <nowiki>... </nowiki> tags, like this {{Input|1=<nowiki>cmd1 | cmd2</nowiki>}}
, which also displays
cmd1 | cmd2
Translatable Content
Everything that is translatable is contained within <translate> and </translate> tags. In most cases any images should be contained within the translatable section, as it is sometimes necessary to use localised versions of the images to explain a point. The rule of thumb is "If in doubt, include it!". </translate>
- Plasma
- Plan/Manual/Creating ODT Report Templates
- LabPlot/FAQ
- Marble/MapThemes
- Test
- Tellico/DefaultFields
- Tutorials
- Nepomuk
- Plan/Engineering To Order project tutorial/planning
- Translator Account

Remember
<translate>
Translator Account
In order to become a translator on UserBase you first need an account on the KDE Identity system (the procedure is described on the Introduction to new contributors page). Then you just add your name to this list in order to request translator rights. We usually respond within a few days - a short greeting is added to your application to show, that you are now an official UserBase translator.
</translate>
Example (please add yours to the bottom of the page) :
User Name: Hans
Language(s): Swedish
(Optional) Do you expect to work off-line?: No
User Name: kakaroto
Language(s): Brazilian Portuguese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 07:31, 25 January 2020 (UTC)
Wiki Username: RogueScholar (talk | contribs) / KDE Identity: pmello | |
Language(s): European Portuguese (pt_PT) | |
Do you expect to work off-line?: Sometimes | Submitted: 06:10, 2 February 2020 (UTC) |
Welcome to the Translator group Claus chr (talk) 09:10, 2 February 2020 (UTC)
User Name: Antoni0
Language(s): Italian
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 05:49, 3 February 2020 (UTC)
User Name: Ezequias Santos
Language(s): Brazilian Portuguese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 05:58, 10 February 2020 (UTC)
User Name: Imgradeone
Language(s): Chinese (China)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 06:47, 17 February 2020 (UTC)
User Name: Karellism
Language(s): Dutch
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 09:33, 19 February 2020 (UTC)
User Name: KKatanov
Language(s): Russian
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 05:44, 25 February 2020 (UTC)
User Name: Wessell Urdata
Language(s): Chinese(Traditional)
(Optional) Do you expect to work off-line?: no
Welcome to the Translator group Claus chr (talk) 09:34, 29 February 2020 (UTC)
User Name: Michael Liang
Language(s): Chinese
(Optional) Do you expect to work off-line?: no
Welcome to the Translator group Claus chr (talk) 07:55, 4 March 2020 (UTC)
User Name: Falion
Language(s): English, German, Turkish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 05:44, 14 March 2020 (UTC)
User Name: niamfrifruli
Language(s): Spanish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 16:54, 30 March 2020 (UTC)
User Name: panxiaoyu
Language(s): Chinese(Simplified)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:26, 9 April 2020 (UTC)
User Name: Xeyyam
Language(s): Azerbaijani
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Claus chr (talk) 06:14, 13 April 2020 (UTC)
User Name: Ikoch
Language(s): German
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:07, 11 April 2020 (UTC)
User Name: Cyril
Language(s): French
Do you expect to work off-line?: why not.
Welcome to the Translator group Claus chr (talk) 06:07, 13 April 2020 (UTC)
User Name: Svetlij
Language(s): Russian
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Yurchor (talk) 17:59, 18 April 2020 (UTC)
User Name: kayterina
Language(s): Hellenic (el/cy)
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Claus chr (talk) 06:41, 3 May 2020 (UTC)
User Name: xoch
Language(s): Spanish
(Optional) Do you expect to work off-line?: Maybe
Welcome to the Translator group Claus chr (talk) 04:56, 3 June 2020 (UTC)
User Name: Manicap
Language(s): Czech
(Optional) Do you expect to work off-line?: I am not sure for now.
Welcome to the Translator group Claus chr (talk) 08:00, 9 July 2020 (UTC)
User Name: Reverier
Language(s): Chinese(Simplified)
(Optional) Do you expect to work off-line?: Maybe.
Welcome to the Translator group Claus chr (talk) 07:34, 23 August 2020 (UTC)
User Name: Hakanydin
Language(s): Turkish(tr)
(Optional) Do you expect to work off-line?: Maybe
Welcome to the Translator group Yurchor (talk) 17:40, 16 September 2020 (UTC)
User Name: ColibriCosmique (wiki), colibricosmique (KDE Account)
Language(s): French
(Optional) Do you expect to work off-line?: Maybe sometimes
Welcome to the Translator group Yurchor (talk) 12:15, 27 September 2020 (UTC)
User Name: boutiflet
Language(s): French
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 05:43, 14 October 2020 (UTC)
User Name: Fhek
Language(s): Brazilian Portuguese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:55, 20 December 2020 (UTC)
User Name: marcinsta
Language(s): polish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:04, 28 January 2021 (UTC)
User Name: LakeJason
Language(s): Simplified Chinese and Traditional Chinese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 14:04, 10 February 2021 (UTC)
User Name: hasntbeentaken
Language(s): Chinese(Simplified)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:42, 21 February 2021 (UTC)
User Name: akagusu
Language(s): Brazilian Portuguese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 06:51, 25 February 2021 (UTC)
User Name: zerox
Language(s): Arabic
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 06:51, 8 March 2021 (UTC)
User Name: Vegata
Language(s): Japanese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 05:44, 12 March 2021 (UTC)
User Name: toyamasoujinn
Language(s): Japanese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 06:57, 10 April 2021 (UTC)
User Name: Fdekruijf
Language(s): Dutch
(Optional) Do you expect to work off-line?: yes
Hi Fdekruijf
It seems you already have the requested rights - are you experiencing problems accessing your old user account? Claus chr (talk) 04:55, 16 April 2021 (UTC)
User Name: phylastik
Language(s): French
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 06:09, 2 May 2021 (UTC)
User Name: Jesusmeneses
Language(s): English-Spanish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 04:53, 18 May 2021 (UTC)
User Name: Antemyste
Language(s): French
(Optional) Do you expect to work off-line?: occasionally
Welcome to the Translator group Claus chr (talk) 05:20, 26 May 2021 (UTC)
User Name: Vlcerqueira
Language(s): Brazilian Portuguese
(Optional) Do you expect to work off-line?: Sometimes
Welcome to the Translator group Claus chr (talk) 04:52, 31 May 2021 (UTC)
User Name: fyn
Language(s): Chinese(Simpled)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 06:19, 20 June 2021 (UTC)
User Name: Coioidea
Language(s): Chinese(Simplified)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 05:06, 21 June 2021 (UTC)
User Name: Pzm
Language(s): Chinese(Simplified)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 05:58, 26 June 2021 (UTC)
User Name: Siderealart
Language(s): Traditional Chinese
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Yurchor (talk) 08:29, 27 June 2021 (UTC)
User Name: Cheredin
Language(s): Russian
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 18:03, 4 July 2021 (UTC)
User Name: Notifyctrl
Language(s): Chinese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 06:07, 13 July 2021 (UTC)
User Name: Brsvh
Language(s): Chinese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:42, 19 July 2021 (UTC)
User Name: Bardia
Language(s): Persian
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 06:11, 28 July 2021 (UTC)
User Name: marcoxiao
Language(s): Chinese English
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 05:02, 21 August 2021 (UTC)
User Name: shan
Language(s): Turkish, English
(Optional) Do you expect to work off-line?: Mostly on-line
Welcome to the Translator group Claus chr (talk) 05:18, 25 September 2021 (UTC)
User Name: archandilinux
Language(s): German, English, French, Spanish, Tagalog/Filipino, Japanese
(Optional) Do you expect to work off-line?: no
Welcome to the Translator group Yurchor (talk) 14:13, 11 November 2021 (UTC)
User Name: namatullahkhan
Language(s): Urdu
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Claus chr (talk) 08:10, 14 November 2021 (UTC)
User Name: Justman
Language(s): German
(Optional) Do you expect to work off-line?: ?
Welcome to the Translator group Claus chr (talk) 05:57, 22 May 2022 (UTC)
User Name: Aisekleovus
Language(s): Russian
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Claus chr (talk) 06:37, 18 June 2022 (UTC)
User Name: Sihnu
Language(s): Spanish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 13:14, 22 August 2022 (UTC)
User Name: Rhabacker
Language(s): German
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 08:05, 23 August 2022 (UTC)
User Name: gkpiccoli
Language(s): Portuguese-BR
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:44, 2 September 2022 (UTC)
User Name: mvillarino
Language(s): galician, spanish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 14:27, 28 September 2022 (UTC)
User Name: esari
Language(s): Turkish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 08:21, 7 October 2022 (UTC)
User Name: Futurelemon
Language(s): Japanese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:00, 2 November 2022 (UTC)
User Name: Evs
Language(s): Russian
(Optional) Do you expect to work off-line?: Yes
Welcome to the Translator group Claus chr (talk) 08:13, 22 November 2022 (UTC)
User Name: mib
Language(s): German
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 10:30, 19 December 2022 (UTC)
User Name: gheescoo
Language(s): Chinese (Simplified)
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 09:12, 30 December 2022 (UTC)
User Name: axelkeller
Language(s): German
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Yurchor (talk) 17:18, 23 January 2023 (UTC)
User Name: michielfotograaf
Language(s): Dutch
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 12:49, 9 February 2023 (UTC)
User Name: stepanzubkov
Language(s): Russian
(Optional) Do you expect to work off-line?: Sometimes
Welcome to the Translator group Claus chr (talk) 09:49, 14 February 2023 (UTC)
User Name: জয়শ্রীরাম সরকার
Language(s): Bengali
(Optional) Do you expect to work off-line?: yes
I have added translator rights to user Joysriramsarkar - I assume this is your login name. Let me know if this is not correct. User name জয়শ্রীরাম সরকার is not known to the system.
Welcome to the Translator group Claus chr (talk) 16:05, 13 November 2023 (UTC)
User Name: kazu
Language(s): Japanese
(Optional) Do you expect to work off-line?:No
Welcome to the Translator group Claus chr (talk) 10:59, 19 November 2023 (UTC)
User Name: pzamponi
Language(s): Italian
(Optional) Do you expect to work off-line?:No
Welcome to the Translator group Claus chr (talk) 11:18, 7 February 2024 (UTC)
User Name: Alem
Language(s): Italian
(Optional) Do you expect to work off-line?:No
Welcome to the Translator group Claus chr (talk) 11:18, 7 February 2024 (UTC)
User Name: Gedon
Language(s): German, English
(Optional) Do you expect to work off-line?: Sometimes
Welcome to the Translator group Claus chr (talk) 09:26, 3 April 2024 (UTC)
User Name: Kokaia
Language(s): Georgian
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 09:13, 13 April 2024 (UTC)
User Name: Sriveenkat
Language(s): Tamil
(Optional) Do you expect to work off-line?: No
I'm sorry to have kept you waiting. Somehow I missed your request. Welcome to the Translator group Claus chr (talk) 06:12, 4 June 2024 (UTC)
User Name: Gschegosch
Language(s): Russian, Ukrainian, Polish
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 06:12, 4 June 2024 (UTC)
User Name: Iskandarma
Language(s): Chinese
(Optional) Do you expect to work off-line?: No
Welcome to the Translator group Claus chr (talk) 07:50, 15 October 2024 (UTC)
<translate>
Add an Introductory Screenshot and Description
Whenever possible we begin an application's top-level page with this. The code to achieve it is
{|class="tablecenter vertical-centered" |[[Image:YourScreenshot.png|250px|thumb]] |Your descriptive text |}
Format Your Text
Use Headings
Each heading goes on its own line starting and ending with two or more '=' characters. Once there are more than a handful of headings on a page they automatically create a Table of Contents, so use them. The number of '=' characters determines their level in the Table of Contents, thus your headings should be '==Main section name==', '===Subsection name===', '====Sub-subheading name here====', and so on. Avoid using single '=', as that denotes a page heading and every wiki page already has one made from its name; for example, this page's title "Claus chr/DPL" appears as its page heading.
Use bold and italic
Blips are used to specify bold and italic words.
Use '''bold text''' to specify bold text and ''italic text'' to specify italic text.
In order to ensure we get easy and accurate translations, please adhere to the typographical guidelines.
Add a Code Snippet
We have templates to assist in correctly displaying code snippets. Examples of use in various situations are available on the typographical guideline page
If you have problems displaying pipe characters in your code snippet, please see the explanation and markup detailed on Typographical Guidelines
Add Indents
- ":" is used for an indent, and was used in multiples in some old pages. This is deprecated, and causes some problems, so the multiples will be removed as they are found. A single ":" indents by four characters.
Format Dates
Dates in a purely numerical format cause confusion, due to differences in expectations of geographical zones. Please format dates as
18 Mar 2011
with the month either spelled out completely or in abbreviated form, and the year in 4-digit format. The day may be single or double-digit.
</translate><translate>
Bulleted Lists
* is the symbol to use for bulletted lists. ** gives a second level:
* Almonds <!--T:22--> * Nuts ** Cashews <!--T:23--> * Raisins
produces
- Almonds
- Nuts
- Cashews
- Raisins
Enumerations
Enumerations are produced in the same way, using '#'.
# Sift # Mix ## Stir thoroughly # Bake
produces
- Sift
- Mix
- Stir thoroughly
- Bake
For more details see wikimedia on lists.
Combining Bulleted Lists and Enumerations
You can have an enumerated sublist in a bulleted list and vice versa, like this:
* Nuts *# Cashew *# Crazy * Other things
produces
- Nuts
- Cashew
- Crazy
- Other things
while
# Nuts #* Cashew #* Crazy # Other things
produces
- Nuts
- Cashew
- Crazy
- Other things
To get each bullet and each sub bullet in its own translation unit you can enter something like this:
* First bullet </translate > <translate > ** First sub bullet </translate > <translate > ** Another sub bullet<br /><br />This one consists of two paragraphs </translate > <translate > * The next main bullet </translate > <translate > ** And so on
This displays like this:
- First bullet</translate>
<translate>
- First sub bullet</translate>
<translate>
- Another sub bullet
This one consists of two paragraphs</translate>
- Another sub bullet
<translate>
- The next main bullet</translate>
<translate>
- And so on
The same method should apply to the other kinds of lists.
If on the other hand you need to have more sections in the same item, you can do something like this to have each section in a translation unit of its own:
* First bullet </translate > <translate > * Second bullet, first section. </translate><br /><br /> <translate > Second section of the second bullet. This section has a translation unit of its own </translate > <translate > * And so on
This displays like this:
- First bullet</translate>
<translate>
- Second bullet, first section.</translate>
<translate>
Second section of the second bullet. This section has a translation unit of its own</translate> <translate>
- And so on
Itemizations
Itemizations are produced using ; and : alternatively. They are best for giving short descriptions for a group of related objects.
;Animals : They move around and devour other creatures. <!--T:46--> ;Plants : They have roots and feed upon ground water and sun.
produces
- Animals
- They move around and devour other creatures.
- Plants
- They have roots and feed upon ground water and sun.
Add a Link
There are three kinds of links to learn, internal ones, to another userbase page, internal links to a section of a userbase page, and external URL links.
For an internal link the format [[PageLayout]], where you want to display the name of the page, does work, but it is not ideal, particularly for translation to docbook and for localisation. It is better to use the form [[Special:myLanguage/PageLayout|Page Layout]], because that allows translators to link correctly even though the page name is localised. The result is that it directs to the correctly translated page, if one exists. You often need to include the link in a sentence, so in that case you would use
[[Special:myLanguage/PageLayout|this page]]
which displays
Internal links to subsections of a page use character '#' (hash) and should look like this
[[Special:myLanguage/Tasks_and_Tools#Working_with_Languages|...]]
With this kind of link it is very important, that the page you link to declares the reference anchor. If the anchor contains space characters, replace them by character '_' (underscore) when calling the reference. If the reference is found, the section will be automatically displayed by your browser (if it manages anchors). If it is not the case, you will have to go down through the page to find the referenced section. External links are given as the URL and a text separated by a space and delimited by single square brackets as in
[https://en.wikipedia.org/wiki/KDE KDE's Wikipedia page]
which gives KDE's Wikipedia page.
Anchor declaration
Anchor declaration must be done immediatly BEFORE the referenced section, and followed by a blank line separating the anchor and its headline. In the following example just copy in the ID value, the title of associated section. It should look like this:
</translate><span id="Working with Languages"></span> <translate>
If the page containing the section that you link to is not yet marked up for translation, you should omit the </translate > and <translate > tags.
External links are slightly different so
[http://techbase.kde.org/Schedules our road map]
displays
our road map, which would take you straight to the techbase page.
One last thing to note - when you preview your page, all links are live. This gives you two benefits. You can check (by hovering) that your links are set up as you expected, and you can use a red link to create a new page.
Make an application list
If you want to make a list of applications like the ones in the subpages of Applications, you should use the AppItem
template. Simply enter
{| {{AppItem|System Settings/Locale|Preferences-desktop-locale.png| Settings for localized handling of numbers, dates, etc}}A short text. A few more short lines about the app. This is optional. |- {{AppItem|System Settings/Shortcuts and Gestures|Preferences-desktop-keyboard.png| Shortcuts and Gestures}}Another short text. If you do not type <keycap>Enter</keycap> between the texts you get one section no matter how long the text is. |}
This gives the following display:
Settings for localized handling of numbers, dates, etc | |
![]() |
A short text.
A few more short lines about the app. This is optional. |
Shortcuts and Gestures | |
![]() |
Another short text. If you do not type Enter between the texts you get one section no matter how long the text is. |
Note, that you should not prepend "Special:myLanguage" to the page name - the template takes care of that. Also note, that you must give a title, even if the title is the same as the page name.
Footnotes
Footnotes are rarely used in our pages, but if you need them you can place a <ref>text</ref>
in the source where the footnote mark should appear. There has to be one <references />
somewhere in the source as well, usually towards the end of the page. This is where the text added by the <ref> tags will appear. For more info see the Wikipedia help page.
Illustrate Your Text
Add a single image, centered
[[File:KMail-kde4.png|250px|center]]
Note that you can change the position of the image, but the default is left. The size of the image depends on the circumstances, but for screenshots I recommend no less than 250px and no more than 500px.
Also note that Image:
and File:
are synonyms.
So that [[Image:KMail-kde4.png]]
is the same as [[File:KMail-kde4.png]]
. However Image:
is deprecated, so prefer File:
in new content.
see mediawiki for more info.
Make the Image Clickable and Add a Caption
Where you need to show more detail, create a moderately sized image, clickable, so that the full-size can be seen. Simply add the parameter '|thumb' within the image parentheses.
A caption can also be added as a parameter, but will only show if '|thumb' is present.
Example:
[[File:file_name.png|thumb|this will be the caption]]
Add a caption without a thumbnail
Captions also appear on images marked up with the frame syntax.
Example:
[[File:image.png|frame|left|this will be the caption]]
Prevent text from flowing around image
Sometimes you might not want the text to flow down the sides of your image. You can prevent this by adding a <br clear=all>
tag between the file tag and the text in question.
Example:
[[File:image.png]] <br clear=all> This text would normally flow down the sides of the image but now it will be found under the image
Use Tables to Precisely Place Multiple Images
{|class="tablecenter" style="border: 1px solid grey;" |[[Image:Desktop-config-customized.png|230px|center]]||[[Image:Desktop-settings-rightclick.png|230px|center]] |- |[[Image:Desktop-theme-details-dialog.png|230px|center]]||[[Image:Plasma-multiple-themes.png|230px|center]] |}
displays
![]() |
![]() |
![]() |
![]() |
Note that all the parameters for one image are contained within [[...]], and cells are separated by '||'. To start a new line, insert '|-' on an otherwise-empty line, then '|' at the start of the next one.
For more details on Table formating see mediawiki
</translate> <translate>
Embed a Video
As of July 2012 the MediaWiki EmbedVideo extension has been installed on userbase.kde. This means you can embed videos from various video hosting sites into the page content and have them display in line.
EmbedVideo parser function expects to be called in any of the following ways:
{{#ev:service|id}}
{{#ev:service|id|width}}
{{#ev:service|id|width|align}}
{{#ev:service|id|width|align|desc}}
{{#evp:service|id|desc}}
{{#evp:service|id|desc|align}}
{{#evp:service|id|desc|align|width}}
Where:
service is the name of a video sharing service (See "service name" in the list below) id is the id of the video to include width (optional) is the width in pixels of the viewing area (height will be determined automatically) align (optional) is an alignment (float) attribute. May be "left" or "right". desc (optional) is a short description to display beneath the video when it is aligned
For example, to include the famous "evolution of dance" YouTube video, you'd enter:
{{#ev:youtube|dMH0bHeiRNg}}
And if you wanted scaled down to thumbnail size, on the right with a short description, you could use:
{{#ev:youtube|dMH0bHeiRNg|100|right|This is an embedded video!}}
As of version 1.0, EmbedVideo supports embedding video content from the following services:
Site | Service Name |
---|---|
Dailymotion | dailymotion |
Div Share | divshare |
Edutopia | edutopia |
FunnyOrDie | funnyordie |
Google Video | googlevideo |
Interia | interia or interiavideo |
Revver | revver |
sevenload | sevenload |
TeacherTube | teachertube |
YouTube | youtube and youtubehd |
Vimeo | vimeo |
</translate> <translate>
Add Notes and Warnings
Where a note or warning is relevant within your text, use these templates:
{{Info|This is general information}} displays
{{Note|Some important information at this point}} displays
{{Tip|A helpful piece of advice, something to remember}}displays
{{Warning|Take care - this is a dangerous thing to do}} displays
Where the strongest possible warning is needed, the Remember box can be used, but please use sparingly.
{{Remember|1=This is for things that definitely must not be forgotten}}
You can also change the heading:
Page Redirection
You can make a page to redirect to another page automatically by using:
#REDIRECT [[Pagename]]
KDE3 and KDE SC 4 Versions of Applications
By default, KDE SC 4 is assumed. If the KDE SC 4 version is not yet ready for release, or where only a KDE 3 version exists, it may be necessary to document the KDE3 version. In this case you should add the template {{KDE3}}
which displays
Should you be writing about a KDE3 version and KDE SC 4 version on the same page, use icons for both — {{KDE4}} which displays
Other Useful Templates
</translate><translate>
Inserting GUI Icons
The best way to refer to icons in the GUI is to display it in the text. This can be done with a template like this: {{Icon|list-add}}
. This will display the icon.
For this to work, the icon image must have been uploaded to the wiki. See Update an Image for an explanation on how to upload images. The .png files can usually be found here: usr/share/icons/oxygen. If possible use the 16x16 icon. The file name should have an Icon- prefix as in Icon-list-add.png — apart from the prefix the filename should exactly match the usual name. Note, that when using the template you should neither write the Icon- prefix nor the .png file type extension.
The icon can also be written as
{{Plus}}
, and the icon as
{{Minus}}
. You can also use {{Configure}}
to get the icon, and
{{Exit}}
gets you the icon.
Community Applications
The final consideration concerns those applications which are not distributed as core KDE applications. These need to be indicated by an icon, placing {{Community-app}}
at the end of your sentence or line, just as you would to denote a footnote in general writing. You then need to add {{Community-app-footnote}} which will create a footnote, like this:
Support for this application can be found from the project's home page
Making Major Edits to Existing Pages
If a page is likely to be open for editing for some time there is a danger of conflicts - someone else may edit at the same time, and saving your edit will cancel out theirs, or vice versa. The way to avoid that is to make a temporary entry, directly under the language bar, using {{Being_Edited}} which will display
Don't forget to remove it when you have finished!
Adding a New Complex Page
If you need to be able to work on a page for quite some time, over several days, for instance, you may like to use the Construction template - {{Construction}}, which displays
Links to Pages in the Neighbourhood
You can add links to a preceding or a following page using the {{Prevnext2}} template…
{{Prevnext2 | prevpage = Previous Pagename | nextpage = Following Pagename | prevtext = The page before this one | nexttext = The next page you should read | index = Index page | indextext = Back to Menu }}
…to produce helpful navigation links of the form…
All six arguments are optional, but keep in mind that if you don't specify a value for the indexname
parameter, the untranslated name of the current page will be displayed. For the first and last pages in a series, the template is most often used like this:
First page | Last page |
---|---|
{{Prevnext2 | nextpage = Following Pagename | nexttext = Read this page next | indextext = Tasks and Tools }} |
{{Prevnext2 | prevpage = Previous Pagename | prevtext = The page before this one | indextext = Tasks and Tools }} |
🡻 Output 🡻 | 🡻 Output 🡻 |
|
|
Links to bugs
You can link directly to a bug in Bugzilla by using this template:
{{Bug|123456}}
Please do not forget to add the <s> and </s>
to strike through a bug that is closed.
Adding a List of Sub-Pages
== Subpages of {{FULLPAGENAME}} == {{Special:PrefixIndex/{{FULLPAGENAME}}/}}
is very useful when you want to list subpages with active links, such as
Subpages of User:Claus chr/DPL
It does, however, also list all "other-language" pages, so use with discretion.
</translate>
- Okteta/Writing structure definitions
- Plasma/Tips
- Parley/Manual unstable
- Parley/Manual dev
- Parley/Manual
- Reference: DPL Manual
- See also Pipesmoker's notes and this page of examples
- Example UI on this Template:Catlist page
Searching for pages containing a certain text string
Matching content in pages: You need to include the contents of pages in this page (include = *
does that) and then do a perl-like regexp on their contents to filter interesting pages (includematch = ...
). If you are searching in translated pages (fx all Danish pages) it is often advantageous to have namespace = Translations
set; otherwise you will get both all full pages and all translation units containing matching text — that could be a very long output.
<DPL> titlematch = %/da namespace = Translations include = * includematch = /[Aa]pplikation/ includemaxlength = 0 resultsheader = Danish translation units containing the string "applikation" format = ,\n* [[%PAGE%|%TITLE%]]\n,, </DPL>
Searching for pages that hasn't been marked for translation
<DPL> nottitlematch = %/__|%/zh-%|%pt-%|%(%) namespace = Main include = * includenotmatch = /<languages/ includemaxlength = 0 resultsheader = Danish translation units containing the string "applikation" format = ,\n* [[%PAGE%|%TITLE%]]\n,, </DPL>
Find discussion threads contributed by a user
Perhaps more talk namespaces needs to be searched.
<DPL> namespace = Talk | Thread createdby = AmirHP </DPL>
All English manual pages
<DPL> titlematch = %/Manual% nottitlematch = %/__|%/__-__|%/___|% (% namespace = | User | Draft resultsheader = Manual Pages: format = ,\n* [[%PAGE%|%TITLE%]]\n,, </DPL>
All English pages linking to a given page
The LinksTo template is describes and tested here: User:Claus_chr/DPL/Test
Kopete Subpages in 3 columns
<DPL> titlematch = Kopete/% notnamespace = Translations columns = 3 format = ,\n* [[%PAGE%|%TITLE%]],, </DPL>
Akonadi Subpages in Danish
<DPL> titlematch = Akonadi%/da notnamespace = Translations format = ,\n* [[%PAGE%|%TITLE%]],, </DPL>
Archived pages
<DPL> titlematch = % namespace = Archive columns = 2 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% pages in the Archive namespace. These are:\n </DPL>
NoIndexed pages
<DPL> titlematch = % category = Noindexed_pages columns = 2 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% pages in the Archive namespace. These are:\n </DPL>
Ignoring Deleted Pages
"As for DPL. If you hit a page with ?action=purge attached to the URL (i.e. http://en.wikinews.org/wiki/Template:Latest_news?action=purge ), it will dump all the removed pages."
Remaining old-style translations
<DPL> titlematch = %_(%) notcategory = Template notnamespace = Thread notnamespace = Summary columns = 2 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% pages (partly) remaining in old-style translations. These are:\n </DPL>
Pages with old i18n bar
<DPL> titlematch = % namespace = Main uses = Template:I18n/Language Navigation Bar columns = 3 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% pages that still display the old i18n language bar\n </DPL>
Pages with old i18n bar but w/o old-way-translated ones
<DPL> nottitlematch = %_(%) namespace = Main uses = Template:I18n/Language Navigation Bar columns = 3 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% relevant pages that still display the old i18n language bar\n </DPL>
Pages not updated since 1st July 2010
<DPL> namespace = Main lastrevisionbefore = 201007010000 columns = 2 ordermethod=lastedit format = ,\n* (%DATE%) [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% pages without recent updates\n </DPL>
Listing Non-Translation Pages
<DPL> nottitlematch = %/__|%/zh-%|%(%) titlematch = Amarok% namespace = Main columns = 1 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% Amarok pages, not counting translations\n </DPL>
List all pages in a specific namespace
<DPL> nottitlematch = %/__|%/zh-%|%pt-%|%(%) namespace = MediaWiki columns = 3 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = These %TOTALPAGES% pages are in the Mediawiki namespace\n </DPL>
To count translated pages in a specific language:
<DPL> titlematch = %/en notnamespace = Translations columns = 3 format = ,\n* [[%PAGE%|%TITLE%]],, resultsheader = There are %TOTALPAGES% pages (partly) translated to English. These are:\n </DPL>