Zhenke Wu, PhD Research Website
HTML Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_data
_includes
_layouts
_plugins
_scripts
assets
blog
css
js
misc
news
papers
projects
teaching
team
.gitignore
404.html
CNAME
Gemfile
README.md
Rakefile
_config.yml
about.html
archive.html
categories.html
feed.xml
index.md
notes.md
pages.html
sitemap.txt
tags.html

README.md

Zhenke Wu's Research Website: click to view

Notes

  • After cloning the repo to your local folder, you'll need to install jekyll to build and test your modified site.

  • fonts

    • Use Typekit to publish fonts you like; register an Adobe account;
    • Modify $font-stack in /assets/themes/lab/css/style.scss to include your fonts. Extra font names are used as fallbacks.
  • posts

    • To add a post, e.g., a new paper, follow the format of the existing .md files
    • Comment out </div> if there are a multiple of three papers in each subsection; otherwise, there will be errors of indentation.
  • tracking

    • To link your site to Google analytic services, modify the tracking_id in _config.yml file in the root directory so that it points to your website.
  • MathJax (also see here )

    • To properly display the math expressions rendered by MathJax,
      • Add kramdown after on the line of markdown: in _config.yml; this prevents markdown language to intervene with LaTex commands; Also put gem 'kramdown' in Gemfile;
    • Add the following code block to /_includes/themes/lab/default.html, before </head>
 <!-- Math via MathJax -->
<script type="text/x-mathjax-config">
MathJax.Hub.Config({
  jax: ["input/TeX", "output/HTML-CSS"],
  tex2jax: {
    inlineMath: [ ['$', '$'] ],
    displayMath: [ ['$$', '$$']],
    processEscapes: true,
    skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
  },
  messageStyle: "none",
  "HTML-CSS": { preferredFont: "TeX", availableFonts: ["STIX","TeX"] }
});
</script>
<script src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML" type="text/javascript"></script>
  • projects
    • For each repo (in the folder /_data), the url should not end with /. For example, use url: /projects/baker, instead of url: /projects/baker/
  • navigation:
    • For example, the "papers" tab is specified in the folder "papers/". At the top, title is for tab name; group can be either navigation or subnavigation depending on whether you want to show this tab or collapse into the "More" tab; navorder specifies the order appearing in the navigation bar (1 for the first tab).

Other Technicalities

  • categories
    • refers to the subfolders in the main directory without an underscore _;
    • is used to refer to specific locations in the website (my current guess is that the definition of categories ships with the engine of jekyll, so no need to user-define categories)
  • style sheets
    • There are two that matter: /assets/themes/lab/css/style.scss and /assets/themes/css/style.scss; The former works for posts, the latter for pages PRIOR to entering posts.
    • This might best be fixed, but I don't have time now to check how they are currently used in different pages.