Difference between revisions of "Source Repository Information"

From Creative Commons
Jump to: navigation, search
(Available Modules)
Line 1: Line 1:
 
[[Category:Developer]]
 
[[Category:Developer]]
  
Creative Commons uses Subversion repositories at Sourceforge and [[CcTools Berlios|Berlios.de]] for maintaining project source code.  Subversion (svn) clients are included with Linux and Mac OS X.  Windows users can use [http://tortoisesvn.tigris.org/ Tortoise SVN].
+
Creative Commons uses [http://subversion.tigris.org Subversion] and [http://git.or.cz/ Git] repositories at http://code.creativecommons.org for source code management.  Subversion (svn) clients are included with Linux and Mac OS X.  Windows users can use [http://tortoisesvn.tigris.org/ Tortoise SVN].
 +
 
 +
ccPublisher and some dependencies are still housed at [[CcTools Berlios|Berlios.de]]; those modules will be moving to code.creativecommons.org soon.
 +
 
 +
== Checking Out Source ==
 +
 
 +
=== code.creativecommons.org ===
 +
 
 +
We moved our primary source repository from Sourceforge.net to code.creativecommons.org in March, 2008.  Note that we only support public key authentication for our repositories.
 +
 
 +
==== Subversion====
 +
 
 +
* [http://code.creativecommons.org/viewsvn web view]
 +
* [http://code.creativecommons.org/svnroot read-only repository]
 +
* writeable checkout:
 +
      $svn co svn+ssh://svn@code.creativecommons.org/svnroot/project
 +
* write permission: email webmaster@creativecommons.org with your public key; if you had write permission at Sourceforge, please include your sourceforge.net username so we can map your key correctly.
 +
 
 +
==== Git====
 +
 
 +
* [http://code.creativecommons.org/viewgit web view]
 +
* read-only access:
 +
      $git clone git://code.creativecommons.org/cc.license.git
 +
* read/write access:
 +
      $git clone git@code.creativecommons.org:cc.license
 +
 
 +
=== Berlios.de ===
 +
 
 +
See the [http://developer.berlios.de/svn/?group_id=5272 ccTools Subversion Information] page for details on checking out code hosted at Berlios (ccPublisher).
  
 
== Available Modules ==
 
== Available Modules ==
  
The Sourceforge Subversion repository contains the following modules:
+
''Note that this list is somewhat outdated; as we move forward we're trying to write README files for modules to maintain documentation with the code.''
 +
 
 +
The Subversion repository contains the following modules:
  
 
<table align="left" valign="top" style="float:none;">
 
<table align="left" valign="top" style="float:none;">
Line 33: Line 63:
 
   <tr><td>__cvs_import      </td><td>Data from the import from CVS that was either deprecated, crufted, or wrong.</td></tr>
 
   <tr><td>__cvs_import      </td><td>Data from the import from CVS that was either deprecated, crufted, or wrong.</td></tr>
 
</table>
 
</table>
 
== Checking Out Source ==
 
 
=== From Sourceforge ===
 
 
The Sourceforge Subversion repository is accessed over https.  You can check out the entire repository (all projects, branches, tags, trunk and all; not recommended) with the following command:
 
 
  $ svn co https://cctools.svn.sourceforge.net/svnroot/cctools
 
 
For a particular project, we specify a specify module.  For example, the following command can be used to check out the trunk of CcHost into a directory named <code>cchost</code>:
 
 
  $ svn co https://cctools.svn.sourceforge.net/svnroot/cctools/cchost/trunk cchost
 
 
Note that a username and password is only required when performing a write operation to the repository.  Subversion will prompt for a password as needed.  If Subversion prompts for a password for the incorrect username, simply press Enter, and Subversion will prompt for the username.
 
 
=== From Berlios ===
 
 
See the [http://developer.berlios.de/svn/?group_id=5272 ccTools Subversion Information] page for details on checking out code hosted at Berlios (ccPublisher).
 

Revision as of 23:42, 24 March 2008


Creative Commons uses Subversion and Git repositories at http://code.creativecommons.org for source code management. Subversion (svn) clients are included with Linux and Mac OS X. Windows users can use Tortoise SVN.

ccPublisher and some dependencies are still housed at Berlios.de; those modules will be moving to code.creativecommons.org soon.

Checking Out Source

code.creativecommons.org

We moved our primary source repository from Sourceforge.net to code.creativecommons.org in March, 2008. Note that we only support public key authentication for our repositories.

Subversion

     $svn co svn+ssh://svn@code.creativecommons.org/svnroot/project
  • write permission: email webmaster@creativecommons.org with your public key; if you had write permission at Sourceforge, please include your sourceforge.net username so we can map your key correctly.

Git

     $git clone git://code.creativecommons.org/cc.license.git
  • read/write access:
     $git clone git@code.creativecommons.org:cc.license

Berlios.de

See the ccTools Subversion Information page for details on checking out code hosted at Berlios (ccPublisher).

Available Modules

Note that this list is somewhat outdated; as we move forward we're trying to write README files for modules to maintain documentation with the code.

The Subversion repository contains the following modules:

module name description
api Web services, generalized chooselicense.xsl implementation
api_client Sample client implementation
ccoer The code for some half-secret CC OER thing
cchost The code for ccmixter.org and other ccHost installations
cci Code for supporting iCommons web-sites; currently a Word Press theme. In development.
cclicense Potential portal page for licensing
cclookup CC Lookup
ccnutch Creative Commons plugin for the open source Nutch search engine
ccpublisher1 ccPublisher 1.x
ccpublisher2 ccPublisher 2 DEPRECATED Development for this project has moved to Berlios.de
ccrdf Python library for modeling licenses in RDF.
ccsearch Code for http://search.creativecommons.org
cctagutils
cli_tools Command-line based tools for embedding and reading licenses.
desktop_search Desktop search tools; Spotlight plugin for Mac OS X.
experimental Experimental code, i18n (internationalization), test, and miscellaneous bits
liblicense library and simple command line tool for empowering reading and writing of licenses all around the desktop
pyarchive Python library for uploading works to the Internet Archive
vendor_libs Vendor libraries that are used by other projects. Modules are imported here if the project doesn't use svn, so we can use svn:externals, or if additional customization is required.
widgets Widgets for visualizing CC content and information.
xmp Tools for embedding XMP metadata in PDF, JPEG and (future) other file types.
zope_products CC developed zope products: the license engine, Plone skin and iStr.
__cvs_import Data from the import from CVS that was either deprecated, crufted, or wrong.