path: root/Documentation
diff options
authorIvan Enderlin <ivan.enderlin@hoa-project.net>2015-01-08 11:58:12 +0100
committerIvan Enderlin <ivan.enderlin@hoa-project.net>2015-01-08 11:58:12 +0100
commit16860c720979e169d90301d964c12aa890ee2a50 (patch)
tree7489193a49ad7c887312810b7245e8295835e2ae /Documentation
parentaf144a64a9fd307f6265aff988a422767bd8d88a (diff)
Translate the abstract and #Introduction.
Diffstat (limited to 'Documentation')
1 files changed, 28 insertions, 2 deletions
diff --git a/Documentation/En/Index.xyl b/Documentation/En/Index.xyl
index 6fa3e8f..2cc7090 100644
--- a/Documentation/En/Index.xyl
+++ b/Documentation/En/Index.xyl
@@ -3,8 +3,34 @@
<overlay xmlns="http://hoa-project.net/xyl/xylophone">
<yield id="chapter">
- <p class="warning">This chapter is not yet translated. Contributions are
- welcomed!</p>
+ <p>Strings can sometimes be <strong>complex</strong>, especially when they use
+ the <code>Unicode</code> encoding format. The <code>Hoa\String</code> library
+ provides several operations on UTF-8 strings.</p>
+ <h2 id="Table_of_contents">Table of contents</h2>
+ <tableofcontents id="main-toc" />
+ <h2 id="Introduction" for="main-toc">Introduction</h2>
+ <p>When we manipulate strings, the <a href="http://unicode.org/">Unicode</a>
+ format establishes itself because of its <strong>compatibility</strong> with
+ historical formats (like ASCII) and its capacity to understand a
+ <strong>large</strong> range of characters and symbols for all cultures and
+ all regions in the world. PHP provides several tools to manipulate such
+ strings, like the following extensions:
+ <a href="http://php.net/mbstring"><code>mbstring</code></a>,
+ <a href="http://php.net/iconv"><code>iconv</code></a> or also the excellent
+ <a href="http://php.net/intl"><code>intl</code></a> which is based on
+ <a href="http://icu-project.org/">ICU</a>, the reference implementation of
+ Unicode. Unfortunately, sometimes we have to mix these extensions to achieve
+ our aims and at the cost of a certain <strong>complexity</strong> along with
+ a regrettable <strong>verbosity</strong>.</p>
+ <p>The <code>Hoa\String</code> library answers to these issues by providing a
+ <strong>simple</strong> way to manipulate strings with
+ <strong>performance</strong> and <strong>efficiency</strong> in minds. It
+ also provides some evoluated algorithms to perform <strong>search</strong>
+ operations on strings.</p>