Get Involved/development/IDE configuration/Kate: Difference between revisions

From KDE Community Wiki
(Use https://kate-editor.org/build-it/)
 
(Use flat)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
Kate is the feature-packed text editor from KDE.
Kate is the feature-packed text editor from KDE.


The official instructions web page for "Building Kate from Sources on Linux" is https://kate-editor.org/build-it/  
A screen recording version is available https://www.youtube.com/watch?v=WBWVTKEVkOU


The web page talks about how to build kate using kdesrc-build.
==kdesrc-build==


The web page also talks about how to configure the kate text editor in order to program/develop C++ source code projects:
Make sure kdesrc-build works correctly. Make sure ~/.config/kdesrc-buildrc contains the lines:
* Configure kdesrc-build to generate .kateproject project files.
 
* Configure kdesrc-build to generate the file compile_commands.json used by the clangd C++ LSP server.
{{Input|1=<nowiki>
* Enable the kate plugins: Project Plugin, LSP Client, Build Plugin.
cmake-options -G "Kate - Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug
# Build with LSP support for everything that supports it
compile-commands-linking true
compile-commands-export true
</nowiki>}}
 
Using kdesrc-build build a module. E.g.
{{Input|1=<nowiki>
kdesrc-build kcalc
</nowiki>}}
 
==kate==
 
See the web page "Building Kate from Sources on Linux" https://kate-editor.org/build-it/
 
The web page talks about how to build kate using kdesrc-build and how to configure kate.
 
In kate enable the plugins: Project Plugin, LSP Client, Build Plugin, GDB.
 
Some of the features available in kate:
 
* LSP Client Symbol Outline
* Right click in text editor on a C++ identifier > LSP Client > Go to Declaration/Find References/ Switch Source Header F12/ Symbol Info/ Search and Go to Symbol Ctrl+Alt+P/ Format/ Rename/ Switch to diagnostics tab/ Quickfix This menu is also available from kate main menu > LSP Client.
* kate main menu > Tools > External Tools > Git > git blame/ gitk
* kate main menu > Tools > External Tools > Tools > Clang Format Full File/ Search KDE/Qt API/ JSON/XML Format Full File.
 
===Build and debug===
 
====With the ".kateproject" file====
 
{{Input|1=<nowiki>
cd ~/kde/src/kcalc
ln -s ~/kde/build/kcalc/.kateproject ~/kde/src/kcalc/.kateproject
kate . &
</nowiki>}}
 
* Build. kate main menu > Build > Select Target... > Target Set > Working Directory should be "~/kde/build/kcalc", all of the CMake targets should be listed, > OK button. "Build Output" tool view > "Output" is shown. kate main menu > Build > Build Default Target.  
* Debugger. kate main menu > Debug > Targets > Target 1. kate main menu > View > Tool Views > Show Debug View > Settings tab > Executable > select "~/kde/build/kcalc/bin/kcalc". Click on source code line, from kate main menu > Debug > Toggle Breakpoint. kate main menu > Debug > Start Debugging. kate main menu > Debug > Continue/ Step Over/ Step In/ Step Out.
 
====Without the ".kateproject" file====
 
If we do not have a ".kateproject" file. Then:
* Build. kate main menu > Build > Select Target... > Target Set > Working Directory should be "~/kde/build/kcalc" > OK button. "Build Output" tool view > "Output" is shown. Change to tab "Target Settings" from tool view "Build Output" > double click on cell "Dir:" > select "~/kde/build/kcalc", press Enter. kate main menu > Build > Build Default Target.
* Debugger. kate main menu > Debug > Targets > Target 1. kate main menu > View > Tool Views > Show Debug View > Settings tab > Executable > select "~/kde/build/kcalc/bin/kcalc". Click on source code line, from kate main menu > Debug > Toggle Breakpoint. kate main menu > Debug > Start Debugging. kate main menu > Debug > Continue/ Step Over/ Step In/ Step Out.

Latest revision as of 18:10, 30 December 2022

Kate is the feature-packed text editor from KDE.

A screen recording version is available https://www.youtube.com/watch?v=WBWVTKEVkOU

kdesrc-build

Make sure kdesrc-build works correctly. Make sure ~/.config/kdesrc-buildrc contains the lines:

cmake-options -G "Kate - Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug
# Build with LSP support for everything that supports it
compile-commands-linking true
compile-commands-export true

Using kdesrc-build build a module. E.g.

kdesrc-build kcalc

kate

See the web page "Building Kate from Sources on Linux" https://kate-editor.org/build-it/

The web page talks about how to build kate using kdesrc-build and how to configure kate.

In kate enable the plugins: Project Plugin, LSP Client, Build Plugin, GDB.

Some of the features available in kate:

  • LSP Client Symbol Outline
  • Right click in text editor on a C++ identifier > LSP Client > Go to Declaration/Find References/ Switch Source Header F12/ Symbol Info/ Search and Go to Symbol Ctrl+Alt+P/ Format/ Rename/ Switch to diagnostics tab/ Quickfix This menu is also available from kate main menu > LSP Client.
  • kate main menu > Tools > External Tools > Git > git blame/ gitk
  • kate main menu > Tools > External Tools > Tools > Clang Format Full File/ Search KDE/Qt API/ JSON/XML Format Full File.

Build and debug

With the ".kateproject" file

cd ~/kde/src/kcalc
ln -s ~/kde/build/kcalc/.kateproject ~/kde/src/kcalc/.kateproject
kate . &
  • Build. kate main menu > Build > Select Target... > Target Set > Working Directory should be "~/kde/build/kcalc", all of the CMake targets should be listed, > OK button. "Build Output" tool view > "Output" is shown. kate main menu > Build > Build Default Target.
  • Debugger. kate main menu > Debug > Targets > Target 1. kate main menu > View > Tool Views > Show Debug View > Settings tab > Executable > select "~/kde/build/kcalc/bin/kcalc". Click on source code line, from kate main menu > Debug > Toggle Breakpoint. kate main menu > Debug > Start Debugging. kate main menu > Debug > Continue/ Step Over/ Step In/ Step Out.

Without the ".kateproject" file

If we do not have a ".kateproject" file. Then:

  • Build. kate main menu > Build > Select Target... > Target Set > Working Directory should be "~/kde/build/kcalc" > OK button. "Build Output" tool view > "Output" is shown. Change to tab "Target Settings" from tool view "Build Output" > double click on cell "Dir:" > select "~/kde/build/kcalc", press Enter. kate main menu > Build > Build Default Target.
  • Debugger. kate main menu > Debug > Targets > Target 1. kate main menu > View > Tool Views > Show Debug View > Settings tab > Executable > select "~/kde/build/kcalc/bin/kcalc". Click on source code line, from kate main menu > Debug > Toggle Breakpoint. kate main menu > Debug > Start Debugging. kate main menu > Debug > Continue/ Step Over/ Step In/ Step Out.