Post Template


Create an Article, Event, or other post

Posts for Articles and Events are kept in the following directories (as of writing this):

  • _posts -> Articles Page
  • _events -> Events Page

To create a new post, add a file with the markdown file extension (.md). Jekyll uses Kramdown for processing these files. It is important that you follow Jekyll’s naming conventions for a post as follows: This is how Jekyll organizes and sorts your posts correctly.

For example, this is how you create a new post for the Articles page:

  1. Create a file named in the _posts directory.
  2. Insure you have the proper Front Matter for your post. An Article has the following Front Matter:

    # Uses this html: "_layout/post.html" as a template.
    layout: post 
    title:  Post Template
    # (Optional) Used to sort posts, not supported as of writing this.
    categories: [ Workshops ]
  3. Write your article. Use this post template or Kramdown’s documentation for any markdown questions / issues you have.
  4. Confirm your article shows up on the site.

Use KaTex

Use KaTex to draw Math formulas directly in Markdown. KaTex uses LaTeX and TeX macros to parse math formulas. See the Katex docs for a full list of LaTeX and TeX macros.B elow is a simple example of using Katex:

_Today we'll go over the Pythagorean Theorem..._

a^{2} + b^{2} = c^{2}

# Inline mode:

a^{2} + b^{2} = c^{2}  

…Which results in the following output:

Today we’ll go over the Pythagorean Theorem…

$ a^{2} + b^{2} = c^{2} $

Add a Video

  • Get the source of a video. For Vimeo videos, you can get the source of the video by clicking share then copying the link shown in the popup. For YouTube, right-click a video and choose copy video url.

    • You can also add videos to the site in the /uploads/videos directory, but it is not recommended to keep videos in your code repository.

Vimeo video example

  • Once you have the source of a video, use the code below as a template:

    include video.html
    title="Tensors & Operators -- James B. Wilson"
    desc="Introduction to Tensors, Tensor Spaces, and Transverse Operators. TACA 2019. For more visit https://TheTensor.Space/. Creative Commons 2.0 CC-BY 2019 James B. Wilson"

…which will result in the following output:

Tensors & Operators -- James B. Wilson

Introduction to Tensors, Tensor Spaces, and Transverse Operators. Creative Commons 2.0 CC-BY 2019 James B. Wilson

Add an image

It is not recommended to keep images in your code repository, but at a small scale it is acceptable (this is because Git tracks every image and slows down version control and for other reasons).

Use the following markdown as a template to add an image to a post:

  Use an image in the /uploads/images directory:

  ![Vimeo video example](/uploads/images/vimeo_src_example.png)

  Or, use an external image (Be sure the image won't be removed in the future):

  ![Text that is shown if the image fails to load](https://URL_TO_YOUR_IMAGE)

Edit a non-post page

All non-post pages are mostly located in the root directory. For example, About, Home, and Contact pages can be found in the root directory as,, and


A full list of documentation for the site can be found on the documentation page.


When you’d like to contribute to the website, you’ll need to follow these steps:

  1. Fork our repository, thetensor-space/
  2. Clone your fork onto your local machine with Git.
  3. Create a new branch with a descriptive name like article-squid-membranes.
  4. Run the site locally:
    1. Open a terminal and navigate inside your cloned project.
    2. Use Docker (Recommended, Free for linux):
      docker run --rm \
         --volume="$PWD:/srv/jekyll" \
         -p 4000:4000 \
         -it jekyll/jekyll \
         jekyll serve

      OR… install Jekyll manually.

      Then, run jekyll serve or bundle exec jekyll serve to run the site.

    3. Now the site is available at http://localhost:4000 it will automagically reload every time a file is saved.
  5. Create new changes (Add an article, update the navbar, etc.).
    • Instructions for common changes are described in the rest of this post.
  6. Push your new branch to your fork.
  7. Create a pull request to master on thetensor-space/
  8. We will review your pull request and either request changes or approve it and merge your changes to master.
  9. The site will automatically refresh with any new changes within a few minutes.

Additional Questions?

If you have additional questions, feel free to reach out to a maintainer / contributor on the contact page.

What Is a Tensor

There are numerous potential meanings for a tensor, most relate in some fashion to a...

Related Posts