<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="The Art Gallery Guardian">
<meta name="author" content="Chao Xu">
<meta name="google-site-verification" content="YE2oeW4OwVOPdVVfdpYIakOuD0A2Qo80W_sUbMJDGok" />
<meta property="og:title" content="README" />
<meta property="og:type" content="article" />
<meta property="og:site_name" content="The Art Gallery Guardian" />
<meta property="article:tag" content="" />
<title>README</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.16.0/dist/katex.min.css" integrity="sha384-Xi8rHCmBmhbuyyhbI88391ZKP2dmfnOl4rT9ZfRI7mLTdk1wblIUnrIq35nqwEvC" crossorigin="anonymous">
<link rel="shortcut icon" type="image/x-icon" href="/favicon.ico"/>
<link rel="stylesheet" href="/css/default.css" crossorigin="anonymous">
<link rel="stylesheet" href="/css/blog.css" crossorigin="anonymous">
<link rel="alternate" type="application/rss+xml" title="RSS"
href="https://chaoxu.prof/rss.xml">
</head>
<body>
<header class="hide-on-print">
<div id="site-title">
<a href="/blog.html">The Art Gallery Guardian</a>
</div>
<div style="display: none;">
<img src="/files/chao/chao_thumb.jpg" >
</div>
</header>
<nav class="hide-on-print">
<ul>
<li><a href="/">About</a></li>
<li><a href="/blog.html">Blog</a></li>
<li><a href="/cnblog.html">中文博客</a></li>
<li><a href="/files/cv.pdf">CV</a></li>
<li><a href="/pages/tools.html">Tools</a></li>
</ul>
</nav>
<main>
<article>
<h1 id="article-title">README</h1>
<h1 data-number="1" id="technology"><span
class="header-section-number">1</span> Technology</h1>
<ol type="1">
<li>The source of the blog is on a <a
href="https://github.com/chaoxu/chaoxu.github.io/tree/develop">git
repository</a>.</li>
<li>html files are hosted on <a href="https://pages.github.com">GitHub
Pages</a>.</li>
<li>The blog source is compiled by <a
href="http://jaspervdj.be/hakyll/">hakyll</a>.</li>
<li>The content is written use my variation of <a
href="http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown">Pandoc’s
Markdown</a>, I call it <a
href="https://github.com/chaoxu/chaoxu.github.io/blob/develop/ChaoDoc.hs">ChaoDoc</a>.</li>
<li>Coded most of the things in <a
href="http://www.sublimetext.com/3">Sublime Text 3</a>.</li>
<li>The theme is <a href="http://tarskitheme.com/">Tarski</a> with few
changes.</li>
<li>The math are shown with <a href="https://katex.org/">KaTex</a>,
rendered offline.</li>
<li>The heading themes are similar to <a
href="http://www.amazon.com/gp/product/0199205272/ref=as_li_ss_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=0199205272&linkCode=as2&tag=fighterempire-20">Connections
in Combinatorial Optimization</a>, and the remaining themes are similar
to <a
href="http://www.amazon.com/gp/product/0387984038/ref=as_li_ss_tl?ie=UTF8&camp=1789&creative=390957&creativeASIN=0387984038&linkCode=as2&tag=fighterempire-20">Categories
for the Working Mathematician</a>. The symbols are of KaTeX.</li>
<li>To compile just <code>ChaoDoc.hs</code>, you need
<code>pandoc</code> and <code>citeproc</code>. To compile the
<code>site.hs</code>, additionally you need <code>hakyll</code>.</li>
<li>For the homepage, I generate with python. Needs to run
<code>pip install pyyaml mistune jinja2 bs4</code> on a new
machine.</li>
<li>KaTeX offline compilation. Requires <a
href="https://github.com/chaoxu/katex_cli">katex_cli</a>. Build it and
copy the executable into the base directory, and name it
<code>katex_cli</code>.</li>
<li>Make sure install llvm 13 for things to work correctly. This will be
an issue until Hakyll start to work for higher pandoc version.</li>
</ol>
<h1 data-number="2" id="notes"><span
class="header-section-number">2</span> Notes</h1>
<ul>
<li>I made an <a
href="https://gist.github.com/chaoxu/195ce33124f384a2f4e4">syntax
highlighting file</a> for sublime 3, so in Markdown it can also
highlight latex codes.</li>
</ul>
</article>
</main>
<footer class="hide-on-print">© 2010 - <time><script>document.write(new Date().getFullYear())</script></time> <a href="https://chaoxu.prof" rel="author">Chao Xu</a>. Licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.
<a href="/README.html">Blog README</a>.</footer>
</body>
</html>