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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
#use wml::debian::template title="Hvordan www.debian.org er organiseret"
#use wml::debian::translation-check translation="6d9ec7201dcfa229e0cdf7f93c34b3d4a8509ebe"
#use wml::debian::toc
<p>Debians <em>"webtræ"</em>, en samling mapper og filer som udgør vores
websted, befinder sig i mappen <tt>/org/www.debian.org/www</tt> på
www-master.debian.org. Størstedelen af siderne er normale, statiske HTML-filer
(dvs. ikke fremstillet dynamisk ved hjælp af for eksempel et CGI- eller
PHP-script), fordi webstedet spejles.</p>
<p>Webstedet genereres på en af tre måder:</p>
<ul>
<li>størstedelen genereres ved hjælp af WML, fra
<a href="$(DEVEL)/website/using_git">Git-arkivet <q>webwml</q></a></li>
<li>dokumentationen genereres ved hjælp af enten DocBook XML (DebianDoc SGML
udfases), fra <a href="$(DOC)/vcs"><q>ddp</q>'s git-arkiv</a>; eller ved
hjælp af <a href="#scripts">cronskripter</a>, fra de tilsvarende
Debian-pakker.</li>
<li>dele af webstedet genereres ved hjælp af scripts som anvender andre
kilder, for eksempel siderne til tegnelse eller ophævelse af abonnemenet
på postlister</li>
</ul>
<p>En automatisk opdatering (fra Git-arkivet og andre kilder til webtræet)
kører seks gange i døgnet.</p>
<p>Hvis du har lyst til at bidrage til webstedet, skal du <strong>ikke</strong>
bare tilføje eller redigere filer i mappen <code>www/</code>. Kontakt først
<a href="mailto:webmaster@debian.org">webmasterne</a>.</p>
<p>Alle filer og mapper ejes af gruppen debwww og er skrivbare af den
gruppe, så webteamet kan redigere filerne i webmappen. 'Mode 2775' på
mapper betyder at enhver fil oprettet i den mappe vil arve gruppen - i
dette tilfælde debwww. Alle i gruppen debwww forventes at sætte
'<code>umask 002</code>' så filerne oprettes med skriverettigheder.</p>
<toc-display />
<hrline />
<toc-add-entry name="look">Ens udseende</toc-add-entry>
<p>Vi giver siderne det samme udseende ved at lade
<a href="https://packages.debian.org/unstable/web/wml">WML</a> tage sig af
det detajlerede arbejde med at tilføje sidehoveder og -fødder til siderne.
Selvom en .wml-side kan ligne HTML ved første øjekast, er HTML kun en form for
ekstra oplysninger som kan anvendes i en .wml-fil. Efter WML er færdig med at
køre sine filtre på en fil, er det færdige resultat ægte HTML. For at give dig
et indtryk af styrken ved WML, kan man for eksempel bruge Perl-kode i en side
hvilket betyder at man kan lave hvad som helst, eller næsten hvad som helst.</p>
<p>Bemærk dog, at WML kontrollerer (og nogle gange automagisk korrigerer) den
mest grundlæggende korrekthed af din HTML-kode. Du bør installere
<a href="https://packages.debian.org/unstable/web/weblint">weblint</a>
og/eller
<a href="https://packages.debian.org/unstable/web/tidy">tidy</a> til at
validere din HTML-kode.</p>
<p>For tiden følger vore websider standarden
<a href="http://www.w3.org/TR/html4/">HTML 4.01 Strict</a>.</p>
<p>Alle der arbejder på mange sider bør installere WML så de kan sikre sig at
resultatet er som de ønsker. Hvis du kører Debian kan du nemt installere pakken
<code>wml</code>. Læs siderne om <a href="using_wml">brug af WML</a> for flere
oplysninger.</p>
<toc-add-entry name="sources">Kildekode</toc-add-entry>
<p>Kildekoden til websiderne gemmes i Git. Git er et versionsstyringssystem som
giver os mulighed for at føre en log over hvad, hvem, hvornår og hvorfor en
ændring blev foretaget, osv. Det er en sikker måde at kontrollere den løbende
redigering af kildekode-filer med mange forfattere, noget der er vigtigt for os
fordi Debians webteam er temmeligt stort.</p>
<p>Hvis du ikke er vant til dette program, skal du læse siderne om
<a href="using_git">brug af Git</a>.</p>
<p>Den allerøverste webwml-mappe i CVS-arkivet indeholder mapper navngivet
efter de sprog webstedet oversættes til, to makefiler og flere scripts.
Oversættelsesmappernes navne skal være på engelsk og skrives med små
bogstaver (for eksempel <q>deutsch</q>, ikke <q>Deutsch</q>).
<p>Den vigtigste af de to makefiler er Makefile.common, der som navnet antyder
indeholder fælles regler som anvendes ved at inkludere filen i de andre
makefiler.</p>
<p>Alle sprogmapperne indeholder makefiler, WML-kildekodefiler og
undermapper. Filer og mapper har ikke forskellige navne, dette er for at
sikre at sprogs links er korrekte. Mapperne kan også indeholde .wmlrc-filer,
der indeholder oplysninger som WML anvender.</p>
<p>Mappen webwml/english/template indeholder specielle WML-filer som vi
kalder skabeloner (templates), fordi der refereres til dem fra andre filer ved
hjælp af kommandoen <code>#use</code>.
<p>For at ændringer til skabelonerne spreder sig til filerne som anvender dem,
har filerne makefile-betingelser. Da størstedelen af filerne anvender
"template"-skabelonen, ved øverst at indeholde linien
"<code>#use wml::debian::template</code>", er den standardiserede afhængighed
(den som alle filer anvender) den selvsamme skabelon. Der er selvfølgelig
undtagelser til denne regel.</p>
<toc-add-entry name="scripts">Skripter</toc-add-entry>
<p>Scriptene er for de flestes vedkommende skrevet i shell eller Perl. Nogle
af dem er fritstående, andre er integreret i WML-kildekodefiler.</p>
<p>Kildekoden til de primære www-master-genopbygningsscripts er i
<a href="https://salsa.debian.org/webmaster-team/cron.git">debwww/cron i
git-arkivet</a>.</p>
<p>Kildekoden til packages.debian.org-genopbygningsscriptene er i
<a href="https://salsa.debian.org/webmaster-team/packages">Git-arkivet
webwml/packages</a>.</p>
<toc-add-entry name="help">Hvordan du kan hjælpe til</toc-add-entry>
<p>Alle som er interesserede i at hjælpe os med at gøre Debians websted så godt
som muligt, er velkomne. Hvis du har værdifulde oplysninger relateret til
Debian som du mener mangler på vores sider, så
<a href="mailto:debian-www@lists.debian.org">del dem med os</a> og vi vil sørge
for at få dem tilføjet. Husk at skrive på engelsk.</p>
<p>Vi har altid brug for hjælp til at designe siderne (med hensyn til grafik og
layout), og også sørge for at vores HTML-kode er korrekt. Vi kører jævnligt
følgende kontroller mod hele vores websted:</p>
<ul>
<li><a href="https://www-master.debian.org/build-logs/urlcheck/">URL-kontrol</a>
<li><a href="https://www-master.debian.org/build-logs/validate/">wdg-html-validator</a>
<li><a href="https://www-master.debian.org/build-logs/tidy/">tidy</a>
</ul>
<p>Hjælp til at læse ovennævnte logfiler og rette problemerne, er altid
velkommen.</p>
<p>Webstedets aktuelle opbygnings-logfiler findes på
<url "https://www-master.debian.org/build-logs/">.</p>
<p>Hvis du forstår engelsk flydende, må du meget gerne læse korrektur på vores
engelsksprogede sider og rapportere alle fejl til
<a href="mailto:debian-www@lists.debian.org">os</a>.</p>
<p>Hvis du taler et andet sprog, har du måske lyst til at hjælpe os med at
oversætte sider til dit sprog. Hvis en oversættelse allerede findes, men
indeholder fejl, så kig på listen over
<a href="translation_coordinators">oversættelseskoordinatorer</a> og kontakt
dit sprogs koordinator for at få rettet fejlene. Hvis du selv har lyst til at
oversætte sider, så kig på siden om
<a href="translating">emnet</a> for flere oplysninger.</p>
<toc-add-entry name="nohelp">Hvordan man <strong>ikke</strong> hjælper</toc-add-entry>
<p><em>[Sp] Jeg ønsker at føje en <var>smart webting</var> til www.debian.org,
må jeg det?</em></p>
<p>[Sv] Nej. Vi ønsker at www.debian.org er så tilgængelig som muligt,
derfor</p>
<ul>
<li>ingen browser-specifikke "udvidelser".</li>
<li>ingen afhængighed af billeder alene. Billeder kan benyttes til at
uddybe, men oplysningerne på www.debian.org skal fortsat være
tilgængelige ved hjælp af en browser som Lynx, der kun kan vise
tekst.</li>
</ul>
<p><em>[Sp] Jeg har en denne her gode idé. Vil I slå FOO til i www.debian.org's
HTTPD?</em></p>
<p>[Sv] Nej. Vi ønsker at det skal være let for administratorer at spejle
www.debian.org, derfor ingen specielle HTTPD-funktioner, tak. Nej, heller ikke
SSI. En undtagelse har været nødvendig med hensyn til indholdsforhandling
(content negotiation) fordi det er den eneste robuste måde at kunne håndtere
mange sprog på.</p>
|
