| 1 |
plessy |
198 |
[[!meta title="How to use dep.debian.net for your own proposals"]] |
| 2 |
adeodato |
9 |
|
| 3 |
|
|
Using dep.debian.net |
| 4 |
|
|
==================== |
| 5 |
|
|
|
| 6 |
|
|
You are welcome to maintain your DEP under the _dep.debian.net_ |
| 7 |
adeodato |
10 |
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 |
adeodato |
9 |
|
| 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 |
adeodato |
10 |
|
| 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 |
adeodato |
11 |
Non-subversion repositories |
| 44 |
|
|
=========================== |
| 45 |
adeodato |
9 |
|
| 46 |
adeodato |
11 |
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 |