summaryrefslogtreecommitdiff
path: root/documentation/translations.html
blob: 9abb65bf3d4f5ac770376624460f2ade86b1aff8 (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
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
        "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>NetSurf | Producing Translations</title>
<link rel="stylesheet" type="text/css" href="/netsurf.css">
<link rel="icon" type="image/png" href="/webimages/favicon.png">
</head>

<body>
<p class="banner"><a href="/"><img src="/netsurf.png" alt="NetSurf"></a></p>

<div class="navigation">
<div class="navsection">
<ul>
<li><a href="/about/">About NetSurf</a></li>
<li><a href="/downloads/">Downloads</a></li>
<li><a href="/documentation/">Documentation</a>
<ul>
<li><a href="/documentation/info">User info</a></li>
<li><a href="/documentation/guide">User guide</a></li>
<li><a href="/documentation/progress">Project progress</a></li>
<li><a href="/documentation/develop">Developer info</a></li>
</ul>
</li>
<li><a href="/developers/">Development area</a></li>
<li><a href="/webmasters/">Webmaster area</a></li>
<li><a href="/contact/">Contact</a></li>
</ul>
</div>

<div class="navsection">
<ul class="languages">
<!--<li><a href="index.de">Deutsch</a></li>-->
<li>English</li>
<!--<li><a href="index.fr">Fran�ais</a></li>-->
<!--<li><a href="index.nl">Nederlands</a></li>-->
</ul>
</div>

<div class="navsection">
<ul class="sitelinks">
<li><a href="http://wiki.netsurf-browser.org/">Development wiki</a></li>
<li><a href="http://source.netsurf-browser.org/">Git repository viewer</a></li>
<li><a href="http://ci.netsurf-browser.org/">Continuous Integration</a></li>
<li><a href="http://bugs.netsurf-browser.org/">Bug report system</a></li>
<li><a href="http://ci.netsurf-browser.org/jenkins/view/Categorized/job/docs-netsurf/doxygen/">Code documentation</a></li>
</ul>
</div>

</div>

<div class="content">

<p class="breadcrumbs"><a href="/">Home</a><a href="/documentation/">Documentation</a> � Producing translations</p>

<h1>Producing Translations</h1>

<p>This page contains information for anyone interested in translating NetSurf into other languages.</p>

<ul>
<li><a href="#GettingStarted">Getting started</a>
<ul>
<li><a href="#GettingStartedMailingList">Mailing list</a></li>
<li><a href="#GettingStartedObtainingFiles">Obtaining files</a></li>
<li><a href="#GettingStartedRequirements">Requirements</a></li>
</ul></li>
<li><a href="#FileSubmission">File submission</a></li>
</ul>

<p class="updated">Last updated 17 June 2006</p>

<h2 id="GettingStarted">Getting started</h2>

<p>Translations of NetSurf into other languages are very welcome. Currently we have the reference version in English and translations into Dutch, French and German.</p>

<h3 id="GettingStartedMailingList">Mailing list</h3>

<p>Translators are encouraged to join the <a href="/contact/#MailingLists">developer's mailing list</a>. Please join the mailing list if you would like to translate NetSurf into a new language or help with an existing translation.</p>

<p>The mailing list is for any discussion related to development or translation of NetSurf and will be used to indicate any changes that have been made to NetSurf's interface, web site or documentation.</p>

<h3 id="GettingStartedObtainingFiles">Obtaining files</h3>

<p>There are two types of files that can be translated; those that are part of the web site and those that are part of the NetSurf application.</p>

<p>The documentation is part of the web site and it is copied into the NetSurf application by the autobuilder. The autobuilder automatically makes a few changes to links in the documentation, to ensure they work off line. It is important that it is the web site version of the documentation is translated.</p>

<p>The simplest way to get the latest files is to use Git, as follows:</p>

<p><code>$ <strong>git clone git://git.netsurf-browser.org/netsurf.git</strong></code><br><code>$ <strong>git clone git://git.netsurf-browser.org/netsurf-website.git</strong></code></p>

<p>The important files are</p>

<ul>
<li>!NetSurf/Docs.intro_??</li>
<li>!NetSurf/Resources/??/Messages</li>
<li>!NetSurf/Resources/??/Templates</li>
<li>In netsurfweb: Any file ending in &quot;.??&quot;</li>
</ul>

<p class="caption">&quot;??&quot; is a two letter country code, such as &quot;de&quot; (Germany) or &quot;fr&quot; (France)</p>

<p>Alternatively, the three files from !NetSurf can be taken from the <a href="http://ci.netsurf-browser.org/builds/">latest build</a> and any documentation or web material can be found on the <a href="http://www.netsurf-browser.org/">web site</a>. Do not be put off by the amount of files that can be translated. A translation of just NetSurf's interface is much better than no translation at all!</p>

<p>Please translate from the English version as this will always be most up to date.</p>

<h3 id="GettingStartedRequirements">Requirements</h3>

<p>No programming knowledge is required, just the ability to use a template editor (for example <a href="http://www.snowstone.org.uk/riscos/wined/">WinEd</a>) and a text editor capable of editing UTF-8 encoded files (for example <a href="http://zap.tartarus.org/">Zap</a>).</p>

<p>NetSurf's Messages files are UTF-8 encoded. In Zap 1.47 Beta, to select UTF-8 mode, click menu over the window and select:</p>

<p><code>Edit &gt; Encoding &gt; UTF8</code></p>

<h2 id="FileSubmission">File submission</h2>

<p>Please send any translated files to the <a href="/contact/">development mailing list</a>.</p>


<div class="footer">
<p>Copyright 2003 - 2009 The NetSurf Developers</p>
</div>

</div>


<form method="get" action="//www.google.co.uk/search">
<div class="searchbox">
<input type="hidden" name="q" value="site:netsurf-browser.org">
<input type="text" name="q" maxlength="255"><br>
<input type="submit" value="Search" name="btnG">
</div>
</form>

</body>
</html>