aboutsummaryrefslogtreecommitdiffstats
path: root/swedish/devel/website/desc.wml
blob: 4e582e3ae8b7745d717fd9f2bc50df412e34a678 (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
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
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
#use wml::debian::template title="Hur www.debian.org är uppbyggt"
#use wml::debian::translation-check translation="b71e318d7035342144f073c15e0f275ded4ac220"
#use wml::debian::toc

<p>
Debians <em>&rdquo;webbträd&rdquo;</em>, eller samlingen av kataloger och
filer som utgör vår webbplats, lagras i katalogen
<tt>/org/www.debian.org/debian.org</tt> på www-master.debian.org.
Merparten av sidorna är vanliga statiska HTML-dokument (dvs. inte genererade
med något dynamiskt såsom CGI- eller PHP-program), eftersom webbplatsen
speglas.
</p>

<p>Debians webbsidor genereras på ett av tre sätt:
</p>

<ul>
  <li>huvuddelen genereras med WML från
      <a href="$(DEVEL)/website/using_git">git-förrådet <q>webwml</q></a>
  <li>dokumentationen genereras antingen med hjälp av DocBook XML
      (användande av DebianDoc-SGML fasas ut) från
      <a href="$(DOC)/cvs">subversion-arkivet <q>ddp</q></a>; eller med hjälp
		av <a href="#scripts">cron-script</a>, från motsvarande Debianpaket.
  <li>delar av webbplatsen genereras av skript, t.ex
      sändlisteprenumerationssidorna
</ul>

<p>Automatiska uppdateringar (från git-förrådet och andra källor för
webbträdet) körs sex gånger varje dag.
</p>

<p>Om du vill bidra till webbplatsen skall du <strong>inte</strong> bara
lägga till eller redigera filer i <code>www/</code>-katalogen.
Kontakta
<a href="mailto:webmaster@debian.org">webbansvariga</a> först.
</p>

<p>Alla filer och kataloger ägs av gruppen debwww och är skrivbara av den
gruppen, så webbgruppen kan ändra filer i webbkatalogen.
2775-läget på katalogerna betyder att alla filer som skapas under den
katalogen ärver gruppen - debwww i det här fallet.
Alla i gruppen debwww förväntas sätta &rdquo;<code>umask 002</code>&rdquo; så att
filerna skapas med skrivrättigheter för gruppen.
</p>

<toc-display />
<hrline />

<toc-add-entry name="look">Gemensamt utseende</toc-add-entry>

<p>Vi ger sidorna ett gemensamt utseende genom att låta
<a href="https://packages.debian.org/unstable/web/wml">WML</a>
hantera alla detaljer, såsom att lägga till huvud och fot på sidorna.
Även om en .wml-sida kan se ut som html vid första titten, är HTML bara en
typ av extra information som läggas in i .wml-filerna.
När WML är har kört sina olika filter över filen är slutprodukten äkta HTML.
För att ge dig en aning om WMLs kraft så kan du lägga in Perlkod i en sida,
vilket tillåter dig att göra, tja, nästan vad som helst.
</p>

<p>Observera dock att WML endast kontrollerar (och ibland automagiskt
korrigerar) grundläggande riktighet i din HTML-kod.
Du bör installera
<a href="https://packages.debian.org/unstable/web/weblint">weblint</a>
och/eller
<a href="https://packages.debian.org/unstable/web/tidy">tidy</a>
för att kontrollera din HTML-kod.
</p>

<p>
Vår webbplats följer för närvarande standarden
<a href="http://www.w3.org/TR/html4/">HTML 4.01 Strict</a>.
Vi planerar dock att gå över till
<a href="http://www.w3.org/TR/xhtml1/">XHTML</a>. så alla
webbsidesredaktörer uppmanas å det bestämdaste att skriva HTML-märken med
små bokstäver, lägga in slutmärken när det passar, osv., för att göra
övergången så mjuk som möjligt.
</p>

<p>Alla som arbetar med ett stort antal sidor borde installera WML så att
de kan testa och vara säkra på att resultatet är det de önskar.
Om du använder Debian kan du väldigt enkelt installera
<code>wml</code>-paketet.
Läs sidorna om att <a href="using_wml">använda WML</a> för ytterligare
information.
</p>

<toc-add-entry name="sources">Källkod</toc-add-entry>

<p>Källkoden för webbsidorna lagras i git.
Git är ett versionshanteringssystem vilket gör det möjligt för oss att
upprätthålla loggar över av vilka, av vem, när, och varför ändringar
gjorts, osv.
Det är ett säkert sätt att kontrollera den parallella redigering av
källkodsfilerna som sker hos flera författare, vilket är avgörande för oss
eftersom Debians webbgrupp är rätt så omfattande.
</p>

<p>Om du inte är van vid detta program, bör du läsa sidorna om att
<a href="using_git">använda Git</a>.
</p>

<p>Den översta katalogen i Git-förrådet, webwml, innehåller kataloger som
namnges efter språket webbplatsen översätts till, två makefiler och flera
skript.
Översättningskatalogens namn bör vara på engelska och skrivas med små
bokstäver (t.ex &rdquo;german&rdquo;, inte &rdquo;Deutsch&rdquo;).
</p>

<p>Den viktigaste av de två makefilerna är Makefile.common, vilken, som
namnet antyder, innehåller några gemensamma regler som appliceras genom att
inkludera denna i fil i andra makefiler.
</p>

<p>Varje språk innehåller makefiler, WML-källkodsfiler och underkataloger.
Namnen på filerna och katalogerna varierar inte, vilket gör att länkarna är
korrekta för alla språk.
Katalogerna kan även innehålla .wmlrc-filer, vilka innehåller information
användbar för WML.
</p>

<p>Katalogen webwml/english/template innehåller speciella WML-filer vilka
kallas mallar, eftersom de kan refereras från alla andra filer med kommandot
<code>#use</code>.
</p>

<p>För att ändringar i mallarna skall propagera till filerna som använder
dem har makefilerna beroenden på dem.
Eftersom en stor majoritet av filerna använder &rdquo;template&rdquo;-mallen genom att
innehålla raden &rdquo;<code>#use wml::debian::template</code>&rdquo; i början är det
standardiserade beroendet (det som gäller samtliga filer) på den mallen.
Det finns naturligtvis undantag från denna regel.
</p>

<toc-add-entry name="scripts">Skript</toc-add-entry>

<p>
Skripten är huvudsakligen skrivna i skalspråket eller Perl.
En del av dem är fristående medan några är integrerade i WML-källfilerna.
</p>

<p>
Källkoden till de viktigaste av www-master:s byggskript finns i git-arkivet 
<a href="https://salsa.debian.org/webmaster-team/cron.git">debwww/cron</a>.
</p>

<p>
Källkoden till byggskripten för packages.debian.org finns i
git-arkivet
<a href="https://salsa.debian.org/webmaster-team/packages/">webwml/packages</a>.
</p>

<toc-add-entry name="help">Hjälpa till</toc-add-entry>

<p>Vi välkomnar alla som är intresserade av att hjälpa oss göra Debians
webbplats så bra den bara kan bli.
Om du har värdefull Debianrelaterad information som du tror saknas på våra
sidor,
<a href="mailto:debian-www@lists.debian.org">dela då med dig till oss</a>
så att vi kan se till att den läggs upp.
</p>

<p>Vi är också intresserad av hjälp att formge sidor (vad gäller grafik och
utseende), och att hålla vår HTML-kod ren.
Vi kör regelbundet följande kontroller på hela webbplatsen:</p>

<ul>
 <li><a href="https://www-master.debian.org/build-logs/urlcheck/">URL check</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 är alltid välkommen vad gäller att läsa loggarna ovan och rätta
problemen.</p>

<p>
Aktuella byggloggar för webbplatsen finns på
<url "https://www-master.debian.org/build-logs/">.
</p>

<p>Om du talar flytande engelska ser vi gärna att du korrekturläser våra
sidor och rapporterar alla fel du hittar till
<a href="mailto:debian-www@lists.debian.org">oss</a>.
</p>

<p>Om du talar ett annat språk, kanske du vill hjälpa till att översätta
sidorna till ditt språk.
Om en översättning redan har gjorts, men har problem, se på listan över
<a href="translation_coordinators">översättningssamordnare</a>, och ta
kontakt med den som har hand om ditt språk om att rätta till det.
# Swedish blurb ---
(För den här svenska översättningen ber vi dig se
<a href="$(HOME)/international/Swedish/">Debians svenska sidor</a>
för information om hur du hjälper till och vem du skall kontakta).
# -----------------
Om du vill översätta sidor själv, se sidan
<a href="translating">som handlar om det</a>
för ytterligare information.
</p>

<p>Vi har också en <a href="todo">&rdquo;ATT GÖRA&rdquo;-fil</a>, läs
den.</p>

<toc-add-entry name="nohelp">Hur du <strong>inte</strong> hjälper till</toc-add-entry>

<p><em>[?] Jag vill lägga in <var>tuff webbfunktion</var> på www.debian.org,
får jag det?</em>
</p>

<p>[!] Nej. Vi vill hålla www.debian.org så tillgänglig som möjlig, så
<ul>
    <li>inga webbläsarspecifika &rdquo;utökningar&rdquo;.
    <li>inget beroende endast på bilder.
        Bilder kan användas för att klargöra, men informationen på
        www.debian.org måste vara tillgänglig via en textbaserad webbläsare
        såsom Lynx.
</ul>

<p><em>[?] Jag har en bra idé.
Kan ni vara snälla och aktivera FOO i www.debian.org:s HTTPD?</em>
</p>

<p>[!] Nej. Vi vill göra det så lätt som möjligt för administratörer att
spegla www.debian.org, så inga speciella HTTPD-funktioner, är ni snälla.
Nej, inte ens SSI.
Ett undantag har gjorts för innehållsförhandling, eftersom det är det enda
robusta sättet att tillhandahålla flera språk på.
</p>

© 2014-2024 Faster IT GmbH | imprint | privacy policy