trunk: Documentation changes including improvements to the look of the website; minor script improvement (limit jobs of I/O intensive process)

git-svn-id: https://svn.code.sf.net/p/kaldi/code/trunk@4936 5e6a8d80-dfce-4ca6-a32a-6e07a63d50c8

Author: danpovey

egs/wsj/s5/steps/decode_fmllr.sh

@@ -45,7 +45,9 @@ num_threads=1 # if >1, will use gmm-latgen-faster-parallel
 parallel_opts=  # If you supply num-threads, you should supply this too.
 skip_scoring=false
 scoring_opts=
-# End configuration section
+max_fmllr_jobs=25  # I've seen the fMLLR jobs overload NFS badly if the decoding
+                   # was started with a lot of many jobs, so we limit the number of
+                   # parallel jobs to 25 by default.  End configuration section
 echo "$0 $@"  # Print the command line for logging
 
 [ -f ./path.sh ] && . ./path.sh; # source the path.
@@ -147,7 +149,7 @@ esac
 ## Now get the first-pass fMLLR transforms.
 if [ $stage -le 1 ]; then
   echo "$0: getting first-pass fMLLR transforms."
-  $cmd JOB=1:$nj $dir/log/fmllr_pass1.JOB.log \
+  $cmd --max-jobs-run $max_fmllr_jobs JOB=1:$nj $dir/log/fmllr_pass1.JOB.log \
     gunzip -c $si_dir/lat.JOB.gz \| \
     lattice-to-post --acoustic-scale=$acwt ark:- ark:- \| \
     weight-silence-post $silence_weight $silphonelist $alignment_model ark:- ark:- \| \
@@ -183,7 +185,7 @@ fi
 ## $dir/trans.1, etc.
 if [ $stage -le 3 ]; then
   echo "$0: estimating fMLLR transforms a second time."
-  $cmd JOB=1:$nj $dir/log/fmllr_pass2.JOB.log \
+  $cmd --max-jobs-run $max_fmllr_jobs JOB=1:$nj $dir/log/fmllr_pass2.JOB.log \
     lattice-determinize-pruned$thread_string --acoustic-scale=$acwt --beam=4.0 \
     "ark:gunzip -c $dir/lat.tmp.JOB.gz|" ark:- \| \
     lattice-to-post --acoustic-scale=$acwt ark:- ark:- \| \

misc/logo/KaldiIco.png

@@ -17,14 +17,28 @@
 # The PROJECT_NAME tag is a single word (or a sequence of words surrounded 
 # by quotes) that should identify the project.
 
-PROJECT_NAME           = 'KALDI'
+PROJECT_NAME           = Kaldi
 
 # The PROJECT_NUMBER tag can be used to enter a project or revision number. 
 # This could be handy for archiving the generated documentation or 
 # if some version control system is used.
 
 PROJECT_NUMBER         = 
 
+
+# Using the PROJECT_BRIEF tag one can provide an optional one line description
+# for a project that appears at the top of each page and should give viewer
+# a quick idea about the purpose of the project. Keep the description short.
+
+# PROJECT_BRIEF          =  "Open source speech recognition"
+
+# With the PROJECT_LOGO tag one can specify an logo or icon that is
+# included in the documentation. The maximum height of the logo should not
+# exceed 55 pixels and the maximum width should not exceed 200 pixels.
+# Doxygen will copy the logo to the output directory.
+ 
+PROJECT_LOGO           =  ../misc/logo/KaldiTextAndLogoSmall.png
+
 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 
 # base path where the generated documentation will be put. 
 # If a relative path is entered, it will be relative to the location 
@@ -639,7 +653,40 @@ HTML_FILE_EXTENSION    = .html
 # each generated HTML page. If it is left blank doxygen will generate a 
 # standard header.
 
-HTML_HEADER            = 
+## Note: doc/header.html is a modified version of the standard header which was generated
+## using "doxygen -w html header.html footer.html stylesheet.css Doxyfile" (note, this may
+## have to be updated if the doxygen version changes), and then the following line was added:
+## <link rel="icon" type="image/png" href="http://kaldi.sf.net/favicon.ico">
+
+HTML_HEADER            = doc/header.html
+
+
+# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output.
+# Doxygen will adjust the colors in the style sheet and background images
+# according to this color. Hue is specified as an angle on a colorwheel,
+# see http://en.wikipedia.org/wiki/Hue for more information.
+# For instance the value 0 represents red, 60 is yellow, 120 is green,
+# 180 is cyan, 240 is blue, 300 purple, and 360 is red again.
+# The allowed range is 0 to 359.
+
+HTML_COLORSTYLE_HUE    = 26
+
+# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of
+# the colors in the HTML output. For a value of 0 the output will use
+# grayscales only. A value of 255 will produce the most vivid colors.
+
+HTML_COLORSTYLE_SAT    = 80
+
+# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to
+# the luminance component of the colors in the HTML output. Values below
+# 100 gradually make the output lighter, whereas values above 100 make
+# the output darker. The value divided by 100 is the actual gamma applied,
+# so 80 represents a gamma of 0.8, The value 220 represents a gamma of 2.2,
+# and 100 does not change the gamma.
+
+HTML_COLORSTYLE_GAMMA  = 90
+
+
 
 # The HTML_FOOTER tag can be used to specify a personal HTML footer for 
 # each generated HTML page. If it is left blank doxygen will generate a 
