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
|
#use wml::debian::template title="Brug af WML"
#use wml::debian::translation-check translation="24a8bbc5bf2fd2fbe025f0baa536bf1126f83723"
<p>WML betyder "web site meta language". Dette betyder, at WML anvender
.wml-filer som inddata, behandler hvad de indeholder (det kan være alt fra
almindelig HTML til Perl-kode!), og dets uddata er hvad du ønsker, dets uddata
skal være, for eksempel .html eller .php.</p>
<p>Der et ikke let at lære af dokumentationen til WML. Den er faktisk ret
fuldstændig, men indtil man begynder at forstå hvordan det fungerer (og det er
ganske kraftfuldt), er det nemmest at lære af eksempler. Det kan måske være
lærerigt at kigge på de skabelonfiler som anvendes til Debians websted. De
findes i
<code><a href="https://salsa.debian.org/webmaster-team/webwml/tree/master/english/template/debian">\
webwml/english/template/debian/</a></code>.</p>
<p>Det forudsætter at du har installeret WML på din maskine. WML er tilgængelig
som <a href="https://packages.debian.org/wml">Debian-pakke</a>.</p>
<h2>Redigering af WML-kildekode</h2>
<p>En ting som alle .wml-filerne indeholder, er en eller flere indledende
<code>#use</code>-linier. Du må ikke ændre på eller oversætter deres syntaks,
kun strengene i anførselstegn, som dem efter <code>title=</code>, der kan ændre
<title>-elementet i uddatafilerne.</p>
<p>Ud over header-linierne, indeholder de fleste af vore .wml-sider simpel
HTML. Hvis du møder tags som <define-tag> eller <: ... :>, så vær
forsigtig, da disse adskiller kode som behandles i et af WMLs specielle
gennemgange. Se nedenfor for flere oplysninger.</p>
<h2>Opbygning af Debians websider</h2>
<p>Skriv blot <kbd>make</kbd> i webwml/<sprog>. Vi har lavet makefiler
som kalder <kbd>wml</kbd> med alle de rigtige parametre.</p>
<p>Hvis du udfører <kbd>make install</kbd> vil HTML-filerne blive opbygget og
placeret i mappen <kbd>../../www/</kbd>.</p>
<h2>Ekstra WML-funktioner, som vi bruger</h2>
<p>En af fordelene ved WML som vi gør udbredt brug af, er at man kan bruge
Perl. Husk, at det ikke er dynamiske sider. Perl bruges når HTML-siderne
genereres, til stort set hvad som helst. To gode eksempler på hvordan vi bruger
Perl på siderne, er ved oprettelsen af listen over de seneste nyheder på
forsiden, og ved genereringen af links til oversætterlene nederst på
siderne.</p>
# TODO: add the basic stuff from webwml/english/po/README here
<p>For at genopbygge skabelonerne til vores websted, er wml version
>= 2.0.6 krævet. For at genopbygge gettext-skabelonerne til ikke-engelske
oversættelser, er mp4h >= 1.3.0 krævet.</p>
<h2>Særlige problemstillinger mht. WML</h2>
<p>Multibyte-sprog kan kræve speciel før- eller efterbehandling af
.wml-filerne for at kunne håndtere tegnsættet korrekt. Dette kan gøre ved at
ændre variablerne <kbd>WMLPROLOG</kbd> og <kbd>WMLEPILOG</kbd> i
<kbd>webwml/<sprog>/Make.lang</kbd> på passende vis. Afhængigt af
hvordan dit <kbd>WMLEPILOG</kbd>-program fungerer, kan det være nødvendigt at
ændre <kbd>WMLOUTFILE</kbd>s værdi.<br>
Eksempler på dette er de japanske og kinesiske oversættelser.</p>
|
