/[dep]/web/depdn-howto.mdwn
ViewVC logotype

Contents of /web/depdn-howto.mdwn

Parent Directory Parent Directory | Revision Log Revision Log


Revision 198 - (hide annotations) (download)
Sat Jul 23 09:11:41 2011 UTC (22 months ago) by plessy
File size: 2147 byte(s)
Ikiwiki 3.0 transition again.
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

  ViewVC Help
Powered by ViewVC 1.1.5