4 files changed, 65 insertions, 38 deletions

diff --git a/README.md b/README.md
index 2e1df44..d686738 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,31 @@
+---
+author:
+- Robert Alessi
+title: 'The arabluatex package – README file'
+---
+
 Overview 
 ========
 
-This package provides for LuaLaTeX an Arab<span>TeX</span>-like
-interface to generate Arabic writing from an <span
-style="font-variant:small-caps;">ascii</span> transliteration. It is
-particularly well-suited for complex documents such as technical
-documents or critical editions where a lot of left-to-right commands
-intertwine with Arabic writing. arabluatex is able to process any
-ArabTeX input notation. Its output can be set in the same modes of
-vocalization as ArabTeX, or in different roman transliterations. It
-further allows many typographical refinements. It will eventually
-interact with some other packages yet to come to produce from `.tex`
-source files, in addition to printed books, `TEI xml` compliant critical
-editions and/or lexicons that can be searched, analyzed and correlated
-in various ways.
+This package provides for [LuaLaTeX](http://luatex.org) an
+[ArabTeX](http://ctan.org/pkg/arabtex)-like interface to generate Arabic
+writing from an <span style="font-variant:small-caps;">ascii</span>
+transliteration. It is particularly well-suited for complex documents
+such as technical documents or critical editions where a lot of
+left-to-right commands intertwine with Arabic writing. arabluatex is
+able to process any ArabTeX input notation. Its output can be set in the
+same modes of vocalization as ArabTeX, or in different roman
+transliterations. It further allows many typographical refinements. It
+will eventually interact with some other packages yet to come to produce
+from `.tex` source files, in addition to printed books, `TEI xml`
+compliant critical editions and/or lexicons that can be searched,
+analyzed and correlated in various ways.
 
 License and disclamer 
 =====================
 
-Copyright ⓒ 2016 Robert Alessi
-
-Please send error reports and suggestions for improvements to Robert
-Alessi:
+Copyright ⓒ 2016 Robert Alessi Please send error reports and suggestions
+for improvements to Robert Alessi:
 
 -   email: [alessi@robertalessi.net](alessi@robertalessi.net)
 
@@ -62,7 +66,8 @@ This release of arabluatex consists of the following source files:
 Installation 
 ============
 
-1.  run `lualatex arabluatex.ins` to produce the `arabluatex.sty` file;
+1.  run `'lualatex arabluatex.ins'` to produce the `arabluatex.sty`
+    file;
 
 2.  To finish the installation you have to move the following files into
     a directory where LaTeX can find them. See the FAQ on `tex.ac.uk` at
diff --git a/README.tex b/README.tex
index adcee9c..01cd3bc 100644
--- a/README.tex
+++ b/README.tex
@@ -1,34 +1,40 @@
+% The arabluatex package -- README file
+% Robert Alessi
+% March 5, 2016
 \documentclass{article}
 
 \usepackage{fontspec,luatextra}
+\usepackage{libertine}
 
-\title{The arabluatex package}
+\title{The arabluatex package -- README file}
 \author{Robert Alessi}
 \usepackage{hyperref}
+\hypersetup{pdftitle={The arabluatex package -- README file},
+  pdfauthor={Robert Alessi}}
 
 \begin{document}
 \maketitle
 
 \section*{Overview}
 \label{sec:overview}
-This package provides for Lua\LaTeX\ an Arab{\TeX}-like interface to
+This package provides for \href{http://luatex.org}{Lua\LaTeX} an
+\href{http://ctan.org/pkg/arabtex}{Arab\TeX}-like interface to
 generate Arabic writing from an \textsc{ascii} transliteration. It is
 particularly well-suited for complex documents such as technical
 documents or critical editions where a lot of left-to-right commands
-intertwine with Arabic writing. arabluatex is able to
-process any Arab\TeX\ input notation. Its output can be set in the
-same modes of vocalization as Arab\TeX, or in different roman
-transliterations. It further allows many typographical refinements. It
-will eventually interact with some other packages yet to come to
-produce from \verb|.tex| source files, in addition to printed books,
-\texttt{TEI xml} compliant critical editions and/or lexicons that can
-be searched, analyzed and correlated in various ways.
+intertwine with Arabic writing. arabluatex is able to process any
+Arab\TeX\ input notation. Its output can be set in the same modes of
+vocalization as Arab\TeX, or in different roman transliterations. It
+further allows many typographical refinements. It will eventually
+interact with some other packages yet to come to produce from
+\verb|.tex| source files, in addition to printed books, \texttt{TEI
+  xml} compliant critical editions and/or lexicons that can be
+searched, analyzed and correlated in various ways.
 
 \section*{License and disclamer}
 Copyright ⓒ 2016  Robert Alessi
-
-\addcontentsline{toc}{section}{License and disclamer} Please send
-error reports and suggestions for improvements to Robert Alessi:
+Please send error reports and suggestions for improvements to Robert
+Alessi:
 \begin{itemize}
 \item email: \url{alessi@robertalessi.net}
 \item website: \url{http://www.robertalessi.net/arabluatex}
@@ -65,7 +71,7 @@ source files:
 \section*{Installation}
 \label{sec:installation}
 \begin{enumerate}
-\item run \verb+lualatex arabluatex.ins+ to produce the
+\item run \verb+'lualatex arabluatex.ins'+ to produce the
   \verb+arabluatex.sty+ file;
 \item To finish the installation you have to move the following files
   into a directory where LaTeX can find them. See the FAQ on
diff --git a/about.html b/about.html
index 050dcb5..5a69d60 100644
--- a/about.html
+++ b/about.html
@@ -1,8 +1,22 @@
+<!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/html; charset=utf-8" />
+  <meta http-equiv="Content-Style-Type" content="text/css" />
+  <meta name="generator" content="pandoc" />
+  <meta name="author" content="Robert Alessi" />
+  <title>The arabluatex package – README file</title>
+  <style type="text/css">code{white-space: pre;}</style>
+</head>
+<body>
+<div id="header">
+<h1 class="title">The arabluatex package – README file</h1>
+<h2 class="author">Robert Alessi</h2>
+</div>
 <h1 id="sec:overview" class="unnumbered">Overview</h1>
-<p>This package provides for LuaLaTeX an Arab<span>TeX</span>-like interface to generate Arabic writing from an <span style="font-variant: small-caps;">ascii</span> transliteration. It is particularly well-suited for complex documents such as technical documents or critical editions where a lot of left-to-right commands intertwine with Arabic writing. arabluatex is able to process any ArabTeX input notation. Its output can be set in the same modes of vocalization as ArabTeX, or in different roman transliterations. It further allows many typographical refinements. It will eventually interact with some other packages yet to come to produce from <code>.tex</code> source files, in addition to printed books, <code>TEI xml</code> compliant critical editions and/or lexicons that can be searched, analyzed and correlated in various ways.</p>
+<p>This package provides for <a href="http://luatex.org">LuaLaTeX</a> an <a href="http://ctan.org/pkg/arabtex">ArabTeX</a>-like interface to generate Arabic writing from an <span style="font-variant: small-caps;">ascii</span> transliteration. It is particularly well-suited for complex documents such as technical documents or critical editions where a lot of left-to-right commands intertwine with Arabic writing. arabluatex is able to process any ArabTeX input notation. Its output can be set in the same modes of vocalization as ArabTeX, or in different roman transliterations. It further allows many typographical refinements. It will eventually interact with some other packages yet to come to produce from <code>.tex</code> source files, in addition to printed books, <code>TEI xml</code> compliant critical editions and/or lexicons that can be searched, analyzed and correlated in various ways.</p>
 <h1 id="license-and-disclamer" class="unnumbered">License and disclamer</h1>
-<p>Copyright ⓒ 2016 Robert Alessi</p>
-<p>Please send error reports and suggestions for improvements to Robert Alessi:</p>
+<p>Copyright ⓒ 2016 Robert Alessi Please send error reports and suggestions for improvements to Robert Alessi:</p>
 <ul>
 <li><p>email: <a href="alessi@robertalessi.net" class="uri">alessi@robertalessi.net</a></p></li>
 <li><p>website: <a href="http://www.robertalessi.net/arabluatex" class="uri">http://www.robertalessi.net/arabluatex</a></p></li>
@@ -23,7 +37,7 @@
 </ul>
 <h1 id="sec:installation" class="unnumbered">Installation</h1>
 <ol>
-<li><p>run <code>lualatex arabluatex.ins</code> to produce the <code>arabluatex.sty</code> file;</p></li>
+<li><p>run <code>'lualatex arabluatex.ins'</code> to produce the <code>arabluatex.sty</code> file;</p></li>
 <li><p>To finish the installation you have to move the following files into a directory where LaTeX can find them. See the FAQ on <code>tex.ac.uk</code> at <a href="http://www.tex.ac.uk/faq/FAQ-inst-wlcf.html" class="uri">http://www.tex.ac.uk/faq/FAQ-inst-wlcf.html</a> for more on this:</p>
 <ul>
 <li><p><code>arabluatex.sty</code></p></li>
@@ -46,3 +60,5 @@
 <pre><code>git clone http://git.robertalessi.net/cgit.cgi/arabluatex</code></pre>
 <p>A new directory named arabluatex will have been created, containing ArabLuaTeX. Git hosting</p>
 <p>Please, do not use GitHub or GitLab: see <a href="https://libreboot.org/git/#githosting">there</a>.</p>
+</body>
+</html>
diff --git a/makefile b/makefile
index 154d2fd..515ba29 100644
--- a/makefile
+++ b/makefile
@@ -42,5 +42,5 @@ clean:
         rm *.*
         cp saved/* .
         rm -rf saved/
-        pandoc README.tex -o README.md && sed -i 's/{#.*}//g' README.md
-        pandoc README.tex -o about.html
+        pandoc -s README.tex -o README.md && sed -i 's/{#.*}//g' README.md
+        pandoc -s README.tex -o about.html