@@ -654,8 +701,7 @@ HTML_FOOTER            =
 # the style sheet file to the HTML output directory, so don't put your own 
 # stylesheet in the HTML output directory as well, or it will be erased!
 
-HTML_STYLESHEET        = 
-
+HTML_STYLESHEET        =
 
 # If the GENERATE_HTMLHELP tag is set to YES, additional index files 
 # will be generated that can be used as input for tools like the 

misc/logo/KaldiTextAndLogoSmall.png

@@ -24,6 +24,7 @@ doxygen
 cp doc/*.pptx html/;
 
 if [[ $(hostname -f) == *.clsp.jhu.edu ]]; then
+   cp ../misc/logo/KaldiIco.png html/favicon.ico
    tar -czf html.tar.gz html
    scp html.tar.gz [email protected]:/home/project-web/kaldi/htdocs/
 
@@ -49,3 +50,10 @@ fi
 # I added figures that I manually excerpted from https://sourceforge.net/p/kaldi/mailman/kaldi-users/?viewmonth=201203
 # and https://sourceforge.net/p/kaldi/mailman/kaldi-developers/?viewmonth=201203
 # this is june 13, 2014, 6:11pm, check my email.
+
+# Note (RE adding favicon): I generated the default header files like this (from
+# src/) doxygen -w html header.html footer.html stylesheet.css Doxyfile then
+# moved the header.html to doc/ and edited it to include the following snippet,
+# and added it to the repo.
+#<link rel="icon" type="image/png" href="http://kaldi.sf.net/favicon.ico">
+

src/Doxyfile

@@ -144,7 +144,7 @@ preprocessor variables, setting compile options, linking with libraries, and so
 \section build_setup_platforms Which platforms has Kaldi been compiled on?
 
 We have compiled Kaldi on Windows, Cygwin, various flavors of Linux (including
-Ubuntu, CentOS, Debian and SUSE), and Darwin. We recommend you use g++ version
-4.4 or above for the source to compile.
+Ubuntu, CentOS, Debian, Red Hat and SUSE), and Darwin. We recommend you use g++ version
+4.4 or above, although other compilers such as llvm and Intel's icc are also known to work.
 
 */

src/doc/README

@@ -0,0 +1,51 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9"/>
+<!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
+<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
+<link href="$relpath$tabs.css" rel="stylesheet" type="text/css"/>
+<link rel="icon" href="favicon.ico" type="image/x-icon" />
+<script type="text/javascript" src="$relpath$jquery.js"></script>
+<script type="text/javascript" src="$relpath$dynsections.js"></script>
+$treeview
+$search
+$mathjax
+<link href="stylesheet.css" rel="stylesheet" type="text/css" /> 
+</head>
+<body>
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+
+<!--BEGIN TITLEAREA-->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr style="height: 56px;">
+  <!--BEGIN PROJECT_LOGO-->
+  <td id="projectlogo"><img alt="Logo" src="$relpath$$projectlogo"/ style="padding: 4px 5px 1px 5px"></td>
+  <!--END PROJECT_LOGO-->
+  <!--BEGIN PROJECT_NAME-->
+  <td style="padding-left: 0.5em;">
+   <div id="projectname" style="display:none">$projectname
+   <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span><!--END PROJECT_NUMBER-->
+   </div>
+   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
+  </td>
+  <!--END PROJECT_NAME-->
+    <td style="padding-left: 0.5em;">
+    <div id="projectbrief" style="display:none">$projectbrief</div>
+    </td>
+   <!--END PROJECT_BRIEF-->
+  <!--END !PROJECT_NAME-->
+  <!--BEGIN DISABLE_INDEX-->
+   <!--BEGIN SEARCHENGINE-->
+   <td>$searchbox</td>
+   <!--END SEARCHENGINE-->
+  <!--END DISABLE_INDEX-->
+ </tr>
+ </tbody>
+</table>
+</div>
+<!--END TITLEAREA-->
+<!-- end header part -->

src/doc/build_setup.dox

@@ -30,10 +30,7 @@
 /**
   \mainpage Kaldi
 
-   Please see the \ref install_warning "instructions" on upgrading your repository to the
-   new location, following our upgrade to the "new" Sourceforge.
-
-   (see also Kaldi's <a href=http://sourceforge.net/projects/kaldi/> project page on Sourceforge </a>,
+   See also Kaldi's <a href=http://sourceforge.net/projects/kaldi/>project page on Sourceforge</a>,
     and <a href=http://kaldi-asr.org>kaldi-asr.org</a>  where you can download pre-built models.
 
   <p>
@@ -42,7 +39,6 @@
    - \subpage install 
    - \subpage dependencies
    - \subpage legal
-   - \subpage roadmap
    - \subpage tutorial
    - \subpage data_prep
    - \subpage build_setup