aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--web/features.txt26
-rw-r--r--web/header.html3
-rwxr-xr-xweb/mkdemos.sh24
3 files changed, 49 insertions, 4 deletions
diff --git a/web/features.txt b/web/features.txt
new file mode 100644
index 000000000..0351c02fe
--- /dev/null
+++ b/web/features.txt
@@ -0,0 +1,26 @@
+% Pandoc features
+
+- A real markdown parser, not based on regex substitutions.
+- [More accurate] and [faster], in many cases, than `Markdown.pl`.
+- Multiple output formats--HTML, Docbook XML, LaTeX, reStructuredText,
+ RTF, S5 slide shows--generated natively, with no XSLT postprocessing.
+- Converts *to* markdown from HTML, LaTeX, and reStructuredText.
+- Convenient wrapper scripts:
+ + `html2markdown` makes it easy to produce a markdown version
+ of any web page.
+ + `markdown2pdf` converts markdown to PDF in one step.
+ + `hsmarkdown` is a drop-in replacement for `Markdown.pl`.
+- Unicode support.
+- Support for footnotes.
+- Support for "smart" quotes, dashes, and ellipses.
+- Support for document metadata (title, author, date).
+- Support for inline LaTeX math and [ASCIIMathML].
+- Support for inline LaTeX commands.
+- Compatibility mode to turn off syntax entensions and emulate
+ `Markdown.pl`.
+- Multi-platform: runs on Windows, MacOS X, Linux, Unix.
+
+[More accurate]: http://code.google.com/p/pandoc/wiki/PandocVsMarkdownPl
+[faster]: http://code.google.com/p/pandoc/wiki/Benchmarks
+[ASCIIMathML]: http://www1.chapman.edu/~jipsen/mathml/asciimath.html
+
diff --git a/web/header.html b/web/header.html
index 4a5f60901..6f9ce637d 100644
--- a/web/header.html
+++ b/web/header.html
@@ -2,9 +2,10 @@
<ul>
<li><a href="index.html" title="Home page">Home</a></li>
<li><a href="README.html" title="Pandoc documentation">README</a></li>
+<li><a href="features.html" title="Pandoc features">Features</a></li>
<li><a href="examples.html" title="Pandoc demos">Examples</a></li>
<li><a href="doc/index.html" title="API documentation for Pandoc libraries">API</a></li>
-<li><a href="changelog.html" title="Pandoc's changelog">History</a></li>
+<li><a href="changelog.html" title="Pandoc's changelog">Changelog</a></li>
</ul>
</div>
<div id="main" class="withleftmenu">
diff --git a/web/mkdemos.sh b/web/mkdemos.sh
index 11628bb04..83490f837 100755
--- a/web/mkdemos.sh
+++ b/web/mkdemos.sh
@@ -8,17 +8,29 @@ PROGPATH=$2
NEWLINE='
'
-EXAMPLES='pandoc README -o example0.html
+EXAMPLES='HTML fragment:
+pandoc README -o example0.html
+Standalone HTML file:
pandoc -s -S README -o example0.html
+HTML with smart quotes, CSS, and custom header and footer:
pandoc -s -S -c main.css -B header.html -A footer.html README -o example0.html
+LaTeX:
pandoc -s README -o example0.tex
+From LaTeX to markdown:
pandoc -s README.tex -o example0.txt
+reStructuredText:
pandoc -s -w rst README -o example0.txt
+Rich text format (RTF):
pandoc -s README -o example0.rtf
+S5 HTML slide show (all in one file):
pandoc -s -m -i -w s5 S5DEMO -o example0.html
+Docbook XML:
pandoc -s -w docbook README -o example0.db
+Converting a web page to markdown:
html2markdown http://www.gnu.org/software/make/ -o example0.txt
+From markdown to PDF:
markdown2pdf README -o example0.pdf
+Using a custom LaTeX header to change the font style of the PDF:
markdown2pdf -C myheader.tex README -o example0.pdf'
oldifs=$IFS
@@ -35,14 +47,20 @@ click on the name of the output file:
'
num=0
-for command in "$@"; do
+while [ $# -gt 0 ]; do
+ description="$1"
+ command="$2"
num=$(($num + 1))
command=$(echo $command | sed -e "s/0/$num/")
firstpart=$(echo $command | sed -e 's/\(.*\) [^ ]* -o.*/\1/')
input=$(echo $command | sed -e 's/.* \([^ ]*\) -o.*/\1/')
output=$(echo $command | sed -e 's/.*-o \(.*\)/\1/')
- echo "1. <code>$firstpart <a href=\""$input"\" title=\""View input file"\">$input</a> -o <a href=\""$output"\" title=\""View pandoc output"\">$output</a></code>"
+ echo "1. $description"
+ echo
+ echo " <code>$firstpart <a href=\""$input"\" title=\""View input file"\">$input</a> -o <a href=\""$output"\" title=\""View pandoc output"\">$output</a></code>"
echo $command >&2
result=$(PATH=$PROGPATH:$PATH $command) # run the command and create output file
+ shift
+ shift
done