dep/web/depdn-howto.mdwn

[[!meta title="How to use dep.debian.net for your own proposals"]]

Using dep.debian.net
====================

You are welcome to maintain your DEP under the _dep.debian.net_
namespace. This is attached to the _dep_ Alioth project, to which all
developers have write access to, and it runs [ikiwiki][] with a
Subversion repository underneath it. To add your DEP:

  1. `svn checkout svn+ssh://svn.debian.org/svn/dep/web`
  2. commit a file named _depN.mdwn_ under `web/deps`

  [ikiwiki]: http://ikiwiki.info

The file is in Markdown format, which basically means that plain text
will format nicely, and for extra goodies you can consult [this brief
help][syntax1], or the full [Markdown syntax documentation][syntax2].
The only caveat is for the first paragraph: please indent all of its
lines with 4 spaces, so that it gets treated as &lt;pre>; see e.g.
[dep0.mdwn][].

  [syntax1]: http://ikiwiki.info/ikiwiki/formatting/index.html
  [syntax2]: http://daringfireball.net/projects/markdown/syntax
  [dep0.mdwn]: http://svn.debian.org/viewsvn/*checkout*/dep/web/deps/dep0.mdwn

There is also a [dep-commits mailing list][ml].

  [ml]: http://lists.alioth.debian.org/mailman/listinfo/dep-commits


Without ikiwiki
===============

If you'd just like space under Subversion, without having to care about
ikiwiki at all, create and use a _depN_ subdirectory under
`svn.debian.org/dep/playground`. Then, you could use a URL like this for
your DEP:

      http://svn.debian.org/viewsvn/*checkout*/dep/playground/dep17/dep17.txt


Non-subversion repositories
===========================

The _dep_ project in Alioth also provides space for Bazaar, Darcs, Git
and Mercurial repositories. To make use of them, log into alioth and
create a _file:///$VCS/depN_ **directory**, and place as many branches
or repositories as you need under it. You can then use the appropriate
`http://$VCS.debian.org` URL that will provide a plain text copy of the
latest version as the URL for your DEP. (**TODO**: provide those URLs.)

#### TODO

  * I think it would be great if we could integrate those VCSen spaces
    with ikiwiki somehow. No idea how, though. -- Dato
1	[[!meta title="How to use dep.debian.net for your own proposals"]]
2
3	Using dep.debian.net
4	====================
5
6	You are welcome to maintain your DEP under the _dep.debian.net_
7	namespace. This is attached to the _dep_ Alioth project, to which all
8	developers have write access to, and it runs [ikiwiki][] with a
9	Subversion repository underneath it. To add your DEP:
10
11	1. `svn checkout svn+ssh://svn.debian.org/svn/dep/web`
12	2. commit a file named _depN.mdwn_ under `web/deps`
13
14	[ikiwiki]: http://ikiwiki.info
15
16	The file is in Markdown format, which basically means that plain text
17	will format nicely, and for extra goodies you can consult [this brief
18	help][syntax1], or the full [Markdown syntax documentation][syntax2].
19	The only caveat is for the first paragraph: please indent all of its
20	lines with 4 spaces, so that it gets treated as <pre>; see e.g.
21	[dep0.mdwn][].
22
23	[syntax1]: http://ikiwiki.info/ikiwiki/formatting/index.html
24	[syntax2]: http://daringfireball.net/projects/markdown/syntax
25	[dep0.mdwn]: http://svn.debian.org/viewsvn/checkout/dep/web/deps/dep0.mdwn
26
27	There is also a [dep-commits mailing list][ml].
28
29	[ml]: http://lists.alioth.debian.org/mailman/listinfo/dep-commits
30
31
32	Without ikiwiki
33	===============
34
35	If you'd just like space under Subversion, without having to care about
36	ikiwiki at all, create and use a _depN_ subdirectory under
37	`svn.debian.org/dep/playground`. Then, you could use a URL like this for
38	your DEP:
39
40	http://svn.debian.org/viewsvn/checkout/dep/playground/dep17/dep17.txt
41
42
43	Non-subversion repositories
44	===========================
45
46	The _dep_ project in Alioth also provides space for Bazaar, Darcs, Git
47	and Mercurial repositories. To make use of them, log into alioth and
48	create a _file:///$VCS/depN_ directory, and place as many branches
49	or repositories as you need under it. You can then use the appropriate
50	`http://$VCS.debian.org` URL that will provide a plain text copy of the
51	latest version as the URL for your DEP. (TODO: provide those URLs.)
52
53	#### TODO
54
55	* I think it would be great if we could integrate those VCSen spaces
56	with ikiwiki somehow. No idea how, though. -- Dato