Extensions Docs Server: Doc conversion script

chrome/common/extensions/docs/server2/templates/intros/ttsEngine.html

Index: chrome/common/extensions/docs/server2/templates/intros/ttsEngine.html
diff --git a/chrome/common/extensions/docs/server2/templates/intros/ttsEngine.html b/chrome/common/extensions/docs/server2/templates/intros/ttsEngine.html
index 086d7c02c01501db97d6cf001485fcf7391d35fd..7f2af21e5188c5c65c26dd9ae460800a843c9b52 100644
--- a/chrome/common/extensions/docs/server2/templates/intros/ttsEngine.html
+++ b/chrome/common/extensions/docs/server2/templates/intros/ttsEngine.html
@@ -9,7 +9,10 @@ module to generate speech. Your extension can then use any available
 web technology to synthesize and output the speech, and send events back
 to the calling function to report the status.
 </p>
+
+
 <h2 id="overview">Overview</h2>
+
 <p>An extension can register itself as a speech engine. By doing so, it
 can intercept some or all calls to functions such as
 <a href="tts.html#method-speak"><code>speak()</code></a> and
@@ -20,10 +23,13 @@ to provide speech, including streaming audio from a server, HTML5 audio,
 Native Client, or Flash. An extension could even do something different
 with the utterances, like display closed captions in a pop-up window or
 send them as log messages to a remote server.</p>
+
 <h2 id="manifest">Manifest</h2>
+
 <p>To implement a TTS engine, an extension must
 declare the "ttsEngine" permission and then declare all voices
 it provides in the extension manifest, like this:</p>
+
 <pre>{
   "name": "My TTS Engine",
   "version": "1.0",
@@ -45,15 +51,19 @@ it provides in the extension manifest, like this:</p>
   },</b>
   "background_page": "background.html",
 }</pre>
+
 <p>An extension can specify any number of voices.</p>
+
 <p>The <code>voice_name</code> parameter is required. The name should be
 descriptive enough that it identifies the name of the voice and the
 engine used. In the unlikely event that two extensions register voices
 with the same name, a client can specify the ID of the extension that
 should do the synthesis.</p>
+
 <p>The <code>gender</code> parameter is optional. If your voice corresponds
 to a male or female voice, you can use this parameter to help clients
 choose the most appropriate voice for their application.</p>
+
 <p>The <code>lang</code> parameter is optional, but highly recommended.
 Almost always, a voice can synthesize speech in just a single language.
 When an engine supports more than one language, it can easily register a
@@ -62,11 +72,13 @@ voice can handle more than one language, it's easiest to just list two
 separate voices and handle them using the same logic internally. However,
 if you want to create a voice that will handle utterances in any language,
 leave out the <code>lang</code> parameter from your extension's manifest.</p>
+
 <p>Finally, the <code>event_types</code> parameter is required if the engine can
 send events to update the client on the progress of speech synthesis.
 At a minimum, supporting the <code>'end'</code> event type to indicate
 when speech is finished is highly recommended, otherwise Chrome cannot
 schedule queued utterances.</p>
+
 <p class="note">
 <strong>Note:</strong> If your TTS engine does not support
 the <code>'end'</code> event type, Chrome cannot queue utterances
@@ -76,8 +88,10 @@ option to your engine's onSpeak handler, giving you the option of
 implementing your own queueing.  This is discouraged because then
 clients are unable to queue utterances that should get spoken by different
 speech engines.</p>
+
 <p>The possible event types that you can send correspond to the event types
 that the <code>speak()</code> method receives:</p>
+
 <ul>
   <li><code>'start'</code>: The engine has started speaking the utterance.
   <li><code>'word'</code>: A word boundary was reached. Use
@@ -94,34 +108,45 @@ that the <code>speak()</code> method receives:</p>
           this utterance cannot be spoken.
           Pass more information in <code>event.errorMessage</code>.
 </ul>
+
 <p>The <code>'interrupted'</code> and <code>'cancelled'</code> events are
 not sent by the speech engine; they are generated automatically by Chrome.</p>
+
 <p>Text-to-speech clients can get the voice information from your
 extension's manifest by calling
 <a href="tts.html#method-getVoices">getVoices()</a>,
 assuming you've registered speech event listeners as described below.</p>
+
 <h2 id="handling_speech_events">Handling speech events</h2>
+
 <p>To generate speech at the request of clients, your extension must
 register listeners for both <code>onSpeak</code> and <code>onStop</code>,
 like this:</p>
+
 <pre>var speakListener = function(utterance, options, sendTtsEvent) {
   sendTtsEvent({'event_type': 'start', 'charIndex': 0})
+
   // (start speaking)
+
   sendTtsEvent({'event_type': 'end', 'charIndex': utterance.length})
 };
+
 var stopListener = function() {
   // (stop all speech)
 };
+
 chrome.ttsEngine.onSpeak.addListener(speakListener);
 chrome.ttsEngine.onStop.addListener(stopListener);</pre>
+
 <p class="warning">
 <b>Important:</b>
 If your extension does not register listeners for both
 <code>onSpeak</code> and <code>onStop</code>, it will not intercept any
 speech calls, regardless of what is in the manifest.</p>
+
 <p>The decision of whether or not to send a given speech request to an
 extension is based solely on whether the extension supports the given voice
 parameters in its manifest and has registered listeners
 for <code>onSpeak</code> and <code>onStop</code>. In other words,
 there's no way for an extension to receive a speech request and
-dynamically decide whether to handle it.</p>
+dynamically decide whether to handle it.</p>