Hugo

Adding publications page to website

I am working off these instructions and want to be able to pull off this…

I’m not understanding the workflow very well from these instructions, and I can’t find good documentation on it. I’ve “view page source” and “inspect page” on these, and can’t figure out how they are doing it. From what I understand:

  1. I need to make an index.html file for each publication I want to include on my website and then I link those pages in the publications.md widget for my website?

Does anyone have some skeleton code for how to include these? I can’t tell how to add the buttons with links either - does that code go in the .html file for each publication or does that code go in the .md widget section of content/home folder? Any hints are much appreciated!

Hiya! The Academic theme was created by @neutreno. It has a dedicated issue queue and community chat. :slight_smile:

2 Likes

Okay perfect, I have saved those two references to my favorites. I just posted on their site too, gonna see wait for response. Thanks!

Have a look at the code of the example site

It looks like you need a /content/publications folder.

  • In this folder you need an _index.md file. What’s important about this file is the frontmatter which tells hugo how to layout the list of publications.
  • In the /content/publications folder you create a folder for each publication you want listed. Inside this sub-folder you need an index.md file, which has loads of metadata options for your publication, and the body of that is where you might put a longer description of the publication. You can also put related files, like images, or bibtex information, relating to the publication in this folder.

Hugo is a powerful tool, and the Academic theme has loads, and loads of options. Not everyone who uses Hugo will be able to help you with some of the finer points of using this theme. As @maiki has hinted, you’ll get some help here, but you may get more help from the community chat.

1 Like

Thanks this really outlines a lot. I was having trouble seeing the big picture of everything I needed to do to pull it off. It seems like it’s a little more complicated than I thought. Gonna keep trying, I might check back in.

Also, I will look at the link you sent.

Good news! I copied the directories from the example site you sent. I tried the journal-artice and it didn’t work (prefilled it with my information). Then I tried the conference-paper and it worked (I still need to fill it out with most of my information I just changed the title to see if it was reflecting). It’s up on my website take a look!


The only thing is I would have expected for it to display all the items I have in the publications folder in that section, but it only display the conference paper. I cannot figure out how to list more than one publication in that section. Do you have any hints?

Things I’ve tried:

  1. Set Front matter to true on content/home/publications and content/home/featured to true.
  2. Within publications and featured I changed the setting to display all cards

I can’t figure out the mechanism to actually list out more than 1 publication (even though I have 3 in the publications folder).

Okay I think I have figured it out. From what I understand, within /content/publications I have a folder for each publication. Inside these sub-folders I have an index.md file (with all the details of the publication). But within the normal /content/publications folder I need to somehow tie all of the publications together? For example this is what I’m thinking to solve the problem…

/content/publications -> has _index.md (front matter file)… so I need to add index.md or index.html in addition to the _index.md to this directory to list out all that publications I want to display in that section?

I don’t know heaps about the inner workings of the Academic theme.

  • I think only one publication can be featured.
  • I’m not sure how the academic theme chooses to list recent publications (the documentation isn’t clear, and I haven’t dug through the code) but I’d guess it’s based on either the date or publishDate in the frontmatter of /content/publications/MYPUBLICATION/index.md
date: "2015-09-01T00:00:00Z"
doi: ""

# Schedule page publish date (NOT publication's date).
publishDate: "2017-01-01T00:00:00Z"

Sounds good. I appreciate you feedback. I’ve runned out of ideas, so I’ll mess with the dates and see if that does anything. As of now I still can’t get more than 1 publication on my page.