/usr/share/doc/festival-doc/html/Shell-API.html is in festival-doc 1:2.4~release-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
<head>
<title>Festival Speech Synthesis System: Shell API</title>
<meta name="description" content="Festival Speech Synthesis System: Shell API">
<meta name="keywords" content="Festival Speech Synthesis System: Shell API">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Index.html#Index" rel="index" title="Index">
<link href="Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="API.html#API" rel="up" title="API">
<link href="Server_002fclient-API.html#Server_002fclient-API" rel="next" title="Server/client API">
<link href="Scheme-API.html#Scheme-API" rel="prev" title="Scheme API">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Shell-API"></a>
<div class="header">
<p>
Next: <a href="Server_002fclient-API.html#Server_002fclient-API" accesskey="n" rel="next">Server/client API</a>, Previous: <a href="Scheme-API.html#Scheme-API" accesskey="p" rel="prev">Scheme API</a>, Up: <a href="API.html#API" accesskey="u" rel="up">API</a> [<a href="Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Index.html#Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Shell-API-1"></a>
<h3 class="section">28.2 Shell API</h3>
<a name="index-shell-programming"></a>
<p>The simplest use of Festival (though not the most powerful) is
simply using it to directly render text files as speech. Suppose
we have a file <samp>hello.txt</samp> containing
</p><div class="lisp">
<pre class="lisp">Hello world. Isn't it excellent weather
this morning.
</pre></div>
<p>We can simply call Festival as
</p><div class="lisp">
<pre class="lisp">unix$ festival --tts hello.txt
</pre></div>
<p>Or for even simpler one-off phrases
</p><div class="lisp">
<pre class="lisp">unix$ echo "hello " | festival --tts
</pre></div>
<p>This is easy to use but you will need to wait for Festival to start up
and initialise its databases before it starts to render the text as
speech. This may take several seconds on some machines. A socket based
server mechanism is provided in Festival which will allow a single
server process to start up once and be used efficiently by multiple
client programs.
</p>
<p>Note also the use of Sable for marked up text, see <a href="XML_002fSGML-mark_002dup.html#XML_002fSGML-mark_002dup">XML/SGML mark-up</a>.
Sable allows various forms of additional information in text, such as
phrasing, emphasis, pronunciation, as well as changing voices, and
inclusion of external waveform files (i.e. random noises). For many
application this will be the preferred interface method. Other text
modes too are available through the command line by using
<code>auto-text-mode-alist</code>.
</p>
</body>
</html>
|