Ordering website components

Menu links

The first order of things I could change was the order of links in the menu on the top right of my page. In this case, I wanted my information to be the first link, followed by “Publications”, “Projects”, “Posts”, “Tutorials”, and “Contact”. The weighting for these links is found in the config.toml file of the website repo, where a standard entry for one of the links looks a bit like this:

[[menu.main]]
  name = "Publications"
  url = "#publications"
  weight = 2

Here you can change the “name”, which is what the menu option actually says (e.g. I changed the menu option for my bio from “Home” to “About”). The URL refers to where on the site the link will point to. If you are trying to link to a homepage widget, as in the example above, the url will be # followed by the file name of that widget in the content/home/ folder. You want to be careful not to link to a widget that is inactive (which you can see in the first few lines of the Markdown document for that widget), otherwise the link will not go anywhere.

If you are linking to something else, you can provide the file-path relative to the content folder – for example, my tutorials live in the folder content/tutorial:

[[menu.main]]
  name = "Tutorials"
  url = "/tutorial/"
  weight = 5

Finally, you can change the weights to reflect the order you want the links to appear in the menu: the links will appear from left to right in ascending order of weight (weight = 1 is the first link, etc.)

Home page content

Initially, I confused changing the weights in the config.toml file with actually changing the order of those sections on the home page, but doing that actually requires editing the Markdown files for those types of content in the content/home/ folder. For example, I decided I wanted to put posts first, so I went to content/home/posts.md and modified the weight argument so that it was lowest and continued editing the weights until everything was in the order I wanted.