Added a section on the `markdown` package to the mu/ examples.

example/mu/Makefile

@@ -3,6 +3,11 @@ PDFFILES=fi-pdflatex.pdf fi-lualatex.pdf sci-pdflatex.pdf sci-lualatex.pdf \
 	fss-pdflatex.pdf fss-lualatex.pdf fsps-pdflatex.pdf fsps-lualatex.pdf \
 	phil-pdflatex.pdf phil-lualatex.pdf law-pdflatex.pdf law-lualatex.pdf \
 	econ-pdflatex.pdf econ-lualatex.pdf
+PDFLATEX=pdflatex --shell-escape
+LUALATEX=lualatex
+AUXFILES=*.aux *.log *.out *.toc *.lot *.lof *.bcf *.blg *.run.xml \
+		*.bbl *.idx *.ind *.ilg *.markdown.*
+AUXDIRS=_markdown-*/
 OUTPUT=$(PDFFILES) $(PDFFILES:.pdf=.tex)
 
 .PHONY: all clean
@@ -17,26 +22,26 @@ all: $(OUTPUT) clean
 
 # This target typesets a pdfLaTeX example.
 %-pdflatex.pdf: %-pdflatex.tex example.bib
-	pdflatex $< # The initial typesetting.
+	$(PDFLATEX) $< # The initial typesetting.
 	biber                               $(basename $<).bcf
-	pdflatex $< # Update the index after the bibliography insertion.
+	$(PDFLATEX) $< # Update the index after the bibliography insertion.
 	texindy -I latex -C utf8 -L english $(basename $<).idx
-	pdflatex $< # The final typesetting, now also with index.
-	pdflatex $<
+	$(PDFLATEX) $< # The final typesetting, now also with index.
+	$(PDFLATEX) $<
 
 # This target typesets a LuaLaTeX example.
 %-lualatex.pdf: %-lualatex.tex example.bib
-	lualatex $< # The initial typesetting.
+	$(LUALATEX) $< # The initial typesetting.
 	biber                               $(basename $<).bcf
-	lualatex $< # Update the index after the bibliography insertion.
+	$(LUALATEX) $< # Update the index after the bibliography insertion.
 	texindy -I latex -C utf8 -L english $(basename $<).idx
-	lualatex $< # The final typesetting, now also with index.
-	lualatex $<
+	$(LUALATEX) $< # The final typesetting, now also with index.
+	$(LUALATEX) $<
 
 # This target removes any auxiliary files.
 clean:
-	rm -f *.aux *.log *.out *.toc *.lot *.lof *.bcf *.blg *.run.xml \
-		*.bbl *.idx *.ind *.ilg
+	rm -f $(AUXFILES)
+	rm -rf $(AUXDIRS)
 
 # This target removes any auxiliary files
 # and the output PDF files.

example/mu/example.dtx

@@ -411,11 +411,12 @@
 \usepackage{makeidx}      %% The `makeidx` package contains
 \makeindex                %% helper commands for index typesetting.
 %% These additional packages are used within the document:
-\usepackage{paralist}
-\usepackage{amsmath}
+\usepackage{paralist} %% Compact list environments
+\usepackage{amsmath}  %% Mathematics
 \usepackage{amsthm}
 \usepackage{amsfonts}
-\usepackage{url}
+\usepackage{url}      %% Hyperlinks
+\usepackage{markdown} %% Lightweight Markup
 \begin{document}
 %<*econ>
 \makeatletter
