blob: a764031eeee3d7589d700fee9cab4a0769596920 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
# How to Contribute to This Wiki
There are essentially three possibilities. They are outlined below.
Some general hints; just as in software projects:
* Do independent changes *separately*: don't aggregate changes that don't
belong together.
* Install your changes *early* and *often*: don't hold your contribution back
until you think it is perfect.
If you are editing the source files from a git checkout you can nevertheless
have them get rendered to html pages:
$ wiki/render_locally
[...]
scanning HowToContributeToThisWiki.mdwn
rendering HowToContributeToThisWiki.mdwn
Now open `wiki.rendered/index.html' to browse the wiki pages.
## Edit Via the Web Interface
When you found a page you want to work on, just follow the *Edit* link on the
top of the page. When doing this for the first time, this will first transfer
you to a page where you have to create a wiki account. After logging in, you
can edit the wiki pages.
## Do an Anonymous Checkout of the git Repository
*Not yet available.*
Check out the wiki.
$ git clone git://flubber.bddebian.com/wiki [dest]
If you omit *[dest]* it will default to *wiki*.
Then you can work on these files.
$ cd wiki/
$ emacs Hurd/NextHurd.mdwn
$ git commit Hurd/NextHurd.mdwn
Finally publish your changes.
$ [TODO]
## Do a Read-write Checkout of the git Repository
For being able to do that you need a
[[shell_account_on_*flubber*|Hurd/PublicHurdBoxen]]. (It's very much
recommenable that you set up your local *ssh* configuration as advised on that
page.)
Check out the wiki.
$ git clone flubber:~wiki/wiki [dest]
If you omit *[dest]* it will default to *wiki*.
Then you can work on these files.
$ cd wiki/
$ emacs Hurd/NextHurd.mdwn
$ git commit Hurd/NextHurd.mdwn
Finally install your changes.
$ git push
|