1 |
<?xml version="1.0" ?> |
2 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
3 |
<html xmlns="http://www.w3.org/1999/xhtml"> |
4 |
<head> |
5 |
<title>harusame.pl - Multilingual Web page management tool</title> |
6 |
<link rel="stylesheet" href="http://suika.fam.cx/www/style/html/pod.css" type="text/css" /> |
7 |
<meta http-equiv="content-type" content="text/html; charset=utf-8" /> |
8 |
<link rev="made" href="mailto:wakaba@suika.fam.cx" /> |
9 |
</head> |
10 |
|
11 |
<body> |
12 |
|
13 |
|
14 |
<!-- INDEX BEGIN --> |
15 |
<div name="index"> |
16 |
<p><a name="__index__"></a></p> |
17 |
|
18 |
<ul> |
19 |
|
20 |
<li><a href="#name">NAME</a></li> |
21 |
<li><a href="#synopsis">SYNOPSIS</a></li> |
22 |
<li><a href="#description">DESCRIPTION</a></li> |
23 |
<li><a href="#arguments">ARGUMENTS</a></li> |
24 |
<li><a href="#see_also">SEE ALSO</a></li> |
25 |
<li><a href="#author">AUTHOR</a></li> |
26 |
<li><a href="#license">LICENSE</a></li> |
27 |
</ul> |
28 |
|
29 |
<hr name="index" /> |
30 |
</div> |
31 |
<!-- INDEX END --> |
32 |
|
33 |
<p> |
34 |
</p> |
35 |
<h1><a name="name">NAME</a></h1> |
36 |
<p>harusame.pl - Multilingual Web page management tool</p> |
37 |
<p> |
38 |
</p> |
39 |
<hr /> |
40 |
<h1><a name="synopsis">SYNOPSIS</a></h1> |
41 |
<pre> |
42 |
perl harusame.pl --lang LANGCODE < input.html > output.html</pre> |
43 |
<pre> |
44 |
perl harusame.pl --help</pre> |
45 |
<p> |
46 |
</p> |
47 |
<hr /> |
48 |
<h1><a name="description">DESCRIPTION</a></h1> |
49 |
<p>The <code>harusame.pl</code> script extracts a version of the HTML document |
50 |
written in the specified natural language, from a source HTML document |
51 |
that contains paragraphs in multiple natural languages.</p> |
52 |
<p>The document management of a multilingual Web site where there are |
53 |
multiple versions of a (conceptually same) document is somewhat |
54 |
difficult in general. If the author of an HTML document wants to edit |
55 |
a part of the document, then he or she has to ensure not to forget |
56 |
updating translations at the same time, otherwise documents in |
57 |
different language versions also differ in their content versions.</p> |
58 |
<p>Using the <code>harusame.pl</code>, one can generate versions of an HTML |
59 |
document in different language from one source HTML document that |
60 |
contains paragraphs written in all of those languages, such that |
61 |
authors no longer have to manage different content versions and |
62 |
different language versions in separate files.</p> |
63 |
<p> |
64 |
</p> |
65 |
<hr /> |
66 |
<h1><a name="arguments">ARGUMENTS</a></h1> |
67 |
<p>The source document must be provided to the script using the |
68 |
<em>standard input</em>. It must be encoded in UTF-8.</p> |
69 |
<p>The script outputs the generated document encoded in UTF-8 to the |
70 |
<em>standard output</em>.</p> |
71 |
<p>Following command-line options are available to this script:</p> |
72 |
<dl> |
73 |
<dt><strong><a name="help" class="item"><code>--help</code></a></strong> |
74 |
|
75 |
<dd> |
76 |
<p>Show the help message and exit.</p> |
77 |
</dd> |
78 |
</li> |
79 |
<dt><strong><a name="langcode" class="item"><code>--lang LANGCODE</code> (<strong>REQUIRED</strong>)</a></strong> |
80 |
|
81 |
<dd> |
82 |
<p>The language of the version to generate. This option must be |
83 |
specified. The value must be a value that is valid for HTML |
84 |
<code>lang=""</code> attribute.</p> |
85 |
</dd> |
86 |
</li> |
87 |
</dl> |
88 |
<p> |
89 |
</p> |
90 |
<hr /> |
91 |
<h1><a name="see_also">SEE ALSO</a></h1> |
92 |
<p>Readme <a href="http://suika.fam.cx/www/harusame/readme">http://suika.fam.cx/www/harusame/readme</a>. How to mark up the |
93 |
source HTML document is described in this document.</p> |
94 |
<p> |
95 |
</p> |
96 |
<hr /> |
97 |
<h1><a name="author">AUTHOR</a></h1> |
98 |
<p>Wakaba <<a href="mailto:w@suika.fam.cx">w@suika.fam.cx</a>>.</p> |
99 |
<p> |
100 |
</p> |
101 |
<hr /> |
102 |
<h1><a name="license">LICENSE</a></h1> |
103 |
<p>Copyright 2008 Wakaba <<a href="mailto:w@suika.fam.cx">w@suika.fam.cx</a>>.</p> |
104 |
<p>This library is free software; you can redistribute it and/or modify |
105 |
it under the same terms as Perl itself.</p> |
106 |
|
107 |
</body> |
108 |
|
109 |
</html> |