Commit c8d9ac84 authored by Thomas Dennis's avatar Thomas Dennis

Add a "help" page which demonstrates how the conversion stuff works.

parent 069f2559
......@@ -24,9 +24,7 @@
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -57,9 +57,7 @@
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -266,3 +266,7 @@ td.kana-blank { background: #888; }
.wrong_answer { background: #FAA; }
.hidden-answer { display: none; }
/* Used on the Help page. */
#convert_output { width:100%; }
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<link rel="stylesheet" href="default.css">
<script src="js/util.js"></script>
<title>naniJSore</title>
</head>
<body>
<div id="navbar" class="custom-navbar custom-header">
<a href="index.html" class="custom-brand">あ naniJSore</a>
<a href="kana.html">Kana</a>
<a href="kanji.html">Kanji</a>
<a href="nouns.html">Nouns</a>
<a href="particles.html">Particles</a>
<a href="conjugate.html">Conjugations</a>
<span class="custom-expand"></span>
</div>
<div class="body-content">
<!--content-->
<h1>Help</h1>
<h2>Do I have to use kanji/hiragana/katakana/romaji to answer questions?</h2>
<p>
You can generally use hiragana, katakana, and romaji interchangably - they're
converted into the right format behind the scenes. Kanji can be used in a few
places, but this requires special handling since the automatic coversion code
isn't smart enough to figure out the correct reading of a kanji from context:
</p>
<ul>
<li>Kanji <b>can</b> be used on the <a href="nouns.html">nouns</a> page.</li>
<li>Kanji <b>can't</b> be used for <a href="conjugations">conjugations</a> yet.</li>
</ul>
<p>
Hiragana/katakana conversion works as you'd expect - characters from one kana
are replaced by the equivalent in the other. However, the rules for romaji to
kana conversion may require some explaining:
</p>
<ul>
<li>In general, conversion is simple: kondo becomes こんど, for example.</li>
<li>Conversion is Hepburn-based: shi becomes し but si isn't recognised.</li>
<li>は is always converted as ha, never wa. Same goes for へ (he, not e).</li>
<li>nna becomes っな, not んな. Use n' for an explicit ん: n'na</li>
<li>kaa becomes かあ, ka- becomes かー, and kā isn't recognised.</li>
</ul>
<p>
You can see how the conversion process works using the buttons below:
</p>
<!-- TODO: This needs to look nicer (and shouldn't use a table). -->
<table>
<tr><td><input id='convert_input'></td><td id='convert_output'></td></tr>
<tr><td colspan="2" class="centred-box">
<span class="jslink" id="convert_toKataKana">Hiragana to Katakana</span>
<span class="jslink" id="convert_toHiragana">Katakana to Hiragana</span>
<span class="jslink" id="convert_toRomaji">Kana to Romaji</span>
<span class="jslink" id="convert_toKana">Romaji to Kana</span>
</td></tr>
</table>
<script src="js/help.js"></script>
<!--content-->
</div>
<div class="custom-navbar custom-footer">
<a href="readme.html">About</a>
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -38,9 +38,7 @@
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
/**
@file
@brief Code specific to the help.html page.
*/
"use strict";
/**
@brief Initialise everything.
*/
function main()
{
var i = document.getElementById("convert_input");
var o = document.getElementById("convert_output");
document.getElementById("convert_toKataKana").onclick = function()
{ o.innerHTML = i.value.toKatakana(); }
document.getElementById("convert_toHiragana").onclick = function()
{ o.innerHTML = i.value.toHiragana(); }
document.getElementById("convert_toRomaji").onclick = function()
{ o.innerHTML = i.value.toRomaji(); }
document.getElementById("convert_toKana").onclick = function()
{ o.innerHTML = i.value.toKana(); }
}
document.body.onload = main;
......@@ -400,9 +400,7 @@ instead of オ for the "o" sound - as with ゑ, the "w" isn't actually pronounce
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -39,9 +39,7 @@
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -32,9 +32,7 @@
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -28,9 +28,7 @@
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -109,6 +109,7 @@ yet addressed are outlined below:</p>
<li><strong>nouns.html</strong> - Add more words/categories (and support more languages).</li>
<li><strong>particles.html</strong> - Currently blank; need to decide what to put here.</li>
<li><strong>conjugate.html</strong> - Need to add more conjugations (based on WWWJDIC).</li>
<li><strong>help.html</strong> - Need to improve the CSS for the &ldquo;conversion process&rdquo; stuff.</li>
</ul>
......@@ -122,9 +123,6 @@ yet addressed are outlined below:</p>
</ul>
<p>Perhaps there should also be a way to try out the kana conversion functions (in
<code>js/util.js</code>) without using the browser console - maybe on the kana page?</p>
<h2>License</h2>
<p>Copyright &copy; 2015 Thomas Glyn Dennis</p>
......@@ -159,9 +157,7 @@ an <a href="mailto:goFULLSTOPbustoATgmailFULLSTOPcom?subject=naniJSore">email</a
<span class="custom-expand">
<a href='https://gitlab.com/gobusto/nanijsore/tree/master'>Get the source code</a>
</span>
<a href="mailto:goDOTbusto@gmail.com">
Contact
</a>
<a href="help.html">Help</a>
</div>
</body>
</html>
......@@ -86,6 +86,7 @@ yet addressed are outlined below:
+ **nouns.html** - Add more words/categories (and support more languages).
+ **particles.html** - Currently blank; need to decide what to put here.
+ **conjugate.html** - Need to add more conjugations (based on WWWJDIC).
+ **help.html** - Need to improve the CSS for the "conversion process" stuff.
It would also be nice to include the following bits somewhere:
......@@ -94,9 +95,6 @@ It would also be nice to include the following bits somewhere:
+ Expressing "want" via 欲しい or the たい verb ending. For details, see the page on
[about.com](http://japanese.about.com/od/Grammar/a/Expressions-Of-Desire.htm).
Perhaps there should also be a way to try out the kana conversion functions (in
`js/util.js`) without using the browser console - maybe on the kana page?
License
-------
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment