From 05fa83afa73f5ef4fefbdd62020d5de0d8f7ce15 Mon Sep 17 00:00:00 2001
From: George Cushen <gcushen@users.noreply.github.com>
Date: Thu, 2 Nov 2017 20:52:16 +0000
Subject: [PATCH] docs: Add FAQ

---
 exampleSite/content/post/faq.md | 50 +++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 exampleSite/content/post/faq.md

diff --git a/exampleSite/content/post/faq.md b/exampleSite/content/post/faq.md
new file mode 100644
index 00000000..bef7af9c
--- /dev/null
+++ b/exampleSite/content/post/faq.md
@@ -0,0 +1,50 @@
++++
+date = 2016-04-10
+# lastmod = 2017-09-03
+draft = false
+tags = ["academic", "hugo"]
+title = "Frequently Asked Questions (FAQ)"
+summary = """Troubleshoot common issues."""
++++
+
+Common questions and answers will be listed here.
+
+**I cloned/downloaded Academic but Hugo produces errors when using it with my existing Hugo site**
+
+Academic is a website *framework* rather than just a *theme*. Therefore, you must follow the full installation guide found on the Demo/Documentation website or in the Github Readme. If you still have problems, first try running Hugo on the Academic Example Site found in the `themes/academic/exampleSite` folder and then compare the configuration parameters in the Example Site's `config.toml` and content files with the files in your existing site.
+
+**Hosting your site with Netlify or Cloudflare and experience strange behavior such as filters not working?**
+
+Disable post-processing steps such as *minification* in your Netlify/Cloudflare admin panel.
+
+**Publications and other content are not sorted by newest first**
+
+Hugo/TOML require that the value for the `date` field should be in [TOML format](https://github.com/toml-lang/toml#local-date-time), as per frontmatter of the `content/publication/` files in the example site. If you want to use a partial date, such as year, you should still complete a full date to make a valid TOML date format.
+
+**Issue parsing LaTeX in publication abstract**
+
+Let's consider the following LaTeX which fails to parse correctly:
+
+    abstract = "${O(d_{\max})}$"
+
+This is a side effect of Academic and Hugo attempting to parse TOML, Markdown and LaTeX content in the abstract. The solution is to:
+
+- escape each LaTeX backslash (`\`) with an extra backslash, yielding `\\`
+- escape each LaTeX underscore (`_`) with two backslashes, yielding `\\_`.
+
+Hence, editing the above example, we get:
+
+    abstract = "${O(d\\_{\\max})}$"
+
+**Cannot achieve line break in multiline equation (LaTeX/Mathjax)**
+
+`\\` usually achieves a line break in a multiline LaTeX/Mathjax equation, but due to Hugo's Markdown parser it doesn't.
+
+Solution: use 6 backslashes for a line break, for example:
+
+```
+$$\begin{eqnarray} 
+y &=& 1+1   \\\\\\
+&=& 2
+\end{eqnarray}$$
+```