On the top the Documents list has a toolbar with the following buttons:
|Create new document|
|Open an existing document|
|Save the current document|
|Save the current document under a new name|
By default, the Documents list appears in , which displays the folder structure surrounding all currently open documents. Also available is , which displays a simple list of all open documents. You can switch modes by right-clicking on the list and selecting from the menu.
If two or more files with the same name (located in different folders) are open in , the names of the second will be prepended “(2)” and so on. The tool-tip for the file will display its full name including the path, allowing you to choose the desired one.
To display a document in the currently active frame, click the document name in the list.
The context menu has some common actions from the menu.
Additionally there are filemanager actions to rename or delete the file. With you can copy the full path of the document to the clipboard.
You can sort the list in a few different ways by right clicking the list and selecting from the menu. The options are:
Lists the documents alphabetically by their name.
Lists the documents alphabetically by the path to them.
Lists the documents in the order of opening.
The document list will per default visualize your history by shading the entries for the most recent documents with a background color. If the document was edited, an extra color is blended in. The most recent document has the strongest color, so that you can easily find the documents you are working on. This feature can be disabled in the Documents page of the configuration dialog.
The default location of the document list in the Kate window is to the left of the editing area.
- Background Shading
This section allows you to enable or disable the background shading visualization of your recent activity, and choose which colors to use if enabled.
- Sort By
Set how you want the document list sorted. This can be set from themouse button menu in the document list as well.
- View Mode
This provides two options that effect the display of the Documents tool view. The Tree View option will display the documents in a tree underneath the folders they are in, while the List View option will display a flat list of documents.
- Show Full Path
When Tree View and this option are enabled, the folder entries displayed in the Documents tool view will display the full filesystem path to the folder in addition to the name of the folder. It has no effect in List View.
- Show Toolbar
When Tree View and this option are enabled, a toolbar with actions like is displayed above the list of documents. Uncheck this option if the toolbar should be hidden.
- Show Close Button
When this option is enabled, Kate will show a close button for opened documents on hover.