Commit 0cf12340 authored by Christoph Cullmann's avatar Christoph Cullmann

remove the KDE 4 instructions, this is really no longer a good idea

parent 8332c93f
......@@ -9,10 +9,6 @@ zakra_page_header:
- "1"
---
For information how to build Kate 4.x (KDE 4.x based), please refer to the [Get It – KDE 4.x page][1].
This page will handle the case of the current KF5 based Kate.
<img class="aligncenter size-full wp-image-1395" style="display: inline-block; min-width: 20px !important; min-height: 20px !important; border: 1px solid rgba(0, 0, 0, 0.1) !important; background: #ffffff url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAAAAACoWZBhAAAABGdBTUEAALGPC/xhBQAAAAJiS0dEAP+Hj8y/AAAAB3RJTUUH3wwIAAgyL/YaPAAAACJJREFUCFtjfMbOAAQ/gZiFnQPEBAEmGIMIJgtIL8QEgtoAIn4D/96X1KAAAAAldEVYdGRhdGU6Y3JlYXRlADIwMTUtMTItMDhUMDA6MDg6NTArMDM6MDAasuuJAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDE1LTEyLTA4VDAwOjA4OjUwKzAzOjAwa+9TNQAAAABJRU5ErkJggg==') repeat scroll 0% 0% !important;" title="Get It - From Sintel, Copyright Blender Foundation, CC Attribution 3.0" src="/wp-content/uploads/2010/07/get_it.jpg" alt="" width="704" height="160" srcset="/wp-content/uploads/2010/07/get_it.jpg 704w, /wp-content/uploads/2010/07/get_it-300x68.jpg 300w" sizes="(max-width: 704px) 100vw, 704px" />
### Building Kate from Sources on Linux {#linux}
......@@ -27,33 +23,33 @@ This quick howto explains how to build Kate without touching your stable KDE ins
libQt5Gui-devel libQt5DBus-devel libQt5Concurrent-devel libqt5-qtscript-devel libQt5Sql-devel ktexteditor-devel \
kactivities5-devel kiconthemes-devel kguiaddons-devel kcrash-devel kdoctools-devel kinit-devel kwindowsystem-devel \
kdbusaddons-devel kwallet-devel plasma-framework-devel kitemmodels-devel knotifications-devel threadweaver-devel knewstuff-devel</pre>
<p>
<strong>to install on Ubuntu and derivates: </strong>List of required packages:
</p>
<pre>qtbase5-dev qtscript5-dev
extra-cmake-modules plasma-framework-dev libkf5crash-dev libkf5config-dev libkf5activities-dev kinit-dev kdoctools-dev libkf5i18n-dev libkf5parts-dev libkf5guiaddons-dev libkf5iconthemes-dev libkf5jobwidgets-dev kio-dev libkf5texteditor-dev libkf5windowsystem-dev libkf5xmlgui-dev libgit2-dev</pre>
<p>
Optional:
</p>
<pre>libkf5wallet-dev libkf5service-dev libkf5itemmodels-dev libkf5notifications-dev libkf5threadweaver-dev libkf5newstuff-dev</pre>
<p>
<strong>to install on Fedora/RHEL/CentOs:</strong> List of required packages:
</p>
<pre>git cmake gcc-g++ extra-cmake-modules qt5-qtbase-devel qt5-qtscript-devel kf5-kiconthemes-devel kf5-kxmlgui-devel kf5-kwindowsystem-devel kf5-ktexteditor-devel kf5-kparts-devel kf5-kguiaddons-devel kf5-kinit-devel kf5-kdoctools-devel kf5-kcrash-devel kf5-kactivities-devel kf5-kdbusaddons-devel</pre>
<p>
Optional:
</p>
<pre>kf5-kwallet-devel kf5-knewstuff-devel kf5-threadweaver-devel kf5-kitemmodels-devel kf5-plasma-devel kf5-knotifications-devel libgit2-devel</pre>
</li>
<li>
create and change into a KDE development directory:<br /> <code>mkdir -p ~/kde/usr; cd ~/kde</code>
</li>
......@@ -71,16 +67,16 @@ cd kate</code><br /> <strong>NOTE:</strong> If you want to build KTextEditor (th
<blockquote>
<pre>cmake .. -DCMAKE_BUILD_TYPE=RelWithDebInfo -DCMAKE_INSTALL_PREFIX=~/kde/usr -DCMAKE_PREFIX_PATH=~/kde/usr</pre>
</blockquote>
<p>
For developing Kate, build it with debug support (if you have problems using gdb because of optimizations, swap Debug with DebugFull):
</p>
<blockquote>
<pre>cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=~/kde/usr -DCMAKE_PREFIX_PATH=~/kde/usr</pre>
</blockquote>
</li>
<li>
compile Kate:<br /> <code>make</code>
</li>
......@@ -105,9 +101,8 @@ To build the KF5 based Kate/KWrite you can follow the guide on [KDE on Windows
To build the KF5 based Kate/KWrite you can follow the guide on [KDE on Mac][6].
[1]: /get-it-kde-4-x/
[2]: https://phabricator.kde.org/differential/diff/create/
[3]: mailto:kwrite-devel@kde.org
[4]: irc://irc.kde.org/kate "Kate IRC Channel"
[5]: https://community.kde.org/Windows
[6]: https://community.kde.org/Mac#Building_KDE_Frameworks_based_software_on_Mac_OS_X
\ No newline at end of file
[6]: https://community.kde.org/Mac#Building_KDE_Frameworks_based_software_on_Mac_OS_X
---
title: Get It – KDE 4.x
author: Christoph Cullmann
type: page
date: 2015-06-07T14:09:28+00:00
---
<img class="aligncenter size-full wp-image-1395" title="Get It - From Sintel, Copyright Blender Foundation, CC Attribution 3.0" alt="" src="/wp-content/uploads/2010/07/get_it.jpg" width="704" height="160" srcset="/wp-content/uploads/2010/07/get_it.jpg 704w, /wp-content/uploads/2010/07/get_it-300x68.jpg 300w" sizes="(max-width: 704px) 100vw, 704px" />
### Building Kate from Sources
This quick howto explains how to build Kate without touching your stable KDE installation. Right now, Kate&#8217;s source code is located on <a title="Kate on git.kde.org" href="https://projects.kde.org/projects/kde/applications/kate/repository" target="_blank">git.kde.org</a>. To build Kate from git, you need KDE SC >= 4.8. Further,
1. make sure you have the following packages installed: **git** and the **kdelibs development package** (and CMake).
**to install on openSUSE:** `sudo zypper install git libkde4-devel libkactivities-devel libqjson-devel python-kde4-devel`
**to install on Ubuntu and derivates:** `sudo apt-get install g++ make git cmake kdelibs5-dev libqjson-dev python-kde4-dev python-qt4-dev`
**to install on Arch Linux:** `pacman -S git automoc4 cmake kdebindings-python (installation with base-devel + kde)`
**to install on RHEL:** `yum install gcc-c++ kdelibs-devel kactivities-devel qjson-devel sip-devel PyKDE4-devel`
**to install on Fedora:** `yum install gcc-c++ kdelibs-devel kactivities-devel qjson-devel sip-devel pykde4-devel git-core`
2. create and change into a KDE development directory:
`mkdir -p ~/kde/usr; cd ~/kde`
3. get a copy of the Kate code and switch to the KDE 4.14 branch:
`git clone git://anongit.kde.org/kate<br />
cd kate<br />
git checkout KDE/4.14`
4. create and change into a build directory inside the kate directory for compilation:
m`kdir build; cd build`
5. Use a run.sh script as shown below to set the right environment variables, else make install might fail later.
6. run the configure process with cmake: (-DBUILD_KTEXTEDITOR=1 will install new ktexteditor interfaces from kate.git, otherwise, you need up-to-date kdelibs)
For just using Kate, build it optimized but with debugging symbols to get useful backtraces for bugreports:</p>
> <pre>cmake .. -DBUILD_KTEXTEDITOR=1 -DCMAKE_BUILD_TYPE=RelWithDebInfo \
-DCMAKE_INSTALL_PREFIX=~/kde/usr \
-DINSTALL_PYTHON_FILES_IN_PYTHON_PREFIX=OFF</pre>
For developing Kate, build it with debug support (if you have problems using gdb because of optimizations, swap Debug with DebugFull):
> <pre>cmake .. -DBUILD_KTEXTEDITOR=1 -DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_INSTALL_PREFIX=~/kde/usr \
-DINSTALL_PYTHON_FILES_IN_PYTHON_PREFIX=OFF</pre>
7. compile Kate:
`make`
8. finally install Kate:
`make install`
This installs Kate locally into the separate directory `~/kde/usr`, so that your global KDE installation will not be touched at all.
9. Now on to starting the newly compiled Kate. Create a file `~/kde/run.sh` with the following content:
> <pre>#!/bin/bash
export KATE_DIR=~/kde/usr
export PATH=$KATE_DIR/bin:$PATH
export LD_LIBRARY_PATH=$KATE_DIR/lib:$KATE_DIR/lib64:$LD_LIBRARY_PATH
export KDEDIR=$KATE_DIR
export KDEDIRS=$KDEDIR
export XDG_DATA_DIRS=$XDG_DATA_DIRS:$KATE_DIR/share
# update KDE's system configuration cache
kbuildsycoca4
# start app
$@</pre>
Make the script executable with `chmod 755 ~/kde/run.sh`. Now you can run the compiled Kate version with `~/kde/run.sh kate`. Just calling kate directly will start the system version of Kate.</li> </ol> </ol> </ol>
Your copy of Kate contains all of the Kate code, i.e.: the KTextEditor interfaces, Kate Part, KWrite and the Kate Application. You can keep your copy up-to-date by typing `` `git pull --rebase` `` in `~/kde/kate`. Feel free to send patches to our mailing list [`kwrite-devel@kde.org`][1]. And join [`#kate` on `irc.kde.org`][2] :–)
### Building the Kate Handbook
The current stable version of the Kate Handbook is available on the <a title="Kate Handbook" href="http://docs.kde.org/stable/en/applications/kate/index.html" target="_blank">KDE documentation webpage</a>. We very much welcome any updates to improve the Kate&#8217;s documentation. The source of the documentation is in the &#8220;doc&#8221;-subfolder. To create the final html pages, switch to the &#8220;doc&#8221;-folder and first create a folder called &#8220;html/kate&#8221; and &#8220;html/kwrite&#8221;. Here all the html ouput of the *.docbook files will be generated. Then use meinproc4 to generate the html ouput:
> <pre>mkdir -p html/kate
mkdir -p html/kwrite
# build Kate documentation
cd html/kate
meinproc4 --check ../../kate/index.docbook
# or build KWrite documentation
cd html/kwrite
meinproc4 --check ../../kwrite/index.docbook</pre>
After a short moment the generation of the documentation will be finished. Then point your web browser e.g. to ~/kde/kate/doc/html/kate/index.html to view the result. We are very happy for every patch!
### Building the API Documentation
Creating the API documentation for the KTextEditor interfaces works by entering the following commands:
> <pre>cd kate/ktexteditor
/path/to/kdelibs/doc/api/doxygen.sh --recurse \
--doxdatadir=/path/to/kdelibs/doc/common ./</pre>
The API documentation is then generated into the subfolder kate/ktexteditor/ktexteditor-apidocs.
[1]: mailto:kwrite-devel@kde.org
[2]: irc://irc.kde.org/kate "Kate IRC Channel"
\ No newline at end of file
......@@ -15,11 +15,9 @@ In the last months, I didn&#8217;t get much time to work on Kate nor KTextEditor
Guess one of the main issues is, I don&#8217;t use the KF5 based version of Kate that much ATM. At home, it is the only editor I use, but I have not much time to hack at home anyway.
Therefore today I installed the same setup on my work machine and will now use the KF5 based Kate for all of my day job, perhaps that motivates me more to take a look at the issues the Qt5/KF5 port still has.
Therefore today I installed the same setup on my work machine and will now use the KF5 based Kate for all of my day job, perhaps that motivates me more to take a look at the issues the Qt5/KF5 port still has.
(And I will work in a KDE Plasma 5 session with most stuff KF5 based now, including all important stuff like the nice Konsole ;=)
First update: The [Get It][1] page got an update to show how to install KF5 based Kate/KWrite from kate.git on openSUSE 13.2 ;) Feel free to send in the needed hints for other distros (to kwrite-devel@kde.org).
The installation hints for KDE 4.x based Kate got moved to [Get It &#8211; KDE 4.x][2], to keep them intact!
First update: The [Get It][1] page got an update to show how to install KF5 based Kate/KWrite from kate.git on openSUSE 13.2 ;) Feel free to send in the needed hints for other distros (to kwrite-devel@kde.org).
[1]: /get-it/
[2]: /get-it-kde-4-x/
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment