1 |
wakaba |
1.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> |