<a name = 'toc'></a><br><center><a href = '#'></a> | </center>
</p><p>
&lt;?php
//--&gt;--&gt;--&gt;--&gt;--&gt;--&gt;--&gt;--&gt;
//-- Description:
//--   The purpose of this function is to transform a journal or diary
//--   into some kind of meaningful HTML. The plain text is expected to
//--   have as little 'mark-up' imbedded within it as is possible for
//--   the given application. This attempt is an evolution on previous
//--   efforts which I have written which were written in the Unix Bash
//--   shell scripting language and which relied heavily programs such
//--   as 'sed' and 'grep'.
//--
//--   These previous efforts should be viewable at URL's such as
//--   <a href="http://www.geocities.com/matth3wbishop/">http://www.geocities.com/matth3wbishop/</a> and (if it still exists)
//--   <a href="http://www.ella-associates.org/alexis-docs/">http://www.ella-associates.org/alexis-docs/</a>
//--
//--   The overall purpose of this effort is to attempt to allow an
//--   author to write texts in a plain text editor such as
//--   Microsoft Notepad or Vi or Vim or Emacs or Nano etc and for those
//--   written texts to be transformed into readable and function HTML
//--   and even possibly DocBook XML.
//--
//-- Please see the file
//--   fnHyperlinkPlainText.php for explanations as to what sort of
//--   plain text structures will be hyperlinked.
//--
//-- Dependencies:
//--   fnHyperlinkPlainText
//--   fnReduplicateCharacters
//--   fnUnduplicateCharacters
//--
//--
</p><p>
function fnJournalToHtml($sPlainText)
{
  $sReturn = $sPlainText;
</p><p>
  //-- On lines that have nothing but spaces, delete the spaces
  //$sReturn = preg_replace(&quot;#\n\s*\n#im&quot;, &quot;\n\n&quot;, $sReturn);
</p><p>
  //-- Entitize special HTML characters such as &lt; and &gt; so that these
  //-- characters will not be considered part of the resulting HTML.
  //-- We have to do this first so that the HTML which we later insert
  //-- (such as hyperlinks) does not also get entitized. I
  //-- might also have to entitize accented characters such as ???
  $sReturn = htmlspecialchars($sReturn);
</p><p>
  //-- Make empty lines delimite HTML paragraphs
  $sReturn = preg_replace(&quot;#^\s*$#im&quot;, &quot;&lt;/p&gt;&lt;p&gt;&quot;, $sReturn);
</p><p>
  //-- Trailing space serves no purpose.
  $sReturn = preg_replace(&quot;#\s*\n#im&quot;, &quot;\n&quot;, $sReturn);
</p><p>
  //-- Try to allow the delimiters  and  to stop any further
  //-- transformations on the plain text (by placing the text with HTML
  //-- &lt;pre&gt; tags and then doubling every letter
  $sReturn = str_replace(&quot;--&amp;lt;&amp;lt;&quot;, &quot;&lt;/pre&gt;&quot;, $sReturn);
</p><p>
  $sReturn = str_replace(&quot;--&amp;gt;&amp;gt;&quot;, &quot;&lt;pre&gt;&quot;, $sReturn);
</p><p>
  //-- Make the title into a first level heading
  $sReturn =
    preg_replace(&quot;#^[ ]*=(.*)#m&quot;, &quot;&lt;center&gt;&lt;h1&gt;$1&lt;/h1&gt;&lt;/center&gt;&lt;dl&gt;&quot;, $sReturn);
</p><p>
  //-- Section headings are lines that are in upper case but these lines
  //-- can also contain punctuation. So the test below is that the lines do NOT
  //-- contain lower case letters.
  $sHeadings =
     preg_replace('#^\s*[^\*].*$#m', '', $sReturn);
</p><p>
  $sHeadings =
     preg_replace(&quot;#\n\s*\n#m&quot;, &quot;\n&quot;, $sHeadings);
</p><p>
  //-- Get rid of the leading 'star' characters for each of the journal entries
  $sHeadings =
     preg_replace(&quot;#^\s*\*\s*#m&quot;, &quot;&quot;, $sHeadings);
</p><p>
  $sHeadings =
     preg_replace(&quot;#\s*$#m&quot;, &quot;&quot;, $sHeadings);
</p><p>
  $sHeadings =
     preg_replace(&quot;#^(.*)$#m&quot;, &quot;&lt;a href = '#$1'&gt;$1&lt;/a&gt; | &quot; , $sHeadings);
</p><p>
  $sHeadings = &quot;&lt;a name = 'toc'&gt;&lt;/a&gt;&lt;br&gt;&lt;center&gt;&quot;.$sHeadings.&quot;&lt;/center&gt;&quot;;
</p><p>
  //echo &quot;&lt;pre&gt;[$sHeadings]&lt;/pre&gt;&quot;;
  //echo $sHeadings;
  $sReturn = preg_replace(
      &quot;#^\s*\*\s*(.*)$#m&quot;,
      &quot;&lt;dt&gt;&lt;strong&gt;&lt;a name = '$1'&gt;$1&lt;/a&gt;&lt;/strong&gt;&amp;nbsp;&lt;a href = '#toc'&gt;[toc]&lt;/a&gt;&lt;/dt&gt;&lt;dd&gt;&quot;,
      $sReturn);
</p><p>
  $sReturn = $sHeadings.&quot;\n&quot;.$sReturn;
</p><p>
  $sReturn = fnHyperlinkPlainText($sReturn);
</p><p>
  //-- Turn line breaks into &lt;br&gt; tags. This isn't really a good idea
  //-- since you dont know the width of the target screen
  // $sReturn = preg_replace(&quot;#\n#im&quot;, &quot;\n&lt;br&gt;&quot;, $sReturn);
</p><p>
  //-- Make a tab into 2 HTML spaces
  $sReturn = preg_replace(&quot;#\t#im&quot;, &quot;&amp;nbsp;&amp;nbsp;&quot;, $sReturn);
</p><p>
  //-- transform spaces into entitized HTML
  //$sReturn = preg_replace(&quot;#\s\s#im&quot;, &quot;&amp;nbsp;&amp;nbsp;&quot;, $sReturn);
</p><p>
  //-- Delete pre tags since line breaks and spaces are being put
  //-- in anyway
  $sReturn = preg_replace(&quot;#&lt;/?pre&gt;#im&quot;, &quot;&quot;, $sReturn);
</p><p>
  //-- get rid of the </dl> meta-tag which is used to tell the transformation
  //-- system that the current document should be transformed according to the
  //-- rules for a journal or diary style document.
  $sReturn = preg_replace(&quot;#\[\*journal\*\]#im&quot;, &quot;&lt;/dl&gt;&quot;, $sReturn);
</p><p>
  return $sReturn;
} //-- function fnJournalToHtml
</p><p>
//--&lt;--&lt;--&lt;--&lt;--&lt;--&lt;--&lt;--&lt;
?&gt;
</p><p>