@@ -749,6 +750,115 @@ fonts will become available: \[
   See \url{http://tex.stackexchange.com/a/58124/70941}.
 }.
 
+\chapter{Using lightweight markup}
+%<*pdftex>
+\shorthandoff{-}
+%</pdftex>
+\begin{markdown*}{%
+  hybrid,
+  definitionLists,
+  footnotes,
+  hashEnumerators}
+
+If you decide that \LaTeX{} is too wordy for some parts of your
+document, there are [packages](https://www.ctan.org/pkg/markdown
+"Markdown") that allow you to use more lightweight markup next
+to it.
+
+ ![logo](fithesis/logo/mu/fithesis-base.pdf "The logo of the
+  Masaryk University")
+
+This is a bullet list. Unlike numbered lists, bulleted lists
+contain an **unordered** set of bullet points. When a bullet point
+contains multiple paragraphs, the list is typeset as follows:
+
+  * The first item of a bullet list
+
+    that spans several paragraphs,
+  * the second item of a bullet list,
+  * the third item of a bullet list.
+
+When none of the bullet points contains multiple paragraphs, the
+list has a more compact form:
+
+  * The first item of a bullet list,
+  * the second item of a bullet list,
+  * the third item of a bullet list.
+
+Unlike a bulleted list, a numbered list implies chronology or
+ordering of the bullet points. When a bullet point
+contains multiple paragraphs, the list is typeset as follows:
+
+  1. The first item of an ordered list
+
+     that spans several paragraphs,
+  2. the second item of an ordered list,
+  3. the third item of an ordered list.
+  #. If you are feeling lazy,
+  #. you can use hash enumerators as well.
+
+When none of the bullet points contains multiple paragraphs, the
+list has a more compact form:
+
+  6. The first item of an ordered list,
+  7. the second item of an ordered list,
+  8. the third item of an ordered list.
+
+Definition lists are used to provide definitions of terms. When
+a definition contains multiple paragraphs, the list is typeset
+as follows:
+
+Term 1
+
+:   Definition 1
+
+*Term 2*
+
+:   Definition 2
+    
+        Some code, part of Definition 2
+    
+    Third paragraph of Definition 2.
+
+When none of the bullet points contains multiple paragraphs, the
+list has a more compact form:
+
+Term 1
+:   Definition 1
+*Term 2*
+:   Definition 2
+
+Block quotations are used to include an excerpt from an external
+document in way that visually clearly separates the excerpt from
+the rest of the work:
+
+> This is the first level of quoting.
+>
+> > This is nested blockquote.
+>
+> Back to the first level.
+
+Footnotes are used to include additional information to the
+document that are not necessary for the understanding of the main
+text. Here is a footnote reference[^1] and another[^longnote].
+  
+[^1]: Here is the footnote.
+
+[^longnote]: Here's one with multiple blocks.
+  
+    Subsequent paragraphs are indented to show that they
+belong to the previous footnote.
+  
+        Some code
+
+    The whole paragraph can be indented, or just the first
+    line.  In this way, multi-paragraph footnotes work like
+    multi-paragraph list items.
+\end{markdown*}
+%<*pdftex>
+\shorthandon{-}
+%</pdftex>
+
 \chapter{Inserting the bibliography}
 After linking a bibliography data\-base files to the document using
 the \verb"\"\texttt{thesissetup\{bib\discretionary{=}{=}{=}%

guide/mu/guide.dtx

@@ -277,11 +277,11 @@
   Before using the \textsf{fithesis3} class, it is useful to be
   familiar with the \LaTeX{} typesetting system. A good way to get
   started is to read one of the introductory texts in English
-  \cite{veryshortlatex,shortlatex,longlatex,latex} or in Czech
-  \cite{rybicka03,satrapa11}. Taking one of the \textit{FI:PB029},
-  \textit{PřF:M5751}, or \textit{FF:PLIN028} courses taught at
-  the \makeatletter\thesis@english@universityName\makeatother\ is
-  also helpful.
+  \parencite{veryshortlatex,shortlatex,longlatex,latex} or in Czech
+  \parencite{rybicka03,satrapa11}. Taking one of the
+  \textit{FI:PB029}, \textit{PřF:M5751}, or \textit{FF:PLIN028}
+  courses taught at the \makeatletter\thesis@english@universityName
+  \makeatother\ is also helpful.
   
   To become familiar with \textsf{fithesis3}, you are encouraged to
   inspect the example documents \makeatletter
@@ -322,15 +322,17 @@
   documents.
 
   If you are using the command line, you can typeset \LaTeX{}
-  source files by running either \texttt{pdflatex
-  \textit{name.tex}} or \texttt{lualatex
-  \textit{name.tex}} (depending on your choice of \TeX\
-  engine), where \texttt{\textit{name.tex}} corresponds to the name
-  of a \LaTeX\ source file. In the case of the two aforementioned
-  example files, the corresponding commands would be:
+  source files by running either the \texttt{pdflatex
+  -{}-shell-escape \textit{name.tex}} command or the
+  \texttt{lualatex \textit{name.tex}} command depending on your
+  chosen \TeX\ engine, where \texttt{\textit{name.tex}}
+  corresponds to the name of a \LaTeX\ source file. In the case of
+  the two aforementioned example files, the corresponding commands
+  would be
   \begin{center}\makeatletter
-  \texttt{pdflatex \thesis@faculty-pdflatex.tex}
-\\\texttt{lualatex \thesis@faculty-lualatex.tex}
+  \texttt{pdflatex -{}-shell-escape \thesis@faculty-pdflatex.tex}
+  for \hologo{pdfLaTeX},\\and \texttt{lualatex \thesis@faculty-%
+  lualatex.tex} for Lua\LaTeX{}.
   \makeatother\end{center}
   The command needs to be executed from within the directory, where
   the \LaTeX\ source file is located. In Windows, the command line