blob: 6f99e4c039692069bf7e91d7bc278f38635f97b9 (
plain) (
blame)
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
|
#use wml::debian::ddp title="Polityka dokumentacji DDP"
#use wml::debian::translation-check translation="1.13"
<p>
Ta instrukcja jest trochę przeterminowana i na
<a href="http://lists.debian.org/debian-doc/">liście dyskusyjnej
debian-doc</a> czynione są starania aby
to poprawić. Zapoznaj się z aktualnym szkicem
<a href="manuals/ddp-policy/ddp-policy">nowej polityki</a>.</p>
<p>Poniżej znajduje się lista decyzji podjętych na naszej liście
dyskusyjnej. Uzyskała ona akceptację Menadżera Dokumentacji, Susan G.
Kleinmann.
<br>
<ul>
<li>Wszystkie podręczniki należące do Debian Documentation Project
(DDP) będą publikowane pod licencjami zgodnymi z DFSG, najcześciej
GPL.
<br>
<li>Będziemy używać następującej struktury katalogów:
<p>System plików:
<pre>
/usr/share/doc/manuals/<var>somemanual</var>/index.html
/usr/share/doc/manuals/<var>somemanual</var>.ps.gz (optional)
</pre>
<p>Serwer WWW:
<pre>
http://www.debian.org/doc/manuals/<var>somemanual</var>/
</pre>
<p>Serwer FTP:
<pre>
http://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.html.tar.gz
http://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.text.gz
http://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.dvi.gz
http://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.ps.gz
http://ftp.debian.org/debian/doc/manuals/<var>somemanual</var>.sgml.tar.gz
</pre>
<p>Proszę zauważyć, że ta cześć polityki nie została jeszcze globalnie
zaakceptowana, niektóre adresy mogą więc nie działać. Prawdziwe położenie
dokumentów może się zmieniać celem zachowania wstecznej kompatybilności.
<br>
<li>Jako formatu źródłowego będziemy używać SGMLa.
<p>Proszę zauważyć, że to nie oznacza potrzeby nauki SGMLa przez
użytkowników celem zgłoszenia zmiań w dokumencie. Wszystkie formaty są
przez nas akceptowane. Jakkolwiek, zostaną przekonwertowane w SGMLa
przez kogoś z Debian-Doc.
<p><small>Innymi opcjami były: LaTeX, HTML, Texingo oraz kilka innych
mało znaczących formatów.</small>
<br>
<li>Będziemy używać <strong>debiandoc-sgml</strong> dla naszych
dokumentów.
<p><small>Innymi opcjami były: linuxdoc-sgml oraz DocBook. Linuxdoc nie
jest już rozwijany; DocBook jest napiętnowany przez wielu jako rozwiązanie
zbyt duże, zbyt skomplikowane i trudne do konfiguracji.</small>
<br>
<li>Każdy dokument Debiana będzie miał wymienionego jednoosobowego
<em>Opiekuna</em> oraz możliwość posiadania dodatkowo <em>
Współopiekunów</em>.
</ul>
|
