Difference between revisions of "KDE Frameworks/Getting Started/Source Code"

(Marked this version for translation)
Line 2: Line 2:
 
<translate>
 
<translate>
  
 +
<!--T:34-->
 
{{Construction|This is a rewrite of the Getting Stared pages for KF5 using kdesrc-build by John Layt}}
 
{{Construction|This is a rewrite of the Getting Stared pages for KF5 using kdesrc-build by John Layt}}
  
==Introduction==
+
==Introduction== <!--T:35-->
  
 +
<!--T:36-->
 
All KDE Software is free and open source. You are free to view, use and make changes to the code in line with the (L)GPL family of licences. This page describes how this source code is organised and how it can be obtained.
 
All KDE Software is free and open source. You are free to view, use and make changes to the code in line with the (L)GPL family of licences. This page describes how this source code is organised and how it can be obtained.
  
==Source Repositories and Revision Control==
+
==Source Repositories and Revision Control== <!--T:37-->
  
 +
<!--T:38-->
 
The KDE Community uses a central online Revision Control system to store all our Source Code and to track changes made to the code. The KDE Community uses [[Development/Git|Git]] for most [http://projects.kde.org KDE Projects], although some projects still use Subversion. Most developers will only need to use Git, although some familiarity with Subversion may occasionally be required.
 
The KDE Community uses a central online Revision Control system to store all our Source Code and to track changes made to the code. The KDE Community uses [[Development/Git|Git]] for most [http://projects.kde.org KDE Projects], although some projects still use Subversion. Most developers will only need to use Git, although some familiarity with Subversion may occasionally be required.
  
==Browsing The Code==
+
==Browsing The Code== <!--T:39-->
  
 +
<!--T:40-->
 
There are a number of ways to browse or search the code online:
 
There are a number of ways to browse or search the code online:
  
 +
<!--T:41-->
 
* https://projects.kde.org/projects is a list of all KDE Projects, choose a project and then click on Repository to browse the source
 
* https://projects.kde.org/projects is a list of all KDE Projects, choose a project and then click on Repository to browse the source
 
* https://quickgit.kde.org/ is an alternative online code browser for code in Git repositories
 
* https://quickgit.kde.org/ is an alternative online code browser for code in Git repositories
Line 23: Line 28:
 
* http://api.kde.org lets you browse or search the API documentation generated from the code
 
* http://api.kde.org lets you browse or search the API documentation generated from the code
  
==Obtaining The Source Code==
+
==Obtaining The Source Code== <!--T:42-->
  
 +
<!--T:43-->
 
TODO: Detailed instructions or link to existing???
 
TODO: Detailed instructions or link to existing???
  
 +
<!--T:44-->
 
There are three main ways to download a copy of the source code:
 
There are three main ways to download a copy of the source code:
  
 +
<!--T:45-->
 
* Directly access the Source Repository to copy the source code as it currently is with a full history of all changes.  In '''Git''' this is know as ''Cloning the repository'', in '''Subversion''' it is ''Checking-Out the code''.  This is most commonly done if you want to actively develop the code.
 
* Directly access the Source Repository to copy the source code as it currently is with a full history of all changes.  In '''Git''' this is know as ''Cloning the repository'', in '''Subversion''' it is ''Checking-Out the code''.  This is most commonly done if you want to actively develop the code.
 
* Download a tarball snapshot of the Source Repository to bootstrap a '''Git''' clone or '''Subversion''' checkout.  This is a good option if you have a slow or unreliable internet connection.  See the [[/Snapshots|Source Snapshots]] page for more details.
 
* Download a tarball snapshot of the Source Repository to bootstrap a '''Git''' clone or '''Subversion''' checkout.  This is a good option if you have a slow or unreliable internet connection.  See the [[/Snapshots|Source Snapshots]] page for more details.
 
* Download a tarball snapshot of just the code as at a given time or release.  This is most commonly done if you do not want to develop the code itself but just want to use it for a stable system installation, testing a release, or developing applications outside of the KDE Community.
 
* Download a tarball snapshot of just the code as at a given time or release.  This is most commonly done if you do not want to develop the code itself but just want to use it for a stable system installation, testing a release, or developing applications outside of the KDE Community.
  
 +
<!--T:46-->
 
Note that "Checkout" has a different meaning in '''Git''' than it does in '''Subversion'''.
 
Note that "Checkout" has a different meaning in '''Git''' than it does in '''Subversion'''.
  
== OLD Stuff To Be Reworked ==
+
== OLD Stuff To Be Reworked == <!--T:47-->
  
 
==== KDE Base Applications ==== <!--T:23-->
 
==== KDE Base Applications ==== <!--T:23-->
Line 87: Line 96:
  
  
 +
<!--T:48-->
 
[[Category:Getting Started]]
 
[[Category:Getting Started]]
 
</translate>
 
</translate>

Revision as of 12:21, 5 March 2016

Other languages:
English
Under construction.png
 
Under Construction
This is a new page, currently under construction!


Introduction

All KDE Software is free and open source. You are free to view, use and make changes to the code in line with the (L)GPL family of licences. This page describes how this source code is organised and how it can be obtained.

Source Repositories and Revision Control

The KDE Community uses a central online Revision Control system to store all our Source Code and to track changes made to the code. The KDE Community uses Git for most KDE Projects, although some projects still use Subversion. Most developers will only need to use Git, although some familiarity with Subversion may occasionally be required.

Browsing The Code

There are a number of ways to browse or search the code online:

Obtaining The Source Code

TODO: Detailed instructions or link to existing???

There are three main ways to download a copy of the source code:

  • Directly access the Source Repository to copy the source code as it currently is with a full history of all changes. In Git this is know as Cloning the repository, in Subversion it is Checking-Out the code. This is most commonly done if you want to actively develop the code.
  • Download a tarball snapshot of the Source Repository to bootstrap a Git clone or Subversion checkout. This is a good option if you have a slow or unreliable internet connection. See the Source Snapshots page for more details.
  • Download a tarball snapshot of just the code as at a given time or release. This is most commonly done if you do not want to develop the code itself but just want to use it for a stable system installation, testing a release, or developing applications outside of the KDE Community.

Note that "Checkout" has a different meaning in Git than it does in Subversion.

OLD Stuff To Be Reworked

KDE Base Applications

The KDE Base Applications group is defined as those basic applications that are required by the Workspace and other Applications, such as file management, terminal emulation and text editing.

The KDE Base Applications are available from Git:

KDE Applications

The KDE Applications group is defined as those KDE modules built on the KDE Development Platform that are hosted by the KDE infrastructure and are released as part of the regular KDE Release Cycle, i.e. they are part of the KDE SC.

The KDE Applications group is currently split between Git and SVN:


This page was last edited on 5 March 2016, at 12:21. Content is available under Creative Commons License SA 4.0 unless otherwise noted.